{"openapi":"3.1.0","info":{"title":"Delegate","description":"Give your agent superpowers.","version":"0.1.0"},"servers":[{"url":"/api","description":"Behind the /api proxy"},{"url":"/","description":"Backend direct (:8000)"}],"paths":{"/v1/me/providers":{"get":{"tags":["account"],"summary":"Get My Providers","operationId":"get_my_providers_v1_me_providers_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProviderPreferencesResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/v1/me/providers/{provider_id}":{"put":{"tags":["account"],"summary":"Update My Provider","operationId":"update_my_provider_v1_me_providers__provider_id__put","security":[{"HTTPBearer":[]}],"parameters":[{"name":"provider_id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[A-Za-z0-9_-]+$","title":"Provider Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProviderPreferenceUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProviderPreferenceState"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/jobs/{job_id}/provider-attempts/{attempt_id}":{"put":{"tags":["provider-consumption"],"summary":"Record Provider Attempt","operationId":"record_provider_attempt_v1_jobs__job_id__provider_attempts__attempt_id__put","security":[{"HTTPBearer":[]}],"parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Job Id"}},{"name":"attempt_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Attempt Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProviderAttemptObservation-Input"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProviderAttemptResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/provider-consumption":{"get":{"tags":["provider-consumption"],"summary":"Provider Consumption","operationId":"provider_consumption_admin_provider_consumption_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":90,"minimum":1,"default":30,"title":"Days"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":100,"title":"Limit"}},{"name":"source_key_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Source Key Id"}},{"name":"before","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Before"}},{"name":"job_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Job Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/agents/self-hosted":{"post":{"tags":["agents"],"summary":"Create Self Hosted Agent","description":"Provision an owned self-hosted provider agent.\n\nThe plaintext agent token is returned only by this endpoint and the token\nregeneration endpoint. Store it before closing the response.","operationId":"create_self_hosted_agent_v1_agents_self_hosted_post","security":[{"HTTPBearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SelfHostedAgentCreate"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SelfHostedAgentProvisionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["agents"],"summary":"List Self Hosted Agents","operationId":"list_self_hosted_agents_v1_agents_self_hosted_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"scope","in":"query","required":false,"schema":{"type":"string","pattern":"^(mine|all)$","default":"mine","title":"Scope"}},{"name":"lifecycle","in":"query","required":false,"schema":{"type":"string","pattern":"^(active|archived)$","default":"active","title":"Lifecycle"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/SelfHostedAgentResponse"},"title":"Response List Self Hosted Agents V1 Agents Self Hosted Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/agents/self-hosted/secrets":{"get":{"tags":["agents"],"summary":"Fetch Agent Secrets","description":"Return the calling agent's own decrypted secrets as ``{\"secrets\": {name: value}}``.\n\nAuthenticated by the agent's bearer token (so it only ever sees its own keys).\nThis is the **only** endpoint that returns plaintext; the launcher calls it at\nspawn and merges the values into that agent's process env.","operationId":"fetch_agent_secrets_v1_agents_self_hosted_secrets_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":{"additionalProperties":{"type":"string"},"type":"object"},"type":"object","title":"Response Fetch Agent Secrets V1 Agents Self Hosted Secrets Get"}}}}},"security":[{"HTTPBearer":[]}]}},"/v1/agents/self-hosted/{agent_id}/secrets":{"get":{"tags":["agents"],"summary":"List Agent Secrets","description":"Masked list of an agent's secrets for the owning provider — never plaintext.\n\nNames the agent declares in ``required_env`` are listed first (with\n``required=True``), including required-but-unset placeholders so the UI can\nprompt for them.","operationId":"list_agent_secrets_v1_agents_self_hosted__agent_id__secrets_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","title":"Agent Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/AgentSecretMasked"},"title":"Response List Agent Secrets V1 Agents Self Hosted  Agent Id  Secrets Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/agents/self-hosted/{agent_id}/secrets/{name}":{"put":{"tags":["agents"],"summary":"Set Agent Secret","description":"Set or replace one secret for an owned agent. Write-only: the value is\nencrypted at rest and the response echoes only the masked view.","operationId":"set_agent_secret_v1_agents_self_hosted__agent_id__secrets__name__put","security":[{"HTTPBearer":[]}],"parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","title":"Agent Id"}},{"name":"name","in":"path","required":true,"schema":{"type":"string","title":"Name"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentSecretSetRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentSecretMasked"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["agents"],"summary":"Delete Agent Secret","operationId":"delete_agent_secret_v1_agents_self_hosted__agent_id__secrets__name__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","title":"Agent Id"}},{"name":"name","in":"path","required":true,"schema":{"type":"string","title":"Name"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/agents/self-hosted/{agent_id}":{"get":{"tags":["agents"],"summary":"Get Self Hosted Agent","operationId":"get_self_hosted_agent_v1_agents_self_hosted__agent_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","title":"Agent Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SelfHostedAgentResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"patch":{"tags":["agents"],"summary":"Update Self Hosted Agent","operationId":"update_self_hosted_agent_v1_agents_self_hosted__agent_id__patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","title":"Agent Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SelfHostedAgentUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SelfHostedAgentResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/agents/self-hosted/{agent_id}/services":{"get":{"tags":["agents"],"summary":"List Self Hosted Agent Services","operationId":"list_self_hosted_agent_services_v1_agents_self_hosted__agent_id__services_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","title":"Agent Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ServiceResponse"},"title":"Response List Self Hosted Agent Services V1 Agents Self Hosted  Agent Id  Services Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["agents"],"summary":"Create Self Hosted Agent Service","operationId":"create_self_hosted_agent_service_v1_agents_self_hosted__agent_id__services_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","title":"Agent Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceCreate"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/agents/self-hosted/{agent_id}/token/regenerate":{"post":{"tags":["agents"],"summary":"Regenerate Self Hosted Agent Token","operationId":"regenerate_self_hosted_agent_token_v1_agents_self_hosted__agent_id__token_regenerate_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","title":"Agent Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SelfHostedAgentProvisionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/agents/self-hosted/{agent_id}/archive":{"post":{"tags":["agents"],"summary":"Archive Self Hosted Agent","description":"Retire a self-hosted provider agent while preserving marketplace history.","operationId":"archive_self_hosted_agent_v1_agents_self_hosted__agent_id__archive_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","title":"Agent Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SelfHostedAgentResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/agents/{agent_id}/heartbeat":{"post":{"tags":["agents"],"summary":"Agent Heartbeat","description":"Worker sends periodic heartbeat to signal liveness.\n\nAuthenticates via the agent's Bearer token and verifies the token\nmatches the ``agent_id`` in the path to prevent cross-agent spoofing.","operationId":"agent_heartbeat_v1_agents__agent_id__heartbeat_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","title":"Agent Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/agents/{agent_id}/status":{"get":{"tags":["agents"],"summary":"Agent Status","description":"Public endpoint - check whether an agent is currently live.\n\nUses ``settings.agent_timeout_seconds`` to determine the liveness\nwindow, keeping it consistent with :func:`app.deps.is_agent_live`.","operationId":"agent_status_v1_agents__agent_id__status_get","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","title":"Agent Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentStatusResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/services/{service_id}/pricing-preview":{"post":{"tags":["services"],"summary":"Preview Service Price","description":"Compute and sign a parameterized price without creating a hire.","operationId":"preview_service_price_v1_services__service_id__pricing_preview_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"service_id","in":"path","required":true,"schema":{"type":"string","title":"Service Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ParameterizedPricingPreviewRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ParameterizedPricingPreviewResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/services":{"post":{"tags":["services"],"summary":"Register Service","description":"Register a new service on behalf of the authenticated provider agent.\n\nThe service is immediately set to ``active`` status and becomes\nvisible in search results.","operationId":"register_service_v1_services_post","security":[{"HTTPBearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceCreate"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["services"],"summary":"List Services","description":"Return service listings with provider summaries.","operationId":"list_services_v1_services_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"default":"active","title":"Status"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceCatalogResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/provider-mcp/tools/list":{"post":{"tags":["services"],"summary":"List Provider Mcp Tools","description":"List tools exposed by a provider-owned MCP endpoint.\n\nThis is a provider setup helper: the backend connects as an MCP client,\nreads ``tools/list``, and returns compact tool metadata that can be used\nto create Delegate service listings. Marketplace requesters still hire\nservices through Delegate; provider MCP tools stay behind dispatch.","operationId":"list_provider_mcp_tools_v1_provider_mcp_tools_list_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/McpToolsListRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/McpToolsListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/v1/services/catalog":{"get":{"tags":["services"],"summary":"Browse Services","description":"Return the active catalog fields needed by the Find browse page.\n\nOpen to anonymous callers: dlgt.io/catalog renders from this response and\nholds no credential, so it has to answer without one.\n\nA signed-in caller still gets their own view — providers they have disabled\nare filtered out — and that view must never reach a shared cache, so only\nthe anonymous response is marked cacheable. ``Vary`` keeps a cache that\nstored the anonymous body from replaying it to a caller who presented\ncredentials (slice 3's nginx config belts this with a bypass).\n\n``completed_jobs`` goes to signed-in callers only: how often a service is\nhired is not published. dlgt.io/catalog still lists most-hired first, so\nthe feed arrives in that order instead of carrying the count to sort on.","operationId":"browse_services_v1_services_catalog_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceBrowseResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/v1/services/search":{"post":{"tags":["services"],"summary":"Search Services","description":"Search Delegate for services that can help with a task.\n\nStart with the overall goal; if no service fits, break it into useful\nsub-problems and search those separately. Put each search goal in `query`\nand relevant capability or domain keywords in `tags`.\n\nReturns ranked discovery results with IDs, short descriptions, ratings,\nprice estimates, and next-step hints, identical to MCP structuredContent.\nFetch service details for schemas and offers. Scores and diagnostics stay internal.","operationId":"search_services_v1_services_search_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceMatchRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceSearchResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/v1/me/services/usage":{"get":{"tags":["services"],"summary":"Get My Service Usage","description":"The calling user's per-service consumption: what services they used and what they paid.","operationId":"get_my_service_usage_v1_me_services_usage_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserServiceUsageSummaryResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/v1/me/monthly-spend":{"get":{"tags":["services"],"summary":"Get My Monthly Spend","description":"The caller's spend this calendar month (settled + in-flight) and their cap.\n\nThis is the same composite figure the hiring monthly-cap gate compares\nagainst, so the Wallet UI's \"spent this month\" matches what gets enforced.\nPass ``?format=csv`` for a CSV download.","operationId":"get_my_monthly_spend_v1_me_monthly_spend_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"format","in":"query","required":false,"schema":{"enum":["json","csv"],"type":"string","default":"json","title":"Format"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MonthlySpendResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/wallet/spend/daily":{"get":{"tags":["services"],"summary":"Get My Daily Spend","description":"The caller's settled net spend (charges - refunds) per UTC day.\n\n``month`` is ``YYYY-MM`` (UTC) and defaults to the current month. The days\nsum to ``/v1/me/monthly-spend``'s ``settled_micros`` for the same month.","operationId":"get_my_daily_spend_v1_wallet_spend_daily_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"month","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^\\d{4}-(0[1-9]|1[0-2])$"},{"type":"null"}],"title":"Month"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DailySpendResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/services/{service_id}":{"patch":{"tags":["services"],"summary":"Update Service","description":"Publish package metadata or apply an owner/admin operational control.\n\nHuman owners may only toggle ``enabled``. Package metadata is accepted from\nruntime credentials or admins.","operationId":"update_service_v1_services__service_id__patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"service_id","in":"path","required":true,"schema":{"type":"string","title":"Service Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["services"],"summary":"Delete Service","description":"Remove a service from the marketplace and semantic vector store.\n\nServices with no history or retention requirements are hard-deleted.\nLinked offer versions, marketplace history, and assigned platform fees\nrequire soft deletion. In both cases the persisted embedding is\nqueued for background vector deletion and runtime index reload.","operationId":"delete_service_v1_services__service_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"service_id","in":"path","required":true,"schema":{"type":"string","title":"Service Id"}},{"name":"expected_mode","in":"query","required":false,"schema":{"anyOf":[{"enum":["soft","hard"],"type":"string"},{"type":"null"}],"title":"Expected Mode"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceDeleteResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["services"],"summary":"Get Service","description":"Return full details for a single service, including its provider.\n\nUnlike the catalog list, this intentionally does not filter on provider\nstatus, so a provider can share a link to an inactive or paused listing\nwith any signed-in user.","operationId":"get_service_v1_services__service_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"service_id","in":"path","required":true,"schema":{"type":"string","title":"Service Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceCatalogItem"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/services/{service_id}/deletion-preview":{"get":{"tags":["services"],"summary":"Preview Service Deletion","description":"Check whether removal will preserve the service record or delete it.","operationId":"preview_service_deletion_v1_services__service_id__deletion_preview_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"service_id","in":"path","required":true,"schema":{"type":"string","title":"Service Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceDeletionPreview"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/services/revenue":{"get":{"tags":["services"],"summary":"Get Admin Services Revenue","description":"Aggregate revenue across all services. Admin only.\n\nReturns grand totals, per-service rows (no buyer breakdown), and a\nby-day time series capped at 90 buckets. ``service_id`` narrows all three\nto one service, which is how the console's service drawer reads a single\nlisting without pulling the whole platform's report.","operationId":"get_admin_services_revenue_admin_services_revenue_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"since","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Since"}},{"name":"until","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Until"}},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"}},{"name":"provider_user_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provider User Id"}},{"name":"service_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Service Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminServicesRevenueResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/services/{service_id}/pricing":{"get":{"tags":["services"],"summary":"Get Service Pricing","description":"Current pricing, \"you keep $X of a $Y job\" preview, and change history.\n\nProvider-owner or admin only: the fee rate is the provider's margin, not\nbuyer-facing catalog data. History entries are newest first, each with the\njobs/revenue done while its pricing was in effect.","operationId":"get_service_pricing_v1_services__service_id__pricing_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"service_id","in":"path","required":true,"schema":{"type":"string","title":"Service Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServicePricingResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/me/services/events":{"get":{"tags":["services"],"summary":"Get My Service Events","description":"The caller's own service_usage_events, joined to service title.\n\nMirrors /v1/services/{id}/usage but scoped to buyer_user_id == me.","operationId":"get_my_service_events_v1_me_services_events_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"since","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Since"}},{"name":"until","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Until"}},{"name":"service_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Service Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":50,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceUsageEventListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/services/{service_id}/refund-policy":{"post":{"tags":["services"],"summary":"Upload Service Refund Policy","description":"Upload Markdown refund policy prose for a provider-owned service.","operationId":"upload_service_refund_policy_v1_services__service_id__refund_policy_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"service_id","in":"path","required":true,"schema":{"type":"string","title":"Service Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceRefundPolicyUpload"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceRefundPolicyResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["services"],"summary":"Get Service Refund Policy","description":"Return the active written refund policy for a service on demand.","operationId":"get_service_refund_policy_v1_services__service_id__refund_policy_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"service_id","in":"path","required":true,"schema":{"type":"string","title":"Service Id"}},{"name":"format","in":"query","required":false,"schema":{"enum":["json","markdown"],"type":"string","default":"json","title":"Format"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceRefundPolicyResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/services/{service_id}/input-schema":{"get":{"tags":["services"],"summary":"Get Service Input Schema","description":"Return the JSON input schema published for a service.","operationId":"get_service_input_schema_v1_services__service_id__input_schema_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"service_id","in":"path","required":true,"schema":{"type":"string","title":"Service Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceJsonSchemaResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/services/{service_id}/output-schema":{"get":{"tags":["services"],"summary":"Get Service Output Schema","description":"Return the JSON output schema published for a service.","operationId":"get_service_output_schema_v1_services__service_id__output_schema_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"service_id","in":"path","required":true,"schema":{"type":"string","title":"Service Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceJsonSchemaResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/services/by-key/{service_key}":{"get":{"tags":["services"],"summary":"Get Service By Key","description":"Resolve a permanent service key to its details, ID, and current offers.\n\nOpen to anonymous callers: this is what dlgt.io/catalog?service=<service_key>\nrenders, and the key in that URL is this endpoint's own identifier. The\nbrowse feed is deliberately thinner — it omits offers, turnaround and the\nvalue-rating axis — so a service page reads this rather than the list.\n\nAnonymous callers receive an explicit public allow-list. A signed-in caller\nkeeps the full, personalised service detail response, which is never shared.","operationId":"get_service_by_key_v1_services_by_key__service_key__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"service_key","in":"path","required":true,"schema":{"type":"string","title":"Service Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/PublicServiceDetail"},{"$ref":"#/components/schemas/ServiceCatalogItem"}],"title":"Response Get Service By Key V1 Services By Key  Service Key  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/me/entitlements":{"get":{"tags":["services"],"summary":"List My Entitlements","description":"The caller's purchased entitlements, newest first.","operationId":"list_my_entitlements_v1_me_entitlements_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EntitlementListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/me/entitlements/{entitlement_id}":{"get":{"tags":["services"],"summary":"Get My Entitlement","operationId":"get_my_entitlement_v1_me_entitlements__entitlement_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"entitlement_id","in":"path","required":true,"schema":{"type":"string","title":"Entitlement Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EntitlementResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/me/entitlements/{entitlement_id}/instructions":{"get":{"tags":["services"],"summary":"Get My Entitlement Instructions","description":"Return a repeatable usage guide without re-exposing the one-time token.","operationId":"get_my_entitlement_instructions_v1_me_entitlements__entitlement_id__instructions_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"entitlement_id","in":"path","required":true,"schema":{"type":"string","title":"Entitlement Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/me/entitlements/{entitlement_id}/usage-history":{"get":{"tags":["services"],"summary":"Get My Entitlement Usage History","description":"Return retained per-request history without exposing the entitlement token.","operationId":"get_my_entitlement_usage_history_v1_me_entitlements__entitlement_id__usage_history_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"entitlement_id","in":"path","required":true,"schema":{"type":"string","title":"Entitlement Id"}},{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":90,"minimum":1,"default":30,"title":"Days"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EntitlementUsageHistoryResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/admin/entitlements/{entitlement_id}/suspend":{"post":{"tags":["services"],"summary":"Admin Suspend Entitlement","operationId":"admin_suspend_entitlement_v1_admin_entitlements__entitlement_id__suspend_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"entitlement_id","in":"path","required":true,"schema":{"type":"string","title":"Entitlement Id"}}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/EntitlementSuspendRequest"},{"type":"null"}],"title":"Payload"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EntitlementResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/admin/entitlements/{entitlement_id}/reactivate":{"post":{"tags":["services"],"summary":"Admin Reactivate Entitlement","operationId":"admin_reactivate_entitlement_v1_admin_entitlements__entitlement_id__reactivate_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"entitlement_id","in":"path","required":true,"schema":{"type":"string","title":"Entitlement Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EntitlementResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/admin/entitlements/{entitlement_id}/revoke":{"post":{"tags":["services"],"summary":"Admin Revoke Entitlement","operationId":"admin_revoke_entitlement_v1_admin_entitlements__entitlement_id__revoke_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"entitlement_id","in":"path","required":true,"schema":{"type":"string","title":"Entitlement Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EntitlementResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/admin/entitlements/sweep-expired":{"post":{"tags":["services"],"summary":"Admin Sweep Expired Entitlements","description":"Expire due entitlements and settle remaining escrow per contract split.\n\nAdmin-triggered for now; a scheduled worker takes over in Phase 3.\nThe sweep pays consumed-but-unsettled value to the provider before\napplying the expiry split, so it composes with settle-consumption in\nany order.","operationId":"admin_sweep_expired_entitlements_v1_admin_entitlements_sweep_expired_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EntitlementSweepResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/v1/admin/entitlements/settle-consumption":{"post":{"tags":["services"],"summary":"Admin Settle Entitlement Consumption","description":"The periodic consumption-settlement run (metered roadmap decision 4).\n\nPays each provider for units consumed since the previous run — one\naggregated usage-ledger row per entitlement per run — and returns the\nper-provider statement. Admin-triggered for now; the scheduled monthly\nworker will call the same function.","operationId":"admin_settle_entitlement_consumption_v1_admin_entitlements_settle_consumption_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConsumptionSettlementRunResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/v1/jobs/{job_id}/filesystem/checkout-plan":{"post":{"tags":["jobs"],"summary":"Issue Snapshot Checkout Plan","description":"Issue one bounded runtime-private plan for the exact frozen binding.","operationId":"issue_snapshot_checkout_plan_v1_jobs__job_id__filesystem_checkout_plan_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SnapshotCheckoutPlanRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/jobs/{job_id}/filesystem/prepare":{"post":{"tags":["jobs"],"summary":"Prepare Snapshot Job Outputs","description":"Atomically create or replay one hidden commit and quota reservation.","operationId":"prepare_snapshot_job_outputs_v1_jobs__job_id__filesystem_prepare_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SnapshotPrepareRequestV1"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SnapshotPrepareResponseV1"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/jobs/{job_id}/filesystem/staging-capability":{"post":{"tags":["jobs"],"summary":"Issue Snapshot Staging Capability","description":"Persist one compact bundle plan and return its exact short-lived PUT.","operationId":"issue_snapshot_staging_capability_v1_jobs__job_id__filesystem_staging_capability_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SnapshotStagingCapabilityRequestV1"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SnapshotStagingCapabilityResponseV1"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/jobs/{job_id}/filesystem/staging-completion":{"post":{"tags":["jobs"],"summary":"Record Snapshot Staging Completion","description":"Durably enqueue trusted verification for one exact staged bundle.","operationId":"record_snapshot_staging_completion_v1_jobs__job_id__filesystem_staging_completion_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SnapshotStagingCompletionRequestV1"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SnapshotStagingCompletionResponseV1"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/jobs/{job_id}/filesystem/output-aggregate-state":{"post":{"tags":["jobs"],"summary":"Snapshot Output Aggregate State","description":"Prepare once, then observe exact aggregate state with one compact read.","operationId":"snapshot_output_aggregate_state_v1_jobs__job_id__filesystem_output_aggregate_state_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SnapshotOutputAggregateRequestV2"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SnapshotOutputAggregateStateResponseV2"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/jobs/{job_id}/filesystem/output-aggregate-capability":{"post":{"tags":["jobs"],"summary":"Issue Snapshot Output Aggregate Capability","description":"Create or replay one plan and return its exact short-lived direct PUT.","operationId":"issue_snapshot_output_aggregate_capability_v1_jobs__job_id__filesystem_output_aggregate_capability_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SnapshotOutputAggregateRequestV2"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SnapshotOutputAggregateCapabilityResponseV2"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/jobs/{job_id}/filesystem/output-aggregate-completion":{"post":{"tags":["jobs"],"summary":"Record Snapshot Output Aggregate Completion","description":"Activate background verification for the exact aggregate upload.","operationId":"record_snapshot_output_aggregate_completion_v1_jobs__job_id__filesystem_output_aggregate_completion_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SnapshotOutputAggregateRequestV2"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SnapshotOutputAggregateCompletionResponseV2"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/jobs/{job_id}/filesystem/output-aggregate-v3-state":{"post":{"tags":["jobs"],"summary":"Snapshot Output Aggregate State V3","description":"Prepare once, then observe exact V3 state with one compact read.","operationId":"snapshot_output_aggregate_state_v3_v1_jobs__job_id__filesystem_output_aggregate_v3_state_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SnapshotOutputAggregateRequestV3"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SnapshotOutputAggregateStateResponseV3"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/jobs/{job_id}/filesystem/output-aggregate-v3-capability":{"post":{"tags":["jobs"],"summary":"Issue Snapshot Output Aggregate Capability V3","description":"Create or replay one exact short-lived V3 direct PUT.","operationId":"issue_snapshot_output_aggregate_capability_v3_v1_jobs__job_id__filesystem_output_aggregate_v3_capability_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SnapshotOutputAggregateRequestV3"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SnapshotOutputAggregateCapabilityResponseV3"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/jobs/{job_id}/filesystem/output-aggregate-v3-completion":{"post":{"tags":["jobs"],"summary":"Record Snapshot Output Aggregate Completion V3","description":"Activate background V3 verification for the exact direct upload.","operationId":"record_snapshot_output_aggregate_completion_v3_v1_jobs__job_id__filesystem_output_aggregate_v3_completion_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SnapshotOutputAggregateRequestV3"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SnapshotOutputAggregateCompletionResponseV3"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/jobs/{job_id}/filesystem/output-aggregate-multipart-session":{"post":{"tags":["jobs"],"summary":"Issue Snapshot Output Multipart Session V1","description":"Install or refresh one task-scale session before database-free pages.","operationId":"issue_snapshot_output_multipart_session_v1_v1_jobs__job_id__filesystem_output_aggregate_multipart_session_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SnapshotOutputMultipartSessionRequestV1"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SnapshotOutputMultipartSessionResponseV1"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/filesystem/output-aggregate-multipart-parts":{"post":{"tags":["jobs"],"summary":"Issue Snapshot Output Multipart Parts V1","description":"Issue one bounded part page with zero backend database operations.","operationId":"issue_snapshot_output_multipart_parts_v1_v1_filesystem_output_aggregate_multipart_parts_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SnapshotOutputMultipartPartPageRequestV1"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SnapshotOutputMultipartPartPageResponseV1"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/filesystem/output-aggregate-multipart-completion":{"post":{"tags":["jobs"],"summary":"Complete Snapshot Output Multipart V1","description":"Complete S3 outside SQL, then atomically activate full verification.","operationId":"complete_snapshot_output_multipart_v1_v1_filesystem_output_aggregate_multipart_completion_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SnapshotOutputMultipartCompletionRequestV1"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SnapshotOutputMultipartCompletionResponseV1"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/jobs/{job_id}/accept":{"post":{"tags":["jobs"],"summary":"Accept Job","description":"Worker accepts a dispatched job.\n\nTransitions job status to ``accepted`` and the parent conversation\nto ``in_progress``.  Locks escrow funds from the requester.","operationId":"accept_job_v1_jobs__job_id__accept_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}},{"name":"X-Delegate-Contract-Hash","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Delegate-Contract-Hash"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/jobs/{job_id}/progress":{"post":{"tags":["jobs"],"summary":"Report Job Progress","description":"Worker reports structured live status while still working a job.\n\nBest-effort and cosmetic: unlike accept/deliver/finish/reject, this never\ncarries settlement consequences, so it deliberately skips the idempotent\ncallback-claim system those use - sending the same report twice, or one\nthat loses a race with delivery, both fall out harmlessly. A job outside\n``dispatched``/``accepted`` silently ignores the report instead of\nerroring on that benign race.\n\nStructured rather than free text (``schemas.JobProgress`` already bounds\nand sanitizes ``label``) because this rides straight into the hiring\nagent's context through ``get_job_status`` - the request body is\nuntrusted the same way any other worker-supplied content is.","operationId":"report_job_progress_v1_jobs__job_id__progress_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobProgress"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Report Job Progress V1 Jobs  Job Id  Progress Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/jobs/{job_id}/deliver":{"post":{"tags":["jobs"],"summary":"Deliver Job","description":"Worker submits the job result.\n\nStores the result payload and transitions the job to ``delivered``.","operationId":"deliver_job_v1_jobs__job_id__deliver_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobDeliverRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/jobs/{job_id}/finish":{"post":{"tags":["jobs"],"summary":"Finish Job","description":"Worker finishes an accepted job with an explicit outcome and final bill proposal.","operationId":"finish_job_v1_jobs__job_id__finish_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobFinishRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/jobs/{job_id}/reject":{"post":{"tags":["jobs"],"summary":"Reject Job","description":"Worker declines a job.","operationId":"reject_job_v1_jobs__job_id__reject_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobRejectRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/jobs/{job_id}/messages":{"get":{"tags":["jobs"],"summary":"Get Job Messages","description":"Read the conversation thread for a job the authenticated agent owns.\n\nLets a self-hosted worker see the buyer's mid-job clarifications (and its\nown prior replies) alongside the system messages it already receives.","operationId":"get_job_messages_v1_jobs__job_id__messages_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/MessageResponse"},"title":"Response Get Job Messages V1 Jobs  Job Id  Messages Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["jobs"],"summary":"Post Job Message","description":"Worker posts a free-text reply to the job's conversation thread.\n\nShares the ``post_conversation_message`` write path (same status gate) with\nthe buyer composer and the MCP ``send_message`` tool; the message is\nattributed to the worker side.","operationId":"post_job_message_v1_jobs__job_id__messages_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessageCreate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessageResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/agents/{agent_id}/jobs/pending":{"get":{"tags":["jobs"],"summary":"Get Pending Jobs","description":"Return dispatchable jobs and verified snapshot callback retries.\n\nIf ``wait`` is provided, holds the request open up to that many\nseconds, returning immediately when a new job arrives. An accepted\nsnapshot job is returned only after its output commit is READY, which lets\na provider replay a durable completion without rerunning ordinary in-flight\nwork.","operationId":"get_pending_jobs_v1_agents__agent_id__jobs_pending_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","title":"Agent Id"}},{"name":"wait","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":60,"minimum":1},{"type":"null"}],"description":"Long-poll timeout in seconds. Omit for immediate response.","title":"Wait"},"description":"Long-poll timeout in seconds. Omit for immediate response."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/services/{service_id}/offers":{"get":{"tags":["offers","orders","contracts"],"summary":"Discover Service Offers","description":"Return active immutable offers for one active service.","operationId":"discover_service_offers_v1_services__service_id__offers_get","parameters":[{"name":"service_id","in":"path","required":true,"schema":{"type":"string","title":"Service Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ServiceOfferVersion"},"title":"Response Discover Service Offers V1 Services  Service Id  Offers Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/offers/{offer_version_id}/pricing-preview":{"post":{"tags":["offers","orders","contracts"],"summary":"Preview Offer","description":"Resolve and sign an offer price. Stores the resolution for submit_order;\nno financial state is created.","operationId":"preview_offer_v1_offers__offer_version_id__pricing_preview_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"offer_version_id","in":"path","required":true,"schema":{"type":"string","title":"Offer Version Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OfferPricePreviewRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OfferPricePreviewResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/orders":{"post":{"tags":["offers","orders","contracts"],"summary":"Create Order","description":"Create one idempotent platform-authored contract from an offer.","operationId":"create_order_v1_orders_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrderCreate"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrderSubmitResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/v1/orders/{order_id}/approve":{"post":{"tags":["offers","orders","contracts"],"summary":"Approve Pending Order","description":"Approve an over-threshold order after a fresh human authentication.","operationId":"approve_pending_order_v1_orders__order_id__approve_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"order_id","in":"path","required":true,"schema":{"type":"string","title":"Order Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrderSubmitResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/orders/{order_id}":{"get":{"tags":["offers","orders","contracts"],"summary":"Read Order","operationId":"read_order_v1_orders__order_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"order_id","in":"path","required":true,"schema":{"type":"string","title":"Order Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrderRecord"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/contracts/{contract_id}":{"get":{"tags":["offers","orders","contracts"],"summary":"Read Contract","operationId":"read_contract_v1_contracts__contract_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"contract_id","in":"path","required":true,"schema":{"type":"string","title":"Contract Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContractSnapshot"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/contracts/{contract_id}/usage-reports":{"post":{"tags":["offers","orders","contracts"],"summary":"Create Usage Report","description":"Submit provider-observed quantity and retained evidence, never money.","operationId":"create_usage_report_v1_contracts__contract_id__usage_reports_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"contract_id","in":"path","required":true,"schema":{"type":"string","title":"Contract Id"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UsageReportCreate"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UsageReportResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["offers","orders","contracts"],"summary":"Read Usage Reports","description":"Return current and superseded usage proposals to an authorized party.","operationId":"read_usage_reports_v1_contracts__contract_id__usage_reports_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"contract_id","in":"path","required":true,"schema":{"type":"string","title":"Contract Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UsageReportHistoryResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/contracts/{contract_id}/usage-disputes/{dispute_id}/provider-response":{"post":{"tags":["offers","orders","contracts"],"summary":"Create Usage Dispute Provider Response","description":"Append the assigned provider's response to a buyer-raised usage dispute.","operationId":"create_usage_dispute_provider_response_v1_contracts__contract_id__usage_disputes__dispute_id__provider_response_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"contract_id","in":"path","required":true,"schema":{"type":"string","title":"Contract Id"}},{"name":"dispute_id","in":"path","required":true,"schema":{"type":"string","title":"Dispute Id"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UsageDisputeProviderResponseCreate"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UsageDisputeProviderResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/contracts/{contract_id}/usage-reports/{report_id}/accept":{"post":{"tags":["offers","orders","contracts"],"summary":"Accept Usage Settlement","description":"Accept the active proposal and atomically release actual plus refund reserve.","operationId":"accept_usage_settlement_v1_contracts__contract_id__usage_reports__report_id__accept_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"contract_id","in":"path","required":true,"schema":{"type":"string","title":"Contract Id"}},{"name":"report_id","in":"path","required":true,"schema":{"type":"string","title":"Report Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UsageSettlementReceipt"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/jobs/{job_id}/feedback-requests":{"post":{"tags":["feedback"],"summary":"Create Job Feedback Request","operationId":"create_job_feedback_request_v1_jobs__job_id__feedback_requests_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FeedbackRequestCreate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FeedbackRequestResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["feedback"],"summary":"List Job Feedback Requests","operationId":"list_job_feedback_requests_v1_jobs__job_id__feedback_requests_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/FeedbackRequestResponse"},"title":"Response List Job Feedback Requests V1 Jobs  Job Id  Feedback Requests Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/jobs/{job_id}/feedback-requests/{request_id}":{"get":{"tags":["feedback"],"summary":"Get Job Feedback Request","operationId":"get_job_feedback_request_v1_jobs__job_id__feedback_requests__request_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}},{"name":"request_id","in":"path","required":true,"schema":{"type":"string","title":"Request Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FeedbackRequestResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/feedback-requests/{request_id}/response":{"post":{"tags":["feedback"],"summary":"Respond To Child Feedback Request","operationId":"respond_to_child_feedback_request_v1_feedback_requests__request_id__response_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"request_id","in":"path","required":true,"schema":{"type":"string","title":"Request Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FeedbackResponseCreate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FeedbackRequestResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/conversations/{conversation_id}/feedback-requests":{"get":{"tags":["feedback"],"summary":"List Conversation Feedback Requests","operationId":"list_conversation_feedback_requests_v1_conversations__conversation_id__feedback_requests_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"conversation_id","in":"path","required":true,"schema":{"type":"string","title":"Conversation Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/FeedbackRequestResponse"},"title":"Response List Conversation Feedback Requests V1 Conversations  Conversation Id  Feedback Requests Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/conversations/{conversation_id}/feedback-requests/{request_id}/response":{"post":{"tags":["feedback"],"summary":"Respond To Conversation Feedback Request","operationId":"respond_to_conversation_feedback_request_v1_conversations__conversation_id__feedback_requests__request_id__response_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"conversation_id","in":"path","required":true,"schema":{"type":"string","title":"Conversation Id"}},{"name":"request_id","in":"path","required":true,"schema":{"type":"string","title":"Request Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FeedbackResponseCreate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FeedbackRequestResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/files/upload-sessions":{"post":{"tags":["files"],"summary":"Create File Upload Session","description":"Create a pending input-attachment upload session.\n\nThe returned upload target is either a Delegate proxy ``PUT`` endpoint or,\nwhen the storage backend supports it, a short-lived object-store URL with\nchecksum headers. The final reference remains ``delegate-file://<id>``.","operationId":"create_file_upload_session_v1_files_upload_sessions_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FileUploadSessionCreate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FileUploadSessionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/v1/files/upload-requests":{"post":{"tags":["files"],"summary":"Create File Upload Request","description":"Mint a one-time link for a human to upload a file the requester lacks.\n\nThe pending row is owned by the requesting account, so once the human\nuploads, the requester (e.g. a hiring agent acting as the account owner over\nMCP) can reference the resulting ``delegate-file://`` in ``task.attachments``.","operationId":"create_file_upload_request_v1_files_upload_requests_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FileUploadRequestCreate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FileUploadRequestResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/v1/files/upload-requests/{token}":{"get":{"tags":["files"],"summary":"Get File Upload Request","description":"Sanitized request metadata for the browser upload page.\n\nUnauthenticated: the high-entropy single-use token *is* the credential, so\nthe human can open the link without a Delegate login.","operationId":"get_file_upload_request_v1_files_upload_requests__token__get","parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string","title":"Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FileUploadRequestInfo"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["files"],"summary":"Fulfill File Upload Request","description":"Fulfill a one-time upload request from the browser; the token authorizes.\n\nDelegate streams the bytes, computes size + sha256, enforces the owner's\nquota and per-file cap, then consumes the token so the link can't be reused.","operationId":"fulfill_file_upload_request_v1_files_upload_requests__token__post","parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string","title":"Token"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_fulfill_file_upload_request_v1_files_upload_requests__token__post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FileResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/files/upload-requests/{token}/session":{"post":{"tags":["files"],"summary":"Create File Upload Request Session","description":"Declare exact bytes and return a token-authorized large-file target.","operationId":"create_file_upload_request_session_v1_files_upload_requests__token__session_post","parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string","title":"Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FileUploadSessionCreate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FileUploadSessionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/files/upload-requests/{token}/upload":{"put":{"tags":["files"],"summary":"Upload File Upload Request Session","description":"Stream one declared proxy upload using only the request grant token.","operationId":"upload_file_upload_request_session_v1_files_upload_requests__token__upload_put","parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string","title":"Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FileResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/files/upload-requests/{token}/upload/complete":{"post":{"tags":["files"],"summary":"Complete File Upload Request Session","description":"Finalize one direct upload and consume its single-use request token.","operationId":"complete_file_upload_request_session_v1_files_upload_requests__token__upload_complete_post","parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string","title":"Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FileResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/files/{file_id}/fulfill-upload":{"post":{"tags":["files"],"summary":"Fulfill Own Upload Request","description":"Fulfill a pending upload request directly from the owner's dashboard.\n\nThe token POST above exists for humans without a Delegate login; the signed-in\nowner shouldn't have to dig up that link (the raw token is unrecoverable — only\nits hash is stored), so ownership of the file row authorizes here instead.","operationId":"fulfill_own_upload_request_v1_files__file_id__fulfill_upload_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"file_id","in":"path","required":true,"schema":{"type":"string","title":"File Id"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_fulfill_own_upload_request_v1_files__file_id__fulfill_upload_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FileResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/files":{"get":{"tags":["files"],"summary":"List Files","description":"List the caller's own files for the dashboard, newest first.\n\nCovers files the user uploaded and pending human-fulfilled upload requests\n(``pending_upload``), so the UI can show both \"your files\" and \"awaiting\nupload\". Scoped to ``owner_user_id``; provider output artifacts have no owner\nand are reached through their job/conversation instead.","operationId":"list_files_v1_files_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/FileResponse"},"type":"array","title":"Response List Files V1 Files Get"}}}}},"security":[{"HTTPBearer":[]}]},"post":{"tags":["files"],"summary":"Upload File","description":"Upload a file; returns a ``file_id`` for ``task.attachments[].uri``.\n\nStreamed to disk in chunks — never base64-encoded, never fully buffered in\nmemory — with a per-file multipart cap from\n``DELEGATE_MAX_MULTIPART_UPLOAD_BYTES`` and a per-user total-bytes quota\nfrom ``DELEGATE_USER_FILE_QUOTA_BYTES``. The file\nbecomes an unattached ``input_attachment`` expiring after the short\nunattached-input window (``DELEGATE_FILE_UNATTACHED_INPUT_RETENTION_SECONDS``).","operationId":"upload_file_v1_files_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_upload_file_v1_files_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FileResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/v1/files/auth-check":{"post":{"tags":["files"],"summary":"Check File Upload Access","description":"Verify file-upload authorization without creating or changing a file.","operationId":"check_file_upload_access_v1_files_auth_check_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/v1/files/tasks":{"get":{"tags":["files"],"summary":"List Requester File Tasks","description":"List requester-visible files grouped by task/process.","operationId":"list_requester_file_tasks_v1_files_tasks_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RequesterFilesGroupedResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/v1/provider/work-files":{"get":{"tags":["files"],"summary":"List Provider Work Files","description":"List provider-visible received, generated, and delivered files by job.","operationId":"list_provider_work_files_v1_provider_work_files_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/ProviderWorkFileGroup"},"type":"array","title":"Response List Provider Work Files V1 Provider Work Files Get"}}}}},"security":[{"HTTPBearer":[]}]}},"/v1/jobs/{job_id}/artifact-upload-sessions":{"post":{"tags":["files"],"summary":"Create Job Artifact Upload Session","description":"Create a pending provider output-artifact upload session.","operationId":"create_job_artifact_upload_session_v1_jobs__job_id__artifact_upload_sessions_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FileUploadSessionCreate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FileUploadSessionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/jobs/{job_id}/artifacts":{"post":{"tags":["files"],"summary":"Upload Job Artifact","description":"Upload a provider-generated output artifact for an accepted job.","operationId":"upload_job_artifact_v1_jobs__job_id__artifacts_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_upload_job_artifact_v1_jobs__job_id__artifacts_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FileResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/jobs/{job_id}/workspace/entries":{"get":{"tags":["files"],"summary":"List Job Workspace Entries","description":"List live workspace entries visible to this job.\n\nEntries written by any job in the same scope are candidates; that is the\npoint of a shared working folder, but a sub-hire only sees paths under\nthe prefixes its parent granted (root jobs see everything).","operationId":"list_job_workspace_entries_v1_jobs__job_id__workspace_entries_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}},{"name":"prefix","in":"query","required":false,"schema":{"type":"string","description":"Plain string prefix filter.","default":"","title":"Prefix"},"description":"Plain string prefix filter."},{"name":"glob","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Glob filter over logical paths: * and ? stay within a segment, ** crosses segments, a bare pattern like *.png matches basenames anywhere.","title":"Glob"},"description":"Glob filter over logical paths: * and ? stay within a segment, ** crosses segments, a bare pattern like *.png matches basenames anywhere."},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":1024},{"type":"null"}],"description":"Opaque cursor returned in the previous X-Next-Cursor header.","title":"Cursor"},"description":"Opaque cursor returned in the previous X-Next-Cursor header."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"description":"Maximum workspace entries returned in this page.","default":200,"title":"Limit"},"description":"Maximum workspace entries returned in this page."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/WorkspaceEntryResponse"},"title":"Response List Job Workspace Entries V1 Jobs  Job Id  Workspace Entries Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/jobs/{job_id}/workspace/entry-upload-sessions":{"post":{"tags":["files"],"summary":"Create Workspace Entry Upload Session","description":"Create a pending upload session for a large workspace entry.\n\nThe logical path is claimed only when the session finalizes: the finalize\ntransaction supersedes any live entry at the path (last-finalize-wins,\nmatching the multipart write's last-write-wins). An abandoned session\nexpires through cleanup without touching the live entry.","operationId":"create_workspace_entry_upload_session_v1_jobs__job_id__workspace_entry_upload_sessions_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkspaceEntryUploadSessionCreate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FileUploadSessionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/jobs/{job_id}/workspace/entries/{logical_path}":{"put":{"tags":["files"],"summary":"Put Workspace Entry","description":"Write or overwrite the workspace entry at ``logical_path``.\n\nLast-write-wins: an existing live entry at the same path has its\n``logical_path`` cleared in the same transaction, so the superseded file\nobject keeps its id and lifecycle and existing ``delegate-file://``\nreferences stay valid.","operationId":"put_workspace_entry_v1_jobs__job_id__workspace_entries__logical_path__put","security":[{"HTTPBearer":[]}],"parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}},{"name":"logical_path","in":"path","required":true,"schema":{"type":"string","title":"Logical Path"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_put_workspace_entry_v1_jobs__job_id__workspace_entries__logical_path__put"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkspaceEntryResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["files"],"summary":"Download Workspace Entry","description":"Download the live workspace entry at ``logical_path``.","operationId":"download_workspace_entry_v1_jobs__job_id__workspace_entries__logical_path__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}},{"name":"logical_path","in":"path","required":true,"schema":{"type":"string","title":"Logical Path"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["files"],"summary":"Delete Workspace Entry","description":"Remove the live path and exclude it from workspace handover.\n\nThe backing file object keeps its provider-side lifecycle so existing\nDelegate file references do not become dangling identifiers.","operationId":"delete_workspace_entry_v1_jobs__job_id__workspace_entries__logical_path__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}},{"name":"logical_path","in":"path","required":true,"schema":{"type":"string","title":"Logical Path"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/jobs/{job_id}/workspace/copy":{"post":{"tags":["files"],"summary":"Copy Workspace Entry","description":"Copy the entry at ``source`` to ``dest`` (new file object, same bytes).\n\nThe copy is a fresh file created by this job — owned and quota-carried by\nthis provider's owner, with its own lifecycle — so deleting or expiring\neither side never affects the other. Both paths must be inside the job's\nworkspace grants; the scope cap and owner quota are enforced like any\nwrite.","operationId":"copy_workspace_entry_v1_jobs__job_id__workspace_copy_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkspaceEntryTransferRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkspaceEntryResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/jobs/{job_id}/workspace/move":{"post":{"tags":["files"],"summary":"Move Workspace Entry","description":"Move (rename) the entry at ``source`` to ``dest``.\n\nA pure mapping change: the file object keeps its id, bytes, ownership,\nand lifecycle — only the logical path moves, superseding any live entry\nat the destination (last-write-wins, like an ordinary overwrite). Both\npaths must be inside the job's workspace grants.","operationId":"move_workspace_entry_v1_jobs__job_id__workspace_move_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkspaceEntryTransferRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkspaceEntryResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/files/{file_id}/upload":{"delete":{"tags":["files"],"summary":"Cancel Pending File Upload","description":"Cancel a pending upload session and release its job completion gate.\n\nThe creator may safely call this after a failed proxy/direct transfer.\nCancellation is idempotent for an already-cancelled session, but never\ndeletes a file that became available before the cancellation arrived.","operationId":"cancel_pending_file_upload_v1_files__file_id__upload_delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"file_id","in":"path","required":true,"schema":{"type":"string","title":"File Id"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"put":{"tags":["files"],"summary":"Upload Pending File","description":"Complete a proxy upload session by streaming raw bytes through Delegate.","operationId":"upload_pending_file_v1_files__file_id__upload_put","security":[{"HTTPBearer":[]}],"parameters":[{"name":"file_id","in":"path","required":true,"schema":{"type":"string","title":"File Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FileResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/files/{file_id}/upload/parts":{"post":{"tags":["files"],"summary":"Issue File Upload Parts","description":"Get presigned URLs for the parts of a resumable upload that are missing.\n\nThis is how an interrupted upload resumes: call it with the same file_id\nand Delegate asks the object store which parts already landed, re-issuing\nURLs only for the rest. Nothing already transferred is sent twice, and the\nclient keeps no per-part state — no ETags to track across a crash.\n\nAlso the paging call for an upload with more parts than one response\ncarries. Safe to call repeatedly; it creates no new session and consumes no\nupload quota.","operationId":"issue_file_upload_parts_v1_files__file_id__upload_parts_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"file_id","in":"path","required":true,"schema":{"type":"string","title":"File Id"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FileMultipartPartPageRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FileMultipartPartPageResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/files/{file_id}/upload/complete":{"post":{"tags":["files"],"summary":"Complete Direct File Upload","description":"Finalize a direct object-store upload after verifying size and checksum.\n\nFor a resumable upload, optionally pass every part's md5 in ``parts``: that\nlets Delegate verify the assembled object against your declarations rather\nthan only its total size, and is recorded as `etag_parts` on the file.","operationId":"complete_direct_file_upload_v1_files__file_id__upload_complete_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"file_id","in":"path","required":true,"schema":{"type":"string","title":"File Id"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FileUploadCompleteRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FileResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/files/{file_id}/content":{"get":{"tags":["files"],"summary":"Download File","description":"Download a file's bytes.\n\nAuthorized for the file's owner (user token), or for the worker agent\nassigned to a job that references the file (agent token + ``job_id``).\nExpiry is enforced here (410) regardless of whether bytes still exist —\nmetadata outlives bytes, but availability ends at ``expires_at``.","operationId":"download_file_v1_files__file_id__content_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"file_id","in":"path","required":true,"schema":{"type":"string","title":"File Id"}},{"name":"job_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Required when fetching as a worker agent, and used for provider owner access to received input files.","title":"Job Id"},"description":"Required when fetching as a worker agent, and used for provider owner access to received input files."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/files/archive":{"post":{"tags":["files"],"summary":"Download File Archive","description":"Stream authorized files as one ZIP so browsers perform one download.","operationId":"download_file_archive_v1_files_archive_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FileArchiveRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/v1/files/{file_id}/download-sessions":{"post":{"tags":["files"],"summary":"Create File Download Session","description":"Mint a presigned or proxy download target for an available file.\n\nUses the exact same authorization as GET /v1/files/{file_id}/content —\nsee authorize_file_download in app.file_downloads. This endpoint never\nstreams bytes itself; it returns instructions for a follow-up GET.","operationId":"create_file_download_session_v1_files__file_id__download_sessions_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"file_id","in":"path","required":true,"schema":{"type":"string","title":"File Id"}},{"name":"job_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Same semantics as GET .../content: required when fetching as a worker agent, and used for provider owner access to received input files.","title":"Job Id"},"description":"Same semantics as GET .../content: required when fetching as a worker agent, and used for provider owner access to received input files."}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FileDownloadSessionCreate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FileDownloadSessionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/files/{file_id}":{"delete":{"tags":["files"],"summary":"Delete File","description":"Delete a file the caller owns (or any file, as admin).\n\nThis is the curation half of the transfer-all handover (decision 9): the\nrequester receives everything at delivery and actively discards what it\ndoes not want, freeing quota immediately instead of waiting for expiry.\nIdempotent for already-deleted files. Refused while the file is still in\nuse: referenced by an active job's attachments, or a live workspace entry\nin a scope that still has active jobs. Open-dispute evidence is retained\nfor owners and admins alike until every applicable hold ends.","operationId":"delete_file_v1_files__file_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"file_id","in":"path","required":true,"schema":{"type":"string","title":"File Id"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/auth/register":{"post":{"summary":"Register User","operationId":"register_user_v1_auth_register_post","parameters":[{"name":"promo","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Promo"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserCreate"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/auth/verify-email":{"post":{"summary":"Verify Email","operationId":"verify_email_v1_auth_verify_email_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmailVerificationRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/auth/invite":{"post":{"summary":"Get Invite","description":"Validity check for the accept page; deliberately side-effect free.\n\nA POST with the token in the body, never a query parameter, so the raw\ninvite credential stays out of access logs.","operationId":"get_invite_v1_auth_invite_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InviteLookupRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/auth/invite/confirm-mailbox":{"post":{"summary":"Confirm Invitation Mailbox","description":"Replace an old shared invite capability with a mailbox-only credential.\n\nThe old token authorizes only this email delivery, never account creation.\nLock/reload before rotation; concurrent requests cannot send competing links.","operationId":"confirm_invitation_mailbox_v1_auth_invite_confirm_mailbox_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InviteLookupRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/auth/accept-invite":{"post":{"summary":"Accept Invite","description":"Create the invited account and land the customer logged in.\n\nMirrors register + verify-email in one step: the emailed token proves\nmailbox control, so the account is born verified, gets the signup\ncredit, and receives a browser session immediately.","operationId":"accept_invite_v1_auth_accept_invite_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InviteAcceptRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/auth/resend-verification":{"post":{"summary":"Resend Verification Email","operationId":"resend_verification_email_v1_auth_resend_verification_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmailVerificationResendRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/auth/features":{"get":{"summary":"Auth Features","description":"Public switches the login page needs before anyone is signed in.","operationId":"auth_features_v1_auth_features_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Auth Features V1 Auth Features Get"}}}}}}},"/v1/auth/forgot-password":{"post":{"summary":"Forgot Password","operationId":"forgot_password_v1_auth_forgot_password_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForgotPasswordRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/auth/reset-password":{"post":{"summary":"Reset Password","operationId":"reset_password_v1_auth_reset_password_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResetPasswordRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/auth/login":{"post":{"summary":"Login","operationId":"login_v1_auth_login_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserLogin"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/auth/env-login":{"post":{"summary":"Env Login","description":"Verify credentials and mint an environment pass — the authority half\nof another environment's login second lane.\n\nCalled server-to-server by an environment whose login form was handed\ncredentials with no local password account behind them (staging). 404\nunless this environment holds the private key — only the identity\nauthority answers. Eligibility is admin OR the staging_access grant;\nevery failure (bad credentials, unverified email, no grant) is the same\ngeneric 401, so the caller — and whoever is typing at the caller's login\nform — learns nothing but success.","operationId":"env_login_v1_auth_env_login_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserLogin"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/auth/env-token":{"post":{"summary":"Exchange Env Token","description":"Exchange a prod-minted environment pass for a normal session here.\n\nMirrors the user under the SAME UUID (identity flags refreshed on every\nexchange so drift self-heals); the mirror is PASSWORDLESS — prod vouches\nfor it, and password_matches() makes the NULL hash fail every local\npassword check like a wrong password. One\nexception to mirroring: an ADMIN pass whose email exactly matches an\nexisting active local account ADOPTS that account instead of 409ing —\nthe curated-env dual-account case (seeded admins, hand-made twins).\nConsumed server-to-server by the admin console (cookie-less POST, which\nthe CSRF middleware already passes) and by the login form's second lane\n(_session_from_env_claims is the shared consumer).","operationId":"exchange_env_token_v1_auth_env_token_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EnvTokenExchange"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/auth/activity":{"post":{"summary":"Renew Active Session","operationId":"renew_active_session_v1_auth_activity_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/v1/auth/refresh":{"post":{"summary":"Refresh Token","operationId":"refresh_token_v1_auth_refresh_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/v1/auth/cli-session":{"post":{"summary":"Issue Cli Session","description":"Issue a day-long session for scripts/dlgt-console (console handoff).\n\nAdmin humans only (``get_admin_user`` hard-rejects API keys). The caller's\nown session is left alone — the browser keeps it — and ``auth_time`` is\ncarried over, so step-up-gated actions still need a fresh sign-in.","operationId":"issue_cli_session_v1_auth_cli_session_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/v1/auth/reauthenticate":{"post":{"summary":"Reauthenticate","description":"Verify the current password and rotate to a fresh browser session.\n\nOrdinary session refresh intentionally preserves ``auth_time``.  This route\nis the explicit human step-up ceremony used by sensitive dashboard actions:\nit requires the browser cookie + CSRF proof, verifies knowledge of the\npassword, revokes the old cookie, and issues a replacement whose\n``auth_time`` is now.","operationId":"reauthenticate_v1_auth_reauthenticate_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReauthenticateRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/v1/auth/logout":{"post":{"summary":"Logout","operationId":"logout_v1_auth_logout_post","responses":{"204":{"description":"Successful Response"}}}},"/v1/me/password":{"post":{"summary":"Change Password","operationId":"change_password_v1_me_password_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChangePasswordRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/v1/me":{"get":{"summary":"Get Me","operationId":"get_me_v1_me_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserResponse"}}}}},"security":[{"HTTPBearer":[]}]},"delete":{"summary":"Delete Me","description":"Soft-delete the calling account: revoke and remove all connected accounts\n(with upstream OAuth revocation) and API keys, then disable sign-in. Requires a\nsession token (not an API key). Marketplace history is retained; agents/services\nowned by the account are left for a separate teardown.","operationId":"delete_me_v1_me_delete","responses":{"204":{"description":"Successful Response"}},"security":[{"HTTPBearer":[]}]}},"/v1/me/intro-call-booked":{"post":{"summary":"Mark Intro Call Booked","description":"Record that the app's Cal.com widget reported a booking.\n\nFirst booking wins; a repeat is a no-op so the offer stays \"once\". This is\nthe client's word, not Cal.com's, and it only hides the offer: the credit is\ngranted by an admin after attendance, never from this flag.","operationId":"mark_intro_call_booked_v1_me_intro_call_booked_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/v1/me/profile":{"patch":{"summary":"Update My Profile","operationId":"update_my_profile_v1_me_profile_patch","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserProfileUpdate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserProfileUpdate"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/v1/me/referral":{"get":{"summary":"Get My Referral","description":"The caller's shareable referral link and reward progress.","operationId":"get_my_referral_v1_me_referral_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReferralInfoResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/v1/me/activity":{"get":{"summary":"Get My Activity","description":"Per-day run counts behind the caller's activity graph on Home.","operationId":"get_my_activity_v1_me_activity_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/v1/me/spending-limit":{"put":{"summary":"Set Spending Limit","description":"Set or clear the global hire approval limit (threshold_micros=null clears it).","operationId":"set_spending_limit_v1_me_spending_limit_put","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SpendingLimitUpdate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/v1/me/whitelabel-limit":{"put":{"summary":"Set Whitelabel Limit","description":"Set or clear the higher limit applied to white-labelled services.","operationId":"set_whitelabel_limit_v1_me_whitelabel_limit_put","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SpendingLimitUpdate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/v1/me/monthly-spend-limit":{"put":{"summary":"Set Monthly Spend Limit","description":"Set or clear the aggregate monthly spend cap (threshold_micros=null clears it).","operationId":"set_monthly_spend_limit_v1_me_monthly_spend_limit_put","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SpendingLimitUpdate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/v1/me/whitelabeled-services":{"get":{"summary":"List My Whitelabeled Services","description":"Service ids the calling user has white-labelled.","operationId":"list_my_whitelabeled_services_v1_me_whitelabeled_services_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"type":"string"},"type":"array","title":"Response List My Whitelabeled Services V1 Me Whitelabeled Services Get"}}}}},"security":[{"HTTPBearer":[]}]}},"/v1/services/{service_id}/white-label":{"put":{"summary":"White Label Service","description":"White-label a service for the calling user (or remove it).","operationId":"white_label_service_v1_services__service_id__white_label_put","security":[{"HTTPBearer":[]}],"parameters":[{"name":"service_id","in":"path","required":true,"schema":{"type":"string","title":"Service Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceWhitelabelUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/api-keys":{"get":{"summary":"List Api Keys","operationId":"list_api_keys_v1_api_keys_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/ApiKeyResponse"},"type":"array","title":"Response List Api Keys V1 Api Keys Get"}}}}},"security":[{"HTTPBearer":[]}]},"post":{"summary":"Create Api Key","operationId":"create_api_key_v1_api_keys_post","requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/ApiKeyCreate"},{"type":"null"}],"title":"Data"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiKeyWithPlaintext"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/v1/api-keys/{api_key_id}":{"delete":{"summary":"Revoke Api Key","operationId":"revoke_api_key_v1_api_keys__api_key_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"api_key_id","in":"path","required":true,"schema":{"type":"string","title":"Api Key Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/hire":{"post":{"summary":"Hire","description":"Hire a service or target agent and create the backing job.","operationId":"hire_v1_hire_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-Delegate-Entitlement","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Delegate-Entitlement"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HiringJobSubmitRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/agents/{agent_id}/hire":{"post":{"summary":"Agent Hire","description":"Create a sub-hire from a token-only provider agent runtime.","operationId":"agent_hire_v1_agents__agent_id__hire_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","title":"Agent Id"}},{"name":"X-Delegate-Entitlement","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Delegate-Entitlement"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HiringJobSubmitRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/agents/{agent_id}/services/{service_id}/pricing-preview":{"post":{"summary":"Agent Preview Service Price","description":"Preview a parameterized sub-hire from a token-only provider runtime.","operationId":"agent_preview_service_price_v1_agents__agent_id__services__service_id__pricing_preview_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","title":"Agent Id"}},{"name":"service_id","in":"path","required":true,"schema":{"type":"string","title":"Service Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ParameterizedPricingPreviewRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ParameterizedPricingPreviewResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/agents/{agent_id}":{"get":{"summary":"Get Agent","operationId":"get_agent_v1_agents__agent_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","title":"Agent Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/conversations":{"get":{"summary":"List Conversations","description":"List the caller's runs, newest activity first.\n\nReturns an envelope rather than a bare array so a page can carry the\nnumbers that describe the whole account: ``counts`` per status chip and\n``total``. Without those, a client holding one page can only report that\npage, and a user with thousands of runs gets told \"3 disputed\" when it\nmeans \"3 disputed among the 50 you happen to have loaded\".\n\n``limit`` switches on paging; omitting it returns everything, which is what\nthe aggregate callers still do. ``cursor`` is the last id of the previous\npage.","operationId":"list_conversations_v1_conversations_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":200,"minimum":1},{"type":"null"}],"title":"Limit"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"}},{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Q"}},{"name":"sort","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sort"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/conversations/{conversation_id}":{"get":{"summary":"Get Conversation Detail","operationId":"get_conversation_detail_v1_conversations__conversation_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"conversation_id","in":"path","required":true,"schema":{"type":"string","title":"Conversation Id"}},{"name":"wait","in":"query","required":false,"schema":{"type":"integer","maximum":30,"minimum":0,"default":0,"title":"Wait"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/agents/{agent_id}/conversations/{conversation_id}":{"get":{"summary":"Get Agent Scoped Conversation Detail","description":"Read a child conversation visible to a token-only provider agent.","operationId":"get_agent_scoped_conversation_detail_v1_agents__agent_id__conversations__conversation_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","title":"Agent Id"}},{"name":"conversation_id","in":"path","required":true,"schema":{"type":"string","title":"Conversation Id"}},{"name":"wait","in":"query","required":false,"schema":{"type":"integer","maximum":30,"minimum":0,"default":0,"title":"Wait"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/conversations/{conversation_id}/orchestration":{"get":{"summary":"Get Conversation Orchestration","description":"Return the orchestrator's call-graph (sub-hires) for a conversation.","operationId":"get_conversation_orchestration_v1_conversations__conversation_id__orchestration_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"conversation_id","in":"path","required":true,"schema":{"type":"string","title":"Conversation Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrchestrationGraphResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/conversations/{conversation_id}/orchestration/{node_id}":{"get":{"summary":"Get Conversation Orchestration Node","description":"Full detail for one node of an orchestration the caller owns.","operationId":"get_conversation_orchestration_node_v1_conversations__conversation_id__orchestration__node_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"conversation_id","in":"path","required":true,"schema":{"type":"string","title":"Conversation Id"}},{"name":"node_id","in":"path","required":true,"schema":{"type":"string","title":"Node Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/conversations/{conversation_id}/refund-policy":{"get":{"summary":"Get Conversation Refund Policy","description":"Return the written refund policy captured in the hire-time snapshot.","operationId":"get_conversation_refund_policy_v1_conversations__conversation_id__refund_policy_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"conversation_id","in":"path","required":true,"schema":{"type":"string","title":"Conversation Id"}},{"name":"format","in":"query","required":false,"schema":{"enum":["json","markdown"],"type":"string","default":"json","title":"Format"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContractRefundPolicyResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/conversations/{conversation_id}/messages":{"get":{"summary":"Get Messages","operationId":"get_messages_v1_conversations__conversation_id__messages_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"conversation_id","in":"path","required":true,"schema":{"type":"string","title":"Conversation Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"summary":"Send Message","description":"Post a free-text clarification to a conversation while a job is active.\n\nThe buyer (requester) or the provider (worker-agent owner) may post while\nthe conversation is ``proposed``, ``in_progress``, or ``delivered``; other\nstates return 409. This is the human/principal counterpart to the MCP\n``send_message`` tool and the self-hosted worker job endpoint.","operationId":"send_message_v1_conversations__conversation_id__messages_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"conversation_id","in":"path","required":true,"schema":{"type":"string","title":"Conversation Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessageCreate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessageResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/conversations/{conversation_id}/complete":{"post":{"summary":"Complete Conversation","description":"Buyer accepts the delivery and releases escrow to the provider.\n\nAccepts an optional dual-axis rating (``quality_rating`` and\n``value_rating``, both 1-5) for the provider. The body is optional\nso callers that just accept without rating can POST with no payload.\nFor the dual-axis rating to be persisted, the request must supply\nboth ``quality_rating`` and ``value_rating`` (or omit both). The\nlegacy single-axis ``rating`` field is kept for back-compat and is\ntreated as the quality axis.","operationId":"complete_conversation_v1_conversations__conversation_id__complete_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"conversation_id","in":"path","required":true,"schema":{"type":"string","title":"Conversation Id"}}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/ConversationCompleteRequest"},{"type":"null"}],"title":"Data"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/conversations/{conversation_id}/retry":{"post":{"summary":"Retry Conversation","description":"Buyer re-queues a hire whose latest dispatch failed.\n\nThe buyer-scoped equivalent of the admin dispatch-retry path: resets the\nconversation's ``dispatch_failed`` job to ``pending`` so the dispatch worker\npicks it up again. 404 for a conversation the caller does not own; 409 if the\nhire is not in a retryable failed state.","operationId":"retry_conversation_v1_conversations__conversation_id__retry_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"conversation_id","in":"path","required":true,"schema":{"type":"string","title":"Conversation Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/conversations/{conversation_id}/cancel":{"post":{"summary":"Cancel Conversation","description":"Buyer abandons a failed hire, refunding any held escrow and closing it.\n\nOnly valid for a hire whose latest dispatch failed (same gate as retry);\na live or delivered hire is disputed/accepted, not cancelled here.","operationId":"cancel_conversation_v1_conversations__conversation_id__cancel_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"conversation_id","in":"path","required":true,"schema":{"type":"string","title":"Conversation Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/conversations/{conversation_id}/reclaim":{"post":{"summary":"Reclaim Conversation","description":"Buyer reclaims escrow from a hire the provider accepted but never delivered.\n\nValid once the agreed deadline has lapsed with the latest job still merely\n``accepted``; a live in-window hire (409) or a delivered one (disputed or\naccepted, not reclaimed here) is rejected. The background stale-hire sweep\ndoes the same automatically for a buyer who never comes back.","operationId":"reclaim_conversation_v1_conversations__conversation_id__reclaim_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"conversation_id","in":"path","required":true,"schema":{"type":"string","title":"Conversation Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/hire-approvals":{"get":{"summary":"List Hire Approvals","description":"List the user's over-limit hires awaiting (or past) approval.","operationId":"list_hire_approvals_v1_hire_approvals_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/HireApprovalResponse"},"type":"array","title":"Response List Hire Approvals V1 Hire Approvals Get"}}}}},"security":[{"HTTPBearer":[]}]}},"/v1/hire-approvals/{approval_id}/approve":{"post":{"summary":"Approve Hire","description":"Approve a parked over-limit hire and dispatch it.","operationId":"approve_hire_v1_hire_approvals__approval_id__approve_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"approval_id","in":"path","required":true,"schema":{"type":"string","title":"Approval Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/hire-approvals/{approval_id}/decline":{"post":{"summary":"Decline Hire","description":"Decline a parked over-limit hire; it is never dispatched.","operationId":"decline_hire_v1_hire_approvals__approval_id__decline_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"approval_id","in":"path","required":true,"schema":{"type":"string","title":"Approval Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/wallet/balance":{"get":{"summary":"Get Balance","operationId":"get_balance_v1_wallet_balance_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/v1/wallet/fund":{"post":{"summary":"Fund Escrow","operationId":"fund_escrow_v1_wallet_fund_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FundEscrowRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/v1/wallet/checkout-sessions":{"post":{"summary":"Create Wallet Checkout Session","description":"Open an embedded Stripe Checkout session for a wallet top-up.\n\nNo step-up auth here: this moves no money on its own, and the card entry in\nStripe's frame is the real commitment point.","operationId":"create_wallet_checkout_session_v1_wallet_checkout_sessions_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WalletCheckoutRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/v1/wallet/checkout-sessions/{session_id}":{"get":{"summary":"Get Wallet Checkout Session","description":"Resolve a checkout session for the success page.\n\nCredits the balance itself when the webhook has not landed yet, so a\ndropped webhook cannot leave a buyer who paid with an unchanged balance.","operationId":"get_wallet_checkout_session_v1_wallet_checkout_sessions__session_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"session_id","in":"path","required":true,"schema":{"type":"string","title":"Session Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/wallet/transactions":{"get":{"summary":"Escrow History","description":"The caller's escrow ledger. Pass ``?format=csv`` for a CSV download.","operationId":"escrow_history_v1_wallet_transactions_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"format","in":"query","required":false,"schema":{"enum":["json","csv"],"type":"string","default":"json","title":"Format"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/conversations/{conversation_id}/dispute":{"post":{"summary":"Raise Dispute","description":"Open a dispute on a delivered or in-progress conversation.","operationId":"raise_dispute_v1_conversations__conversation_id__dispute_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"conversation_id","in":"path","required":true,"schema":{"type":"string","title":"Conversation Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DisputeCreate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/disputes/{dispute_id}/resolve":{"post":{"summary":"Resolve Dispute","operationId":"resolve_dispute_admin_disputes__dispute_id__resolve_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"dispute_id","in":"path","required":true,"schema":{"type":"string","title":"Dispute Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DisputeResolveRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/disputes":{"get":{"summary":"List Disputes","description":"List disputes with the conversation context an admin needs to resolve them.","operationId":"list_disputes_admin_disputes_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminDisputeListResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/admin/settlements/auto-accept":{"post":{"summary":"Trigger Auto Accept","description":"Run the time-based auto-accept sweep now (manual/ops trigger).\n\nReleases escrow on every delivered conversation past the auto-accept window,\nexactly as the background loop does, and returns the conversation ids settled.","operationId":"trigger_auto_accept_admin_settlements_auto_accept_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/admin/settlements/expire-stale-hires":{"post":{"summary":"Trigger Stale Hire Sweep","description":"Run the stale-hire deadline sweep now (manual/ops trigger).\n\nRefunds escrow on every accepted-but-undelivered hire past its deadline (or\nthe no-deadline fallback age), exactly as the background loop does, and\nreturns the conversation ids that were expired.","operationId":"trigger_stale_hire_sweep_admin_settlements_expire_stale_hires_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/admin/files/cleanup":{"post":{"summary":"Trigger File Cleanup","description":"Run the expired-file cleanup sweep now (manual/ops trigger).\n\nDeletes bytes for expired files and marks the rows ``expired``, exactly as\nthe background loop does — files in conversations with an open dispute are\nskipped. Returns the file ids cleaned up.","operationId":"trigger_file_cleanup_admin_files_cleanup_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/admin/files/{file_id}/retention":{"post":{"summary":"Update File Retention","description":"Extend, shorten, or make durable one file's retention (admin hold).\n\nThis is the only path besides dispute pinning that may move a file past\nits role-default retention window; the ``paid`` reason is a stub until\nthe billing integration exists, so nothing extends retention for free.\nEvery change is recorded as an operational event for audit.","operationId":"update_file_retention_admin_files__file_id__retention_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"file_id","in":"path","required":true,"schema":{"type":"string","title":"File Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FileRetentionUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FileResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/accounts/unverified-cleanup":{"post":{"summary":"Trigger Unverified Account Cleanup","description":"Run the inactive unverified-account cleanup sweep now.","operationId":"trigger_unverified_account_cleanup_admin_accounts_unverified_cleanup_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/v1/me/invitations":{"get":{"summary":"My Invitations","operationId":"my_invitations_v1_me_invitations_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserInvitationsResponse"}}}}},"security":[{"HTTPBearer":[]}]},"post":{"summary":"Create Invitation","operationId":"create_invitation_v1_me_invitations_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InviteCreate"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserInvitation"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/v1/me/invitations/code":{"patch":{"summary":"Update Personal Invite Code","operationId":"update_personal_invite_code_v1_me_invitations_code_patch","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PersonalInviteCodeUpdate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PersonalInviteCode"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/v1/me/invitations/joined":{"get":{"summary":"Joined Invitees","operationId":"joined_invitees_v1_me_invitations_joined_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JoinedInviteesResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/me/invitations/{invite_id}/resend":{"post":{"summary":"Resend Invitation","operationId":"resend_invitation_v1_me_invitations__invite_id__resend_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"invite_id","in":"path","required":true,"schema":{"type":"string","title":"Invite Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserInvitation"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/me/invitations/{invite_id}/revoke":{"post":{"summary":"Revoke Invitation","operationId":"revoke_invitation_v1_me_invitations__invite_id__revoke_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"invite_id","in":"path","required":true,"schema":{"type":"string","title":"Invite Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/users/{user_id}/invitation-access":{"patch":{"summary":"Update Invitation Access","operationId":"update_invitation_access_admin_users__user_id__invitation_access_patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"string","title":"User Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InvitationAccessUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InvitationProfile"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/me/communications/events":{"post":{"tags":["communications"],"summary":"Home Event","operationId":"home_event_v1_me_communications_events_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HomeEvent"}}},"required":true},"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/v1/me/communications/home":{"get":{"tags":["communications"],"summary":"Home Messages","description":"The one optional ask Home may show now (see app.home_nudges).","operationId":"home_messages_v1_me_communications_home_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HomeMessages"}}}}},"security":[{"HTTPBearer":[]}]}},"/v1/communications/email/{communication_id}/{link_key}":{"get":{"tags":["communications"],"summary":"Email Click","operationId":"email_click_v1_communications_email__communication_id___link_key__get","parameters":[{"name":"communication_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Communication Id"}},{"name":"link_key","in":"path","required":true,"schema":{"type":"string","title":"Link Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/email-suppressions":{"put":{"tags":["communications"],"summary":"Update Email Suppression","operationId":"update_email_suppression_admin_email_suppressions_put","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuppressionRequest"}}},"required":true},"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/v1/communications/postmark":{"post":{"tags":["communications"],"summary":"Postmark Feedback","operationId":"postmark_feedback_v1_communications_postmark_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBasic":[]}]}},"/admin/users/{user_id}/communications":{"get":{"tags":["communications"],"summary":"User Communications","operationId":"user_communications_admin_users__user_id__communications_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"string","title":"User Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":50,"title":"Limit"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"Cursor"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HistoryPage"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/env-tokens":{"post":{"tags":["admin"],"summary":"Mint Env Token","description":"Mint a short-lived signed pass for another environment (staging).\n\nHuman admin sessions only (``get_admin_user`` hard-rejects API keys);\n404 on environments without the private key — only prod mints. Every\nmint is audited. Slice 10 widens eligibility to grant-holding users.\n\nLimited per admin, not per IP: every console user arrives from the\nconsole's shared egress address, so an IP bucket meters the whole team\nas one client and its 429 log line gets that address fail2ban-banned\n(console outage 2026-09-21/22).","operationId":"mint_env_token_admin_env_tokens_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/admin/users":{"get":{"tags":["admin"],"summary":"List Users","description":"Admin overview of users, ownership, and provider footprint.","operationId":"list_users_admin_users_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminUsersResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/admin/invites":{"get":{"tags":["admin"],"summary":"List Invites","description":"Pending invites for oversight and revocation, including expired links.","operationId":"list_invites_admin_invites_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminInvitesResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/admin/invites/{invite_id}/revoke":{"post":{"tags":["admin"],"summary":"Revoke Invite","operationId":"revoke_invite_admin_invites__invite_id__revoke_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"invite_id","in":"path","required":true,"schema":{"type":"string","title":"Invite Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/invite-settings":{"get":{"tags":["admin"],"summary":"Read Invite Settings","description":"Legacy view of the ordinary tier; trust-specific terms live on invitations.","operationId":"read_invite_settings_admin_invite_settings_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InviteSettings"}}}}},"security":[{"HTTPBearer":[]}]},"put":{"tags":["admin"],"summary":"Update Invite Settings","operationId":"update_invite_settings_admin_invite_settings_put","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InviteSettings"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InviteSettings"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/admin/referral-settings":{"get":{"tags":["admin"],"summary":"Read Referral Settings","description":"Legacy view of the ordinary tier; no extra signup bonus is stacked.","operationId":"read_referral_settings_admin_referral_settings_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReferralSettings"}}}}},"security":[{"HTTPBearer":[]}]},"put":{"tags":["admin"],"summary":"Update Referral Settings","operationId":"update_referral_settings_admin_referral_settings_put","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReferralSettings"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReferralSettings"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/admin/orchestrations":{"get":{"tags":["admin"],"summary":"List Orchestrations","description":"Recent orchestration roots with direct sub-hires for admin inspection.","operationId":"list_orchestrations_admin_orchestrations_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminOrchestrationsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/orchestrations/{conversation_id}":{"get":{"tags":["admin"],"summary":"Get Orchestration Graph","description":"Unrestricted orchestration graph for an admin.","operationId":"get_orchestration_graph_admin_orchestrations__conversation_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"conversation_id","in":"path","required":true,"schema":{"type":"string","title":"Conversation Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrchestrationGraphResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/orchestrations/{conversation_id}/nodes/{node_id}":{"get":{"tags":["admin"],"summary":"Get Orchestration Node","description":"Unrestricted node detail for an admin-visible orchestration graph.","operationId":"get_orchestration_node_admin_orchestrations__conversation_id__nodes__node_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"conversation_id","in":"path","required":true,"schema":{"type":"string","title":"Conversation Id"}},{"name":"node_id","in":"path","required":true,"schema":{"type":"string","title":"Node Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/snapshot-garbage-collection/root-authorities":{"post":{"tags":["admin"],"summary":"Acquire Snapshot Gc Root Authority","description":"Atomically protect one exact bounded root set for an admin-owned operation.","operationId":"acquire_snapshot_gc_root_authority_admin_snapshot_garbage_collection_root_authorities_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SnapshotGcRootAuthorityOperationRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SnapshotGcRootAuthorityOperationResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/admin/snapshot-garbage-collection/root-authorities/release":{"post":{"tags":["admin"],"summary":"Release Snapshot Gc Root Authority","description":"Atomically release the exact root set after its operation fully drains.","operationId":"release_snapshot_gc_root_authority_admin_snapshot_garbage_collection_root_authorities_release_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SnapshotGcRootAuthorityOperationRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SnapshotGcRootAuthorityOperationResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/admin/snapshot-garbage-collection/repairs/blobs":{"post":{"tags":["admin"],"summary":"Repair Snapshot Gc Blob","description":"Repair one exact blob from operator-supplied bytes; no backup discovery.","operationId":"repair_snapshot_gc_blob_admin_snapshot_garbage_collection_repairs_blobs_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_repair_snapshot_gc_blob_admin_snapshot_garbage_collection_repairs_blobs_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SnapshotGcRootAuthorityOperationResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/admin/snapshot-garbage-collection/restores/root-batches":{"post":{"tags":["admin"],"summary":"Append Snapshot Gc Restore Root Batch","description":"Protect one bounded batch for an evidence-bound restore operation.","operationId":"append_snapshot_gc_restore_root_batch_admin_snapshot_garbage_collection_restores_root_batches_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SnapshotGcRestoreRootBatchRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SnapshotGcRootAuthorityOperationResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/admin/snapshot-garbage-collection/restores/complete":{"post":{"tags":["admin"],"summary":"Complete Snapshot Gc Restore","description":"Release one complete restore operation after its evidence is recorded.","operationId":"complete_snapshot_gc_restore_admin_snapshot_garbage_collection_restores_complete_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SnapshotGcRestoreCompletionRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SnapshotGcRestoreCompletionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/admin/embeddings/rebuild":{"post":{"tags":["admin"],"summary":"Rebuild Embeddings","description":"Queue a full embedding/index reconcile job for the background worker.","operationId":"rebuild_embeddings_admin_embeddings_rebuild_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"wait","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Wait"}},{"name":"timeout_seconds","in":"query","required":false,"schema":{"type":"integer","maximum":300,"minimum":1,"default":30,"title":"Timeout Seconds"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminEmbeddingRebuildResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/search-index/jobs":{"get":{"tags":["admin"],"summary":"Search Index Jobs","description":"Return operational health for background search-index jobs.","operationId":"search_index_jobs_admin_search_index_jobs_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminSearchIndexJobsResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/admin/search-index/jobs/{job_id}/retry":{"post":{"tags":["admin"],"summary":"Retry Search Index Job","description":"Reset one failed indexing job so the background worker can retry it.","operationId":"retry_search_index_job_admin_search_index_jobs__job_id__retry_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminSearchIndexJobSummary"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/users/{user_id}/role":{"patch":{"tags":["admin"],"summary":"Update User Role","description":"Update an account's admin or provider access flags.","operationId":"update_user_role_admin_users__user_id__role_patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"string","title":"User Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminUserRoleUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/users/{user_id}/intro-call-credit":{"post":{"tags":["admin"],"summary":"Grant Intro Call Credit","description":"Credit the intro-call reward once, after an admin confirmed attendance.\n\nOnce per account: the user row is locked first so two admins clicking at\nonce cannot both pass the \"not yet granted\" check, and the marker column is\nwritten in the same transaction as the ledger row.","operationId":"grant_intro_call_credit_admin_users__user_id__intro_call_credit_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"string","title":"User Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/users/{user_id}/credit":{"post":{"tags":["admin"],"summary":"Grant Admin Credit","description":"Add internal credit to an account, e.g. so a tester can keep testing.\n\nLedger-only: no payment rail, receipt or referral reward is involved, and\nthe 'admin_credit' purpose keeps it apart from paid deposits. The cap bounds\na mistyped amount, and the audit event rides the ledger row's transaction:\nif it cannot be recorded, nothing is credited.","operationId":"grant_admin_credit_admin_users__user_id__credit_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"string","title":"User Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminCreditRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/status":{"get":{"tags":["admin"],"summary":"Status","description":"Quick health snapshot of backend, nginx, and git state.","operationId":"status_admin_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/admin/daily-metrics":{"get":{"tags":["admin"],"summary":"Get Daily Metrics","operationId":"get_daily_metrics_admin_daily_metrics_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":30,"minimum":7,"default":7,"title":"Days"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DailyMetricsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/activity-metrics":{"get":{"tags":["admin"],"summary":"Get Activity Metrics","operationId":"get_activity_metrics_admin_activity_metrics_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":90,"minimum":7,"default":7,"title":"Days"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActivityMetricsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/service-activity":{"get":{"tags":["admin"],"summary":"Get Service Activity","operationId":"get_service_activity_admin_service_activity_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":90,"minimum":1,"default":1,"title":"Days"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceActivity"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/usage/chat-toolbox":{"get":{"tags":["admin"],"summary":"Get Chat Toolbox Usage","operationId":"get_chat_toolbox_usage_admin_usage_chat_toolbox_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":90,"minimum":7,"default":7,"title":"Days"}},{"name":"include_staff","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Include Staff"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatToolboxUsage"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/usage-digest/preview":{"post":{"tags":["admin"],"summary":"Preview Usage Digest","operationId":"preview_usage_digest_admin_usage_digest_preview_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UsageDigestContent"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/admin/daily-metrics/image":{"get":{"tags":["admin"],"summary":"Get Daily Metrics Image","operationId":"get_daily_metrics_image_admin_daily_metrics_image_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"snapshot_date","in":"query","required":true,"schema":{"type":"string","format":"date","title":"Snapshot Date"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/usage-digest":{"get":{"tags":["admin"],"summary":"Get Usage Digest Settings","description":"Where and when the signed-up / DAU / WAU / MAU digest gets posted.","operationId":"get_usage_digest_settings_admin_usage_digest_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UsageDigestSettingsResponse"}}}}},"security":[{"HTTPBearer":[]}]},"put":{"tags":["admin"],"summary":"Update Usage Digest Settings","description":"Partial update: omitted fields keep their value, \"\" clears a secret.","operationId":"update_usage_digest_settings_admin_usage_digest_put","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UsageDigestSettingsUpdate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UsageDigestSettingsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/admin/usage-digest/test":{"post":{"tags":["admin"],"summary":"Send Usage Digest Test","description":"Post the current numbers now, from any environment, to check a destination.\n\nWithout a body it goes to every configured destination; with one it goes\nto that destination only, which is how the card tests a saved setup.","operationId":"send_usage_digest_test_admin_usage_digest_test_post","requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/UsageDigestTestRequest"},{"type":"null"}],"title":"Payload"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UsageDigestTestResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/admin/dashboard/metrics":{"get":{"tags":["admin"],"summary":"Dashboard Metrics","description":"Growth, payments, revenue and the customer funnel for the console.\n\nEvery ``*_previous`` figure covers the window of the same length\nimmediately before this one, measured by the same query, which is what the\ndashboard's \"vs prior\" comparisons use.","operationId":"dashboard_metrics_admin_dashboard_metrics_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"since","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Since"}},{"name":"until","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Until"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminDashboardMetrics"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/service-quality":{"get":{"tags":["admin"],"summary":"Service Quality","description":"Summarize deterministic monitoring records without reading source jobs.","operationId":"service_quality_admin_service_quality_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"integer","default":30,"title":"Days"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}},{"name":"service_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Service Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/service-quality/semantic":{"get":{"tags":["admin"],"summary":"Get Semantic Quality","operationId":"get_semantic_quality_admin_service_quality_semantic_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"default":50,"title":"Limit"}},{"name":"service_limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":50,"title":"Service Limit"}},{"name":"search","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":1,"maxLength":100},{"type":"null"}],"title":"Search"}},{"name":"service_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":1,"maxLength":36},{"type":"null"}],"title":"Service Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/service-quality/semantic/control":{"put":{"tags":["admin"],"summary":"Update Semantic Control","operationId":"update_semantic_control_admin_service_quality_semantic_control_put","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Payload"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/admin/service-quality/semantic/services/{service_id}":{"put":{"tags":["admin"],"summary":"Update Semantic Policy","operationId":"update_semantic_policy_admin_service_quality_semantic_services__service_id__put","security":[{"HTTPBearer":[]}],"parameters":[{"name":"service_id","in":"path","required":true,"schema":{"type":"string","title":"Service Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__service_quality_policy__PolicyUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/service-quality/continuous":{"get":{"tags":["admin"],"summary":"Get Continuous Quality","operationId":"get_continuous_quality_admin_service_quality_continuous_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"days","in":"query","required":false,"schema":{"enum":[7,30,90],"type":"integer","default":7,"title":"Days"}},{"name":"service_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Service Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/service-quality/continuous/control":{"put":{"tags":["admin"],"summary":"Update Continuous Control","operationId":"update_continuous_control_admin_service_quality_continuous_control_put","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ControlUpdate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/admin/service-quality/continuous/stop-admission":{"post":{"tags":["admin"],"summary":"Stop Continuous Admission","operationId":"stop_continuous_admission_admin_service_quality_continuous_stop_admission_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/admin/service-quality/continuous/capacity-acceptance":{"post":{"tags":["admin"],"summary":"Accept Capacity","operationId":"accept_capacity_admin_service_quality_continuous_capacity_acceptance_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CapacityAcceptance"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/admin/service-quality/continuous/services/{service_id}":{"put":{"tags":["admin"],"summary":"Update Continuous Policy","operationId":"update_continuous_policy_admin_service_quality_continuous_services__service_id__put","security":[{"HTTPBearer":[]}],"parameters":[{"name":"service_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Service Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__routers__admin_service_quality_continuous__PolicyUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/service-quality/continuous/services/{service_id}/calibration":{"get":{"tags":["admin"],"summary":"Get Calibration Status","operationId":"get_calibration_status_admin_service_quality_continuous_services__service_id__calibration_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"service_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Service Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/service-quality/continuous/services/{service_id}/calibration-acceptance":{"post":{"tags":["admin"],"summary":"Accept Calibration","operationId":"accept_calibration_admin_service_quality_continuous_services__service_id__calibration_acceptance_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"service_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Service Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CalibrationAcceptance"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/service-quality/continuous/services/{service_id}/calibration-revocation":{"post":{"tags":["admin"],"summary":"Revoke Calibration","operationId":"revoke_calibration_admin_service_quality_continuous_services__service_id__calibration_revocation_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"service_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Service Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CalibrationRevocation"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/observability/summary":{"get":{"tags":["admin"],"summary":"Observability Summary","description":"Operational health summary across search, embeddings, dispatch, disputes.","operationId":"observability_summary_admin_observability_summary_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"since","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Since"}},{"name":"until","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Until"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ObservabilitySummary"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/observability/snapshot-completion":{"get":{"tags":["admin"],"summary":"Snapshot Completion Outbox Health","description":"Return one compact, admin-only completion backlog projection.","operationId":"snapshot_completion_outbox_health_admin_observability_snapshot_completion_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SnapshotCompletionOutboxHealth"}}}}},"security":[{"HTTPBearer":[]}]}},"/admin/observability/snapshot-garbage-collection":{"get":{"tags":["admin"],"summary":"Snapshot Gc Health","description":"Return one identifier-free, admin-only GC backlog projection.","operationId":"snapshot_gc_health_admin_observability_snapshot_garbage_collection_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SnapshotGcHealth"}}}}},"security":[{"HTTPBearer":[]}]}},"/admin/observability/snapshot-staging":{"get":{"tags":["admin"],"summary":"Snapshot Staging Health","description":"Return one identifier-free verification and cleanup backlog projection.","operationId":"snapshot_staging_health_admin_observability_snapshot_staging_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SnapshotStagingHealth"}}}}},"security":[{"HTTPBearer":[]}]}},"/admin/observability/snapshot-lifecycle":{"get":{"tags":["admin"],"summary":"Snapshot Lifecycle Health","description":"Return compact lifecycle, stored-volume, and quota-integrity health.","operationId":"snapshot_lifecycle_health_admin_observability_snapshot_lifecycle_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SnapshotLifecycleHealth"}}}}},"security":[{"HTTPBearer":[]}]}},"/admin/observability/snapshot-completion/parked":{"get":{"tags":["admin"],"summary":"Snapshot Completion Parked Effects","description":"Return one oldest-first, privacy-reduced parked-effect page.","operationId":"snapshot_completion_parked_effects_admin_observability_snapshot_completion_parked_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}},{"name":"after_parked_at_seconds","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}],"title":"After Parked At Seconds"}},{"name":"after_plan_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":128},{"type":"null"}],"title":"After Plan Id"}},{"name":"after_effect_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":128},{"type":"null"}],"title":"After Effect Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SnapshotCompletionParkedPage"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/observability/workspace-scopes":{"get":{"tags":["admin"],"summary":"Workspace Scope Usage","description":"Workspace storage per orchestration scope, heaviest first.\n\nOperators use this to see which composed job trees hold the most working\nbytes, how much of that is live entries versus superseded/pending\noverhead awaiting cleanup, and whether the scope is still active (once it\nis not, the scope-terminal retention cap bounds the remaining lifetime).","operationId":"workspace_scope_usage_admin_observability_workspace_scopes_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":20,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/WorkspaceScopeUsage"},"title":"Response Workspace Scope Usage Admin Observability Workspace Scopes Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/observability/failing-providers":{"get":{"tags":["admin"],"summary":"Failing Providers","description":"Top provider agents/services by dispatch failure count and rate.","operationId":"failing_providers_admin_observability_failing_providers_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"since","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Since"}},{"name":"until","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Until"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":10,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FailingProvidersResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/observability/events":{"get":{"tags":["admin"],"summary":"Operational Events","description":"Cross-tenant operational event log with drill-down filters.\n\nThe admin twin of ``/v1/provider/observability/events``: same paginated\nquery, but no owner scope and every dispatch dimension (provider, service,\njob, conversation, request_id, error_type) is filterable so an admin can go\nfrom \"provider X has N failures\" to the individual failures behind it.\n\nLike the provider log it applies no default window: with no ``since``/\n``until`` it returns full history (bounded by ``limit``), so the UI's \"All\ntime\" range works and \"Load more\" pages a stable window.","operationId":"operational_events_admin_observability_events_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"since","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Since"}},{"name":"until","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Until"}},{"name":"event_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Event Type"}},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"}},{"name":"provider_agent_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provider Agent Id"}},{"name":"service_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Service Id"}},{"name":"job_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Job Id"}},{"name":"conversation_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Conversation Id"}},{"name":"principal_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Principal Type"}},{"name":"api_key_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Api Key Id"}},{"name":"request_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Request Id"}},{"name":"error_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Type"}},{"name":"include_metadata","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Include Metadata"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":50,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminOperationalEventListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/observability/event-types":{"get":{"tags":["admin"],"summary":"Operational Event Types","description":"Distinct event types across the marketplace, to populate the type filter.\n\nWindowed like the event log when ``since``/``until`` are given, so the\nfilter only offers types actually present in the visible range.","operationId":"operational_event_types_admin_observability_event_types_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"since","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Since"}},{"name":"until","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Until"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminEventTypesResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/observability/events/{event_id}":{"get":{"tags":["admin"],"summary":"Operational Event Detail","description":"Single operational event with its full ``event_metadata`` — the \"what\nactually happened\" view an admin opens from the event log.","operationId":"operational_event_detail_admin_observability_events__event_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"event_id","in":"path","required":true,"schema":{"type":"string","title":"Event Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminOperationalEventDetail"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/observability/jobs/{job_id}/retry":{"post":{"tags":["admin"],"summary":"Retry Dispatch","description":"Re-queue a dispatch_failed job for another dispatch attempt.\n\nThe remediation counterpart to the event log: once an admin has diagnosed a\nfailure, this resets the job + its outbox row so the dispatch worker retries\nit, instead of requiring a manual DB edit. Only dispatch_failed jobs are\neligible (409 otherwise), so a live or delivered job is never re-dispatched.","operationId":"retry_dispatch_admin_observability_jobs__job_id__retry_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminDispatchRetryResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/observability/incidents/{conversation_id}/timeline":{"get":{"tags":["admin"],"summary":"Incident Timeline","description":"Reconstruct one conversation's incident timeline from every persisted\nsource — jobs, the message transcript, operational events (dispatch +\nsettlement + dispute), the dispatch outbox, the escrow ledger, and billing —\ntime-ordered into one list. The single surface for reconstructing a\nfailed/disputed incident without hand-joining tables.","operationId":"incident_timeline_admin_observability_incidents__conversation_id__timeline_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"conversation_id","in":"path","required":true,"schema":{"type":"string","title":"Conversation Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminIncidentTimeline"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/observability/retention/run":{"post":{"tags":["admin"],"summary":"Run Retention","description":"Run the operational-event retention sweep now (manual/ops trigger).\n\nPrunes aged-out high-volume telemetry exactly as the background loop does;\nthe audit/financial event trail is preserved. Returns how many events were\nremoved and the cutoff applied.","operationId":"run_retention_admin_observability_retention_run_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminRetentionRunResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/admin/external-keys":{"get":{"tags":["admin-external-keys"],"summary":"List External Keys","operationId":"list_external_keys_admin_external_keys_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalApiKeyListResponse"}}}}},"security":[{"HTTPBearer":[]}]},"post":{"tags":["admin-external-keys"],"summary":"Create External Key","operationId":"create_external_key_admin_external_keys_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalApiKeyCreate"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalApiKeyResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/admin/external-keys/alert-thresholds":{"put":{"tags":["admin-external-keys"],"summary":"Update Alert Thresholds","description":"Retune the budget email tiers without a deploy.\n\nTakes effect on the next hourly sweep. Lowering a tier past a key that\nalready alerted does not re-mail it: the stored tier only escalates.","operationId":"update_alert_thresholds_admin_external_keys_alert_thresholds_put","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalKeyAlertThresholds"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalKeyAlertThresholds"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/admin/external-keys/{key_id}/refresh-usage":{"post":{"tags":["admin-external-keys"],"summary":"Refresh Key Usage","description":"Probe the provider right now and return the fresh snapshot.","operationId":"refresh_key_usage_admin_external_keys__key_id__refresh_usage_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"key_id","in":"path","required":true,"schema":{"type":"string","title":"Key Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalApiKeyUsage"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/external-keys/test-probe":{"post":{"tags":["admin-external-keys"],"summary":"Test External Key Probe","description":"Run a probe config against a value without saving either.\n\nNo key row, no snapshot row, no audit record carrying the value: the\nconsole calls this from the add-key form so a custom HTTP or script\nprobe can be checked before the key exists.","operationId":"test_external_key_probe_admin_external_keys_test_probe_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalApiKeyProbeTest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalApiKeyUsage"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/admin/external-keys/{key_id}/rotate":{"post":{"tags":["admin-external-keys"],"summary":"Rotate External Key","operationId":"rotate_external_key_admin_external_keys__key_id__rotate_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"key_id","in":"path","required":true,"schema":{"type":"string","title":"Key Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalApiKeyRotate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalApiKeyResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/external-keys/{key_id}/probe":{"put":{"tags":["admin-external-keys"],"summary":"Update External Key Probe","description":"Add, replace or remove a key's usage probe without touching the value.\n\nCustom probes are iterated on (a script that mis-parses the response,\na renamed endpoint), so the probe is editable in place; the key's\nbindings, value and snapshots are untouched.","operationId":"update_external_key_probe_admin_external_keys__key_id__probe_put","security":[{"HTTPBearer":[]}],"parameters":[{"name":"key_id","in":"path","required":true,"schema":{"type":"string","title":"Key Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalApiKeyProbeUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalApiKeyResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/external-keys/{key_id}/test-probe":{"post":{"tags":["admin-external-keys"],"summary":"Test External Key Probe Existing","description":"Dry-run a candidate probe against this key's stored value.\n\nThe value is decrypted for the one call and never leaves the process;\nno snapshot is written, so the Keys table keeps showing the last real\nsweep until the probe is saved and refreshed.","operationId":"test_external_key_probe_existing_admin_external_keys__key_id__test_probe_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"key_id","in":"path","required":true,"schema":{"type":"string","title":"Key Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalApiKeyProbeTestExisting"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalApiKeyUsage"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/external-keys/{key_id}/reveal":{"post":{"tags":["admin-external-keys"],"summary":"Reveal External Key","description":"Decrypt the master value for the console: server-side late cross-env\nbinding pushes and benchmark key references, plus the Keys page's\nexplicit reveal control. Every reveal is rate-limited and audited with\nthe acting admin; the console must never store the value or echo it\nanywhere but the response to the admin who asked.","operationId":"reveal_external_key_admin_external_keys__key_id__reveal_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"key_id","in":"path","required":true,"schema":{"type":"string","title":"Key Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalApiKeyValueResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/external-keys/{key_id}/benchmark-grant":{"post":{"tags":["admin-external-keys"],"summary":"Grant Benchmark Read","description":"Let the benchmark job read this key for one run, by reference:\nthe value never passes through the console nor sits in the job's settings.\nOne timed grant per key, moved later by each run, lapses by itself. 409 when\nthe key cannot be read that way (no version, or this backend does not write\nto Secret Manager): the console then reveals, as before.","operationId":"grant_benchmark_read_admin_external_keys__key_id__benchmark_grant_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"key_id","in":"path","required":true,"schema":{"type":"string","title":"Key Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalApiKeyBenchmarkGrant"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalApiKeyBenchmarkGrantResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/external-keys/{key_id}":{"delete":{"tags":["admin-external-keys"],"summary":"Delete External Key","description":"Delete the master row of a key no provider uses any more.\n\nA key bound to any agent is refused with 409, naming every binding\n(environment, agent, variable): unbind first, so no provider silently loses\na key (D13 in docs/architecture/Registry Keys in Secret Manager.md). The rule lives here, so the\nconsole and the CLI show the same refusal.","operationId":"delete_external_key_admin_external_keys__key_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"key_id","in":"path","required":true,"schema":{"type":"string","title":"Key Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalApiKeyResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/external-keys/{key_id}/bindings":{"post":{"tags":["admin-external-keys"],"summary":"Create Binding","operationId":"create_binding_admin_external_keys__key_id__bindings_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"key_id","in":"path","required":true,"schema":{"type":"string","title":"Key Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalApiKeyBindingCreate"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalApiKeyBindingResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/external-keys/{key_id}/bindings/{binding_id}":{"delete":{"tags":["admin-external-keys"],"summary":"Delete Binding","operationId":"delete_binding_admin_external_keys__key_id__bindings__binding_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"key_id","in":"path","required":true,"schema":{"type":"string","title":"Key Id"}},{"name":"binding_id","in":"path","required":true,"schema":{"type":"string","title":"Binding Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalApiKeyBindingResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/fleet/platform-secrets":{"get":{"tags":["admin-external-keys"],"summary":"List Platform Secrets","description":"This environment's copies, without values: the Keys page compares their\nversions with the master's (drift) and offers Sync.","operationId":"list_platform_secrets_admin_fleet_platform_secrets_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/PlatformSecretPointer"},"type":"array","title":"Response List Platform Secrets Admin Fleet Platform Secrets Get"}}}}},"security":[{"HTTPBearer":[]}]},"put":{"tags":["admin-external-keys"],"summary":"Put Platform Secret","description":"Upsert THIS environment's operational copy of a platform-bound key. A\npush of an older version than the stored one changes nothing. Without a\nvalue it is a pointer push (_put_pointer).","operationId":"put_platform_secret_admin_fleet_platform_secrets_put","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformSecretPut"}}},"required":true},"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/admin/fleet/platform-secrets/{agent_key}/{name}":{"delete":{"tags":["admin-external-keys"],"summary":"Delete Platform Secret","description":"Remove this environment's operational copy. Idempotent.","operationId":"delete_platform_secret_admin_fleet_platform_secrets__agent_key___name__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"agent_key","in":"path","required":true,"schema":{"type":"string","title":"Agent Key"}},{"name":"name","in":"path","required":true,"schema":{"type":"string","title":"Name"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/fleet/agent-env":{"put":{"tags":["admin-external-keys"],"summary":"Put Agent Env","description":"Upsert a plaintext non-secret env value for an agent variable in THIS env.","operationId":"put_agent_env_admin_fleet_agent_env_put","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformEnvPut"}}},"required":true},"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/admin/fleet/agent-env/{agent_key}/{name}":{"delete":{"tags":["admin-external-keys"],"summary":"Delete Agent Env","description":"Remove a plaintext env value. Idempotent.","operationId":"delete_agent_env_admin_fleet_agent_env__agent_key___name__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"agent_key","in":"path","required":true,"schema":{"type":"string","title":"Agent Key"}},{"name":"name","in":"path","required":true,"schema":{"type":"string","title":"Name"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/integrations":{"get":{"tags":["admin"],"summary":"List Admin Integrations","description":"The full catalog — including hidden and disabled entries — each badged with\nits current admin override (lifecycle / hidden / banner), fleet adoption counts\n(connections + active grants), and the latest reachability probe.","operationId":"list_admin_integrations_admin_integrations_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/AdminIntegrationEntry"},"type":"array","title":"Response List Admin Integrations Admin Integrations Get"}}}}},"security":[{"HTTPBearer":[]}]}},"/admin/integrations/grants":{"get":{"tags":["admin"],"summary":"List Admin Grants","description":"Every connection grant across all users, resolved to its provider slug.\nOptionally filter by ``slug`` and/or ``status`` — the fleet view for spotting\nand triaging who has standing access to a compromised provider.","operationId":"list_admin_grants_admin_integrations_grants_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"slug","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Slug"}},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/AdminGrantEntry"},"title":"Response List Admin Grants Admin Integrations Grants Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/integrations/{slug}":{"patch":{"tags":["admin"],"summary":"Update Admin Integration","description":"Set a catalog entry's runtime state. Only provided fields change; an empty\n``banner`` clears it. Unknown slugs 404. Disabling takes effect immediately at\nthe connect chokepoints and the broker (no existing connection is deleted).","operationId":"update_admin_integration_admin_integrations__slug__patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IntegrationOverrideUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminIntegrationEntry"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/integrations/{slug}/revoke-grants":{"post":{"tags":["admin"],"summary":"Revoke Integration Grants","description":"Kill-switch: revoke every approved/pending agent grant bound to a connection\non this provider. Effective immediately (the broker re-checks status per call);\nbuyers' vaulted credentials are left intact. Often paired with disabling the\nentry via PATCH so no new grant can be created.","operationId":"revoke_integration_grants_admin_integrations__slug__revoke_grants_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkRevokeResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/integrations/health":{"get":{"tags":["admin"],"summary":"Get Integration Health","description":"The latest reachability result per integration (empty until the first\nsweep). Read straight from the stored probe events.","operationId":"get_integration_health_admin_integrations_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/IntegrationHealthEntry"},"type":"array","title":"Response Get Integration Health Admin Integrations Health Get"}}}}},"security":[{"HTTPBearer":[]}]}},"/admin/integrations/health/probe":{"post":{"tags":["admin"],"summary":"Run Integration Health Probe","description":"Probe every catalog endpoint's unauthenticated MCP challenge (no credential\nneeded), store the results, and return a reachable/unreachable summary. Routed\nthrough the SSRF gate; runs synchronously (bounded concurrency).","operationId":"run_integration_health_probe_admin_integrations_health_probe_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HealthProbeResult"}}}}},"security":[{"HTTPBearer":[]}]}},"/admin/agent-deployments/options":{"get":{"tags":["fleet"],"summary":"List Agent Deployment Options","description":"Return server-owned deployment choices for the admin console.\n\nConfigured fleet hosts are supplemented with hosts already referenced by\ndeployments so an operator can still manage a legacy or renamed target.","operationId":"list_agent_deployment_options_admin_agent_deployments_options_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentDeploymentOptionsResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/admin/agent-deployments":{"get":{"tags":["fleet"],"summary":"List Agent Deployments","operationId":"list_agent_deployments_admin_agent_deployments_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/AgentDeploymentResponse"},"type":"array","title":"Response List Agent Deployments Admin Agent Deployments Get"}}}}},"security":[{"HTTPBearer":[]}]},"post":{"tags":["fleet"],"summary":"Create Agent Deployment","description":"Create a deployment row for a self-hosted agent.\n\nAddressed by ``agent_id`` (must exist, enabled) or by ``agent_key`` — the\nfirst-promote path: an agent_key the backend has never seen is\nauto-registered under the configured publish owner account, mirroring the\nCI publish endpoint; a disabled registration still refuses.","operationId":"create_agent_deployment_admin_agent_deployments_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentDeploymentCreate"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentDeploymentResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/admin/agent-deployments/{deployment_id}":{"patch":{"tags":["fleet"],"summary":"Update Agent Deployment","operationId":"update_agent_deployment_admin_agent_deployments__deployment_id__patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"deployment_id","in":"path","required":true,"schema":{"type":"string","title":"Deployment Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentDeploymentUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentDeploymentResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["fleet"],"summary":"Delete Agent Deployment","operationId":"delete_agent_deployment_admin_agent_deployments__deployment_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"deployment_id","in":"path","required":true,"schema":{"type":"string","title":"Deployment Id"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/agent-images/{host}/{agent_key}":{"patch":{"tags":["fleet"],"summary":"Publish Agent Image","description":"Upsert one deployment row's image after CI pushed a new build.\n\nThe staging-tracks-develop step: CI builds an agent's image, then points\nthe agent's row on ``host`` at the new digest; the host's fleet watcher\nconverges within seconds. Creates the row on first publish (an agent's\nfirst build) with the standard poll-agent entry defaults.","operationId":"publish_agent_image_v1_agent_images__host___agent_key__patch","parameters":[{"name":"host","in":"path","required":true,"schema":{"type":"string","title":"Host"}},{"name":"agent_key","in":"path","required":true,"schema":{"type":"string","title":"Agent Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentImagePublishRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentImagePublishResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/fleet/{host}/agent-deployments":{"get":{"tags":["fleet"],"summary":"List Fleet Deployments","description":"Deployment rows assigned to one fleet host.\n\nRows whose agent is archived/disabled are omitted, so the host's next\nconvergence tears the container down.","operationId":"list_fleet_deployments_v1_fleet__host__agent_deployments_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"host","in":"path","required":true,"schema":{"type":"string","title":"Host"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FleetDeploymentsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/fleet/{host}/agent-deployments/watch":{"get":{"tags":["fleet"],"summary":"Watch Fleet Deployments","description":"Wait for one host's effective deployment state to change.\n\nThe state-derived cursor is durable across backend workers and restarts.\nEach snapshot ends its read transaction before the async wait, so one\nwatcher per fleet host does not hold a database connection while idle.","operationId":"watch_fleet_deployments_v1_fleet__host__agent_deployments_watch_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"host","in":"path","required":true,"schema":{"type":"string","title":"Host"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":64,"maxLength":64},{"type":"null"}],"title":"Cursor"}},{"name":"timeout_seconds","in":"query","required":false,"schema":{"type":"number","maximum":55.0,"minimum":0.0,"default":45.0,"title":"Timeout Seconds"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FleetDeploymentWatchResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/fleet/{host}/agent-deployments/{deployment_id}/identity":{"post":{"tags":["fleet"],"summary":"Provision Fleet Deployment Identity","description":"Rotate the token for an agent assigned to this fleet host.\n\nThe shared fleet credential is intentionally limited to deployment rows\nassigned to the requested host. User/API-key token rotation continues to\nrequire a fresh human session on the general self-hosted-agent endpoint.","operationId":"provision_fleet_deployment_identity_v1_fleet__host__agent_deployments__deployment_id__identity_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"host","in":"path","required":true,"schema":{"type":"string","title":"Host"}},{"name":"deployment_id","in":"path","required":true,"schema":{"type":"string","title":"Deployment Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FleetDeploymentIdentityResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/fleet/{host}/agent-deployments/status":{"post":{"tags":["fleet"],"summary":"Report Fleet Deployment Status","description":"Record host-observed container states. Unknown ids and rows belonging\nto other hosts are ignored rather than erroring, so a stale host report\ncan never mutate foreign rows.","operationId":"report_fleet_deployment_status_v1_fleet__host__agent_deployments_status_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"host","in":"path","required":true,"schema":{"type":"string","title":"Host"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FleetStatusReport"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FleetStatusReportResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/fleet/agents/{agent_id}":{"patch":{"tags":["fleet"],"summary":"Set Fleet Agent Enabled","description":"Toggle a runtime identity's ``enabled`` switch, admin-scoped.\n\n``enabled`` is a runtime switch, not published metadata. Derived service\navailability re-syncs immediately, so\nthe marketplace reflects the toggle without waiting for a heartbeat.","operationId":"set_fleet_agent_enabled_admin_fleet_agents__agent_id__patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","title":"Agent Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FleetAgentEnabledUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Set Fleet Agent Enabled Admin Fleet Agents  Agent Id  Patch"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/fleet/agents/{agent_id}/archive":{"post":{"tags":["fleet"],"summary":"Archive Fleet Agent","description":"Retire an agent from the fleet, admin-scoped.\n\nThe owner-facing archive lives on /v1/agents/self-hosted/{id}/archive and\nis scoped to the owner; a platform admin retires an agent they do not own,\nwhich is the same operation with a different authority. Marketplace\nhistory is preserved: the row stays, its services go inactive, and the\nagent token is revoked so the runtime cannot re-register with it.\n\nArchiving is not a repo action. An agent still placed on an enforce-mode\ntarget gets a FRESH identity on the next deploy — retiring it for good\nmeans removing its member entry too. The console says so before it acts.","operationId":"archive_fleet_agent_admin_fleet_agents__agent_id__archive_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","title":"Agent Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Archive Fleet Agent Admin Fleet Agents  Agent Id  Archive Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/fleet/agents/{agent_id}/unarchive":{"post":{"tags":["fleet"],"summary":"Unarchive Fleet Agent","description":"Bring an archived agent back onto the fleet, admin-scoped.\n\nThe reverse of archive with one deliberate asymmetry: the credential\narchive revoked stays revoked. The row comes back disabled and offline,\nits services stay inactive, and it cannot run until its owner\nregenerates the token (or an enforce-mode deploy provisions a fresh\nidentity). Marketplace history is untouched either way.","operationId":"unarchive_fleet_agent_admin_fleet_agents__agent_id__unarchive_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","title":"Agent Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Unarchive Fleet Agent Admin Fleet Agents  Agent Id  Unarchive Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/fleet/assignees":{"get":{"tags":["fleet"],"summary":"List Fleet Assignees","description":"Who is assigned to each agent, keyed by agent_key.\n\nUnlike the overview this is NOT per environment: assignment is an\norganisational fact about the agent, so one answer from the primary\nenvironment covers the whole fleet — including agents that exist only\non staging, which is why the key is agent_key and not an agent id.","operationId":"list_fleet_assignees_admin_fleet_assignees_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FleetAssigneesResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/admin/fleet/assignees/{agent_key}":{"put":{"tags":["fleet"],"summary":"Set Fleet Assignee","description":"Assign someone to an agent, or clear it with ``user_id: null``.\n\nAny admin may reassign at any time: this grants no access and moves no\nrevenue (that is ``agents.owner_user_id``, which stays put), so it\nneeds no confirmation step — only an audit line.","operationId":"set_fleet_assignee_admin_fleet_assignees__agent_key__put","security":[{"HTTPBearer":[]}],"parameters":[{"name":"agent_key","in":"path","required":true,"schema":{"type":"string","title":"Agent Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FleetAssigneeUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/FleetAssignee"},{"type":"null"}],"title":"Response Set Fleet Assignee Admin Fleet Assignees  Agent Key  Put"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/fleet-audit":{"post":{"tags":["fleet"],"summary":"Record Fleet Audit","description":"Land a cross-env fleet action in THIS environment's audit trail.\n\nThe admin console relays actions to other environments server-side; it\nreports each one here (on its primary env) so the single pane of glass\nhas the complete history. Prod-local actions are audited at their own\nendpoints; this surface is for the actions prod could not see.","operationId":"record_fleet_audit_admin_fleet_audit_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FleetAuditEvent"}}},"required":true},"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/admin/fleet/catalog":{"get":{"tags":["fleet"],"summary":"Fleet Catalog","operationId":"fleet_catalog_admin_fleet_catalog_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FleetCatalogResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/admin/fleet/overview":{"get":{"tags":["fleet"],"summary":"Fleet Overview","description":"Every agent with its services and container deployments, joined\nserver-side so the console renders from one payload per env.\n\nArchived agents are INCLUDED, carrying ``archived_at``: the console lists\nthem last rather than hiding them, so a retired agent stays visible as\nhistory instead of silently vanishing from the fleet.","operationId":"fleet_overview_admin_fleet_overview_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FleetOverviewResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/v1/agent-bundles":{"get":{"tags":["agent-bundles"],"summary":"List Agent Bundles","description":"Admins see every bundle; providers see only their own uploads.","operationId":"list_agent_bundles_v1_agent_bundles_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/AgentBundleResponse"},"type":"array","title":"Response List Agent Bundles V1 Agent Bundles Get"}}}}},"security":[{"HTTPBearer":[]}]},"post":{"tags":["agent-bundles"],"summary":"Upload Agent Bundle","description":"Validate and store an uploaded bundle ZIP as a ``pending_review`` row.\n\nOpen to any authenticated first-party user (providers), not just admins;\nthe bundle is owned by the uploader and stays ``pending_review`` until an\nadmin approves it, so nothing is built or run without admin review.","operationId":"upload_agent_bundle_v1_agent_bundles_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_upload_agent_bundle_v1_agent_bundles_post"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentBundleResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/v1/agent-bundles/github":{"post":{"tags":["agent-bundles"],"summary":"Import Github Agent Bundle","description":"Pin a public GitHub MCP repository and submit its canonical SDK facade.","operationId":"import_github_agent_bundle_v1_agent_bundles_github_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GitHubMcpBundleImportRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentBundleResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/v1/agent-bundles/{bundle_id}/approve":{"post":{"tags":["agent-bundles"],"summary":"Approve Agent Bundle","description":"Approve a bundle and create or replace its Phase A deployment.\n\nA replacement reuses the agent's existing deployment row only when every\nother bundle linked to that row is suspended.  Reusing the row preserves\nthe agent identity and its vault secrets while atomically moving the fleet\nto the newly reviewed ZIP.","operationId":"approve_agent_bundle_v1_agent_bundles__bundle_id__approve_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"bundle_id","in":"path","required":true,"schema":{"type":"string","title":"Bundle Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentBundleApprove"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentBundleResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/agent-bundles/{bundle_id}/suspend":{"post":{"tags":["agent-bundles"],"summary":"Suspend Agent Bundle","description":"Suspend a bundle: it is dropped from the fleet on the next converge.\n\nAn admin may suspend any bundle; a provider may withdraw only their own\n(others 404 so a bundle's existence is not leaked across owners). An optional\n``reason`` (typically an admin rejection note) is stored and shown to the\nuploading provider.","operationId":"suspend_agent_bundle_v1_agent_bundles__bundle_id__suspend_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"bundle_id","in":"path","required":true,"schema":{"type":"string","title":"Bundle Id"}}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/AgentBundleSuspend"},{"type":"null"}],"title":"Payload"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentBundleResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/agent-bundles/{bundle_id}":{"delete":{"tags":["agent-bundles"],"summary":"Delete Agent Bundle","description":"Delete a bundle the caller uploaded (or any bundle, as admin).\n\nOnly bundles that were never deployed (``deployment_id`` is null — e.g. a\n``pending_review`` upload or one withdrawn before approval) can be deleted\nhere; an approved bundle must have its deployment removed first (admin).\nDeleting frees the uploader's quota slot and, because uniqueness is per\n``(uploaded_by_user_id, bundle_sha256)``, lets them resubmit the same bytes\nafterwards. The stored ZIP is removed too. A missing or foreign bundle 404s\nso existence is not leaked across owners.","operationId":"delete_agent_bundle_v1_agent_bundles__bundle_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"bundle_id","in":"path","required":true,"schema":{"type":"string","title":"Bundle Id"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/.well-known/oauth-protected-resource/mcp":{"get":{"tags":["oauth"],"summary":"Protected Resource Metadata","operationId":"protected_resource_metadata__well_known_oauth_protected_resource_mcp_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/.well-known/oauth-protected-resource":{"get":{"tags":["oauth"],"summary":"Protected Resource Metadata","operationId":"protected_resource_metadata__well_known_oauth_protected_resource_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/.well-known/oauth-protected-resource/{resource_path}":{"get":{"tags":["oauth"],"summary":"Protected Resource Metadata Path","operationId":"protected_resource_metadata_path__well_known_oauth_protected_resource__resource_path__get","parameters":[{"name":"resource_path","in":"path","required":true,"schema":{"type":"string","title":"Resource Path"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/.well-known/oauth-authorization-server/mcp":{"get":{"tags":["oauth"],"summary":"Authorization Server Metadata","operationId":"authorization_server_metadata__well_known_oauth_authorization_server_mcp_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/.well-known/oauth-authorization-server":{"get":{"tags":["oauth"],"summary":"Authorization Server Metadata","operationId":"authorization_server_metadata__well_known_oauth_authorization_server_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/.well-known/oauth-authorization-server/{issuer_path}":{"get":{"tags":["oauth"],"summary":"Authorization Server Metadata Path","operationId":"authorization_server_metadata_path__well_known_oauth_authorization_server__issuer_path__get","parameters":[{"name":"issuer_path","in":"path","required":true,"schema":{"type":"string","title":"Issuer Path"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/oauth/register":{"post":{"tags":["oauth"],"summary":"Register Client","operationId":"register_client_oauth_register_post","responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/oauth/authorize":{"get":{"tags":["oauth"],"summary":"Authorize","operationId":"authorize_oauth_authorize_get","parameters":[{"name":"response_type","in":"query","required":true,"schema":{"type":"string","title":"Response Type"}},{"name":"client_id","in":"query","required":true,"schema":{"type":"string","title":"Client Id"}},{"name":"redirect_uri","in":"query","required":true,"schema":{"type":"string","title":"Redirect Uri"}},{"name":"code_challenge","in":"query","required":false,"schema":{"type":"string","default":"","title":"Code Challenge"}},{"name":"code_challenge_method","in":"query","required":false,"schema":{"type":"string","default":"S256","title":"Code Challenge Method"}},{"name":"scope","in":"query","required":false,"schema":{"type":"string","default":"","title":"Scope"}},{"name":"state","in":"query","required":false,"schema":{"type":"string","default":"","title":"State"}},{"name":"resource","in":"query","required":false,"schema":{"type":"string","default":"","title":"Resource"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["oauth"],"summary":"Authorize Decision","description":"The React consent page POSTs the signed-in user's decision here.","operationId":"authorize_decision_oauth_authorize_post","security":[{"HTTPBearer":[]}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/oauth/authorize/consent":{"get":{"tags":["oauth"],"summary":"Authorize Consent","description":"Resolve the signed request into the exact facts shown before approval.","operationId":"authorize_consent_oauth_authorize_consent_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"request_handle","in":"query","required":true,"schema":{"type":"string","title":"Request Handle"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/oauth/token":{"post":{"tags":["oauth"],"summary":"Token","operationId":"token_oauth_token_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/oauth/revoke":{"post":{"tags":["oauth"],"summary":"Revoke","description":"Revoke a refresh or access token (RFC 7009). Per the spec we always return\n200, even for an unknown/invalid/expired token, so a caller can't probe which\ntokens are valid.\n\n- refresh token (opaque ``dgr_``): marked revoked in the DB (so it can't mint\n  new access tokens);\n- access token (JWT): its ``jti`` is denylisted until the token's own ``exp``,\n  and ``deps.get_user_from_jwt_token`` rejects it at /mcp from then on.","operationId":"revoke_oauth_revoke_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/oauth/clients":{"get":{"tags":["connected-apps"],"summary":"List Connected Apps","description":"List the OAuth clients the caller currently has an active grant for.\n\nA client appears while it has at least one live (non-revoked, non-expired)\nrefresh or access-only grant record. ``authorized_at`` is the first grant\n(earliest record across the rotation trail); ``last_active_at`` is the\nnewest live record.","operationId":"list_connected_apps_v1_oauth_clients_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/ConnectedAppResponse"},"type":"array","title":"Response List Connected Apps V1 Oauth Clients Get"}}}}},"security":[{"HTTPBearer":[]}]}},"/v1/oauth/clients/{client_id}":{"delete":{"tags":["connected-apps"],"summary":"Revoke Connected App","description":"Revoke the caller's grant to one OAuth client.\n\nMarks every live grant record for this ``(user, client)`` revoked; the\nclient's outstanding access token is rejected on its next call once no live\ngrant record remains (see ``deps.get_user_from_jwt_token``). Returns 404\nwhen the caller has no active grant for this client (unknown / not theirs /\nalready revoked) so the UI can tell a no-op from a real sever.","operationId":"revoke_connected_app_v1_oauth_clients__client_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"client_id","in":"path","required":true,"schema":{"type":"string","title":"Client Id"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/integrations/library":{"get":{"tags":["connections"],"summary":"List Integration Library","description":"The built-in integration catalog, each entry badged with the caller's\nexisting connection to that provider (if any). Admin-disabled and hidden\nentries are omitted (see ``build_library_view``).","operationId":"list_integration_library_v1_integrations_library_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/IntegrationLibraryEntry"},"type":"array","title":"Response List Integration Library V1 Integrations Library Get"}}}}},"security":[{"HTTPBearer":[]}]}},"/v1/connections":{"get":{"tags":["connections"],"summary":"List Connections","operationId":"list_connections_v1_connections_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/ConnectionResponse"},"type":"array","title":"Response List Connections V1 Connections Get"}}}}},"security":[{"HTTPBearer":[]}]},"post":{"tags":["connections"],"summary":"Create Connection","operationId":"create_connection_v1_connections_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConnectionCreate"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConnectionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/v1/connections/connectors/{provider_slug}":{"post":{"tags":["connections"],"summary":"Create Connector Connection","description":"Validate and vault a credential for a reviewed non-MCP connector.","operationId":"create_connector_connection_v1_connections_connectors__provider_slug__post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"provider_slug","in":"path","required":true,"schema":{"type":"string","title":"Provider Slug"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConnectorConnectionCreate"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConnectionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/connections/{connection_id}":{"delete":{"tags":["connections"],"summary":"Delete Connection","operationId":"delete_connection_v1_connections__connection_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"connection_id","in":"path","required":true,"schema":{"type":"string","title":"Connection Id"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/connections/{connection_id}/test":{"post":{"tags":["connections"],"summary":"Test Connection","operationId":"test_connection_v1_connections__connection_id__test_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"connection_id","in":"path","required":true,"schema":{"type":"string","title":"Connection Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConnectionTestResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/connections/{connection_id}/unlock":{"post":{"tags":["connections"],"summary":"Unlock Connection","description":"Unlock a user-held (Tier-2) connection for the unlock window so hired agents\ncan use it. The passphrase / recovery code derives the key and is never stored.","operationId":"unlock_connection_v1_connections__connection_id__unlock_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"connection_id","in":"path","required":true,"schema":{"type":"string","title":"Connection Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VaultUnlockRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VaultUnlockResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/connections/{connection_id}/lock":{"post":{"tags":["connections"],"summary":"Lock Connection","description":"Re-lock a user-held connection immediately (forget its cached key).","operationId":"lock_connection_v1_connections__connection_id__lock_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"connection_id","in":"path","required":true,"schema":{"type":"string","title":"Connection Id"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/connections/oauth/start":{"post":{"tags":["connections"],"summary":"Start Oauth Connection","description":"Begin connecting a third-party MCP server via OAuth. Returns the provider\nauthorization URL for the dashboard to redirect the browser to, and sets a\nsigned HttpOnly cookie binding this browser to the flow (checked at the\ncallback so only the browser that started the flow can complete it).","operationId":"start_oauth_connection_v1_connections_oauth_start_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OAuthStartRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OAuthStartResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/v1/connections/oauth/callback":{"get":{"tags":["connections"],"summary":"Oauth Callback","description":"Provider redirect target (unauthenticated browser navigation). Exchanges the\ncode and bounces the browser back to the dashboard with a fixed result query.","operationId":"oauth_callback_v1_connections_oauth_callback_get","parameters":[{"name":"code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Code"}},{"name":"state","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State"}},{"name":"error","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/connections/oauth/finalize":{"post":{"tags":["connections"],"summary":"Finalize Oauth Connection","description":"Finish a Tier-2 OAuth connection by supplying the passphrase. Surfaces the\none-time recovery code exactly once, like creating a Tier-2 connection.","operationId":"finalize_oauth_connection_v1_connections_oauth_finalize_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OAuthFinalizeRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConnectionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/v1/connection-grants/request":{"post":{"tags":["connections"],"summary":"Request Connection Grant","description":"Agent-authed: a hired agent requests scoped access to the buyer's connection.","operationId":"request_connection_grant_v1_connection_grants_request_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GrantRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GrantResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/v1/connection-grants":{"get":{"tags":["connections"],"summary":"List Connection Grants","operationId":"list_connection_grants_v1_connection_grants_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/GrantResponse"},"type":"array","title":"Response List Connection Grants V1 Connection Grants Get"}}}}},"security":[{"HTTPBearer":[]}]}},"/v1/connection-grants/{grant_id}":{"get":{"tags":["connections"],"summary":"Get Connection Grant","description":"Agent-authed: a hired agent polls its own grant's status (pending → approved).","operationId":"get_connection_grant_v1_connection_grants__grant_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"grant_id","in":"path","required":true,"schema":{"type":"string","title":"Grant Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GrantResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/connection-grants/{grant_id}/approve":{"post":{"tags":["connections"],"summary":"Approve Connection Grant","operationId":"approve_connection_grant_v1_connection_grants__grant_id__approve_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"grant_id","in":"path","required":true,"schema":{"type":"string","title":"Grant Id"}}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/GrantApprove"},{"type":"null"}],"title":"Payload"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GrantResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/connection-grants/{grant_id}/decline":{"post":{"tags":["connections"],"summary":"Decline Connection Grant","operationId":"decline_connection_grant_v1_connection_grants__grant_id__decline_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"grant_id","in":"path","required":true,"schema":{"type":"string","title":"Grant Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GrantResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/connection-grants/{grant_id}/revoke":{"post":{"tags":["connections"],"summary":"Revoke Connection Grant","operationId":"revoke_connection_grant_v1_connection_grants__grant_id__revoke_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"grant_id","in":"path","required":true,"schema":{"type":"string","title":"Grant Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GrantResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/broker/mcp/call":{"post":{"tags":["connections"],"summary":"Broker Call","description":"Agent-authed: invoke a third-party MCP tool through delegate using an\napproved grant. The raw credential is resolved server-side and never returned.","operationId":"broker_call_v1_broker_mcp_call_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BrokerCallRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/v1/broker/actions/call":{"post":{"tags":["connections"],"summary":"Broker Action Call","description":"Agent-authed: execute a reviewed connector action through Delegate.\n\nThe raw connected-account credential stays inside the broker and trusted\ndriver; only the redacted action result is returned to the agent.","operationId":"broker_action_call_v1_broker_actions_call_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BrokerActionCallRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/v1/broker/gmail/attachments/import":{"post":{"tags":["connections"],"summary":"Broker Gmail Import Attachment","description":"Import Gmail bytes directly into a job-scoped Delegate file object.","operationId":"broker_gmail_import_attachment_v1_broker_gmail_attachments_import_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GmailAttachmentImportRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FileResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/v1/broker/gmail/threads/search":{"post":{"tags":["connections"],"summary":"Broker Gmail Search","description":"Search Gmail without exposing the vaulted OAuth credential.","operationId":"broker_gmail_search_v1_broker_gmail_threads_search_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GmailThreadSearchRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/v1/broker/gmail/threads/get":{"post":{"tags":["connections"],"summary":"Broker Gmail Thread","description":"Retrieve a normalized full Gmail thread through Gmail REST.","operationId":"broker_gmail_thread_v1_broker_gmail_threads_get_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GmailThreadGetRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/v1/provider/sub-hire-spend":{"get":{"tags":["provider"],"summary":"Get Provider Sub Hire Spend","description":"Outbound sub-hire spend for the caller's agents.\n\nFor each engagement one of the caller's agents ran (as orchestrator), reports\nwhich sub-agents it hired, what each was paid, the revenue the engagement\nearned, and the resulting margin — surfacing engagements whose revenue was\nrefunded (where the owner absorbs the sub-hire cost as a loss). Pass\n``conversation_id`` to scope to a single engagement.","operationId":"get_provider_sub_hire_spend_v1_provider_sub_hire_spend_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"conversation_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Conversation Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubHireSpendResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/provider/dependencies/overview":{"get":{"tags":["provider"],"summary":"Get Provider Dependency Overview","description":"Which of the caller's agents have downstream dependencies (sub-hires).\n\nCheap owner-wide signal that drives the conditional entry point: only agents\nthat actually sub-hired appear, each with its dependency/sub-hire counts and\ntotal outbound spend. Agents with no dependencies are omitted.","operationId":"get_provider_dependency_overview_v1_provider_dependencies_overview_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DependencyOverviewResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/v1/provider/agents/{agent_id}/dependencies":{"get":{"tags":["provider"],"summary":"Get Agent Dependency Analysis","description":"Per-dependency analysis for one of the caller's agents.\n\nFor each downstream service/agent the agent hires, reports usage frequency,\nduration, quality, workflow-disrupting errors, and historical cost (with a\nper-day time series). Returns 404 for an agent the caller does not own.","operationId":"get_agent_dependency_analysis_v1_provider_agents__agent_id__dependencies_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","title":"Agent Id"}},{"name":"since","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Since"}},{"name":"until","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Until"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentDependencyAnalysisResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/provider/status":{"get":{"tags":["provider"],"summary":"Get Provider Status","description":"Ownership/history signal for access to the established provider workspace.","operationId":"get_provider_status_v1_provider_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProviderStatusResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/v1/provider/revenue":{"get":{"tags":["provider"],"summary":"Get Provider Revenue","description":"Per-service revenue and agent attribution for the caller's services.","operationId":"get_provider_revenue_v1_provider_revenue_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProviderRevenueResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/v1/provider/statements":{"get":{"tags":["provider"],"summary":"Get Provider Statements","description":"Monthly earnings statements (gross / fees / refunds / net), newest first.\n\nPass ``?format=csv`` for a CSV download (months only; the lifetime totals\nare JSON-only).","operationId":"get_provider_statements_v1_provider_statements_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"format","in":"query","required":false,"schema":{"enum":["json","csv"],"type":"string","default":"json","title":"Format"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProviderStatementsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/provider/statements/{month}/events":{"get":{"tags":["provider"],"summary":"Get Provider Statement Events","description":"Paginated per-event drill-down for one statement month (``YYYY-MM``).\n\nPass ``?format=csv`` for a CSV download of the **entire** month —\n``limit``/``offset`` are ignored, matching the ``export.csv`` endpoint.","operationId":"get_provider_statement_events_v1_provider_statements__month__events_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"month","in":"path","required":true,"schema":{"type":"string","title":"Month"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":50,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}},{"name":"format","in":"query","required":false,"schema":{"enum":["json","csv"],"type":"string","default":"json","title":"Format"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProviderServiceUsageEventListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/provider/statements/{month}/export.csv":{"get":{"tags":["provider"],"summary":"Export Provider Statement Csv","description":"Download the full month's events as a streamed CSV earnings statement.","operationId":"export_provider_statement_csv_v1_provider_statements__month__export_csv_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"month","in":"path","required":true,"schema":{"type":"string","title":"Month"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/provider/observability/summary":{"get":{"tags":["provider"],"summary":"Provider Observability Summary","description":"Operational health (dispatch + disputes + failing services) for the\ncaller's own agents.","operationId":"provider_observability_summary_v1_provider_observability_summary_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"since","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Since"}},{"name":"until","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Until"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProviderObservabilitySummary"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/provider/observability/failing-services":{"get":{"tags":["provider"],"summary":"Provider Failing Services","description":"The caller's own services ranked by dispatch failures in the window.","operationId":"provider_failing_services_v1_provider_observability_failing_services_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"since","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Since"}},{"name":"until","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Until"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":10,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FailingProvidersResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/provider/observability/trends":{"get":{"tags":["provider"],"summary":"Provider Observability Trends","description":"Per-day dispatch volume + failure rate for the caller's own agents.","operationId":"provider_observability_trends_v1_provider_observability_trends_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"since","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Since"}},{"name":"until","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Until"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProviderObservabilityTrends"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/provider/observability/event-types":{"get":{"tags":["provider"],"summary":"Provider Event Types","description":"Distinct event types in the caller's own event log (for the type filter).\n\nOwner-scoped, windowed like the event log when ``since``/``until`` are given\nso the filter only offers types actually present in the visible range.","operationId":"provider_event_types_v1_provider_observability_event_types_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"since","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Since"}},{"name":"until","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Until"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProviderEventTypesResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/provider/observability/events":{"get":{"tags":["provider"],"summary":"Provider Operational Events","description":"Paginated operational event log for the caller's own agents.\n\nUnlike the rolling-metric endpoints, the log applies no default window: with\nno ``since``/``until`` it returns full history (bounded by ``limit``), so the\nUI's \"All time\" range works. The client snapshots ``until`` per paging\nsession so \"Load more\" sees a stable window even as new events arrive.","operationId":"provider_operational_events_v1_provider_observability_events_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"since","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Since"}},{"name":"until","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Until"}},{"name":"event_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Event Type"}},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":50,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProviderOperationalEventListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/provider/orchestrations":{"get":{"tags":["provider"],"summary":"List Provider Orchestrations","description":"Orchestration roots where one of the caller's agents was the worker.\n\nDrill-down into a tree reuses the already owner-scoped\n``/v1/conversations/{id}/orchestration`` endpoints.","operationId":"list_provider_orchestrations_v1_provider_orchestrations_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProviderOrchestrationsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/provider/disputes":{"get":{"tags":["provider"],"summary":"List Provider Disputes","description":"Read-only list of disputes opened against the caller's own services.\n\nResolution stays admin-only (``POST /admin/disputes/{id}/resolve``).","operationId":"list_provider_disputes_v1_provider_disputes_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProviderDisputeListResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/v1/reviews/groups/{group_id}":{"get":{"summary":"Get Group Reviews","operationId":"get_group_reviews_v1_reviews_groups__group_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"group_id","in":"path","required":true,"schema":{"type":"string","title":"Group Id"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}],"title":"Cursor"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/conversations/{conversation_id}/human-rating":{"put":{"summary":"Put Human Rating","description":"Give or edit the buyer's rating of one run (website only).","operationId":"put_human_rating_v1_conversations__conversation_id__human_rating_put","security":[{"HTTPBearer":[]}],"parameters":[{"name":"conversation_id","in":"path","required":true,"schema":{"type":"string","title":"Conversation Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HumanRatingEntry"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/reviews/groups":{"get":{"summary":"List My Review Groups","operationId":"list_my_review_groups_v1_reviews_groups_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"before","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":36},{"type":"null"}],"title":"Before"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/conversations/{conversation_id}/review":{"post":{"summary":"Post Conversation Review","description":"Retired write endpoint. Ratings and acceptance are separate operations.","operationId":"post_conversation_review_v1_conversations__conversation_id__review_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"conversation_id","in":"path","required":true,"schema":{"type":"string","title":"Conversation Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConversationReviewRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Post Conversation Review V1 Conversations  Conversation Id  Review Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/services/{service_id}/reviews":{"get":{"summary":"Get Service Reviews","description":"Public, paginated hirer->worker reviews of a service.","operationId":"get_service_reviews_v1_services__service_id__reviews_get","parameters":[{"name":"service_id","in":"path","required":true,"schema":{"type":"string","title":"Service Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}},{"name":"sort","in":"query","required":false,"schema":{"enum":["recent","lowest_quality","lowest_value"],"type":"string","default":"recent","title":"Sort"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceReviewsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/users/{user_id}/reviews":{"get":{"summary":"Get User Reviews","description":"Public, paginated reviews *received* by a user plus their rollup.\n\nReviews are always ``hirer_to_worker`` (the only supported direction).\nThe per-user rollup is computed from the ``reviews`` table on every call.","operationId":"get_user_reviews_v1_users__user_id__reviews_get","parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"string","title":"User Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserReviewsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/me/reviews/authored":{"get":{"summary":"Get My Authored Reviews","description":"Reviews the current user has *written*.","operationId":"get_my_authored_reviews_v1_me_reviews_authored_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":50,"title":"Limit"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthoredReviewsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/conversations/{conversation_id}/reviews":{"get":{"summary":"Get Conversation Reviews","description":"The single review row on a conversation, accessible to either participant or admin.","operationId":"get_conversation_reviews_v1_conversations__conversation_id__reviews_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"conversation_id","in":"path","required":true,"schema":{"type":"string","title":"Conversation Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConversationReviewsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/realtime/config":{"get":{"summary":"Get Realtime Config","operationId":"get_realtime_config_v1_realtime_config_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/v1/support/issues":{"post":{"tags":["support"],"summary":"Create Issue Report","operationId":"create_issue_report_v1_support_issues_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IssueReportCreate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IssueReportResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/v1/support/chat":{"get":{"tags":["support"],"summary":"Get Chat State","operationId":"get_chat_state_v1_support_chat_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SupportChatState"}}}}},"security":[{"HTTPBearer":[]}]}},"/v1/support/chat/messages":{"post":{"tags":["support"],"summary":"Post Chat Message","operationId":"post_chat_message_v1_support_chat_messages_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SupportChatMessageCreate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SupportChatState"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/v1/support/chat/attachments":{"post":{"tags":["support"],"summary":"Post Chat Attachment","description":"Send a screenshot, a log, or a recording as a message.\n\nThe bytes go into the platform's own file store as an ordinary input\nattachment, so download authorization (owner or admin — exactly the two\nparties to a support thread) and the S3/local backends come for free. The\nrow's unattached expiry is cleared afterwards: those files are swept for\nnever reaching a job, and this one belongs to a conversation instead.","operationId":"post_chat_attachment_v1_support_chat_attachments_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_post_chat_attachment_v1_support_chat_attachments_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SupportChatState"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/v1/support/chat/close":{"post":{"tags":["support"],"summary":"Start New Issue","description":"Put the current conversation away and start fresh (\"New issue\").\n\nClosing rather than deleting: the customer gets an empty panel, and the\nteam keeps the conversation they were already answering. Anything else\nwould let someone erase a thread from under the person working it.","operationId":"start_new_issue_v1_support_chat_close_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SupportChatState"}}}}},"security":[{"HTTPBearer":[]}]}},"/v1/apps":{"get":{"tags":["apps"],"summary":"Get Apps","operationId":"get_apps_v1_apps_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":20,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"title":"Response Get Apps V1 Apps Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/apps/purchase-rule":{"get":{"tags":["apps"],"summary":"Get Purchase Rule","operationId":"get_purchase_rule_v1_apps_purchase_rule_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PurchaseRule"}}}}},"security":[{"HTTPBearer":[]}]},"put":{"tags":["apps"],"summary":"Set Purchase Rule","description":"Only the person themself, with no fresh sign-in (DEC-022): a chat that\nread their apps still buys only within their spending setting.","operationId":"set_purchase_rule_v1_apps_purchase_rule_put","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PurchaseRule"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PurchaseRule"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/v1/apps/actions/{action_id}":{"get":{"tags":["apps"],"summary":"Get App Action","operationId":"get_app_action_v1_apps_actions__action_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"action_id","in":"path","required":true,"schema":{"type":"string","title":"Action Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"title":"Response Get App Action V1 Apps Actions  Action Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/apps/actions/{action_id}/decision":{"post":{"tags":["apps"],"summary":"Decide App Action","description":"Send, or don't. Only the account owner's own session decides: an API\nkey, an OAuth app or an assistant gets ``403 human_decision_required``.\nA draft edited since it was reviewed is ``409 changed`` with what it says\nnow, to review again. ``remember`` on a vendor tool that edits or deletes\nneeds a fresh sign-in, checked before anything is decided: a ``403\nfresh_human_auth_required`` leaves the action waiting, so the page can\nstep up and send the same body again.","operationId":"decide_app_action_v1_apps_actions__action_id__decision_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"action_id","in":"path","required":true,"schema":{"type":"string","title":"Action Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AppDecision"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"title":"Response Decide App Action V1 Apps Actions  Action Id  Decision Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/apps/{app}/tools":{"get":{"tags":["apps"],"summary":"Get App Tools","description":"A connected vendor app's tools for \"Choose per action\": name, title\nand risk, turned-off ones included. 404 for Gmail, Calendar or anything\nelse that is not a vendor app.","operationId":"get_app_tools_v1_apps__app__tools_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"app","in":"path","required":true,"schema":{"type":"string","title":"App"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"title":"Response Get App Tools V1 Apps  App  Tools Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/apps/{app}/rules":{"put":{"tags":["apps"],"summary":"Set App Rule","description":"Change what AI may do on its own in one app: one tier or one tool, to\n``allow``, ``ask`` or ``off`` (null restores the default). Only the person\nthemself; letting something that sends, edits or deletes run on its own\nalso needs a fresh sign-in (``403 fresh_human_auth_required``).","operationId":"set_app_rule_v1_apps__app__rules_put","security":[{"HTTPBearer":[]}],"parameters":[{"name":"app","in":"path","required":true,"schema":{"type":"string","title":"App"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RuleChange"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"title":"Response Set App Rule V1 Apps  App  Rules Put"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/apps/accounts/{connection_id}/disconnect":{"post":{"tags":["apps"],"summary":"Disconnect Account","operationId":"disconnect_account_v1_apps_accounts__connection_id__disconnect_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"connection_id","in":"path","required":true,"schema":{"type":"string","title":"Connection Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"title":"Response Disconnect Account V1 Apps Accounts  Connection Id  Disconnect Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/apps/accounts/{connection_id}/restore":{"post":{"tags":["apps"],"summary":"Restore Account","operationId":"restore_account_v1_apps_accounts__connection_id__restore_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"connection_id","in":"path","required":true,"schema":{"type":"string","title":"Connection Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"title":"Response Restore Account V1 Apps Accounts  Connection Id  Restore Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/skills":{"get":{"tags":["skills"],"summary":"List Skills","operationId":"list_skills_v1_skills_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SkillList"}}}}},"security":[{"HTTPBearer":[]}]},"post":{"tags":["skills"],"summary":"Create Skill","operationId":"create_skill_v1_skills_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SkillCreate"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SkillView"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/v1/skills/{skill_id}":{"get":{"tags":["skills"],"summary":"Get Skill","operationId":"get_skill_v1_skills__skill_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"skill_id","in":"path","required":true,"schema":{"type":"string","title":"Skill Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SkillView"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"patch":{"tags":["skills"],"summary":"Update Skill","operationId":"update_skill_v1_skills__skill_id__patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"skill_id","in":"path","required":true,"schema":{"type":"string","title":"Skill Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SkillUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SkillView"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/skills/{skill_id}/SKILL.md":{"get":{"tags":["skills"],"summary":"Export Skill","description":"The skill as a portable SKILL.md (agentskills.io), to save as\n``<name>/SKILL.md`` in any agent's skills folder.","operationId":"export_skill_v1_skills__skill_id__SKILL_md_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"skill_id","in":"path","required":true,"schema":{"type":"string","title":"Skill Id"}}],"responses":{"200":{"description":"Successful Response","content":{"text/plain":{"schema":{"type":"string"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/support/threads":{"get":{"tags":["admin"],"summary":"List Support Threads","description":"Conversations for the inbox, busiest first.","operationId":"list_support_threads_admin_support_threads_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"status","in":"query","required":false,"schema":{"type":"string","pattern":"^(open|closed)$","default":"open","title":"Status"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":50,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SupportInboxList"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/support/threads/{thread_id}":{"get":{"tags":["admin"],"summary":"Read Support Thread","operationId":"read_support_thread_admin_support_threads__thread_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"thread_id","in":"path","required":true,"schema":{"type":"string","title":"Thread Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SupportInboxDetail"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/support/threads/{thread_id}/messages":{"post":{"tags":["admin"],"summary":"Reply To Support Thread","description":"Answer a customer, and mail them the answer: always the first one, and\nlater ones if they have walked away.","operationId":"reply_to_support_thread_admin_support_threads__thread_id__messages_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"thread_id","in":"path","required":true,"schema":{"type":"string","title":"Thread Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SupportStaffReply"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SupportInboxDetail"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/support/threads/{thread_id}/close":{"post":{"tags":["admin"],"summary":"Close Support Thread","description":"Close a thread. The customer keeps seeing it, told who closed it, until\nthey start a new issue themselves.","operationId":"close_support_thread_admin_support_threads__thread_id__close_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"thread_id","in":"path","required":true,"schema":{"type":"string","title":"Thread Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SupportInboxDetail"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/auth/sso/providers":{"get":{"summary":"List Sso Providers","operationId":"list_sso_providers_v1_auth_sso_providers_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"type":"string"},"type":"array","title":"Response List Sso Providers V1 Auth Sso Providers Get"}}}}}}},"/v1/auth/sso/{provider}/start":{"get":{"summary":"Start Sso","operationId":"start_sso_v1_auth_sso__provider__start_get","parameters":[{"name":"provider","in":"path","required":true,"schema":{"type":"string","title":"Provider"}},{"name":"next","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":2048},{"type":"null"}],"title":"Next"}},{"name":"ref","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Ref"}},{"name":"reauth","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":8},{"type":"null"}],"title":"Reauth"}},{"name":"promo","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Promo"}},{"name":"surface","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":16},{"type":"null"}],"title":"Surface"}},{"name":"utm_source","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Utm Source"}},{"name":"utm_medium","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Utm Medium"}},{"name":"utm_campaign","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Utm Campaign"}},{"name":"utm_content","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Utm Content"}},{"name":"referrer","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Referrer"}},{"name":"landing_page","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Landing Page"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/auth/sso/{provider}/callback":{"get":{"summary":"Sso Callback","operationId":"sso_callback_v1_auth_sso__provider__callback_get","parameters":[{"name":"provider","in":"path","required":true,"schema":{"type":"string","title":"Provider"}},{"name":"code","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":2048},{"type":"null"}],"title":"Code"}},{"name":"state","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":256},{"type":"null"}],"title":"State"}},{"name":"error","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":128},{"type":"null"}],"title":"Error"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/mcp":{"get":{"tags":["mcp"],"summary":"Mcp Notifications","operationId":"mcp_notifications_mcp_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"post":{"tags":["mcp"],"summary":"Mcp Endpoint","operationId":"mcp_endpoint_mcp_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/health":{"get":{"summary":"Health","operationId":"health_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}}},"components":{"schemas":{"ActivityDay":{"properties":{"date":{"type":"string","title":"Date"},"searches":{"type":"integer","title":"Searches"},"hires":{"type":"integer","title":"Hires"},"delivered":{"type":"integer","title":"Delivered"}},"type":"object","required":["date","searches","hires","delivered"],"title":"ActivityDay"},"ActivityMetricsResponse":{"properties":{"snapshots":{"items":{"$ref":"#/components/schemas/ActivitySnapshot"},"type":"array","title":"Snapshots"},"stale":{"type":"boolean","title":"Stale","default":false},"unavailable":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Unavailable"}},"type":"object","title":"ActivityMetricsResponse"},"ActivitySnapshot":{"properties":{"date_utc":{"type":"string","format":"date","title":"Date Utc"},"captured_at_utc":{"type":"string","format":"date-time","title":"Captured At Utc"},"total_users":{"type":"integer","minimum":0.0,"title":"Total Users"},"dau":{"type":"integer","minimum":0.0,"title":"Dau"},"wau":{"type":"integer","minimum":0.0,"title":"Wau"},"mau":{"type":"integer","minimum":0.0,"title":"Mau"}},"type":"object","required":["date_utc","captured_at_utc","total_users","dau","wau","mau"],"title":"ActivitySnapshot"},"AdminCreditRequest":{"properties":{"amount_micros":{"type":"integer","exclusiveMinimum":0.0,"title":"Amount Micros"},"note":{"type":"string","maxLength":500,"minLength":1,"title":"Note"}},"additionalProperties":false,"type":"object","required":["amount_micros","note"],"title":"AdminCreditRequest"},"AdminDashboardCreditSources":{"properties":{"card_micros":{"type":"integer","title":"Card Micros"},"bonus_micros":{"type":"integer","title":"Bonus Micros"},"signup_micros":{"type":"integer","title":"Signup Micros"},"referral_micros":{"type":"integer","title":"Referral Micros"},"admin_micros":{"type":"integer","title":"Admin Micros"},"other_micros":{"type":"integer","title":"Other Micros"}},"type":"object","required":["card_micros","bonus_micros","signup_micros","referral_micros","admin_micros","other_micros"],"title":"AdminDashboardCreditSources","description":"Wallet credit given to buyers in the window, by source."},"AdminDashboardFunnel":{"properties":{"signed_up":{"type":"integer","title":"Signed Up"},"signed_up_from_invites":{"type":"integer","title":"Signed Up From Invites"},"signed_up_invited_earlier":{"type":"integer","title":"Signed Up Invited Earlier"},"paid":{"type":"integer","title":"Paid"},"hired":{"type":"integer","title":"Hired"},"hired_again":{"type":"integer","title":"Hired Again"},"too_early":{"type":"integer","title":"Too Early"},"hired_without_paying":{"type":"integer","title":"Hired Without Paying"}},"type":"object","required":["signed_up","signed_up_from_invites","signed_up_invited_earlier","paid","hired","hired_again","too_early","hired_without_paying"],"title":"AdminDashboardFunnel","description":"Signed up → paid → hired → hired again after a week.\n\n``too_early`` hired less than a week before the window ended, so they\ncould not have come back yet. ``hired_without_paying`` is outside the\nfunnel and reported beside it."},"AdminDashboardInvites":{"properties":{"sent":{"type":"integer","title":"Sent"},"signed_up":{"type":"integer","title":"Signed Up"}},"type":"object","required":["sent","signed_up"],"title":"AdminDashboardInvites","description":"Distinct people invited in the window, and how many signed up by its end."},"AdminDashboardLeaderboardUser":{"properties":{"user_id":{"type":"string","title":"User Id"},"email":{"type":"string","title":"Email"},"spent_micros":{"type":"integer","title":"Spent Micros"},"hires":{"type":"integer","title":"Hires"},"paid_micros":{"type":"integer","title":"Paid Micros"},"credits_micros":{"type":"integer","title":"Credits Micros"},"balance_micros":{"type":"integer","title":"Balance Micros"},"first_paid_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"First Paid At"},"last_active_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Active At"}},"type":"object","required":["user_id","email","spent_micros","hires","paid_micros","credits_micros","balance_micros"],"title":"AdminDashboardLeaderboardUser"},"AdminDashboardMetrics":{"properties":{"since":{"type":"string","format":"date-time","title":"Since"},"until":{"type":"string","format":"date-time","title":"Until"},"users":{"$ref":"#/components/schemas/AdminDashboardUsers"},"payments":{"$ref":"#/components/schemas/AdminDashboardPayments"},"revenue":{"$ref":"#/components/schemas/AdminDashboardRevenue"},"credit_sources":{"$ref":"#/components/schemas/AdminDashboardCreditSources"},"invites":{"$ref":"#/components/schemas/AdminDashboardInvites"},"invites_previous":{"$ref":"#/components/schemas/AdminDashboardInvites"},"funnel":{"$ref":"#/components/schemas/AdminDashboardFunnel"},"funnel_previous":{"$ref":"#/components/schemas/AdminDashboardFunnel"},"sources":{"items":{"$ref":"#/components/schemas/AdminDashboardSource"},"type":"array","title":"Sources"},"user_leaderboard":{"items":{"$ref":"#/components/schemas/AdminDashboardLeaderboardUser"},"type":"array","title":"User Leaderboard"}},"type":"object","required":["since","until","users","payments","revenue","credit_sources","invites","invites_previous","funnel","funnel_previous","sources","user_leaderboard"],"title":"AdminDashboardMetrics","description":"The console dashboard figures no other admin endpoint already returns.\n\nActivity history, service activity, dispatch health, disputes, keys and\nfleet state each have their own endpoint; the dashboard composes those."},"AdminDashboardPayments":{"properties":{"paying_users":{"type":"integer","title":"Paying Users"},"paying_users_previous":{"type":"integer","title":"Paying Users Previous"},"first_time_paying_users":{"type":"integer","title":"First Time Paying Users"},"count":{"type":"integer","title":"Count"},"count_previous":{"type":"integer","title":"Count Previous"},"amount_micros":{"type":"integer","title":"Amount Micros"},"amount_previous_micros":{"type":"integer","title":"Amount Previous Micros"}},"type":"object","required":["paying_users","paying_users_previous","first_time_paying_users","count","count_previous","amount_micros","amount_previous_micros"],"title":"AdminDashboardPayments","description":"Card top-ups that actually settled, i.e. money that arrived.\n\nCounted on this deployment's own Stripe network only: a test-mode\ndeployment reports its test charges, a live one reports live charges, and\nthe two are never summed into one figure. Amounts are cash paid, without\nthe bonus Delegate adds on larger top-ups."},"AdminDashboardRevenue":{"properties":{"net_micros":{"type":"integer","title":"Net Micros"},"net_previous_micros":{"type":"integer","title":"Net Previous Micros"},"platform_fee_micros":{"type":"integer","title":"Platform Fee Micros"}},"type":"object","required":["net_micros","net_previous_micros","platform_fee_micros"],"title":"AdminDashboardRevenue","description":"Settled service charges and earned fees, staff excluded."},"AdminDashboardSource":{"properties":{"source":{"type":"string","title":"Source"},"signups":{"type":"integer","title":"Signups"},"paid":{"type":"integer","title":"Paid"}},"type":"object","required":["source","signups","paid"],"title":"AdminDashboardSource","description":"One first-touch channel: signups in the window, and how many paid."},"AdminDashboardUsers":{"properties":{"total_signups":{"type":"integer","title":"Total Signups"},"signups":{"type":"integer","title":"Signups"},"paying_users_ever":{"type":"integer","title":"Paying Users Ever"},"by_day":{"items":{"$ref":"#/components/schemas/AdminDashboardUsersDay"},"type":"array","title":"By Day"}},"type":"object","required":["total_signups","signups","paying_users_ever","by_day"],"title":"AdminDashboardUsers","description":"Live, non-staff accounts, and how many of them have ever paid by card.\n\n``by_day`` holds both totals at the end of each UTC day in the window,\nrebuilt from creation and first-payment times rather than captured."},"AdminDashboardUsersDay":{"properties":{"date":{"type":"string","title":"Date"},"signups_total":{"type":"integer","title":"Signups Total"},"paying_total":{"type":"integer","title":"Paying Total"}},"type":"object","required":["date","signups_total","paying_total"],"title":"AdminDashboardUsersDay"},"AdminDispatchRetryResponse":{"properties":{"job_id":{"type":"string","title":"Job Id"},"status":{"type":"string","title":"Status"}},"type":"object","required":["job_id","status"],"title":"AdminDispatchRetryResponse","description":"Result of re-queuing a dispatch_failed job from the admin UI."},"AdminDisputeItem":{"properties":{"id":{"type":"string","title":"Id"},"conversation_id":{"type":"string","title":"Conversation Id"},"contract_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Contract Id"},"status":{"type":"string","title":"Status"},"reason":{"type":"string","title":"Reason"},"outcome":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Outcome"},"raised_by_role":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Raised By Role"},"resolution_note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Resolution Note"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"resolved_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Resolved At"},"provider_response_due_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Provider Response Due At"},"provider_response":{"anyOf":[{"$ref":"#/components/schemas/UsageDisputeProviderResponse"},{"type":"null"}]},"conversation_status":{"type":"string","title":"Conversation Status"},"escrow_locked_micros":{"type":"integer","title":"Escrow Locked Micros"},"auto_accept":{"type":"boolean","title":"Auto Accept","default":false},"service_title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Service Title"},"provider_display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provider Display Name"},"task_title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Task Title"},"task_summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Task Summary"},"contract_snapshot":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Contract Snapshot"},"latest_response_preview":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Latest Response Preview"},"latest_artifacts":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Latest Artifacts"},"latest_settlement":{"anyOf":[{"$ref":"#/components/schemas/SettlementSummaryPayload"},{"type":"null"}]},"usage_report":{"anyOf":[{"$ref":"#/components/schemas/UsageReportResponse"},{"type":"null"}]},"buyer_email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Buyer Email"}},"type":"object","required":["id","conversation_id","status","reason","created_at","conversation_status","escrow_locked_micros"],"title":"AdminDisputeItem","description":"Admin dispute context, including the buyer identity needed to adjudicate."},"AdminDisputeListResponse":{"properties":{"disputes":{"items":{"$ref":"#/components/schemas/AdminDisputeItem"},"type":"array","title":"Disputes"},"open_count":{"type":"integer","title":"Open Count"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["disputes","open_count","total"],"title":"AdminDisputeListResponse"},"AdminEmbeddingRebuildResponse":{"properties":{"job_id":{"type":"string","title":"Job Id"},"job_status":{"type":"string","title":"Job Status"},"queued":{"type":"boolean","title":"Queued"},"wait":{"type":"boolean","title":"Wait"},"processed":{"type":"boolean","title":"Processed"},"timed_out":{"type":"boolean","title":"Timed Out","default":false},"service_vectors_loaded":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Service Vectors Loaded"},"term_vectors_loaded":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Term Vectors Loaded"},"semantic_search_ready":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Semantic Search Ready"},"semantic_readiness_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Semantic Readiness Reason"}},"type":"object","required":["job_id","job_status","queued","wait","processed"],"title":"AdminEmbeddingRebuildResponse"},"AdminEventTypesResponse":{"properties":{"event_types":{"items":{"type":"string"},"type":"array","title":"Event Types"}},"type":"object","required":["event_types"],"title":"AdminEventTypesResponse","description":"Distinct event types present across the marketplace, for the admin\nevent-log type filter."},"AdminGrantEntry":{"properties":{"id":{"type":"string","title":"Id"},"status":{"type":"string","title":"Status"},"slug":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Slug"},"owner_user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Owner User Id"},"grantee_agent_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Grantee Agent Id"},"grantee_display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Grantee Display Name"},"connection_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Connection Id"},"connection_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Connection Label"},"allowed_scopes":{"items":{"type":"string"},"type":"array","title":"Allowed Scopes","default":[]},"connection_kind":{"type":"string","title":"Connection Kind","default":"mcp"},"provider_slug":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provider Slug"},"always":{"type":"boolean","title":"Always","default":false},"conversation_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Conversation Id"},"expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Expires At"},"last_used_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Used At"},"created_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Created At"},"resolved_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Resolved At"}},"type":"object","required":["id","status"],"title":"AdminGrantEntry","description":"One connection grant in the admin fleet view, resolved to its provider\nslug and stamped with the owning user."},"AdminIncidentTimeline":{"properties":{"conversation_id":{"type":"string","title":"Conversation Id"},"conversation_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Conversation Status"},"settled_outcome":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Settled Outcome"},"created_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Created At"},"delivered_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Delivered At"},"entries":{"items":{"$ref":"#/components/schemas/AdminIncidentTimelineEntry"},"type":"array","title":"Entries"}},"type":"object","required":["conversation_id","entries"],"title":"AdminIncidentTimeline","description":"The whole story of one conversation assembled from every persisted source,\nordered by time - the single surface for reconstructing a failed/disputed\nincident without hand-joining tables."},"AdminIncidentTimelineEntry":{"properties":{"ts":{"type":"string","format":"date-time","title":"Ts"},"source":{"type":"string","title":"Source"},"kind":{"type":"string","title":"Kind"},"summary":{"type":"string","title":"Summary"},"ref_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ref Id"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"error_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Type"},"request_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Request Id"}},"type":"object","required":["ts","source","kind","summary"],"title":"AdminIncidentTimelineEntry","description":"One time-ordered event in a conversation's reconstructed incident timeline."},"AdminIntegrationEntry":{"properties":{"slug":{"type":"string","title":"Slug"},"name":{"type":"string","title":"Name"},"description":{"type":"string","title":"Description"},"category":{"type":"string","title":"Category"},"mcp_url":{"type":"string","title":"Mcp Url"},"website":{"type":"string","title":"Website"},"docs_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Docs Url"},"brand_color":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Brand Color"},"verified_on":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Verified On"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notes"},"lifecycle":{"type":"string","title":"Lifecycle","default":"active"},"banner":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Banner"},"oauth":{"anyOf":[{"$ref":"#/components/schemas/LibraryOAuthInfo"},{"type":"null"}]},"api_key":{"anyOf":[{"$ref":"#/components/schemas/LibraryApiKeyInfo"},{"type":"null"}]},"anonymous":{"anyOf":[{"$ref":"#/components/schemas/LibraryAnonymousInfo"},{"type":"null"}]},"connector":{"anyOf":[{"$ref":"#/components/schemas/LibraryConnectorInfo"},{"type":"null"}]},"connection":{"anyOf":[{"$ref":"#/components/schemas/LibraryConnectionInfo"},{"type":"null"}]},"connector_connection":{"anyOf":[{"$ref":"#/components/schemas/LibraryConnectionInfo"},{"type":"null"}]},"hidden":{"type":"boolean","title":"Hidden","default":false},"connections":{"type":"integer","title":"Connections","default":0},"active_grants":{"type":"integer","title":"Active Grants","default":0},"health":{"anyOf":[{"$ref":"#/components/schemas/IntegrationHealthEntry"},{"type":"null"}]}},"type":"object","required":["slug","name","description","category","mcp_url","website"],"title":"AdminIntegrationEntry","description":"The admin-console view of a catalog entry: every field end users see plus\nthe ``hidden`` flag (hidden/disabled entries are present here, omitted there),\nfleet adoption counts, and the latest reachability probe (if any)."},"AdminInviteItem":{"properties":{"id":{"type":"string","title":"Id"},"email":{"type":"string","title":"Email"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"expires_at":{"type":"string","format":"date-time","title":"Expires At"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"},"category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category"},"category_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category Name"},"category_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category Label"}},"type":"object","required":["id","email","created_at","expires_at"],"title":"AdminInviteItem"},"AdminInvitesResponse":{"properties":{"invites":{"items":{"$ref":"#/components/schemas/AdminInviteItem"},"type":"array","title":"Invites"}},"type":"object","required":["invites"],"title":"AdminInvitesResponse"},"AdminOperationalEventDetail":{"properties":{"id":{"type":"string","title":"Id"},"event_type":{"type":"string","title":"Event Type"},"status":{"type":"string","title":"Status"},"provider_agent_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provider Agent Id"},"provider_display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provider Display Name"},"service_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Service Id"},"service_title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Service Title"},"job_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Job Id"},"conversation_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Conversation Id"},"principal_type":{"type":"string","title":"Principal Type","default":"system"},"api_key_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Api Key Id"},"duration_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Duration Ms"},"error_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Type"},"error_message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Message"},"error_truncated":{"type":"boolean","title":"Error Truncated","default":false},"request_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Request Id"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"event_metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Event Metadata"},"raw_response_excerpt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Raw Response Excerpt"}},"type":"object","required":["id","event_type","status","created_at"],"title":"AdminOperationalEventDetail","description":"Full single-event view: the list row plus the raw ``event_metadata`` and,\nfor dispatch failures, the redacted upstream response excerpt."},"AdminOperationalEventListResponse":{"properties":{"events":{"items":{"$ref":"#/components/schemas/AdminOperationalEventRow"},"type":"array","title":"Events"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["events","total"],"title":"AdminOperationalEventListResponse"},"AdminOperationalEventRow":{"properties":{"id":{"type":"string","title":"Id"},"event_type":{"type":"string","title":"Event Type"},"status":{"type":"string","title":"Status"},"provider_agent_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provider Agent Id"},"provider_display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provider Display Name"},"service_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Service Id"},"service_title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Service Title"},"job_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Job Id"},"conversation_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Conversation Id"},"principal_type":{"type":"string","title":"Principal Type","default":"system"},"api_key_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Api Key Id"},"duration_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Duration Ms"},"error_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Type"},"error_message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Message"},"error_truncated":{"type":"boolean","title":"Error Truncated","default":false},"request_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Request Id"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"event_metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Event Metadata"}},"type":"object","required":["id","event_type","status","created_at"],"title":"AdminOperationalEventRow","description":"One operational event in the admin (cross-tenant) event log.\n\nUnlike the provider row, this resolves the provider's display name and\nexposes the correlation/truncation fields an admin needs to root-cause a\nfailure. ``event_metadata`` is omitted from the list row by default (the\ndetail endpoint carries it); pass ``include_metadata=true`` to get it\ninline — the console's recent-fleet-actions panel reads whole events\nwhose payload IS the metadata, and per-row detail calls would be silly."},"AdminOrchestrationRootSummary":{"properties":{"id":{"type":"string","title":"Id"},"requester_user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Requester User Id"},"requester_email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Requester Email"},"worker_agent_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Worker Agent Id"},"provider_owner_user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provider Owner User Id"},"provider_owner_email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provider Owner Email"},"service_title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Service Title"},"provider_display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provider Display Name"},"status":{"type":"string","title":"Status"},"direct_child_count":{"type":"integer","title":"Direct Child Count"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated At"},"delivered_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Delivered At"},"task_summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Task Summary"},"latest_response_preview":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Latest Response Preview"}},"type":"object","required":["id","status","direct_child_count"],"title":"AdminOrchestrationRootSummary"},"AdminOrchestrationsResponse":{"properties":{"roots":{"items":{"$ref":"#/components/schemas/AdminOrchestrationRootSummary"},"type":"array","title":"Roots"},"total_roots":{"type":"integer","title":"Total Roots"},"returned":{"type":"integer","title":"Returned"},"scan_cap":{"type":"integer","title":"Scan Cap"},"truncated":{"type":"boolean","title":"Truncated"}},"type":"object","required":["roots","total_roots","returned","scan_cap","truncated"],"title":"AdminOrchestrationsResponse"},"AdminRetentionRunResponse":{"properties":{"deleted":{"type":"integer","title":"Deleted"},"cutoff":{"type":"string","format":"date-time","title":"Cutoff"},"retention_days":{"type":"integer","title":"Retention Days"}},"type":"object","required":["deleted","cutoff","retention_days"],"title":"AdminRetentionRunResponse","description":"Result of a manual operational-event retention sweep."},"AdminRevenueByDay":{"properties":{"date":{"type":"string","title":"Date"},"gross_micros":{"type":"integer","title":"Gross Micros"},"refunded_micros":{"type":"integer","title":"Refunded Micros"},"charges":{"type":"integer","title":"Charges","default":0}},"type":"object","required":["date","gross_micros","refunded_micros"],"title":"AdminRevenueByDay"},"AdminRevenueTotals":{"properties":{"gross_charged_micros":{"type":"integer","title":"Gross Charged Micros"},"provider_net_micros":{"type":"integer","title":"Provider Net Micros"},"platform_fee_micros":{"type":"integer","title":"Platform Fee Micros"},"refunded_micros":{"type":"integer","title":"Refunded Micros"},"unique_buyers":{"type":"integer","title":"Unique Buyers"},"total_events":{"type":"integer","title":"Total Events"}},"type":"object","required":["gross_charged_micros","provider_net_micros","platform_fee_micros","refunded_micros","unique_buyers","total_events"],"title":"AdminRevenueTotals"},"AdminSearchIndexJobSummary":{"properties":{"id":{"type":"string","title":"Id"},"job_type":{"type":"string","title":"Job Type"},"target_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target Id"},"operation":{"type":"string","title":"Operation"},"reason":{"type":"string","title":"Reason"},"status":{"type":"string","title":"Status"},"attempts":{"type":"integer","title":"Attempts"},"max_attempts":{"type":"integer","title":"Max Attempts"},"available_at":{"type":"string","format":"date-time","title":"Available At"},"locked_by":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Locked By"},"locked_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Locked At"},"error_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Type"},"error_message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Message"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"},"completed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Completed At"}},"type":"object","required":["id","job_type","operation","reason","status","attempts","max_attempts","available_at","updated_at"],"title":"AdminSearchIndexJobSummary"},"AdminSearchIndexJobsResponse":{"properties":{"worker_mode":{"type":"string","enum":["disabled","in_process","external"],"title":"Worker Mode"},"pending":{"type":"integer","title":"Pending"},"retry_pending":{"type":"integer","title":"Retry Pending"},"processing":{"type":"integer","title":"Processing"},"stale_processing":{"type":"integer","title":"Stale Processing"},"failed":{"type":"integer","title":"Failed"},"oldest_pending_seconds":{"type":"integer","title":"Oldest Pending Seconds"},"oldest_processing_seconds":{"type":"integer","title":"Oldest Processing Seconds"},"recent_failures":{"items":{"$ref":"#/components/schemas/AdminSearchIndexJobSummary"},"type":"array","title":"Recent Failures"}},"type":"object","required":["worker_mode","pending","retry_pending","processing","stale_processing","failed","oldest_pending_seconds","oldest_processing_seconds"],"title":"AdminSearchIndexJobsResponse"},"AdminServiceRevenueRow":{"properties":{"service_id":{"type":"string","title":"Service Id"},"title":{"type":"string","title":"Title"},"provider_agent_id":{"type":"string","title":"Provider Agent Id"},"provider_display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provider Display Name"},"pricing_model":{"type":"string","title":"Pricing Model"},"price_micros":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Price Micros"},"platform_fee_bps":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Platform Fee Bps"},"effective_fee_bps":{"type":"integer","title":"Effective Fee Bps"},"status":{"type":"string","title":"Status"},"gross_charged_micros":{"type":"integer","title":"Gross Charged Micros"},"provider_net_micros":{"type":"integer","title":"Provider Net Micros"},"platform_fee_micros":{"type":"integer","title":"Platform Fee Micros"},"refunded_micros":{"type":"integer","title":"Refunded Micros"},"total_events":{"type":"integer","title":"Total Events"},"last_event_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Event At"}},"type":"object","required":["service_id","title","provider_agent_id","pricing_model","effective_fee_bps","status","gross_charged_micros","provider_net_micros","platform_fee_micros","refunded_micros","total_events"],"title":"AdminServiceRevenueRow"},"AdminServicesRevenueResponse":{"properties":{"totals":{"$ref":"#/components/schemas/AdminRevenueTotals"},"by_service":{"items":{"$ref":"#/components/schemas/AdminServiceRevenueRow"},"type":"array","title":"By Service"},"by_day":{"items":{"$ref":"#/components/schemas/AdminRevenueByDay"},"type":"array","title":"By Day"}},"type":"object","required":["totals","by_service","by_day"],"title":"AdminServicesRevenueResponse"},"AdminUserRoleUpdate":{"properties":{"is_admin":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Admin"},"can_provide":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Can Provide"},"staging_access":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Staging Access"},"can_refer":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Can Refer"},"chat_access":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Chat Access"},"apps_access":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Apps Access"},"sponsored_daily_cap_micros":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Sponsored Daily Cap Micros"}},"type":"object","title":"AdminUserRoleUpdate"},"AdminUserSummary":{"properties":{"is_internal":{"type":"boolean","title":"Is Internal","default":false},"can_invite":{"type":"boolean","title":"Can Invite","default":false},"can_invite_override":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Can Invite Override"},"invitation_level":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Invitation Level"},"invitation_generation":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Invitation Generation"},"invitation_trust_level":{"anyOf":[{"type":"integer","maximum":2.0,"minimum":0.0},{"type":"null"}],"title":"Invitation Trust Level"},"invited_by_user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Invited By User Id"},"invited_by_email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Invited By Email"},"signup_origin":{"type":"string","title":"Signup Origin","default":"unknown"},"invited_user_count":{"type":"integer","title":"Invited User Count","default":0},"intro_call_booked_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Intro Call Booked At"},"intro_call_credited":{"type":"boolean","title":"Intro Call Credited","default":false},"id":{"type":"string","title":"Id"},"email":{"type":"string","title":"Email"},"display_name":{"type":"string","title":"Display Name","default":""},"is_admin":{"type":"boolean","title":"Is Admin"},"can_provide":{"type":"boolean","title":"Can Provide"},"staging_access":{"type":"boolean","title":"Staging Access","default":false},"chat_access":{"type":"boolean","title":"Chat Access","default":false},"apps_access":{"type":"boolean","title":"Apps Access","default":false},"sponsored_daily_cap_micros":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Sponsored Daily Cap Micros"},"can_refer":{"type":"boolean","title":"Can Refer"},"escrow_balance_micros":{"type":"integer","title":"Escrow Balance Micros"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"agent_count":{"type":"integer","title":"Agent Count"},"enabled_agent_count":{"type":"integer","title":"Enabled Agent Count"},"live_agent_count":{"type":"integer","title":"Live Agent Count"},"service_count":{"type":"integer","title":"Service Count"},"active_service_count":{"type":"integer","title":"Active Service Count"},"last_agent_seen_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Agent Seen At"},"last_active_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Active At"}},"type":"object","required":["id","email","is_admin","can_provide","can_refer","escrow_balance_micros","created_at","agent_count","enabled_agent_count","live_agent_count","service_count","active_service_count"],"title":"AdminUserSummary"},"AdminUsersResponse":{"properties":{"total_users":{"type":"integer","title":"Total Users"},"admin_users":{"type":"integer","title":"Admin Users"},"dau":{"type":"integer","title":"Dau"},"wau":{"type":"integer","title":"Wau"},"mau":{"type":"integer","title":"Mau"},"total_agents":{"type":"integer","title":"Total Agents"},"live_agents":{"type":"integer","title":"Live Agents"},"total_services":{"type":"integer","title":"Total Services"},"active_services":{"type":"integer","title":"Active Services"},"users":{"items":{"$ref":"#/components/schemas/AdminUserSummary"},"type":"array","title":"Users"}},"type":"object","required":["total_users","admin_users","dau","wau","mau","total_agents","live_agents","total_services","active_services","users"],"title":"AdminUsersResponse"},"AgentBundleApprove":{"properties":{"host":{"type":"string","title":"Host","default":"fleet-1"}},"type":"object","title":"AgentBundleApprove"},"AgentBundleResponse":{"properties":{"id":{"type":"string","title":"Id"},"bundle_file_id":{"type":"string","title":"Bundle File Id"},"bundle_sha256":{"type":"string","title":"Bundle Sha256"},"agent_key":{"type":"string","title":"Agent Key"},"display_name":{"type":"string","title":"Display Name"},"status":{"type":"string","title":"Status"},"manifest":{"additionalProperties":true,"type":"object","title":"Manifest"},"source_kind":{"type":"string","title":"Source Kind","default":"upload"},"source_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Url"},"source_ref":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Ref"},"source_commit_sha":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Commit Sha"},"source_subdirectory":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Subdirectory"},"compatibility_mode":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Compatibility Mode"},"conformance_report":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Conformance Report"},"uploaded_by_user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Uploaded By User Id"},"uploaded_by_email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Uploaded By Email"},"review_note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Review Note"},"deployment_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Deployment Id"},"approved_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Approved At"},"created_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Created At"}},"type":"object","required":["id","bundle_file_id","bundle_sha256","agent_key","display_name","status","manifest"],"title":"AgentBundleResponse"},"AgentBundleSuspend":{"properties":{"reason":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Reason"}},"type":"object","title":"AgentBundleSuspend"},"AgentDependencyAnalysisResponse":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"agent_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Name"},"window":{"$ref":"#/components/schemas/ObservabilityWindow"},"totals":{"$ref":"#/components/schemas/AgentDependencyTotals"},"dependencies":{"items":{"$ref":"#/components/schemas/AgentDependencyRow"},"type":"array","title":"Dependencies"},"time_series":{"items":{"$ref":"#/components/schemas/DependencyTimePoint"},"type":"array","title":"Time Series"},"truncated":{"type":"boolean","title":"Truncated","default":false}},"type":"object","required":["agent_id","window","totals"],"title":"AgentDependencyAnalysisResponse"},"AgentDependencyOverviewRow":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"agent_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Name"},"dependency_count":{"type":"integer","title":"Dependency Count"},"sub_hire_count":{"type":"integer","title":"Sub Hire Count"},"total_spend_micros":{"type":"integer","title":"Total Spend Micros"},"error_count":{"type":"integer","title":"Error Count","default":0},"last_used_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Used At"}},"type":"object","required":["agent_id","dependency_count","sub_hire_count","total_spend_micros"],"title":"AgentDependencyOverviewRow"},"AgentDependencyRow":{"properties":{"dependency_key":{"type":"string","title":"Dependency Key"},"service_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Service Id"},"worker_agent_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Worker Agent Id"},"service_title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Service Title"},"provider_display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provider Display Name"},"usage_count":{"type":"integer","title":"Usage Count"},"total_cost_micros":{"type":"integer","title":"Total Cost Micros"},"in_flight_escrow_micros":{"type":"integer","title":"In Flight Escrow Micros","default":0},"avg_duration_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Avg Duration Ms"},"p95_duration_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"P95 Duration Ms"},"success_count":{"type":"integer","title":"Success Count","default":0},"error_count":{"type":"integer","title":"Error Count","default":0},"observed_success_rate":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Observed Success Rate"},"last_used_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Used At"},"reputation":{"$ref":"#/components/schemas/DependencyReputation"},"latest_error":{"anyOf":[{"$ref":"#/components/schemas/DependencyLatestError"},{"type":"null"}]},"time_series":{"items":{"$ref":"#/components/schemas/DependencyTimePoint"},"type":"array","title":"Time Series"}},"type":"object","required":["dependency_key","usage_count","total_cost_micros","reputation"],"title":"AgentDependencyRow","description":"One downstream service/agent this agent depends on, with its metrics."},"AgentDependencyTotals":{"properties":{"dependency_count":{"type":"integer","title":"Dependency Count"},"sub_hire_count":{"type":"integer","title":"Sub Hire Count"},"engagement_count":{"type":"integer","title":"Engagement Count"},"total_cost_micros":{"type":"integer","title":"Total Cost Micros"},"in_flight_escrow_micros":{"type":"integer","title":"In Flight Escrow Micros"},"success_count":{"type":"integer","title":"Success Count"},"error_count":{"type":"integer","title":"Error Count"}},"type":"object","required":["dependency_count","sub_hire_count","engagement_count","total_cost_micros","in_flight_escrow_micros","success_count","error_count"],"title":"AgentDependencyTotals"},"AgentDeploymentContainer":{"properties":{"profile":{"type":"string","enum":["base","elevenlabs","bundle"],"title":"Profile","default":"base"},"image":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Image"},"persistent_state":{"type":"boolean","title":"Persistent State","default":false},"memory":{"type":"string","title":"Memory","default":"1g"},"cpus":{"type":"number","maximum":16.0,"exclusiveMinimum":0.0,"title":"Cpus","default":1.0},"pids_limit":{"type":"integer","maximum":4096.0,"minimum":16.0,"title":"Pids Limit","default":256},"max_instances":{"anyOf":[{"type":"integer","maximum":100.0,"minimum":1.0},{"type":"null"}],"title":"Max Instances"},"jobs_per_instance":{"anyOf":[{"type":"integer","maximum":50.0,"minimum":1.0},{"type":"null"}],"title":"Jobs Per Instance"},"bundle_file_id":{"anyOf":[{"type":"string","maxLength":36},{"type":"null"}],"title":"Bundle File Id"},"bundle_sha256":{"anyOf":[{"type":"string","maxLength":64,"minLength":64},{"type":"null"}],"title":"Bundle Sha256"}},"additionalProperties":false,"type":"object","title":"AgentDeploymentContainer"},"AgentDeploymentCreate":{"properties":{"agent_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Id"},"agent_key":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"Agent Key"},"host":{"type":"string","title":"Host"},"name":{"type":"string","maxLength":255,"minLength":1,"title":"Name"},"desired_state":{"type":"string","enum":["running","stopped"],"title":"Desired State","default":"running"},"entry":{"$ref":"#/components/schemas/AgentDeploymentEntry"},"image_library_version":{"anyOf":[{"type":"string","maxLength":32},{"type":"null"}],"title":"Image Library Version"}},"type":"object","required":["host","name","entry"],"title":"AgentDeploymentCreate"},"AgentDeploymentEntry":{"properties":{"kind":{"type":"string","enum":["agent","mcp_provider"],"title":"Kind"},"module":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Module"},"port":{"anyOf":[{"type":"integer","maximum":65535.0,"minimum":1024.0},{"type":"null"}],"title":"Port"},"env":{"additionalProperties":{"type":"string"},"type":"object","title":"Env","default":{}},"env_passthrough":{"items":{"type":"string"},"type":"array","title":"Env Passthrough","default":[]},"container":{"$ref":"#/components/schemas/AgentDeploymentContainer","default":{"profile":"base","persistent_state":false,"memory":"1g","cpus":1.0,"pids_limit":256}}},"additionalProperties":false,"type":"object","required":["kind"],"title":"AgentDeploymentEntry"},"AgentDeploymentImageHistoryEntry":{"properties":{"image":{"type":"string","title":"Image"},"commit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Commit"},"agent_version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Version"},"at":{"type":"string","format":"date-time","title":"At"},"source":{"type":"string","title":"Source"},"launch_name":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Launch Name"},"library_version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Library Version"},"revision":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Revision"}},"type":"object","required":["image","at","source"],"title":"AgentDeploymentImageHistoryEntry"},"AgentDeploymentModuleOption":{"properties":{"value":{"type":"string","title":"Value"},"label":{"type":"string","title":"Label"},"default_port":{"type":"integer","maximum":65535.0,"minimum":1024.0,"title":"Default Port"},"container_profile":{"type":"string","enum":["base","elevenlabs"],"title":"Container Profile"}},"type":"object","required":["value","label","default_port","container_profile"],"title":"AgentDeploymentModuleOption"},"AgentDeploymentOptionsResponse":{"properties":{"hosts":{"items":{"type":"string"},"type":"array","title":"Hosts"},"modules":{"items":{"$ref":"#/components/schemas/AgentDeploymentModuleOption"},"type":"array","title":"Modules"}},"type":"object","required":["hosts","modules"],"title":"AgentDeploymentOptionsResponse"},"AgentDeploymentResponse":{"properties":{"id":{"type":"string","title":"Id"},"agent_id":{"type":"string","title":"Agent Id"},"agent_display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Display Name"},"agent_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Key"},"agent_enabled":{"type":"boolean","title":"Agent Enabled","default":true},"host":{"type":"string","title":"Host"},"name":{"type":"string","title":"Name"},"desired_state":{"type":"string","title":"Desired State"},"entry":{"$ref":"#/components/schemas/AgentDeploymentEntry"},"last_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Status"},"last_status_detail":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Status Detail"},"last_synced_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Synced At"},"created_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Created At"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"},"image_history":{"items":{"$ref":"#/components/schemas/AgentDeploymentImageHistoryEntry"},"type":"array","title":"Image History","default":[]}},"type":"object","required":["id","agent_id","host","name","desired_state","entry"],"title":"AgentDeploymentResponse"},"AgentDeploymentUpdate":{"properties":{"desired_state":{"anyOf":[{"type":"string","enum":["running","stopped"]},{"type":"null"}],"title":"Desired State"},"entry":{"anyOf":[{"$ref":"#/components/schemas/AgentDeploymentEntry"},{"type":"null"}]},"host":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"Host"},"image":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Image"},"image_commit":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Image Commit"},"image_agent_version":{"anyOf":[{"type":"string","maxLength":50},{"type":"null"}],"title":"Image Agent Version"},"image_launch_name":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Image Launch Name"},"image_library_version":{"anyOf":[{"type":"string","maxLength":32},{"type":"null"}],"title":"Image Library Version"}},"type":"object","title":"AgentDeploymentUpdate"},"AgentImagePublishRequest":{"properties":{"image":{"type":"string","title":"Image"},"commit":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Commit"},"agent_version":{"anyOf":[{"type":"string","maxLength":50},{"type":"null"}],"title":"Agent Version"},"display_name":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Display Name"},"description":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Description"},"library_version":{"anyOf":[{"type":"string","maxLength":32},{"type":"null"}],"title":"Library Version"}},"type":"object","required":["image"],"title":"AgentImagePublishRequest","description":"CI's payload for the single-purpose publish endpoint."},"AgentImagePublishResponse":{"properties":{"id":{"type":"string","title":"Id"},"host":{"type":"string","title":"Host"},"agent_key":{"type":"string","title":"Agent Key"},"image":{"type":"string","title":"Image"},"created":{"type":"boolean","title":"Created"}},"type":"object","required":["id","host","agent_key","image","created"],"title":"AgentImagePublishResponse"},"AgentResponse":{"properties":{"id":{"type":"string","title":"Id"},"display_name":{"type":"string","title":"Display Name"},"business_card":{"additionalProperties":true,"type":"object","title":"Business Card"},"status":{"type":"string","enum":["idle","live","offline","error"],"title":"Status"},"presence_status":{"type":"string","enum":["idle","live","offline","error"],"title":"Presence Status"},"reported_status":{"type":"string","enum":["idle","live","running","offline","error","unknown"],"title":"Reported Status"},"last_seen_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Seen At"},"callback_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Callback Url"},"notification_mode":{"type":"string","enum":["webhook","sse","long_poll","short_poll","poll"],"title":"Notification Mode","default":"poll"}},"type":"object","required":["id","display_name","business_card","status","presence_status","reported_status","last_seen_at"],"title":"AgentResponse"},"AgentSecretMasked":{"properties":{"name":{"type":"string","title":"Name"},"is_set":{"type":"boolean","title":"Is Set"},"last4":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last4"},"required":{"type":"boolean","title":"Required","default":false},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["name","is_set"],"title":"AgentSecretMasked","description":"A single agent secret as shown in the provider UI - never the plaintext.\n\n``required`` marks names the agent declares in ``Agent.required_env`` (surfaced\neven when unset so the UI can prompt for them). ``is_set`` is False for those\nrequired-but-unset placeholder rows."},"AgentSecretSetRequest":{"properties":{"value":{"type":"string","maxLength":8192,"minLength":1,"title":"Value"}},"type":"object","required":["value"],"title":"AgentSecretSetRequest","description":"Set or replace one agent secret. The value is write-only - it is encrypted\nat rest and never returned by any list/read endpoint."},"AgentStatusResponse":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"status":{"type":"string","enum":["idle","live","offline","error"],"title":"Status"},"presence_status":{"type":"string","enum":["idle","live","offline","error"],"title":"Presence Status"},"reported_status":{"type":"string","enum":["idle","live","running","offline","error","unknown"],"title":"Reported Status"},"is_live":{"type":"boolean","title":"Is Live"},"last_seen_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Seen At"}},"type":"object","required":["agent_id","status","presence_status","reported_status","is_live"],"title":"AgentStatusResponse"},"ApiKeyCreate":{"properties":{"label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Label"},"scopes":{"items":{"type":"string"},"type":"array","title":"Scopes"},"agent_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Id"},"expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Expires At"},"payment_mode":{"type":"string","enum":["none","escrow"],"title":"Payment Mode","default":"none"},"per_contract_limit_micros":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Per Contract Limit Micros"},"daily_limit_micros":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Daily Limit Micros"},"monthly_limit_micros":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Monthly Limit Micros"},"provider_ids":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Provider Ids"}},"type":"object","title":"ApiKeyCreate"},"ApiKeyResponse":{"properties":{"id":{"type":"string","title":"Id"},"label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Label"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"last_used_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Used At"},"scopes":{"items":{"type":"string"},"type":"array","title":"Scopes"},"agent_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Id"},"expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Expires At"},"payment_mode":{"type":"string","enum":["none","escrow"],"title":"Payment Mode","default":"none"},"per_contract_limit_micros":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Per Contract Limit Micros"},"daily_limit_micros":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Daily Limit Micros"},"monthly_limit_micros":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Monthly Limit Micros"},"provider_ids":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Provider Ids"},"compatibility_expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Compatibility Expires At"}},"type":"object","required":["id","label","created_at"],"title":"ApiKeyResponse"},"ApiKeyWithPlaintext":{"properties":{"id":{"type":"string","title":"Id"},"label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Label"},"plaintext_key":{"type":"string","title":"Plaintext Key"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"scopes":{"items":{"type":"string"},"type":"array","title":"Scopes"},"agent_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Id"},"expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Expires At"},"payment_mode":{"type":"string","enum":["none","escrow"],"title":"Payment Mode","default":"none"},"per_contract_limit_micros":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Per Contract Limit Micros"},"daily_limit_micros":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Daily Limit Micros"},"monthly_limit_micros":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Monthly Limit Micros"},"provider_ids":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Provider Ids"}},"type":"object","required":["id","label","plaintext_key","created_at"],"title":"ApiKeyWithPlaintext"},"AppDecision":{"properties":{"decision":{"type":"string","enum":["send","dont_send"],"title":"Decision"},"proposal_hash":{"type":"string","maxLength":64,"minLength":64,"title":"Proposal Hash"},"remember":{"type":"boolean","title":"Remember","default":false}},"additionalProperties":false,"type":"object","required":["decision","proposal_hash"],"title":"AppDecision"},"AppUsage":{"properties":{"app":{"type":"string","title":"App"},"name":{"type":"string","title":"Name"},"connected_people":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Connected People"},"actions":{"type":"integer","title":"Actions"},"from_chat":{"type":"integer","title":"From Chat"},"failed":{"type":"integer","title":"Failed"},"median_read_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Median Read Ms"}},"type":"object","required":["app","name","connected_people","actions","from_chat","failed","median_read_ms"],"title":"AppUsage"},"AuthoredReviewItem":{"properties":{"id":{"type":"string","title":"Id"},"direction":{"type":"string","title":"Direction"},"service_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Service Id"},"service_title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Service Title"},"quality_rating":{"type":"integer","title":"Quality Rating"},"value_rating":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Value Rating"},"quality_note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quality Note"},"value_note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Value Note"},"reviewer_model_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reviewer Model Name"},"reviewer_model_provider":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reviewer Model Provider"},"subject_display_name":{"type":"string","title":"Subject Display Name"},"reviewer_type":{"type":"string","enum":["human","agent"],"title":"Reviewer Type"},"task_group_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Task Group Id"},"conversation_ids":{"items":{"type":"string"},"type":"array","title":"Conversation Ids","default":[]},"run_title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Run Title"},"provider_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provider Name"},"rated_hire_count":{"type":"integer","title":"Rated Hire Count","default":1},"editable_until":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Editable Until"},"is_locked":{"type":"boolean","title":"Is Locked","default":true},"revision":{"type":"integer","title":"Revision","default":1},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","direction","quality_rating","subject_display_name","reviewer_type","created_at"],"title":"AuthoredReviewItem","description":"A review the current user has *written*, joined to the service."},"AuthoredReviewsResponse":{"properties":{"reviews":{"items":{"$ref":"#/components/schemas/AuthoredReviewItem"},"type":"array","title":"Reviews"},"next_cursor":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Next Cursor"}},"type":"object","required":["reviews"],"title":"AuthoredReviewsResponse"},"BatchItemsPolicy":{"properties":{"count_scope_key":{"type":"string","maxLength":100,"minLength":1,"title":"Count Scope Key"}},"additionalProperties":false,"type":"object","required":["count_scope_key"],"title":"BatchItemsPolicy","description":"Declares that one order of this offer may carry N line items.\n\n``count_scope_key`` names the integer scope field that must equal the\nnumber of items. That field is already what the offer's unit_schedule\nprices, so a batch needs no pricing machinery of its own: 40 items is\npriced exactly as scope 40 always was."},"Body_fulfill_file_upload_request_v1_files_upload_requests__token__post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"}},"type":"object","required":["file"],"title":"Body_fulfill_file_upload_request_v1_files_upload_requests__token__post"},"Body_fulfill_own_upload_request_v1_files__file_id__fulfill_upload_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"}},"type":"object","required":["file"],"title":"Body_fulfill_own_upload_request_v1_files__file_id__fulfill_upload_post"},"Body_post_chat_attachment_v1_support_chat_attachments_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"},"body":{"type":"string","title":"Body","default":""}},"type":"object","required":["file"],"title":"Body_post_chat_attachment_v1_support_chat_attachments_post"},"Body_put_workspace_entry_v1_jobs__job_id__workspace_entries__logical_path__put":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"}},"type":"object","required":["file"],"title":"Body_put_workspace_entry_v1_jobs__job_id__workspace_entries__logical_path__put"},"Body_repair_snapshot_gc_blob_admin_snapshot_garbage_collection_repairs_blobs_post":{"properties":{"authority_ref":{"type":"string","maxLength":256,"minLength":1,"title":"Authority Ref"},"security_domain_id":{"type":"string","pattern":"^sd1_[0-9a-f]{32}$","title":"Security Domain Id"},"logical_id":{"type":"string","pattern":"^b1-sha256:[0-9a-f]{64}$","title":"Logical Id"},"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"}},"type":"object","required":["authority_ref","security_domain_id","logical_id","file"],"title":"Body_repair_snapshot_gc_blob_admin_snapshot_garbage_collection_repairs_blobs_post"},"Body_upload_agent_bundle_v1_agent_bundles_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"}},"type":"object","required":["file"],"title":"Body_upload_agent_bundle_v1_agent_bundles_post"},"Body_upload_file_v1_files_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"}},"type":"object","required":["file"],"title":"Body_upload_file_v1_files_post"},"Body_upload_job_artifact_v1_jobs__job_id__artifacts_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"}},"type":"object","required":["file"],"title":"Body_upload_job_artifact_v1_jobs__job_id__artifacts_post"},"BrokerActionCallRequest":{"properties":{"grant_id":{"type":"string","minLength":1,"title":"Grant Id"},"action_name":{"type":"string","maxLength":100,"minLength":1,"title":"Action Name"},"arguments":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Arguments"}},"type":"object","required":["grant_id","action_name"],"title":"BrokerActionCallRequest"},"BrokerCallRequest":{"properties":{"grant_id":{"type":"string","minLength":1,"title":"Grant Id"},"tool_name":{"type":"string","minLength":1,"title":"Tool Name"},"arguments":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Arguments"}},"type":"object","required":["grant_id","tool_name"],"title":"BrokerCallRequest"},"BudgetConstraint":{"properties":{"max_amount_micros":{"type":"integer","minimum":0.0,"title":"Max Amount Micros"}},"type":"object","required":["max_amount_micros"],"title":"BudgetConstraint"},"BulkRevokeResponse":{"properties":{"slug":{"type":"string","title":"Slug"},"revoked":{"type":"integer","title":"Revoked"}},"type":"object","required":["slug","revoked"],"title":"BulkRevokeResponse"},"BundleOwner":{"properties":{"name":{"type":"string","maxLength":200,"minLength":1,"title":"Name"},"email":{"anyOf":[{"type":"string","format":"email"},{"type":"null"}],"title":"Email"}},"additionalProperties":false,"type":"object","required":["name"],"title":"BundleOwner","description":"Attribution for the project an agent is built from.\n\nA bundle that wraps a third-party service or repository records who owns\nthat upstream project, so a reviewer can see the provenance without\nre-reading the source. Optional and advisory: the manifest validates and\nround-trips it into the stored bundle, but no runtime behaviour reads it\nyet — persistence and admin display come later."},"Buyer":{"properties":{"user_id":{"type":"string","title":"User Id"},"name":{"type":"string","title":"Name"},"orders":{"type":"integer","title":"Orders"}},"type":"object","required":["user_id","name","orders"],"title":"Buyer"},"BuyerCapFundingPolicy":{"properties":{"kind":{"type":"string","const":"buyer_cap","title":"Kind","default":"buyer_cap"},"minimum_cap_micros":{"type":"integer","maximum":9007199254740991.0,"minimum":0.0,"title":"Minimum Cap Micros"},"maximum_cap_micros":{"type":"integer","maximum":9007199254740991.0,"minimum":0.0,"title":"Maximum Cap Micros"}},"additionalProperties":false,"type":"object","required":["minimum_cap_micros","maximum_cap_micros"],"title":"BuyerCapFundingPolicy"},"CalibrationAcceptance":{"properties":{"policy_version_id":{"type":"string","format":"uuid","title":"Policy Version Id"},"corpus":{"$ref":"#/components/schemas/CalibrationCorpus"},"run":{"$ref":"#/components/schemas/CalibrationRun"},"expires_at":{"type":"string","format":"date-time","title":"Expires At"}},"additionalProperties":false,"type":"object","required":["policy_version_id","corpus","run","expires_at"],"title":"CalibrationAcceptance"},"CalibrationCase":{"properties":{"version":{"type":"integer","const":1,"title":"Version","default":1},"id":{"type":"string","maxLength":64,"minLength":1,"pattern":"^[a-z0-9_]+$","title":"Id"},"family":{"type":"string","enum":["csv_to_json","business_day","tls_certificate"],"title":"Family"},"split":{"type":"string","enum":["development","holdout"],"title":"Split"},"kind":{"type":"string","enum":["good","bad","incomplete","missing_evidence","adversarial"],"title":"Kind"},"request_input":{"additionalProperties":true,"type":"object","title":"Request Input"},"result":{"additionalProperties":true,"type":"object","title":"Result"},"verified_reference":{"anyOf":[{"$ref":"#/components/schemas/VerifiedReference"},{"type":"null"}]},"expected_outcome":{"type":"string","enum":["pass","fail","unknown"],"title":"Expected Outcome"}},"additionalProperties":false,"type":"object","required":["id","family","split","kind","request_input","result","expected_outcome"],"title":"CalibrationCase","description":"Independently labeled source/response/reference calibration example."},"CalibrationCorpus":{"properties":{"version":{"type":"string","const":"service-quality-calibration-v2","title":"Version","default":"service-quality-calibration-v2"},"label_source":{"type":"string","const":"independent_fixture_review","title":"Label Source","default":"independent_fixture_review"},"reference_basis":{"type":"string","const":"controlled_synthetic_contract_fixtures","title":"Reference Basis","default":"controlled_synthetic_contract_fixtures"},"fingerprint":{"type":"string","pattern":"^[0-9a-f]{64}$","title":"Fingerprint"},"cases":{"items":{"$ref":"#/components/schemas/CalibrationCase"},"type":"array","maxItems":100,"minItems":1,"title":"Cases"}},"additionalProperties":false,"type":"object","required":["fingerprint","cases"],"title":"CalibrationCorpus"},"CalibrationPrediction":{"properties":{"case_id":{"type":"string","maxLength":64,"minLength":1,"pattern":"^[a-z0-9_]+$","title":"Case Id"},"corpus_fingerprint":{"type":"string","pattern":"^[0-9a-f]{64}$","title":"Corpus Fingerprint"},"task_fingerprint":{"type":"string","pattern":"^[0-9a-f]{64}$","title":"Task Fingerprint"},"evaluation_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Evaluation Id","description":"Delivered marketplace evaluator Job receipt UUID."},"findings":{"$ref":"#/components/schemas/RawJevFindings"}},"additionalProperties":false,"type":"object","required":["case_id","corpus_fingerprint","task_fingerprint","findings"],"title":"CalibrationPrediction"},"CalibrationPreflightAbstention":{"properties":{"case_id":{"type":"string","maxLength":64,"minLength":1,"pattern":"^[a-z0-9_]+$","title":"Case Id"},"corpus_fingerprint":{"type":"string","pattern":"^[0-9a-f]{64}$","title":"Corpus Fingerprint"},"task_fingerprint":{"type":"string","pattern":"^[0-9a-f]{64}$","title":"Task Fingerprint"},"unavailable_reason":{"type":"string","maxLength":64,"minLength":1,"title":"Unavailable Reason"},"evidence_profile":{"type":"string","enum":["csv_to_json","business_day","tls_certificate"],"title":"Evidence Profile"},"profile_version":{"type":"string","const":"continuous-quality-profiles-v2","title":"Profile Version","default":"continuous-quality-profiles-v2"},"receipt_kind":{"type":"string","const":"local_evidence_preflight_v1","title":"Receipt Kind","default":"local_evidence_preflight_v1"},"local_extractor_receipt":{"type":"string","pattern":"^[0-9a-f]{64}$","title":"Local Extractor Receipt"},"evaluated_at":{"type":"string","format":"date-time","title":"Evaluated At"}},"additionalProperties":false,"type":"object","required":["case_id","corpus_fingerprint","task_fingerprint","unavailable_reason","evidence_profile","local_extractor_receipt","evaluated_at"],"title":"CalibrationPreflightAbstention","description":"A local evidence-extractor abstention, never represented as a JEV result."},"CalibrationRevocation":{"properties":{"approval_event_id":{"type":"string","format":"uuid","title":"Approval Event Id"},"reason":{"type":"string","maxLength":200,"minLength":1,"title":"Reason"}},"additionalProperties":false,"type":"object","required":["approval_event_id","reason"],"title":"CalibrationRevocation"},"CalibrationRun":{"properties":{"schema_version":{"type":"integer","const":1,"title":"Schema Version","default":1},"corpus_version":{"type":"string","const":"service-quality-calibration-v2","title":"Corpus Version"},"corpus_fingerprint":{"type":"string","pattern":"^[0-9a-f]{64}$","title":"Corpus Fingerprint"},"profile_version":{"type":"string","const":"continuous-quality-profiles-v2","title":"Profile Version"},"rating_contract_version":{"type":"string","const":"service-quality-assessment-v1","title":"Rating Contract Version"},"evaluator_model":{"type":"string","const":"jev-1.13.0","title":"Evaluator Model"},"review_policy_version":{"type":"string","const":"jev-review-v1","title":"Review Policy Version"},"origin":{"type":"string","enum":["actual_jev","synthetic_test"],"title":"Origin"},"evaluated_at":{"type":"string","format":"date-time","title":"Evaluated At"},"predictions":{"items":{"$ref":"#/components/schemas/CalibrationPrediction"},"type":"array","maxItems":100,"title":"Predictions"},"preflight_abstentions":{"items":{"$ref":"#/components/schemas/CalibrationPreflightAbstention"},"type":"array","maxItems":100,"title":"Preflight Abstentions","default":[]}},"additionalProperties":false,"type":"object","required":["corpus_version","corpus_fingerprint","profile_version","rating_contract_version","evaluator_model","review_policy_version","origin","evaluated_at","predictions"],"title":"CalibrationRun"},"CapacityAcceptance":{"properties":{"proof":{"$ref":"#/components/schemas/CapacityProof"},"load_evidence_hash64":{"type":"string","pattern":"^[0-9a-f]{64}$","title":"Load Evidence Hash64"},"provider_quota_isolation_reviewed":{"type":"boolean","const":true,"title":"Provider Quota Isolation Reviewed"},"customer_load_acceptance_reviewed":{"type":"boolean","const":true,"title":"Customer Load Acceptance Reviewed"}},"additionalProperties":false,"type":"object","required":["proof","load_evidence_hash64","provider_quota_isolation_reviewed","customer_load_acceptance_reviewed"],"title":"CapacityAcceptance"},"CapacityProof":{"properties":{"provider_account_ref":{"type":"string","maxLength":160,"minLength":1,"title":"Provider Account Ref"},"quota_scope_ref":{"type":"string","maxLength":160,"minLength":1,"title":"Quota Scope Ref"},"public_provider_account_ref":{"type":"string","maxLength":160,"minLength":1,"title":"Public Provider Account Ref"},"public_quota_scope_ref":{"type":"string","maxLength":160,"minLength":1,"title":"Public Quota Scope Ref"},"source_key_id":{"type":"string","format":"uuid","title":"Source Key Id"},"evidence_hash64":{"type":"string","pattern":"^[0-9a-f]{64}$","title":"Evidence Hash64"},"expires_at":{"type":"string","format":"date-time","title":"Expires At"},"approved_by":{"type":"string","format":"uuid","title":"Approved By"}},"additionalProperties":false,"type":"object","required":["provider_account_ref","quota_scope_ref","public_provider_account_ref","public_quota_scope_ref","source_key_id","evidence_hash64","expires_at","approved_by"],"title":"CapacityProof","description":"Fresh operator attestation for vendor capacity outside Delegate.\n\n``source_key_id`` binds the statement to the registry credential. Account\nand quota references are opaque provider-side identifiers, never secrets.\nDelegate can compare the declared public and internal scopes but cannot\nindependently verify TypeSafe quota allocation because TypeSafe exposes no\ndocumented account-usage API."},"ChangePasswordRequest":{"properties":{"current_password":{"type":"string","title":"Current Password"},"new_password":{"type":"string","title":"New Password"}},"type":"object","required":["current_password","new_password"],"title":"ChangePasswordRequest"},"ChatDay":{"properties":{"date":{"type":"string","title":"Date"},"finished_well":{"type":"integer","title":"Finished Well"},"not_well":{"type":"integer","title":"Not Well"},"outcomes":{"$ref":"#/components/schemas/Outcomes"}},"type":"object","required":["date","finished_well","not_well","outcomes"],"title":"ChatDay"},"ChatToolboxUsage":{"properties":{"days":{"type":"integer","title":"Days"},"include_staff":{"type":"boolean","title":"Include Staff"},"since":{"type":"string","format":"date-time","title":"Since"},"until":{"type":"string","format":"date-time","title":"Until"},"chat":{"$ref":"#/components/schemas/ChatUsage"},"toolbox":{"$ref":"#/components/schemas/ToolboxUsage"}},"type":"object","required":["days","include_staff","since","until","chat","toolbox"],"title":"ChatToolboxUsage"},"ChatUsage":{"properties":{"people":{"$ref":"#/components/schemas/Pair"},"people_new":{"type":"integer","title":"People New"},"people_back":{"type":"integer","title":"People Back"},"runs":{"$ref":"#/components/schemas/Pair"},"requests":{"$ref":"#/components/schemas/Pair"},"finished_well":{"$ref":"#/components/schemas/Pair"},"ended":{"$ref":"#/components/schemas/Pair"},"scheduled_runs":{"type":"integer","title":"Scheduled Runs"},"goal_checks":{"type":"integer","title":"Goal Checks"},"outcomes":{"$ref":"#/components/schemas/Outcomes"},"ai_cost_micros":{"$ref":"#/components/schemas/Pair"},"purchases":{"$ref":"#/components/schemas/Purchases"},"files_made":{"type":"integer","title":"Files Made"},"by_day":{"items":{"$ref":"#/components/schemas/ChatDay"},"type":"array","title":"By Day"},"reasons":{"items":{"$ref":"#/components/schemas/Reason"},"type":"array","title":"Reasons"},"funnel":{"$ref":"#/components/schemas/Funnel"},"models":{"items":{"$ref":"#/components/schemas/ModelUsage"},"type":"array","title":"Models"},"users":{"items":{"$ref":"#/components/schemas/Person"},"type":"array","title":"Users"},"providers":{"items":{"$ref":"#/components/schemas/ProviderUsage"},"type":"array","title":"Providers"}},"type":"object","required":["people","people_new","people_back","runs","requests","finished_well","ended","scheduled_runs","goal_checks","outcomes","ai_cost_micros","purchases","files_made","by_day","reasons","funnel","models","users","providers"],"title":"ChatUsage"},"ChoiceQuestion":{"properties":{"kind":{"type":"string","const":"choice","title":"Kind"},"id":{"type":"string","maxLength":32,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","title":"Id"},"instructions":{"type":"string","maxLength":1024,"minLength":1,"title":"Instructions"},"options":{"items":{"type":"string"},"type":"array","maxItems":10,"minItems":2,"title":"Options"},"descriptions":{"items":{"type":"string"},"type":"array","maxItems":10,"minItems":2,"title":"Descriptions"}},"additionalProperties":false,"type":"object","required":["kind","id","instructions","options","descriptions"],"title":"ChoiceQuestion"},"CommercialScopeSchema":{"properties":{"type":{"type":"string","const":"object","title":"Type","default":"object"},"properties":{"additionalProperties":{"oneOf":[{"$ref":"#/components/schemas/IntegerScopeField"},{"$ref":"#/components/schemas/StringScopeField"}],"discriminator":{"propertyName":"type","mapping":{"integer":"#/components/schemas/IntegerScopeField","string":"#/components/schemas/StringScopeField"}}},"type":"object","maxProperties":25,"title":"Properties"},"required":{"items":{"type":"string"},"type":"array","maxItems":25,"title":"Required"},"additional_properties":{"type":"boolean","const":false,"title":"Additional Properties","default":false}},"additionalProperties":false,"type":"object","title":"CommercialScopeSchema"},"ConnectedAppResponse":{"properties":{"client_id":{"type":"string","title":"Client Id"},"client_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Client Name"},"scope":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Scope"},"access_mode":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Access Mode"},"per_order_limit_micros":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Per Order Limit Micros"},"monthly_limit_micros":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Monthly Limit Micros"},"requires_reauthorization":{"type":"boolean","title":"Requires Reauthorization","default":false},"authorized_at":{"type":"string","format":"date-time","title":"Authorized At"},"last_active_at":{"type":"string","format":"date-time","title":"Last Active At"}},"type":"object","required":["client_id","authorized_at","last_active_at"],"title":"ConnectedAppResponse","description":"One OAuth client (e.g. Claude Desktop) the user has an active grant for,\nas shown on the Connected apps dashboard.\n\nAggregated from the user's live ``oauth_refresh_tokens`` rows for that\nclient, so it appears only while the grant can still mint access tokens."},"ConnectionCreate":{"properties":{"endpoint_url":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}],"title":"Endpoint Url"},"provider_slug":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"Provider Slug"},"credential":{"anyOf":[{"type":"string","maxLength":4000},{"type":"null"}],"title":"Credential"},"label":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Label"},"auth_type":{"type":"string","title":"Auth Type","default":"api_key"},"scopes":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Scopes"},"key_custody":{"type":"string","title":"Key Custody","default":"server"},"passphrase":{"anyOf":[{"type":"string","maxLength":1024},{"type":"null"}],"title":"Passphrase"}},"type":"object","title":"ConnectionCreate"},"ConnectionResponse":{"properties":{"id":{"type":"string","title":"Id"},"label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Label"},"endpoint_url":{"type":"string","title":"Endpoint Url"},"connection_kind":{"type":"string","title":"Connection Kind","default":"mcp"},"provider_slug":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provider Slug"},"external_account_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"External Account Id"},"capabilities":{"items":{"type":"string"},"type":"array","title":"Capabilities","default":[]},"connection_metadata":{"additionalProperties":true,"type":"object","title":"Connection Metadata","default":{}},"auth_type":{"type":"string","title":"Auth Type"},"key_custody":{"type":"string","title":"Key Custody","default":"server"},"unlocked":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Unlocked"},"unlock_expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Unlock Expires At"},"scopes":{"items":{"type":"string"},"type":"array","title":"Scopes","default":[]},"status":{"type":"string","title":"Status"},"credential_configured":{"type":"boolean","title":"Credential Configured"},"oauth":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Oauth"},"recovery_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Recovery Code"},"created_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Created At"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["id","endpoint_url","auth_type","status","credential_configured"],"title":"ConnectionResponse"},"ConnectionTestResponse":{"properties":{"ok":{"type":"boolean","title":"Ok"},"tools":{"items":{},"type":"array","title":"Tools","default":[]},"capabilities":{"items":{"type":"string"},"type":"array","title":"Capabilities","default":[]},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"}},"type":"object","required":["ok"],"title":"ConnectionTestResponse"},"ConnectorConnectionCreate":{"properties":{"credential":{"type":"string","maxLength":4000,"minLength":1,"title":"Credential"},"label":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Label"},"key_custody":{"type":"string","title":"Key Custody","default":"server"},"passphrase":{"anyOf":[{"type":"string","maxLength":1024},{"type":"null"}],"title":"Passphrase"},"options":{"additionalProperties":true,"type":"object","title":"Options","default":{}}},"type":"object","required":["credential"],"title":"ConnectorConnectionCreate","description":"Create a typed, non-MCP connected account with a reviewed driver."},"ConstantPriceRule":{"properties":{"kind":{"type":"string","const":"constant","title":"Kind","default":"constant"},"name":{"type":"string","maxLength":100,"minLength":1,"title":"Name"},"amount_micros":{"type":"integer","maximum":9007199254740991.0,"minimum":0.0,"title":"Amount Micros"}},"additionalProperties":false,"type":"object","required":["name","amount_micros"],"title":"ConstantPriceRule"},"ConsumptionCapacity":{"properties":{"purchase_scope_key":{"type":"string","maxLength":100,"minLength":1,"title":"Purchase Scope Key"},"commercial_unit":{"type":"string","maxLength":100,"minLength":1,"title":"Commercial Unit"},"atomic_unit":{"type":"string","maxLength":100,"minLength":1,"title":"Atomic Unit"},"atomic_units_per_commercial_unit":{"type":"integer","maximum":1000000000.0,"minimum":1.0,"title":"Atomic Units Per Commercial Unit"}},"additionalProperties":false,"type":"object","required":["purchase_scope_key","commercial_unit","atomic_unit","atomic_units_per_commercial_unit"],"title":"ConsumptionCapacity"},"ConsumptionProportionalSettlementPolicy":{"properties":{"kind":{"type":"string","const":"consumption_proportional","title":"Kind","default":"consumption_proportional"},"expiry_provider_share_bps":{"type":"integer","maximum":10000.0,"minimum":0.0,"title":"Expiry Provider Share Bps","default":0},"settle_each_commit":{"type":"boolean","title":"Settle Each Commit","default":true}},"additionalProperties":false,"type":"object","title":"ConsumptionProportionalSettlementPolicy"},"ConsumptionRuntimePolicy":{"properties":{"execution_mode":{"type":"string","enum":["gateway","job"],"title":"Execution Mode"},"usage_adapter_key":{"type":"string","maxLength":100,"minLength":1,"title":"Usage Adapter Key"},"reservation_strategy":{"type":"string","enum":["fixed","adapter_max"],"title":"Reservation Strategy"},"commit_strategy":{"type":"string","enum":["fixed","adapter_measured_ceil"],"title":"Commit Strategy"},"fixed_atomic_units":{"anyOf":[{"type":"integer","maximum":1000000000.0,"minimum":1.0},{"type":"null"}],"title":"Fixed Atomic Units"},"maximum_atomic_units_per_request":{"type":"integer","maximum":1000000000.0,"minimum":1.0,"title":"Maximum Atomic Units Per Request"}},"additionalProperties":false,"type":"object","required":["execution_mode","usage_adapter_key","reservation_strategy","commit_strategy","maximum_atomic_units_per_request"],"title":"ConsumptionRuntimePolicy"},"ConsumptionSettlementRunResponse":{"properties":{"entitlements_settled":{"type":"integer","title":"Entitlements Settled"},"total_units":{"type":"integer","title":"Total Units"},"total_gross_micros":{"type":"integer","title":"Total Gross Micros"},"total_provider_net_micros":{"type":"integer","title":"Total Provider Net Micros"},"total_platform_fee_micros":{"type":"integer","title":"Total Platform Fee Micros"},"providers":{"items":{"$ref":"#/components/schemas/ProviderSettlementStatement"},"type":"array","title":"Providers"}},"type":"object","required":["entitlements_settled","total_units","total_gross_micros","total_provider_net_micros","total_platform_fee_micros","providers"],"title":"ConsumptionSettlementRunResponse"},"ContinuousDiscoveryConfig":{"properties":{"service_ids":{"items":{"type":"string","format":"uuid"},"type":"array","maxItems":1000,"minItems":1,"title":"Service Ids"},"batch_size":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"Batch Size","default":25},"lookback_seconds":{"type":"integer","maximum":86400.0,"minimum":1.0,"title":"Lookback Seconds","default":86400},"poll_interval_seconds":{"type":"integer","maximum":3600.0,"minimum":30.0,"title":"Poll Interval Seconds","default":30}},"additionalProperties":false,"type":"object","required":["service_ids"],"title":"ContinuousDiscoveryConfig","description":"Strict global bounds for one discovery cycle."},"ContinuousEvidenceProfile":{"properties":{"version":{"type":"integer","const":1,"title":"Version","default":1},"definitions":{"$ref":"#/components/schemas/ServiceQualityDefinitions"},"evidence_profile":{"type":"string","const":"inline_fields_v1","title":"Evidence Profile","default":"inline_fields_v1"},"requester_scope":{"type":"string","enum":["internal","approved_customers"],"title":"Requester Scope","default":"internal"},"decode_output_paths":{"items":{"type":"string"},"type":"array","maxItems":4,"title":"Decode Output Paths","default":[]},"reference_adapter":{"type":"string","enum":["source_fidelity_v1","verified_fixture_v1"],"title":"Reference Adapter"},"reference_kind":{"type":"string","enum":["independent_factual_observation","controlled_synthetic_fixture"],"title":"Reference Kind","default":"independent_factual_observation"},"reference_input_hash":{"anyOf":[{"type":"string","pattern":"^[0-9a-f]{64}$"},{"type":"null"}],"title":"Reference Input Hash"},"reference":{"anyOf":[{"type":"string","maxLength":2048},{"type":"null"}],"title":"Reference"},"reference_expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Reference Expires At"},"retention_hours":{"type":"integer","maximum":168.0,"minimum":1.0,"title":"Retention Hours","default":24},"approval_id":{"type":"string","format":"uuid","title":"Approval Id"},"approved_at":{"type":"string","format":"date-time","title":"Approved At"}},"additionalProperties":false,"type":"object","required":["definitions","reference_adapter","approval_id","approved_at"],"title":"ContinuousEvidenceProfile"},"ContinuousReconciliationState":{"properties":{"version":{"type":"integer","const":1,"title":"Version","default":1},"cycle_boundary_created_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Cycle Boundary Created At"},"cycle_boundary_job_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Cycle Boundary Job Id"},"cursor_created_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Cursor Created At"},"cursor_job_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Cursor Job Id"}},"additionalProperties":false,"type":"object","title":"ContinuousReconciliationState","description":"Persisted bounded cursor for cyclic scans behind the main watermark."},"ContinuousRuntimeConfig":{"properties":{"discovery":{"$ref":"#/components/schemas/ContinuousDiscoveryConfig"},"reconciliation":{"anyOf":[{"$ref":"#/components/schemas/ContinuousReconciliationState"},{"type":"null"}]},"scheduling":{"$ref":"#/components/schemas/ContinuousSchedulingState"},"admission_enabled":{"type":"boolean","title":"Admission Enabled","default":false},"buyer_user_id":{"type":"string","format":"uuid","title":"Buyer User Id"},"evaluator_service_id":{"type":"string","format":"uuid","title":"Evaluator Service Id"},"evaluator_offer_version_id":{"type":"string","format":"uuid","title":"Evaluator Offer Version Id"},"capacity_proof":{"anyOf":[{"$ref":"#/components/schemas/CapacityProof"},{"type":"null"}]},"capacity_approval_event_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Capacity Approval Event Id"},"global_daily_budget_micros":{"type":"integer","maximum":1000000000.0,"minimum":1.0,"title":"Global Daily Budget Micros"},"per_service_daily_budgets":{"items":{"$ref":"#/components/schemas/ContinuousServiceBudget"},"type":"array","maxItems":1000,"minItems":1,"title":"Per Service Daily Budgets"},"per_order_cap_micros":{"type":"integer","maximum":1000000000.0,"minimum":1.0,"title":"Per Order Cap Micros"},"max_inflight":{"type":"integer","maximum":4.0,"minimum":1.0,"title":"Max Inflight","default":1},"poll_interval_seconds":{"type":"integer","maximum":3600.0,"minimum":30.0,"title":"Poll Interval Seconds","default":30},"claim_batch_size":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"Claim Batch Size","default":10},"retry_seconds":{"type":"integer","maximum":3600.0,"minimum":30.0,"title":"Retry Seconds","default":30},"claim_lease_seconds":{"type":"integer","maximum":600.0,"minimum":30.0,"title":"Claim Lease Seconds","default":120}},"additionalProperties":false,"type":"object","required":["discovery","buyer_user_id","evaluator_service_id","evaluator_offer_version_id","global_daily_budget_micros","per_service_daily_budgets","per_order_cap_micros"],"title":"ContinuousRuntimeConfig","description":"Strict, immutable financial and scheduling configuration."},"ContinuousSchedulingState":{"properties":{"version":{"type":"integer","const":1,"title":"Version","default":1},"last_attempt_at":{"additionalProperties":{"type":"string","format":"date-time"},"propertyNames":{"format":"uuid"},"type":"object","title":"Last Attempt At"}},"additionalProperties":false,"type":"object","title":"ContinuousSchedulingState","description":"Bounded service fairness state maintained only by admission."},"ContinuousServiceBudget":{"properties":{"service_id":{"type":"string","format":"uuid","title":"Service Id"},"daily_budget_micros":{"type":"integer","maximum":1000000000.0,"minimum":1.0,"title":"Daily Budget Micros"}},"additionalProperties":false,"type":"object","required":["service_id","daily_budget_micros"],"title":"ContinuousServiceBudget"},"ContractRefundPolicyResponse":{"properties":{"conversation_id":{"type":"string","title":"Conversation Id"},"service_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Service Id"},"document":{"$ref":"#/components/schemas/TextDocumentMetadata"},"markdown":{"type":"string","title":"Markdown"}},"type":"object","required":["conversation_id","document","markdown"],"title":"ContractRefundPolicyResponse"},"ContractSnapshot":{"properties":{"schema_version":{"type":"integer","const":2,"title":"Schema Version","default":2},"contract_id":{"type":"string","maxLength":200,"minLength":1,"title":"Contract Id"},"order_id":{"type":"string","maxLength":200,"minLength":1,"title":"Order Id"},"buyer_id":{"type":"string","maxLength":200,"minLength":1,"title":"Buyer Id"},"provider_id":{"type":"string","maxLength":200,"minLength":1,"title":"Provider Id"},"service_id":{"type":"string","maxLength":200,"minLength":1,"title":"Service Id"},"offer_version_id":{"type":"string","maxLength":200,"minLength":1,"title":"Offer Version Id"},"offer_definition_hash":{"type":"string","pattern":"^[0-9a-f]{64}$","title":"Offer Definition Hash"},"offer_definition":{"$ref":"#/components/schemas/OfferDefinition"},"canonical_scope":{"additionalProperties":{"anyOf":[{"type":"integer"},{"type":"string"}]},"type":"object","title":"Canonical Scope"},"execution_context":{"$ref":"#/components/schemas/OrderExecutionContext"},"trusted_measurements":{"additionalProperties":{"anyOf":[{"type":"integer"},{"type":"string"}]},"type":"object","title":"Trusted Measurements"},"measurement_evidence":{"additionalProperties":{"$ref":"#/components/schemas/TrustedMeasurementEvidence"},"type":"object","title":"Measurement Evidence"},"task_binding_hash":{"anyOf":[{"type":"string","pattern":"^[0-9a-f]{64}$"},{"type":"null"}],"title":"Task Binding Hash"},"artifact_binding_hashes":{"additionalProperties":{"type":"string"},"type":"object","maxProperties":100,"title":"Artifact Binding Hashes"},"measurement_hash":{"anyOf":[{"type":"string","pattern":"^[0-9a-f]{64}$"},{"type":"null"}],"title":"Measurement Hash"},"pricing_resolution":{"$ref":"#/components/schemas/PriceResolution"},"funding_amount_micros":{"type":"integer","maximum":9007199254740991.0,"minimum":0.0,"title":"Funding Amount Micros"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"report_due_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Report Due At"},"contract_hash":{"anyOf":[{"type":"string","pattern":"^[0-9a-f]{64}$"},{"type":"null"}],"title":"Contract Hash"}},"additionalProperties":false,"type":"object","required":["contract_id","order_id","buyer_id","provider_id","service_id","offer_version_id","offer_definition_hash","offer_definition","canonical_scope","pricing_resolution","funding_amount_micros","created_at"],"title":"ContractSnapshot"},"ControlUpdate":{"properties":{"enabled":{"type":"boolean","title":"Enabled"},"config":{"anyOf":[{"$ref":"#/components/schemas/ContinuousRuntimeConfig"},{"type":"null"}]}},"additionalProperties":false,"type":"object","required":["enabled"],"title":"ControlUpdate"},"ConversationCompleteRequest":{"properties":{"rating":{"anyOf":[{"type":"integer","maximum":5.0,"minimum":1.0},{"type":"null"}],"title":"Rating"},"quality_rating":{"anyOf":[{"type":"integer","maximum":5.0,"minimum":1.0},{"type":"null"}],"title":"Quality Rating"},"value_rating":{"anyOf":[{"type":"integer","maximum":5.0,"minimum":1.0},{"type":"null"}],"title":"Value Rating"},"quality_note":{"anyOf":[{"type":"string","maxLength":280},{"type":"null"}],"title":"Quality Note"},"value_note":{"anyOf":[{"type":"string","maxLength":280},{"type":"null"}],"title":"Value Note"}},"type":"object","title":"ConversationCompleteRequest","description":"Body for accepting a delivery.\n\nAll rating fields are optional. The single-axis ``rating`` (1-5) is\ntreated as the quality axis. The dual-axis surface uses\n``quality_rating`` and ``value_rating``; both must be supplied\ntogether when the dual-axis path is used, so the per-conversation\nrollup stays consistent. The server stores the buyer's optional\nrating(s), folds them into the per-service rollups, and writes a\nhirer->worker review row when ``quality_rating`` is supplied."},"ConversationReviewRequest":{"properties":{"quality_rating":{"type":"integer","maximum":5.0,"minimum":1.0,"title":"Quality Rating"},"value_rating":{"type":"integer","maximum":5.0,"minimum":1.0,"title":"Value Rating"},"quality_note":{"anyOf":[{"type":"string","maxLength":280},{"type":"null"}],"title":"Quality Note"},"value_note":{"anyOf":[{"type":"string","maxLength":280},{"type":"null"}],"title":"Value Note"},"reviewer_model_name":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Reviewer Model Name"},"reviewer_model_provider":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Reviewer Model Provider"},"accept":{"type":"boolean","title":"Accept","default":true}},"type":"object","required":["quality_rating","value_rating"],"title":"ConversationReviewRequest","description":"Accepted request shape for the retired conversation review endpoint (410)."},"ConversationReviewsResponse":{"properties":{"conversation_id":{"type":"string","title":"Conversation Id"},"reviews":{"items":{"$ref":"#/components/schemas/ReviewSummary"},"type":"array","title":"Reviews"}},"type":"object","required":["conversation_id","reviews"],"title":"ConversationReviewsResponse","description":"The single review row on a conversation, plus the conversation id."},"CustomProbeConfig":{"properties":{"kind":{"type":"string","const":"http","title":"Kind","default":"http"},"url":{"type":"string","maxLength":500,"minLength":12,"title":"Url"},"headers":{"additionalProperties":{"type":"string"},"type":"object","title":"Headers","default":{}},"params":{"additionalProperties":{"type":"string"},"type":"object","title":"Params","default":{}},"paths":{"$ref":"#/components/schemas/CustomProbePaths","default":{}},"unit":{"anyOf":[{"type":"string","maxLength":32},{"type":"null"}],"title":"Unit"}},"type":"object","required":["url"],"title":"CustomProbeConfig","description":"User-supplied HTTP usage probe for a provider without a built-in one.\n\n``{{key}}`` in url, headers or params is replaced with the key's value at\nprobe time — the config itself never contains the value."},"CustomProbePaths":{"properties":{"used":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Used"},"limit":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Limit"},"remaining":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Remaining"}},"type":"object","title":"CustomProbePaths","description":"Dot-paths into the probe response's JSON (e.g. ``data.requests.used``)."},"CustomerCategory":{"properties":{"key":{"type":"string","title":"Key"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"label":{"type":"string","title":"Label"},"description":{"type":"string","title":"Description"},"video_title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Video Title"},"video_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Video Url"},"has_video":{"type":"boolean","title":"Has Video","default":true},"mock":{"type":"boolean","title":"Mock","default":false}},"type":"object","required":["key","label","description"],"title":"CustomerCategory"},"CustomerCategoryGroup":{"properties":{"key":{"type":"string","enum":["use_case","persona"],"title":"Key"},"label":{"type":"string","title":"Label"},"categories":{"items":{"$ref":"#/components/schemas/CustomerCategory"},"type":"array","title":"Categories"}},"type":"object","required":["key","label","categories"],"title":"CustomerCategoryGroup"},"DailyMetricsResponse":{"properties":{"snapshots":{"items":{"$ref":"#/components/schemas/DailySnapshot"},"type":"array","title":"Snapshots"},"stale":{"type":"boolean","title":"Stale","default":false},"unavailable":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Unavailable"},"notes":{"items":{"type":"string"},"type":"array","title":"Notes"},"image_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Image Date"}},"type":"object","title":"DailyMetricsResponse"},"DailySnapshot":{"properties":{"date_utc":{"type":"string","format":"date","title":"Date Utc"},"captured_at_utc":{"type":"string","format":"date-time","title":"Captured At Utc"},"active_users_7d":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Active Users 7D"},"revenue_users_24h":{"type":"integer","minimum":0.0,"title":"Revenue Users 24H"},"gross_usd":{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","title":"Gross Usd"},"refunds_usd":{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","title":"Refunds Usd"},"net_usd":{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","title":"Net Usd"},"active_stable_services":{"type":"integer","minimum":0.0,"title":"Active Stable Services"},"active_user_method":{"type":"string","title":"Active User Method"}},"type":"object","required":["date_utc","captured_at_utc","revenue_users_24h","gross_usd","refunds_usd","net_usd","active_stable_services","active_user_method"],"title":"DailySnapshot"},"DailySpendDay":{"properties":{"date":{"type":"string","title":"Date"},"net_micros":{"type":"integer","title":"Net Micros"}},"type":"object","required":["date","net_micros"],"title":"DailySpendDay"},"DailySpendResponse":{"properties":{"month":{"type":"string","title":"Month"},"total_micros":{"type":"integer","title":"Total Micros"},"days":{"items":{"$ref":"#/components/schemas/DailySpendDay"},"type":"array","title":"Days"}},"type":"object","required":["month","total_micros","days"],"title":"DailySpendResponse","description":"The caller's settled net spend per UTC day for one calendar month.\n\nSame definition as ``MonthlySpendResponse.settled_micros`` (committed\ncharges minus refunds), so ``total_micros`` equals it for the current\nmonth. In-flight holds are not spend yet and are left out. ``days`` lists\nonly days with a charge or refund, oldest first."},"DecisionReview":{"properties":{"id":{"type":"string","maxLength":32,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","title":"Id"},"status":{"type":"string","enum":["ready","needs_review"],"title":"Status"},"reason":{"type":"string","enum":["threshold_met","low_confidence","ambiguous_choice","uncertain_probability","review_option"],"title":"Reason"},"yes_no_decision":{"type":"string","enum":["yes","no","uncertain","not_applicable"],"title":"Yes No Decision"}},"additionalProperties":false,"type":"object","required":["id","status","reason","yes_no_decision"],"title":"DecisionReview","description":"Deterministic review annotation returned by JEV evaluate-v2."},"DependencyLatestError":{"properties":{"error_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Type"},"error_message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Message"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"}},"type":"object","title":"DependencyLatestError","description":"The newest failed/degraded operational event for the dependency."},"DependencyOverviewResponse":{"properties":{"agents":{"items":{"$ref":"#/components/schemas/AgentDependencyOverviewRow"},"type":"array","title":"Agents"},"truncated":{"type":"boolean","title":"Truncated","default":false}},"type":"object","title":"DependencyOverviewResponse"},"DependencyReputation":{"properties":{"quality_average_rating":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Quality Average Rating"},"value_average_rating":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Value Average Rating"},"completion_rate":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Completion Rate"},"dispute_rate":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Dispute Rate"},"completed_jobs":{"type":"integer","title":"Completed Jobs","default":0}},"type":"object","title":"DependencyReputation","description":"The downstream service's own reputation (x100 ints as stored)."},"DependencyTimePoint":{"properties":{"date":{"type":"string","title":"Date"},"cost_micros":{"type":"integer","title":"Cost Micros"},"usage_count":{"type":"integer","title":"Usage Count"}},"type":"object","required":["date","cost_micros","usage_count"],"title":"DependencyTimePoint"},"DimensionDefinition":{"properties":{"dimension":{"type":"string","enum":["correctness_fidelity","task_fulfilment","usability"],"title":"Dimension"},"definition":{"type":"string","maxLength":800,"minLength":1,"title":"Definition"}},"additionalProperties":false,"type":"object","required":["dimension","definition"],"title":"DimensionDefinition","description":"One service-specific interpretation, stored separately from the rubric."},"DisputeCreate":{"properties":{"reason":{"type":"string","title":"Reason"}},"type":"object","required":["reason"],"title":"DisputeCreate"},"DisputeResolveRequest":{"properties":{"outcome":{"type":"string","enum":["release_to_provider","refund_to_buyer","split"],"title":"Outcome"},"provider_micros":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Provider Micros"},"buyer_refund_micros":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Buyer Refund Micros"},"note":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Note"}},"type":"object","required":["outcome"],"title":"DisputeResolveRequest"},"EmailVerificationRequest":{"properties":{"token":{"type":"string","minLength":1,"title":"Token"}},"type":"object","required":["token"],"title":"EmailVerificationRequest"},"EmailVerificationResendRequest":{"properties":{"email":{"type":"string","format":"email","title":"Email"}},"type":"object","required":["email"],"title":"EmailVerificationResendRequest"},"EntitlementFulfillmentPolicy":{"properties":{"kind":{"type":"string","const":"entitlement","title":"Kind","default":"entitlement"},"capacity":{"$ref":"#/components/schemas/ConsumptionCapacity"},"runtime":{"$ref":"#/components/schemas/ConsumptionRuntimePolicy"},"validity_seconds":{"type":"integer","maximum":31622400.0,"minimum":1.0,"title":"Validity Seconds"},"rate_limit_per_minute":{"anyOf":[{"type":"integer","maximum":1000000.0,"minimum":1.0},{"type":"null"}],"title":"Rate Limit Per Minute"},"rate_limit_per_day":{"anyOf":[{"type":"integer","maximum":100000000.0,"minimum":1.0},{"type":"null"}],"title":"Rate Limit Per Day"}},"additionalProperties":false,"type":"object","required":["capacity","runtime","validity_seconds"],"title":"EntitlementFulfillmentPolicy"},"EntitlementListResponse":{"properties":{"entitlements":{"items":{"$ref":"#/components/schemas/EntitlementResponse"},"type":"array","title":"Entitlements"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["entitlements","total"],"title":"EntitlementListResponse"},"EntitlementOrderResult":{"properties":{"kind":{"type":"string","const":"entitlement","title":"Kind","default":"entitlement"},"order_id":{"type":"string","title":"Order Id"},"contract_id":{"type":"string","title":"Contract Id"},"entitlement_id":{"type":"string","title":"Entitlement Id"},"entitlement_token":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Entitlement Token"},"token_recoverable":{"type":"boolean","const":false,"title":"Token Recoverable","default":false}},"additionalProperties":false,"type":"object","required":["order_id","contract_id","entitlement_id"],"title":"EntitlementOrderResult"},"EntitlementResponse":{"properties":{"id":{"type":"string","title":"Id"},"service_id":{"type":"string","title":"Service Id"},"service_title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Service Title"},"conversation_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Conversation Id"},"contract_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Contract Id"},"execution_mode":{"type":"string","enum":["gateway","job"],"title":"Execution Mode"},"status":{"type":"string","title":"Status"},"unit":{"type":"string","title":"Unit"},"purchased_units":{"type":"integer","title":"Purchased Units"},"consumed_units":{"type":"integer","title":"Consumed Units"},"reserved_units":{"type":"integer","title":"Reserved Units"},"remaining_units":{"type":"integer","title":"Remaining Units"},"price_micros":{"type":"integer","title":"Price Micros"},"expiry_provider_bps":{"type":"integer","title":"Expiry Provider Bps"},"rate_limit_per_minute":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rate Limit Per Minute"},"rate_limit_per_day":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rate Limit Per Day"},"starts_at":{"type":"string","format":"date-time","title":"Starts At"},"expires_at":{"type":"string","format":"date-time","title":"Expires At"},"suspended_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Suspended At"},"suspension_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Suspension Reason"},"settled_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Settled At"},"created_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Created At"}},"type":"object","required":["id","service_id","execution_mode","status","unit","purchased_units","consumed_units","reserved_units","remaining_units","price_micros","expiry_provider_bps","starts_at","expires_at"],"title":"EntitlementResponse","description":"Buyer-facing entitlement state. Never carries the token or its hash."},"EntitlementSuspendRequest":{"properties":{"reason":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Reason"}},"type":"object","title":"EntitlementSuspendRequest"},"EntitlementSweepResponse":{"properties":{"swept":{"type":"integer","title":"Swept"}},"type":"object","required":["swept"],"title":"EntitlementSweepResponse"},"EntitlementUsageHistoryResponse":{"properties":{"entitlement_id":{"type":"string","title":"Entitlement Id"},"available":{"type":"boolean","title":"Available"},"retention_days":{"type":"integer","title":"Retention Days"},"window_days":{"type":"integer","title":"Window Days"},"generated_at":{"type":"string","format":"date-time","title":"Generated At"},"total_requests":{"type":"integer","title":"Total Requests"},"total_units":{"type":"integer","title":"Total Units"},"daily":{"items":{"$ref":"#/components/schemas/MeteredUsageBucket"},"type":"array","title":"Daily"},"hourly":{"items":{"$ref":"#/components/schemas/MeteredUsageBucket"},"type":"array","title":"Hourly"},"recent_requests":{"items":{"$ref":"#/components/schemas/MeteredUsageRequest"},"type":"array","title":"Recent Requests"}},"type":"object","required":["entitlement_id","available","retention_days","window_days","generated_at","total_requests","total_units","daily","hourly","recent_requests"],"title":"EntitlementUsageHistoryResponse"},"EnvTokenExchange":{"properties":{"token":{"type":"string","maxLength":4096,"minLength":1,"title":"Token"}},"type":"object","required":["token"],"title":"EnvTokenExchange"},"ExactFundingPolicy":{"properties":{"kind":{"type":"string","const":"exact","title":"Kind","default":"exact"},"approval_threshold_micros":{"anyOf":[{"type":"integer","maximum":9007199254740991.0,"minimum":0.0},{"type":"null"}],"title":"Approval Threshold Micros"}},"additionalProperties":false,"type":"object","title":"ExactFundingPolicy"},"ExternalApiKeyBenchmarkGrant":{"properties":{"run_id":{"type":"string","maxLength":64,"minLength":1,"pattern":"^[0-9A-Za-z-]+$","title":"Run Id"}},"type":"object","required":["run_id"],"title":"ExternalApiKeyBenchmarkGrant"},"ExternalApiKeyBenchmarkGrantResponse":{"properties":{"secret":{"type":"string","title":"Secret"},"until":{"type":"string","format":"date-time","title":"Until"}},"type":"object","required":["secret","until"],"title":"ExternalApiKeyBenchmarkGrantResponse","description":"What a benchmark run reads instead of the value: the secret version its\njob may read until ``until``."},"ExternalApiKeyBindingCreate":{"properties":{"env":{"type":"string","maxLength":64,"minLength":1,"title":"Env"},"agent_key":{"type":"string","maxLength":100,"minLength":1,"title":"Agent Key"},"var_name":{"type":"string","title":"Var Name"},"materialize":{"type":"boolean","title":"Materialize","default":false}},"type":"object","required":["env","agent_key","var_name"],"title":"ExternalApiKeyBindingCreate"},"ExternalApiKeyBindingResponse":{"properties":{"id":{"type":"string","title":"Id"},"env":{"type":"string","title":"Env"},"agent_key":{"type":"string","title":"Agent Key"},"var_name":{"type":"string","title":"Var Name"}},"type":"object","required":["id","env","agent_key","var_name"],"title":"ExternalApiKeyBindingResponse"},"ExternalApiKeyCreate":{"properties":{"provider_slug":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Provider Slug"},"probe_config":{"anyOf":[{"$ref":"#/components/schemas/CustomProbeConfig"},{"$ref":"#/components/schemas/ScriptProbeConfig"},{"type":"null"}],"title":"Probe Config"},"purpose":{"type":"string","enum":["runtime","usage_only"],"title":"Purpose","default":"runtime"},"label":{"type":"string","maxLength":100,"minLength":1,"title":"Label"},"value":{"type":"string","maxLength":4096,"minLength":4,"title":"Value"},"bindings":{"items":{"$ref":"#/components/schemas/ExternalApiKeyBindingCreate"},"type":"array","title":"Bindings","default":[]}},"type":"object","required":["label","value"],"title":"ExternalApiKeyCreate"},"ExternalApiKeyListResponse":{"properties":{"keys":{"items":{"$ref":"#/components/schemas/ExternalApiKeyResponse"},"type":"array","title":"Keys"},"supported_providers":{"items":{"type":"string"},"type":"array","title":"Supported Providers","default":[]},"alert_thresholds":{"anyOf":[{"$ref":"#/components/schemas/ExternalKeyAlertThresholds"},{"type":"null"}]}},"type":"object","required":["keys"],"title":"ExternalApiKeyListResponse"},"ExternalApiKeyProbeTest":{"properties":{"value":{"type":"string","maxLength":4096,"minLength":4,"title":"Value"},"provider_slug":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Provider Slug"},"probe_config":{"anyOf":[{"$ref":"#/components/schemas/CustomProbeConfig"},{"$ref":"#/components/schemas/ScriptProbeConfig"},{"type":"null"}],"title":"Probe Config"},"purpose":{"type":"string","enum":["runtime","usage_only"],"title":"Purpose","default":"runtime"}},"type":"object","required":["value"],"title":"ExternalApiKeyProbeTest","description":"Dry-run a usage probe against a value that is not (yet) a key.\n\nNothing is persisted: the value is used for the one probe call and the\nresulting snapshot is returned as-is. Backs the console's \"Test probe\"\nbutton on the add-key form."},"ExternalApiKeyProbeTestExisting":{"properties":{"provider_slug":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Provider Slug"},"probe_config":{"anyOf":[{"$ref":"#/components/schemas/CustomProbeConfig"},{"$ref":"#/components/schemas/ScriptProbeConfig"},{"type":"null"}],"title":"Probe Config"}},"type":"object","title":"ExternalApiKeyProbeTestExisting","description":"Dry-run a candidate probe against a STORED key's value (the console\nnever has the value when editing): nothing is persisted."},"ExternalApiKeyProbeUpdate":{"properties":{"provider_slug":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Provider Slug"},"probe_config":{"anyOf":[{"$ref":"#/components/schemas/CustomProbeConfig"},{"$ref":"#/components/schemas/ScriptProbeConfig"},{"type":"null"}],"title":"Probe Config"}},"type":"object","title":"ExternalApiKeyProbeUpdate","description":"Replace a key's usage probe in place: provider (selects a built-in\nprobe) and/or custom config. ``probe_config: null`` removes the custom\nprobe; both null means the key is no longer probed."},"ExternalApiKeyResponse":{"properties":{"id":{"type":"string","title":"Id"},"purpose":{"type":"string","title":"Purpose","default":"runtime"},"probeable":{"type":"boolean","title":"Probeable","default":false},"provider_slug":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provider Slug"},"probe_config":{"anyOf":[{"$ref":"#/components/schemas/CustomProbeConfig"},{"$ref":"#/components/schemas/ScriptProbeConfig"},{"type":"null"}],"title":"Probe Config"},"label":{"type":"string","title":"Label"},"last4":{"type":"string","title":"Last4"},"secret_version":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Secret Version"},"created_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Created At"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"},"bindings":{"items":{"$ref":"#/components/schemas/ExternalApiKeyBindingResponse"},"type":"array","title":"Bindings"},"usage":{"anyOf":[{"$ref":"#/components/schemas/ExternalApiKeyUsage"},{"type":"null"}]}},"type":"object","required":["id","label","last4","bindings"],"title":"ExternalApiKeyResponse","description":"Masked registry row — the stored value is write-only by design."},"ExternalApiKeyRotate":{"properties":{"value":{"type":"string","maxLength":4096,"minLength":4,"title":"Value"}},"type":"object","required":["value"],"title":"ExternalApiKeyRotate"},"ExternalApiKeyUsage":{"properties":{"captured_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Captured At"},"shared_with_key_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Shared With Key Id"},"last_success_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Success At"},"stale":{"type":"boolean","title":"Stale","default":true},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source"},"scope":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Scope"},"account_ref":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Account Ref"},"used":{"anyOf":[{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"},{"type":"null"}],"title":"Used"},"limit_value":{"anyOf":[{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"},{"type":"null"}],"title":"Limit Value"},"remaining":{"anyOf":[{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"},{"type":"null"}],"title":"Remaining"},"unit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Unit"},"plan":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Plan"},"resets_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Resets At"},"status":{"type":"string","title":"Status","default":"unsupported"},"detail":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Detail"}},"type":"object","title":"ExternalApiKeyUsage"},"ExternalApiKeyValueResponse":{"properties":{"value":{"type":"string","title":"Value"}},"type":"object","required":["value"],"title":"ExternalApiKeyValueResponse","description":"Decrypted value for the console's server-side cross-env push — the\nconsole never forwards it to the browser."},"ExternalKeyAlertThresholds":{"properties":{"low_pct":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"Low Pct"},"critical_pct":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"Critical Pct"}},"type":"object","required":["low_pct","critical_pct"],"title":"ExternalKeyAlertThresholds","description":"Remaining-percent tiers at which the budget emails fire.\n\nInclusive, so a key resting on exactly ``low_pct`` alerts. Exhaustion is\nnot configurable: zero remaining always mails."},"FailingProvider":{"properties":{"provider_agent_id":{"type":"string","title":"Provider Agent Id"},"provider_display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provider Display Name"},"service_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Service Id"},"service_title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Service Title"},"dispatch_attempts":{"type":"integer","title":"Dispatch Attempts"},"failures":{"type":"integer","title":"Failures"},"failure_rate":{"type":"number","title":"Failure Rate"},"mcp_failures":{"type":"integer","title":"Mcp Failures"},"webhook_failures":{"type":"integer","title":"Webhook Failures"},"error_types":{"additionalProperties":{"type":"integer"},"type":"object","title":"Error Types"},"latest_failure_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Latest Failure At"},"latest_failure_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Latest Failure Reason"}},"type":"object","required":["provider_agent_id","dispatch_attempts","failures","failure_rate","mcp_failures","webhook_failures"],"title":"FailingProvider"},"FailingProvidersResponse":{"properties":{"window":{"$ref":"#/components/schemas/ObservabilityWindow"},"providers":{"items":{"$ref":"#/components/schemas/FailingProvider"},"type":"array","title":"Providers"}},"type":"object","required":["window","providers"],"title":"FailingProvidersResponse"},"FeeTerms":{"properties":{"platform_fee_bps":{"type":"integer","maximum":10000.0,"minimum":0.0,"title":"Platform Fee Bps"},"provider_fee_bps":{"type":"integer","maximum":10000.0,"minimum":0.0,"title":"Provider Fee Bps","default":0}},"additionalProperties":false,"type":"object","required":["platform_fee_bps"],"title":"FeeTerms"},"FeedbackAttachment":{"properties":{"uri":{"type":"string","maxLength":500,"minLength":1,"pattern":"^delegate-file://[^/\\s]+$","title":"Uri"},"name":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Name"},"media_type":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Media Type"}},"additionalProperties":false,"type":"object","required":["uri"],"title":"FeedbackAttachment","description":"Trusted Delegate file reference supplied with a feedback response."},"FeedbackAttachmentRequest":{"properties":{"filename":{"anyOf":[{"type":"string","maxLength":255,"minLength":1},{"type":"null"}],"title":"Filename"},"content_type":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Content Type"},"selection_mode":{"type":"string","const":"explicit_user_file","title":"Selection Mode","default":"explicit_user_file"},"desktop_path_hint":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}],"title":"Desktop Path Hint"},"upload_prompt":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}],"title":"Upload Prompt"}},"additionalProperties":false,"type":"object","title":"FeedbackAttachmentRequest","description":"One requester-owned file a provider needs before it can continue."},"FeedbackRequestCreate":{"properties":{"idempotency_key":{"type":"string","maxLength":200,"minLength":8,"title":"Idempotency Key"},"trigger":{"type":"string","enum":["milestone","error","clarification"],"title":"Trigger","default":"clarification"},"prompt":{"type":"string","maxLength":4000,"minLength":1,"title":"Prompt"},"context":{"anyOf":[{"type":"string","maxLength":8000},{"type":"null"}],"title":"Context"},"choices":{"anyOf":[{"items":{"type":"string"},"type":"array","maxItems":20},{"type":"null"}],"title":"Choices"},"allow_free_text":{"type":"boolean","title":"Allow Free Text","default":true},"attachment_request":{"anyOf":[{"$ref":"#/components/schemas/FeedbackAttachmentRequest"},{"type":"null"}]}},"type":"object","required":["idempotency_key","prompt"],"title":"FeedbackRequestCreate"},"FeedbackRequestResponse":{"properties":{"id":{"type":"string","title":"Id"},"job_id":{"type":"string","title":"Job Id"},"root_job_id":{"type":"string","title":"Root Job Id"},"trigger":{"type":"string","enum":["milestone","error","clarification"],"title":"Trigger"},"prompt":{"type":"string","title":"Prompt"},"context":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Context"},"choices":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Choices"},"allow_free_text":{"type":"boolean","title":"Allow Free Text"},"attachment_request":{"anyOf":[{"$ref":"#/components/schemas/FeedbackAttachmentRequest"},{"type":"null"}]},"status":{"type":"string","enum":["pending","answered","cancelled"],"title":"Status"},"response":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Response"},"response_attachments":{"items":{"$ref":"#/components/schemas/FeedbackAttachment"},"type":"array","title":"Response Attachments"},"responded_by_type":{"anyOf":[{"type":"string","enum":["user","agent"]},{"type":"null"}],"title":"Responded By Type"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"},"responded_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Responded At"}},"type":"object","required":["id","job_id","root_job_id","trigger","prompt","context","choices","allow_free_text","attachment_request","status","response","responded_by_type","created_at","updated_at","responded_at"],"title":"FeedbackRequestResponse"},"FeedbackResponseCreate":{"properties":{"response":{"type":"string","maxLength":4000,"minLength":1,"title":"Response"},"attachments":{"items":{"$ref":"#/components/schemas/FeedbackAttachment"},"type":"array","maxItems":10,"title":"Attachments"}},"type":"object","required":["response"],"title":"FeedbackResponseCreate"},"FileArchiveRequest":{"properties":{"file_ids":{"items":{"type":"string"},"type":"array","maxItems":100,"minItems":1,"title":"File Ids"}},"additionalProperties":false,"type":"object","required":["file_ids"],"title":"FileArchiveRequest","description":"The file objects to package into one browser download."},"FileDownloadSessionCreate":{"properties":{"preferred_download":{"type":"string","enum":["auto","direct","proxy"],"title":"Preferred Download","default":"auto"}},"additionalProperties":false,"type":"object","title":"FileDownloadSessionCreate","description":"Declared preference for a presigned-download session."},"FileDownloadSessionResponse":{"properties":{"file":{"$ref":"#/components/schemas/FileResponse"},"download":{"$ref":"#/components/schemas/FileDownloadTarget"}},"type":"object","required":["file","download"],"title":"FileDownloadSessionResponse","description":"An available file plus concrete instructions for downloading it."},"FileDownloadTarget":{"properties":{"mode":{"type":"string","enum":["proxy","direct"],"title":"Mode"},"method":{"type":"string","const":"GET","title":"Method","default":"GET"},"url":{"type":"string","title":"Url"},"headers":{"additionalProperties":{"type":"string"},"type":"object","title":"Headers"},"expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Expires At"},"supports_range":{"type":"boolean","title":"Supports Range","default":false},"guidance":{"items":{"type":"string"},"type":"array","title":"Guidance"}},"type":"object","required":["mode","url"],"title":"FileDownloadTarget","description":"Concrete download instructions for an available file."},"FileMultipartPartPageRequest":{"properties":{"first_part_number":{"type":"integer","maximum":10000.0,"minimum":1.0,"title":"First Part Number","default":1},"max_parts":{"anyOf":[{"type":"integer","maximum":10000.0,"minimum":1.0},{"type":"null"}],"title":"Max Parts"},"parts":{"items":{"$ref":"#/components/schemas/FileUploadPartEvidence"},"type":"array","maxItems":10000,"title":"Parts"},"force_parts":{"items":{"type":"integer"},"type":"array","maxItems":10000,"title":"Force Parts"}},"additionalProperties":false,"type":"object","title":"FileMultipartPartPageRequest","description":"Ask for presigned URLs for the parts that are still missing."},"FileMultipartPartPageResponse":{"properties":{"part_size_bytes":{"type":"integer","title":"Part Size Bytes"},"part_count":{"type":"integer","title":"Part Count"},"existing_part_count":{"type":"integer","title":"Existing Part Count"},"remaining_part_count":{"type":"integer","title":"Remaining Part Count"},"missing_part_numbers":{"items":{"type":"integer"},"type":"array","title":"Missing Part Numbers"},"next_part_number":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Next Part Number"},"state":{"type":"string","enum":["in_progress","ready_to_complete"],"title":"State"},"complete_url":{"type":"string","title":"Complete Url"},"abort_url":{"type":"string","title":"Abort Url"},"parts":{"items":{"$ref":"#/components/schemas/FileUploadPartTarget"},"type":"array","title":"Parts"},"guidance":{"items":{"type":"string"},"type":"array","title":"Guidance"}},"type":"object","required":["part_size_bytes","part_count","existing_part_count","remaining_part_count","state","complete_url","abort_url"],"title":"FileMultipartPartPageResponse","description":"Presigned URLs for the missing parts, plus what already landed."},"FileMultipartUploadPlan":{"properties":{"part_size_bytes":{"type":"integer","title":"Part Size Bytes"},"part_count":{"type":"integer","title":"Part Count"},"max_parts_per_request":{"type":"integer","title":"Max Parts Per Request"},"complete_url":{"type":"string","title":"Complete Url"},"abort_url":{"type":"string","title":"Abort Url"}},"type":"object","required":["part_size_bytes","part_count","max_parts_per_request","complete_url","abort_url"],"title":"FileMultipartUploadPlan","description":"The deterministic part geometry for a resumable upload."},"FileResponse":{"properties":{"id":{"type":"string","title":"Id"},"uri":{"type":"string","title":"Uri"},"role":{"type":"string","title":"Role"},"status":{"type":"string","title":"Status"},"filename":{"type":"string","title":"Filename"},"content_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Content Type"},"size_bytes":{"type":"integer","title":"Size Bytes"},"sha256":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sha256"},"sha256_verification":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sha256 Verification"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Expires At"},"upload_prompt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Upload Prompt"},"fulfillable_by_owner":{"type":"boolean","title":"Fulfillable By Owner","default":false}},"type":"object","required":["id","uri","role","status","filename","size_bytes","created_at"],"title":"FileResponse","description":"Metadata for a file object (task input or deliverable)."},"FileRetentionUpdate":{"properties":{"expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Expires At"},"reason":{"type":"string","enum":["admin_hold","paid"],"title":"Reason"},"note":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Note"}},"additionalProperties":false,"type":"object","required":["reason"],"title":"FileRetentionUpdate","description":"Admin/paid retention change for one file (Workspace File Service.md).\n\nRetention past the role defaults is never free: ``admin_hold`` is the\noperator path (also used to shorten), ``paid`` is reserved for the billing\nintegration and is rejected until that exists. Dispute pinning has its own\npath and does not use this schema."},"FileUploadCompleteRequest":{"properties":{"parts":{"items":{"$ref":"#/components/schemas/FileUploadPartEvidence"},"type":"array","maxItems":10000,"title":"Parts"}},"additionalProperties":false,"type":"object","title":"FileUploadCompleteRequest","description":"Optional evidence supplied when finalizing a resumable upload.\n\nDeclaring every part's md5 lets Delegate check the *assembled* object\nagainst those declarations, via the deterministic composite ETag. Without\nit only the total size can be verified, since no store returns a\nwhole-object digest for a multipart object."},"FileUploadPartEvidence":{"properties":{"part_number":{"type":"integer","maximum":10000.0,"minimum":1.0,"title":"Part Number"},"md5":{"type":"string","maxLength":32,"minLength":32,"pattern":"^[0-9a-fA-F]{32}$","title":"Md5"}},"additionalProperties":false,"type":"object","required":["part_number","md5"],"title":"FileUploadPartEvidence","description":"What the client believes one already-uploaded part contains.\n\n``md5`` is the MD5 of that part's exact bytes, which is what an\nS3-compatible store reports as the part's ETag. It is deliberately MD5 and\nnot SHA-256: measured against the live gateway, ``ListParts`` returns an\nETag for every part but no checksum and, on some gateways, not even a size —\nso the ETag is the only evidence available to verify a landed part against.\n\nOptional. Without it a resume still works (part numbers alone say what\nlanded), but a part that landed truncated is only caught by the final\nwhole-object size check, i.e. after the whole transfer completes."},"FileUploadPartTarget":{"properties":{"part_number":{"type":"integer","title":"Part Number"},"method":{"type":"string","const":"PUT","title":"Method","default":"PUT"},"url":{"type":"string","title":"Url"},"headers":{"additionalProperties":{"type":"string"},"type":"object","title":"Headers"},"offset_bytes":{"type":"integer","title":"Offset Bytes"},"size_bytes":{"type":"integer","title":"Size Bytes"},"expires_at":{"type":"string","format":"date-time","title":"Expires At"}},"type":"object","required":["part_number","url","offset_bytes","size_bytes","expires_at"],"title":"FileUploadPartTarget","description":"One presigned UploadPart bearer covering an exact byte range."},"FileUploadRequestCreate":{"properties":{"filename":{"type":"string","maxLength":255,"minLength":1,"title":"Filename"},"content_type":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Content Type"},"prompt":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Prompt"}},"additionalProperties":false,"type":"object","required":["filename"],"title":"FileUploadRequestCreate","description":"Declared metadata for a human-fulfilled upload request.\n\nUnlike a session, the requester does not know the file's size or hash up\nfront - the human picks the file later - so only an expected ``filename`` is\nrequired. The browser later declares exact size and sha256 through the\ntoken-authorized upload-session flow."},"FileUploadRequestInfo":{"properties":{"status":{"type":"string","title":"Status"},"requester_display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Requester Display Name"},"filename":{"type":"string","title":"Filename"},"content_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Content Type"},"prompt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Prompt"},"max_bytes":{"type":"integer","title":"Max Bytes"},"expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Expires At"}},"type":"object","required":["status","filename","max_bytes"],"title":"FileUploadRequestInfo","description":"Sanitized request metadata for the browser upload page.\n\nDeliberately omits owner ids, email addresses, and storage pointers. The\npublic account display name gives the recipient enough verified context to\nrecognize who is asking without exposing private account data."},"FileUploadRequestResponse":{"properties":{"file":{"$ref":"#/components/schemas/FileResponse"},"upload_url":{"type":"string","title":"Upload Url"},"expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Expires At"}},"type":"object","required":["file","upload_url"],"title":"FileUploadRequestResponse","description":"A pending upload request plus the human-openable link to fulfill it."},"FileUploadSessionCreate":{"properties":{"filename":{"type":"string","maxLength":255,"minLength":1,"title":"Filename"},"content_type":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Content Type"},"size_bytes":{"type":"integer","minimum":1.0,"title":"Size Bytes"},"sha256":{"anyOf":[{"type":"string","maxLength":64,"minLength":64,"pattern":"^[0-9a-fA-F]{64}$"},{"type":"null"}],"title":"Sha256"},"preferred_upload":{"type":"string","enum":["auto","direct","proxy","multipart"],"title":"Preferred Upload","default":"auto"}},"additionalProperties":false,"type":"object","required":["filename","size_bytes"],"title":"FileUploadSessionCreate","description":"Declared metadata for a pending file upload session."},"FileUploadSessionResponse":{"properties":{"file":{"$ref":"#/components/schemas/FileResponse"},"upload":{"$ref":"#/components/schemas/FileUploadTarget"}},"type":"object","required":["file","upload"],"title":"FileUploadSessionResponse","description":"Pending file metadata plus upload instructions."},"FileUploadTarget":{"properties":{"mode":{"type":"string","enum":["proxy","direct","multipart"],"title":"Mode"},"method":{"type":"string","const":"PUT","title":"Method","default":"PUT"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"},"headers":{"additionalProperties":{"type":"string"},"type":"object","title":"Headers"},"expires_at":{"type":"string","format":"date-time","title":"Expires At"},"complete_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Complete Url"},"multipart":{"anyOf":[{"$ref":"#/components/schemas/FileMultipartUploadPlan"},{"type":"null"}]},"parts":{"items":{"$ref":"#/components/schemas/FileUploadPartTarget"},"type":"array","title":"Parts"},"guidance":{"items":{"type":"string"},"type":"array","title":"Guidance"}},"type":"object","required":["mode","expires_at"],"title":"FileUploadTarget","description":"Concrete upload instructions for a pending file."},"FleetAgentEnabledUpdate":{"properties":{"enabled":{"type":"boolean","title":"Enabled"}},"type":"object","required":["enabled"],"title":"FleetAgentEnabledUpdate"},"FleetAssignee":{"properties":{"agent_key":{"type":"string","title":"Agent Key"},"user_id":{"type":"string","title":"User Id"}},"type":"object","required":["agent_key","user_id"],"title":"FleetAssignee","description":"Who looks after one agent, by stable agent key.\n\nA pure link: the console already loads the admin user list for the\npicker, so it resolves the email and display name from there rather\nthan having them duplicated here."},"FleetAssigneeUpdate":{"properties":{"user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Id"}},"type":"object","title":"FleetAssigneeUpdate","description":"``user_id: null`` clears the assignment."},"FleetAssigneesResponse":{"properties":{"assignees":{"items":{"$ref":"#/components/schemas/FleetAssignee"},"type":"array","title":"Assignees"}},"type":"object","required":["assignees"],"title":"FleetAssigneesResponse"},"FleetAuditEvent":{"properties":{"env":{"type":"string","maxLength":64,"minLength":1,"title":"Env"},"method":{"type":"string","maxLength":16,"minLength":1,"title":"Method"},"path":{"type":"string","maxLength":400,"minLength":1,"title":"Path"},"status_code":{"type":"integer","maximum":599.0,"minimum":100.0,"title":"Status Code"}},"type":"object","required":["env","method","path","status_code"],"title":"FleetAuditEvent","description":"A cross-environment fleet action, reported by the admin console's\nrelay so actions against OTHER environments land in this (primary)\nenvironment's audit trail."},"FleetCatalogMember":{"properties":{"agent_key":{"type":"string","title":"Agent Key"},"provider_agent_key":{"type":"string","title":"Provider Agent Key","default":""},"enabled":{"type":"boolean","title":"Enabled","default":true},"required_env":{"items":{"type":"string"},"type":"array","title":"Required Env","default":[]},"version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Version"}},"type":"object","required":["agent_key"],"title":"FleetCatalogMember"},"FleetCatalogResponse":{"properties":{"available":{"type":"boolean","title":"Available"},"targets":{"items":{"$ref":"#/components/schemas/FleetCatalogTarget"},"type":"array","title":"Targets"}},"type":"object","required":["available","targets"],"title":"FleetCatalogResponse","description":"The deployed tree's deploy/agent-targets.json, lightly parsed.\n\n``available`` is False when the serving environment has no targets file\n(e.g. a bare container without the repo checkout) — the console degrades\nto DB-only information instead of erroring."},"FleetCatalogTarget":{"properties":{"name":{"type":"string","title":"Name"},"env":{"type":"string","title":"Env"},"members":{"items":{"$ref":"#/components/schemas/FleetCatalogMember"},"type":"array","title":"Members"}},"type":"object","required":["name","env","members"],"title":"FleetCatalogTarget"},"FleetCloudRunStatus":{"properties":{"state":{"type":"string","title":"State"},"detail":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Detail"},"project":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Project"}},"type":"object","required":["state"],"title":"FleetCloudRunStatus","description":"Whether this backend can run agents on Cloud Run, and why not."},"FleetDeployment":{"properties":{"id":{"type":"string","title":"Id"},"agent_id":{"type":"string","title":"Agent Id"},"agent_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Key"},"name":{"type":"string","title":"Name"},"launch_name":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Launch Name"},"desired_state":{"type":"string","title":"Desired State"},"required_env":{"items":{"type":"string"},"type":"array","title":"Required Env","default":[]},"entry":{"$ref":"#/components/schemas/AgentDeploymentEntry"},"identity_fingerprint":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Identity Fingerprint"}},"type":"object","required":["id","agent_id","name","desired_state","entry"],"title":"FleetDeployment"},"FleetDeploymentIdentityResponse":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"agent_token":{"type":"string","title":"Agent Token"}},"type":"object","required":["agent_id","agent_token"],"title":"FleetDeploymentIdentityResponse"},"FleetDeploymentStatus":{"properties":{"state":{"type":"string","maxLength":50,"minLength":1,"title":"State"},"detail":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Detail"}},"type":"object","required":["state"],"title":"FleetDeploymentStatus"},"FleetDeploymentWatchResponse":{"properties":{"host":{"type":"string","title":"Host"},"cursor":{"type":"string","maxLength":64,"minLength":64,"title":"Cursor"},"changed":{"type":"boolean","title":"Changed"}},"type":"object","required":["host","cursor","changed"],"title":"FleetDeploymentWatchResponse"},"FleetDeploymentsResponse":{"properties":{"host":{"type":"string","title":"Host"},"deployments":{"items":{"$ref":"#/components/schemas/FleetDeployment"},"type":"array","title":"Deployments"}},"type":"object","required":["host","deployments"],"title":"FleetDeploymentsResponse"},"FleetOverviewAgent":{"properties":{"id":{"type":"string","title":"Id"},"agent_key":{"type":"string","title":"Agent Key"},"display_name":{"type":"string","title":"Display Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"owner_email":{"type":"string","title":"Owner Email"},"enabled":{"type":"boolean","title":"Enabled"},"status":{"type":"string","title":"Status"},"reported_status":{"type":"string","title":"Reported Status"},"last_seen_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Seen At"},"presence_expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Presence Expires At"},"heartbeat_exempt":{"type":"boolean","title":"Heartbeat Exempt","default":false},"deployment_model":{"type":"string","title":"Deployment Model"},"notification_mode":{"type":"string","title":"Notification Mode","default":"poll"},"archived_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Archived At"},"required_env":{"items":{"type":"string"},"type":"array","title":"Required Env","default":[]},"plain_env":{"additionalProperties":{"type":"string"},"type":"object","title":"Plain Env","default":{}},"services":{"items":{"$ref":"#/components/schemas/FleetOverviewService"},"type":"array","title":"Services"},"deployments":{"items":{"$ref":"#/components/schemas/FleetOverviewDeployment"},"type":"array","title":"Deployments"},"registration_refused":{"anyOf":[{"$ref":"#/components/schemas/FleetRegistrationRefusal"},{"type":"null"}]}},"type":"object","required":["id","agent_key","display_name","owner_email","enabled","status","reported_status","deployment_model","services","deployments"],"title":"FleetOverviewAgent"},"FleetOverviewDeployment":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"host":{"type":"string","title":"Host"},"desired_state":{"type":"string","title":"Desired State"},"last_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Status"},"last_status_detail":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Status Detail"},"last_synced_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Synced At"},"image":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Image"},"image_history":{"items":{"$ref":"#/components/schemas/AgentDeploymentImageHistoryEntry"},"type":"array","title":"Image History","default":[]},"runtime":{"type":"string","title":"Runtime","default":"docker"},"serving_revision":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Serving Revision"},"service_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Service Url"},"logs_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Logs Url"},"errors_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Errors Url"},"parked_on_cloud_run":{"type":"boolean","title":"Parked On Cloud Run","default":false}},"type":"object","required":["id","name","host","desired_state"],"title":"FleetOverviewDeployment"},"FleetOverviewResponse":{"properties":{"agents":{"items":{"$ref":"#/components/schemas/FleetOverviewAgent"},"type":"array","title":"Agents"},"cloud_run":{"$ref":"#/components/schemas/FleetCloudRunStatus","default":{"state":"off"}}},"type":"object","required":["agents"],"title":"FleetOverviewResponse"},"FleetOverviewService":{"properties":{"id":{"type":"string","title":"Id"},"service_key":{"type":"string","title":"Service Key"},"title":{"type":"string","title":"Title"},"enabled":{"type":"boolean","title":"Enabled"},"status":{"type":"string","title":"Status"},"admin_suspended":{"type":"boolean","title":"Admin Suspended"},"contract_version":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Contract Version"}},"type":"object","required":["id","service_key","title","enabled","status","admin_suspended"],"title":"FleetOverviewService"},"FleetRegistrationRefusal":{"properties":{"message":{"type":"string","title":"Message"},"at":{"type":"string","format":"date-time","title":"At"}},"type":"object","required":["message","at"],"title":"FleetRegistrationRefusal","description":"The backend refused one of the agent's service registrations: the reason\nan agent stops at start-up, which the runtime only reports as an exit."},"FleetStatusReport":{"properties":{"statuses":{"additionalProperties":{"$ref":"#/components/schemas/FleetDeploymentStatus"},"type":"object","title":"Statuses"}},"type":"object","required":["statuses"],"title":"FleetStatusReport"},"FleetStatusReportResponse":{"properties":{"updated":{"type":"integer","title":"Updated"}},"type":"object","required":["updated"],"title":"FleetStatusReportResponse"},"ForgotPasswordRequest":{"properties":{"email":{"type":"string","format":"email","title":"Email"}},"type":"object","required":["email"],"title":"ForgotPasswordRequest"},"FundEscrowRequest":{"properties":{"amount_micros":{"type":"integer","minimum":0.0,"title":"Amount Micros"}},"type":"object","required":["amount_micros"],"title":"FundEscrowRequest"},"Funnel":{"properties":{"requests":{"type":"integer","title":"Requests"},"searched":{"type":"integer","title":"Searched"},"quoted":{"type":"integer","title":"Quoted"},"ordered":{"type":"integer","title":"Ordered"},"delivered":{"type":"integer","title":"Delivered"}},"type":"object","required":["requests","searched","quoted","ordered","delivered"],"title":"Funnel","description":"Chat requests in the window, and how many reached each purchase step."},"GitHubMcpBundleImportRequest":{"properties":{"repository_url":{"type":"string","maxLength":500,"minLength":1,"title":"Repository Url"},"ref":{"type":"string","maxLength":255,"minLength":1,"title":"Ref","default":"HEAD"},"subdirectory":{"type":"string","maxLength":500,"title":"Subdirectory","default":""},"definition_path":{"type":"string","maxLength":500,"title":"Definition Path","default":"delegate.mcp.json"},"definition":{"anyOf":[{"$ref":"#/components/schemas/ImportedMcpDefinition"},{"type":"null"}]}},"additionalProperties":false,"type":"object","required":["repository_url"],"title":"GitHubMcpBundleImportRequest","description":"Provider-supplied recipe for one deterministic GitHub MCP import."},"GmailAttachmentImportRequest":{"properties":{"grant_id":{"type":"string","minLength":1,"title":"Grant Id"},"job_id":{"type":"string","minLength":1,"title":"Job Id"},"message_id":{"type":"string","maxLength":512,"minLength":1,"title":"Message Id"},"attachment_id":{"type":"string","maxLength":512,"minLength":1,"title":"Attachment Id"},"filename":{"type":"string","maxLength":255,"minLength":1,"title":"Filename"},"content_type":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Content Type"}},"type":"object","required":["grant_id","job_id","message_id","attachment_id","filename"],"title":"GmailAttachmentImportRequest"},"GmailThreadGetRequest":{"properties":{"grant_id":{"type":"string","minLength":1,"title":"Grant Id"},"thread_id":{"type":"string","maxLength":512,"minLength":1,"title":"Thread Id"}},"type":"object","required":["grant_id","thread_id"],"title":"GmailThreadGetRequest"},"GmailThreadSearchRequest":{"properties":{"grant_id":{"type":"string","minLength":1,"title":"Grant Id"},"query":{"type":"string","maxLength":2000,"title":"Query","default":""},"page_size":{"type":"integer","maximum":50.0,"minimum":1.0,"title":"Page Size","default":20},"page_token":{"anyOf":[{"type":"string","maxLength":4096},{"type":"null"}],"title":"Page Token"}},"type":"object","required":["grant_id"],"title":"GmailThreadSearchRequest"},"GrantApprove":{"properties":{"connection_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Connection Id"},"always":{"type":"boolean","title":"Always","default":false},"expires_in_days":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Expires In Days"}},"type":"object","title":"GrantApprove","description":"Buyer-side: bind a connection when approving (optional if they have one)."},"GrantRequest":{"properties":{"conversation_id":{"type":"string","minLength":1,"title":"Conversation Id"},"allowed_scopes":{"items":{"type":"string"},"type":"array","minItems":1,"title":"Allowed Scopes"},"connection_kind":{"type":"string","title":"Connection Kind","default":"mcp"},"provider_slug":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"Provider Slug"}},"type":"object","required":["conversation_id","allowed_scopes"],"title":"GrantRequest","description":"Agent-side: request scoped access to the hiring buyer's connection."},"GrantResponse":{"properties":{"id":{"type":"string","title":"Id"},"status":{"type":"string","title":"Status"},"grantee_agent_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Grantee Agent Id"},"grantee_display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Grantee Display Name"},"connection_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Connection Id"},"connection_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Connection Label"},"allowed_scopes":{"items":{"type":"string"},"type":"array","title":"Allowed Scopes","default":[]},"connection_kind":{"type":"string","title":"Connection Kind","default":"mcp"},"provider_slug":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provider Slug"},"always":{"type":"boolean","title":"Always","default":false},"standing_allowed":{"type":"boolean","title":"Standing Allowed","default":false},"standing_scopes":{"items":{"type":"string"},"type":"array","title":"Standing Scopes","default":[]},"conversation_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Conversation Id"},"expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Expires At"},"last_used_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Used At"},"created_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Created At"},"resolved_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Resolved At"}},"type":"object","required":["id","status"],"title":"GrantResponse"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"HealthProbeResult":{"properties":{"checked":{"type":"integer","title":"Checked"},"reachable":{"type":"integer","title":"Reachable"},"unreachable":{"type":"integer","title":"Unreachable"}},"type":"object","required":["checked","reachable","unreachable"],"title":"HealthProbeResult","description":"Summary returned when an admin runs the reachability sweep."},"HireApprovalResponse":{"properties":{"id":{"type":"string","title":"Id"},"status":{"type":"string","title":"Status"},"budget_micros":{"type":"integer","title":"Budget Micros"},"threshold_micros":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Threshold Micros"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"service_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Service Id"},"service_title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Service Title"},"provider_display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provider Display Name"},"conversation_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Conversation Id"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"resolved_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Resolved At"}},"type":"object","required":["id","status","budget_micros","threshold_micros","title","service_id","service_title","provider_display_name","conversation_id","created_at","resolved_at"],"title":"HireApprovalResponse"},"HireAttachment":{"properties":{"uri":{"type":"string","minLength":1,"title":"Uri","description":"Durable attachment reference, usually delegate-file://file_id."},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name","description":"Optional display name."},"media_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Media Type","description":"Optional media type, e.g. audio/mpeg or application/pdf."},"input_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Input Name","description":"Canonical file-contract input slot resolved by Delegate."},"size_bytes":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Size Bytes","description":"Trusted stored byte size populated by Delegate."},"sha256":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sha256","description":"Trusted stored digest populated by Delegate."}},"additionalProperties":false,"type":"object","required":["uri"],"title":"HireAttachment"},"HireConnector":{"properties":{"connection_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Connection Id","description":"Buyer-owned stored connection to use."},"tool_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tool Name","description":"Third-party MCP/tool operation to call."},"arguments":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Arguments","description":"JSON arguments for the connector tool."}},"additionalProperties":false,"type":"object","title":"HireConnector"},"HireContract":{"properties":{"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type","description":"Exact contract type selected by the requester for a hire."},"offer_id":{"anyOf":[{"type":"string","maxLength":128,"minLength":1},{"type":"null"}],"title":"Offer Id","description":"Stable offer reference returned by search or service details. The exact price and quantity are still repeated and verified."},"price":{"anyOf":[{"$ref":"#/components/schemas/HireContractPrice"},{"type":"null"}],"description":"Exact USD-micros price in the requester hire offer."},"quantity":{"anyOf":[{"$ref":"#/components/schemas/HireContractQuantity"},{"type":"null"}],"description":"Optional quantity intent."},"deadline":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Deadline","description":"Optional requested deadline."},"auto_accept":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Auto Accept","description":"Optional auto-accept intent validated against service terms."},"preview_token":{"anyOf":[{"type":"string","maxLength":4096,"minLength":1},{"type":"null"}],"title":"Preview Token","description":"Optional signed parameterized-pricing preview token. When supplied, Delegate verifies it against the requester, service, task, quantity, resolved price, pricing revision, and expiry."}},"additionalProperties":false,"type":"object","title":"HireContract"},"HireContractPrice":{"properties":{"amount_micros":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Amount Micros","description":"Expected price in USD micros."}},"additionalProperties":false,"type":"object","title":"HireContractPrice"},"HireContractQuantity":{"properties":{"unit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Unit","description":"Optional quantity unit."},"value":{"anyOf":[{"type":"integer"},{"type":"number"},{"type":"string"},{"type":"null"}],"title":"Value","description":"Optional quantity value."}},"additionalProperties":false,"type":"object","title":"HireContractQuantity"},"HireReferences":{"properties":{"search_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Search Id","description":"Optional Delegate-issued search_id returned by search_services."},"service_id":{"type":"string","title":"Service Id","description":"Marketplace service to hire. Delegate derives the provider agent from this service."},"entitlement_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Entitlement Id","description":"Purchased metered entitlement to consume through the normal job rail. Requires the X-Delegate-Entitlement header."},"file_contract_hash":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"File Contract Hash","description":"Expected file-contract hash from search or service discovery. A changed contract rejects the hire before dispatch."}},"additionalProperties":false,"type":"object","required":["service_id"],"title":"HireReferences"},"HireTask":{"properties":{"input":{"additionalProperties":true,"type":"object","title":"Input","description":"Required JSON input object validated against the service schema."},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title","description":"Recommended short job title for UI and review."},"summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Summary","description":"Recommended human-readable task summary or instructions."},"attachments":{"anyOf":[{"items":{"$ref":"#/components/schemas/HireAttachment"},"type":"array"},{"type":"null"}],"title":"Attachments","description":"Optional file/resource references such as delegate-file://file_id."}},"additionalProperties":false,"type":"object","required":["input"],"title":"HireTask"},"HiringJobSubmitRequest":{"properties":{"references":{"$ref":"#/components/schemas/HireReferences","description":"Service and optional search provenance references."},"task":{"$ref":"#/components/schemas/HireTask","description":"Structured task payload for the service."},"contract":{"anyOf":[{"$ref":"#/components/schemas/HireContract"},{"type":"null"}],"description":"Required requester hire offer with exact contract type and price."},"connector":{"anyOf":[{"$ref":"#/components/schemas/HireConnector"},{"type":"null"}],"description":"Optional connector routing for vault-backed or tool-backed services."},"file_inputs":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"File Inputs","description":"Complete snapshot input selector. Legacy v1 maps semantic names to artifact handles; normalized v2 selects exact immutable source bindings. Presence selects snapshot runtime mode, and an empty mapping may accompany named Delegate File attachments for asynchronous immutable ingress."},"idempotency_key":{"anyOf":[{"type":"string","maxLength":200,"minLength":8},{"type":"null"}],"title":"Idempotency Key","description":"Exact requester-scoped hire idempotency key. Required only with snapshot file_inputs."},"acting_agent_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Acting Agent Id","description":"Internal agent-initiated sub-hire actor id."},"parent_job_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Parent Job Id","description":"Internal currently executing parent job id for agent sub-hires."},"workspace_access":{"anyOf":[{"items":{"anyOf":[{"type":"string"},{"$ref":"#/components/schemas/WorkspaceAccessGrant"}]},"type":"array"},{"type":"null"}],"title":"Workspace Access","description":"Workspace selectors for an agent sub-hire. Structured grants are least-privilege; legacy prefix strings mean read/write/delete."}},"additionalProperties":false,"type":"object","required":["references","task"],"title":"HiringJobSubmitRequest"},"HistoryItem":{"properties":{"id":{"type":"string","title":"Id"},"communication_id":{"type":"string","title":"Communication Id"},"message_key":{"type":"string","title":"Message Key"},"message_version":{"type":"integer","title":"Message Version"},"channel":{"type":"string","title":"Channel"},"event":{"type":"string","title":"Event"},"action":{"type":"string","title":"Action"},"occurred_at":{"type":"string","format":"date-time","title":"Occurred At"},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source"},"actor_user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Actor User Id"},"provider_message_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provider Message Id"},"actor_email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Actor Email"}},"type":"object","required":["id","communication_id","message_key","message_version","channel","event","action","occurred_at"],"title":"HistoryItem"},"HistoryPage":{"properties":{"items":{"items":{"$ref":"#/components/schemas/HistoryItem"},"type":"array","title":"Items"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor"},"email_suppression":{"anyOf":[{"$ref":"#/components/schemas/SuppressionStatus"},{"type":"null"}]}},"type":"object","required":["items","next_cursor"],"title":"HistoryPage"},"HomeEvent":{"properties":{"communication_id":{"type":"string","format":"uuid","title":"Communication Id"},"message_key":{"type":"string","enum":["home.name","home.connect","home.first_hire","home.service_wish","home.follow"],"title":"Message Key"},"message_version":{"type":"integer","const":1,"title":"Message Version"},"event":{"type":"string","enum":["shown","clicked","dismissed","completed"],"title":"Event"},"action":{"type":"string","maxLength":32,"title":"Action","default":""}},"additionalProperties":false,"type":"object","required":["communication_id","message_key","message_version","event"],"title":"HomeEvent"},"HomeMessages":{"properties":{"nudge":{"anyOf":[{"$ref":"#/components/schemas/HomeNudge"},{"type":"null"}]}},"type":"object","required":["nudge"],"title":"HomeMessages"},"HomeNudge":{"properties":{"message_key":{"type":"string","title":"Message Key"},"clicked":{"items":{"type":"string"},"type":"array","title":"Clicked"}},"type":"object","required":["message_key","clicked"],"title":"HomeNudge"},"HumanRatingEntry":{"properties":{"expected_revision":{"type":"integer","minimum":0.0,"title":"Expected Revision"},"quality_rating":{"type":"integer","maximum":5.0,"minimum":1.0,"title":"Quality Rating"},"quality_note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quality Note"}},"additionalProperties":false,"type":"object","required":["expected_revision","quality_rating"],"title":"HumanRatingEntry","description":"A person's rating of one run: quality only, plus an optional comment.\n\nThe comment is stored as the quality note. People are not asked about value\nfor money; that axis comes from agent assessments."},"ImportedMcpDefinition":{"properties":{"agent_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Key"},"display_name":{"type":"string","maxLength":200,"minLength":1,"title":"Display Name"},"description":{"type":"string","maxLength":4000,"title":"Description","default":""},"owner":{"anyOf":[{"$ref":"#/components/schemas/BundleOwner"},{"type":"null"}]},"env_prefix":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Env Prefix"},"port":{"anyOf":[{"type":"integer","maximum":65535.0,"minimum":1024.0},{"type":"null"}],"title":"Port"},"version":{"type":"string","maxLength":100,"minLength":1,"title":"Version","default":"0.1.0"},"required_env":{"items":{"type":"string"},"type":"array","maxItems":50,"title":"Required Env"},"requirements_path":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Requirements Path","default":"requirements.txt"},"target":{"$ref":"#/components/schemas/ImportedMcpTarget"},"services":{"items":{"$ref":"#/components/schemas/ImportedMcpService"},"type":"array","maxItems":20,"minItems":1,"title":"Services"}},"additionalProperties":false,"type":"object","required":["display_name","target","services"],"title":"ImportedMcpDefinition"},"ImportedMcpService":{"properties":{"service_key":{"type":"string","title":"Service Key"},"target_tool_name":{"type":"string","maxLength":255,"minLength":1,"title":"Target Tool Name"},"title":{"type":"string","maxLength":200,"minLength":1,"title":"Title"},"description":{"type":"string","maxLength":4000,"minLength":1,"title":"Description"},"input_schema":{"additionalProperties":true,"type":"object","title":"Input Schema"},"primary_argument":{"type":"string","maxLength":100,"minLength":1,"title":"Primary Argument"},"offers":{"items":{"$ref":"#/components/schemas/OfferDefinition"},"type":"array","maxItems":10,"minItems":1,"title":"Offers"},"output_schema":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Output Schema"},"tags":{"items":{"type":"string"},"type":"array","maxItems":20,"title":"Tags"},"file_contract":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"File Contract"},"timeout_seconds":{"type":"integer","maximum":120.0,"minimum":1.0,"title":"Timeout Seconds","default":120},"sample_tasks":{"items":{"additionalProperties":true,"type":"object"},"type":"array","maxItems":20,"title":"Sample Tasks"},"queue_policy":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Queue Policy"},"refund_policy":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Refund Policy"},"typical_turnaround_minutes":{"anyOf":[{"type":"integer","minimum":1.0},{"type":"null"}],"title":"Typical Turnaround Minutes"},"p90_turnaround_minutes":{"anyOf":[{"type":"integer","minimum":1.0},{"type":"null"}],"title":"P90 Turnaround Minutes"},"max_turnaround_minutes":{"anyOf":[{"type":"integer","minimum":1.0},{"type":"null"}],"title":"Max Turnaround Minutes"},"required_env":{"anyOf":[{"items":{"type":"string"},"type":"array","maxItems":50},{"type":"null"}],"title":"Required Env"},"contract_acceptance_tool_name":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Contract Acceptance Tool Name"}},"additionalProperties":false,"type":"object","required":["service_key","target_tool_name","title","description","input_schema","primary_argument","offers"],"title":"ImportedMcpService"},"ImportedMcpTarget":{"properties":{"command":{"items":{"type":"string"},"type":"array","maxItems":64,"minItems":1,"title":"Command"},"port":{"type":"integer","maximum":65535.0,"minimum":1024.0,"title":"Port"},"endpoint_path":{"type":"string","maxLength":255,"minLength":1,"title":"Endpoint Path","default":"/mcp"},"cwd":{"type":"string","maxLength":500,"title":"Cwd","default":"."},"env_keys":{"items":{"type":"string"},"type":"array","maxItems":50,"title":"Env Keys"},"auth_token_env":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"Auth Token Env"},"header_env":{"additionalProperties":{"type":"string"},"type":"object","maxProperties":20,"title":"Header Env"},"timeout_seconds":{"type":"integer","maximum":120.0,"minimum":1.0,"title":"Timeout Seconds","default":120},"startup_timeout_seconds":{"type":"integer","maximum":120.0,"minimum":1.0,"title":"Startup Timeout Seconds","default":30}},"additionalProperties":false,"type":"object","required":["command","port"],"title":"ImportedMcpTarget"},"IntegerScopeField":{"properties":{"type":{"type":"string","const":"integer","title":"Type","default":"integer"},"title":{"type":"string","maxLength":100,"minLength":1,"title":"Title"},"description":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}],"title":"Description"},"minimum":{"type":"integer","maximum":9007199254740991.0,"minimum":0.0,"title":"Minimum"},"maximum":{"type":"integer","maximum":9007199254740991.0,"minimum":0.0,"title":"Maximum"},"unit":{"type":"string","maxLength":100,"minLength":1,"title":"Unit"},"allowed_values":{"anyOf":[{"items":{"type":"integer"},"type":"array","maxItems":100,"minItems":1},{"type":"null"}],"title":"Allowed Values"}},"additionalProperties":false,"type":"object","required":["title","minimum","maximum","unit"],"title":"IntegerScopeField"},"IntegrationHealthEntry":{"properties":{"slug":{"type":"string","title":"Slug"},"reachable":{"type":"boolean","title":"Reachable"},"detail":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Detail"},"latency_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Latency Ms"},"checked_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Checked At"}},"type":"object","required":["slug","reachable"],"title":"IntegrationHealthEntry","description":"The latest reachability probe result for one catalog entry."},"IntegrationLibraryEntry":{"properties":{"slug":{"type":"string","title":"Slug"},"name":{"type":"string","title":"Name"},"description":{"type":"string","title":"Description"},"category":{"type":"string","title":"Category"},"mcp_url":{"type":"string","title":"Mcp Url"},"website":{"type":"string","title":"Website"},"docs_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Docs Url"},"brand_color":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Brand Color"},"verified_on":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Verified On"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notes"},"lifecycle":{"type":"string","title":"Lifecycle","default":"active"},"banner":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Banner"},"oauth":{"anyOf":[{"$ref":"#/components/schemas/LibraryOAuthInfo"},{"type":"null"}]},"api_key":{"anyOf":[{"$ref":"#/components/schemas/LibraryApiKeyInfo"},{"type":"null"}]},"anonymous":{"anyOf":[{"$ref":"#/components/schemas/LibraryAnonymousInfo"},{"type":"null"}]},"connector":{"anyOf":[{"$ref":"#/components/schemas/LibraryConnectorInfo"},{"type":"null"}]},"connection":{"anyOf":[{"$ref":"#/components/schemas/LibraryConnectionInfo"},{"type":"null"}]},"connector_connection":{"anyOf":[{"$ref":"#/components/schemas/LibraryConnectionInfo"},{"type":"null"}]}},"type":"object","required":["slug","name","description","category","mcp_url","website"],"title":"IntegrationLibraryEntry"},"IntegrationOverrideUpdate":{"properties":{"lifecycle":{"anyOf":[{"type":"string","pattern":"^(active|deprecated|disabled)$"},{"type":"null"}],"title":"Lifecycle"},"hidden":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Hidden"},"banner":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Banner"}},"type":"object","title":"IntegrationOverrideUpdate","description":"Admin patch of a catalog entry's runtime state. Only provided fields change;\nomitted fields are left as-is (so an admin can flip lifecycle without clearing\na banner)."},"InvitationAccessUpdate":{"properties":{"make_root":{"type":"boolean","title":"Make Root","default":false},"can_invite":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Can Invite"}},"additionalProperties":false,"type":"object","title":"InvitationAccessUpdate"},"InvitationProfile":{"properties":{"can_invite":{"type":"boolean","title":"Can Invite"},"can_invite_override":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Can Invite Override"},"invitation_level":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Invitation Level"},"invitation_generation":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Invitation Generation"},"invitation_trust_level":{"anyOf":[{"type":"integer","maximum":2.0,"minimum":0.0},{"type":"null"}],"title":"Invitation Trust Level"},"invited_by_user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Invited By User Id"},"signup_origin":{"type":"string","enum":["direct","invited","unknown"],"title":"Signup Origin"}},"type":"object","required":["can_invite","can_invite_override","invitation_level","invited_by_user_id","signup_origin"],"title":"InvitationProfile"},"InviteAcceptRequest":{"properties":{"utm_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Utm Source"},"utm_medium":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Utm Medium"},"utm_campaign":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Utm Campaign"},"utm_content":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Utm Content"},"referrer":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Referrer"},"landing_page":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Landing Page"},"first_name":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"First Name"},"last_name":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"Last Name"},"token":{"type":"string","minLength":1,"title":"Token"},"password":{"type":"string","title":"Password"}},"type":"object","required":["token","password"],"title":"InviteAcceptRequest"},"InviteCreate":{"properties":{"email":{"type":"string","format":"email","title":"Email"},"category":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Category"},"chat_access":{"type":"boolean","title":"Chat Access","default":false},"apps_access":{"type":"boolean","title":"Apps Access","default":false}},"additionalProperties":false,"type":"object","required":["email"],"title":"InviteCreate"},"InviteLookupRequest":{"properties":{"token":{"type":"string","minLength":1,"title":"Token"}},"type":"object","required":["token"],"title":"InviteLookupRequest"},"InviteSettings":{"properties":{"signup_credit_micros":{"type":"integer","minimum":0.0,"title":"Signup Credit Micros"}},"type":"object","required":["signup_credit_micros"],"title":"InviteSettings"},"IssueReportCreate":{"properties":{"title":{"type":"string","maxLength":200,"minLength":1,"title":"Title"},"description":{"type":"string","maxLength":5000,"minLength":1,"title":"Description"},"area":{"type":"string","enum":["connection","discovery","pricing_offers","hiring_orders","job_execution","files","wallet_billing","disputes_refunds","account","dashboard","provider","other"],"title":"Area","default":"other"},"issue_type":{"type":"string","enum":["bug","feature"],"title":"Issue Type","default":"bug"},"surface":{"type":"string","enum":["mcp","web"],"title":"Surface","default":"mcp"},"mcp_tool":{"type":"string","maxLength":60,"title":"Mcp Tool","default":""},"client":{"type":"string","maxLength":60,"title":"Client","default":""},"reference":{"type":"string","maxLength":200,"title":"Reference","default":""},"expected":{"type":"string","maxLength":2000,"title":"Expected","default":""},"steps":{"type":"string","maxLength":2000,"title":"Steps","default":""},"page":{"type":"string","maxLength":500,"title":"Page","default":""},"user_agent":{"type":"string","maxLength":300,"title":"User Agent","default":""},"viewport":{"type":"string","maxLength":50,"title":"Viewport","default":""},"mode":{"type":"string","maxLength":50,"title":"Mode","default":""},"screenshot":{"type":"string","maxLength":1400000,"title":"Screenshot","default":""}},"type":"object","required":["title","description"],"title":"IssueReportCreate","description":"A structured report; captured client fields are also untrusted input."},"IssueReportResponse":{"properties":{"identifier":{"type":"string","title":"Identifier"}},"type":"object","required":["identifier"],"title":"IssueReportResponse"},"JobDeliverRequest":{"properties":{"content":{"type":"string","minLength":1,"title":"Content"},"artifacts":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Artifacts"},"settlement":{"anyOf":[{"$ref":"#/components/schemas/JobSettlementRequest"},{"type":"null"}]},"snapshot_finalize":{"anyOf":[{"$ref":"#/components/schemas/SnapshotFinalizeRequestV1"},{"$ref":"#/components/schemas/SnapshotFinalizeRequestV2"},{"type":"null"}],"title":"Snapshot Finalize"}},"type":"object","required":["content"],"title":"JobDeliverRequest"},"JobFinishRequest":{"properties":{"outcome":{"type":"string","enum":["delivered","reduced","non_billable","failed_provider"],"title":"Outcome","default":"delivered"},"content":{"type":"string","minLength":1,"title":"Content"},"artifacts":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Artifacts"},"settlement":{"anyOf":[{"$ref":"#/components/schemas/JobSettlementRequest"},{"type":"null"}]}},"type":"object","required":["content"],"title":"JobFinishRequest"},"JobProgress":{"properties":{"status":{"type":"string","enum":["running","completed","failed","blocked"],"title":"Status"},"label":{"anyOf":[{"type":"string","maxLength":160},{"type":"null"}],"title":"Label"},"phase":{"anyOf":[{"type":"integer","minimum":1.0},{"type":"null"}],"title":"Phase"},"total_phases":{"anyOf":[{"type":"integer","minimum":1.0},{"type":"null"}],"title":"Total Phases"},"items_total":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Items Total"},"items_completed":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Items Completed"},"items_failed":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Items Failed"}},"additionalProperties":false,"type":"object","required":["status"],"title":"JobProgress","description":"Structured live status a worker reports while a job is still running.\n\nDeliberately minimal and never part of settlement/billing: unlike\naccept/deliver/finish, sending the same progress twice (or never at all)\nhas no lifecycle consequence. Structured (status/label/phase) rather than\nfree prose specifically to bound how much an untrusted or compromised\nprovider can put in front of the hiring agent: it rides straight into\nthat agent's context through ``get_job_status``, so there is deliberately\nvery little room in this shape for anything but a short status update."},"JobQueueSnapshot":{"properties":{"queue_position":{"type":"integer","minimum":1.0,"title":"Queue Position"},"queued_jobs_ahead":{"type":"integer","minimum":0.0,"title":"Queued Jobs Ahead"},"running_jobs":{"type":"integer","minimum":0.0,"title":"Running Jobs"},"estimated_start_seconds":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Estimated Start Seconds"},"estimated_start_p90_seconds":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Estimated Start P90 Seconds"},"queued_at":{"type":"string","format":"date-time","title":"Queued At"},"observed_at":{"type":"string","format":"date-time","title":"Observed At"}},"type":"object","required":["queue_position","queued_jobs_ahead","running_jobs","queued_at","observed_at"],"title":"JobQueueSnapshot"},"JobRejectRequest":{"properties":{"reason":{"type":"string","maxLength":2000,"minLength":1,"title":"Reason"},"reason_code":{"anyOf":[{"type":"string","maxLength":100,"minLength":1},{"type":"null"}],"title":"Reason Code"}},"type":"object","required":["reason"],"title":"JobRejectRequest"},"JobSettlementRequest":{"properties":{"billable_micros":{"type":"integer","minimum":0.0,"title":"Billable Micros"},"reason_code":{"type":"string","maxLength":100,"minLength":1,"title":"Reason Code"},"reason":{"type":"string","maxLength":2000,"minLength":1,"title":"Reason"},"usage":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Usage"}},"type":"object","required":["billable_micros","reason_code","reason"],"title":"JobSettlementRequest"},"JoinedInvitee":{"properties":{"id":{"type":"string","title":"Id"},"display_name":{"type":"string","title":"Display Name"},"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"},"joined_at":{"type":"string","format":"date-time","title":"Joined At"}},"type":"object","required":["id","display_name","email","joined_at"],"title":"JoinedInvitee"},"JoinedInviteesResponse":{"properties":{"users":{"items":{"$ref":"#/components/schemas/JoinedInvitee"},"type":"array","title":"Users"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["users","total"],"title":"JoinedInviteesResponse"},"LibraryAnonymousInfo":{"properties":{"supported":{"type":"boolean","title":"Supported","default":true},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notes"}},"type":"object","title":"LibraryAnonymousInfo","description":"A public, no-credential connect option for one library entry."},"LibraryApiKeyInfo":{"properties":{"supported":{"type":"boolean","title":"Supported","default":true},"credential_label":{"type":"string","title":"Credential Label","default":"API key"},"help_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Help Url"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notes"}},"type":"object","title":"LibraryApiKeyInfo"},"LibraryConnectionInfo":{"properties":{"id":{"type":"string","title":"Id"},"status":{"type":"string","title":"Status"},"auth_type":{"type":"string","title":"Auth Type"},"key_custody":{"type":"string","title":"Key Custody","default":"server"},"unlocked":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Unlocked"},"unlock_expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Unlock Expires At"}},"type":"object","required":["id","status","auth_type"],"title":"LibraryConnectionInfo","description":"The caller's existing connection to this integration's endpoint, if any."},"LibraryConnectorInfo":{"properties":{"supported":{"type":"boolean","title":"Supported","default":true},"credential_label":{"type":"string","title":"Credential Label","default":"Access token"},"help_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Help Url"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notes"},"oauth_managed":{"type":"boolean","title":"Oauth Managed","default":false}},"type":"object","title":"LibraryConnectorInfo","description":"A reviewed, fixed-action application connector for this provider."},"LibraryOAuthInfo":{"properties":{"supported":{"type":"boolean","title":"Supported","default":true},"available":{"type":"boolean","title":"Available","default":true},"requires_preregistered_client":{"type":"boolean","title":"Requires Preregistered Client","default":false},"default_scopes":{"items":{"type":"string"},"type":"array","title":"Default Scopes","default":[]},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notes"}},"type":"object","title":"LibraryOAuthInfo","description":"OAuth availability for one library entry, as the dashboard sees it."},"LookupPricePoint":{"properties":{"value":{"anyOf":[{"type":"integer"},{"type":"string"}],"title":"Value"},"amount_micros":{"type":"integer","maximum":9007199254740991.0,"minimum":0.0,"title":"Amount Micros"}},"additionalProperties":false,"type":"object","required":["value","amount_micros"],"title":"LookupPricePoint"},"LookupPriceRule":{"properties":{"kind":{"type":"string","const":"lookup","title":"Kind","default":"lookup"},"name":{"type":"string","maxLength":100,"minLength":1,"title":"Name"},"parameter":{"$ref":"#/components/schemas/ParameterReference"},"points":{"items":{"$ref":"#/components/schemas/LookupPricePoint"},"type":"array","maxItems":100,"minItems":1,"title":"Points"}},"additionalProperties":false,"type":"object","required":["name","parameter","points"],"title":"LookupPriceRule"},"McpServiceConfig":{"properties":{"endpoint_url":{"type":"string","maxLength":1000,"minLength":1,"title":"Endpoint Url"},"tool_name":{"type":"string","maxLength":255,"minLength":1,"title":"Tool Name"},"contract_acceptance_tool_name":{"anyOf":[{"type":"string","maxLength":255,"minLength":1},{"type":"null"}],"title":"Contract Acceptance Tool Name"},"primary_argument":{"type":"string","maxLength":100,"minLength":1,"title":"Primary Argument","default":"prompt"},"static_arguments":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Static Arguments"},"auth_token":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Auth Token"},"auth_token_secret":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Auth Token Secret"},"auth_id_token_audience":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}],"title":"Auth Id Token Audience"},"headers":{"anyOf":[{"additionalProperties":{"type":"string"},"type":"object"},{"type":"null"}],"title":"Headers"},"timeout_seconds":{"anyOf":[{"type":"integer","maximum":1800.0,"minimum":1.0},{"type":"null"}],"title":"Timeout Seconds"},"delegate_context_version":{"anyOf":[{"type":"integer","const":1},{"type":"null"}],"title":"Delegate Context Version"},"requires_user_connection":{"type":"boolean","title":"Requires User Connection","default":false},"requires_provider_presence":{"type":"boolean","title":"Requires Provider Presence","default":false},"streaming":{"type":"string","enum":["always","optional","never"],"title":"Streaming","default":"never"}},"type":"object","required":["endpoint_url","tool_name"],"title":"McpServiceConfig"},"McpServiceConfigPublic":{"properties":{"endpoint_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Endpoint Url"},"tool_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tool Name"},"contract_acceptance_tool_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Contract Acceptance Tool Name"},"primary_argument":{"type":"string","title":"Primary Argument","default":"prompt"},"timeout_seconds":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Timeout Seconds"},"delegate_context_version":{"anyOf":[{"type":"integer","const":1},{"type":"null"}],"title":"Delegate Context Version"},"streaming":{"type":"string","enum":["always","optional","never"],"title":"Streaming","default":"never"},"auth_token_configured":{"type":"boolean","title":"Auth Token Configured","default":false},"auth_token_secret":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Auth Token Secret"},"headers_configured":{"type":"boolean","title":"Headers Configured","default":false},"requires_user_connection":{"type":"boolean","title":"Requires User Connection","default":false}},"type":"object","title":"McpServiceConfigPublic"},"McpToolInfo":{"properties":{"name":{"type":"string","title":"Name"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"input_schema":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Input Schema"},"output_schema":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Output Schema"}},"type":"object","required":["name"],"title":"McpToolInfo"},"McpToolsListRequest":{"properties":{"endpoint_url":{"type":"string","maxLength":1000,"minLength":1,"title":"Endpoint Url"},"auth_token":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Auth Token"},"headers":{"anyOf":[{"additionalProperties":{"type":"string"},"type":"object"},{"type":"null"}],"title":"Headers"},"timeout_seconds":{"anyOf":[{"type":"integer","maximum":120.0,"minimum":1.0},{"type":"null"}],"title":"Timeout Seconds"}},"type":"object","required":["endpoint_url"],"title":"McpToolsListRequest"},"McpToolsListResponse":{"properties":{"tools":{"items":{"$ref":"#/components/schemas/McpToolInfo"},"type":"array","title":"Tools"}},"type":"object","required":["tools"],"title":"McpToolsListResponse"},"MessageCreate":{"properties":{"text":{"type":"string","maxLength":4000,"minLength":1,"title":"Text"}},"type":"object","required":["text"],"title":"MessageCreate","description":"Body for posting a mid-job clarification message to a conversation."},"MessageResponse":{"properties":{"id":{"type":"string","title":"Id"},"sender_type":{"type":"string","title":"Sender Type"},"a2a_payload":{"additionalProperties":true,"type":"object","title":"A2A Payload"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","sender_type","a2a_payload","created_at"],"title":"MessageResponse"},"MeteredUsageBucket":{"properties":{"period":{"type":"string","title":"Period"},"requests":{"type":"integer","title":"Requests"},"successful_requests":{"type":"integer","title":"Successful Requests"},"failed_requests":{"type":"integer","title":"Failed Requests"},"units":{"type":"integer","title":"Units"}},"type":"object","required":["period","requests","successful_requests","failed_requests","units"],"title":"MeteredUsageBucket"},"MeteredUsageRequest":{"properties":{"request_id":{"type":"string","title":"Request Id"},"at":{"type":"string","format":"date-time","title":"At"},"service_key":{"type":"string","title":"Service Key"},"status":{"type":"string","title":"Status"},"billable":{"type":"boolean","title":"Billable"},"unit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Unit"},"quantity":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Quantity"},"reserved_quantity":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Reserved Quantity"},"requested_quantity":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Requested Quantity"},"remaining":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Remaining"},"consumed_total":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Consumed Total"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"}},"type":"object","required":["request_id","at","service_key","status","billable"],"title":"MeteredUsageRequest"},"ModelUsage":{"properties":{"model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model"},"label":{"type":"string","title":"Label"},"engine":{"type":"string","title":"Engine"},"runs":{"type":"integer","title":"Runs"},"finished_well":{"type":"integer","title":"Finished Well"},"ended":{"type":"integer","title":"Ended"},"median_seconds":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Median Seconds"},"p90_seconds":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"P90 Seconds"},"ai_cost_micros":{"type":"integer","title":"Ai Cost Micros"}},"type":"object","required":["model","label","engine","runs","finished_well","ended","median_seconds","p90_seconds","ai_cost_micros"],"title":"ModelUsage"},"MonthlySpendResponse":{"properties":{"month":{"type":"string","title":"Month"},"spend_micros":{"type":"integer","title":"Spend Micros"},"settled_micros":{"type":"integer","title":"Settled Micros"},"in_flight_micros":{"type":"integer","title":"In Flight Micros"},"limit_micros":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Limit Micros"}},"type":"object","required":["month","spend_micros","settled_micros","in_flight_micros"],"title":"MonthlySpendResponse","description":"The caller's spend for the current calendar month (UTC) and their cap.\n\n``spend_micros`` is the figure the monthly-cap gate compares against:\nsettled net charges plus in-flight escrow holds for the month. The parts are\nbroken out so the client can explain why ``spend_micros`` may exceed the\nsettled \"net paid\" shown elsewhere."},"OAuthFinalizeRequest":{"properties":{"flow_id":{"type":"string","minLength":1,"title":"Flow Id"},"passphrase":{"type":"string","maxLength":1024,"minLength":1,"title":"Passphrase"}},"type":"object","required":["flow_id","passphrase"],"title":"OAuthFinalizeRequest","description":"Finish a Tier-2 OAuth connection: supply the passphrase to wrap the tokens\nthat were stashed at the callback."},"OAuthStartRequest":{"properties":{"endpoint_url":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}],"title":"Endpoint Url"},"provider_slug":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"Provider Slug"},"label":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Label"},"scopes":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Scopes"},"key_custody":{"type":"string","title":"Key Custody","default":"server"},"request_offline":{"type":"boolean","title":"Request Offline","default":true},"login_hint":{"anyOf":[{"type":"string","format":"email"},{"type":"null"}],"title":"Login Hint"},"return_to":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Return To"},"authorization_endpoint":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Authorization Endpoint"},"token_endpoint":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Token Endpoint"},"registration_endpoint":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Registration Endpoint"},"revocation_endpoint":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Revocation Endpoint"},"client_id":{"anyOf":[{"type":"string","maxLength":512},{"type":"null"}],"title":"Client Id"},"client_secret":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Client Secret"}},"type":"object","title":"OAuthStartRequest","description":"Begin connecting a third-party MCP server via OAuth (auth-code + PKCE).\n\nDelegate auto-discovers the provider's authorization server from\n``endpoint_url`` and dynamically registers a client. The fallback fields\n(``authorization_endpoint`` / ``token_endpoint`` / ``client_id`` /\n``client_secret``) let the user configure a provider that supports neither\ndiscovery nor dynamic registration.\n\nAlternatively ``provider_slug`` names a library integration: the endpoint,\nlabel, scopes, and any known endpoint overrides or operator-registered\nclient come from the catalog entry instead. Operator clients accept only\nthe catalog's approved HTTPS OAuth endpoints. Custom OAuth endpoints require\nyour own client_id (and client_secret for a confidential client); credentials\nare never mixed with the operator's client."},"OAuthStartResponse":{"properties":{"authorization_url":{"type":"string","title":"Authorization Url"},"redirect_uri":{"type":"string","title":"Redirect Uri"}},"type":"object","required":["authorization_url","redirect_uri"],"title":"OAuthStartResponse"},"ObservabilityAgentAuthCacheMetrics":{"properties":{"started_at":{"type":"string","format":"date-time","title":"Started At"},"active":{"type":"boolean","title":"Active"},"mode":{"type":"string","title":"Mode"},"redis_url_configured":{"type":"boolean","title":"Redis Url Configured"},"ttl_seconds":{"type":"integer","title":"Ttl Seconds"},"get_attempts":{"type":"integer","title":"Get Attempts"},"get_hits":{"type":"integer","title":"Get Hits"},"get_misses":{"type":"integer","title":"Get Misses"},"get_errors":{"type":"integer","title":"Get Errors"},"get_hit_ratio":{"type":"number","title":"Get Hit Ratio"},"set_attempts":{"type":"integer","title":"Set Attempts"},"set_successes":{"type":"integer","title":"Set Successes"},"set_errors":{"type":"integer","title":"Set Errors"},"invalidation_attempts":{"type":"integer","title":"Invalidation Attempts"},"invalidation_successes":{"type":"integer","title":"Invalidation Successes"},"invalidation_errors":{"type":"integer","title":"Invalidation Errors"}},"type":"object","required":["started_at","active","mode","redis_url_configured","ttl_seconds","get_attempts","get_hits","get_misses","get_errors","get_hit_ratio","set_attempts","set_successes","set_errors","invalidation_attempts","invalidation_successes","invalidation_errors"],"title":"ObservabilityAgentAuthCacheMetrics"},"ObservabilityAuth":{"properties":{"login_failed":{"type":"integer","title":"Login Failed"},"login_failed_distinct_ips":{"type":"integer","title":"Login Failed Distinct Ips"}},"type":"object","required":["login_failed","login_failed_distinct_ips"],"title":"ObservabilityAuth"},"ObservabilityDatabase":{"properties":{"pool_size":{"type":"integer","title":"Pool Size"},"max_overflow":{"type":"integer","title":"Max Overflow"},"capacity":{"type":"integer","title":"Capacity"},"checked_out":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Checked Out"},"checked_in":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Checked In"},"overflow":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Overflow"},"usage_ratio":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Usage Ratio"},"max_checked_out":{"type":"integer","title":"Max Checked Out"},"checkouts_total":{"type":"integer","title":"Checkouts Total"},"checkins_total":{"type":"integer","title":"Checkins Total"},"long_checkouts_total":{"type":"integer","title":"Long Checkouts Total"},"high_occupancy_events_total":{"type":"integer","title":"High Occupancy Events Total"},"last_checkout_seconds":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Last Checkout Seconds"},"last_long_checkout_seconds":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Last Long Checkout Seconds"},"last_long_checkout_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Long Checkout At"},"pool_timeout_seconds":{"type":"integer","title":"Pool Timeout Seconds"},"long_checkout_threshold_seconds":{"type":"number","title":"Long Checkout Threshold Seconds"},"occupancy_warn_ratio":{"type":"number","title":"Occupancy Warn Ratio"},"hot_paths":{"items":{"$ref":"#/components/schemas/ObservabilityDatabaseHotPath"},"type":"array","title":"Hot Paths"}},"type":"object","required":["pool_size","max_overflow","capacity","max_checked_out","checkouts_total","checkins_total","long_checkouts_total","high_occupancy_events_total","pool_timeout_seconds","long_checkout_threshold_seconds","occupancy_warn_ratio"],"title":"ObservabilityDatabase"},"ObservabilityDatabaseHotPath":{"properties":{"key":{"type":"string","title":"Key"},"label":{"type":"string","title":"Label"},"source":{"type":"string","title":"Source","default":"runtime"},"calls":{"type":"integer","title":"Calls"},"rows_read":{"type":"integer","title":"Rows Read"},"estimated_db_bytes":{"type":"integer","title":"Estimated Db Bytes"},"estimated_response_bytes":{"type":"integer","title":"Estimated Response Bytes"},"avg_estimated_db_bytes":{"type":"integer","title":"Avg Estimated Db Bytes"},"avg_estimated_response_bytes":{"type":"integer","title":"Avg Estimated Response Bytes"},"last_seen_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Seen At"}},"type":"object","required":["key","label","calls","rows_read","estimated_db_bytes","estimated_response_bytes","avg_estimated_db_bytes","avg_estimated_response_bytes"],"title":"ObservabilityDatabaseHotPath"},"ObservabilityDispatch":{"properties":{"pending_jobs":{"type":"integer","title":"Pending Jobs"},"oldest_pending_seconds":{"type":"integer","title":"Oldest Pending Seconds"},"dispatch_failed_jobs":{"type":"integer","title":"Dispatch Failed Jobs"},"mcp_failures":{"type":"integer","title":"Mcp Failures"},"webhook_failures":{"type":"integer","title":"Webhook Failures"},"webhook_retry_count":{"type":"integer","title":"Webhook Retry Count"},"pending_job_polling":{"anyOf":[{"$ref":"#/components/schemas/ObservabilityPendingJobPolling"},{"type":"null"}]}},"type":"object","required":["pending_jobs","oldest_pending_seconds","dispatch_failed_jobs","mcp_failures","webhook_failures","webhook_retry_count"],"title":"ObservabilityDispatch"},"ObservabilityDisputes":{"properties":{"open":{"type":"integer","title":"Open"},"created":{"type":"integer","title":"Created"},"resolved":{"type":"integer","title":"Resolved"},"dispute_rate":{"type":"number","title":"Dispute Rate"}},"type":"object","required":["open","created","resolved","dispute_rate"],"title":"ObservabilityDisputes"},"ObservabilityEmbeddings":{"properties":{"service_vectors_loaded":{"type":"integer","title":"Service Vectors Loaded"},"term_vectors_loaded":{"type":"integer","title":"Term Vectors Loaded"},"last_sync_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Sync At"},"last_sync_error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Sync Error"},"last_sync_job_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Sync Job Id"},"last_sync_job_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Sync Job Type"},"last_sync_job_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Sync Job Reason"},"last_sync_job_attempts":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Last Sync Job Attempts"},"last_sync_worker_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Sync Worker Id"},"index_status":{"type":"string","title":"Index Status"},"index_versions":{"items":{"$ref":"#/components/schemas/ObservabilityIndexVersion"},"type":"array","title":"Index Versions"},"semantic_search_ready":{"type":"boolean","title":"Semantic Search Ready","default":false},"semantic_readiness_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Semantic Readiness Reason"},"active_services":{"type":"integer","title":"Active Services","default":0},"persisted_service_vectors":{"type":"integer","title":"Persisted Service Vectors","default":0},"missing_service_vectors":{"type":"integer","title":"Missing Service Vectors","default":0},"stale_service_vectors":{"type":"integer","title":"Stale Service Vectors","default":0},"invalid_service_vectors":{"type":"integer","title":"Invalid Service Vectors","default":0},"runtime_missing_service_vectors":{"type":"integer","title":"Runtime Missing Service Vectors","default":0},"dimension_mismatch_service_vectors":{"type":"integer","title":"Dimension Mismatch Service Vectors","default":0}},"type":"object","required":["service_vectors_loaded","term_vectors_loaded","index_status"],"title":"ObservabilityEmbeddings"},"ObservabilityIndexVersion":{"properties":{"index_name":{"type":"string","title":"Index Name"},"database_version":{"type":"integer","title":"Database Version"},"runtime_loaded_version":{"type":"integer","title":"Runtime Loaded Version"},"is_loaded":{"type":"boolean","title":"Is Loaded"},"is_stale":{"type":"boolean","title":"Is Stale"}},"type":"object","required":["index_name","database_version","runtime_loaded_version","is_loaded","is_stale"],"title":"ObservabilityIndexVersion"},"ObservabilityPendingJobPolling":{"properties":{"started_at":{"type":"string","format":"date-time","title":"Started At"},"requests":{"type":"integer","title":"Requests"},"short_poll_requests":{"type":"integer","title":"Short Poll Requests"},"long_poll_requests":{"type":"integer","title":"Long Poll Requests"},"postgres_fetches":{"type":"integer","title":"Postgres Fetches"},"postgres_empty_fetches":{"type":"integer","title":"Postgres Empty Fetches"},"postgres_jobs_fetches":{"type":"integer","title":"Postgres Jobs Fetches"},"jobs_returned":{"type":"integer","title":"Jobs Returned"},"estimated_response_bytes_returned":{"type":"integer","title":"Estimated Response Bytes Returned"},"empty_responses":{"type":"integer","title":"Empty Responses"},"long_poll_waits":{"type":"integer","title":"Long Poll Waits"},"long_poll_notification_wakeups":{"type":"integer","title":"Long Poll Notification Wakeups"},"long_poll_timeouts":{"type":"integer","title":"Long Poll Timeouts"},"long_poll_cancelled":{"type":"integer","title":"Long Poll Cancelled"},"long_poll_post_wait_fetches":{"type":"integer","title":"Long Poll Post Wait Fetches"},"redis_hint_set_attempts":{"type":"integer","title":"Redis Hint Set Attempts"},"redis_hint_set_successes":{"type":"integer","title":"Redis Hint Set Successes"},"redis_hint_set_failures":{"type":"integer","title":"Redis Hint Set Failures"},"redis_wakeup_publish_attempts":{"type":"integer","title":"Redis Wakeup Publish Attempts"},"redis_wakeup_publish_successes":{"type":"integer","title":"Redis Wakeup Publish Successes"},"redis_wakeup_publish_failures":{"type":"integer","title":"Redis Wakeup Publish Failures"},"redis_gate_requests":{"type":"integer","title":"Redis Gate Requests"},"redis_gate_fallbacks":{"type":"integer","title":"Redis Gate Fallbacks"},"redis_hint_hits":{"type":"integer","title":"Redis Hint Hits"},"redis_hint_misses":{"type":"integer","title":"Redis Hint Misses"},"redis_hint_read_failures":{"type":"integer","title":"Redis Hint Read Failures"},"redis_safety_check_claims":{"type":"integer","title":"Redis Safety Check Claims"},"redis_safety_check_skips":{"type":"integer","title":"Redis Safety Check Skips"},"redis_safety_check_failures":{"type":"integer","title":"Redis Safety Check Failures"},"redis_idle_timeouts_without_postgres":{"type":"integer","title":"Redis Idle Timeouts Without Postgres"},"redis_shadow_requests":{"type":"integer","title":"Redis Shadow Requests"},"redis_shadow_hint_hits":{"type":"integer","title":"Redis Shadow Hint Hits"},"redis_shadow_hint_misses":{"type":"integer","title":"Redis Shadow Hint Misses"},"redis_shadow_hint_read_failures":{"type":"integer","title":"Redis Shadow Hint Read Failures"},"redis_shadow_hint_hit_empty_fetches":{"type":"integer","title":"Redis Shadow Hint Hit Empty Fetches"},"redis_shadow_hint_miss_job_fetches":{"type":"integer","title":"Redis Shadow Hint Miss Job Fetches"}},"type":"object","required":["started_at","requests","short_poll_requests","long_poll_requests","postgres_fetches","postgres_empty_fetches","postgres_jobs_fetches","jobs_returned","estimated_response_bytes_returned","empty_responses","long_poll_waits","long_poll_notification_wakeups","long_poll_timeouts","long_poll_cancelled","long_poll_post_wait_fetches","redis_hint_set_attempts","redis_hint_set_successes","redis_hint_set_failures","redis_wakeup_publish_attempts","redis_wakeup_publish_successes","redis_wakeup_publish_failures","redis_gate_requests","redis_gate_fallbacks","redis_hint_hits","redis_hint_misses","redis_hint_read_failures","redis_safety_check_claims","redis_safety_check_skips","redis_safety_check_failures","redis_idle_timeouts_without_postgres","redis_shadow_requests","redis_shadow_hint_hits","redis_shadow_hint_misses","redis_shadow_hint_read_failures","redis_shadow_hint_hit_empty_fetches","redis_shadow_hint_miss_job_fetches"],"title":"ObservabilityPendingJobPolling"},"ObservabilityPresence":{"properties":{"backend":{"type":"string","title":"Backend"},"configured":{"type":"boolean","title":"Configured"},"available":{"type":"boolean","title":"Available"},"redis_url_configured":{"type":"boolean","title":"Redis Url Configured"},"detail":{"type":"string","title":"Detail"},"heartbeat_seconds":{"type":"integer","title":"Heartbeat Seconds"},"timeout_seconds":{"type":"integer","title":"Timeout Seconds"},"snapshot_seconds":{"type":"integer","title":"Snapshot Seconds"},"checked_at":{"type":"string","format":"date-time","title":"Checked At"},"metrics":{"$ref":"#/components/schemas/ObservabilityPresenceMetrics"},"agent_auth_cache":{"$ref":"#/components/schemas/ObservabilityAgentAuthCacheMetrics"}},"type":"object","required":["backend","configured","available","redis_url_configured","detail","heartbeat_seconds","timeout_seconds","snapshot_seconds","checked_at","metrics","agent_auth_cache"],"title":"ObservabilityPresence"},"ObservabilityPresenceMetrics":{"properties":{"started_at":{"type":"string","format":"date-time","title":"Started At"},"heartbeat_attempts":{"type":"integer","title":"Heartbeat Attempts"},"heartbeat_successes":{"type":"integer","title":"Heartbeat Successes"},"heartbeat_failures":{"type":"integer","title":"Heartbeat Failures"},"durable_snapshot_writes":{"type":"integer","title":"Durable Snapshot Writes"},"durable_snapshot_skips":{"type":"integer","title":"Durable Snapshot Skips"},"durable_snapshot_write_ratio":{"type":"number","title":"Durable Snapshot Write Ratio"},"redis_operation_count":{"type":"integer","title":"Redis Operation Count"},"redis_error_count":{"type":"integer","title":"Redis Error Count"},"redis_avg_latency_ms":{"type":"number","title":"Redis Avg Latency Ms"},"redis_p95_latency_ms":{"type":"number","title":"Redis P95 Latency Ms"},"redis_last_error_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Redis Last Error At"},"redis_last_error_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Redis Last Error Type"},"redis_missing_payload_reads":{"type":"integer","title":"Redis Missing Payload Reads"},"redis_stale_payload_reads":{"type":"integer","title":"Redis Stale Payload Reads"},"redis_fallback_reads":{"type":"integer","title":"Redis Fallback Reads"},"snapshot_due_marks":{"type":"integer","title":"Snapshot Due Marks"},"snapshot_due_mark_failures":{"type":"integer","title":"Snapshot Due Mark Failures"},"snapshot_bucket_run_successes":{"type":"integer","title":"Snapshot Bucket Run Successes"},"snapshot_bucket_run_failures":{"type":"integer","title":"Snapshot Bucket Run Failures"},"snapshot_bucket_lock_skips":{"type":"integer","title":"Snapshot Bucket Lock Skips"},"snapshot_bucket_agents_scanned":{"type":"integer","title":"Snapshot Bucket Agents Scanned"},"snapshot_bucket_agents_processed":{"type":"integer","title":"Snapshot Bucket Agents Processed"},"snapshot_bucket_missing_metadata":{"type":"integer","title":"Snapshot Bucket Missing Metadata"},"snapshot_bucket_avg_processed_count":{"type":"number","title":"Snapshot Bucket Avg Processed Count"},"snapshot_bucket_oldest_lag_seconds":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Snapshot Bucket Oldest Lag Seconds"},"snapshot_postgres_persisted":{"type":"integer","title":"Snapshot Postgres Persisted"},"snapshot_postgres_skipped":{"type":"integer","title":"Snapshot Postgres Skipped"},"snapshot_postgres_rejected":{"type":"integer","title":"Snapshot Postgres Rejected"},"snapshot_postgres_unsupported_reason_count":{"type":"integer","title":"Snapshot Postgres Unsupported Reason Count"},"offline_bucket_run_successes":{"type":"integer","title":"Offline Bucket Run Successes"},"offline_bucket_run_failures":{"type":"integer","title":"Offline Bucket Run Failures"},"offline_bucket_lock_skips":{"type":"integer","title":"Offline Bucket Lock Skips"},"offline_bucket_candidates_scanned":{"type":"integer","title":"Offline Bucket Candidates Scanned"},"offline_bucket_live_reschedules":{"type":"integer","title":"Offline Bucket Live Reschedules"},"offline_bucket_agents_processed":{"type":"integer","title":"Offline Bucket Agents Processed"},"offline_bucket_avg_processed_count":{"type":"number","title":"Offline Bucket Avg Processed Count"},"offline_bucket_oldest_lag_seconds":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Offline Bucket Oldest Lag Seconds"},"offline_postgres_persisted":{"type":"integer","title":"Offline Postgres Persisted"},"offline_postgres_skipped":{"type":"integer","title":"Offline Postgres Skipped"},"offline_postgres_rejected":{"type":"integer","title":"Offline Postgres Rejected"}},"type":"object","required":["started_at","heartbeat_attempts","heartbeat_successes","heartbeat_failures","durable_snapshot_writes","durable_snapshot_skips","durable_snapshot_write_ratio","redis_operation_count","redis_error_count","redis_avg_latency_ms","redis_p95_latency_ms","redis_missing_payload_reads","redis_stale_payload_reads","redis_fallback_reads","snapshot_due_marks","snapshot_due_mark_failures","snapshot_bucket_run_successes","snapshot_bucket_run_failures","snapshot_bucket_lock_skips","snapshot_bucket_agents_scanned","snapshot_bucket_agents_processed","snapshot_bucket_missing_metadata","snapshot_bucket_avg_processed_count","snapshot_postgres_persisted","snapshot_postgres_skipped","snapshot_postgres_rejected","snapshot_postgres_unsupported_reason_count","offline_bucket_run_successes","offline_bucket_run_failures","offline_bucket_lock_skips","offline_bucket_candidates_scanned","offline_bucket_live_reschedules","offline_bucket_agents_processed","offline_bucket_avg_processed_count","offline_postgres_persisted","offline_postgres_skipped","offline_postgres_rejected"],"title":"ObservabilityPresenceMetrics"},"ObservabilitySearch":{"properties":{"count":{"type":"integer","title":"Count"},"avg_latency_ms":{"type":"integer","title":"Avg Latency Ms"},"p95_latency_ms":{"type":"integer","title":"P95 Latency Ms"},"no_match_rate":{"type":"number","title":"No Match Rate"},"degraded_count":{"type":"integer","title":"Degraded Count"},"readiness_check_count":{"type":"integer","title":"Readiness Check Count","default":0},"avg_readiness_latency_ms":{"type":"integer","title":"Avg Readiness Latency Ms","default":0},"readiness_degraded_count":{"type":"integer","title":"Readiness Degraded Count","default":0},"readiness_embedding_rows_read":{"type":"integer","title":"Readiness Embedding Rows Read","default":0},"readiness_vector_dimensions_read":{"type":"integer","title":"Readiness Vector Dimensions Read","default":0},"readiness_estimated_vector_json_bytes":{"type":"integer","title":"Readiness Estimated Vector Json Bytes","default":0}},"type":"object","required":["count","avg_latency_ms","p95_latency_ms","no_match_rate","degraded_count"],"title":"ObservabilitySearch"},"ObservabilitySummary":{"properties":{"window":{"$ref":"#/components/schemas/ObservabilityWindow"},"search":{"$ref":"#/components/schemas/ObservabilitySearch"},"embeddings":{"$ref":"#/components/schemas/ObservabilityEmbeddings"},"dispatch":{"$ref":"#/components/schemas/ObservabilityDispatch"},"disputes":{"$ref":"#/components/schemas/ObservabilityDisputes"},"database":{"$ref":"#/components/schemas/ObservabilityDatabase"},"presence":{"$ref":"#/components/schemas/ObservabilityPresence"},"auth":{"$ref":"#/components/schemas/ObservabilityAuth"},"youtube_transcripts":{"$ref":"#/components/schemas/ObservabilityYoutubeTranscripts"},"usage_adjusted":{"$ref":"#/components/schemas/ObservabilityUsageAdjusted"}},"type":"object","required":["window","search","embeddings","dispatch","disputes","database","presence","auth","youtube_transcripts","usage_adjusted"],"title":"ObservabilitySummary"},"ObservabilityTrendPoint":{"properties":{"date":{"type":"string","title":"Date"},"dispatch_attempts":{"type":"integer","title":"Dispatch Attempts"},"dispatch_failures":{"type":"integer","title":"Dispatch Failures"},"failure_rate":{"type":"number","title":"Failure Rate"},"provider_net_micros":{"type":"integer","title":"Provider Net Micros"},"completed_jobs":{"type":"integer","title":"Completed Jobs"}},"type":"object","required":["date","dispatch_attempts","dispatch_failures","failure_rate","provider_net_micros","completed_jobs"],"title":"ObservabilityTrendPoint","description":"One UTC day of provider activity: dispatch, revenue, and completions."},"ObservabilityUsageAdjusted":{"properties":{"contracts_accepted":{"type":"integer","title":"Contracts Accepted"},"contracts_rejected":{"type":"integer","title":"Contracts Rejected"},"reports_received":{"type":"integer","title":"Reports Received"},"reports_superseded":{"type":"integer","title":"Reports Superseded"},"reports_rejected":{"type":"integer","title":"Reports Rejected"},"report_retries":{"type":"integer","title":"Report Retries"},"evidence_failures":{"type":"integer","title":"Evidence Failures"},"review_expired":{"type":"integer","title":"Review Expired"},"disputed":{"type":"integer","title":"Disputed"},"dispute_rate":{"type":"number","title":"Dispute Rate"},"provider_responses":{"type":"integer","title":"Provider Responses"},"settled":{"type":"integer","title":"Settled"},"buyer_settled":{"type":"integer","title":"Buyer Settled"},"admin_settled":{"type":"integer","title":"Admin Settled"},"system_settled":{"type":"integer","title":"System Settled","default":0},"full_refunds":{"type":"integer","title":"Full Refunds"},"cap_exhausted_reports":{"type":"integer","title":"Cap Exhausted Reports"},"formula_above_cap_reports":{"type":"integer","title":"Formula Above Cap Reports"},"report_latency_samples":{"type":"integer","title":"Report Latency Samples"},"report_latency_p95_seconds":{"type":"integer","title":"Report Latency P95 Seconds"},"reported_quantity":{"type":"integer","title":"Reported Quantity"},"supported_quantity":{"type":"integer","title":"Supported Quantity"},"supported_to_reported_ratio":{"type":"number","title":"Supported To Reported Ratio"},"approved_cap_micros":{"type":"integer","title":"Approved Cap Micros"},"proposed_gross_micros":{"type":"integer","title":"Proposed Gross Micros"},"settled_gross_micros":{"type":"integer","title":"Settled Gross Micros"},"buyer_refund_micros":{"type":"integer","title":"Buyer Refund Micros"},"full_refund_micros":{"type":"integer","title":"Full Refund Micros"},"settlement_delta_micros":{"type":"integer","title":"Settlement Delta Micros"},"reconciliation_failures":{"type":"integer","title":"Reconciliation Failures"},"alerts":{"items":{"$ref":"#/components/schemas/ObservabilityUsageAdjustedAlert"},"type":"array","title":"Alerts"}},"type":"object","required":["contracts_accepted","contracts_rejected","reports_received","reports_superseded","reports_rejected","report_retries","evidence_failures","review_expired","disputed","dispute_rate","provider_responses","settled","buyer_settled","admin_settled","full_refunds","cap_exhausted_reports","formula_above_cap_reports","report_latency_samples","report_latency_p95_seconds","reported_quantity","supported_quantity","supported_to_reported_ratio","approved_cap_micros","proposed_gross_micros","settled_gross_micros","buyer_refund_micros","full_refund_micros","settlement_delta_micros","reconciliation_failures"],"title":"ObservabilityUsageAdjusted"},"ObservabilityUsageAdjustedAlert":{"properties":{"code":{"type":"string","title":"Code"},"severity":{"type":"string","enum":["warning","critical"],"title":"Severity"},"value":{"type":"number","title":"Value"},"threshold":{"type":"number","title":"Threshold"},"unit":{"type":"string","title":"Unit"},"message":{"type":"string","title":"Message"}},"type":"object","required":["code","severity","value","threshold","unit","message"],"title":"ObservabilityUsageAdjustedAlert"},"ObservabilityWindow":{"properties":{"since":{"type":"string","format":"date-time","title":"Since"},"until":{"type":"string","format":"date-time","title":"Until"}},"type":"object","required":["since","until"],"title":"ObservabilityWindow"},"ObservabilityYoutubeTranscripts":{"properties":{"request_count":{"type":"integer","title":"Request Count"},"successes":{"type":"integer","title":"Successes"},"failures":{"type":"integer","title":"Failures"},"success_rate":{"type":"number","title":"Success Rate"},"successful_p95_latency_ms":{"type":"integer","title":"Successful P95 Latency Ms"},"successful_network_count":{"type":"integer","title":"Successful Network Count"},"successful_network_p95_latency_ms":{"type":"integer","title":"Successful Network P95 Latency Ms"},"successful_network_within_15s_rate":{"type":"number","title":"Successful Network Within 15S Rate"},"cache_hits":{"type":"integer","title":"Cache Hits"},"cache_hit_rate":{"type":"number","title":"Cache Hit Rate"},"queue_delay_p95_ms":{"type":"integer","title":"Queue Delay P95 Ms"},"deadline_exhaustions":{"type":"integer","title":"Deadline Exhaustions"},"failure_classes":{"additionalProperties":{"type":"integer"},"type":"object","title":"Failure Classes"},"failure_types":{"additionalProperties":{"type":"integer"},"type":"object","title":"Failure Types"},"routes":{"additionalProperties":{"type":"integer"},"type":"object","title":"Routes"},"observed_days":{"type":"integer","title":"Observed Days"},"consecutive_observed_days":{"type":"integer","title":"Consecutive Observed Days"},"first_observed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"First Observed At"},"last_observed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Observed At"}},"type":"object","required":["request_count","successes","failures","success_rate","successful_p95_latency_ms","successful_network_count","successful_network_p95_latency_ms","successful_network_within_15s_rate","cache_hits","cache_hit_rate","queue_delay_p95_ms","deadline_exhaustions","observed_days","consecutive_observed_days"],"title":"ObservabilityYoutubeTranscripts"},"OfferDefinition":{"properties":{"schema_version":{"type":"integer","const":2,"title":"Schema Version","default":2},"offer_key":{"type":"string","maxLength":100,"minLength":1,"title":"Offer Key"},"title":{"type":"string","maxLength":200,"minLength":1,"title":"Title"},"description":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Description"},"scope":{"$ref":"#/components/schemas/CommercialScopeSchema"},"price":{"$ref":"#/components/schemas/PriceSpec"},"funding":{"oneOf":[{"$ref":"#/components/schemas/ExactFundingPolicy"},{"$ref":"#/components/schemas/BuyerCapFundingPolicy"}],"title":"Funding","discriminator":{"propertyName":"kind","mapping":{"buyer_cap":"#/components/schemas/BuyerCapFundingPolicy","exact":"#/components/schemas/ExactFundingPolicy"}}},"fulfillment":{"oneOf":[{"$ref":"#/components/schemas/TaskFulfillmentPolicy"},{"$ref":"#/components/schemas/EntitlementFulfillmentPolicy"}],"title":"Fulfillment","discriminator":{"propertyName":"kind","mapping":{"entitlement":"#/components/schemas/EntitlementFulfillmentPolicy","task":"#/components/schemas/TaskFulfillmentPolicy"}}},"settlement":{"oneOf":[{"$ref":"#/components/schemas/TaskAcceptanceSettlementPolicy"},{"$ref":"#/components/schemas/ConsumptionProportionalSettlementPolicy"},{"$ref":"#/components/schemas/UsageAdjustedSettlementPolicy"}],"title":"Settlement","discriminator":{"propertyName":"kind","mapping":{"consumption_proportional":"#/components/schemas/ConsumptionProportionalSettlementPolicy","task_acceptance":"#/components/schemas/TaskAcceptanceSettlementPolicy","usage_adjusted":"#/components/schemas/UsageAdjustedSettlementPolicy"}}},"fees":{"$ref":"#/components/schemas/FeeTerms"},"validity":{"$ref":"#/components/schemas/OfferValidity"},"refund_policy":{"anyOf":[{"$ref":"#/components/schemas/PolicyReference"},{"type":"null"}]},"dispute_policy":{"anyOf":[{"$ref":"#/components/schemas/PolicyReference"},{"type":"null"}]}},"additionalProperties":false,"type":"object","required":["offer_key","title","scope","price","funding","fulfillment","settlement","fees"],"title":"OfferDefinition"},"OfferPricePreviewRequest":{"properties":{"scope":{"additionalProperties":true,"type":"object","title":"Scope"},"task":{"anyOf":[{"$ref":"#/components/schemas/OrderTask"},{"type":"null"}],"description":"Required for task/batch offers: the quote signs the final task. Batch task.items entries need unique custom_id and input; len(items) must match scope[batch.count_scope_key]. Omit only for entitlement offers."},"artifact_binding_hashes":{"additionalProperties":{"type":"string"},"type":"object","maxProperties":100,"title":"Artifact Binding Hashes"}},"additionalProperties":false,"type":"object","title":"OfferPricePreviewRequest"},"OfferPricePreviewResponse":{"properties":{"offer_version_id":{"type":"string","title":"Offer Version Id"},"offer_definition_hash":{"type":"string","title":"Offer Definition Hash"},"funding":{"oneOf":[{"$ref":"#/components/schemas/ExactFundingPolicy"},{"$ref":"#/components/schemas/BuyerCapFundingPolicy"}],"title":"Funding","discriminator":{"propertyName":"kind","mapping":{"buyer_cap":"#/components/schemas/BuyerCapFundingPolicy","exact":"#/components/schemas/ExactFundingPolicy"}}},"canonical_scope":{"additionalProperties":{"anyOf":[{"type":"integer"},{"type":"string"}]},"type":"object","title":"Canonical Scope"},"artifact_binding_hashes":{"additionalProperties":{"type":"string"},"type":"object","title":"Artifact Binding Hashes"},"trusted_measurements":{"additionalProperties":{"anyOf":[{"type":"integer"},{"type":"string"}]},"type":"object","title":"Trusted Measurements"},"measurement_evidence":{"additionalProperties":{"$ref":"#/components/schemas/TrustedMeasurementEvidence"},"type":"object","title":"Measurement Evidence"},"resolution":{"$ref":"#/components/schemas/PriceResolution"},"pricing_resolution_id":{"type":"string","title":"Pricing Resolution Id"},"pricing_resolution_token":{"type":"string","title":"Pricing Resolution Token"},"expires_at":{"type":"string","format":"date-time","title":"Expires At"},"queue":{"anyOf":[{"$ref":"#/components/schemas/ServiceQueueSnapshot"},{"type":"null"}]}},"additionalProperties":false,"type":"object","required":["offer_version_id","offer_definition_hash","funding","canonical_scope","resolution","pricing_resolution_id","pricing_resolution_token","expires_at"],"title":"OfferPricePreviewResponse"},"OfferValidity":{"properties":{"available_from":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Available From"},"available_until":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Available Until"}},"additionalProperties":false,"type":"object","title":"OfferValidity"},"OrchestrationEdge":{"properties":{"id":{"type":"string","title":"Id"},"source":{"type":"string","title":"Source"},"target":{"type":"string","title":"Target"},"label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Label"}},"type":"object","required":["id","source","target"],"title":"OrchestrationEdge"},"OrchestrationGraphResponse":{"properties":{"root_id":{"type":"string","title":"Root Id"},"node_count":{"type":"integer","title":"Node Count"},"max_depth":{"type":"integer","title":"Max Depth"},"truncated":{"type":"boolean","title":"Truncated"},"root_billing":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Root Billing"},"root_run":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Root Run"},"nodes":{"items":{"$ref":"#/components/schemas/OrchestrationNode"},"type":"array","title":"Nodes"},"edges":{"items":{"$ref":"#/components/schemas/OrchestrationEdge"},"type":"array","title":"Edges"}},"type":"object","required":["root_id","node_count","max_depth","truncated","nodes","edges"],"title":"OrchestrationGraphResponse"},"OrchestrationNode":{"properties":{"id":{"type":"string","title":"Id"},"parent_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Parent Id"},"depth":{"type":"integer","title":"Depth"},"step_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Step Label"},"service_title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Service Title"},"provider_display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provider Display Name"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"escrow_locked_micros":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Escrow Locked Micros"},"billable_micros":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Billable Micros"},"cost_micros":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Cost Micros"},"settlement":{"anyOf":[{"$ref":"#/components/schemas/SettlementSummaryPayload"},{"type":"null"}]},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated At"},"delivered_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Delivered At"},"duration_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Duration Ms"},"task_summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Task Summary"},"latest_response_preview":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Latest Response Preview"},"has_children":{"type":"boolean","title":"Has Children","default":false},"failed_step":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Failed Step"},"error_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Type"},"critique":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Critique"},"missing":{"type":"boolean","title":"Missing","default":false}},"type":"object","required":["id","depth"],"title":"OrchestrationNode","description":"One conversation in an orchestrator's call tree (root = the parent)."},"OrderAttachment":{"properties":{"uri":{"type":"string","maxLength":2000,"minLength":1,"title":"Uri"},"input_name":{"type":"string","maxLength":100,"minLength":1,"title":"Input Name"}},"additionalProperties":false,"type":"object","required":["uri","input_name"],"title":"OrderAttachment"},"OrderCreate":{"properties":{"schema_version":{"type":"integer","const":2,"title":"Schema Version","default":2},"offer_version_id":{"type":"string","maxLength":200,"minLength":1,"title":"Offer Version Id"},"scope":{"additionalProperties":true,"type":"object","title":"Scope"},"task":{"anyOf":[{"$ref":"#/components/schemas/OrderTask"},{"type":"null"}]},"artifact_binding_hashes":{"additionalProperties":{"type":"string"},"type":"object","maxProperties":100,"title":"Artifact Binding Hashes"},"pricing_resolution_id":{"anyOf":[{"type":"string","maxLength":200,"minLength":1},{"type":"null"}],"title":"Pricing Resolution Id"},"pricing_resolution_token":{"anyOf":[{"type":"string","maxLength":4096,"minLength":1},{"type":"null"}],"title":"Pricing Resolution Token"},"buyer_cap_micros":{"anyOf":[{"type":"integer","maximum":9007199254740991.0,"minimum":0.0},{"type":"null"}],"title":"Buyer Cap Micros","description":"Required only when the quote's funding.kind is buyer_cap: the maximum authorized amount in USD micros (1 USD = 1,000,000 micros). Must be within funding.minimum_cap_micros and funding.maximum_cap_micros and at least resolution.total_micros. Omit for funding.kind exact; the signed quote fixes the funding amount and supplying a cap is rejected."},"idempotency_key":{"anyOf":[{"type":"string","maxLength":200,"minLength":8},{"type":"null"}],"title":"Idempotency Key","description":"Optional. Leave it out and the signed quote keys the order: submitting the same quote twice without a key returns the same order, and different quotes never collide. A key you choose yourself persists per buyer across sessions and must be unique per order."},"execution_context":{"$ref":"#/components/schemas/OrderExecutionContext"}},"additionalProperties":false,"type":"object","required":["offer_version_id"],"title":"OrderCreate"},"OrderExecutionContext":{"properties":{"task_group_id":{"anyOf":[{"type":"string","maxLength":36,"minLength":1},{"type":"null"}],"title":"Task Group Id"},"search_id":{"anyOf":[{"type":"string","maxLength":200,"minLength":1},{"type":"null"}],"title":"Search Id"},"parent_job_id":{"anyOf":[{"type":"string","maxLength":200,"minLength":1},{"type":"null"}],"title":"Parent Job Id"},"file_contract_hash":{"anyOf":[{"type":"string","maxLength":200,"minLength":1},{"type":"null"}],"title":"File Contract Hash"},"workspace_access":{"items":{"anyOf":[{"type":"string"},{"$ref":"#/components/schemas/WorkspaceAccessGrant"}]},"type":"array","maxItems":100,"title":"Workspace Access"}},"additionalProperties":false,"type":"object","title":"OrderExecutionContext"},"OrderRecord":{"properties":{"schema_version":{"type":"integer","const":2,"title":"Schema Version","default":2},"order_id":{"type":"string","maxLength":200,"minLength":1,"title":"Order Id"},"buyer_id":{"type":"string","maxLength":200,"minLength":1,"title":"Buyer Id"},"acting_agent_id":{"anyOf":[{"type":"string","maxLength":200,"minLength":1},{"type":"null"}],"title":"Acting Agent Id"},"service_id":{"type":"string","maxLength":200,"minLength":1,"title":"Service Id"},"offer_version_id":{"type":"string","maxLength":200,"minLength":1,"title":"Offer Version Id"},"canonical_scope":{"additionalProperties":{"anyOf":[{"type":"integer"},{"type":"string"}]},"type":"object","title":"Canonical Scope"},"task":{"anyOf":[{"$ref":"#/components/schemas/OrderTask"},{"type":"null"}]},"pricing_resolution":{"$ref":"#/components/schemas/PriceResolution"},"funding_amount_micros":{"type":"integer","maximum":9007199254740991.0,"minimum":0.0,"title":"Funding Amount Micros"},"idempotency_key":{"type":"string","maxLength":200,"minLength":8,"title":"Idempotency Key"},"execution_context":{"$ref":"#/components/schemas/OrderExecutionContext"},"status":{"type":"string","enum":["created","awaiting_approval","funding","contracted","rejected","failed"],"title":"Status"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"additionalProperties":false,"type":"object","required":["order_id","buyer_id","service_id","offer_version_id","canonical_scope","pricing_resolution","funding_amount_micros","idempotency_key","status","created_at"],"title":"OrderRecord"},"OrderSubmitResponse":{"properties":{"order_id":{"type":"string","title":"Order Id"},"task_group_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Task Group Id"},"status":{"type":"string","enum":["awaiting_approval","contracted","rejected","failed"],"title":"Status"},"contract_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Contract Id"},"result":{"anyOf":[{"$ref":"#/components/schemas/TaskOrderResult"},{"$ref":"#/components/schemas/EntitlementOrderResult"},{"type":"null"}],"title":"Result"},"funding_amount_micros":{"type":"integer","maximum":9007199254740991.0,"minimum":0.0,"title":"Funding Amount Micros"},"approval_threshold_micros":{"anyOf":[{"type":"integer","maximum":9007199254740991.0,"minimum":0.0},{"type":"null"}],"title":"Approval Threshold Micros"}},"additionalProperties":false,"type":"object","required":["order_id","status","funding_amount_micros"],"title":"OrderSubmitResponse"},"OrderTask":{"properties":{"title":{"type":"string","maxLength":500,"minLength":1,"title":"Title"},"summary":{"type":"string","maxLength":5000,"minLength":1,"title":"Summary"},"input":{"additionalProperties":true,"type":"object","title":"Input"},"attachments":{"items":{"anyOf":[{"type":"string"},{"$ref":"#/components/schemas/OrderAttachment"}]},"type":"array","maxItems":100,"title":"Attachments"},"items":{"anyOf":[{"items":{"$ref":"#/components/schemas/OrderTaskItem"},"type":"array","maxItems":100,"minItems":1},{"type":"null"}],"title":"Items"}},"additionalProperties":false,"type":"object","required":["title","summary"],"title":"OrderTask"},"OrderTaskItem":{"properties":{"custom_id":{"type":"string","maxLength":200,"minLength":1,"title":"Custom Id"},"input":{"additionalProperties":true,"type":"object","title":"Input"}},"additionalProperties":false,"type":"object","required":["custom_id"],"title":"OrderTaskItem","description":"One line item in a batch order.\n\n``custom_id`` is the buyer's own correlation key: per-item results come\nback keyed by it, so a buyer never has to rely on ordering to match a\nresult to the thing it asked about."},"Outcomes":{"properties":{"finished_well":{"type":"integer","title":"Finished Well","default":0},"needs_you":{"type":"integer","title":"Needs You","default":0},"awaiting_approval":{"type":"integer","title":"Awaiting Approval","default":0},"gave_up":{"type":"integer","title":"Gave Up","default":0},"failed":{"type":"integer","title":"Failed","default":0},"hit_ai_budget":{"type":"integer","title":"Hit Ai Budget","default":0},"stopped":{"type":"integer","title":"Stopped","default":0},"in_progress":{"type":"integer","title":"In Progress","default":0}},"type":"object","title":"Outcomes"},"Pair":{"properties":{"current":{"type":"integer","title":"Current"},"prior":{"type":"integer","title":"Prior"}},"type":"object","required":["current","prior"],"title":"Pair"},"ParameterReference":{"properties":{"source":{"type":"string","enum":["scope","platform_measure","settlement_measure"],"title":"Source"},"key":{"type":"string","maxLength":100,"minLength":1,"title":"Key"}},"additionalProperties":false,"type":"object","required":["source","key"],"title":"ParameterReference","description":"One explicitly-provenanced input consumed by a pricing rule."},"ParameterizedPricingPreviewRequest":{"properties":{"task":{"$ref":"#/components/schemas/HireTask"},"quantity":{"anyOf":[{"$ref":"#/components/schemas/HireContractQuantity"},{"type":"null"}]},"acting_agent_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Acting Agent Id"},"parent_job_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Parent Job Id"},"workspace_access":{"anyOf":[{"items":{"anyOf":[{"type":"string"},{"$ref":"#/components/schemas/WorkspaceAccessGrant"}]},"type":"array"},{"type":"null"}],"title":"Workspace Access"}},"additionalProperties":false,"type":"object","required":["task"],"title":"ParameterizedPricingPreviewRequest","description":"Non-hiring inputs needed to price one parameterized hire."},"ParameterizedPricingPreviewResponse":{"properties":{"contract_type":{"type":"string","const":"parameterized","title":"Contract Type","default":"parameterized"},"amount_micros":{"type":"integer","minimum":0.0,"title":"Amount Micros"},"base_price_micros":{"type":"integer","minimum":0.0,"title":"Base Price Micros"},"pricing_breakdown":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Pricing Breakdown"},"service_pricing_revision":{"type":"string","title":"Service Pricing Revision"},"preview_token":{"type":"string","title":"Preview Token"},"expires_at":{"type":"string","format":"date-time","title":"Expires At"}},"additionalProperties":false,"type":"object","required":["amount_micros","base_price_micros","pricing_breakdown","service_pricing_revision","preview_token","expires_at"],"title":"ParameterizedPricingPreviewResponse"},"ParameterizedPricingSummary":{"properties":{"model":{"type":"string","const":"parameterized","title":"Model","default":"parameterized"},"base_price_micros":{"type":"integer","minimum":0.0,"title":"Base Price Micros"},"minimum_price_micros":{"type":"integer","minimum":0.0,"title":"Minimum Price Micros"},"requires_attachment":{"type":"boolean","title":"Requires Attachment"},"dimensions":{"items":{"oneOf":[{"$ref":"#/components/schemas/ParameterizedTierDimensionSummary"},{"$ref":"#/components/schemas/ParameterizedUnitDimensionSummary"}],"discriminator":{"propertyName":"kind","mapping":{"tier":"#/components/schemas/ParameterizedTierDimensionSummary","unit":"#/components/schemas/ParameterizedUnitDimensionSummary"}}},"type":"array","title":"Dimensions"}},"additionalProperties":false,"type":"object","required":["base_price_micros","minimum_price_micros","requires_attachment","dimensions"],"title":"ParameterizedPricingSummary","description":"Normalized public terms; clients never need to interpret raw listing JSON."},"ParameterizedTierDimensionSummary":{"properties":{"name":{"type":"string","title":"Name"},"kind":{"type":"string","const":"tier","title":"Kind","default":"tier"},"source":{"type":"string","const":"input","title":"Source","default":"input"},"field":{"type":"string","title":"Field"},"tiers":{"items":{"$ref":"#/components/schemas/ParameterizedTierPriceSummary"},"type":"array","title":"Tiers"}},"additionalProperties":false,"type":"object","required":["name","field","tiers"],"title":"ParameterizedTierDimensionSummary","description":"Buyer-safe description of one task-input tier dimension."},"ParameterizedTierPriceSummary":{"properties":{"value":{"type":"string","title":"Value"},"price_micros":{"type":"integer","minimum":0.0,"title":"Price Micros"}},"additionalProperties":false,"type":"object","required":["value","price_micros"],"title":"ParameterizedTierPriceSummary","description":"Buyer-safe price for one selectable tier value."},"ParameterizedUnitDimensionSummary":{"properties":{"name":{"type":"string","title":"Name"},"kind":{"type":"string","const":"unit","title":"Kind","default":"unit"},"source":{"type":"string","enum":["input","attachment"],"title":"Source"},"field":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Field"},"measure":{"anyOf":[{"type":"string","enum":["byte_size","pdf_page_count","audio_duration_seconds"]},{"type":"null"}],"title":"Measure"},"unit":{"type":"string","title":"Unit"},"unit_price_micros":{"type":"integer","minimum":0.0,"title":"Unit Price Micros"},"unit_scale":{"type":"integer","minimum":1.0,"title":"Unit Scale"},"min_units":{"type":"integer","minimum":0.0,"title":"Min Units"},"max_units":{"type":"integer","minimum":1.0,"title":"Max Units"}},"additionalProperties":false,"type":"object","required":["name","source","unit","unit_price_micros","unit_scale","min_units","max_units"],"title":"ParameterizedUnitDimensionSummary","description":"Buyer-safe description of one bounded unit-priced dimension."},"Person":{"properties":{"user_id":{"type":"string","title":"User Id"},"name":{"type":"string","title":"Name"},"email":{"type":"string","title":"Email"},"first_seen":{"type":"string","format":"date-time","title":"First Seen"},"last_active":{"type":"string","format":"date-time","title":"Last Active"},"active_days":{"type":"integer","title":"Active Days"},"chats":{"type":"integer","title":"Chats"},"runs":{"type":"integer","title":"Runs"},"finished_well":{"type":"integer","title":"Finished Well"},"ended":{"type":"integer","title":"Ended"},"orders":{"type":"integer","title":"Orders"},"delivered":{"type":"integer","title":"Delivered"},"spend_micros":{"type":"integer","title":"Spend Micros"},"ai_cost_micros":{"type":"integer","title":"Ai Cost Micros"},"top_provider":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Top Provider"}},"type":"object","required":["user_id","name","email","first_seen","last_active","active_days","chats","runs","finished_well","ended","orders","delivered","spend_micros","ai_cost_micros","top_provider"],"title":"Person"},"PersonalInviteCode":{"properties":{"code":{"type":"string","title":"Code"},"share_url":{"type":"string","title":"Share Url"}},"type":"object","required":["code","share_url"],"title":"PersonalInviteCode"},"PersonalInviteCodeUpdate":{"properties":{"code":{"type":"string","maxLength":16,"minLength":3,"pattern":"^[a-z0-9][a-z0-9-]*[a-z0-9]$","title":"Code"}},"additionalProperties":false,"type":"object","required":["code"],"title":"PersonalInviteCodeUpdate"},"PlatformEnvPut":{"properties":{"agent_key":{"type":"string","maxLength":100,"minLength":1,"title":"Agent Key"},"name":{"type":"string","title":"Name"},"value":{"type":"string","maxLength":4096,"minLength":1,"title":"Value"}},"type":"object","required":["agent_key","name","value"],"title":"PlatformEnvPut","description":"Plaintext non-secret env value for one agent variable in THIS env."},"PlatformSecretPointer":{"properties":{"agent_key":{"type":"string","title":"Agent Key"},"name":{"type":"string","title":"Name"},"source_key_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Key Id"},"secret_version":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Secret Version"}},"type":"object","required":["agent_key","name"],"title":"PlatformSecretPointer","description":"One copy of a platform-bound key, without its value."},"PlatformSecretPut":{"properties":{"agent_key":{"type":"string","maxLength":100,"minLength":1,"title":"Agent Key"},"name":{"type":"string","title":"Name"},"value":{"anyOf":[{"type":"string","maxLength":4096,"minLength":1},{"type":"null"}],"title":"Value"},"source_key_id":{"anyOf":[{"type":"string","maxLength":36},{"type":"null"}],"title":"Source Key Id"},"secret_version":{"anyOf":[{"type":"integer","minimum":1.0},{"type":"null"}],"title":"Secret Version"}},"type":"object","required":["agent_key","name"],"title":"PlatformSecretPut"},"PolicyReference":{"properties":{"document_id":{"type":"string","maxLength":200,"minLength":1,"title":"Document Id"},"content_hash":{"type":"string","pattern":"^[0-9a-f]{64}$","title":"Content Hash"}},"additionalProperties":false,"type":"object","required":["document_id","content_hash"],"title":"PolicyReference"},"PriceComponentResolution":{"properties":{"name":{"type":"string","title":"Name"},"kind":{"type":"string","enum":["constant","lookup","unit_schedule"],"title":"Kind"},"amount_micros":{"type":"integer","maximum":9007199254740991.0,"minimum":0.0,"title":"Amount Micros"},"parameter":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Parameter"},"raw_value":{"anyOf":[{"type":"integer"},{"type":"string"},{"type":"null"}],"title":"Raw Value"},"quantity_units":{"anyOf":[{"type":"integer","maximum":1000000000.0,"minimum":0.0},{"type":"null"}],"title":"Quantity Units"},"unit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Unit"},"mode":{"anyOf":[{"type":"string","enum":["graduated","volume"]},{"type":"null"}],"title":"Mode"}},"additionalProperties":false,"type":"object","required":["name","kind","amount_micros"],"title":"PriceComponentResolution"},"PriceResolution":{"properties":{"schema_version":{"type":"integer","const":1,"title":"Schema Version","default":1},"currency":{"type":"string","const":"USD","title":"Currency","default":"USD"},"price_spec_hash":{"type":"string","pattern":"^[0-9a-f]{64}$","title":"Price Spec Hash"},"total_micros":{"type":"integer","maximum":9007199254740991.0,"minimum":0.0,"title":"Total Micros"},"parameters":{"additionalProperties":{"anyOf":[{"type":"integer"},{"type":"string"}]},"type":"object","title":"Parameters"},"breakdown":{"items":{"$ref":"#/components/schemas/PriceComponentResolution"},"type":"array","title":"Breakdown"}},"additionalProperties":false,"type":"object","required":["price_spec_hash","total_micros","parameters","breakdown"],"title":"PriceResolution"},"PriceSpec":{"properties":{"schema_version":{"type":"integer","const":1,"title":"Schema Version","default":1},"currency":{"type":"string","const":"USD","title":"Currency","default":"USD"},"checkout_floor_micros":{"type":"integer","enum":[0,1000,50000],"title":"Checkout Floor Micros","default":1000},"rule":{"oneOf":[{"$ref":"#/components/schemas/ConstantPriceRule"},{"$ref":"#/components/schemas/LookupPriceRule"},{"$ref":"#/components/schemas/UnitSchedulePriceRule"},{"$ref":"#/components/schemas/SumPriceRule"}],"title":"Rule","discriminator":{"propertyName":"kind","mapping":{"constant":"#/components/schemas/ConstantPriceRule","lookup":"#/components/schemas/LookupPriceRule","sum":"#/components/schemas/SumPriceRule","unit_schedule":"#/components/schemas/UnitSchedulePriceRule"}}}},"additionalProperties":false,"type":"object","required":["rule"],"title":"PriceSpec","description":"One immutable pricing function evaluated before funding or settlement."},"ProviderAttemptObservation-Input":{"properties":{"revision":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"Revision"},"credential_name":{"anyOf":[{"type":"string","pattern":"^[A-Z][A-Z0-9_]{0,98}$"},{"type":"null"}],"title":"Credential Name"},"attempt_number":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"Attempt Number"},"endpoint_id":{"type":"string","maxLength":150,"minLength":1,"pattern":"^[a-zA-Z0-9][a-zA-Z0-9_./-]*$","title":"Endpoint Id"},"upstream_request_id":{"anyOf":[{"type":"string","maxLength":128,"minLength":1,"pattern":"^[a-zA-Z0-9_.-]+$"},{"type":"null"}],"title":"Upstream Request Id"},"observed_at":{"type":"string","format":"date-time","title":"Observed At"},"outcome":{"type":"string","enum":["started","submitted","succeeded","partial","failed","cancelled","unknown"],"title":"Outcome"},"response_bytes":{"anyOf":[{"type":"integer","maximum":1073741824.0,"minimum":0.0},{"type":"null"}],"title":"Response Bytes"},"units":{"anyOf":[{"type":"number","maximum":1000000000.0,"minimum":0.0},{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*(?:\\d{0,12}|(?=[\\d.]{1,25}0*$)\\d{0,12}\\.\\d{0,12}0*$)"},{"type":"null"}],"title":"Units"},"unit":{"type":"string","maxLength":32,"minLength":1,"pattern":"^[a-z][a-z0-9_]*$","title":"Unit"},"usage_source":{"type":"string","enum":["delegate_observed","provider_reported"],"title":"Usage Source","default":"delegate_observed"},"cost_status":{"type":"string","enum":["unknown","estimated","provider_reported","documented_free"],"title":"Cost Status","default":"unknown"},"cost_usd":{"anyOf":[{"type":"number","maximum":1000000000.0,"minimum":0.0},{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*(?:\\d{0,12}|(?=[\\d.]{1,25}0*$)\\d{0,12}\\.\\d{0,12}0*$)"},{"type":"null"}],"title":"Cost Usd"},"unit_price_usd":{"anyOf":[{"type":"number","maximum":1000000000.0,"minimum":0.0},{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*(?:\\d{0,12}|(?=[\\d.]{1,25}0*$)\\d{0,12}\\.\\d{0,12}0*$)"},{"type":"null"}],"title":"Unit Price Usd"},"price_basis":{"anyOf":[{"type":"string","maxLength":100,"minLength":1,"pattern":"^[a-zA-Z0-9_.-]+$"},{"type":"null"}],"title":"Price Basis"}},"additionalProperties":false,"type":"object","required":["revision","attempt_number","endpoint_id","observed_at","outcome","unit"],"title":"ProviderAttemptObservation"},"ProviderAttemptObservation-Output":{"properties":{"revision":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"Revision"},"credential_name":{"anyOf":[{"type":"string","pattern":"^[A-Z][A-Z0-9_]{0,98}$"},{"type":"null"}],"title":"Credential Name"},"attempt_number":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"Attempt Number"},"endpoint_id":{"type":"string","maxLength":150,"minLength":1,"pattern":"^[a-zA-Z0-9][a-zA-Z0-9_./-]*$","title":"Endpoint Id"},"upstream_request_id":{"anyOf":[{"type":"string","maxLength":128,"minLength":1,"pattern":"^[a-zA-Z0-9_.-]+$"},{"type":"null"}],"title":"Upstream Request Id"},"observed_at":{"type":"string","format":"date-time","title":"Observed At"},"outcome":{"type":"string","enum":["started","submitted","succeeded","partial","failed","cancelled","unknown"],"title":"Outcome"},"response_bytes":{"anyOf":[{"type":"integer","maximum":1073741824.0,"minimum":0.0},{"type":"null"}],"title":"Response Bytes"},"units":{"anyOf":[{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*(?:\\d{0,12}|(?=[\\d.]{1,25}0*$)\\d{0,12}\\.\\d{0,12}0*$)"},{"type":"null"}],"title":"Units"},"unit":{"type":"string","maxLength":32,"minLength":1,"pattern":"^[a-z][a-z0-9_]*$","title":"Unit"},"usage_source":{"type":"string","enum":["delegate_observed","provider_reported"],"title":"Usage Source","default":"delegate_observed"},"cost_status":{"type":"string","enum":["unknown","estimated","provider_reported","documented_free"],"title":"Cost Status","default":"unknown"},"cost_usd":{"anyOf":[{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*(?:\\d{0,12}|(?=[\\d.]{1,25}0*$)\\d{0,12}\\.\\d{0,12}0*$)"},{"type":"null"}],"title":"Cost Usd"},"unit_price_usd":{"anyOf":[{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*(?:\\d{0,12}|(?=[\\d.]{1,25}0*$)\\d{0,12}\\.\\d{0,12}0*$)"},{"type":"null"}],"title":"Unit Price Usd"},"price_basis":{"anyOf":[{"type":"string","maxLength":100,"minLength":1,"pattern":"^[a-zA-Z0-9_.-]+$"},{"type":"null"}],"title":"Price Basis"}},"additionalProperties":false,"type":"object","required":["revision","attempt_number","endpoint_id","observed_at","outcome","unit"],"title":"ProviderAttemptObservation"},"ProviderAttemptResponse":{"properties":{"id":{"type":"string","title":"Id"},"job_id":{"type":"string","title":"Job Id"},"agent_key":{"type":"string","title":"Agent Key"},"service_key":{"type":"string","title":"Service Key"},"environment":{"type":"string","title":"Environment"},"source_key_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Key Id"},"credential_updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Credential Updated At"},"account_ref":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Account Ref"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"},"observation":{"$ref":"#/components/schemas/ProviderAttemptObservation-Output"}},"type":"object","required":["id","job_id","agent_key","service_key","environment","source_key_id","credential_updated_at","created_at","updated_at","observation"],"title":"ProviderAttemptResponse"},"ProviderDisputeItem":{"properties":{"id":{"type":"string","title":"Id"},"conversation_id":{"type":"string","title":"Conversation Id"},"contract_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Contract Id"},"status":{"type":"string","title":"Status"},"reason":{"type":"string","title":"Reason"},"outcome":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Outcome"},"raised_by_role":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Raised By Role"},"resolution_note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Resolution Note"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"resolved_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Resolved At"},"provider_response_due_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Provider Response Due At"},"provider_response":{"anyOf":[{"$ref":"#/components/schemas/UsageDisputeProviderResponse"},{"type":"null"}]},"conversation_status":{"type":"string","title":"Conversation Status"},"escrow_locked_micros":{"type":"integer","title":"Escrow Locked Micros"},"auto_accept":{"type":"boolean","title":"Auto Accept","default":false},"service_title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Service Title"},"provider_display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provider Display Name"},"task_title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Task Title"},"task_summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Task Summary"},"contract_snapshot":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Contract Snapshot"},"latest_response_preview":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Latest Response Preview"},"latest_artifacts":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Latest Artifacts"},"latest_settlement":{"anyOf":[{"$ref":"#/components/schemas/SettlementSummaryPayload"},{"type":"null"}]},"usage_report":{"anyOf":[{"$ref":"#/components/schemas/UsageReportResponse"},{"type":"null"}]}},"type":"object","required":["id","conversation_id","status","reason","created_at","conversation_status","escrow_locked_micros"],"title":"ProviderDisputeItem","description":"Provider-visible dispute context without direct buyer identity."},"ProviderDisputeListResponse":{"properties":{"disputes":{"items":{"$ref":"#/components/schemas/ProviderDisputeItem"},"type":"array","title":"Disputes"},"open_count":{"type":"integer","title":"Open Count"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["disputes","open_count","total"],"title":"ProviderDisputeListResponse"},"ProviderEventTypesResponse":{"properties":{"event_types":{"items":{"type":"string"},"type":"array","title":"Event Types"}},"type":"object","required":["event_types"],"title":"ProviderEventTypesResponse","description":"Distinct operational event types present for the caller's own agents,\nused to populate the event-log type filter."},"ProviderLifetimeEarnings":{"properties":{"gross_charged_micros":{"type":"integer","title":"Gross Charged Micros"},"provider_net_micros":{"type":"integer","title":"Provider Net Micros"},"platform_fee_micros":{"type":"integer","title":"Platform Fee Micros"},"refunded_micros":{"type":"integer","title":"Refunded Micros"}},"type":"object","required":["gross_charged_micros","provider_net_micros","platform_fee_micros","refunded_micros"],"title":"ProviderLifetimeEarnings","description":"All-time sums over the same predicate as the monthly statements.\n\nAlways equals the column-sums of ``statements``; surfaced server-side so\nthe UI has an authoritative earned-to-date figure. Earnings are credited\nto the in-platform wallet balance - there is no payout rail yet."},"ProviderMonthlyStatement":{"properties":{"month":{"type":"string","title":"Month"},"gross_charged_micros":{"type":"integer","title":"Gross Charged Micros"},"provider_net_micros":{"type":"integer","title":"Provider Net Micros"},"platform_fee_micros":{"type":"integer","title":"Platform Fee Micros"},"refunded_micros":{"type":"integer","title":"Refunded Micros"},"charge_count":{"type":"integer","title":"Charge Count"},"refund_count":{"type":"integer","title":"Refund Count"},"total_events":{"type":"integer","title":"Total Events"},"closed":{"type":"boolean","title":"Closed"},"first_event_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"First Event At"},"last_event_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Event At"}},"type":"object","required":["month","gross_charged_micros","provider_net_micros","platform_fee_micros","refunded_micros","charge_count","refund_count","total_events","closed"],"title":"ProviderMonthlyStatement"},"ProviderObservabilitySummary":{"properties":{"window":{"$ref":"#/components/schemas/ObservabilityWindow"},"dispatch":{"$ref":"#/components/schemas/ObservabilityDispatch"},"disputes":{"$ref":"#/components/schemas/ObservabilityDisputes"},"failing_services":{"items":{"$ref":"#/components/schemas/FailingProvider"},"type":"array","title":"Failing Services"}},"type":"object","required":["window","dispatch","disputes","failing_services"],"title":"ProviderObservabilitySummary","description":"Operational health for a provider's own agents.\n\nMirrors the dispatch + disputes + failing-services slices of the admin\n``ObservabilitySummary`` but never includes the infra sections (search,\nembeddings, database) which carry platform-wide internals."},"ProviderObservabilityTrends":{"properties":{"window":{"$ref":"#/components/schemas/ObservabilityWindow"},"points":{"items":{"$ref":"#/components/schemas/ObservabilityTrendPoint"},"type":"array","title":"Points"}},"type":"object","required":["window","points"],"title":"ProviderObservabilityTrends"},"ProviderOffering":{"properties":{"id":{"type":"string","title":"Id"},"service_key":{"type":"string","title":"Service Key"},"title":{"type":"string","title":"Title"},"tags":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Tags"},"price_display":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Price Display"},"price_micros":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Price Micros"}},"type":"object","required":["id","service_key","title","tags","price_display","price_micros"],"title":"ProviderOffering"},"ProviderOperationalEventListResponse":{"properties":{"events":{"items":{"$ref":"#/components/schemas/ProviderOperationalEventRow"},"type":"array","title":"Events"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["events","total"],"title":"ProviderOperationalEventListResponse"},"ProviderOperationalEventRow":{"properties":{"id":{"type":"string","title":"Id"},"event_type":{"type":"string","title":"Event Type"},"status":{"type":"string","title":"Status"},"provider_agent_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provider Agent Id"},"service_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Service Id"},"service_title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Service Title"},"job_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Job Id"},"conversation_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Conversation Id"},"duration_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Duration Ms"},"error_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Type"},"error_message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Message"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","event_type","status","created_at"],"title":"ProviderOperationalEventRow","description":"One operational event for the provider event log.\n\nDeliberately omits ``event_metadata`` (can carry infra internals); only the\nprovider's own dispatch identifiers + error are exposed."},"ProviderOrchestrationRootSummary":{"properties":{"id":{"type":"string","title":"Id"},"requester_user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Requester User Id"},"worker_agent_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Worker Agent Id"},"service_title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Service Title"},"provider_display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provider Display Name"},"status":{"type":"string","title":"Status"},"direct_child_count":{"type":"integer","title":"Direct Child Count"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated At"},"delivered_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Delivered At"},"task_summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Task Summary"},"latest_response_preview":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Latest Response Preview"}},"type":"object","required":["id","status","direct_child_count"],"title":"ProviderOrchestrationRootSummary","description":"Orchestration root for the provider view.\n\nSame shape as ``AdminOrchestrationRootSummary`` minus the cross-tenant\n``provider_owner_*`` fields (the owner is the caller themselves)."},"ProviderOrchestrationsResponse":{"properties":{"roots":{"items":{"$ref":"#/components/schemas/ProviderOrchestrationRootSummary"},"type":"array","title":"Roots"},"total_roots":{"type":"integer","title":"Total Roots"},"returned":{"type":"integer","title":"Returned"},"scan_cap":{"type":"integer","title":"Scan Cap"},"truncated":{"type":"boolean","title":"Truncated"}},"type":"object","required":["roots","total_roots","returned","scan_cap","truncated"],"title":"ProviderOrchestrationsResponse"},"ProviderPreference":{"properties":{"id":{"type":"string","title":"Id"},"display_name":{"type":"string","title":"Display Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"enabled":{"type":"boolean","title":"Enabled"},"services":{"items":{"$ref":"#/components/schemas/ProviderOffering"},"type":"array","title":"Services"},"job_count":{"type":"integer","title":"Job Count"},"last_used_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Used At"}},"type":"object","required":["id","display_name","description","enabled","services","job_count","last_used_at"],"title":"ProviderPreference"},"ProviderPreferenceState":{"properties":{"id":{"type":"string","title":"Id"},"enabled":{"type":"boolean","title":"Enabled"}},"type":"object","required":["id","enabled"],"title":"ProviderPreferenceState"},"ProviderPreferenceUpdate":{"properties":{"enabled":{"type":"boolean","title":"Enabled"}},"additionalProperties":false,"type":"object","required":["enabled"],"title":"ProviderPreferenceUpdate"},"ProviderPreferencesResponse":{"properties":{"providers":{"items":{"$ref":"#/components/schemas/ProviderPreference"},"type":"array","title":"Providers"}},"type":"object","required":["providers"],"title":"ProviderPreferencesResponse"},"ProviderRevenueAgent":{"properties":{"id":{"type":"string","title":"Id"},"display_name":{"type":"string","title":"Display Name"},"service_ids":{"items":{"type":"string"},"type":"array","title":"Service Ids"}},"type":"object","required":["id","display_name","service_ids"],"title":"ProviderRevenueAgent"},"ProviderRevenueResponse":{"properties":{"by_service":{"items":{"$ref":"#/components/schemas/ProviderServiceRevenueRow"},"type":"array","title":"By Service"},"agents":{"items":{"$ref":"#/components/schemas/ProviderRevenueAgent"},"type":"array","title":"Agents"}},"type":"object","required":["by_service","agents"],"title":"ProviderRevenueResponse"},"ProviderServiceRevenueRow":{"properties":{"service_id":{"type":"string","title":"Service Id"},"title":{"type":"string","title":"Title"},"gross_charged_micros":{"type":"integer","title":"Gross Charged Micros"},"provider_net_micros":{"type":"integer","title":"Provider Net Micros"},"platform_fee_micros":{"type":"integer","title":"Platform Fee Micros"},"refunded_micros":{"type":"integer","title":"Refunded Micros"},"total_events":{"type":"integer","title":"Total Events"},"total_jobs":{"type":"integer","title":"Total Jobs"},"quality_average_rating":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Quality Average Rating"},"value_average_rating":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Value Average Rating"},"completion_rate":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Completion Rate"},"platform_fee_bps":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Platform Fee Bps"},"effective_fee_bps":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Effective Fee Bps"}},"type":"object","required":["service_id","title","gross_charged_micros","provider_net_micros","platform_fee_micros","refunded_micros","total_events","total_jobs"],"title":"ProviderServiceRevenueRow"},"ProviderServiceUsageEventListResponse":{"properties":{"events":{"items":{"$ref":"#/components/schemas/ProviderServiceUsageEventResponse"},"type":"array","title":"Events"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["events","total"],"title":"ProviderServiceUsageEventListResponse"},"ProviderServiceUsageEventResponse":{"properties":{"id":{"type":"string","title":"Id"},"service_id":{"type":"string","title":"Service Id"},"service_title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Service Title"},"buyer_user_id":{"type":"string","title":"Buyer User Id"},"conversation_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Conversation Id"},"job_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Job Id"},"event_type":{"type":"string","title":"Event Type"},"amount_micros":{"type":"integer","title":"Amount Micros"},"provider_net_micros":{"type":"integer","title":"Provider Net Micros"},"platform_fee_micros":{"type":"integer","title":"Platform Fee Micros"},"quantity":{"type":"integer","title":"Quantity"},"unit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Unit"},"status":{"type":"string","title":"Status"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","service_id","buyer_user_id","conversation_id","job_id","event_type","amount_micros","provider_net_micros","platform_fee_micros","quantity","unit","status","created_at"],"title":"ProviderServiceUsageEventResponse","description":"Provider-facing event with direct buyer identity intentionally omitted."},"ProviderSettlementStatement":{"properties":{"provider_user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provider User Id"},"entitlements_settled":{"type":"integer","title":"Entitlements Settled"},"units":{"type":"integer","title":"Units"},"gross_micros":{"type":"integer","title":"Gross Micros"},"provider_net_micros":{"type":"integer","title":"Provider Net Micros"},"platform_fee_micros":{"type":"integer","title":"Platform Fee Micros"}},"type":"object","required":["entitlements_settled","units","gross_micros","provider_net_micros","platform_fee_micros"],"title":"ProviderSettlementStatement","description":"Per-provider aggregate for one consumption-settlement run."},"ProviderStatementsResponse":{"properties":{"statements":{"items":{"$ref":"#/components/schemas/ProviderMonthlyStatement"},"type":"array","title":"Statements"},"lifetime":{"$ref":"#/components/schemas/ProviderLifetimeEarnings"}},"type":"object","required":["statements","lifetime"],"title":"ProviderStatementsResponse"},"ProviderStatusResponse":{"properties":{"is_provider":{"type":"boolean","title":"Is Provider"}},"type":"object","required":["is_provider"],"title":"ProviderStatusResponse"},"ProviderUsage":{"properties":{"agent_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Id"},"name":{"type":"string","title":"Name"},"orders":{"type":"integer","title":"Orders"},"delivered":{"type":"integer","title":"Delivered"},"spend_micros":{"type":"integer","title":"Spend Micros"},"buyers":{"type":"integer","title":"Buyers"},"repeat_buyers":{"type":"integer","title":"Repeat Buyers"},"mix":{"items":{"$ref":"#/components/schemas/Buyer"},"type":"array","title":"Mix"}},"type":"object","required":["agent_id","name","orders","delivered","spend_micros","buyers","repeat_buyers","mix"],"title":"ProviderUsage"},"ProviderWorkFileGroup":{"properties":{"id":{"type":"string","title":"Id"},"job_id":{"type":"string","title":"Job Id"},"conversation_id":{"type":"string","title":"Conversation Id"},"service_title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Service Title"},"agent_display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Display Name"},"title":{"type":"string","title":"Title"},"status":{"type":"string","title":"Status"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"},"received":{"items":{"$ref":"#/components/schemas/FileResponse"},"type":"array","title":"Received"},"generated":{"items":{"$ref":"#/components/schemas/FileResponse"},"type":"array","title":"Generated"},"delivered":{"items":{"$ref":"#/components/schemas/FileResponse"},"type":"array","title":"Delivered"}},"type":"object","required":["id","job_id","conversation_id","title","status","created_at","updated_at"],"title":"ProviderWorkFileGroup"},"PublicServiceDetail":{"properties":{"id":{"type":"string","title":"Id"},"service_key":{"type":"string","title":"Service Key"},"title":{"type":"string","title":"Title"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"commercial_model_version":{"type":"integer","title":"Commercial Model Version"},"pricing_model":{"type":"string","title":"Pricing Model"},"price_micros":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Price Micros"},"pricing_options":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Pricing Options"},"pricing_summary":{"anyOf":[{"$ref":"#/components/schemas/ParameterizedPricingSummary"},{"type":"null"}]},"price_estimate":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Price Estimate"},"tags":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Tags"},"connection_requirement":{"anyOf":[{"$ref":"#/components/schemas/ServiceConnectionRequirement"},{"type":"null"}]},"enabled":{"type":"boolean","title":"Enabled"},"status":{"type":"string","title":"Status"},"settlement_policy":{"anyOf":[{"$ref":"#/components/schemas/ServiceSettlementPolicy"},{"type":"null"}]},"queue_policy":{"anyOf":[{"$ref":"#/components/schemas/ServiceQueuePolicy"},{"type":"null"}]},"refund_policy_document_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Refund Policy Document Id"},"input_schema":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Input Schema"},"output_schema":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Output Schema"},"file_contract":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"File Contract"},"file_contract_hash":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"File Contract Hash"},"filesystem_runtime_modes":{"items":{"type":"string","enum":["live_workspace_v1","snapshot_v1"]},"type":"array","title":"Filesystem Runtime Modes"},"typical_turnaround_minutes":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Typical Turnaround Minutes"},"p90_turnaround_minutes":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"P90 Turnaround Minutes"},"max_turnaround_minutes":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Turnaround Minutes"},"sample_tasks":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Sample Tasks"},"quality_average_rating":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Quality Average Rating"},"quality_rating_count":{"type":"integer","title":"Quality Rating Count"},"value_average_rating":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Value Average Rating"},"value_rating_count":{"type":"integer","title":"Value Rating Count"},"provider":{"$ref":"#/components/schemas/ServiceBrowseProvider"},"offers":{"items":{"$ref":"#/components/schemas/ServiceOffer"},"type":"array","title":"Offers"},"offer_versions":{"items":{"$ref":"#/components/schemas/ServiceOfferVersion"},"type":"array","title":"Offer Versions"}},"type":"object","required":["id","service_key","title","description","commercial_model_version","pricing_model","price_micros","pricing_options","pricing_summary","price_estimate","tags","connection_requirement","enabled","status","settlement_policy","queue_policy","refund_policy_document_id","input_schema","output_schema","file_contract","file_contract_hash","filesystem_runtime_modes","typical_turnaround_minutes","p90_turnaround_minutes","max_turnaround_minutes","sample_tasks","quality_average_rating","quality_rating_count","value_average_rating","value_rating_count","provider","offers","offer_versions"],"title":"PublicServiceDetail","description":"Allow-listed service details safe for an anonymous catalog page."},"PurchaseRule":{"properties":{"rule":{"type":"string","enum":["ask","follow"],"title":"Rule"}},"additionalProperties":false,"type":"object","required":["rule"],"title":"PurchaseRule","description":"Toolbox \"When a chat has read your apps\": ``ask`` before buying (the\ndefault) or ``follow`` the assistant's spending setting."},"Purchases":{"properties":{"count":{"type":"integer","title":"Count"},"succeeded":{"type":"integer","title":"Succeeded"},"spend_micros":{"type":"integer","title":"Spend Micros"}},"type":"object","required":["count","succeeded","spend_micros"],"title":"Purchases"},"RawChoiceFinding":{"properties":{"id":{"type":"string","maxLength":32,"minLength":1,"title":"Id"},"choice":{"type":"string","maxLength":64,"minLength":1,"title":"Choice"},"confidence":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Confidence"}},"additionalProperties":false,"type":"object","required":["id","choice","confidence"],"title":"RawChoiceFinding"},"RawJevFindings":{"properties":{"model":{"type":"string","const":"jev-1.13.0","title":"Model"},"complete":{"type":"boolean","const":true,"title":"Complete"},"question_count":{"type":"integer","const":3,"title":"Question Count"},"choice_answers":{"items":{"$ref":"#/components/schemas/RawChoiceFinding"},"type":"array","maxItems":3,"minItems":3,"title":"Choice Answers"},"needs_review":{"type":"boolean","title":"Needs Review"},"review_policy_version":{"type":"string","const":"jev-review-v1","title":"Review Policy Version"},"decision_reviews":{"items":{"$ref":"#/components/schemas/DecisionReview"},"type":"array","maxItems":3,"minItems":3,"title":"Decision Reviews"}},"type":"object","required":["model","complete","question_count","choice_answers","needs_review","review_policy_version","decision_reviews"],"title":"RawJevFindings","description":"Only raw decision fields used from one actual JEV result artifact."},"Reason":{"properties":{"key":{"type":"string","title":"Key"},"label":{"type":"string","title":"Label"},"outcome":{"type":"string","title":"Outcome"},"runs":{"type":"integer","title":"Runs"},"by_day":{"items":{"type":"integer"},"type":"array","title":"By Day"}},"type":"object","required":["key","label","outcome","runs","by_day"],"title":"Reason","description":"Why requests did not finish well: one end state and its cause."},"ReauthenticateRequest":{"properties":{"current_password":{"type":"string","minLength":1,"title":"Current Password"}},"type":"object","required":["current_password"],"title":"ReauthenticateRequest"},"ReferralInfoResponse":{"properties":{"code":{"type":"string","title":"Code"},"url":{"type":"string","title":"Url"},"reward_micros":{"type":"integer","title":"Reward Micros"},"referee_reward_micros":{"type":"integer","title":"Referee Reward Micros"},"reward_cap":{"type":"integer","title":"Reward Cap"},"rewarded_count":{"type":"integer","title":"Rewarded Count"}},"type":"object","required":["code","url","reward_micros","referee_reward_micros","reward_cap","rewarded_count"],"title":"ReferralInfoResponse"},"ReferralSettings":{"properties":{"credit_micros":{"type":"integer","minimum":0.0,"title":"Credit Micros"},"referee_credit_micros":{"type":"integer","minimum":0.0,"title":"Referee Credit Micros"},"reward_cap":{"type":"integer","minimum":0.0,"title":"Reward Cap"}},"type":"object","required":["credit_micros","referee_credit_micros","reward_cap"],"title":"ReferralSettings"},"RequesterFileTaskGroup":{"properties":{"id":{"type":"string","title":"Id"},"group_key":{"type":"string","title":"Group Key"},"conversation_ids":{"items":{"type":"string"},"type":"array","title":"Conversation Ids"},"title":{"type":"string","title":"Title"},"status":{"type":"string","title":"Status"},"service_titles":{"items":{"type":"string"},"type":"array","title":"Service Titles"},"provider_display_names":{"items":{"type":"string"},"type":"array","title":"Provider Display Names"},"task_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Task Id"},"search_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Search Id"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"},"inputs":{"items":{"$ref":"#/components/schemas/FileResponse"},"type":"array","title":"Inputs"},"outputs":{"items":{"$ref":"#/components/schemas/FileResponse"},"type":"array","title":"Outputs"}},"type":"object","required":["id","group_key","title","status","created_at","updated_at"],"title":"RequesterFileTaskGroup"},"RequesterFilesGroupedResponse":{"properties":{"tasks":{"items":{"$ref":"#/components/schemas/RequesterFileTaskGroup"},"type":"array","title":"Tasks"},"unattached":{"items":{"$ref":"#/components/schemas/FileResponse"},"type":"array","title":"Unattached"},"pending_uploads":{"items":{"$ref":"#/components/schemas/FileResponse"},"type":"array","title":"Pending Uploads"}},"type":"object","title":"RequesterFilesGroupedResponse"},"ResetPasswordRequest":{"properties":{"token":{"type":"string","minLength":1,"title":"Token"},"password":{"type":"string","title":"Password"}},"type":"object","required":["token","password"],"title":"ResetPasswordRequest"},"ReviewSummary":{"properties":{"id":{"type":"string","title":"Id"},"direction":{"type":"string","title":"Direction"},"quality_rating":{"type":"integer","title":"Quality Rating"},"value_rating":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Value Rating"},"quality_note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quality Note"},"value_note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Value Note"},"reviewer_model_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reviewer Model Name"},"reviewer_model_provider":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reviewer Model Provider"},"reviewer_type":{"type":"string","enum":["human","agent"],"title":"Reviewer Type"},"task_group_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Task Group Id"},"rated_hire_count":{"type":"integer","title":"Rated Hire Count","default":1},"first_submitted_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"First Submitted At"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"},"editable_until":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Editable Until"},"is_locked":{"type":"boolean","title":"Is Locked","default":true},"revision":{"type":"integer","title":"Revision","default":1},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","direction","quality_rating","reviewer_type","created_at"],"title":"ReviewSummary","description":"A single review row without reviewer identity.\n\nThe dual-axis shape carries ``quality_rating`` and ``value_rating``.\nPre-migration rows have ``value_rating = null`` on the wire; the\napplication treats NULL as \"no value opinion\" and excludes the row\nfrom the value rollup."},"Rubric":{"properties":{"version":{"type":"integer","const":1,"title":"Version","default":1},"instruction":{"type":"string","maxLength":1200,"minLength":1,"title":"Instruction"},"input_paths":{"items":{"type":"string"},"type":"array","maxItems":16,"minItems":1,"title":"Input Paths"},"output_paths":{"items":{"type":"string"},"type":"array","maxItems":16,"minItems":1,"title":"Output Paths"},"questions":{"items":{"oneOf":[{"$ref":"#/components/schemas/ChoiceQuestion"},{"$ref":"#/components/schemas/ScoreQuestion"},{"$ref":"#/components/schemas/YesNoQuestion"}],"discriminator":{"propertyName":"kind","mapping":{"choice":"#/components/schemas/ChoiceQuestion","score":"#/components/schemas/ScoreQuestion","yes_no":"#/components/schemas/YesNoQuestion"}}},"type":"array","maxItems":4,"minItems":1,"title":"Questions"}},"additionalProperties":false,"type":"object","required":["instruction","input_paths","output_paths","questions"],"title":"Rubric"},"RuleChange":{"properties":{"tier":{"anyOf":[{"type":"string","enum":["read","write","send"]},{"type":"null"}],"title":"Tier"},"tool":{"anyOf":[{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9_.\\-]{0,63}$"},{"type":"null"}],"title":"Tool"},"rule":{"anyOf":[{"type":"string","enum":["allow","ask","off"]},{"type":"null"}],"title":"Rule"}},"additionalProperties":false,"type":"object","required":["rule"],"title":"RuleChange"},"ScopeJobBinding":{"properties":{"scope_key":{"type":"string","maxLength":100,"minLength":1,"title":"Scope Key"},"job_context_key":{"type":"string","maxLength":100,"minLength":1,"title":"Job Context Key"},"task_input_key":{"anyOf":[{"type":"string","maxLength":100,"minLength":1},{"type":"null"}],"title":"Task Input Key"},"task_input_consistency":{"type":"string","enum":["ignore","equal_if_present","required_equal"],"title":"Task Input Consistency","default":"ignore"}},"additionalProperties":false,"type":"object","required":["scope_key","job_context_key"],"title":"ScopeJobBinding"},"ScoreQuestion":{"properties":{"kind":{"type":"string","const":"score","title":"Kind"},"id":{"type":"string","maxLength":32,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","title":"Id"},"instructions":{"type":"string","maxLength":1024,"minLength":1,"title":"Instructions"},"levels":{"items":{"type":"string"},"type":"array","maxItems":10,"minItems":2,"title":"Levels"}},"additionalProperties":false,"type":"object","required":["kind","id","instructions","levels"],"title":"ScoreQuestion"},"ScriptProbeConfig":{"properties":{"kind":{"type":"string","const":"script","title":"Kind"},"language":{"type":"string","const":"python","title":"Language","default":"python"},"source":{"type":"string","maxLength":20000,"minLength":10,"title":"Source"},"unit":{"anyOf":[{"type":"string","maxLength":32},{"type":"null"}],"title":"Unit"},"timeout_seconds":{"type":"integer","maximum":120.0,"minimum":1.0,"title":"Timeout Seconds","default":30}},"type":"object","required":["kind","source"],"title":"ScriptProbeConfig","description":"User-supplied usage probe as a Python script.\n\nThe script defines ``probe(key: str) -> dict`` and is run in a separate\ninterpreter at probe time with the key's value as its only input (see\n``app/external_key_probe_runner.py`` for the contract). Only the source\nis stored, never the value."},"SelfHostedAgentCreate":{"properties":{"display_name":{"type":"string","maxLength":255,"minLength":1,"title":"Display Name"},"agent_key":{"type":"string","maxLength":100,"title":"Agent Key"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"callback_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Callback Url"},"notification_mode":{"type":"string","enum":["webhook","sse","long_poll","short_poll","poll"],"title":"Notification Mode","default":"poll"},"required_env":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Required Env"}},"type":"object","required":["display_name","agent_key"],"title":"SelfHostedAgentCreate"},"SelfHostedAgentProvisionResponse":{"properties":{"id":{"type":"string","title":"Id"},"owner_user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Owner User Id"},"owner_email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Owner Email"},"owner_display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Owner Display Name"},"display_name":{"type":"string","title":"Display Name"},"agent_key":{"type":"string","title":"Agent Key"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"enabled":{"type":"boolean","title":"Enabled","default":true},"status":{"type":"string","enum":["idle","live","offline","error"],"title":"Status"},"presence_status":{"type":"string","enum":["idle","live","offline","error"],"title":"Presence Status"},"reported_status":{"type":"string","enum":["idle","live","running","offline","error","unknown"],"title":"Reported Status"},"last_seen_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Seen At"},"presence_expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Presence Expires At"},"callback_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Callback Url"},"notification_mode":{"type":"string","enum":["webhook","sse","long_poll","short_poll","poll"],"title":"Notification Mode","default":"poll"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"},"archived_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Archived At"},"agent_token":{"type":"string","title":"Agent Token"}},"type":"object","required":["id","display_name","agent_key","status","presence_status","reported_status","last_seen_at","created_at","agent_token"],"title":"SelfHostedAgentProvisionResponse"},"SelfHostedAgentResponse":{"properties":{"id":{"type":"string","title":"Id"},"owner_user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Owner User Id"},"owner_email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Owner Email"},"owner_display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Owner Display Name"},"display_name":{"type":"string","title":"Display Name"},"agent_key":{"type":"string","title":"Agent Key"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"enabled":{"type":"boolean","title":"Enabled","default":true},"status":{"type":"string","enum":["idle","live","offline","error"],"title":"Status"},"presence_status":{"type":"string","enum":["idle","live","offline","error"],"title":"Presence Status"},"reported_status":{"type":"string","enum":["idle","live","running","offline","error","unknown"],"title":"Reported Status"},"last_seen_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Seen At"},"presence_expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Presence Expires At"},"callback_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Callback Url"},"notification_mode":{"type":"string","enum":["webhook","sse","long_poll","short_poll","poll"],"title":"Notification Mode","default":"poll"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"},"archived_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Archived At"}},"type":"object","required":["id","display_name","agent_key","status","presence_status","reported_status","last_seen_at","created_at"],"title":"SelfHostedAgentResponse"},"SelfHostedAgentUpdate":{"properties":{"display_name":{"anyOf":[{"type":"string","maxLength":255,"minLength":1},{"type":"null"}],"title":"Display Name"},"agent_key":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"Agent Key"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"callback_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Callback Url"},"notification_mode":{"anyOf":[{"type":"string","enum":["webhook","sse","long_poll","short_poll","poll"]},{"type":"null"}],"title":"Notification Mode"},"required_env":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Required Env"}},"type":"object","title":"SelfHostedAgentUpdate"},"ServiceActivity":{"properties":{"captured_at_utc":{"type":"string","format":"date-time","title":"Captured At Utc"},"days":{"type":"integer","title":"Days","default":1},"service_requests":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Service Requests"},"completed":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Completed"},"in_progress":{"type":"integer","title":"In Progress"},"failed":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Failed"},"task_requests":{"type":"integer","title":"Task Requests"},"api_calls":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Api Calls"},"searches":{"type":"integer","title":"Searches"},"detail_views":{"type":"integer","title":"Detail Views"},"top_services":{"items":{"$ref":"#/components/schemas/ServiceLeader"},"type":"array","title":"Top Services","default":[]},"top_users":{"items":{"$ref":"#/components/schemas/UserLeader"},"type":"array","title":"Top Users","default":[]},"leaderboards_include_api_calls":{"type":"boolean","title":"Leaderboards Include Api Calls","default":true},"metered_gateway_configured":{"type":"boolean","title":"Metered Gateway Configured","default":true},"by_day":{"items":{"$ref":"#/components/schemas/ActivityDay"},"type":"array","title":"By Day","default":[]},"tool_calls_before":{"type":"integer","title":"Tool Calls Before","default":0}},"type":"object","required":["captured_at_utc","service_requests","completed","in_progress","failed","task_requests","api_calls","searches","detail_views"],"title":"ServiceActivity"},"ServiceBrowseItem":{"properties":{"id":{"type":"string","title":"Id"},"service_key":{"type":"string","title":"Service Key"},"title":{"type":"string","title":"Title"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"tags":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Tags"},"commercial_model_version":{"type":"integer","title":"Commercial Model Version"},"pricing_model":{"type":"string","title":"Pricing Model"},"price_micros":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Price Micros"},"price_estimate":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Price Estimate"},"completed_jobs":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Completed Jobs"},"quality_average_rating":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Quality Average Rating"},"quality_rating_count":{"type":"integer","title":"Quality Rating Count"},"quality_rating_confidence":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Quality Rating Confidence","default":0},"provider":{"$ref":"#/components/schemas/ServiceBrowseProvider"}},"type":"object","required":["id","service_key","title","description","tags","commercial_model_version","pricing_model","price_micros","price_estimate","quality_average_rating","quality_rating_count","provider"],"title":"ServiceBrowseItem"},"ServiceBrowseProvider":{"properties":{"display_name":{"type":"string","title":"Display Name"}},"type":"object","required":["display_name"],"title":"ServiceBrowseProvider"},"ServiceBrowseResponse":{"properties":{"results":{"items":{"$ref":"#/components/schemas/ServiceBrowseItem"},"type":"array","title":"Results"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["results","total"],"title":"ServiceBrowseResponse"},"ServiceCatalogItem":{"properties":{"id":{"type":"string","title":"Id"},"provider_agent_id":{"type":"string","title":"Provider Agent Id"},"title":{"type":"string","title":"Title"},"service_key":{"type":"string","title":"Service Key"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"commercial_model_version":{"type":"integer","title":"Commercial Model Version","default":1},"pricing_model":{"type":"string","title":"Pricing Model"},"price_micros":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Price Micros"},"callback_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Callback Url"},"mcp_config":{"anyOf":[{"$ref":"#/components/schemas/McpServiceConfigPublic"},{"type":"null"}]},"connection_requirement":{"anyOf":[{"$ref":"#/components/schemas/ServiceConnectionRequirement"},{"type":"null"}]},"enabled":{"type":"boolean","title":"Enabled"},"status":{"type":"string","title":"Status"},"admin_suspended":{"type":"boolean","title":"Admin Suspended","default":false},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"},"listing_types":{"items":{"type":"string"},"type":"array","title":"Listing Types"},"pricing_options":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Pricing Options"},"pricing_summary":{"anyOf":[{"$ref":"#/components/schemas/ParameterizedPricingSummary"},{"type":"null"}]},"tags":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Tags"},"settlement_policy":{"anyOf":[{"$ref":"#/components/schemas/ServiceSettlementPolicy"},{"type":"null"}]},"queue_policy":{"anyOf":[{"$ref":"#/components/schemas/ServiceQueuePolicy"},{"type":"null"}]},"queue":{"anyOf":[{"$ref":"#/components/schemas/ServiceQueueSnapshot"},{"type":"null"}]},"refund_policy_document_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Refund Policy Document Id"},"input_schema":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Input Schema"},"output_schema":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Output Schema"},"file_contract":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"File Contract"},"file_contract_hash":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"File Contract Hash"},"filesystem_runtime_modes":{"items":{"type":"string","enum":["live_workspace_v1","snapshot_v1"]},"type":"array","title":"Filesystem Runtime Modes"},"typical_turnaround_minutes":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Typical Turnaround Minutes"},"p90_turnaround_minutes":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"P90 Turnaround Minutes"},"max_turnaround_minutes":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Turnaround Minutes"},"sample_tasks":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Sample Tasks"},"risk_tier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Risk Tier"},"platform_fee_bps":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Platform Fee Bps"},"completed_jobs":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Completed Jobs","default":0},"completion_rate":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Completion Rate"},"dispute_rate":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Dispute Rate"},"quality_average_rating":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Quality Average Rating"},"quality_rating_count":{"type":"integer","title":"Quality Rating Count","default":0},"value_average_rating":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Value Average Rating"},"value_rating_count":{"type":"integer","title":"Value Rating Count","default":0},"can_activate":{"type":"boolean","title":"Can Activate","default":true},"activation_issues":{"items":{"type":"string"},"type":"array","title":"Activation Issues"},"provider_access":{"type":"string","enum":["enabled","disabled"],"title":"Provider Access","default":"enabled"},"provider":{"$ref":"#/components/schemas/ServiceProviderSummary"},"price_estimate":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Price Estimate"},"offers":{"items":{"$ref":"#/components/schemas/ServiceOffer"},"type":"array","title":"Offers"},"offer_versions":{"items":{"$ref":"#/components/schemas/ServiceOfferVersion"},"type":"array","title":"Offer Versions"}},"type":"object","required":["id","provider_agent_id","title","service_key","description","pricing_model","price_micros","callback_url","enabled","status","created_at","updated_at","provider"],"title":"ServiceCatalogItem"},"ServiceCatalogResponse":{"properties":{"results":{"items":{"$ref":"#/components/schemas/ServiceCatalogItem"},"type":"array","title":"Results"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["results","total"],"title":"ServiceCatalogResponse"},"ServiceConnectionRequirement":{"properties":{"connection_kind":{"type":"string","enum":["mcp","connector"],"title":"Connection Kind"},"provider_slug":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"Provider Slug"},"approval_timing":{"type":"string","const":"after_hire","title":"Approval Timing","default":"after_hire"},"approval_channel":{"type":"string","const":"delegate_dashboard","title":"Approval Channel","default":"delegate_dashboard"},"standing_access_supported":{"type":"boolean","title":"Standing Access Supported","default":false},"notice":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Notice"}},"additionalProperties":false,"type":"object","required":["connection_kind"],"title":"ServiceConnectionRequirement","description":"Human approval a hired service may need before it can finish a job."},"ServiceCreate":{"properties":{"title":{"type":"string","maxLength":255,"minLength":1,"title":"Title"},"service_key":{"type":"string","maxLength":100,"title":"Service Key"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"input_schema":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Input Schema"},"output_schema":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Output Schema"},"file_contract":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"File Contract"},"filesystem_runtime_modes":{"items":{"type":"string","enum":["live_workspace_v1","snapshot_v1"]},"type":"array","title":"Filesystem Runtime Modes"},"queue_policy":{"anyOf":[{"$ref":"#/components/schemas/ServiceQueuePolicy"},{"type":"null"}]},"callback_url":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Callback Url"},"mcp_config":{"anyOf":[{"$ref":"#/components/schemas/McpServiceConfig"},{"type":"null"}]},"connection_requirement":{"anyOf":[{"$ref":"#/components/schemas/ServiceConnectionRequirement"},{"type":"null"}]},"offers":{"items":{"$ref":"#/components/schemas/OfferDefinition"},"type":"array","maxItems":10,"minItems":1,"title":"Offers"},"tags":{"anyOf":[{"items":{"type":"string"},"type":"array","maxItems":50},{"type":"null"}],"title":"Tags"},"sample_tasks":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array","maxItems":50},{"type":"null"}],"title":"Sample Tasks"},"typical_turnaround_minutes":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Typical Turnaround Minutes"},"p90_turnaround_minutes":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"P90 Turnaround Minutes"},"max_turnaround_minutes":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Turnaround Minutes"}},"additionalProperties":false,"type":"object","required":["title","service_key","offers"],"title":"ServiceCreate"},"ServiceDeleteResponse":{"properties":{"service_id":{"type":"string","title":"Service Id"},"status":{"type":"string","title":"Status"},"hard_deleted":{"type":"boolean","title":"Hard Deleted"},"vector_deleted":{"type":"boolean","title":"Vector Deleted"}},"type":"object","required":["service_id","status","hard_deleted","vector_deleted"],"title":"ServiceDeleteResponse"},"ServiceDeletionPreview":{"properties":{"service_id":{"type":"string","title":"Service Id"},"mode":{"type":"string","enum":["soft","hard"],"title":"Mode"}},"type":"object","required":["service_id","mode"],"title":"ServiceDeletionPreview"},"ServiceJsonSchemaResponse":{"properties":{"service_id":{"type":"string","title":"Service Id"},"schema_type":{"type":"string","enum":["input","output"],"title":"Schema Type"},"schema":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Schema"}},"type":"object","required":["service_id","schema_type"],"title":"ServiceJsonSchemaResponse"},"ServiceKeepPreview":{"properties":{"gross_micros":{"type":"integer","title":"Gross Micros"},"platform_fee_micros":{"type":"integer","title":"Platform Fee Micros"},"provider_net_micros":{"type":"integer","title":"Provider Net Micros"}},"type":"object","required":["gross_micros","platform_fee_micros","provider_net_micros"],"title":"ServiceKeepPreview","description":"The \"you keep $X of a $Y job\" split, computed with the settlement math."},"ServiceLeader":{"properties":{"service_id":{"type":"string","title":"Service Id"},"title":{"type":"string","title":"Title"},"provider":{"type":"string","title":"Provider"},"requests":{"type":"integer","title":"Requests"},"completed":{"type":"integer","title":"Completed"},"failed":{"type":"integer","title":"Failed"},"detail_views":{"type":"integer","title":"Detail Views"},"revenue_micros":{"type":"integer","title":"Revenue Micros","default":0},"buyers":{"type":"integer","title":"Buyers","default":0}},"type":"object","required":["service_id","title","provider","requests","completed","failed","detail_views"],"title":"ServiceLeader"},"ServiceMatchRequest":{"properties":{"query":{"type":"string","minLength":1,"title":"Query"},"tags":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Tags"},"budget":{"anyOf":[{"$ref":"#/components/schemas/BudgetConstraint"},{"type":"null"}]},"desired_turnaround_minutes":{"anyOf":[{"type":"integer","minimum":1.0},{"type":"null"}],"title":"Desired Turnaround Minutes"},"max_results":{"type":"integer","maximum":50.0,"minimum":1.0,"title":"Max Results","default":10},"blocked_provider_ids":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Blocked Provider Ids"},"allowed_provider_ids":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Allowed Provider Ids"}},"type":"object","required":["query"],"title":"ServiceMatchRequest","description":"Structured request for service matching."},"ServiceOffer":{"properties":{"offer_id":{"type":"string","title":"Offer Id"},"label":{"type":"string","title":"Label"},"contract_type":{"type":"string","title":"Contract Type"},"price_micros":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Price Micros"},"quantity":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Quantity"},"validity_days":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Validity Days"},"requires_pricing_preview":{"type":"boolean","title":"Requires Pricing Preview","default":false},"contract":{"additionalProperties":true,"type":"object","title":"Contract"}},"type":"object","required":["offer_id","label","contract_type","contract"],"title":"ServiceOffer","description":"One stable offer an agent can select and copy into ``hire.contract``."},"ServiceOfferVersion":{"properties":{"offer_version_id":{"type":"string","maxLength":200,"minLength":1,"title":"Offer Version Id"},"service_id":{"type":"string","maxLength":200,"minLength":1,"title":"Service Id"},"version":{"type":"integer","minimum":1.0,"title":"Version"},"definition_hash":{"type":"string","pattern":"^[0-9a-f]{64}$","title":"Definition Hash"},"definition":{"$ref":"#/components/schemas/OfferDefinition"},"state":{"type":"string","enum":["draft","active","retired"],"title":"State"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"additionalProperties":false,"type":"object","required":["offer_version_id","service_id","version","definition_hash","definition","state","created_at"],"title":"ServiceOfferVersion"},"ServicePricingChangeEntry":{"properties":{"id":{"type":"string","title":"Id"},"changed_at":{"type":"string","format":"date-time","title":"Changed At"},"actor_label":{"type":"string","title":"Actor Label"},"actor_is_admin":{"type":"boolean","title":"Actor Is Admin"},"old_pricing_model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Old Pricing Model"},"new_pricing_model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"New Pricing Model"},"old_price_micros":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Old Price Micros"},"new_price_micros":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"New Price Micros"},"old_platform_fee_bps":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Old Platform Fee Bps"},"new_platform_fee_bps":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"New Platform Fee Bps"},"old_effective_fee_bps":{"type":"integer","title":"Old Effective Fee Bps"},"new_effective_fee_bps":{"type":"integer","title":"New Effective Fee Bps"},"jobs_before":{"type":"integer","title":"Jobs Before"},"gross_before_micros":{"type":"integer","title":"Gross Before Micros"},"window_jobs":{"type":"integer","title":"Window Jobs"},"window_gross_micros":{"type":"integer","title":"Window Gross Micros"},"window_provider_net_micros":{"type":"integer","title":"Window Provider Net Micros"},"window_refunded_micros":{"type":"integer","title":"Window Refunded Micros"}},"type":"object","required":["id","changed_at","actor_label","actor_is_admin","old_effective_fee_bps","new_effective_fee_bps","jobs_before","gross_before_micros","window_jobs","window_gross_micros","window_provider_net_micros","window_refunded_micros"],"title":"ServicePricingChangeEntry"},"ServicePricingCurrent":{"properties":{"pricing_model":{"type":"string","title":"Pricing Model"},"price_micros":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Price Micros"},"platform_fee_bps":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Platform Fee Bps"},"effective_fee_bps":{"type":"integer","title":"Effective Fee Bps"},"default_platform_fee_bps":{"type":"integer","title":"Default Platform Fee Bps"},"fee_source":{"type":"string","enum":["service","default"],"title":"Fee Source"},"keep_preview":{"anyOf":[{"$ref":"#/components/schemas/ServiceKeepPreview"},{"type":"null"}]}},"type":"object","required":["pricing_model","effective_fee_bps","default_platform_fee_bps","fee_source"],"title":"ServicePricingCurrent"},"ServicePricingResponse":{"properties":{"service_id":{"type":"string","title":"Service Id"},"title":{"type":"string","title":"Title"},"current":{"$ref":"#/components/schemas/ServicePricingCurrent"},"changes":{"items":{"$ref":"#/components/schemas/ServicePricingChangeEntry"},"type":"array","title":"Changes"}},"type":"object","required":["service_id","title","current","changes"],"title":"ServicePricingResponse"},"ServiceProviderSummary":{"properties":{"id":{"type":"string","title":"Id"},"display_name":{"type":"string","title":"Display Name"},"business_card":{"additionalProperties":true,"type":"object","title":"Business Card"},"status":{"type":"string","enum":["idle","live","offline","error"],"title":"Status"},"presence_status":{"type":"string","enum":["idle","live","offline","error"],"title":"Presence Status"},"reported_status":{"type":"string","enum":["idle","live","running","offline","error","unknown"],"title":"Reported Status"},"last_seen_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Seen At"}},"type":"object","required":["id","display_name","business_card","status","presence_status","reported_status","last_seen_at"],"title":"ServiceProviderSummary"},"ServiceQualityDefinitions":{"properties":{"version":{"type":"string","const":"service-quality-assessment-v1","title":"Version","default":"service-quality-assessment-v1"},"dimensions":{"items":{"$ref":"#/components/schemas/DimensionDefinition"},"type":"array","maxItems":3,"minItems":3,"title":"Dimensions"}},"additionalProperties":false,"type":"object","required":["dimensions"],"title":"ServiceQualityDefinitions","description":"Complete service-specific meanings for the common dimensions."},"ServiceQueuePolicy":{"properties":{"max_concurrent_jobs":{"anyOf":[{"type":"integer","maximum":10000.0,"minimum":1.0},{"type":"null"}],"title":"Max Concurrent Jobs"},"max_queue_depth":{"anyOf":[{"type":"integer","maximum":100000.0,"minimum":0.0},{"type":"null"}],"title":"Max Queue Depth"},"max_queue_wait_seconds":{"anyOf":[{"type":"integer","maximum":604800.0,"minimum":1.0},{"type":"null"}],"title":"Max Queue Wait Seconds"},"acceptance_timeout_seconds":{"anyOf":[{"type":"integer","maximum":604800.0,"minimum":1.0},{"type":"null"}],"title":"Acceptance Timeout Seconds"},"start_deadline_seconds":{"anyOf":[{"type":"integer","maximum":604800.0,"minimum":1.0},{"type":"null"}],"title":"Start Deadline Seconds"},"default_priority":{"type":"string","enum":["low","normal","high"],"title":"Default Priority","default":"normal"},"overflow_behavior":{"type":"string","const":"reject","title":"Overflow Behavior","default":"reject"}},"additionalProperties":false,"type":"object","title":"ServiceQueuePolicy","description":"Provider queue contract enforced at admission time (spec section 11).\n\n``max_concurrent_jobs`` and ``max_queue_depth`` are enforced by the\nplatform's atomic capacity admission (``app.marketplace.queue_admission``):\na hire is rejected ``queue_full`` before any conversation, job, or escrow\nhold exists, and every provider transport defers instead of starting work\npast the concurrency cap. ``acceptance_timeout_seconds`` bounds how long a\ndispatched reservation may wait for provider acceptance.\n``max_queue_wait_seconds`` bounds how long a queued job may wait for a\nfree slot before dispatch fails it. ``start_deadline_seconds`` and\n``default_priority`` are declared contract terms snapshotted at hire time;\ntheir runtime enforcement is a later lifecycle slice (roadmap Phase 7)."},"ServiceQueueSnapshot":{"properties":{"max_concurrent_jobs":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Concurrent Jobs"},"max_queue_depth":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Queue Depth"},"running_jobs":{"type":"integer","title":"Running Jobs","default":0},"queued_jobs":{"type":"integer","title":"Queued Jobs","default":0},"available_slots":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Available Slots"},"estimated_start_seconds_for_new_job":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Estimated Start Seconds For New Job"},"estimated_start_p90_seconds_for_new_job":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Estimated Start P90 Seconds For New Job"},"observed_at":{"type":"string","format":"date-time","title":"Observed At"}},"type":"object","required":["observed_at"],"title":"ServiceQueueSnapshot"},"ServiceRefundPolicyResponse":{"properties":{"service_id":{"type":"string","title":"Service Id"},"document":{"$ref":"#/components/schemas/TextDocumentMetadata"},"markdown":{"type":"string","title":"Markdown"}},"type":"object","required":["service_id","document","markdown"],"title":"ServiceRefundPolicyResponse"},"ServiceRefundPolicyUpload":{"properties":{"title":{"type":"string","maxLength":255,"minLength":1,"title":"Title"},"markdown":{"type":"string","minLength":1,"title":"Markdown"},"effective_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Effective At"}},"type":"object","required":["title","markdown"],"title":"ServiceRefundPolicyUpload"},"ServiceResponse":{"properties":{"id":{"type":"string","title":"Id"},"provider_agent_id":{"type":"string","title":"Provider Agent Id"},"title":{"type":"string","title":"Title"},"service_key":{"type":"string","title":"Service Key"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"commercial_model_version":{"type":"integer","title":"Commercial Model Version","default":1},"pricing_model":{"type":"string","title":"Pricing Model"},"price_micros":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Price Micros"},"callback_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Callback Url"},"mcp_config":{"anyOf":[{"$ref":"#/components/schemas/McpServiceConfigPublic"},{"type":"null"}]},"connection_requirement":{"anyOf":[{"$ref":"#/components/schemas/ServiceConnectionRequirement"},{"type":"null"}]},"enabled":{"type":"boolean","title":"Enabled"},"status":{"type":"string","title":"Status"},"admin_suspended":{"type":"boolean","title":"Admin Suspended","default":false},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"},"listing_types":{"items":{"type":"string"},"type":"array","title":"Listing Types"},"pricing_options":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Pricing Options"},"pricing_summary":{"anyOf":[{"$ref":"#/components/schemas/ParameterizedPricingSummary"},{"type":"null"}]},"tags":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Tags"},"settlement_policy":{"anyOf":[{"$ref":"#/components/schemas/ServiceSettlementPolicy"},{"type":"null"}]},"queue_policy":{"anyOf":[{"$ref":"#/components/schemas/ServiceQueuePolicy"},{"type":"null"}]},"queue":{"anyOf":[{"$ref":"#/components/schemas/ServiceQueueSnapshot"},{"type":"null"}]},"refund_policy_document_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Refund Policy Document Id"},"input_schema":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Input Schema"},"output_schema":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Output Schema"},"file_contract":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"File Contract"},"file_contract_hash":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"File Contract Hash"},"filesystem_runtime_modes":{"items":{"type":"string","enum":["live_workspace_v1","snapshot_v1"]},"type":"array","title":"Filesystem Runtime Modes"},"typical_turnaround_minutes":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Typical Turnaround Minutes"},"p90_turnaround_minutes":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"P90 Turnaround Minutes"},"max_turnaround_minutes":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Turnaround Minutes"},"sample_tasks":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Sample Tasks"},"risk_tier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Risk Tier"},"platform_fee_bps":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Platform Fee Bps"},"completed_jobs":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Completed Jobs","default":0},"completion_rate":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Completion Rate"},"dispute_rate":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Dispute Rate"},"quality_average_rating":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Quality Average Rating"},"quality_rating_count":{"type":"integer","title":"Quality Rating Count","default":0},"value_average_rating":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Value Average Rating"},"value_rating_count":{"type":"integer","title":"Value Rating Count","default":0},"can_activate":{"type":"boolean","title":"Can Activate","default":true},"activation_issues":{"items":{"type":"string"},"type":"array","title":"Activation Issues"}},"type":"object","required":["id","provider_agent_id","title","service_key","description","pricing_model","price_micros","callback_url","enabled","status","created_at","updated_at"],"title":"ServiceResponse"},"ServiceReviewsResponse":{"properties":{"service_id":{"type":"string","title":"Service Id"},"sort":{"type":"string","enum":["recent","lowest_quality","lowest_value"],"title":"Sort","default":"recent"},"reviews":{"items":{"$ref":"#/components/schemas/ReviewSummary"},"type":"array","title":"Reviews"},"quality":{"$ref":"#/components/schemas/_AxisRollup"},"value":{"$ref":"#/components/schemas/_AxisRollup"},"next_cursor":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Next Cursor"}},"type":"object","required":["service_id","reviews","quality","value"],"title":"ServiceReviewsResponse","description":"Paginated hirer->worker reviews of a service plus the dual-axis rollup.\n\nThe rollup is split into ``quality`` and ``value`` blocks (each\nshaped like ``_AxisRollup``); the value block is the same shape\nwith all-zero counts when the service has no value ratings yet.\nThe distribution is keyed by stringified star rating (\"1\" .. \"5\")\nso the frontend can index it without a translation layer."},"ServiceSearchRatings":{"properties":{"average_rating_hundredths":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Average Rating Hundredths","description":"Average in hundredths of a star (480 = 4.8/5)."},"rating_count":{"type":"integer","title":"Rating Count"}},"type":"object","required":["average_rating_hundredths","rating_count"],"title":"ServiceSearchRatings"},"ServiceSearchResponse":{"properties":{"schema_version":{"type":"integer","const":6,"title":"Schema Version","default":6},"search_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Search Id"},"results":{"items":{"$ref":"#/components/schemas/ServiceSearchResult"},"type":"array","title":"Results"},"action_hints":{"items":{"type":"string"},"type":"array","title":"Action Hints"}},"type":"object","required":["search_id","results","action_hints"],"title":"ServiceSearchResponse","description":"Public discovery payload shared by REST and MCP structuredContent."},"ServiceSearchResult":{"properties":{"service_id":{"type":"string","title":"Service Id"},"provider_agent_id":{"type":"string","title":"Provider Agent Id"},"title":{"type":"string","title":"Title"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"quality":{"anyOf":[{"$ref":"#/components/schemas/ServiceSearchRatings"},{"type":"null"}],"description":"Quality ratings; omitted when unrated."},"value_for_money":{"anyOf":[{"$ref":"#/components/schemas/ServiceSearchRatings"},{"type":"null"}],"description":"Value-for-money ratings; omitted when unrated."},"price_estimate":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Price Estimate"}},"type":"object","required":["service_id","provider_agent_id","title","description","price_estimate"],"title":"ServiceSearchResult"},"ServiceSettlementBrokerMetering":{"properties":{"tool_name":{"type":"string","maxLength":200,"minLength":1,"title":"Tool Name"},"per_unit_micros":{"type":"integer","exclusiveMinimum":0.0,"title":"Per Unit Micros"}},"additionalProperties":false,"type":"object","required":["tool_name","per_unit_micros"],"title":"ServiceSettlementBrokerMetering","description":"Per-unit metering attested by the broker journal (see\n``job_settlement.verify_broker_metering``): the bill for a matching rule\nmay not exceed per_unit_micros x successful broker calls of tool_name."},"ServiceSettlementPolicy":{"properties":{"supports_provider_adjustment":{"type":"boolean","title":"Supports Provider Adjustment","default":false},"default_billable_rule":{"type":"string","maxLength":100,"title":"Default Billable Rule","default":"full_on_delivery"},"supported_outcomes":{"items":{"type":"string","enum":["delivered","reduced","non_billable","failed_provider"]},"type":"array","maxItems":4,"minItems":1,"title":"Supported Outcomes"},"allowed_reason_codes":{"items":{"type":"string"},"type":"array","maxItems":100,"title":"Allowed Reason Codes"},"buyer_review_required":{"type":"boolean","title":"Buyer Review Required","default":true},"auto_accept_adjustments":{"type":"string","enum":["never","allow_if_within_policy"],"title":"Auto Accept Adjustments","default":"never"},"max_auto_refund_micros":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Max Auto Refund Micros"},"adjustment_rules":{"items":{"$ref":"#/components/schemas/ServiceSettlementRule"},"type":"array","maxItems":50,"title":"Adjustment Rules"}},"additionalProperties":false,"type":"object","title":"ServiceSettlementPolicy"},"ServiceSettlementRule":{"properties":{"reason_code":{"type":"string","maxLength":100,"minLength":1,"title":"Reason Code"},"billable_rule":{"type":"string","maxLength":100,"minLength":1,"title":"Billable Rule"},"outcome":{"anyOf":[{"type":"string","enum":["delivered","reduced","non_billable","failed_provider"]},{"type":"null"}],"title":"Outcome"},"description":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}],"title":"Description"},"minimum_billable_micros":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Minimum Billable Micros"},"maximum_billable_micros":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Maximum Billable Micros"},"percentage_discount_bps":{"anyOf":[{"type":"integer","maximum":10000.0,"minimum":0.0},{"type":"null"}],"title":"Percentage Discount Bps"},"broker_metering":{"anyOf":[{"$ref":"#/components/schemas/ServiceSettlementBrokerMetering"},{"type":"null"}]}},"additionalProperties":false,"type":"object","required":["reason_code","billable_rule"],"title":"ServiceSettlementRule"},"ServiceUpdate":{"properties":{"title":{"anyOf":[{"type":"string","maxLength":255,"minLength":1},{"type":"null"}],"title":"Title"},"service_key":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"Service Key","description":"Permanent service identity. If supplied, must match the existing key."},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"callback_url":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Callback Url"},"mcp_config":{"anyOf":[{"$ref":"#/components/schemas/McpServiceConfig"},{"type":"null"}]},"connection_requirement":{"anyOf":[{"$ref":"#/components/schemas/ServiceConnectionRequirement"},{"type":"null"}]},"enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Enabled"},"admin_suspended":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Admin Suspended"},"input_schema":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Input Schema"},"output_schema":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Output Schema"},"file_contract":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"File Contract"},"filesystem_runtime_modes":{"anyOf":[{"items":{"type":"string","enum":["live_workspace_v1","snapshot_v1"]},"type":"array"},{"type":"null"}],"title":"Filesystem Runtime Modes"},"queue_policy":{"anyOf":[{"$ref":"#/components/schemas/ServiceQueuePolicy"},{"type":"null"}]},"tags":{"anyOf":[{"items":{"type":"string"},"type":"array","maxItems":50},{"type":"null"}],"title":"Tags"},"sample_tasks":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array","maxItems":50},{"type":"null"}],"title":"Sample Tasks"},"typical_turnaround_minutes":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Typical Turnaround Minutes"},"p90_turnaround_minutes":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"P90 Turnaround Minutes"},"max_turnaround_minutes":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Max Turnaround Minutes"}},"additionalProperties":false,"type":"object","title":"ServiceUpdate","description":"Partial service update used by runtime publication and operational controls.\n\nAll fields are optional. Authorization restricts human owners to ``enabled``;\nruntime credentials publish package metadata and admins may moderate or\ncorrect a listing."},"ServiceUsageEventListResponse":{"properties":{"events":{"items":{"$ref":"#/components/schemas/ServiceUsageEventResponse"},"type":"array","title":"Events"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["events","total"],"title":"ServiceUsageEventListResponse"},"ServiceUsageEventResponse":{"properties":{"id":{"type":"string","title":"Id"},"service_id":{"type":"string","title":"Service Id"},"service_title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Service Title"},"buyer_user_id":{"type":"string","title":"Buyer User Id"},"conversation_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Conversation Id"},"job_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Job Id"},"event_type":{"type":"string","title":"Event Type"},"amount_micros":{"type":"integer","title":"Amount Micros"},"provider_net_micros":{"type":"integer","title":"Provider Net Micros"},"platform_fee_micros":{"type":"integer","title":"Platform Fee Micros"},"quantity":{"type":"integer","title":"Quantity"},"unit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Unit"},"status":{"type":"string","title":"Status"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"buyer_email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Buyer Email"},"entitlement_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Entitlement Id"}},"type":"object","required":["id","service_id","buyer_user_id","conversation_id","job_id","event_type","amount_micros","provider_net_micros","platform_fee_micros","quantity","unit","status","created_at"],"title":"ServiceUsageEventResponse","description":"Buyer-facing event; the email is the authenticated buyer's own."},"ServiceWhitelabelUpdate":{"properties":{"enabled":{"type":"boolean","title":"Enabled","default":true}},"type":"object","title":"ServiceWhitelabelUpdate"},"SettlementSummaryPayload":{"properties":{"job_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Job Id"},"outcome":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Outcome"},"locked_micros":{"type":"integer","title":"Locked Micros"},"billable_micros":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Billable Micros"},"refund_micros":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Refund Micros"},"reason_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reason Code"},"reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reason"},"usage":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Usage"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"}},"type":"object","required":["job_id","outcome","locked_micros","billable_micros","refund_micros","reason_code","reason","usage","error"],"title":"SettlementSummaryPayload"},"SkillCreate":{"properties":{"name":{"type":"string","maxLength":64,"title":"Name"},"description":{"type":"string","maxLength":1024,"title":"Description"},"body":{"type":"string","maxLength":20000,"title":"Body"}},"additionalProperties":false,"type":"object","required":["name","description","body"],"title":"SkillCreate"},"SkillList":{"properties":{"skills":{"items":{"$ref":"#/components/schemas/SkillRow"},"type":"array","title":"Skills"}},"type":"object","required":["skills"],"title":"SkillList"},"SkillRow":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"description":{"type":"string","title":"Description"},"version":{"type":"integer","title":"Version"},"created_via":{"type":"string","enum":["mcp","web","chat"],"title":"Created Via"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["id","name","description","version","created_via","created_at","updated_at"],"title":"SkillRow","description":"A row of the Skills page; the body only comes with one skill."},"SkillUpdate":{"properties":{"version":{"type":"integer","minimum":1.0,"title":"Version"},"name":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Name"},"description":{"anyOf":[{"type":"string","maxLength":1024},{"type":"null"}],"title":"Description"},"body":{"anyOf":[{"type":"string","maxLength":20000},{"type":"null"}],"title":"Body"},"archived":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Archived"}},"additionalProperties":false,"type":"object","required":["version"],"title":"SkillUpdate","description":"Only the fields sent change; ``version`` is the one the editor loaded\n(409 ``version_conflict`` when it moved on). ``archived: true`` archives."},"SkillView":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"description":{"type":"string","title":"Description"},"version":{"type":"integer","title":"Version"},"created_via":{"type":"string","enum":["mcp","web","chat"],"title":"Created Via"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"},"body":{"type":"string","title":"Body"},"archived_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Archived At"}},"type":"object","required":["id","name","description","version","created_via","created_at","updated_at","body"],"title":"SkillView"},"SkillsCreated":{"properties":{"web":{"type":"integer","title":"Web","default":0},"chat":{"type":"integer","title":"Chat","default":0},"mcp":{"type":"integer","title":"Mcp","default":0}},"type":"object","title":"SkillsCreated"},"SnapshotCheckoutPlanRequest":{"properties":{"filesystem_binding_id":{"type":"string","maxLength":76,"pattern":"^lfb1-sha256:[0-9a-f]{64}$","title":"Filesystem Binding Id"},"supported_plan_versions":{"items":{"type":"integer","enum":[1,2]},"type":"array","maxItems":2,"minItems":1,"title":"Supported Plan Versions"}},"additionalProperties":false,"type":"object","required":["filesystem_binding_id"],"title":"SnapshotCheckoutPlanRequest"},"SnapshotCompletionOutboxHealth":{"properties":{"observed_at_seconds":{"type":"integer","title":"Observed At Seconds"},"pending_count":{"type":"integer","title":"Pending Count"},"claimed_count":{"type":"integer","title":"Claimed Count"},"parked_count":{"type":"integer","title":"Parked Count"},"due_pending_count":{"type":"integer","title":"Due Pending Count"},"expired_claim_count":{"type":"integer","title":"Expired Claim Count"},"oldest_due_at_seconds":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Oldest Due At Seconds"},"oldest_parked_at_seconds":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Oldest Parked At Seconds"}},"type":"object","required":["observed_at_seconds","pending_count","claimed_count","parked_count","due_pending_count","expired_claim_count"],"title":"SnapshotCompletionOutboxHealth"},"SnapshotCompletionParkedCursor":{"properties":{"parked_at_seconds":{"type":"integer","title":"Parked At Seconds"},"plan_id":{"type":"string","title":"Plan Id"},"effect_id":{"type":"string","title":"Effect Id"}},"type":"object","required":["parked_at_seconds","plan_id","effect_id"],"title":"SnapshotCompletionParkedCursor"},"SnapshotCompletionParkedEffect":{"properties":{"plan_id":{"type":"string","title":"Plan Id"},"effect_id":{"type":"string","title":"Effect Id"},"job_id":{"type":"string","title":"Job Id"},"result_id":{"type":"string","title":"Result Id"},"effect_key":{"type":"string","title":"Effect Key"},"kind":{"type":"string","title":"Kind"},"revision":{"type":"integer","title":"Revision"},"attempts":{"type":"integer","title":"Attempts"},"parked_at_seconds":{"type":"integer","title":"Parked At Seconds"},"error_code":{"type":"string","title":"Error Code"}},"type":"object","required":["plan_id","effect_id","job_id","result_id","effect_key","kind","revision","attempts","parked_at_seconds","error_code"],"title":"SnapshotCompletionParkedEffect"},"SnapshotCompletionParkedPage":{"properties":{"items":{"items":{"$ref":"#/components/schemas/SnapshotCompletionParkedEffect"},"type":"array","title":"Items"},"next_cursor":{"anyOf":[{"$ref":"#/components/schemas/SnapshotCompletionParkedCursor"},{"type":"null"}]}},"type":"object","required":["items"],"title":"SnapshotCompletionParkedPage"},"SnapshotFinalizeRequestV1":{"properties":{"version":{"type":"integer","const":1,"title":"Version"},"commit_id":{"type":"string","maxLength":255,"minLength":1,"title":"Commit Id"},"generation":{"type":"integer","maximum":9007199254740991.0,"minimum":0.0,"title":"Generation"},"idempotency_key":{"type":"string","maxLength":255,"minLength":1,"title":"Idempotency Key"},"proposed_root":{"type":"string","maxLength":74,"pattern":"^t1-sha256:[0-9a-f]{64}$","title":"Proposed Root"},"contract_hash":{"type":"string","maxLength":71,"pattern":"^sha256:[0-9a-f]{64}$","title":"Contract Hash"}},"additionalProperties":false,"type":"object","required":["version","commit_id","generation","idempotency_key","proposed_root","contract_hash"],"title":"SnapshotFinalizeRequestV1","description":"Exact READY commit identity accepted only for snapshot delivery."},"SnapshotFinalizeRequestV2":{"properties":{"version":{"type":"integer","const":2,"title":"Version"},"commit_id":{"type":"string","maxLength":255,"minLength":1,"title":"Commit Id"},"generation":{"type":"integer","maximum":9007199254740991.0,"minimum":0.0,"title":"Generation"},"idempotency_key":{"type":"string","maxLength":255,"minLength":1,"title":"Idempotency Key"},"output_set_id":{"type":"string","maxLength":75,"pattern":"^os1-sha256:[0-9a-f]{64}$","title":"Output Set Id"},"contract_hash":{"type":"string","maxLength":71,"pattern":"^sha256:[0-9a-f]{64}$","title":"Contract Hash"}},"additionalProperties":false,"type":"object","required":["version","commit_id","generation","idempotency_key","output_set_id","contract_hash"],"title":"SnapshotFinalizeRequestV2","description":"Exact aggregate READY identity accepted only for snapshot delivery."},"SnapshotGcHealth":{"properties":{"observed_at_seconds":{"type":"integer","title":"Observed At Seconds"},"marking_epoch_count":{"type":"integer","title":"Marking Epoch Count"},"sweeping_epoch_count":{"type":"integer","title":"Sweeping Epoch Count"},"failed_epoch_count":{"type":"integer","title":"Failed Epoch Count"},"pending_stage_count":{"type":"integer","title":"Pending Stage Count"},"claimed_stage_count":{"type":"integer","title":"Claimed Stage Count"},"parked_stage_count":{"type":"integer","title":"Parked Stage Count"},"due_pending_stage_count":{"type":"integer","title":"Due Pending Stage Count"},"expired_stage_claim_count":{"type":"integer","title":"Expired Stage Claim Count"},"oldest_stage_due_at_seconds":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Oldest Stage Due At Seconds"},"oldest_stage_parked_at_seconds":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Oldest Stage Parked At Seconds"},"active_root_authority_count":{"type":"integer","title":"Active Root Authority Count"},"tombstoned_count":{"type":"integer","title":"Tombstoned Count"},"delete_claimed_count":{"type":"integer","title":"Delete Claimed Count"},"cancelled_count":{"type":"integer","title":"Cancelled Count"},"deleted_count":{"type":"integer","title":"Deleted Count"},"due_tombstone_count":{"type":"integer","title":"Due Tombstone Count"},"expired_delete_claim_count":{"type":"integer","title":"Expired Delete Claim Count"},"oldest_delete_due_at_seconds":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Oldest Delete Due At Seconds"},"oldest_unreachable_since_seconds":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Oldest Unreachable Since Seconds"}},"type":"object","required":["observed_at_seconds","marking_epoch_count","sweeping_epoch_count","failed_epoch_count","pending_stage_count","claimed_stage_count","parked_stage_count","due_pending_stage_count","expired_stage_claim_count","active_root_authority_count","tombstoned_count","delete_claimed_count","cancelled_count","deleted_count","due_tombstone_count","expired_delete_claim_count"],"title":"SnapshotGcHealth"},"SnapshotGcRestoreCompletionRequest":{"properties":{"restore_plan_evidence":{"type":"string","maxLength":4096,"minLength":1,"title":"Restore Plan Evidence"},"restore_completion_evidence":{"type":"string","maxLength":4096,"minLength":1,"title":"Restore Completion Evidence"},"restore_root_inventory_evidence":{"type":"string","maxLength":4096,"minLength":1,"title":"Restore Root Inventory Evidence"}},"additionalProperties":false,"type":"object","required":["restore_plan_evidence","restore_completion_evidence","restore_root_inventory_evidence"],"title":"SnapshotGcRestoreCompletionRequest"},"SnapshotGcRestoreCompletionResponse":{"properties":{"restore_id":{"type":"string","format":"uuid","title":"Restore Id"},"recovery_evidence_ref":{"type":"string","title":"Recovery Evidence Ref"},"security_domain_id":{"type":"string","title":"Security Domain Id"},"authority_ref":{"type":"string","title":"Authority Ref"},"state":{"type":"string","const":"RELEASED","title":"State"},"root_count":{"type":"integer","title":"Root Count"},"restored_root_inventory_id":{"type":"string","pattern":"^gcri1-sha256:[0-9a-f]{64}$","title":"Restored Root Inventory Id"},"replayed":{"type":"boolean","title":"Replayed"}},"type":"object","required":["restore_id","recovery_evidence_ref","security_domain_id","authority_ref","state","root_count","restored_root_inventory_id","replayed"],"title":"SnapshotGcRestoreCompletionResponse"},"SnapshotGcRestoreRootBatchRequest":{"properties":{"restore_plan_evidence":{"type":"string","maxLength":4096,"minLength":1,"title":"Restore Plan Evidence"},"roots":{"items":{"$ref":"#/components/schemas/SnapshotGcRootAuthorityTarget"},"type":"array","maxItems":400,"minItems":1,"title":"Roots"}},"additionalProperties":false,"type":"object","required":["restore_plan_evidence","roots"],"title":"SnapshotGcRestoreRootBatchRequest"},"SnapshotGcRootAuthorityOperationRequest":{"properties":{"authority_kind":{"type":"string","enum":["HOLD","IMPORT","REPAIR","RESTORE"],"title":"Authority Kind"},"authority_ref":{"type":"string","maxLength":256,"minLength":1,"title":"Authority Ref"},"security_domain_id":{"type":"string","pattern":"^sd1_[0-9a-f]{32}$","title":"Security Domain Id"},"roots":{"items":{"$ref":"#/components/schemas/SnapshotGcRootAuthorityTarget"},"type":"array","maxItems":400,"minItems":1,"title":"Roots"}},"additionalProperties":false,"type":"object","required":["authority_kind","authority_ref","security_domain_id","roots"],"title":"SnapshotGcRootAuthorityOperationRequest"},"SnapshotGcRootAuthorityOperationResponse":{"properties":{"authority_kind":{"type":"string","enum":["HOLD","IMPORT","REPAIR","RESTORE"],"title":"Authority Kind"},"authority_ref":{"type":"string","title":"Authority Ref"},"security_domain_id":{"type":"string","title":"Security Domain Id"},"state":{"type":"string","enum":["ACTIVE","RELEASED"],"title":"State"},"root_count":{"type":"integer","title":"Root Count"},"roots":{"items":{"$ref":"#/components/schemas/SnapshotGcRootAuthorityTarget"},"type":"array","title":"Roots"},"replayed":{"type":"boolean","title":"Replayed"}},"type":"object","required":["authority_kind","authority_ref","security_domain_id","state","root_count","roots","replayed"],"title":"SnapshotGcRootAuthorityOperationResponse"},"SnapshotGcRootAuthorityTarget":{"properties":{"object_kind":{"type":"string","enum":["blob","manifest"],"title":"Object Kind"},"logical_id":{"type":"string","maxLength":74,"minLength":74,"pattern":"^(?:b1|t1)-sha256:[0-9a-f]{64}$","title":"Logical Id"}},"additionalProperties":false,"type":"object","required":["object_kind","logical_id"],"title":"SnapshotGcRootAuthorityTarget"},"SnapshotLatencyHistogram":{"properties":{"bucket_upper_bounds_seconds":{"items":{"type":"integer"},"type":"array","title":"Bucket Upper Bounds Seconds"},"cumulative_counts":{"items":{"type":"integer"},"type":"array","title":"Cumulative Counts"},"sample_count":{"type":"integer","title":"Sample Count"},"sample_sum_seconds":{"type":"integer","title":"Sample Sum Seconds"},"invalid_count":{"type":"integer","title":"Invalid Count"}},"type":"object","required":["bucket_upper_bounds_seconds","cumulative_counts","sample_count","sample_sum_seconds","invalid_count"],"title":"SnapshotLatencyHistogram"},"SnapshotLifecycleHealth":{"properties":{"observed_at_seconds":{"type":"integer","title":"Observed At Seconds"},"preparing_commit_count":{"type":"integer","title":"Preparing Commit Count"},"ready_commit_count":{"type":"integer","title":"Ready Commit Count"},"published_commit_count":{"type":"integer","title":"Published Commit Count"},"aborted_commit_count":{"type":"integer","title":"Aborted Commit Count"},"expired_commit_count":{"type":"integer","title":"Expired Commit Count"},"due_commit_expiry_count":{"type":"integer","title":"Due Commit Expiry Count"},"due_ready_recovery_count":{"type":"integer","title":"Due Ready Recovery Count"},"expired_recovery_claim_count":{"type":"integer","title":"Expired Recovery Claim Count"},"oldest_commit_expiry_due_at_seconds":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Oldest Commit Expiry Due At Seconds"},"oldest_ready_recovery_due_at_seconds":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Oldest Ready Recovery Due At Seconds"},"oldest_ready_at_seconds":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Oldest Ready At Seconds"},"prepare_to_ready_latency":{"$ref":"#/components/schemas/SnapshotLatencyHistogram"},"ready_to_published_latency":{"$ref":"#/components/schemas/SnapshotLatencyHistogram"},"prepare_to_published_latency":{"$ref":"#/components/schemas/SnapshotLatencyHistogram"},"file_artifact_count":{"type":"integer","title":"File Artifact Count"},"tree_artifact_count":{"type":"integer","title":"Tree Artifact Count"},"artifact_entry_total":{"type":"integer","title":"Artifact Entry Total"},"artifact_file_total":{"type":"integer","title":"Artifact File Total"},"artifact_logical_bytes_total":{"type":"integer","title":"Artifact Logical Bytes Total"},"quota_bucket_count":{"type":"integer","title":"Quota Bucket Count"},"quota_active_reservation_count":{"type":"integer","title":"Quota Active Reservation Count"},"quota_sealed_reservation_count":{"type":"integer","title":"Quota Sealed Reservation Count"},"quota_consumed_reservation_count":{"type":"integer","title":"Quota Consumed Reservation Count"},"quota_released_reservation_count":{"type":"integer","title":"Quota Released Reservation Count"},"quota_reserved_file_count":{"type":"integer","title":"Quota Reserved File Count"},"quota_reserved_logical_bytes":{"type":"integer","title":"Quota Reserved Logical Bytes"},"quota_used_file_count":{"type":"integer","title":"Quota Used File Count"},"quota_used_logical_bytes":{"type":"integer","title":"Quota Used Logical Bytes"},"quota_reservation_state_mismatch_count":{"type":"integer","title":"Quota Reservation State Mismatch Count"},"quota_bucket_counter_mismatch_count":{"type":"integer","title":"Quota Bucket Counter Mismatch Count"}},"type":"object","required":["observed_at_seconds","preparing_commit_count","ready_commit_count","published_commit_count","aborted_commit_count","expired_commit_count","due_commit_expiry_count","due_ready_recovery_count","expired_recovery_claim_count","prepare_to_ready_latency","ready_to_published_latency","prepare_to_published_latency","file_artifact_count","tree_artifact_count","artifact_entry_total","artifact_file_total","artifact_logical_bytes_total","quota_bucket_count","quota_active_reservation_count","quota_sealed_reservation_count","quota_consumed_reservation_count","quota_released_reservation_count","quota_reserved_file_count","quota_reserved_logical_bytes","quota_used_file_count","quota_used_logical_bytes","quota_reservation_state_mismatch_count","quota_bucket_counter_mismatch_count"],"title":"SnapshotLifecycleHealth"},"SnapshotOutputAggregateCapabilityResponseV2":{"properties":{"version":{"type":"integer","const":2,"title":"Version"},"capability_id":{"type":"string","maxLength":36,"pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$","title":"Capability Id"},"job_id":{"type":"string","maxLength":36,"minLength":1,"title":"Job Id"},"filesystem_binding_id":{"type":"string","maxLength":76,"pattern":"^lfb1-sha256:[0-9a-f]{64}$","title":"Filesystem Binding Id"},"file_contract_hash":{"type":"string","maxLength":71,"pattern":"^sha256:[0-9a-f]{64}$","title":"File Contract Hash"},"commit_id":{"type":"string","maxLength":36,"minLength":1,"title":"Commit Id"},"generation":{"type":"integer","maximum":9007199254740991.0,"minimum":0.0,"title":"Generation"},"plan_id":{"type":"string","maxLength":76,"pattern":"^sop1-sha256:[0-9a-f]{64}$","title":"Plan Id"},"staging_object_id":{"type":"string","maxLength":76,"pattern":"^soo1-sha256:[0-9a-f]{64}$","title":"Staging Object Id"},"request_binding_id":{"type":"string","maxLength":76,"pattern":"^sor1-sha256:[0-9a-f]{64}$","title":"Request Binding Id"},"transfer_kind":{"type":"string","const":"snapshot_output_bundle_v2","title":"Transfer Kind"},"bundle_id":{"type":"string","maxLength":76,"pattern":"^sob2-sha256:[0-9a-f]{64}$","title":"Bundle Id"},"member_count":{"type":"integer","maximum":256.0,"minimum":0.0,"title":"Member Count"},"payload_count":{"type":"integer","maximum":256.0,"minimum":0.0,"title":"Payload Count"},"semantic_entry_count":{"type":"integer","maximum":9007199254740991.0,"minimum":0.0,"title":"Semantic Entry Count"},"semantic_file_count":{"type":"integer","maximum":9007199254740991.0,"minimum":0.0,"title":"Semantic File Count"},"semantic_logical_bytes":{"type":"integer","maximum":9007199254740991.0,"minimum":0.0,"title":"Semantic Logical Bytes"},"payload_size_bytes":{"type":"integer","maximum":9007199254740991.0,"minimum":0.0,"title":"Payload Size Bytes"},"transfer_size_bytes":{"type":"integer","maximum":5368709120.0,"minimum":1.0,"title":"Transfer Size Bytes"},"transfer_sha256":{"type":"string","maxLength":64,"pattern":"^[0-9a-f]{64}$","title":"Transfer Sha256"},"method":{"type":"string","const":"PUT","title":"Method"},"url":{"type":"string","maxLength":8192,"minLength":1,"title":"Url"},"headers":{"additionalProperties":{"type":"string"},"type":"object","maxProperties":4,"minProperties":3,"title":"Headers"},"expires_at":{"type":"string","format":"date-time","title":"Expires At"},"plan_replayed":{"type":"boolean","title":"Plan Replayed"}},"additionalProperties":false,"type":"object","required":["version","capability_id","job_id","filesystem_binding_id","file_contract_hash","commit_id","generation","plan_id","staging_object_id","request_binding_id","transfer_kind","bundle_id","member_count","payload_count","semantic_entry_count","semantic_file_count","semantic_logical_bytes","payload_size_bytes","transfer_size_bytes","transfer_sha256","method","url","headers","expires_at","plan_replayed"],"title":"SnapshotOutputAggregateCapabilityResponseV2","description":"Exact privacy-reduced aggregate PUT bearer."},"SnapshotOutputAggregateCapabilityResponseV3":{"properties":{"version":{"type":"integer","const":3,"title":"Version"},"capability_id":{"type":"string","maxLength":36,"pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$","title":"Capability Id"},"job_id":{"type":"string","maxLength":36,"minLength":1,"title":"Job Id"},"filesystem_binding_id":{"type":"string","maxLength":76,"pattern":"^lfb1-sha256:[0-9a-f]{64}$","title":"Filesystem Binding Id"},"file_contract_hash":{"type":"string","maxLength":71,"pattern":"^sha256:[0-9a-f]{64}$","title":"File Contract Hash"},"commit_id":{"type":"string","maxLength":36,"minLength":1,"title":"Commit Id"},"generation":{"type":"integer","maximum":9007199254740991.0,"minimum":0.0,"title":"Generation"},"plan_id":{"type":"string","maxLength":76,"pattern":"^sop1-sha256:[0-9a-f]{64}$","title":"Plan Id"},"staging_object_id":{"type":"string","maxLength":76,"pattern":"^soo1-sha256:[0-9a-f]{64}$","title":"Staging Object Id"},"request_binding_id":{"type":"string","maxLength":76,"pattern":"^sor1-sha256:[0-9a-f]{64}$","title":"Request Binding Id"},"transfer_kind":{"type":"string","const":"snapshot_output_bundle_v3","title":"Transfer Kind"},"bundle_id":{"type":"string","maxLength":76,"pattern":"^sob3-sha256:[0-9a-f]{64}$","title":"Bundle Id"},"member_count":{"type":"integer","maximum":256.0,"minimum":0.0,"title":"Member Count"},"captured_member_count":{"type":"integer","maximum":256.0,"minimum":0.0,"title":"Captured Member Count"},"adopted_member_count":{"type":"integer","maximum":256.0,"minimum":0.0,"title":"Adopted Member Count"},"payload_count":{"type":"integer","maximum":256.0,"minimum":0.0,"title":"Payload Count"},"semantic_entry_count":{"type":"integer","maximum":9007199254740991.0,"minimum":0.0,"title":"Semantic Entry Count"},"semantic_file_count":{"type":"integer","maximum":9007199254740991.0,"minimum":0.0,"title":"Semantic File Count"},"semantic_logical_bytes":{"type":"integer","maximum":9007199254740991.0,"minimum":0.0,"title":"Semantic Logical Bytes"},"payload_size_bytes":{"type":"integer","maximum":9007199254740991.0,"minimum":0.0,"title":"Payload Size Bytes"},"transfer_size_bytes":{"type":"integer","maximum":5368709120.0,"minimum":1.0,"title":"Transfer Size Bytes"},"transfer_sha256":{"type":"string","maxLength":64,"pattern":"^[0-9a-f]{64}$","title":"Transfer Sha256"},"method":{"type":"string","const":"PUT","title":"Method"},"url":{"type":"string","maxLength":8192,"minLength":1,"title":"Url"},"headers":{"additionalProperties":{"type":"string"},"type":"object","maxProperties":4,"minProperties":3,"title":"Headers"},"expires_at":{"type":"string","format":"date-time","title":"Expires At"},"plan_replayed":{"type":"boolean","title":"Plan Replayed"}},"additionalProperties":false,"type":"object","required":["version","capability_id","job_id","filesystem_binding_id","file_contract_hash","commit_id","generation","plan_id","staging_object_id","request_binding_id","transfer_kind","bundle_id","member_count","captured_member_count","adopted_member_count","payload_count","semantic_entry_count","semantic_file_count","semantic_logical_bytes","payload_size_bytes","transfer_size_bytes","transfer_sha256","method","url","headers","expires_at","plan_replayed"],"title":"SnapshotOutputAggregateCapabilityResponseV3","description":"Exact privacy-reduced V3 direct-PUT bearer."},"SnapshotOutputAggregateCompletionResponseV2":{"properties":{"version":{"type":"integer","const":2,"title":"Version"},"job_id":{"type":"string","maxLength":36,"minLength":1,"title":"Job Id"},"filesystem_binding_id":{"type":"string","maxLength":76,"pattern":"^lfb1-sha256:[0-9a-f]{64}$","title":"Filesystem Binding Id"},"file_contract_hash":{"type":"string","maxLength":71,"pattern":"^sha256:[0-9a-f]{64}$","title":"File Contract Hash"},"idempotency_key":{"type":"string","maxLength":255,"minLength":1,"title":"Idempotency Key"},"bundle_id":{"type":"string","maxLength":76,"pattern":"^sob2-sha256:[0-9a-f]{64}$","title":"Bundle Id"},"transfer_sha256":{"type":"string","maxLength":64,"pattern":"^[0-9a-f]{64}$","title":"Transfer Sha256"},"state":{"type":"string","enum":["PENDING","CLAIMED","SUCCEEDED","PARKED"],"title":"State"},"intent_replayed":{"type":"boolean","title":"Intent Replayed"}},"additionalProperties":false,"type":"object","required":["version","job_id","filesystem_binding_id","file_contract_hash","idempotency_key","bundle_id","transfer_sha256","state","intent_replayed"],"title":"SnapshotOutputAggregateCompletionResponseV2","description":"Durable completion hint acknowledgement, not READY authority."},"SnapshotOutputAggregateCompletionResponseV3":{"properties":{"version":{"type":"integer","const":3,"title":"Version"},"job_id":{"type":"string","maxLength":36,"minLength":1,"title":"Job Id"},"filesystem_binding_id":{"type":"string","maxLength":76,"pattern":"^lfb1-sha256:[0-9a-f]{64}$","title":"Filesystem Binding Id"},"file_contract_hash":{"type":"string","maxLength":71,"pattern":"^sha256:[0-9a-f]{64}$","title":"File Contract Hash"},"idempotency_key":{"type":"string","maxLength":255,"minLength":1,"title":"Idempotency Key"},"bundle_id":{"type":"string","maxLength":76,"pattern":"^sob3-sha256:[0-9a-f]{64}$","title":"Bundle Id"},"transfer_sha256":{"type":"string","maxLength":64,"pattern":"^[0-9a-f]{64}$","title":"Transfer Sha256"},"state":{"type":"string","enum":["PENDING","CLAIMED","SUCCEEDED","PARKED"],"title":"State"},"intent_replayed":{"type":"boolean","title":"Intent Replayed"}},"additionalProperties":false,"type":"object","required":["version","job_id","filesystem_binding_id","file_contract_hash","idempotency_key","bundle_id","transfer_sha256","state","intent_replayed"],"title":"SnapshotOutputAggregateCompletionResponseV3","description":"Durable V3 completion hint acknowledgement, not READY authority."},"SnapshotOutputAggregateRequestV2":{"properties":{"version":{"type":"integer","const":2,"title":"Version"},"filesystem_binding_id":{"type":"string","maxLength":76,"pattern":"^lfb1-sha256:[0-9a-f]{64}$","title":"Filesystem Binding Id"},"file_contract_hash":{"type":"string","maxLength":71,"pattern":"^sha256:[0-9a-f]{64}$","title":"File Contract Hash"},"idempotency_key":{"type":"string","maxLength":255,"minLength":1,"title":"Idempotency Key"},"capture_generation":{"type":"integer","maximum":9007199254740991.0,"minimum":0.0,"title":"Capture Generation"},"capture_name":{"type":"string","maxLength":44,"pattern":"^stoutput-v1-[0-9a-f]{32}$","title":"Capture Name"},"bundle_id":{"type":"string","maxLength":76,"pattern":"^sob2-sha256:[0-9a-f]{64}$","title":"Bundle Id"},"member_count":{"type":"integer","maximum":256.0,"minimum":0.0,"title":"Member Count"},"payload_count":{"type":"integer","maximum":256.0,"minimum":0.0,"title":"Payload Count"},"semantic_entry_count":{"type":"integer","maximum":9007199254740991.0,"minimum":0.0,"title":"Semantic Entry Count"},"semantic_file_count":{"type":"integer","maximum":9007199254740991.0,"minimum":0.0,"title":"Semantic File Count"},"semantic_logical_bytes":{"type":"integer","maximum":9007199254740991.0,"minimum":0.0,"title":"Semantic Logical Bytes"},"payload_size_bytes":{"type":"integer","maximum":9007199254740991.0,"minimum":0.0,"title":"Payload Size Bytes"},"transfer_size_bytes":{"type":"integer","maximum":5497558138880.0,"minimum":1.0,"title":"Transfer Size Bytes"},"transfer_sha256":{"type":"string","maxLength":64,"pattern":"^[0-9a-f]{64}$","title":"Transfer Sha256"}},"additionalProperties":false,"type":"object","required":["version","filesystem_binding_id","file_contract_hash","idempotency_key","capture_generation","capture_name","bundle_id","member_count","payload_count","semantic_entry_count","semantic_file_count","semantic_logical_bytes","payload_size_bytes","transfer_size_bytes","transfer_sha256"],"title":"SnapshotOutputAggregateRequestV2","description":"Path-free identity used by aggregate state, upload and completion."},"SnapshotOutputAggregateRequestV3":{"properties":{"version":{"type":"integer","const":3,"title":"Version"},"filesystem_binding_id":{"type":"string","maxLength":76,"pattern":"^lfb1-sha256:[0-9a-f]{64}$","title":"Filesystem Binding Id"},"file_contract_hash":{"type":"string","maxLength":71,"pattern":"^sha256:[0-9a-f]{64}$","title":"File Contract Hash"},"idempotency_key":{"type":"string","maxLength":255,"minLength":1,"title":"Idempotency Key"},"capture_generation":{"type":"integer","maximum":9007199254740991.0,"minimum":0.0,"title":"Capture Generation"},"capture_name":{"type":"string","maxLength":44,"pattern":"^stoutput-v2-[0-9a-f]{32}$","title":"Capture Name"},"bundle_id":{"type":"string","maxLength":76,"pattern":"^sob3-sha256:[0-9a-f]{64}$","title":"Bundle Id"},"member_count":{"type":"integer","maximum":256.0,"minimum":0.0,"title":"Member Count"},"captured_member_count":{"type":"integer","maximum":256.0,"minimum":0.0,"title":"Captured Member Count"},"adopted_member_count":{"type":"integer","maximum":256.0,"minimum":0.0,"title":"Adopted Member Count"},"payload_count":{"type":"integer","maximum":256.0,"minimum":0.0,"title":"Payload Count"},"semantic_entry_count":{"type":"integer","maximum":9007199254740991.0,"minimum":0.0,"title":"Semantic Entry Count"},"semantic_file_count":{"type":"integer","maximum":9007199254740991.0,"minimum":0.0,"title":"Semantic File Count"},"semantic_logical_bytes":{"type":"integer","maximum":9007199254740991.0,"minimum":0.0,"title":"Semantic Logical Bytes"},"payload_size_bytes":{"type":"integer","maximum":9007199254740991.0,"minimum":0.0,"title":"Payload Size Bytes"},"transfer_size_bytes":{"type":"integer","maximum":5497558138880.0,"minimum":1.0,"title":"Transfer Size Bytes"},"transfer_sha256":{"type":"string","maxLength":64,"pattern":"^[0-9a-f]{64}$","title":"Transfer Sha256"}},"additionalProperties":false,"type":"object","required":["version","filesystem_binding_id","file_contract_hash","idempotency_key","capture_generation","capture_name","bundle_id","member_count","captured_member_count","adopted_member_count","payload_count","semantic_entry_count","semantic_file_count","semantic_logical_bytes","payload_size_bytes","transfer_size_bytes","transfer_sha256"],"title":"SnapshotOutputAggregateRequestV3","description":"Closed V3 identity with explicit captured/adopted source counts."},"SnapshotOutputAggregateStateResponseV2":{"properties":{"version":{"type":"integer","const":2,"title":"Version"},"state":{"type":"string","enum":["PREPARING","READY"],"title":"State"},"job_id":{"type":"string","maxLength":36,"minLength":1,"title":"Job Id"},"filesystem_binding_id":{"type":"string","maxLength":76,"pattern":"^lfb1-sha256:[0-9a-f]{64}$","title":"Filesystem Binding Id"},"file_contract_hash":{"type":"string","maxLength":71,"pattern":"^sha256:[0-9a-f]{64}$","title":"File Contract Hash"},"commit_id":{"type":"string","maxLength":36,"minLength":1,"title":"Commit Id"},"generation":{"type":"integer","maximum":9007199254740991.0,"minimum":0.0,"title":"Generation"},"bundle_id":{"type":"string","maxLength":76,"pattern":"^sob2-sha256:[0-9a-f]{64}$","title":"Bundle Id"},"transfer_sha256":{"type":"string","maxLength":64,"pattern":"^[0-9a-f]{64}$","title":"Transfer Sha256"},"output_set_id":{"anyOf":[{"type":"string","maxLength":75,"pattern":"^os1-sha256:[0-9a-f]{64}$"},{"type":"null"}],"title":"Output Set Id"}},"additionalProperties":false,"type":"object","required":["version","state","job_id","filesystem_binding_id","file_contract_hash","commit_id","generation","bundle_id","transfer_sha256"],"title":"SnapshotOutputAggregateStateResponseV2","description":"Compact provider state; polling reads no output members or tree leaves."},"SnapshotOutputAggregateStateResponseV3":{"properties":{"version":{"type":"integer","const":3,"title":"Version"},"state":{"type":"string","enum":["PREPARING","READY"],"title":"State"},"job_id":{"type":"string","maxLength":36,"minLength":1,"title":"Job Id"},"filesystem_binding_id":{"type":"string","maxLength":76,"pattern":"^lfb1-sha256:[0-9a-f]{64}$","title":"Filesystem Binding Id"},"file_contract_hash":{"type":"string","maxLength":71,"pattern":"^sha256:[0-9a-f]{64}$","title":"File Contract Hash"},"commit_id":{"type":"string","maxLength":36,"minLength":1,"title":"Commit Id"},"generation":{"type":"integer","maximum":9007199254740991.0,"minimum":0.0,"title":"Generation"},"bundle_id":{"type":"string","maxLength":76,"pattern":"^sob3-sha256:[0-9a-f]{64}$","title":"Bundle Id"},"transfer_sha256":{"type":"string","maxLength":64,"pattern":"^[0-9a-f]{64}$","title":"Transfer Sha256"},"output_set_id":{"anyOf":[{"type":"string","maxLength":75,"pattern":"^os1-sha256:[0-9a-f]{64}$"},{"type":"null"}],"title":"Output Set Id"}},"additionalProperties":false,"type":"object","required":["version","state","job_id","filesystem_binding_id","file_contract_hash","commit_id","generation","bundle_id","transfer_sha256"],"title":"SnapshotOutputAggregateStateResponseV3","description":"Version-separated compact state for one V3 capture."},"SnapshotOutputMultipartCompletionRequestV1":{"properties":{"version":{"type":"integer","const":1,"title":"Version"},"aggregate_version":{"type":"integer","enum":[2,3],"title":"Aggregate Version"},"continuation_token":{"type":"string","maxLength":8192,"minLength":1,"title":"Continuation Token"}},"additionalProperties":false,"type":"object","required":["version","aggregate_version","continuation_token"],"title":"SnapshotOutputMultipartCompletionRequestV1","description":"Bearer-authorized completion after every exact part is present."},"SnapshotOutputMultipartCompletionResponseV1":{"properties":{"version":{"type":"integer","const":1,"title":"Version"},"aggregate_version":{"type":"integer","enum":[2,3],"title":"Aggregate Version"},"job_id":{"type":"string","maxLength":36,"minLength":1,"title":"Job Id"},"plan_id":{"type":"string","maxLength":76,"pattern":"^sop1-sha256:[0-9a-f]{64}$","title":"Plan Id"},"state":{"type":"string","enum":["PENDING","CLAIMED","SUCCEEDED","PARKED"],"title":"State"},"multipart_replayed":{"type":"boolean","title":"Multipart Replayed"},"intent_replayed":{"type":"boolean","title":"Intent Replayed"}},"additionalProperties":false,"type":"object","required":["version","aggregate_version","job_id","plan_id","state","multipart_replayed","intent_replayed"],"title":"SnapshotOutputMultipartCompletionResponseV1","description":"Compact acknowledgement; READY still requires full-object verification."},"SnapshotOutputMultipartPartCapabilityV1":{"properties":{"part_number":{"type":"integer","maximum":10000.0,"minimum":1.0,"title":"Part Number"},"offset_bytes":{"type":"integer","maximum":9007199254740991.0,"minimum":0.0,"title":"Offset Bytes"},"size_bytes":{"type":"integer","maximum":5368709120.0,"minimum":1.0,"title":"Size Bytes"},"sha256":{"type":"string","maxLength":64,"pattern":"^[0-9a-f]{64}$","title":"Sha256"},"method":{"type":"string","const":"PUT","title":"Method"},"url":{"type":"string","maxLength":8192,"minLength":1,"title":"Url"},"headers":{"additionalProperties":{"type":"string"},"type":"object","maxProperties":2,"minProperties":2,"title":"Headers"},"expires_at":{"type":"string","format":"date-time","title":"Expires At"}},"additionalProperties":false,"type":"object","required":["part_number","offset_bytes","size_bytes","sha256","method","url","headers","expires_at"],"title":"SnapshotOutputMultipartPartCapabilityV1","description":"Exact ephemeral direct bearer for one missing part."},"SnapshotOutputMultipartPartChecksumRequestV1":{"properties":{"part_number":{"type":"integer","maximum":10000.0,"minimum":1.0,"title":"Part Number"},"sha256":{"type":"string","maxLength":64,"pattern":"^[0-9a-f]{64}$","title":"Sha256"}},"additionalProperties":false,"type":"object","required":["part_number","sha256"],"title":"SnapshotOutputMultipartPartChecksumRequestV1","description":"One local immutable part checksum used to bind an UploadPart bearer."},"SnapshotOutputMultipartPartPageRequestV1":{"properties":{"version":{"type":"integer","const":1,"title":"Version"},"aggregate_version":{"type":"integer","enum":[2,3],"title":"Aggregate Version"},"continuation_token":{"type":"string","maxLength":8192,"minLength":1,"title":"Continuation Token"},"parts":{"items":{"$ref":"#/components/schemas/SnapshotOutputMultipartPartChecksumRequestV1"},"type":"array","maxItems":32,"minItems":1,"title":"Parts"}},"additionalProperties":false,"type":"object","required":["version","aggregate_version","continuation_token","parts"],"title":"SnapshotOutputMultipartPartPageRequestV1","description":"Database-free request for one bounded contiguous capability page."},"SnapshotOutputMultipartPartPageResponseV1":{"properties":{"version":{"type":"integer","const":1,"title":"Version"},"requested_part_count":{"type":"integer","maximum":32.0,"minimum":1.0,"title":"Requested Part Count"},"existing_part_count":{"type":"integer","maximum":32.0,"minimum":0.0,"title":"Existing Part Count"},"capabilities":{"items":{"$ref":"#/components/schemas/SnapshotOutputMultipartPartCapabilityV1"},"type":"array","maxItems":32,"title":"Capabilities"}},"additionalProperties":false,"type":"object","required":["version","requested_part_count","existing_part_count","capabilities"],"title":"SnapshotOutputMultipartPartPageResponseV1","description":"Missing capabilities only; omitted requested parts already match S3."},"SnapshotOutputMultipartSessionRequestV1":{"properties":{"version":{"type":"integer","const":1,"title":"Version"},"aggregate":{"anyOf":[{"$ref":"#/components/schemas/SnapshotOutputAggregateRequestV2"},{"$ref":"#/components/schemas/SnapshotOutputAggregateRequestV3"}],"title":"Aggregate"}},"additionalProperties":false,"type":"object","required":["version","aggregate"],"title":"SnapshotOutputMultipartSessionRequestV1","description":"Authenticated task-scale admission or refresh for one multipart upload."},"SnapshotOutputMultipartSessionResponseV1":{"properties":{"version":{"type":"integer","const":1,"title":"Version"},"aggregate_version":{"type":"integer","enum":[2,3],"title":"Aggregate Version"},"state":{"type":"string","enum":["ACTIVE","COMPLETED"],"title":"State"},"job_id":{"type":"string","maxLength":36,"minLength":1,"title":"Job Id"},"filesystem_binding_id":{"type":"string","maxLength":76,"pattern":"^lfb1-sha256:[0-9a-f]{64}$","title":"Filesystem Binding Id"},"file_contract_hash":{"type":"string","maxLength":71,"pattern":"^sha256:[0-9a-f]{64}$","title":"File Contract Hash"},"bundle_id":{"type":"string","maxLength":76,"pattern":"^sob[23]-sha256:[0-9a-f]{64}$","title":"Bundle Id"},"commit_id":{"type":"string","maxLength":36,"minLength":1,"title":"Commit Id"},"generation":{"type":"integer","maximum":9007199254740991.0,"minimum":0.0,"title":"Generation"},"plan_id":{"type":"string","maxLength":76,"pattern":"^sop1-sha256:[0-9a-f]{64}$","title":"Plan Id"},"staging_object_id":{"type":"string","maxLength":76,"pattern":"^soo1-sha256:[0-9a-f]{64}$","title":"Staging Object Id"},"request_binding_id":{"type":"string","maxLength":76,"pattern":"^sor1-sha256:[0-9a-f]{64}$","title":"Request Binding Id"},"transfer_size_bytes":{"type":"integer","maximum":5497558138880.0,"minimum":1.0,"title":"Transfer Size Bytes"},"transfer_sha256":{"type":"string","maxLength":64,"pattern":"^[0-9a-f]{64}$","title":"Transfer Sha256"},"part_size_bytes":{"type":"integer","maximum":5368709120.0,"minimum":5242880.0,"title":"Part Size Bytes"},"part_count":{"type":"integer","maximum":10000.0,"minimum":1.0,"title":"Part Count"},"continuation_token":{"type":"string","maxLength":8192,"minLength":1,"title":"Continuation Token"},"continuation_expires_at":{"type":"string","format":"date-time","title":"Continuation Expires At"},"plan_replayed":{"type":"boolean","title":"Plan Replayed"},"session_replayed":{"type":"boolean","title":"Session Replayed"}},"additionalProperties":false,"type":"object","required":["version","aggregate_version","state","job_id","filesystem_binding_id","file_contract_hash","bundle_id","commit_id","generation","plan_id","staging_object_id","request_binding_id","transfer_size_bytes","transfer_sha256","part_size_bytes","part_count","continuation_token","continuation_expires_at","plan_replayed","session_replayed"],"title":"SnapshotOutputMultipartSessionResponseV1","description":"Compact plan plus ephemeral database-free continuation authority."},"SnapshotPrepareQuotaAmountV1":{"properties":{"file_count":{"type":"integer","maximum":9007199254740991.0,"minimum":0.0,"title":"File Count"},"logical_bytes":{"type":"integer","maximum":9007199254740991.0,"minimum":0.0,"title":"Logical Bytes"}},"additionalProperties":false,"type":"object","required":["file_count","logical_bytes"],"title":"SnapshotPrepareQuotaAmountV1","description":"Bounded provisional logical capacity requested before trusted sealing."},"SnapshotPrepareRequestV1":{"properties":{"version":{"type":"integer","const":1,"title":"Version"},"filesystem_binding_id":{"type":"string","maxLength":76,"pattern":"^lfb1-sha256:[0-9a-f]{64}$","title":"Filesystem Binding Id"},"idempotency_key":{"type":"string","maxLength":255,"minLength":1,"title":"Idempotency Key"},"requested_total":{"$ref":"#/components/schemas/SnapshotPrepareQuotaAmountV1"}},"additionalProperties":false,"type":"object","required":["version","filesystem_binding_id","idempotency_key","requested_total"],"title":"SnapshotPrepareRequestV1","description":"Provider request to create or exactly replay one hidden PREPARING commit."},"SnapshotPrepareReservationV1":{"properties":{"state":{"type":"string","enum":["ACTIVE","SEALED","CONSUMED","RELEASED"],"title":"State"},"revision":{"type":"integer","maximum":9007199254740991.0,"minimum":0.0,"title":"Revision"},"reserved":{"$ref":"#/components/schemas/SnapshotPrepareQuotaAmountV1"}},"additionalProperties":false,"type":"object","required":["state","revision","reserved"],"title":"SnapshotPrepareReservationV1","description":"Privacy-reduced current reservation returned to the owning provider."},"SnapshotPrepareResponseV1":{"properties":{"version":{"type":"integer","const":1,"title":"Version"},"job_id":{"type":"string","maxLength":36,"minLength":1,"title":"Job Id"},"filesystem_binding_id":{"type":"string","maxLength":76,"pattern":"^lfb1-sha256:[0-9a-f]{64}$","title":"Filesystem Binding Id"},"idempotency_key":{"type":"string","maxLength":255,"minLength":1,"title":"Idempotency Key"},"commit_id":{"type":"string","maxLength":36,"minLength":1,"title":"Commit Id"},"generation":{"type":"integer","maximum":9007199254740991.0,"minimum":0.0,"title":"Generation"},"state":{"type":"string","enum":["PREPARING","READY","PUBLISHED","ABORTED","EXPIRED"],"title":"State"},"file_contract_hash":{"type":"string","maxLength":71,"pattern":"^sha256:[0-9a-f]{64}$","title":"File Contract Hash"},"prepare_expires_at":{"type":"string","format":"date-time","title":"Prepare Expires At"},"reservation":{"$ref":"#/components/schemas/SnapshotPrepareReservationV1"}},"additionalProperties":false,"type":"object","required":["version","job_id","filesystem_binding_id","idempotency_key","commit_id","generation","state","file_contract_hash","prepare_expires_at","reservation"],"title":"SnapshotPrepareResponseV1","description":"Exact compact prepare state with no bucket or security-domain identifier."},"SnapshotStagingCapabilityRequestV1":{"properties":{"version":{"type":"integer","const":1,"title":"Version"},"filesystem_binding_id":{"type":"string","maxLength":76,"pattern":"^lfb1-sha256:[0-9a-f]{64}$","title":"Filesystem Binding Id"},"commit_id":{"type":"string","maxLength":36,"minLength":1,"title":"Commit Id"},"generation":{"type":"integer","maximum":9007199254740991.0,"minimum":0.0,"title":"Generation"},"proposed_root":{"type":"string","maxLength":74,"pattern":"^t1-sha256:[0-9a-f]{64}$","title":"Proposed Root"},"entry_count":{"type":"integer","maximum":1000000.0,"minimum":0.0,"title":"Entry Count"},"file_count":{"type":"integer","maximum":9007199254740991.0,"minimum":0.0,"title":"File Count"},"logical_bytes":{"type":"integer","maximum":9007199254740991.0,"minimum":0.0,"title":"Logical Bytes"},"transfer_size_bytes":{"type":"integer","maximum":5368709120.0,"minimum":1.0,"title":"Transfer Size Bytes"},"transfer_sha256":{"type":"string","maxLength":64,"pattern":"^[0-9a-f]{64}$","title":"Transfer Sha256"}},"additionalProperties":false,"type":"object","required":["version","filesystem_binding_id","commit_id","generation","proposed_root","entry_count","file_count","logical_bytes","transfer_size_bytes","transfer_sha256"],"title":"SnapshotStagingCapabilityRequestV1","description":"Complete generation-bound bundle intent for one exact direct PUT."},"SnapshotStagingCapabilityResponseV1":{"properties":{"version":{"type":"integer","const":1,"title":"Version"},"capability_id":{"type":"string","maxLength":36,"pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$","title":"Capability Id"},"job_id":{"type":"string","maxLength":36,"minLength":1,"title":"Job Id"},"filesystem_binding_id":{"type":"string","maxLength":76,"pattern":"^lfb1-sha256:[0-9a-f]{64}$","title":"Filesystem Binding Id"},"commit_id":{"type":"string","maxLength":36,"minLength":1,"title":"Commit Id"},"generation":{"type":"integer","maximum":9007199254740991.0,"minimum":0.0,"title":"Generation"},"plan_id":{"type":"string","maxLength":76,"pattern":"^sgp1-sha256:[0-9a-f]{64}$","title":"Plan Id"},"staging_object_id":{"type":"string","maxLength":76,"pattern":"^sgo1-sha256:[0-9a-f]{64}$","title":"Staging Object Id"},"request_binding_id":{"type":"string","maxLength":76,"pattern":"^srb1-sha256:[0-9a-f]{64}$","title":"Request Binding Id"},"transfer_kind":{"type":"string","const":"verified_bundle_v1","title":"Transfer Kind"},"proposed_root":{"type":"string","maxLength":74,"pattern":"^t1-sha256:[0-9a-f]{64}$","title":"Proposed Root"},"entry_count":{"type":"integer","maximum":1000000.0,"minimum":0.0,"title":"Entry Count"},"file_count":{"type":"integer","maximum":9007199254740991.0,"minimum":0.0,"title":"File Count"},"logical_bytes":{"type":"integer","maximum":9007199254740991.0,"minimum":0.0,"title":"Logical Bytes"},"transfer_size_bytes":{"type":"integer","maximum":5368709120.0,"minimum":1.0,"title":"Transfer Size Bytes"},"transfer_sha256":{"type":"string","maxLength":64,"pattern":"^[0-9a-f]{64}$","title":"Transfer Sha256"},"method":{"type":"string","const":"PUT","title":"Method"},"url":{"type":"string","maxLength":8192,"minLength":1,"title":"Url"},"headers":{"additionalProperties":{"type":"string"},"type":"object","maxProperties":4,"minProperties":3,"title":"Headers"},"expires_at":{"type":"string","format":"date-time","title":"Expires At"},"plan_replayed":{"type":"boolean","title":"Plan Replayed"}},"additionalProperties":false,"type":"object","required":["version","capability_id","job_id","filesystem_binding_id","commit_id","generation","plan_id","staging_object_id","request_binding_id","transfer_kind","proposed_root","entry_count","file_count","logical_bytes","transfer_size_bytes","transfer_sha256","method","url","headers","expires_at","plan_replayed"],"title":"SnapshotStagingCapabilityResponseV1","description":"Privacy-reduced exact PUT bearer returned only to the owning provider."},"SnapshotStagingCompletionRequestV1":{"properties":{"version":{"type":"integer","const":1,"title":"Version"},"filesystem_binding_id":{"type":"string","maxLength":76,"pattern":"^lfb1-sha256:[0-9a-f]{64}$","title":"Filesystem Binding Id"},"commit_id":{"type":"string","maxLength":36,"minLength":1,"title":"Commit Id"},"generation":{"type":"integer","maximum":9007199254740991.0,"minimum":0.0,"title":"Generation"},"plan_id":{"type":"string","maxLength":76,"pattern":"^sgp1-sha256:[0-9a-f]{64}$","title":"Plan Id"},"staging_object_id":{"type":"string","maxLength":76,"pattern":"^sgo1-sha256:[0-9a-f]{64}$","title":"Staging Object Id"},"request_binding_id":{"type":"string","maxLength":76,"pattern":"^srb1-sha256:[0-9a-f]{64}$","title":"Request Binding Id"}},"additionalProperties":false,"type":"object","required":["version","filesystem_binding_id","commit_id","generation","plan_id","staging_object_id","request_binding_id"],"title":"SnapshotStagingCompletionRequestV1","description":"Exact opaque staging identities reported after a direct PUT returns."},"SnapshotStagingCompletionResponseV1":{"properties":{"version":{"type":"integer","const":1,"title":"Version"},"intent_id":{"type":"string","maxLength":36,"pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$","title":"Intent Id"},"job_id":{"type":"string","maxLength":36,"minLength":1,"title":"Job Id"},"filesystem_binding_id":{"type":"string","maxLength":76,"pattern":"^lfb1-sha256:[0-9a-f]{64}$","title":"Filesystem Binding Id"},"commit_id":{"type":"string","maxLength":36,"minLength":1,"title":"Commit Id"},"generation":{"type":"integer","maximum":9007199254740991.0,"minimum":0.0,"title":"Generation"},"plan_id":{"type":"string","maxLength":76,"pattern":"^sgp1-sha256:[0-9a-f]{64}$","title":"Plan Id"},"staging_object_id":{"type":"string","maxLength":76,"pattern":"^sgo1-sha256:[0-9a-f]{64}$","title":"Staging Object Id"},"request_binding_id":{"type":"string","maxLength":76,"pattern":"^srb1-sha256:[0-9a-f]{64}$","title":"Request Binding Id"},"state":{"type":"string","enum":["PENDING","CLAIMED","SUCCEEDED","PARKED"],"title":"State"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"intent_replayed":{"type":"boolean","title":"Intent Replayed"}},"additionalProperties":false,"type":"object","required":["version","intent_id","job_id","filesystem_binding_id","commit_id","generation","plan_id","staging_object_id","request_binding_id","state","created_at","intent_replayed"],"title":"SnapshotStagingCompletionResponseV1","description":"Durable acknowledgement, not proof that the staged bytes are valid."},"SnapshotStagingHealth":{"properties":{"observed_at_seconds":{"type":"integer","title":"Observed At Seconds"},"verification_pending_count":{"type":"integer","title":"Verification Pending Count"},"verification_claimed_count":{"type":"integer","title":"Verification Claimed Count"},"verification_parked_count":{"type":"integer","title":"Verification Parked Count"},"verification_due_pending_count":{"type":"integer","title":"Verification Due Pending Count"},"verification_expired_claim_count":{"type":"integer","title":"Verification Expired Claim Count"},"oldest_verification_due_at_seconds":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Oldest Verification Due At Seconds"},"oldest_verification_parked_at_seconds":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Oldest Verification Parked At Seconds"},"verification_latency":{"$ref":"#/components/schemas/SnapshotLatencyHistogram"},"cleanup_pending_count":{"type":"integer","title":"Cleanup Pending Count"},"cleanup_claimed_count":{"type":"integer","title":"Cleanup Claimed Count"},"cleanup_due_pending_count":{"type":"integer","title":"Cleanup Due Pending Count"},"cleanup_expired_claim_count":{"type":"integer","title":"Cleanup Expired Claim Count"},"oldest_cleanup_due_at_seconds":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Oldest Cleanup Due At Seconds"}},"type":"object","required":["observed_at_seconds","verification_pending_count","verification_claimed_count","verification_parked_count","verification_due_pending_count","verification_expired_claim_count","verification_latency","cleanup_pending_count","cleanup_claimed_count","cleanup_due_pending_count","cleanup_expired_claim_count"],"title":"SnapshotStagingHealth"},"SpendingLimitUpdate":{"properties":{"threshold_micros":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Threshold Micros"}},"type":"object","title":"SpendingLimitUpdate"},"StringScopeField":{"properties":{"type":{"type":"string","const":"string","title":"Type","default":"string"},"title":{"type":"string","maxLength":100,"minLength":1,"title":"Title"},"description":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}],"title":"Description"},"allowed_values":{"items":{"type":"string"},"type":"array","maxItems":100,"minItems":1,"title":"Allowed Values"}},"additionalProperties":false,"type":"object","required":["title","allowed_values"],"title":"StringScopeField"},"SubHireCompensationRow":{"properties":{"conversation_id":{"type":"string","title":"Conversation Id"},"step_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Step Label"},"service_title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Service Title"},"provider_display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provider Display Name"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"cost_micros":{"type":"integer","title":"Cost Micros"},"escrow_locked_micros":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Escrow Locked Micros"},"funded_by_owner":{"type":"boolean","title":"Funded By Owner","default":true},"missing":{"type":"boolean","title":"Missing","default":false}},"type":"object","required":["conversation_id","cost_micros"],"title":"SubHireCompensationRow","description":"One sub-agent the owner's agent hired to fulfil an engagement."},"SubHireEngagementRow":{"properties":{"conversation_id":{"type":"string","title":"Conversation Id"},"service_title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Service Title"},"worker_agent_id":{"type":"string","title":"Worker Agent Id"},"worker_agent_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Worker Agent Name"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"revenue_micros":{"type":"integer","title":"Revenue Micros"},"sub_hire_spend_micros":{"type":"integer","title":"Sub Hire Spend Micros"},"margin_micros":{"type":"integer","title":"Margin Micros"},"refunded":{"type":"boolean","title":"Refunded","default":false},"funding_anomaly":{"type":"boolean","title":"Funding Anomaly","default":false},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated At"},"sub_hires":{"items":{"$ref":"#/components/schemas/SubHireCompensationRow"},"type":"array","title":"Sub Hires"}},"type":"object","required":["conversation_id","worker_agent_id","revenue_micros","sub_hire_spend_micros","margin_micros"],"title":"SubHireEngagementRow","description":"An engagement one of the owner's agents ran, with its sub-hire economics."},"SubHireSpendResponse":{"properties":{"totals":{"$ref":"#/components/schemas/SubHireSpendTotals"},"engagements":{"items":{"$ref":"#/components/schemas/SubHireEngagementRow"},"type":"array","title":"Engagements"},"truncated":{"type":"boolean","title":"Truncated","default":false}},"type":"object","required":["totals","engagements"],"title":"SubHireSpendResponse"},"SubHireSpendTotals":{"properties":{"revenue_micros":{"type":"integer","title":"Revenue Micros"},"sub_hire_spend_micros":{"type":"integer","title":"Sub Hire Spend Micros"},"margin_micros":{"type":"integer","title":"Margin Micros"},"engagement_count":{"type":"integer","title":"Engagement Count"},"sub_hire_count":{"type":"integer","title":"Sub Hire Count"},"loss_engagement_count":{"type":"integer","title":"Loss Engagement Count"},"funding_anomaly_count":{"type":"integer","title":"Funding Anomaly Count"}},"type":"object","required":["revenue_micros","sub_hire_spend_micros","margin_micros","engagement_count","sub_hire_count","loss_engagement_count","funding_anomaly_count"],"title":"SubHireSpendTotals"},"SumPriceRule":{"properties":{"kind":{"type":"string","const":"sum","title":"Kind","default":"sum"},"components":{"items":{"oneOf":[{"$ref":"#/components/schemas/ConstantPriceRule"},{"$ref":"#/components/schemas/LookupPriceRule"},{"$ref":"#/components/schemas/UnitSchedulePriceRule"}],"discriminator":{"propertyName":"kind","mapping":{"constant":"#/components/schemas/ConstantPriceRule","lookup":"#/components/schemas/LookupPriceRule","unit_schedule":"#/components/schemas/UnitSchedulePriceRule"}}},"type":"array","maxItems":10,"minItems":1,"title":"Components"}},"additionalProperties":false,"type":"object","required":["components"],"title":"SumPriceRule"},"SupportChatAttachment":{"properties":{"file_id":{"type":"string","title":"File Id"},"name":{"type":"string","title":"Name"},"content_type":{"type":"string","title":"Content Type"},"size_bytes":{"type":"integer","title":"Size Bytes"},"transcript":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Transcript"}},"type":"object","required":["file_id","name","content_type","size_bytes"],"title":"SupportChatAttachment","description":"A file on a support turn. The bytes are served by the platform's own\nfile endpoint (`GET /v1/files/{file_id}/content`), which already authorizes\nthe owner and admins — so nothing here is a second download path."},"SupportChatMessage":{"properties":{"id":{"type":"string","title":"Id"},"attachment":{"anyOf":[{"$ref":"#/components/schemas/SupportChatAttachment"},{"type":"null"}]},"sender":{"type":"string","enum":["user","bot","staff"],"title":"Sender"},"sender_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sender Name"},"body":{"type":"string","title":"Body"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","sender","body","created_at"],"title":"SupportChatMessage"},"SupportChatMessageCreate":{"properties":{"body":{"type":"string","maxLength":4000,"minLength":1,"title":"Body"}},"type":"object","required":["body"],"title":"SupportChatMessageCreate"},"SupportChatState":{"properties":{"enabled":{"type":"boolean","title":"Enabled","default":true},"thread":{"anyOf":[{"$ref":"#/components/schemas/SupportChatThread"},{"type":"null"}]},"messages":{"items":{"$ref":"#/components/schemas/SupportChatMessage"},"type":"array","title":"Messages"},"team_notified":{"type":"boolean","title":"Team Notified","default":false},"bot_replying":{"type":"boolean","title":"Bot Replying","default":false}},"type":"object","required":["thread","messages"],"title":"SupportChatState","description":"Everything the widget needs in one response.\n\nDeliberately no staff-presence flag. Who is at a desk this second says\nnothing about who picks a thread up, and showing it invites the customer to\nread a green dot as a promise; the answer is the same either way — the team\ncomes back to you here and by email."},"SupportChatThread":{"properties":{"id":{"type":"string","title":"Id"},"status":{"type":"string","enum":["open","closed"],"title":"Status"},"closed_by_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Closed By Name"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","status","created_at"],"title":"SupportChatThread"},"SupportInboxDetail":{"properties":{"thread":{"$ref":"#/components/schemas/SupportInboxThread"},"messages":{"items":{"$ref":"#/components/schemas/SupportChatMessage"},"type":"array","title":"Messages"}},"type":"object","required":["thread","messages"],"title":"SupportInboxDetail"},"SupportInboxList":{"properties":{"threads":{"items":{"$ref":"#/components/schemas/SupportInboxThread"},"type":"array","title":"Threads"},"total":{"type":"integer","title":"Total"},"awaiting_reply":{"type":"integer","title":"Awaiting Reply"}},"type":"object","required":["threads","total","awaiting_reply"],"title":"SupportInboxList"},"SupportInboxThread":{"properties":{"id":{"type":"string","title":"Id"},"user_id":{"type":"string","title":"User Id"},"user_email":{"type":"string","title":"User Email"},"status":{"type":"string","enum":["open","closed"],"title":"Status"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"last_message_at":{"type":"string","format":"date-time","title":"Last Message At"},"message_count":{"type":"integer","title":"Message Count"},"last_message":{"type":"string","title":"Last Message"},"awaiting_reply":{"type":"boolean","title":"Awaiting Reply"},"forwarded":{"type":"boolean","title":"Forwarded"},"triage_confidence":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Triage Confidence"},"triage_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Triage Reason"}},"type":"object","required":["id","user_id","user_email","status","created_at","last_message_at","message_count","last_message","awaiting_reply","forwarded"],"title":"SupportInboxThread","description":"One row of the console inbox."},"SupportStaffReply":{"properties":{"body":{"type":"string","maxLength":4000,"minLength":1,"title":"Body"}},"type":"object","required":["body"],"title":"SupportStaffReply"},"SuppressionRequest":{"properties":{"email":{"type":"string","format":"email","title":"Email"},"blocked":{"type":"boolean","title":"Blocked"},"reason":{"type":"string","enum":["invalid_address","spam_complaint"],"title":"Reason","default":"invalid_address"}},"additionalProperties":false,"type":"object","required":["email","blocked"],"title":"SuppressionRequest"},"SuppressionStatus":{"properties":{"reason":{"type":"string","title":"Reason"},"source":{"type":"string","title":"Source"},"actor_user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Actor User Id"},"recorded_at":{"type":"string","format":"date-time","title":"Recorded At"}},"type":"object","required":["reason","source","actor_user_id","recorded_at"],"title":"SuppressionStatus"},"TaskAcceptanceSettlementPolicy":{"properties":{"kind":{"type":"string","const":"task_acceptance","title":"Kind","default":"task_acceptance"},"buyer_review_required":{"type":"boolean","title":"Buyer Review Required","default":true},"auto_accept_after_seconds":{"anyOf":[{"type":"integer","maximum":2592000.0,"minimum":1.0},{"type":"null"}],"title":"Auto Accept After Seconds"},"provider_adjustments":{"type":"string","enum":["forbidden","bounded_policy"],"title":"Provider Adjustments","default":"forbidden"},"default_billable_rule":{"type":"string","maxLength":100,"title":"Default Billable Rule","default":"full_on_delivery"},"supported_outcomes":{"items":{"type":"string","enum":["delivered","reduced","non_billable","failed_provider"]},"type":"array","maxItems":4,"minItems":1,"title":"Supported Outcomes"},"allowed_reason_codes":{"items":{"type":"string"},"type":"array","maxItems":100,"title":"Allowed Reason Codes"},"auto_accept_adjustments":{"type":"string","enum":["never","allow_if_within_policy"],"title":"Auto Accept Adjustments","default":"never"},"max_auto_refund_micros":{"anyOf":[{"type":"integer","maximum":9007199254740991.0,"minimum":0.0},{"type":"null"}],"title":"Max Auto Refund Micros"},"adjustment_rules":{"items":{"$ref":"#/components/schemas/TaskSettlementAdjustmentRule"},"type":"array","maxItems":50,"title":"Adjustment Rules"}},"additionalProperties":false,"type":"object","title":"TaskAcceptanceSettlementPolicy"},"TaskFulfillmentPolicy":{"properties":{"kind":{"type":"string","const":"task","title":"Kind","default":"task"},"bindings":{"items":{"$ref":"#/components/schemas/ScopeJobBinding"},"type":"array","maxItems":25,"title":"Bindings"},"batch":{"anyOf":[{"$ref":"#/components/schemas/BatchItemsPolicy"},{"type":"null"}]}},"additionalProperties":false,"type":"object","title":"TaskFulfillmentPolicy"},"TaskOrderResult":{"properties":{"kind":{"type":"string","const":"task","title":"Kind","default":"task"},"order_id":{"type":"string","title":"Order Id"},"contract_id":{"type":"string","title":"Contract Id"},"job_id":{"type":"string","title":"Job Id"},"conversation_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Conversation Id"},"execution_status":{"anyOf":[{"type":"string","enum":["queued","in_progress"]},{"type":"null"}],"title":"Execution Status"},"queue":{"anyOf":[{"$ref":"#/components/schemas/JobQueueSnapshot"},{"type":"null"}]}},"additionalProperties":false,"type":"object","required":["order_id","contract_id","job_id"],"title":"TaskOrderResult"},"TaskSettlementAdjustmentRule":{"properties":{"reason_code":{"type":"string","maxLength":100,"minLength":1,"title":"Reason Code"},"billable_rule":{"type":"string","maxLength":100,"minLength":1,"title":"Billable Rule"},"outcome":{"anyOf":[{"type":"string","enum":["delivered","reduced","non_billable","failed_provider"]},{"type":"null"}],"title":"Outcome"},"description":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}],"title":"Description"},"minimum_billable_micros":{"anyOf":[{"type":"integer","maximum":9007199254740991.0,"minimum":0.0},{"type":"null"}],"title":"Minimum Billable Micros"},"maximum_billable_micros":{"anyOf":[{"type":"integer","maximum":9007199254740991.0,"minimum":0.0},{"type":"null"}],"title":"Maximum Billable Micros"},"percentage_discount_bps":{"anyOf":[{"type":"integer","maximum":10000.0,"minimum":0.0},{"type":"null"}],"title":"Percentage Discount Bps"},"broker_metering":{"anyOf":[{"$ref":"#/components/schemas/TaskSettlementBrokerMetering"},{"type":"null"}]}},"additionalProperties":false,"type":"object","required":["reason_code","billable_rule"],"title":"TaskSettlementAdjustmentRule"},"TaskSettlementBrokerMetering":{"properties":{"tool_name":{"type":"string","maxLength":200,"minLength":1,"title":"Tool Name"},"per_unit_micros":{"type":"integer","maximum":9007199254740991.0,"exclusiveMinimum":0.0,"title":"Per Unit Micros"}},"additionalProperties":false,"type":"object","required":["tool_name","per_unit_micros"],"title":"TaskSettlementBrokerMetering"},"TextDocumentMetadata":{"properties":{"id":{"type":"string","title":"Id"},"kind":{"type":"string","title":"Kind"},"title":{"type":"string","title":"Title"},"storage_uri":{"type":"string","title":"Storage Uri"},"effective_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Effective At"},"content_hash":{"type":"string","title":"Content Hash"},"size_bytes":{"type":"integer","title":"Size Bytes"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"}},"type":"object","required":["id","kind","title","storage_uri","content_hash","size_bytes","created_at"],"title":"TextDocumentMetadata"},"ToolboxUsage":{"properties":{"people_connected":{"type":"integer","title":"People Connected"},"connections_added":{"type":"integer","title":"Connections Added"},"connections_removed":{"type":"integer","title":"Connections Removed"},"actions":{"$ref":"#/components/schemas/Pair"},"actions_done":{"type":"integer","title":"Actions Done"},"actions_failed":{"type":"integer","title":"Actions Failed"},"asked_first":{"type":"integer","title":"Asked First"},"approved":{"type":"integer","title":"Approved"},"apps":{"items":{"$ref":"#/components/schemas/AppUsage"},"type":"array","title":"Apps"},"skills_created":{"$ref":"#/components/schemas/SkillsCreated"},"assistants_with_skills":{"type":"integer","title":"Assistants With Skills"}},"type":"object","required":["people_connected","connections_added","connections_removed","actions","actions_done","actions_failed","asked_first","approved","apps","skills_created","assistants_with_skills"],"title":"ToolboxUsage"},"TrustedMeasurementEvidence":{"properties":{"value":{"anyOf":[{"type":"integer"},{"type":"string"}],"title":"Value"},"artifact_binding_key":{"type":"string","maxLength":200,"minLength":1,"title":"Artifact Binding Key"},"artifact_sha256":{"type":"string","pattern":"^[0-9a-f]{64}$","title":"Artifact Sha256"},"measure":{"type":"string","maxLength":100,"minLength":1,"title":"Measure"},"measured_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Measured At"},"method":{"type":"string","maxLength":200,"minLength":1,"title":"Method"},"tool":{"type":"string","maxLength":200,"minLength":1,"title":"Tool"}},"additionalProperties":false,"type":"object","required":["value","artifact_binding_key","artifact_sha256","measure","method","tool"],"title":"TrustedMeasurementEvidence"},"UnitPriceRange":{"properties":{"from":{"type":"integer","maximum":1000000000.0,"minimum":1.0,"title":"From"},"to":{"type":"integer","maximum":1000000000.0,"minimum":1.0,"title":"To"},"unit_price_micros":{"type":"integer","maximum":9007199254740991.0,"minimum":0.0,"title":"Unit Price Micros"},"minimum_total_micros":{"anyOf":[{"type":"integer","maximum":9007199254740991.0,"minimum":0.0},{"type":"null"}],"title":"Minimum Total Micros"}},"additionalProperties":false,"type":"object","required":["from","to","unit_price_micros"],"title":"UnitPriceRange","description":"One inclusive commercial-unit range and its per-unit rate."},"UnitQuantity":{"properties":{"parameter":{"$ref":"#/components/schemas/ParameterReference"},"unit":{"type":"string","maxLength":100,"minLength":1,"title":"Unit"},"unit_scale":{"type":"integer","maximum":1000000000.0,"minimum":1.0,"title":"Unit Scale","default":1},"minimum_units":{"type":"integer","maximum":1000000000.0,"minimum":0.0,"title":"Minimum Units","default":1},"maximum_units":{"type":"integer","maximum":1000000000.0,"minimum":1.0,"title":"Maximum Units"},"rounding":{"type":"string","const":"ceil","title":"Rounding","default":"ceil"}},"additionalProperties":false,"type":"object","required":["parameter","unit","maximum_units"],"title":"UnitQuantity","description":"Convert one non-negative raw integer into bounded commercial units."},"UnitSchedulePriceRule":{"properties":{"kind":{"type":"string","const":"unit_schedule","title":"Kind","default":"unit_schedule"},"name":{"type":"string","maxLength":100,"minLength":1,"title":"Name"},"quantity":{"$ref":"#/components/schemas/UnitQuantity"},"mode":{"type":"string","enum":["graduated","volume"],"title":"Mode","default":"graduated"},"ranges":{"items":{"$ref":"#/components/schemas/UnitPriceRange"},"type":"array","maxItems":100,"minItems":1,"title":"Ranges"}},"additionalProperties":false,"type":"object","required":["name","quantity","ranges"],"title":"UnitSchedulePriceRule"},"UsageAdjustedSettlementPolicy":{"properties":{"kind":{"type":"string","const":"usage_adjusted","title":"Kind","default":"usage_adjusted"},"measure":{"$ref":"#/components/schemas/ParameterReference"},"evidence_required":{"type":"boolean","title":"Evidence Required","default":true},"buyer_review_required":{"type":"boolean","title":"Buyer Review Required","default":true},"evidence_mode":{"type":"string","enum":["provider_artifact","platform_observed"],"title":"Evidence Mode","default":"provider_artifact"},"required_evidence_kinds":{"items":{"type":"string"},"type":"array","maxItems":20,"minItems":1,"title":"Required Evidence Kinds"},"review_window_seconds":{"type":"integer","maximum":2592000.0,"minimum":3600.0,"title":"Review Window Seconds","default":604800},"report_due_after_seconds":{"type":"integer","maximum":2592000.0,"minimum":60.0,"title":"Report Due After Seconds","default":86400},"verifier_key":{"anyOf":[{"type":"string","maxLength":100,"minLength":1},{"type":"null"}],"title":"Verifier Key"},"verifier_version":{"anyOf":[{"type":"integer","maximum":1000000.0,"minimum":1.0},{"type":"null"}],"title":"Verifier Version"},"evidence_retention_policy_version":{"type":"integer","const":1,"title":"Evidence Retention Policy Version","default":1}},"additionalProperties":false,"type":"object","required":["measure"],"title":"UsageAdjustedSettlementPolicy"},"UsageDigestContent":{"properties":{"metrics":{"items":{"type":"string","enum":["total_users","dau","wau","mau","revenue_users_24h","net_usd","active_stable_services"]},"type":"array","maxItems":8,"minItems":1,"title":"Metrics"},"presentation":{"type":"string","enum":["values","graphs","both"],"title":"Presentation","default":"both"},"history_days":{"type":"integer","enum":[7,30],"title":"History Days","default":7},"service_activity":{"type":"boolean","title":"Service Activity","default":true}},"type":"object","title":"UsageDigestContent"},"UsageDigestSettingsResponse":{"properties":{"metrics":{"items":{"type":"string","enum":["total_users","dau","wau","mau","revenue_users_24h","net_usd","active_stable_services"]},"type":"array","maxItems":8,"minItems":1,"title":"Metrics"},"presentation":{"type":"string","enum":["values","graphs","both"],"title":"Presentation","default":"both"},"history_days":{"type":"integer","enum":[7,30],"title":"History Days","default":7},"service_activity":{"type":"boolean","title":"Service Activity","default":true},"slack_configured":{"type":"boolean","title":"Slack Configured"},"telegram_configured":{"type":"boolean","title":"Telegram Configured"},"telegram_bot_id":{"type":"string","title":"Telegram Bot Id","default":""},"telegram_chat_id":{"type":"string","title":"Telegram Chat Id"},"cadence":{"type":"string","enum":["daily","weekly"],"title":"Cadence"},"hour":{"type":"integer","title":"Hour"},"timezone":{"type":"string","title":"Timezone"},"scheduled_here":{"type":"boolean","title":"Scheduled Here"},"last_posted_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Posted At"}},"type":"object","required":["slack_configured","telegram_configured","telegram_chat_id","cadence","hour","timezone","scheduled_here"],"title":"UsageDigestSettingsResponse"},"UsageDigestSettingsUpdate":{"properties":{"metrics":{"anyOf":[{"items":{"type":"string","enum":["total_users","dau","wau","mau","revenue_users_24h","net_usd","active_stable_services"]},"type":"array","maxItems":8,"minItems":1},{"type":"null"}],"title":"Metrics"},"presentation":{"anyOf":[{"type":"string","enum":["values","graphs","both"]},{"type":"null"}],"title":"Presentation"},"history_days":{"anyOf":[{"type":"integer","enum":[7,30]},{"type":"null"}],"title":"History Days"},"service_activity":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Service Activity"},"slack_webhook_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Slack Webhook Url"},"telegram_bot_token":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Telegram Bot Token"},"telegram_chat_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Telegram Chat Id"},"cadence":{"anyOf":[{"type":"string","enum":["daily","weekly"]},{"type":"null"}],"title":"Cadence"},"hour":{"anyOf":[{"type":"integer","maximum":23.0,"minimum":0.0},{"type":"null"}],"title":"Hour"},"timezone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timezone"}},"type":"object","title":"UsageDigestSettingsUpdate","description":"Partial update: omit a field to keep it, send \"\" to clear a secret."},"UsageDigestTestRequest":{"properties":{"destination":{"anyOf":[{"type":"string","enum":["slack","telegram"]},{"type":"null"}],"title":"Destination"},"content":{"anyOf":[{"$ref":"#/components/schemas/UsageDigestContent"},{"type":"null"}]}},"type":"object","title":"UsageDigestTestRequest"},"UsageDigestTestResponse":{"properties":{"message":{"type":"string","title":"Message"},"delivery":{"additionalProperties":{"anyOf":[{"type":"string"},{"type":"null"}]},"type":"object","title":"Delivery"}},"type":"object","required":["message","delivery"],"title":"UsageDigestTestResponse"},"UsageDisputeProviderResponse":{"properties":{"version":{"type":"integer","const":1,"title":"Version","default":1},"response_id":{"type":"string","title":"Response Id"},"dispute_id":{"type":"string","title":"Dispute Id"},"contract_id":{"type":"string","title":"Contract Id"},"contract_hash":{"type":"string","title":"Contract Hash"},"job_id":{"type":"string","title":"Job Id"},"provider_agent_id":{"type":"string","title":"Provider Agent Id"},"actor_type":{"type":"string","enum":["provider_owner","provider_agent"],"title":"Actor Type"},"statement":{"type":"string","title":"Statement"},"submitted_at":{"type":"string","format":"date-time","title":"Submitted At"}},"additionalProperties":false,"type":"object","required":["response_id","dispute_id","contract_id","contract_hash","job_id","provider_agent_id","actor_type","statement","submitted_at"],"title":"UsageDisputeProviderResponse"},"UsageDisputeProviderResponseCreate":{"properties":{"version":{"type":"integer","const":1,"title":"Version","default":1},"statement":{"type":"string","maxLength":4000,"minLength":1,"title":"Statement"}},"additionalProperties":false,"type":"object","required":["statement"],"title":"UsageDisputeProviderResponseCreate"},"UsageEvidenceReference":{"properties":{"kind":{"type":"string","maxLength":100,"minLength":1,"title":"Kind"},"uri":{"type":"string","maxLength":500,"pattern":"^delegate-file://[^/\\s]+$","title":"Uri"}},"additionalProperties":false,"type":"object","required":["kind","uri"],"title":"UsageEvidenceReference"},"UsageEvidenceResponse":{"properties":{"evidence_id":{"type":"string","title":"Evidence Id"},"kind":{"type":"string","title":"Kind"},"uri":{"type":"string","title":"Uri"},"artifact_digest":{"type":"string","title":"Artifact Digest"},"identity_provenance":{"type":"string","const":"storage_observed","title":"Identity Provenance"},"retain_until":{"type":"string","format":"date-time","title":"Retain Until"}},"additionalProperties":false,"type":"object","required":["evidence_id","kind","uri","artifact_digest","identity_provenance","retain_until"],"title":"UsageEvidenceResponse"},"UsageQuantity":{"properties":{"unit":{"type":"string","maxLength":100,"minLength":1,"title":"Unit"},"value":{"type":"integer","minimum":0.0,"title":"Value"}},"additionalProperties":false,"type":"object","required":["unit","value"],"title":"UsageQuantity"},"UsageReportCreate":{"properties":{"version":{"type":"integer","const":1,"title":"Version","default":1},"quantity":{"$ref":"#/components/schemas/UsageQuantity"},"evidence":{"items":{"$ref":"#/components/schemas/UsageEvidenceReference"},"type":"array","maxItems":100,"minItems":1,"title":"Evidence"},"supersedes_report_id":{"anyOf":[{"type":"string","maxLength":200,"minLength":1},{"type":"null"}],"title":"Supersedes Report Id"}},"additionalProperties":false,"type":"object","required":["quantity","evidence"],"title":"UsageReportCreate"},"UsageReportHistoryResponse":{"properties":{"contract_id":{"type":"string","title":"Contract Id"},"contract_hash":{"type":"string","title":"Contract Hash"},"contract_status":{"type":"string","title":"Contract Status"},"unsettled_amount_micros":{"type":"integer","minimum":0.0,"title":"Unsettled Amount Micros"},"job_id":{"type":"string","title":"Job Id"},"conversation_id":{"type":"string","title":"Conversation Id"},"active_report_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Active Report Id"},"reports":{"items":{"$ref":"#/components/schemas/UsageReportResponse"},"type":"array","title":"Reports"}},"additionalProperties":false,"type":"object","required":["contract_id","contract_hash","contract_status","unsettled_amount_micros","job_id","conversation_id","reports"],"title":"UsageReportHistoryResponse"},"UsageReportResponse":{"properties":{"version":{"type":"integer","const":1,"title":"Version","default":1},"report_id":{"type":"string","title":"Report Id"},"contract_id":{"type":"string","title":"Contract Id"},"contract_hash":{"type":"string","title":"Contract Hash"},"job_id":{"type":"string","title":"Job Id"},"status":{"type":"string","enum":["awaiting_buyer_review","superseded","accepted","disputed","review_expired","settled"],"title":"Status"},"report_received_at":{"type":"string","format":"date-time","title":"Report Received At"},"report_due_at":{"type":"string","format":"date-time","title":"Report Due At"},"review_expires_at":{"type":"string","format":"date-time","title":"Review Expires At"},"supersedes_report_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Supersedes Report Id"},"reported_quantity":{"$ref":"#/components/schemas/UsageQuantity"},"platform_upper_bound":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Platform Upper Bound"},"supported_quantity":{"$ref":"#/components/schemas/UsageQuantity"},"priced_quantity":{"type":"integer","minimum":0.0,"title":"Priced Quantity"},"resolution":{"$ref":"#/components/schemas/PriceResolution"},"approved_cap_micros":{"type":"integer","minimum":0.0,"title":"Approved Cap Micros"},"gross_billable_micros":{"type":"integer","minimum":0.0,"title":"Gross Billable Micros"},"provider_net_micros":{"type":"integer","minimum":0.0,"title":"Provider Net Micros"},"platform_fee_micros":{"type":"integer","minimum":0.0,"title":"Platform Fee Micros"},"buyer_refund_micros":{"type":"integer","minimum":0.0,"title":"Buyer Refund Micros"},"evidence":{"items":{"$ref":"#/components/schemas/UsageEvidenceResponse"},"type":"array","title":"Evidence"}},"additionalProperties":false,"type":"object","required":["report_id","contract_id","contract_hash","job_id","status","report_received_at","report_due_at","review_expires_at","reported_quantity","supported_quantity","priced_quantity","resolution","approved_cap_micros","gross_billable_micros","provider_net_micros","platform_fee_micros","buyer_refund_micros","evidence"],"title":"UsageReportResponse"},"UsageSettlementReceipt":{"properties":{"report":{"$ref":"#/components/schemas/UsageReportResponse"},"settled_at":{"type":"string","format":"date-time","title":"Settled At"},"conversation_id":{"type":"string","title":"Conversation Id"},"contract_status":{"type":"string","const":"settled","title":"Contract Status","default":"settled"}},"additionalProperties":false,"type":"object","required":["report","settled_at","conversation_id"],"title":"UsageSettlementReceipt"},"UserCreate":{"properties":{"utm_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Utm Source"},"utm_medium":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Utm Medium"},"utm_campaign":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Utm Campaign"},"utm_content":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Utm Content"},"referrer":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Referrer"},"landing_page":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Landing Page"},"first_name":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"First Name"},"last_name":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"Last Name"},"email":{"type":"string","format":"email","title":"Email"},"password":{"type":"string","title":"Password"},"referral_code":{"anyOf":[{"type":"string","maxLength":32},{"type":"null"}],"title":"Referral Code"}},"type":"object","required":["email","password"],"title":"UserCreate"},"UserInvitation":{"properties":{"id":{"type":"string","title":"Id"},"email":{"type":"string","title":"Email"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"expires_at":{"type":"string","format":"date-time","title":"Expires At"},"status":{"type":"string","enum":["pending","accepted","expired","revoked","needs_resend"],"title":"Status"},"url":{"type":"null","title":"Url"},"category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category"},"category_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category Name"},"category_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category Label"},"chat_access":{"type":"boolean","title":"Chat Access","default":false},"apps_access":{"type":"boolean","title":"Apps Access","default":false}},"type":"object","required":["id","email","created_at","expires_at","status"],"title":"UserInvitation"},"UserInvitationsResponse":{"properties":{"can_invite":{"type":"boolean","title":"Can Invite"},"can_invite_override":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Can Invite Override"},"invitation_level":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Invitation Level"},"invitation_generation":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Invitation Generation"},"invitation_trust_level":{"anyOf":[{"type":"integer","maximum":2.0,"minimum":0.0},{"type":"null"}],"title":"Invitation Trust Level"},"invited_by_user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Invited By User Id"},"signup_origin":{"type":"string","enum":["direct","invited","unknown"],"title":"Signup Origin"},"sent_count":{"type":"integer","title":"Sent Count"},"joined_count":{"type":"integer","title":"Joined Count"},"invites":{"items":{"$ref":"#/components/schemas/UserInvitation"},"type":"array","title":"Invites"},"pending_invites":{"items":{"$ref":"#/components/schemas/UserInvitation"},"type":"array","title":"Pending Invites"},"pending_count":{"type":"integer","title":"Pending Count"},"categories":{"items":{"$ref":"#/components/schemas/CustomerCategoryGroup"},"type":"array","title":"Categories"},"share_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Share Url"},"signup_credit_micros":{"type":"integer","title":"Signup Credit Micros"},"invitee_bonus_micros":{"type":"integer","title":"Invitee Bonus Micros"},"inviter_reward_micros":{"type":"integer","title":"Inviter Reward Micros"},"rewarded_count":{"type":"integer","title":"Rewarded Count"},"reward_cap":{"type":"integer","title":"Reward Cap"}},"type":"object","required":["can_invite","can_invite_override","invitation_level","invited_by_user_id","signup_origin","sent_count","joined_count","invites","pending_invites","pending_count","signup_credit_micros","invitee_bonus_micros","inviter_reward_micros","rewarded_count","reward_cap"],"title":"UserInvitationsResponse"},"UserLeader":{"properties":{"user_id":{"type":"string","title":"User Id"},"email":{"type":"string","title":"Email"},"requests":{"type":"integer","title":"Requests"},"completed":{"type":"integer","title":"Completed"},"failed":{"type":"integer","title":"Failed"},"searches":{"type":"integer","title":"Searches"},"detail_views":{"type":"integer","title":"Detail Views"}},"type":"object","required":["user_id","email","requests","completed","failed","searches","detail_views"],"title":"UserLeader"},"UserLogin":{"properties":{"email":{"type":"string","format":"email","title":"Email"},"password":{"type":"string","title":"Password"}},"type":"object","required":["email","password"],"title":"UserLogin"},"UserProfileUpdate":{"properties":{"first_name":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"First Name"},"last_name":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"Last Name"}},"type":"object","title":"UserProfileUpdate"},"UserResponse":{"properties":{"id":{"type":"string","title":"Id"},"email":{"type":"string","title":"Email"},"first_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"First Name"},"last_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Name"},"escrow_balance_micros":{"type":"integer","title":"Escrow Balance Micros"},"is_admin":{"type":"boolean","title":"Is Admin"},"can_use_chat":{"type":"boolean","title":"Can Use Chat","default":false},"can_use_apps":{"type":"boolean","title":"Can Use Apps","default":false},"can_provide":{"type":"boolean","title":"Can Provide"},"can_refer":{"type":"boolean","title":"Can Refer"},"can_invite":{"type":"boolean","title":"Can Invite","default":false},"invitation_level":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Invitation Level"},"invitation_generation":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Invitation Generation"},"invitation_trust_level":{"anyOf":[{"type":"integer","maximum":2.0,"minimum":0.0},{"type":"null"}],"title":"Invitation Trust Level"},"invited_by_user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Invited By User Id"},"signup_origin":{"type":"string","title":"Signup Origin","default":"unknown"},"approval_threshold_micros":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Approval Threshold Micros"},"whitelabel_threshold_micros":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Whitelabel Threshold Micros"},"monthly_spend_limit_micros":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Monthly Spend Limit Micros"},"auto_accept_window_seconds":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Auto Accept Window Seconds"},"display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Display Name"},"has_password":{"type":"boolean","title":"Has Password","default":true},"sso_providers":{"items":{"type":"string"},"type":"array","title":"Sso Providers"},"intro_call_booked_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Intro Call Booked At"},"intro_call_credited":{"type":"boolean","title":"Intro Call Credited","default":false},"intro_call_credit_micros":{"type":"integer","title":"Intro Call Credit Micros","default":0},"referral_reward_micros":{"type":"integer","title":"Referral Reward Micros","default":0},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","email","escrow_balance_micros","is_admin","can_provide","can_refer","created_at"],"title":"UserResponse"},"UserReviewsResponse":{"properties":{"user_id":{"type":"string","title":"User Id"},"reviews":{"items":{"$ref":"#/components/schemas/ReviewSummary"},"type":"array","title":"Reviews"},"quality":{"$ref":"#/components/schemas/_AxisRollup"},"value":{"$ref":"#/components/schemas/_AxisRollup"},"next_cursor":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Next Cursor"}},"type":"object","required":["user_id","reviews","quality","value"],"title":"UserReviewsResponse","description":"Paginated reviews *received* by a user plus their dual-axis rollup.\n\nPublic responses omit the account's display name.\n``quality`` and ``value`` are each a ``_AxisRollup`` (count/sum/\naverage_rating/distribution). The rollup is computed from the\n``reviews`` table on every call."},"UserServiceConsumptionItem":{"properties":{"service_id":{"type":"string","title":"Service Id"},"title":{"type":"string","title":"Title"},"net_paid_micros":{"type":"integer","title":"Net Paid Micros"},"gross_charged_micros":{"type":"integer","title":"Gross Charged Micros"},"refunded_micros":{"type":"integer","title":"Refunded Micros"},"event_count":{"type":"integer","title":"Event Count"},"last_used_at":{"type":"string","format":"date-time","title":"Last Used At"}},"type":"object","required":["service_id","title","net_paid_micros","gross_charged_micros","refunded_micros","event_count","last_used_at"],"title":"UserServiceConsumptionItem"},"UserServiceUsageSummaryResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/UserServiceConsumptionItem"},"type":"array","title":"Items"},"total_services":{"type":"integer","title":"Total Services"},"total_net_paid_micros":{"type":"integer","title":"Total Net Paid Micros"}},"type":"object","required":["items","total_services","total_net_paid_micros"],"title":"UserServiceUsageSummaryResponse"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"VaultUnlockRequest":{"properties":{"passphrase":{"anyOf":[{"type":"string","maxLength":1024},{"type":"null"}],"title":"Passphrase"},"recovery_code":{"anyOf":[{"type":"string","maxLength":128},{"type":"null"}],"title":"Recovery Code"}},"type":"object","title":"VaultUnlockRequest","description":"Unlock a user-custody (Tier-2) connection with the passphrase or the\none-time recovery code."},"VaultUnlockResponse":{"properties":{"unlocked":{"type":"boolean","title":"Unlocked","default":true},"expires_at":{"type":"string","format":"date-time","title":"Expires At"}},"type":"object","required":["expires_at"],"title":"VaultUnlockResponse"},"VerifiedReference":{"properties":{"version":{"type":"integer","const":1,"title":"Version","default":1},"independent":{"type":"boolean","const":true,"title":"Independent"},"reference_kind":{"type":"string","enum":["controlled_synthetic_fixture","independent_factual_observation"],"title":"Reference Kind"},"source":{"type":"string","maxLength":128,"minLength":1,"title":"Source"},"key":{"additionalProperties":{"type":"string"},"type":"object","maxProperties":3,"minProperties":1,"title":"Key"},"facts":{"type":"string","maxLength":512,"minLength":1,"title":"Facts"},"captured_at":{"type":"string","format":"date-time","title":"Captured At"},"expires_at":{"type":"string","format":"date-time","title":"Expires At"},"fingerprint":{"type":"string","pattern":"^[0-9a-f]{64}$","title":"Fingerprint"}},"additionalProperties":false,"type":"object","required":["independent","reference_kind","source","key","facts","captured_at","expires_at","fingerprint"],"title":"VerifiedReference","description":"Independent, fingerprinted facts supplied to a verified-fixture profile."},"WalletCheckoutRequest":{"properties":{"amount_micros":{"type":"integer","exclusiveMinimum":0.0,"title":"Amount Micros"},"theme":{"type":"string","enum":["light","dark"],"title":"Theme","default":"light"},"return_path":{"anyOf":[{"type":"string","pattern":"^/chats/[0-9a-fA-F-]{36}$"},{"type":"null"}],"title":"Return Path"}},"type":"object","required":["amount_micros"],"title":"WalletCheckoutRequest","description":"Body for opening an embedded Stripe Checkout session to top up a balance.\n\nBounds are enforced server-side against the configured min/max in\napp/stripe_funding.py; ``gt=0`` only rejects the obviously invalid early."},"WorkspaceAccessGrant":{"properties":{"prefix":{"type":"string","title":"Prefix","description":"Workspace path selector interpreted by match."},"input_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Input Name"},"match":{"type":"string","enum":["prefix","exact"],"title":"Match","default":"prefix"},"permissions":{"items":{"type":"string","enum":["read","write","delete"]},"type":"array","maxItems":3,"minItems":1,"title":"Permissions"}},"additionalProperties":false,"type":"object","required":["prefix","permissions"],"title":"WorkspaceAccessGrant","description":"Permission-aware workspace selector shared by hires and offer orders."},"WorkspaceEntryResponse":{"properties":{"logical_path":{"type":"string","title":"Logical Path"},"file":{"$ref":"#/components/schemas/FileResponse"}},"type":"object","required":["logical_path","file"],"title":"WorkspaceEntryResponse","description":"A live workspace entry: its logical path plus the backing file object."},"WorkspaceEntryTransferRequest":{"properties":{"source":{"type":"string","maxLength":512,"minLength":1,"title":"Source"},"dest":{"type":"string","maxLength":512,"minLength":1,"title":"Dest"}},"additionalProperties":false,"type":"object","required":["source","dest"],"title":"WorkspaceEntryTransferRequest","description":"Source/destination pair for workspace copy and move operations."},"WorkspaceEntryUploadSessionCreate":{"properties":{"filename":{"type":"string","maxLength":255,"minLength":1,"title":"Filename"},"content_type":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Content Type"},"size_bytes":{"type":"integer","minimum":1.0,"title":"Size Bytes"},"sha256":{"anyOf":[{"type":"string","maxLength":64,"minLength":64,"pattern":"^[0-9a-fA-F]{64}$"},{"type":"null"}],"title":"Sha256"},"preferred_upload":{"type":"string","enum":["auto","direct","proxy","multipart"],"title":"Preferred Upload","default":"auto"},"logical_path":{"type":"string","maxLength":512,"minLength":1,"title":"Logical Path"}},"additionalProperties":false,"type":"object","required":["filename","size_bytes","logical_path"],"title":"WorkspaceEntryUploadSessionCreate","description":"Upload-session declaration for a large workspace entry.\n\nSame contract as a file upload session plus the target logical path. The\npath is claimed only when the session finalizes - an abandoned session\nnever supersedes the live entry at that path."},"WorkspaceScopeUsage":{"properties":{"orchestration_scope_id":{"type":"string","title":"Orchestration Scope Id"},"stored_bytes":{"type":"integer","title":"Stored Bytes"},"file_count":{"type":"integer","title":"File Count"},"live_entries":{"type":"integer","title":"Live Entries"},"live_bytes":{"type":"integer","title":"Live Bytes"},"last_write_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Write At"},"has_active_jobs":{"type":"boolean","title":"Has Active Jobs"}},"type":"object","required":["orchestration_scope_id","stored_bytes","file_count","live_entries","live_bytes","has_active_jobs"],"title":"WorkspaceScopeUsage","description":"Per-orchestration-scope workspace storage rollup (admin observability).\n\n``stored_bytes`` counts every not-yet-cleaned workspace row - exactly what\nthe per-scope cap charges - while ``live_*`` covers only current path\nentries; the difference is superseded/pending overhead awaiting cleanup."},"YesNoQuestion":{"properties":{"kind":{"type":"string","const":"yes_no","title":"Kind"},"id":{"type":"string","maxLength":32,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","title":"Id"},"instructions":{"type":"string","maxLength":1024,"minLength":1,"title":"Instructions"},"true_description":{"type":"string","maxLength":256,"title":"True Description","default":""},"false_description":{"type":"string","maxLength":256,"title":"False Description","default":""}},"additionalProperties":false,"type":"object","required":["kind","id","instructions"],"title":"YesNoQuestion"},"_AxisRollup":{"properties":{"count":{"type":"integer","title":"Count"},"sum":{"type":"integer","title":"Sum"},"average_rating":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Average Rating"},"distribution":{"additionalProperties":{"type":"integer"},"type":"object","title":"Distribution"}},"type":"object","required":["count","sum","distribution"],"title":"_AxisRollup","description":"The per-axis rollup block shared by service and user review responses.\n\nCarries count/sum/average_rating and the 1-5 star distribution for one\nof the two review axes (quality or value). Count/distribution measure\nassessed uses; sum is score times assessed-use count. The average uses\nper-record weights (human 2, agent sqrt(count)), independently of sum/count.\nMissing value scores contribute to neither value counts nor value averages."},"app__routers__admin_service_quality_continuous__PolicyUpdate":{"properties":{"mode":{"type":"string","enum":["off","sampled","all"],"title":"Mode"},"sample_permyriad":{"type":"integer","maximum":10000.0,"minimum":0.0,"title":"Sample Permyriad"},"daily_budget_micros":{"type":"integer","maximum":1000000000.0,"minimum":0.0,"title":"Daily Budget Micros"},"instruction":{"type":"string","maxLength":300,"minLength":1,"title":"Instruction"},"input_paths":{"items":{"type":"string"},"type":"array","maxItems":4,"minItems":1,"title":"Input Paths"},"output_paths":{"items":{"type":"string"},"type":"array","maxItems":4,"minItems":1,"title":"Output Paths"},"continuous":{"$ref":"#/components/schemas/ContinuousEvidenceProfile"},"evidence_processing_approved":{"type":"boolean","const":true,"title":"Evidence Processing Approved"},"upstream_retention_approved":{"type":"boolean","const":true,"title":"Upstream Retention Approved"}},"additionalProperties":false,"type":"object","required":["mode","sample_permyriad","daily_budget_micros","instruction","input_paths","output_paths","continuous","evidence_processing_approved","upstream_retention_approved"],"title":"PolicyUpdate"},"app__service_quality_policy__PolicyUpdate":{"properties":{"mode":{"type":"string","enum":["off","sampled","all"],"title":"Mode"},"sample_permyriad":{"type":"integer","maximum":10000.0,"minimum":0.0,"title":"Sample Permyriad"},"daily_budget_micros":{"type":"integer","maximum":1000000.0,"minimum":0.0,"title":"Daily Budget Micros"},"rubric":{"$ref":"#/components/schemas/Rubric"}},"additionalProperties":false,"type":"object","required":["mode","sample_permyriad","daily_budget_micros","rubric"],"title":"PolicyUpdate"}},"securitySchemes":{"HTTPBearer":{"type":"http","scheme":"bearer"},"HTTPBasic":{"type":"http","scheme":"basic"}}}}