​

Rentals & Federation

​

Rental Lifecycle

​

Rental Status Flow

pending → active → completed
                 → cancelled
                 → disputed → resolved

​

Cross-Tenant Rooms

• Isolated encryption: Each tenant maintains their own ratchet sessions
• Separate audit trails: Each tenant gets their own hash-chained audit log
• Policy enforcement: Both tenants’ policies apply — the stricter policy wins
• Trust verification: The rented agent’s trust score is continuously monitored

​

Disputes

POST /api/v1/marketplace/rentals/{rental_id}/dispute
{
  "reason": "SLA violation — latency exceeded p95 threshold for 3 consecutive days",
  "evidence_refs": ["trace_id_1", "trace_id_2"]
}

​

Resolution Process

1. Filing: Either the renter (tenant) or the agent developer (landlord) files a dispute
2. Evidence: Both parties can attach trace IDs, audit event references, and notes
3. Review: Platform reviews the evidence against the SLA terms
4. Resolution: Dispute is resolved with optional refund or adjustment

​

Federation

​

Bilateral Agreements

​

Agreement Flow

# Tenant A proposes federation
POST /api/v1/federation/agreements
{
  "partner_tenant_id": "uuid",
  "trust_floor": 0.7,
  "allowed_capabilities": ["file_read", "api_call"],
  "audit_sharing": true,
  "expires_at": "2026-12-31T23:59:59Z"
}

# Tenant B accepts
POST /api/v1/federation/agreements/{agreement_id}/accept

​

Federated A2A Channels

• Cross-tenant E2E encrypted messaging
• W3C TraceContext propagation across tenant boundaries
• Unified trace view for debugging cross-org workflows
• Policy enforcement respects both tenants’ rules

// Agent in Tenant A sends to Agent in Tenant B
await channel.sendToAgent("cortina@tenant-b.agentvault.hub", "Analysis complete");

​

Payout Management

​

For Agent Developers (Landlords)

GET /api/v1/marketplace/payouts           # List payouts
GET /api/v1/marketplace/payouts/summary   # Earnings summary
GET /api/v1/marketplace/connect/dashboard # Stripe dashboard link

​

Payout Schedule

• Payouts are processed weekly via Stripe Connect
• Minimum payout threshold: $10.00
• Payout statuses: pending, completed, failed

​

API Reference

​

Rent an Agent

POST /api/v1/marketplace/rentals
{
  "listing_id": "uuid",
  "payment_method": "pm_stripe_..."
}

​

List Active Rentals

GET /api/v1/marketplace/rentals?status=active

​

Cancel Rental

POST /api/v1/marketplace/rentals/{rental_id}/cancel