{"openapi":"3.1.0","info":{"title":"runx Hosted API","version":"0.1.0","summary":"Governed hosted API for run submission, hosted agent config, connect, grants, approvals, and inspection.","description":"Hosted API contract for run submission, hosted agent config, connect, grants, approvals, webhook ingress, and inspection."},"jsonSchemaDialect":"https://json-schema.org/draft/2020-12/schema","servers":[{"url":"https://api.runx.ai","description":"Hosted API surface"},{"url":"https://connect.runx.ai","description":"Hosted Connect surface"},{"url":"https://runx.ai","description":"Hosted app surface"}],"tags":[{"name":"system"},{"name":"public"},{"name":"integrations"},{"name":"agent"},{"name":"identity"},{"name":"knowledge"},{"name":"runs"},{"name":"receipts"},{"name":"connect"},{"name":"provider-references"},{"name":"admin"}],"paths":{"/healthz":{"get":{"operationId":"getHealth","summary":"Health check","tags":["system"],"responses":{"200":{"description":"Health status.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StatusEnvelope"}}}}}}},"/readyz":{"get":{"operationId":"getReadiness","summary":"Readiness check","tags":["system"],"responses":{"200":{"description":"Readiness status.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HostedReadinessEnvelope"}}}},"503":{"description":"Dependencies are not ready.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HostedReadinessErrorEnvelope"}}}}}}},"/openapi.json":{"get":{"operationId":"getOpenApiDocument","summary":"OpenAPI document","tags":["system"],"responses":{"200":{"description":"OpenAPI document.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/system/status":{"get":{"operationId":"getPublicSystemStatus","summary":"Inspect public system status","tags":["public"],"responses":{"200":{"description":"Public system status.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicSystemStatusEnvelope"}}}},"503":{"description":"Public system status degraded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicSystemStatusEnvelope"}}}}}}},"/v1/system/metrics":{"get":{"operationId":"getSystemMetrics","summary":"Inspect hosted API request metrics","tags":["system","admin"],"security":[{"BearerAuth":[]}],"responses":{"200":{"description":"Hosted API request metrics.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HostedApiMetricsEnvelope"}}}},"401":{"description":"Unauthorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"Forbidden.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/integrations":{"get":{"operationId":"listPublicIntegrations","summary":"List the public integrations catalog","tags":["public"],"responses":{"200":{"description":"Public integrations catalog.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicIntegrationListEnvelope"}}}},"503":{"description":"Integrations catalog unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/integrations/{slug}":{"get":{"operationId":"getPublicIntegration","summary":"Inspect one public integration summary","tags":["public"],"parameters":[{"name":"slug","in":"path","required":true,"description":"Integration provider slug.","schema":{"type":"string"}}],"responses":{"200":{"description":"Public integration summary.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicIntegrationEnvelope"}}}},"404":{"description":"Integration not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Integrations catalog unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/integrations/{slug}/logo":{"get":{"operationId":"getPublicIntegrationLogo","summary":"Serve one public integration logo","tags":["public"],"parameters":[{"name":"slug","in":"path","required":true,"description":"Integration provider slug.","schema":{"type":"string"}}],"responses":{"200":{"description":"Integration logo image.","content":{"image/svg+xml":{"schema":{"type":"string","format":"binary"}},"image/png":{"schema":{"type":"string","format":"binary"}},"image/jpeg":{"schema":{"type":"string","format":"binary"}},"image/webp":{"schema":{"type":"string","format":"binary"}}}},"404":{"description":"Integration logo not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"502":{"description":"Integration logo unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Integrations catalog unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/integrations/{slug}/demand":{"post":{"operationId":"recordPublicIntegrationDemand","summary":"Record public demand for one integration","tags":["public"],"parameters":[{"name":"slug","in":"path","required":true,"description":"Integration provider slug.","schema":{"type":"string"}}],"requestBody":{"required":true,"description":"Integration demand signal.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicIntegrationDemandRequest"}}}},"responses":{"200":{"description":"Recorded integration demand.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicIntegrationDemandEnvelope"}}}},"400":{"description":"Validation error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Integration not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Integrations demand capture unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/feed":{"get":{"operationId":"getPublicFeed","summary":"List the public live feed","tags":["public"],"parameters":[{"name":"limit","in":"query","required":false,"description":"Maximum number of feed items to return.","schema":{"type":"string"}}],"responses":{"200":{"description":"Public live feed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicFeedEnvelope"}}}}}}},"/v1/trust/keys":{"get":{"operationId":"getTrustRootKeys","summary":"Fetch public trust-root keys","description":"Returns the public key set used to verify hosted receipt signatures and payment-admission proofs.","tags":["public","receipts"],"responses":{"200":{"description":"Public trust-root document.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TrustRootDocument"}}}}}}},"/v1/projections/receipts":{"get":{"operationId":"listPublicReceiptProjections","summary":"List the public receipt projection feed","description":"Returns monotonic public receipt publication and tombstone projections after the supplied cursor.","tags":["public","receipts"],"parameters":[{"name":"cursor","in":"query","required":false,"description":"Last consumed projection sequence. Omit or pass 0 to read from the beginning.","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Maximum projections to return, between 1 and 500.","schema":{"type":"string"}}],"responses":{"200":{"description":"Public receipt projection page.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicReceiptProjectionFeedEnvelope"}}}},"400":{"description":"Invalid cursor or limit.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Receipt projection feed unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/receipts/notarizations/{hash}":{"get":{"operationId":"getPublicReceiptNotarization","summary":"Inspect one public receipt notarization projection","tags":["public","receipts"],"parameters":[{"name":"hash","in":"path","required":true,"description":"Receipt public hash, with or without sha256: prefix.","schema":{"type":"string"}}],"responses":{"200":{"description":"Public receipt notarization projection.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicReceiptNotarizationEnvelope"}}}},"404":{"description":"Receipt not found or unpublished.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Receipt notary unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/receipts/notarize":{"post":{"operationId":"notarizeReceipt","summary":"Notarize one edge receipt or declared receipt digest","description":"Accepts either a bearer principal with receipts:write scope or an anonymous receipt-key proof.","tags":["receipts"],"security":[{"BearerAuth":[]},{}],"requestBody":{"required":true,"description":"Full receipt or hash-only notarization request, optionally with receipt-key proof for anonymous mode.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReceiptNotarizeRequest"}}}},"responses":{"201":{"description":"Receipt notarized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReceiptNotaryEnvelope"}}}},"400":{"description":"Validation error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Unauthorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"Forbidden.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"413":{"description":"Receipt request too large.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"422":{"description":"Receipt verification failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReceiptVerificationFailedEnvelope"}}}},"429":{"description":"Rate limited.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Receipt notary unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/receipts/key-challenges":{"post":{"operationId":"createReceiptKeyChallenge","summary":"Create a single-use receipt-key challenge","tags":["receipts"],"requestBody":{"required":true,"description":"Receipt-key proof challenge request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReceiptKeyChallengeRequest"}}}},"responses":{"201":{"description":"Receipt-key challenge created.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReceiptKeyChallengeEnvelope"}}}},"400":{"description":"Validation error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"413":{"description":"Challenge request too large.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate limited.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Receipt key challenge store unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/receipts/key-claims":{"post":{"operationId":"claimReceiptKey","summary":"Bind a receipt key to the authenticated principal","tags":["receipts"],"security":[{"BearerAuth":[]}],"requestBody":{"required":true,"description":"Signed claim challenge proof.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReceiptKeyClaimRequest"}}}},"responses":{"201":{"description":"Receipt key claimed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReceiptKeyClaimEnvelope"}}}},"400":{"description":"Validation error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Unauthorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"Forbidden.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"409":{"description":"Receipt key already claimed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Receipt key binding store unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}},"get":{"operationId":"listReceiptKeyClaims","summary":"List receipt-key bindings for the authenticated principal","tags":["receipts"],"security":[{"BearerAuth":[]}],"responses":{"200":{"description":"Receipt key bindings.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReceiptKeyBindingListEnvelope"}}}},"401":{"description":"Unauthorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"Forbidden.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Receipt key binding store unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/receipts/key-claims/disavow":{"post":{"operationId":"disavowReceiptKey","summary":"Append a receipt-key disavowal for the authenticated principal","tags":["receipts"],"security":[{"BearerAuth":[]}],"requestBody":{"required":true,"description":"Receipt-key disavowal request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReceiptKeyDisavowRequest"}}}},"responses":{"200":{"description":"Receipt key disavowed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReceiptKeyClaimEnvelope"}}}},"400":{"description":"Validation error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Unauthorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"Forbidden.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Receipt key binding not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Receipt key binding store unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/receipts/{digest}/unpublish":{"post":{"operationId":"unpublishReceiptNotarization","summary":"Hide one public receipt notarization page","tags":["receipts"],"security":[{"BearerAuth":[]}],"parameters":[{"name":"digest","in":"path","required":true,"description":"Receipt digest, with or without sha256: prefix.","schema":{"type":"string"}}],"responses":{"200":{"description":"Receipt notarization unpublished.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReceiptNotaryEnvelope"}}}},"401":{"description":"Unauthorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"Forbidden.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Receipt not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Receipt notary unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/skills":{"get":{"operationId":"listPublicSkills","summary":"List public registry skills with search and filters","tags":["public"],"parameters":[{"name":"q","in":"query","required":false,"description":"Text query.","schema":{"type":"string"}},{"name":"owner","in":"query","required":false,"description":"Owner namespace filter.","schema":{"type":"string"}},{"name":"tag","in":"query","required":false,"description":"Tag filter.","schema":{"type":"string"}},{"name":"kind","in":"query","required":false,"description":"Catalog kind filter: skill or graph.","schema":{"type":"string"}},{"name":"category","in":"query","required":false,"description":"Registry category filter: code, docs-content, security, planning, or skill-meta.","schema":{"type":"string"}},{"name":"source_type","in":"query","required":false,"description":"Source type filter.","schema":{"type":"string"}},{"name":"profile_mode","in":"query","required":false,"description":"Runner mode filter.","schema":{"type":"string"}},{"name":"featured","in":"query","required":false,"description":"When true, return the curated homepage skill set in operator-defined order.","schema":{"type":"string"}},{"name":"include","in":"query","required":false,"description":"When set to unverified, include zero-install community skills in broad discovery.","schema":{"type":"string"}},{"name":"trust_tier","in":"query","required":false,"description":"Trust tier filter: first_party, verified, or community.","schema":{"type":"string"}},{"name":"sort","in":"query","required":false,"description":"Sort order: newest, most-installed, or a-z.","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Maximum number of skills to return.","schema":{"type":"string"}}],"responses":{"200":{"description":"Public registry listing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicSkillListEnvelope"}}}}}},"post":{"operationId":"publishHostedSkill","summary":"Publish a skill to the hosted registry","description":"Publishes one governed skill markdown document under the signed-in principal's verified namespace. The caller cannot set owner or trust tier.","tags":["public","registry"],"security":[{"BearerAuth":[]}],"requestBody":{"required":true,"description":"Hosted skill publish payload.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HostedSkillPublishRequest"}}}},"responses":{"200":{"description":"Published hosted skill.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HostedSkillPublishEnvelope"}}}},"400":{"description":"Invalid skill package.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Unauthorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"Missing publish scope.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"409":{"description":"Skill version conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Hosted registry unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/tools":{"get":{"operationId":"listPublicTools","summary":"List public imported tools with search and optional source filtering","tags":["public"],"parameters":[{"name":"q","in":"query","required":false,"description":"Text query.","schema":{"type":"string"}},{"name":"source","in":"query","required":false,"description":"Optional imported-tool source filter.","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Maximum number of tools to return.","schema":{"type":"string"}}],"responses":{"200":{"description":"Public imported tool listing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicToolListEnvelope"}}}}}}},"/v1/owners/{owner}":{"get":{"operationId":"getPublicOwnerProfile","summary":"Inspect one public owner profile","tags":["public"],"parameters":[{"name":"owner","in":"path","required":true,"description":"Owner namespace.","schema":{"type":"string"}}],"responses":{"200":{"description":"Public owner profile.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicOwnerProfileEnvelope"}}}},"404":{"description":"Owner not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/skills/{owner}/{name}":{"get":{"operationId":"getPublicSkill","summary":"Inspect one public registry skill","tags":["public"],"parameters":[{"name":"owner","in":"path","required":true,"description":"Owner namespace.","schema":{"type":"string"}},{"name":"name","in":"path","required":true,"description":"Skill name or name@version.","schema":{"type":"string"}},{"name":"ref","in":"query","required":false,"description":"Optional rolling ref selector such as main.","schema":{"type":"string"}}],"responses":{"200":{"description":"Public skill detail.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicSkillDetailEnvelope"}}}},"404":{"description":"Skill not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/tools/{ref}":{"get":{"operationId":"getPublicTool","summary":"Inspect one public imported tool","tags":["public"],"parameters":[{"name":"ref","in":"path","required":true,"description":"Normalized tool ref, for example fixture.echo or source:namespace.tool.","schema":{"type":"string"}},{"name":"source","in":"query","required":false,"description":"Optional imported-tool source filter.","schema":{"type":"string"}}],"responses":{"200":{"description":"Public imported tool detail.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicToolDetailEnvelope"}}}},"404":{"description":"Tool not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/skills/{owner}/{name}/acquire":{"post":{"operationId":"acquirePublicSkill","summary":"Acquire a pinned public registry skill for one installation","tags":["public"],"parameters":[{"name":"owner","in":"path","required":true,"description":"Owner namespace.","schema":{"type":"string"}},{"name":"name","in":"path","required":true,"description":"Skill name or name@version.","schema":{"type":"string"}}],"requestBody":{"required":true,"description":"Registry skill acquisition request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AcquireSkillRequest"}}}},"responses":{"200":{"description":"Registry skill acquisition payload.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AcquireSkillResponse"}}}},"400":{"description":"Validation error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Skill not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Registry store unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/skills/{owner}/{name}/report":{"post":{"operationId":"reportPublicSkill","summary":"Report a public registry skill for moderation review","description":"Records one authenticated report against a resolved skill version. Reports inform moderation; they are not trust evidence.","tags":["public","registry"],"security":[{"BearerAuth":[]}],"parameters":[{"name":"owner","in":"path","required":true,"description":"Owner namespace.","schema":{"type":"string"}},{"name":"name","in":"path","required":true,"description":"Skill name or name@version.","schema":{"type":"string"}}],"requestBody":{"required":true,"description":"Public skill report payload.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HostedSkillReportRequest"}}}},"responses":{"200":{"description":"Duplicate report already recorded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HostedSkillReportEnvelope"}}}},"201":{"description":"Skill report recorded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HostedSkillReportEnvelope"}}}},"400":{"description":"Invalid report payload.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Unauthorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"Missing report scope.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Skill not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Report rate limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Hosted registry unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/skills/{owner}/{name}/harness":{"get":{"operationId":"getPublicSkillHarness","summary":"Inspect public harness evidence for one registry skill","tags":["public"],"parameters":[{"name":"owner","in":"path","required":true,"description":"Owner namespace.","schema":{"type":"string"}},{"name":"name","in":"path","required":true,"description":"Skill name or name@version.","schema":{"type":"string"}},{"name":"ref","in":"query","required":false,"description":"Optional rolling ref selector such as main.","schema":{"type":"string"}}],"responses":{"200":{"description":"Public harness detail.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicHarnessEnvelope"}}}},"404":{"description":"Skill not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/index":{"post":{"operationId":"indexRepositoryUrl","summary":"URL-as-publish: index every SKILL.md in a public github repo","tags":["public","url-publish"],"requestBody":{"required":true,"description":"GitHub repo URL to index.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IndexRequest"}}}},"responses":{"200":{"description":"Indexed listings.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IndexResultEnvelope"}}}},"400":{"description":"Validation error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IndexErrorEnvelope"}}}},"404":{"description":"Repo unreachable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IndexErrorEnvelope"}}}},"409":{"description":"Skill name already taken from a different source.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IndexErrorEnvelope"}}}},"422":{"description":"No valid SKILL.md files found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IndexErrorEnvelope"}}}},"429":{"description":"Rate limited.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IndexErrorEnvelope"}}}}}}},"/v1/index/{owner}/{name}/status":{"get":{"operationId":"getIndexStatus","summary":"Inspect the latest indexed version of a listing","tags":["public","url-publish"],"parameters":[{"name":"owner","in":"path","required":true,"description":"Skill owner.","schema":{"type":"string"}},{"name":"name","in":"path","required":true,"description":"Skill name.","schema":{"type":"string"}}],"responses":{"200":{"description":"Listing status.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IndexStatusEnvelope"}}}},"404":{"description":"Listing not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/claim/sessions":{"post":{"operationId":"createClaimSession","summary":"Create a GitHub OAuth claim session for a public listing","tags":["public","claim"],"requestBody":{"required":true,"description":"Claim target listing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClaimSessionRequest"}}}},"responses":{"201":{"description":"Claim session created.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClaimSessionEnvelope"}}}},"400":{"description":"Validation error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IndexErrorEnvelope"}}}},"404":{"description":"Listing not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IndexErrorEnvelope"}}}},"409":{"description":"Listing source is not claimable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IndexErrorEnvelope"}}}},"429":{"description":"Rate limited.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IndexErrorEnvelope"}}}},"503":{"description":"Claim is not configured.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IndexErrorEnvelope"}}}}}}},"/v1/claim/sessions/{request_id}":{"get":{"operationId":"getClaimSession","summary":"Inspect one claim session","tags":["public","claim"],"parameters":[{"name":"request_id","in":"path","required":true,"description":"Claim request id.","schema":{"type":"string"}}],"responses":{"200":{"description":"Claim session status.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClaimSessionStatusEnvelope"}}}},"404":{"description":"Claim session not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IndexErrorEnvelope"}}}},"503":{"description":"Claim is not configured.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IndexErrorEnvelope"}}}}}}},"/v1/claim/sessions/{request_id}/finalize":{"post":{"operationId":"finalizeClaimSession","summary":"Finalize a claim session after hosted connect reports a provider reference","tags":["public","claim"],"parameters":[{"name":"request_id","in":"path","required":true,"description":"Claim request id.","schema":{"type":"string"}}],"responses":{"200":{"description":"Claim session status.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClaimSessionStatusEnvelope"}}}},"404":{"description":"Claim session not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IndexErrorEnvelope"}}}},"503":{"description":"Claim is not configured.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IndexErrorEnvelope"}}}}}}},"/v1/claim/github-app/sessions":{"post":{"operationId":"createGitHubAppClaimSession","summary":"Create a GitHub App claim session from a repo URL","tags":["public","claim"],"requestBody":{"required":true,"description":"GitHub repo URL and optional target listing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GitHubAppClaimSessionRequest"}}}},"responses":{"201":{"description":"GitHub App claim session created.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GitHubAppClaimSessionEnvelope"}}}},"400":{"description":"Validation error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IndexErrorEnvelope"}}}},"404":{"description":"Listing or repo not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IndexErrorEnvelope"}}}},"409":{"description":"Listing source is not claimable by this repo/install.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IndexErrorEnvelope"}}}},"429":{"description":"Rate limited.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IndexErrorEnvelope"}}}},"503":{"description":"GitHub App claim is not configured.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IndexErrorEnvelope"}}}}}}},"/v1/claim/github-app/sessions/{request_id}":{"get":{"operationId":"getGitHubAppClaimSession","summary":"Inspect one GitHub App claim session","tags":["public","claim"],"parameters":[{"name":"request_id","in":"path","required":true,"description":"GitHub App claim request id.","schema":{"type":"string"}}],"responses":{"200":{"description":"GitHub App claim session status.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GitHubAppClaimSessionStatusEnvelope"}}}},"404":{"description":"Claim session not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IndexErrorEnvelope"}}}},"503":{"description":"GitHub App claim is not configured.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IndexErrorEnvelope"}}}}}}},"/v1/claim/github-app/callbacks":{"post":{"operationId":"exchangeGitHubAppClaimCallback","summary":"Finalize a GitHub App claim from callback state","tags":["public","claim"],"requestBody":{"required":true,"description":"GitHub App installation callback payload.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GitHubAppClaimFinalizeRequest"}}}},"responses":{"200":{"description":"GitHub App claim session status.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GitHubAppClaimSessionStatusEnvelope"}}}},"400":{"description":"Validation error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IndexErrorEnvelope"}}}},"404":{"description":"Claim session not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IndexErrorEnvelope"}}}},"409":{"description":"State or installation mismatch.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IndexErrorEnvelope"}}}},"503":{"description":"GitHub App claim is not configured.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IndexErrorEnvelope"}}}}}}},"/v1/claim/github-app/sessions/{request_id}/finalize":{"post":{"operationId":"finalizeGitHubAppClaimSession","summary":"Finalize a GitHub App claim after GitHub redirects back","tags":["public","claim"],"parameters":[{"name":"request_id","in":"path","required":true,"description":"GitHub App claim request id.","schema":{"type":"string"}}],"requestBody":{"required":true,"description":"GitHub App installation callback payload.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GitHubAppClaimFinalizeRequest"}}}},"responses":{"200":{"description":"GitHub App claim session status.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GitHubAppClaimSessionStatusEnvelope"}}}},"400":{"description":"Validation error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IndexErrorEnvelope"}}}},"404":{"description":"Claim session not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IndexErrorEnvelope"}}}},"409":{"description":"State or installation mismatch.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IndexErrorEnvelope"}}}},"503":{"description":"GitHub App claim is not configured.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IndexErrorEnvelope"}}}}}}},"/v1/self-publish/enrollments/{handle}":{"get":{"operationId":"getSelfPublishEnrollment","summary":"Inspect one self-publish enrollment by tracking handle","tags":["public","self-publish"],"parameters":[{"name":"handle","in":"path","required":true,"description":"Enrollment tracking handle.","schema":{"type":"string"}}],"responses":{"200":{"description":"Self-publish enrollment detail.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SelfPublishEnrollmentEnvelope"}}}},"404":{"description":"Enrollment not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Self-publish is not configured.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/webhooks/integrations/github/app":{"post":{"operationId":"ingestGitHubAppIntegrationWebhook","summary":"Ingest a signed GitHub App integration webhook payload","tags":["public","integrations"],"requestBody":{"required":true,"description":"Raw GitHub App webhook payload.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GitHubAppWebhookRequest"}}}},"responses":{"202":{"description":"Webhook accepted.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookAcceptedEnvelope"}}}},"400":{"description":"Validation error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Invalid GitHub signature.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Integration webhook handling is not configured.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/me":{"get":{"operationId":"getCurrentPrincipal","summary":"Inspect the authenticated principal","tags":["identity"],"security":[{"BearerAuth":[]}],"responses":{"200":{"description":"Authenticated principal.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PrincipalEnvelope"}}}},"401":{"description":"Unauthorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/accounts":{"post":{"operationId":"createSelfServeAccount","summary":"Create a self-serve hosted principal and credential","tags":["identity","billing"],"requestBody":{"required":true,"description":"Optional account display metadata.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateAccountRequest"}}}},"responses":{"201":{"description":"Created principal and one-time credential.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountCreatedEnvelope"}}}},"503":{"description":"Self-serve identity is not configured.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/billing/stripe/setup-intents":{"post":{"operationId":"createStripeSetupIntent","summary":"Create a Stripe SetupIntent for self-serve hosted topup","tags":["billing"],"security":[{"BearerAuth":[]}],"requestBody":{"required":true,"description":"Stripe setup idempotency request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StripeSetupIntentRequest"}}}},"responses":{"201":{"description":"Stripe setup intent.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StripeSetupIntentEnvelope"}}}},"400":{"description":"Validation error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Unauthorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Stripe setup is not configured.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/billing/stripe/setup-intents/{id}/confirm":{"post":{"operationId":"confirmStripeSetupIntent","summary":"Verify a completed Stripe SetupIntent and store the payment method","tags":["billing"],"security":[{"BearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"description":"Stripe SetupIntent id.","schema":{"type":"string"}}],"responses":{"200":{"description":"Verified Stripe payment method.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StripePaymentMethodEnvelope"}}}},"401":{"description":"Unauthorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"Setup intent does not belong to this principal.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"409":{"description":"Setup intent is not complete.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Stripe setup is not configured.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/billing/topup":{"post":{"operationId":"createBillingTopup","summary":"Top up hosted credits through the configured Stripe rail","tags":["billing"],"security":[{"BearerAuth":[]}],"requestBody":{"required":true,"description":"Credit topup request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BillingTopupRequest"}}}},"responses":{"200":{"description":"Idempotent topup replay.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BillingTopupEnvelope"}}}},"201":{"description":"Topup applied.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BillingTopupEnvelope"}}}},"400":{"description":"Validation error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Unauthorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Stripe charge refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Topup is not configured.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/billing/balance":{"get":{"operationId":"getBillingBalance","summary":"Project hosted credit balance from sealed receipts","tags":["billing"],"security":[{"BearerAuth":[]}],"responses":{"200":{"description":"Projected credit balance.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BillingBalanceEnvelope"}}}},"401":{"description":"Unauthorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Billing is not configured.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/billing/entitlements":{"get":{"operationId":"listBillingEntitlements","summary":"List flat entitlement add-on records for the current principal","tags":["billing"],"security":[{"BearerAuth":[]}],"responses":{"200":{"description":"Entitlement records.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EntitlementListEnvelope"}}}},"401":{"description":"Unauthorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Entitlements are not configured.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/billing/entitlements/{addon}":{"put":{"operationId":"putBillingEntitlement","summary":"Create or update one flat entitlement add-on record","tags":["billing","admin"],"security":[{"BearerAuth":[]}],"parameters":[{"name":"addon","in":"path","required":true,"description":"Entitlement add-on id.","schema":{"type":"string"}}],"requestBody":{"required":true,"description":"Entitlement subscription reference.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PutEntitlementRequest"}}}},"responses":{"201":{"description":"Entitlement record.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EntitlementEnvelope"}}}},"400":{"description":"Validation error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Unauthorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"Forbidden.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Entitlements are not configured.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/payments/connect/onboarding/start":{"post":{"operationId":"startStripeConnectOnboarding","summary":"Start Stripe Connect seller onboarding for the authenticated tenant","tags":["billing"],"security":[{"BearerAuth":[]}],"requestBody":{"required":true,"description":"Seller onboarding link request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StripeConnectOnboardingStartRequest"}}}},"responses":{"200":{"description":"Stripe Connect onboarding URL.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StripeConnectOnboardingStartEnvelope"}}}},"400":{"description":"Validation error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Unauthorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Stripe Connect onboarding is not configured.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/payments/connect/onboarding/status":{"get":{"operationId":"getStripeConnectOnboardingStatus","summary":"Read Stripe Connect seller onboarding status for the authenticated tenant","tags":["billing"],"security":[{"BearerAuth":[]}],"responses":{"200":{"description":"Stripe Connect seller status.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StripeConnectOnboardingStatusEnvelope"}}}},"401":{"description":"Unauthorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Stripe Connect onboarding is not configured.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/payments/connect/fund":{"post":{"operationId":"fundMarketplacePostingWithStripeConnect","summary":"Fund a marketplace posting through tenant Stripe Connect","tags":["billing"],"security":[{"BearerAuth":[]}],"requestBody":{"required":true,"description":"Marketplace posting funding request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarketplaceFundingRequest"}}}},"responses":{"200":{"description":"Sealed marketplace funding receipt.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarketplaceReceiptEnvelope"}}}},"400":{"description":"Validation error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Unauthorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"409":{"description":"Refund or settlement policy refusal.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Stripe Connect marketplace is not configured.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/payments/connect/payout":{"post":{"operationId":"payoutMarketplaceClaimWithStripeConnect","summary":"Pay a marketplace claim through tenant Stripe Connect","tags":["billing"],"security":[{"BearerAuth":[]}],"requestBody":{"required":true,"description":"Marketplace claim payout request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarketplacePayoutRequest"}}}},"responses":{"200":{"description":"Sealed marketplace payout receipt.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarketplaceReceiptEnvelope"}}}},"400":{"description":"Validation error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Unauthorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"409":{"description":"Settlement policy refusal.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Stripe Connect marketplace is not configured.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/payments/connect/refund":{"post":{"operationId":"refundMarketplaceSettlementWithStripeConnect","summary":"Refund marketplace funding or reverse a marketplace payout through tenant Stripe Connect","tags":["billing"],"security":[{"BearerAuth":[]}],"requestBody":{"required":true,"description":"Marketplace funding refund or payout reversal request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarketplaceRefundRequest"}}}},"responses":{"200":{"description":"Sealed marketplace refund receipt.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarketplaceReceiptEnvelope"}}}},"400":{"description":"Validation error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Unauthorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Receipt not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"409":{"description":"Refund policy refusal.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Stripe Connect marketplace is not configured.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/payments/paypal/orders":{"post":{"operationId":"createMarketplaceFundingPayPalOrder","summary":"Create a hosted PayPal checkout order for marketplace funding","tags":["billing"],"security":[{"BearerAuth":[]}],"requestBody":{"required":true,"description":"Marketplace funding terms plus optional return URLs.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PayPalMarketplaceOrderRequest"}}}},"responses":{"200":{"description":"PayPal order and approval URL.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PayPalOrderEnvelope"}}}},"400":{"description":"Validation error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Unauthorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"502":{"description":"PayPal order creation failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"PayPal marketplace funding is not configured.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/payments/paypal/capture":{"post":{"operationId":"captureMarketplaceFundingPayPalOrder","summary":"Capture a hosted PayPal order and seal a marketplace funding receipt","tags":["billing"],"security":[{"BearerAuth":[]}],"requestBody":{"required":true,"description":"Marketplace funding terms plus approved PayPal order id.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PayPalMarketplaceCaptureRequest"}}}},"responses":{"200":{"description":"Sealed marketplace funding receipt.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarketplaceReceiptEnvelope"}}}},"400":{"description":"Validation error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Unauthorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"409":{"description":"Settlement policy refusal.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"502":{"description":"PayPal capture failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"PayPal marketplace funding is not configured.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/payments/paypal/refund":{"post":{"operationId":"refundMarketplaceFundingWithPayPal","summary":"Refund PayPal marketplace funding and seal a refund receipt","tags":["billing"],"security":[{"BearerAuth":[]}],"requestBody":{"required":true,"description":"Marketplace PayPal funding refund request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PayPalMarketplaceRefundRequest"}}}},"responses":{"200":{"description":"Sealed marketplace refund receipt.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarketplaceReceiptEnvelope"}}}},"400":{"description":"Validation error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Unauthorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Receipt not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"409":{"description":"Refund policy refusal.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"502":{"description":"PayPal refund failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"PayPal marketplace funding is not configured.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/payments/x402/quote":{"post":{"operationId":"quoteMarketplacePostingWithX402","summary":"Quote a marketplace posting's x402 payment requirements","tags":["billing"],"security":[{"BearerAuth":[]}],"requestBody":{"required":true,"description":"x402 marketplace posting quote request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/X402MarketplaceQuoteRequest"}}}},"responses":{"200":{"description":"Canonical x402 payment requirements.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/X402QuoteEnvelope"}}}},"400":{"description":"Validation error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Unauthorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Tenant x402 marketplace rail is not configured.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/payments/x402/targets":{"get":{"operationId":"getX402SettlementTargets","summary":"Read tenant x402 settlement targets","tags":["billing"],"security":[{"BearerAuth":[]}],"responses":{"200":{"description":"Configured x402 settlement targets.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/X402SettlementTargetsEnvelope"}}}},"401":{"description":"Unauthorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"Forbidden.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Tenant x402 credential is not configured.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"x402 target management is not configured.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}},"put":{"operationId":"putX402SettlementTargets","summary":"Replace tenant x402 settlement targets without rotating CDP secrets","tags":["billing"],"security":[{"BearerAuth":[]}],"requestBody":{"required":true,"description":"x402 settlement target replacement.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/X402SettlementTargetsRequest"}}}},"responses":{"200":{"description":"Configured x402 settlement targets.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/X402SettlementTargetsEnvelope"}}}},"400":{"description":"Validation error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Unauthorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"Forbidden.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Tenant x402 credential is not configured.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"409":{"description":"Tenant credential is not BYO Coinbase CDP.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"x402 target management is not configured.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/payments/x402/fund":{"post":{"operationId":"fundMarketplacePostingWithX402","summary":"Fund a marketplace posting through tenant Coinbase CDP x402","tags":["billing"],"security":[{"BearerAuth":[]}],"requestBody":{"required":true,"description":"x402 marketplace posting funding request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/X402MarketplaceFundingRequest"}}}},"responses":{"200":{"description":"Sealed marketplace funding receipt.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarketplaceReceiptEnvelope"}}}},"400":{"description":"Validation error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Unauthorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"x402 payment verification failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Tenant x402 marketplace rail is not configured.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/payments/x402/refund":{"post":{"operationId":"refundMarketplaceFundingWithX402","summary":"Refund x402 marketplace funding to its verified payer","tags":["billing"],"security":[{"BearerAuth":[]}],"requestBody":{"required":true,"description":"Linked x402 marketplace funding refund request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/X402MarketplaceRefundRequest"}}}},"responses":{"200":{"description":"Sealed x402 marketplace refund receipt.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarketplaceReceiptEnvelope"}}}},"202":{"description":"x402 refund is reserved and still settling.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/X402SettlementPendingEnvelope"}}}},"400":{"description":"Validation error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Unauthorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Funding receipt not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"409":{"description":"Refund policy or provider-evidence refusal.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"x402 refund rail is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/payments/x402/payout":{"post":{"operationId":"payoutMarketplaceClaimWithX402","summary":"Pay a marketplace claim through tenant Coinbase CDP x402","tags":["billing"],"security":[{"BearerAuth":[]}],"requestBody":{"required":true,"description":"x402 marketplace claim payout request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/X402MarketplacePayoutRequest"}}}},"responses":{"200":{"description":"Sealed marketplace payout receipt.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarketplaceReceiptEnvelope"}}}},"400":{"description":"Validation error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Unauthorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"409":{"description":"Settlement policy refusal.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Tenant x402 payout rail is not configured.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/payments/x402/float-payout":{"post":{"operationId":"payoutMarketplaceClaimFromX402Float","summary":"Pay a marketplace claim from tenant x402 float","tags":["billing"],"security":[{"BearerAuth":[]}],"requestBody":{"required":true,"description":"x402 tenant-float payout request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/X402MarketplaceFloatPayoutRequest"}}}},"responses":{"200":{"description":"Sealed marketplace payout receipt.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarketplaceReceiptEnvelope"}}}},"400":{"description":"Validation error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Unauthorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"409":{"description":"Settlement policy refusal.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Tenant x402 payout rail is not configured.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/payments/x402/worker-wallet":{"post":{"operationId":"registerX402WorkerWallet","summary":"Register a worker payout wallet for x402 marketplace settlement","tags":["billing"],"security":[{"BearerAuth":[]}],"requestBody":{"required":true,"description":"Worker x402 payout wallet registration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/X402WorkerWalletRequest"}}}},"responses":{"200":{"description":"Registered x402 worker wallet.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/X402WorkerWalletEnvelope"}}}},"400":{"description":"Validation error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Unauthorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"Payment write scope is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"409":{"description":"Payout wallet is registered to another worker.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"x402 worker-wallet registry is not configured.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/service/token/exchange":{"post":{"operationId":"exchangeServiceToken","summary":"Exchange an OIDC token for a short-lived service access token","tags":["identity","knowledge"],"requestBody":{"required":true,"description":"OIDC-backed service token exchange request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceTokenExchangeRequest"}}}},"responses":{"200":{"description":"Issued service access token.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceTokenExchangeEnvelope"}}}},"400":{"description":"Validation error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"OIDC token not accepted.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Service principal not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Service token exchange unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/admin/registry/publish":{"post":{"operationId":"publishRegistrySkill","summary":"Publish a registry skill through the hosted admin surface","tags":["admin"],"security":[{"BearerAuth":[]}],"requestBody":{"required":true,"description":"Registry publish request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminRegistryPublishRequest"}}}},"responses":{"200":{"description":"Published registry skill.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminRegistryPublishEnvelope"}}}},"400":{"description":"Validation error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Unauthorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"Forbidden.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Registry store unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/admin/owners/{owner}":{"put":{"operationId":"putAdminOwnerProfile","summary":"Create or update an editable owner profile","tags":["admin"],"security":[{"BearerAuth":[]}],"parameters":[{"name":"owner","in":"path","required":true,"description":"Owner namespace.","schema":{"type":"string"}}],"requestBody":{"required":true,"description":"Editable owner profile metadata.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminOwnerProfileRequest"}}}},"responses":{"200":{"description":"Stored owner profile.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicOwnerProfileEnvelope"}}}},"400":{"description":"Validation error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Unauthorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"Forbidden.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Owner profile store unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/agent/config":{"get":{"operationId":"getHostedAgentConfig","summary":"Inspect hosted agent config for the authenticated principal","tags":["agent"],"security":[{"BearerAuth":[]}],"responses":{"200":{"description":"Hosted agent config.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentConfigEnvelope"}}}},"401":{"description":"Unauthorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}},"put":{"operationId":"putHostedAgentConfig","summary":"Create or update hosted agent config for the authenticated principal","tags":["agent"],"security":[{"BearerAuth":[]}],"requestBody":{"required":true,"description":"Hosted agent config request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PutAgentConfigRequest"}}}},"responses":{"200":{"description":"Stored hosted agent config.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentConfigEnvelope"}}}},"400":{"description":"Validation error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Unauthorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}},"delete":{"operationId":"deleteHostedAgentConfig","summary":"Delete hosted agent config for the authenticated principal","tags":["agent"],"security":[{"BearerAuth":[]}],"responses":{"200":{"description":"Deleted hosted agent config.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeletedEnvelope"}}}},"401":{"description":"Unauthorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Hosted agent config not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/knowledge/namespaces":{"get":{"operationId":"listKnowledgeNamespaces","summary":"List knowledge namespaces for the authenticated principal","tags":["knowledge"],"security":[{"BearerAuth":[]}],"responses":{"200":{"description":"Knowledge namespaces.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/KnowledgeNamespaceListEnvelope"}}}},"401":{"description":"Unauthorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/knowledge/namespaces/{namespace}":{"put":{"operationId":"putKnowledgeNamespace","summary":"Create or update one knowledge namespace","tags":["knowledge"],"security":[{"BearerAuth":[]}],"parameters":[{"name":"namespace","in":"path","required":true,"description":"Knowledge namespace.","schema":{"type":"string"}}],"requestBody":{"required":true,"description":"Knowledge namespace request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PutKnowledgeNamespaceRequest"}}}},"responses":{"200":{"description":"Stored knowledge namespace.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/KnowledgeNamespaceEnvelope"}}}},"400":{"description":"Validation error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Unauthorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}},"get":{"operationId":"getKnowledgeNamespace","summary":"Inspect one knowledge namespace","tags":["knowledge"],"security":[{"BearerAuth":[]}],"parameters":[{"name":"namespace","in":"path","required":true,"description":"Knowledge namespace.","schema":{"type":"string"}}],"responses":{"200":{"description":"Knowledge namespace.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/KnowledgeNamespaceEnvelope"}}}},"401":{"description":"Unauthorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Knowledge namespace not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/knowledge/namespaces/{namespace}/subjects/{subject}":{"put":{"operationId":"putKnowledgeSubject","summary":"Create or update one knowledge subject","tags":["knowledge"],"security":[{"BearerAuth":[]}],"parameters":[{"name":"namespace","in":"path","required":true,"description":"Knowledge namespace.","schema":{"type":"string"}},{"name":"subject","in":"path","required":true,"description":"Knowledge subject locator.","schema":{"type":"string"}}],"requestBody":{"required":true,"description":"Knowledge subject request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PutKnowledgeSubjectRequest"}}}},"responses":{"200":{"description":"Stored knowledge subject.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/KnowledgeSubjectEnvelope"}}}},"401":{"description":"Unauthorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}},"get":{"operationId":"getKnowledgeSubject","summary":"Inspect one knowledge subject","tags":["knowledge"],"security":[{"BearerAuth":[]}],"parameters":[{"name":"namespace","in":"path","required":true,"description":"Knowledge namespace.","schema":{"type":"string"}},{"name":"subject","in":"path","required":true,"description":"Knowledge subject locator.","schema":{"type":"string"}}],"responses":{"200":{"description":"Knowledge subject.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/KnowledgeSubjectEnvelope"}}}},"401":{"description":"Unauthorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Knowledge subject not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/knowledge/namespaces/{namespace}/subjects/{subject}/entries":{"post":{"operationId":"appendKnowledgeEntry","summary":"Append one knowledge entry","tags":["knowledge"],"security":[{"BearerAuth":[]}],"parameters":[{"name":"namespace","in":"path","required":true,"description":"Knowledge namespace.","schema":{"type":"string"}},{"name":"subject","in":"path","required":true,"description":"Knowledge subject locator.","schema":{"type":"string"}}],"requestBody":{"required":true,"description":"Knowledge entry append request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AppendKnowledgeEntryRequest"}}}},"responses":{"201":{"description":"Accepted knowledge entry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/KnowledgeEntryEnvelope"}}}},"400":{"description":"Validation error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Unauthorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}},"get":{"operationId":"listKnowledgeEntries","summary":"List knowledge entries for one subject","tags":["knowledge"],"security":[{"BearerAuth":[]}],"parameters":[{"name":"namespace","in":"path","required":true,"description":"Knowledge namespace.","schema":{"type":"string"}},{"name":"subject","in":"path","required":true,"description":"Knowledge subject locator.","schema":{"type":"string"}},{"name":"entry_kind","in":"query","required":false,"description":"Optional knowledge entry kind filter.","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Maximum number of entries to return.","schema":{"type":"string"}}],"responses":{"200":{"description":"Knowledge entries.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/KnowledgeEntryListEnvelope"}}}},"401":{"description":"Unauthorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/knowledge/namespaces/{namespace}/subjects/{subject}/links":{"post":{"operationId":"appendKnowledgeLink","summary":"Create or refresh one knowledge link","tags":["knowledge"],"security":[{"BearerAuth":[]}],"parameters":[{"name":"namespace","in":"path","required":true,"description":"Knowledge namespace.","schema":{"type":"string"}},{"name":"subject","in":"path","required":true,"description":"Knowledge subject locator.","schema":{"type":"string"}}],"requestBody":{"required":true,"description":"Knowledge link request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AppendKnowledgeLinkRequest"}}}},"responses":{"201":{"description":"Accepted knowledge link.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/KnowledgeLinkEnvelope"}}}},"400":{"description":"Validation error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Unauthorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}},"get":{"operationId":"listKnowledgeLinks","summary":"List knowledge links for one subject","tags":["knowledge"],"security":[{"BearerAuth":[]}],"parameters":[{"name":"namespace","in":"path","required":true,"description":"Knowledge namespace.","schema":{"type":"string"}},{"name":"subject","in":"path","required":true,"description":"Knowledge subject locator.","schema":{"type":"string"}},{"name":"direction","in":"query","required":false,"description":"Link direction: incoming, outgoing, or both.","schema":{"type":"string"}}],"responses":{"200":{"description":"Knowledge links.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/KnowledgeLinkListEnvelope"}}}},"401":{"description":"Unauthorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/knowledge/namespaces/{namespace}/snapshots/{snapshot}":{"put":{"operationId":"putKnowledgeSnapshot","summary":"Create or update one knowledge snapshot","tags":["knowledge"],"security":[{"BearerAuth":[]}],"parameters":[{"name":"namespace","in":"path","required":true,"description":"Knowledge namespace.","schema":{"type":"string"}},{"name":"snapshot","in":"path","required":true,"description":"Snapshot name.","schema":{"type":"string"}}],"requestBody":{"required":true,"description":"Knowledge snapshot request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PutKnowledgeSnapshotRequest"}}}},"responses":{"200":{"description":"Stored knowledge snapshot.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/KnowledgeSnapshotEnvelope"}}}},"400":{"description":"Validation error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Unauthorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}},"get":{"operationId":"getKnowledgeSnapshot","summary":"Inspect one private knowledge snapshot","tags":["knowledge"],"security":[{"BearerAuth":[]}],"parameters":[{"name":"namespace","in":"path","required":true,"description":"Knowledge namespace.","schema":{"type":"string"}},{"name":"snapshot","in":"path","required":true,"description":"Snapshot name.","schema":{"type":"string"}},{"name":"subject_locator","in":"query","required":false,"description":"Optional subject locator for subject-scoped snapshots.","schema":{"type":"string"}}],"responses":{"200":{"description":"Knowledge snapshot.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/KnowledgeSnapshotEnvelope"}}}},"401":{"description":"Unauthorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Knowledge snapshot not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/public/knowledge/{principalId}/namespaces/{namespace}/snapshots/{snapshot}":{"get":{"operationId":"getPublishedKnowledgeSnapshot","summary":"Inspect one published public knowledge snapshot","tags":["public","knowledge"],"parameters":[{"name":"principalId","in":"path","required":true,"description":"Snapshot owner principal id.","schema":{"type":"string"}},{"name":"namespace","in":"path","required":true,"description":"Knowledge namespace.","schema":{"type":"string"}},{"name":"snapshot","in":"path","required":true,"description":"Snapshot name.","schema":{"type":"string"}},{"name":"subject_locator","in":"query","required":false,"description":"Optional subject locator for subject-scoped snapshots.","schema":{"type":"string"}}],"responses":{"200":{"description":"Published knowledge snapshot.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/KnowledgeSnapshotEnvelope"}}}},"404":{"description":"Published knowledge snapshot not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/runs":{"post":{"operationId":"createRun","summary":"Create a hosted run","tags":["runs"],"security":[{"BearerAuth":[]}],"requestBody":{"required":true,"description":"Hosted run submission.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateRunRequest"}}}},"responses":{"201":{"description":"Accepted run.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateRunResponse"}}}},"400":{"description":"Validation error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Unauthorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}},"get":{"operationId":"listRuns","summary":"List runs for the authenticated principal","tags":["runs"],"security":[{"BearerAuth":[]}],"parameters":[{"name":"q","in":"query","required":false,"description":"Case-insensitive search over run id, skill, source type, actors, and artifact types.","schema":{"type":"string"}},{"name":"skill","in":"query","required":false,"description":"Exact skill filter.","schema":{"type":"string"}},{"name":"status","in":"query","required":false,"description":"Exact hosted lifecycle status filter.","schema":{"type":"string"}},{"name":"source","in":"query","required":false,"description":"Exact source type filter derived from the attached receipt.","schema":{"type":"string"}},{"name":"actor","in":"query","required":false,"description":"Exact actor/provider filter derived from receipt metadata and submitted resolutions.","schema":{"type":"string"}},{"name":"artifact_type","in":"query","required":false,"description":"Exact artifact type filter derived from hosted ledger entries.","schema":{"type":"string"}},{"name":"since","in":"query","required":false,"description":"Inclusive ISO-8601 lower bound for run start time.","schema":{"type":"string"}},{"name":"until","in":"query","required":false,"description":"Inclusive ISO-8601 upper bound for run start time.","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Maximum number of runs to return, clamped to 1..100.","schema":{"type":"string"}},{"name":"cursor","in":"query","required":false,"description":"Optional opaque cursor returned by the previous run-list page.","schema":{"type":"string"}}],"responses":{"200":{"description":"Run list.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunListEnvelope"}}}},"401":{"description":"Unauthorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/skills/{skill}/run":{"post":{"operationId":"runSkill","summary":"Create a hosted run for a skill","tags":["runs","skills"],"security":[{"BearerAuth":[]}],"parameters":[{"name":"skill","in":"path","required":true,"description":"Skill reference. For owner/name refs, URL-encode the slash.","schema":{"type":"string"}}],"requestBody":{"required":true,"description":"Hosted skill run submission.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunSkillRequest"}}}},"responses":{"201":{"description":"Accepted run.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateRunResponse"}}}},"400":{"description":"Validation error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Unauthorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/skills/{owner}/{name}/run":{"post":{"operationId":"runOwnedSkill","summary":"Create a hosted run for an owner-scoped skill","tags":["runs","skills"],"security":[{"BearerAuth":[]}],"parameters":[{"name":"owner","in":"path","required":true,"description":"Skill owner.","schema":{"type":"string"}},{"name":"name","in":"path","required":true,"description":"Skill name.","schema":{"type":"string"}}],"requestBody":{"required":true,"description":"Hosted skill run submission.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunSkillRequest"}}}},"responses":{"201":{"description":"Accepted run.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateRunResponse"}}}},"400":{"description":"Validation error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Unauthorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/runs/diff":{"get":{"operationId":"diffRuns","summary":"Diff two hosted runs","tags":["runs"],"security":[{"BearerAuth":[]}],"parameters":[{"name":"left","in":"query","required":false,"description":"Left run id.","schema":{"type":"string"}},{"name":"right","in":"query","required":false,"description":"Right run id.","schema":{"type":"string"}}],"responses":{"200":{"description":"Run diff.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunDiffEnvelope"}}}},"400":{"description":"Validation error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Unauthorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Run not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/runs/{id}":{"get":{"operationId":"getRun","summary":"Inspect one run","tags":["runs"],"security":[{"BearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"description":"Run id.","schema":{"type":"string"}}],"responses":{"200":{"description":"Run detail.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunDetailEnvelope"}}}},"401":{"description":"Unauthorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Run not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/runs/{id}/rerun":{"post":{"operationId":"rerunRun","summary":"Create a rerun from a finished hosted run","tags":["runs"],"security":[{"BearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"description":"Finished run id.","schema":{"type":"string"}}],"requestBody":{"required":true,"description":"Optional rerun request metadata.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RerunRunRequest"}}}},"responses":{"201":{"description":"Accepted rerun.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RerunRunResponse"}}}},"401":{"description":"Unauthorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Run not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"409":{"description":"Run conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/runs/{id}/requests":{"get":{"operationId":"listRunRequests","summary":"List outstanding requests for a run","tags":["runs"],"security":[{"BearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"description":"Run id.","schema":{"type":"string"}}],"responses":{"200":{"description":"Run requests.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunRequestsEnvelope"}}}},"401":{"description":"Unauthorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Run not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/runs/{id}/requests/{requestId}/responses":{"post":{"operationId":"recordRunRequestResponse","summary":"Submit a response to a run request","tags":["runs"],"security":[{"BearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"description":"Run id.","schema":{"type":"string"}},{"name":"requestId","in":"path","required":true,"description":"Run request id.","schema":{"type":"string"}}],"requestBody":{"required":true,"description":"Run request response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunRequestResponseRequest"}}}},"responses":{"200":{"description":"Recorded response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunRecordedEnvelope"}}}},"400":{"description":"Validation error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Unauthorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Run not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"409":{"description":"Run conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/policy/bundles":{"get":{"operationId":"listPolicyBundles","summary":"List policy bundle versions for the authenticated principal","tags":["governance"],"security":[{"BearerAuth":[]}],"responses":{"200":{"description":"Policy bundles.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PolicyBundleListEnvelope"}}}},"401":{"description":"Unauthorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/policy/bundles/{bundleId}/versions/{version}":{"get":{"operationId":"getPolicyBundle","summary":"Inspect one policy bundle version","tags":["governance"],"security":[{"BearerAuth":[]}],"parameters":[{"name":"bundleId","in":"path","required":true,"description":"Policy bundle id.","schema":{"type":"string"}},{"name":"version","in":"path","required":true,"description":"Policy bundle version.","schema":{"type":"string"}}],"responses":{"200":{"description":"Policy bundle.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PolicyBundleEnvelope"}}}},"401":{"description":"Unauthorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Policy bundle not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}},"put":{"operationId":"putPolicyBundle","summary":"Create one immutable policy bundle version","tags":["governance"],"security":[{"BearerAuth":[]}],"parameters":[{"name":"bundleId","in":"path","required":true,"description":"Policy bundle id.","schema":{"type":"string"}},{"name":"version","in":"path","required":true,"description":"Policy bundle version.","schema":{"type":"string"}}],"requestBody":{"required":true,"description":"Policy bundle definition.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PutPolicyBundleRequest"}}}},"responses":{"200":{"description":"Stored policy bundle.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PolicyBundleEnvelope"}}}},"400":{"description":"Validation error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Unauthorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/policy/attachments":{"get":{"operationId":"listPolicyAttachments","summary":"List policy attachments for the authenticated principal","tags":["governance"],"security":[{"BearerAuth":[]}],"responses":{"200":{"description":"Policy attachments.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PolicyAttachmentListEnvelope"}}}},"401":{"description":"Unauthorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/policy/attachments/workspace":{"put":{"operationId":"putWorkspacePolicyAttachment","summary":"Attach one policy bundle version to the principal default workspace scope","tags":["governance"],"security":[{"BearerAuth":[]}],"parameters":[{"name":"If-Match","in":"header","required":false,"description":"Required when replacing an existing attachment. Use the current attachment updated_at timestamp.","schema":{"type":"string"}}],"requestBody":{"required":true,"description":"Policy attachment.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PutPolicyAttachmentRequest"}}}},"responses":{"200":{"description":"Stored policy attachment.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PolicyAttachmentEnvelope"}}}},"400":{"description":"Validation error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Unauthorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Referenced policy bundle not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"412":{"description":"Revision precondition failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"428":{"description":"Revision precondition required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}},"delete":{"operationId":"deleteWorkspacePolicyAttachment","summary":"Delete the principal default policy attachment","tags":["governance"],"security":[{"BearerAuth":[]}],"parameters":[{"name":"If-Match","in":"header","required":false,"description":"Required when deleting an existing attachment. Use the current attachment updated_at timestamp.","schema":{"type":"string"}}],"responses":{"200":{"description":"Deleted policy attachment.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PolicyAttachmentEnvelope"}}}},"401":{"description":"Unauthorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Policy attachment not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"412":{"description":"Revision precondition failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"428":{"description":"Revision precondition required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/policy/attachments/skills/{skill}":{"put":{"operationId":"putSkillPolicyAttachment","summary":"Attach one policy bundle version to a skill override scope","tags":["governance"],"security":[{"BearerAuth":[]}],"parameters":[{"name":"skill","in":"path","required":true,"description":"Skill id or skill name.","schema":{"type":"string"}},{"name":"If-Match","in":"header","required":false,"description":"Required when replacing an existing attachment. Use the current attachment updated_at timestamp.","schema":{"type":"string"}}],"requestBody":{"required":true,"description":"Policy attachment.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PutPolicyAttachmentRequest"}}}},"responses":{"200":{"description":"Stored policy attachment.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PolicyAttachmentEnvelope"}}}},"400":{"description":"Validation error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Unauthorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Referenced policy bundle not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"412":{"description":"Revision precondition failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"428":{"description":"Revision precondition required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}},"delete":{"operationId":"deleteSkillPolicyAttachment","summary":"Delete one skill-specific policy attachment","tags":["governance"],"security":[{"BearerAuth":[]}],"parameters":[{"name":"skill","in":"path","required":true,"description":"Skill id or skill name.","schema":{"type":"string"}},{"name":"If-Match","in":"header","required":false,"description":"Required when deleting an existing attachment. Use the current attachment updated_at timestamp.","schema":{"type":"string"}}],"responses":{"200":{"description":"Deleted policy attachment.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PolicyAttachmentEnvelope"}}}},"401":{"description":"Unauthorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Policy attachment not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"412":{"description":"Revision precondition failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"428":{"description":"Revision precondition required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/approval-routes":{"get":{"operationId":"listApprovalRoutes","summary":"List approval routes for the authenticated principal","tags":["governance"],"security":[{"BearerAuth":[]}],"responses":{"200":{"description":"Approval routes.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApprovalRouteListEnvelope"}}}},"401":{"description":"Unauthorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/approval-routes/{routeId}":{"get":{"operationId":"getApprovalRoute","summary":"Inspect one approval route","tags":["governance"],"security":[{"BearerAuth":[]}],"parameters":[{"name":"routeId","in":"path","required":true,"description":"Approval route id.","schema":{"type":"string"}}],"responses":{"200":{"description":"Approval route.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApprovalRouteEnvelope"}}}},"401":{"description":"Unauthorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Approval route not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}},"put":{"operationId":"putApprovalRoute","summary":"Create or update one approval route","tags":["governance"],"security":[{"BearerAuth":[]}],"parameters":[{"name":"routeId","in":"path","required":true,"description":"Approval route id.","schema":{"type":"string"}},{"name":"If-Match","in":"header","required":false,"description":"Required when replacing an existing approval route. Use the current route updated_at timestamp.","schema":{"type":"string"}}],"requestBody":{"required":true,"description":"Approval route definition.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PutApprovalRouteRequest"}}}},"responses":{"200":{"description":"Stored approval route.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApprovalRouteEnvelope"}}}},"400":{"description":"Validation error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Unauthorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"412":{"description":"Revision precondition failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"428":{"description":"Revision precondition required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}},"delete":{"operationId":"deleteApprovalRoute","summary":"Delete one approval route","tags":["governance"],"security":[{"BearerAuth":[]}],"parameters":[{"name":"routeId","in":"path","required":true,"description":"Approval route id.","schema":{"type":"string"}},{"name":"If-Match","in":"header","required":false,"description":"Required when deleting an existing approval route. Use the current route updated_at timestamp.","schema":{"type":"string"}}],"responses":{"200":{"description":"Deleted approval route.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApprovalRouteEnvelope"}}}},"401":{"description":"Unauthorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Approval route not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"412":{"description":"Revision precondition failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"428":{"description":"Revision precondition required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/admin/approvals":{"get":{"operationId":"listAdminApprovals","summary":"Inspect the hosted approval inbox across principals","tags":["governance","admin"],"security":[{"BearerAuth":[]}],"parameters":[{"name":"principal_id","in":"query","required":false,"description":"Optional principal id filter.","schema":{"type":"string"}},{"name":"skill","in":"query","required":false,"description":"Optional skill filter.","schema":{"type":"string"}},{"name":"route","in":"query","required":false,"description":"Optional approval route id filter.","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Optional page size for approval-row pagination.","schema":{"type":"string"}},{"name":"cursor","in":"query","required":false,"description":"Optional opaque cursor returned by the previous approval inbox page.","schema":{"type":"string"}}],"responses":{"200":{"description":"Approval inbox.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApprovalInboxEnvelope"}}}},"401":{"description":"Unauthorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"Forbidden.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/connect/tickets":{"post":{"operationId":"createConnectTicket","summary":"Create a signed connect ticket","tags":["connect"],"security":[{"BearerAuth":[]}],"requestBody":{"required":true,"description":"Connect ticket request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateConnectTicketRequest"}}}},"responses":{"200":{"description":"Created connect ticket.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConnectTicketEnvelope"}}}},"400":{"description":"Validation error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Unauthorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/provider-references":{"get":{"operationId":"listProviderReferences","summary":"List active provider credential references","tags":["provider-references"],"security":[{"BearerAuth":[]}],"responses":{"200":{"description":"Provider references.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProviderReferenceListEnvelope"}}}},"401":{"description":"Unauthorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/provider-references/{provider_reference}":{"delete":{"operationId":"revokeProviderReference","summary":"Revoke one provider credential reference","tags":["provider-references"],"security":[{"BearerAuth":[]}],"parameters":[{"name":"provider_reference","in":"path","required":true,"description":"Provider reference.","schema":{"type":"string"}}],"responses":{"200":{"description":"Revoked provider reference.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProviderReferenceRevokedEnvelope"}}}},"401":{"description":"Unauthorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Provider reference not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/grants":{"get":{"operationId":"listGrants","summary":"List grants","tags":["connect"],"security":[{"BearerAuth":[]}],"responses":{"200":{"description":"Grants.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GrantListEnvelope"}}}},"401":{"description":"Unauthorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/grants/{id}":{"delete":{"operationId":"revokeGrant","summary":"Revoke one grant","tags":["connect"],"security":[{"BearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"description":"Grant id.","schema":{"type":"string"}}],"responses":{"200":{"description":"Revoked grant.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GrantRevokedEnvelope"}}}},"401":{"description":"Unauthorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Grant not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/provider-operations":{"post":{"operationId":"invokeProviderOperation","summary":"Invoke one grant-bound governed provider operation","tags":["connect"],"security":[{"BearerAuth":[]}],"requestBody":{"required":true,"description":"Grant and fixed provider operation input.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProviderOperationRequest"}}}},"responses":{"200":{"description":"Provider operation result.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProviderOperationResultEnvelope"}}}},"400":{"description":"Invalid or unsupported operation request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Unauthorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"Grant or binding does not authorize the operation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Grant not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"409":{"description":"Connector-backed provider operation unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/connect/sessions":{"post":{"operationId":"createConnectSession","summary":"Create a connect session","tags":["connect"],"security":[{"BearerAuth":[]}],"requestBody":{"required":true,"description":"Connect session request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateConnectSessionRequest"}}}},"responses":{"200":{"description":"Existing grant reused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConnectSessionCompleteEnvelope"}}}},"201":{"description":"OAuth required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConnectSessionPendingEnvelope"}}}},"400":{"description":"Validation error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Unauthorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"409":{"description":"Connect is not wired for the requested provider.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConnectSessionUnavailableEnvelope"}}}}}}},"/v1/connect/sessions/{id}":{"get":{"operationId":"getConnectSession","summary":"Inspect one connect session","tags":["connect"],"security":[{"BearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"description":"Session id.","schema":{"type":"string"}}],"responses":{"200":{"description":"Connect session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConnectSessionStatusEnvelope"}}}},"401":{"description":"Unauthorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Flow not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/admin/public/evidence":{"post":{"operationId":"appendPublicEvidence","summary":"Append public website evidence events","tags":["admin","public"],"security":[{"BearerAuth":[]}],"requestBody":{"required":true,"description":"Public evidence ingestion request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicEvidenceIngestRequest"}}}},"responses":{"202":{"description":"Stored public evidence events.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicEvidenceIngestEnvelope"}}}},"400":{"description":"Validation error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Unauthorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"Forbidden.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Public evidence store unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/admin/runs":{"get":{"operationId":"listAdminRuns","summary":"List runs across principals","tags":["admin"],"security":[{"BearerAuth":[]}],"parameters":[{"name":"principal_id","in":"query","required":false,"description":"Filter by principal id.","schema":{"type":"string"}},{"name":"q","in":"query","required":false,"description":"Case-insensitive search over run id, skill, source type, actors, and artifact types.","schema":{"type":"string"}},{"name":"skill","in":"query","required":false,"description":"Exact skill filter.","schema":{"type":"string"}},{"name":"status","in":"query","required":false,"description":"Exact hosted lifecycle status filter.","schema":{"type":"string"}},{"name":"source","in":"query","required":false,"description":"Exact source type filter derived from the attached receipt.","schema":{"type":"string"}},{"name":"actor","in":"query","required":false,"description":"Exact actor/provider filter derived from receipt metadata and submitted resolutions.","schema":{"type":"string"}},{"name":"artifact_type","in":"query","required":false,"description":"Exact artifact type filter derived from hosted ledger entries.","schema":{"type":"string"}},{"name":"since","in":"query","required":false,"description":"Inclusive ISO-8601 lower bound for run start time.","schema":{"type":"string"}},{"name":"until","in":"query","required":false,"description":"Inclusive ISO-8601 upper bound for run start time.","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Maximum number of runs to return, clamped to 1..100.","schema":{"type":"string"}},{"name":"cursor","in":"query","required":false,"description":"Optional opaque cursor returned by the previous run-list page.","schema":{"type":"string"}}],"responses":{"200":{"description":"Run list.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunListEnvelope"}}}},"401":{"description":"Unauthorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"Forbidden.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/admin/runs/{id}":{"get":{"operationId":"getAdminRun","summary":"Inspect one run across principals","tags":["admin"],"security":[{"BearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"description":"Run id.","schema":{"type":"string"}}],"responses":{"200":{"description":"Run detail.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunDetailEnvelope"}}}},"401":{"description":"Unauthorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"Forbidden.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Run not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}}},"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"token"}},"schemas":{"StatusEnvelope":{"type":"object","additionalProperties":true,"properties":{"status":{"type":"string"}},"required":["status"]},"ErrorEnvelope":{"type":"object","properties":{"error":{"type":"string"},"status":{"type":"string"}},"required":["error"],"additionalProperties":true},"HostedReadinessCheck":{"type":"object","properties":{"status":{"type":"string","enum":["ok","not_ready","disabled"]},"error":{"type":"string"}},"required":["status"],"additionalProperties":true},"HostedReadinessEnvelope":{"type":"object","properties":{"status":{"type":"string","const":"ok"},"checks":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/HostedReadinessCheck"}}},"required":["status","checks"],"additionalProperties":false},"HostedReadinessErrorEnvelope":{"type":"object","properties":{"status":{"type":"string","const":"not_ready"},"error":{"type":"string"},"checks":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/HostedReadinessCheck"}}},"required":["status","error","checks"],"additionalProperties":false},"HostedApiLatencyBucketCounts":{"type":"object","properties":{"le_50ms":{"type":"integer","minimum":0},"le_100ms":{"type":"integer","minimum":0},"le_250ms":{"type":"integer","minimum":0},"le_500ms":{"type":"integer","minimum":0},"le_1000ms":{"type":"integer","minimum":0},"gt_1000ms":{"type":"integer","minimum":0}},"required":["le_50ms","le_100ms","le_250ms","le_500ms","le_1000ms","gt_1000ms"],"additionalProperties":false},"HostedApiLatencyMetrics":{"type":"object","properties":{"total":{"type":"number","minimum":0},"average":{"type":"number","minimum":0},"max":{"type":"number","minimum":0},"buckets":{"$ref":"#/components/schemas/HostedApiLatencyBucketCounts"}},"required":["total","average","max","buckets"],"additionalProperties":false},"HostedApiRouteMetrics":{"type":"object","properties":{"method":{"type":"string"},"route":{"type":"string"},"requests_total":{"type":"integer","minimum":0},"error_responses_total":{"type":"integer","minimum":0},"client_error_responses_total":{"type":"integer","minimum":0},"server_error_responses_total":{"type":"integer","minimum":0},"latency_ms":{"$ref":"#/components/schemas/HostedApiLatencyMetrics"},"status_counts":{"type":"object","additionalProperties":{"type":"integer","minimum":0}}},"required":["method","route","requests_total","error_responses_total","client_error_responses_total","server_error_responses_total","latency_ms","status_counts"],"additionalProperties":false},"HostedApiMetrics":{"type":"object","properties":{"started_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"in_flight_requests":{"type":"integer","minimum":0},"requests_total":{"type":"integer","minimum":0},"error_responses_total":{"type":"integer","minimum":0},"client_error_responses_total":{"type":"integer","minimum":0},"server_error_responses_total":{"type":"integer","minimum":0},"latency_ms":{"$ref":"#/components/schemas/HostedApiLatencyMetrics"},"status_counts":{"type":"object","additionalProperties":{"type":"integer","minimum":0}},"routes":{"type":"array","items":{"$ref":"#/components/schemas/HostedApiRouteMetrics"}}},"required":["started_at","updated_at","in_flight_requests","requests_total","error_responses_total","client_error_responses_total","server_error_responses_total","latency_ms","status_counts","routes"],"additionalProperties":false},"HostedApiMetricsEnvelope":{"type":"object","properties":{"status":{"type":"string","const":"success"},"metrics":{"$ref":"#/components/schemas/HostedApiMetrics"}},"required":["status","metrics"],"additionalProperties":false},"PrincipalSummary":{"type":"object","properties":{"principal_id":{"type":"string"},"role":{"type":"string","enum":["user","admin","service"]},"display_name":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}},"namespace_prefixes":{"type":"array","items":{"type":"string"}}},"required":["principal_id","role"],"additionalProperties":false},"PrincipalEnvelope":{"type":"object","properties":{"status":{"type":"string","const":"success"},"principal":{"$ref":"#/components/schemas/PrincipalSummary"}},"required":["status","principal"],"additionalProperties":false},"AgentConfigSummary":{"oneOf":[{"type":"object","properties":{"provider":{"type":"string"},"model":{"type":"string"},"base_url":{"type":"string","format":"uri"},"has_api_key":{"type":"boolean","const":true},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}},"required":["provider","model","has_api_key","created_at","updated_at"],"additionalProperties":false},{"type":"null"}]},"AgentConfigEnvelope":{"type":"object","properties":{"status":{"type":"string","const":"success"},"agent_config":{"$ref":"#/components/schemas/AgentConfigSummary"}},"required":["status","agent_config"],"additionalProperties":false},"ServiceTokenExchangeEnvelope":{"type":"object","properties":{"status":{"type":"string","const":"success"},"access_token":{"type":"string"},"expires_at":{"type":"string","format":"date-time"},"principal":{"$ref":"#/components/schemas/PrincipalSummary"}},"required":["status","access_token","expires_at","principal"],"additionalProperties":false},"KnowledgeNamespaceSummary":{"type":"object","properties":{"id":{"type":"string"},"namespace":{"type":"string"},"title":{"type":"string"},"description":{"type":"string"},"metadata":{"type":"object","additionalProperties":true},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}},"required":["id","namespace","metadata","created_at","updated_at"],"additionalProperties":false},"KnowledgeNamespaceEnvelope":{"type":"object","properties":{"status":{"type":"string","const":"success"},"namespace":{"$ref":"#/components/schemas/KnowledgeNamespaceSummary"}},"required":["status","namespace"],"additionalProperties":false},"KnowledgeNamespaceListEnvelope":{"type":"object","properties":{"status":{"type":"string","const":"success"},"namespaces":{"type":"array","items":{"$ref":"#/components/schemas/KnowledgeNamespaceSummary"}}},"required":["status","namespaces"],"additionalProperties":false},"KnowledgeSubjectSummary":{"type":"object","properties":{"id":{"type":"string"},"namespace":{"type":"string"},"subject_locator":{"type":"string"},"subject_kind":{"type":"string"},"subject_facet":{"type":"string"},"title":{"type":"string"},"canonical_uri":{"type":"string"},"aliases":{"type":"array","items":{"type":"string"}},"metadata":{"type":"object","additionalProperties":true},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}},"required":["id","namespace","subject_locator","subject_kind","aliases","metadata","created_at","updated_at"],"additionalProperties":false},"KnowledgeSubjectEnvelope":{"type":"object","properties":{"status":{"type":"string","const":"success"},"subject":{"$ref":"#/components/schemas/KnowledgeSubjectSummary"}},"required":["status","subject"],"additionalProperties":false},"KnowledgeEntrySummary":{"type":"object","properties":{"id":{"type":"string"},"namespace":{"type":"string"},"subject_locator":{"type":"string"},"entry_kind":{"type":"string"},"author_id":{"type":"string"},"author_role":{"type":"string","enum":["user","admin","service"]},"confidence":{"type":"number"},"freshness":{"type":"string"},"idempotency_key":{"type":"string"},"content":{},"metadata":{"type":"object","additionalProperties":true},"provenance":{"type":"object","additionalProperties":true},"recorded_at":{"type":"string","format":"date-time"},"created_at":{"type":"string","format":"date-time"}},"required":["id","namespace","subject_locator","entry_kind","author_id","author_role","content","metadata","provenance","recorded_at","created_at"],"additionalProperties":false},"KnowledgeEntryEnvelope":{"type":"object","properties":{"status":{"type":"string","enum":["success","accepted"]},"entry":{"$ref":"#/components/schemas/KnowledgeEntrySummary"}},"required":["status","entry"],"additionalProperties":false},"KnowledgeEntryListEnvelope":{"type":"object","properties":{"status":{"type":"string","const":"success"},"entries":{"type":"array","items":{"$ref":"#/components/schemas/KnowledgeEntrySummary"}}},"required":["status","entries"],"additionalProperties":false},"KnowledgeLinkSummary":{"type":"object","properties":{"id":{"type":"string"},"namespace":{"type":"string"},"source_subject_locator":{"type":"string"},"target_subject_locator":{"type":"string"},"link_kind":{"type":"string"},"author_id":{"type":"string"},"author_role":{"type":"string","enum":["user","admin","service"]},"confidence":{"type":"number"},"provenance":{"type":"object","additionalProperties":true},"metadata":{"type":"object","additionalProperties":true},"created_at":{"type":"string","format":"date-time"}},"required":["id","namespace","source_subject_locator","target_subject_locator","link_kind","author_id","author_role","provenance","metadata","created_at"],"additionalProperties":false},"KnowledgeLinkEnvelope":{"type":"object","properties":{"status":{"type":"string","enum":["success","accepted"]},"link":{"$ref":"#/components/schemas/KnowledgeLinkSummary"}},"required":["status","link"],"additionalProperties":false},"KnowledgeLinkListEnvelope":{"type":"object","properties":{"status":{"type":"string","const":"success"},"links":{"type":"array","items":{"$ref":"#/components/schemas/KnowledgeLinkSummary"}}},"required":["status","links"],"additionalProperties":false},"KnowledgeSnapshotSummary":{"type":"object","properties":{"id":{"type":"string"},"namespace":{"type":"string"},"subject_locator":{"type":"string"},"snapshot_name":{"type":"string"},"body":{},"source_refs":{"type":"array","items":{"type":"object","additionalProperties":true}},"projector_id":{"type":"string"},"watermark":{"type":"string"},"metadata":{"type":"object","additionalProperties":true},"visibility":{"type":"string","enum":["private","published"]},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"published_at":{"type":"string","format":"date-time"}},"required":["id","namespace","snapshot_name","body","source_refs","metadata","visibility","created_at","updated_at"],"additionalProperties":false},"KnowledgeSnapshotEnvelope":{"type":"object","properties":{"status":{"type":"string","const":"success"},"snapshot":{"$ref":"#/components/schemas/KnowledgeSnapshotSummary"}},"required":["status","snapshot"],"additionalProperties":false},"DeletedEnvelope":{"type":"object","properties":{"status":{"type":"string","const":"deleted"}},"required":["status"],"additionalProperties":false},"HostedRunSummary":{"$ref":"../../spec/hosted/hosted-run-summary.schema.json"},"CreateRunRequest":{"$ref":"../../spec/hosted/create-run.request.schema.json"},"RunSkillRequest":{"type":"object","properties":{"runner":{"type":"string","minLength":1},"inputs":{"type":"object","additionalProperties":true},"idempotency_key":{"type":"string","minLength":1}},"additionalProperties":false},"RerunRunRequest":{"$ref":"../../spec/hosted/run-rerun.request.schema.json"},"PutAgentConfigRequest":{"$ref":"../../spec/hosted/agent-config.request.schema.json"},"ServiceTokenExchangeRequest":{"$ref":"../../spec/hosted/service-token-exchange.request.schema.json"},"PutKnowledgeNamespaceRequest":{"type":"object","properties":{"title":{"type":"string"},"description":{"type":"string"},"metadata":{"type":"object","additionalProperties":true}},"additionalProperties":false},"PutKnowledgeSubjectRequest":{"type":"object","properties":{"subject_kind":{"type":"string"},"subject_facet":{"type":"string"},"title":{"type":"string"},"canonical_uri":{"type":"string"},"aliases":{"type":"array","items":{"type":"string"}},"metadata":{"type":"object","additionalProperties":true}},"required":["subject_kind"],"additionalProperties":false},"AppendKnowledgeEntryRequest":{"type":"object","properties":{"entry_kind":{"type":"string"},"content":{},"confidence":{"type":"number"},"freshness":{"type":"string"},"idempotency_key":{"type":"string"},"metadata":{"type":"object","additionalProperties":true},"provenance":{"type":"object","additionalProperties":true},"recorded_at":{"type":"string","format":"date-time"},"created_at":{"type":"string","format":"date-time"}},"required":["entry_kind","content"],"additionalProperties":false},"AppendKnowledgeLinkRequest":{"type":"object","properties":{"link_kind":{"type":"string"},"target_subject_locator":{"type":"string"},"confidence":{"type":"number"},"provenance":{"type":"object","additionalProperties":true},"metadata":{"type":"object","additionalProperties":true},"created_at":{"type":"string","format":"date-time"}},"required":["link_kind","target_subject_locator"],"additionalProperties":false},"PutKnowledgeSnapshotRequest":{"type":"object","properties":{"subject_locator":{"type":"string"},"body":{},"source_refs":{"type":"array","items":{"type":"object","additionalProperties":true}},"projector_id":{"type":"string"},"watermark":{"type":"string"},"metadata":{"type":"object","additionalProperties":true},"visibility":{"type":"string","enum":["private","published"]},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"published_at":{"type":"string","format":"date-time"}},"required":["body"],"additionalProperties":false},"CreateRunResponse":{"$ref":"../../spec/hosted/create-run.response.schema.json"},"RerunRunResponse":{"$ref":"../../spec/hosted/run-rerun.response.schema.json"},"RunListEnvelope":{"type":"object","properties":{"status":{"type":"string","const":"success"},"runs":{"type":"array","items":{"$ref":"#/components/schemas/HostedRunSummary"}},"next_cursor":{"type":"string"}},"required":["status","runs"],"additionalProperties":false},"RunDetailEnvelope":{"$ref":"../../spec/hosted/hosted-run-detail.schema.json"},"RunDiffEnvelope":{"$ref":"../../spec/hosted/run-diff.response.schema.json"},"RunRequestSummary":{"$ref":"../../spec/hosted/run-request-summary.schema.json"},"RunRequestsEnvelope":{"$ref":"../../spec/hosted/run-requests.response.schema.json"},"RunRequestResponseRequest":{"$ref":"../../spec/hosted/run-request-response.request.schema.json"},"RunRecordedEnvelope":{"type":"object","properties":{"status":{"type":"string","const":"recorded"},"run":{"$ref":"#/components/schemas/HostedRunSummary"}},"required":["status","run"],"additionalProperties":false},"PolicyApprovalRouteRecipient":{"type":"object","properties":{"kind":{"type":"string","enum":["principal","email","slack_channel","webhook"]},"value":{"type":"string"},"label":{"type":"string"}},"required":["kind","value"],"additionalProperties":false},"PolicyApprovalRouteSummary":{"type":"object","properties":{"principal_id":{"type":"string"},"route_id":{"type":"string"},"title":{"type":"string"},"summary":{"type":"string"},"recipients":{"type":"array","items":{"$ref":"#/components/schemas/PolicyApprovalRouteRecipient"}},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}},"required":["principal_id","route_id","recipients","created_at","updated_at"],"additionalProperties":false},"ApprovalRouteSnapshot":{"type":"object","properties":{"route_id":{"type":"string"},"missing":{"type":"boolean"},"title":{"type":"string"},"summary":{"type":"string"},"recipients":{"type":"array","items":{"$ref":"#/components/schemas/PolicyApprovalRouteRecipient"}}},"required":["route_id","recipients"],"additionalProperties":false},"PutApprovalRouteRequest":{"type":"object","properties":{"title":{"type":"string"},"summary":{"type":"string"},"recipients":{"type":"array","items":{"$ref":"#/components/schemas/PolicyApprovalRouteRecipient"}}},"required":["recipients"],"additionalProperties":false},"ApprovalRouteEnvelope":{"type":"object","properties":{"status":{"type":"string","const":"success"},"route":{"$ref":"#/components/schemas/PolicyApprovalRouteSummary"}},"required":["status","route"],"additionalProperties":false},"ApprovalRouteListEnvelope":{"type":"object","properties":{"status":{"type":"string","const":"success"},"routes":{"type":"array","items":{"$ref":"#/components/schemas/PolicyApprovalRouteSummary"}}},"required":["status","routes"],"additionalProperties":false},"PolicyBundleRoutingRule":{"type":"object","properties":{"id":{"type":"string"},"route_id":{"type":"string"},"skill":{"type":"string"},"gate_type":{"type":"string"},"gate_id":{"type":"string"}},"required":["id","route_id"],"additionalProperties":false},"PolicyBundleRouting":{"type":"object","properties":{"default_route_id":{"type":"string"},"rules":{"type":"array","items":{"$ref":"#/components/schemas/PolicyBundleRoutingRule"}}},"required":["rules"],"additionalProperties":false},"PolicyBundleWorkspacePolicy":{"type":"object","properties":{"strict_cli_tool_inline_code":{"type":"boolean"}},"additionalProperties":false},"PolicyBundleSummary":{"type":"object","properties":{"principal_id":{"type":"string"},"bundle_id":{"type":"string"},"version":{"type":"string"},"title":{"type":"string"},"summary":{"type":"string"},"workspace_policy":{"$ref":"#/components/schemas/PolicyBundleWorkspacePolicy"},"approval_routing":{"$ref":"#/components/schemas/PolicyBundleRouting"},"created_at":{"type":"string","format":"date-time"}},"required":["principal_id","bundle_id","version","workspace_policy","approval_routing","created_at"],"additionalProperties":false},"PutPolicyBundleRequest":{"type":"object","properties":{"title":{"type":"string"},"summary":{"type":"string"},"workspace_policy":{"$ref":"#/components/schemas/PolicyBundleWorkspacePolicy"},"approval_routing":{"$ref":"#/components/schemas/PolicyBundleRouting"}},"additionalProperties":false},"PolicyBundleEnvelope":{"type":"object","properties":{"status":{"type":"string","const":"success"},"bundle":{"$ref":"#/components/schemas/PolicyBundleSummary"}},"required":["status","bundle"],"additionalProperties":false},"PolicyBundleListEnvelope":{"type":"object","properties":{"status":{"type":"string","const":"success"},"bundles":{"type":"array","items":{"$ref":"#/components/schemas/PolicyBundleSummary"}}},"required":["status","bundles"],"additionalProperties":false},"PolicyAttachmentSummary":{"type":"object","properties":{"principal_id":{"type":"string"},"scope_kind":{"type":"string","enum":["workspace_default","skill"]},"scope_ref":{"type":"string"},"bundle_id":{"type":"string"},"bundle_version":{"type":"string"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}},"required":["principal_id","scope_kind","bundle_id","bundle_version","created_at","updated_at"],"additionalProperties":false},"PutPolicyAttachmentRequest":{"type":"object","properties":{"bundle_id":{"type":"string"},"bundle_version":{"type":"string"}},"required":["bundle_id","bundle_version"],"additionalProperties":false},"PolicyAttachmentEnvelope":{"type":"object","properties":{"status":{"type":"string","enum":["success","deleted"]},"attachment":{"$ref":"#/components/schemas/PolicyAttachmentSummary"}},"required":["status","attachment"],"additionalProperties":false},"PolicyAttachmentListEnvelope":{"type":"object","properties":{"status":{"type":"string","const":"success"},"attachments":{"type":"array","items":{"$ref":"#/components/schemas/PolicyAttachmentSummary"}}},"required":["status","attachments"],"additionalProperties":false},"HostedApprovalGate":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string"},"reason":{"type":"string"},"summary":{"type":"object","additionalProperties":true}},"required":["id","reason"],"additionalProperties":false},"ApprovalInboxItem":{"type":"object","properties":{"run_id":{"type":"string"},"principal_id":{"type":"string"},"skill":{"type":"string"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"policy_binding":{"type":"object","properties":{"bundle_id":{"type":"string"},"bundle_version":{"type":"string"},"scope_kind":{"type":"string","enum":["workspace_default","skill"]},"scope_ref":{"type":"string"}},"required":["bundle_id","bundle_version","scope_kind"],"additionalProperties":false},"request_id":{"type":"string"},"gate":{"$ref":"#/components/schemas/HostedApprovalGate"},"route":{"$ref":"#/components/schemas/ApprovalRouteSnapshot"},"matched_by":{"type":"object","properties":{"kind":{"type":"string","enum":["none","default","rule"]},"rule_id":{"type":"string"},"skill":{"type":"string"},"gate_type":{"type":"string"},"gate_id":{"type":"string"}},"required":["kind"],"additionalProperties":false}},"required":["run_id","principal_id","skill","created_at","updated_at","request_id","gate","matched_by"],"additionalProperties":false},"ApprovalInboxEnvelope":{"type":"object","properties":{"status":{"type":"string","const":"success"},"approvals":{"type":"array","items":{"$ref":"#/components/schemas/ApprovalInboxItem"}},"next_cursor":{"type":"string"}},"required":["status","approvals"],"additionalProperties":false},"ConnectTicketEnvelope":{"type":"object","properties":{"status":{"type":"string","const":"success"},"connect":{"type":"object","additionalProperties":true}},"required":["status","connect"],"additionalProperties":false},"CreateConnectTicketRequest":{"type":"object","properties":{"provider":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}},"scope_family":{"type":"string"},"authority_kind":{"type":"string","enum":["read_only","constructive","destructive"]},"target_repo":{"type":"string","pattern":"^[A-Za-z0-9_.-]+/[A-Za-z0-9_.-]+$"},"target_locator":{"type":"string"},"return_to":{"type":"string","format":"uri"}},"required":["provider","return_to"],"additionalProperties":false},"HostedProviderReference":{"type":"object","properties":{"provider_reference":{"type":"string"},"principal_id":{"type":"string"},"provider":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}},"status":{"type":"string","enum":["active","revoked"]},"created_at":{"type":"string","format":"date-time"}},"required":["provider_reference","principal_id","provider","scopes","status","created_at"],"additionalProperties":false},"ProviderReferenceListEnvelope":{"type":"object","properties":{"status":{"type":"string","const":"success"},"provider_references":{"type":"array","items":{"$ref":"#/components/schemas/HostedProviderReference"}}},"required":["status","provider_references"],"additionalProperties":false},"ProviderReferenceRevokedEnvelope":{"type":"object","properties":{"status":{"type":"string","const":"revoked"},"provider_reference":{"$ref":"#/components/schemas/HostedProviderReference"}},"required":["status","provider_reference"],"additionalProperties":false},"ConnectGrant":{"type":"object","properties":{"grant_id":{"type":"string"},"principal_id":{"type":"string"},"provider":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}},"scope_family":{"type":"string"},"authority_kind":{"type":"string","enum":["read_only","constructive","destructive"]},"target_repo":{"type":"string","pattern":"^[A-Za-z0-9_.-]+/[A-Za-z0-9_.-]+$"},"target_locator":{"type":"string"},"auth_mode":{"type":"string","enum":["oauth","byo"]},"material_kind":{"type":"string","enum":["provider_credential","byo_credential"]},"credential_material_bound":{"type":"boolean"},"verification_status":{"type":"string","enum":["pending","verified","failed"]},"verified_at":{"type":"string","format":"date-time"},"expires_at":{"type":"string","format":"date-time"},"grant_reference":{"type":"object","properties":{"grant_id":{"type":"string"},"scope_family":{"type":"string"},"authority_kind":{"type":"string","enum":["read_only","constructive","destructive"]},"target_repo":{"type":"string","pattern":"^[A-Za-z0-9_.-]+/[A-Za-z0-9_.-]+$"},"target_locator":{"type":"string"}},"required":["grant_id","scope_family","authority_kind"],"additionalProperties":false},"status":{"type":"string","enum":["active","revoked"]},"created_at":{"type":"string","format":"date-time"}},"required":["grant_id","principal_id","provider","scopes","auth_mode","material_kind","credential_material_bound","status","created_at"],"additionalProperties":false},"GrantListEnvelope":{"type":"object","properties":{"status":{"type":"string","const":"success"},"grants":{"type":"array","items":{"$ref":"#/components/schemas/ConnectGrant"}}},"required":["status","grants"],"additionalProperties":false},"GrantRevokedEnvelope":{"type":"object","properties":{"status":{"type":"string","const":"revoked"},"grant":{"$ref":"#/components/schemas/ConnectGrant"}},"required":["status","grant"],"additionalProperties":false},"ProviderOperationRequest":{"type":"object","properties":{"grant_id":{"type":"string","minLength":1,"maxLength":200},"operation":{"type":"string","pattern":"^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9]*)+$","maxLength":100},"target":{"type":"string","minLength":1,"maxLength":2000,"description":"Exact provider-neutral target locator bound into the operation readback evidence."},"scopes":{"type":"array","minItems":1,"items":{"type":"string","minLength":1},"description":"Optional exact Runx capability scopes already admitted by the runtime; Cloud checks supplied evidence against the driver descriptor and grant."},"input":{"type":"object","additionalProperties":true},"access":{"type":"string","enum":["read","mutate"],"description":"Optional caller assertion checked against the provider driver's authoritative operation descriptor before dispatch."}},"required":["grant_id","operation","target"],"additionalProperties":false},"ProviderOperationResultEnvelope":{"type":"object","properties":{"status":{"type":"string","const":"success"},"provider":{"type":"string"},"operation":{"type":"string"},"target":{"type":"string"},"access":{"type":"string","enum":["read","mutate"],"description":"Provider-driver access classification for the executed operation."},"result":{},"readback_ref":{"type":"string"},"operation_id":{"type":"string"},"idempotency_key":{"type":"string"}},"required":["status","provider","operation","target","access","result","readback_ref"],"additionalProperties":false},"CreateConnectSessionRequest":{"type":"object","properties":{"provider":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}},"scope_family":{"type":"string"},"authority_kind":{"type":"string","enum":["read_only","constructive","destructive"]},"target_repo":{"type":"string","pattern":"^[A-Za-z0-9_.-]+/[A-Za-z0-9_.-]+$"},"target_locator":{"type":"string"}},"required":["provider"],"additionalProperties":false},"ConnectSessionPendingEnvelope":{"type":"object","properties":{"status":{"type":"string","const":"oauth_required"},"session_id":{"type":"string"},"flow_id":{"type":"string"},"authorization_url":{"type":"string","format":"uri"},"poll_after_ms":{"type":"integer"},"expires_at":{"type":"string","format":"date-time"}},"required":["status","session_id","flow_id","authorization_url","poll_after_ms"],"additionalProperties":false},"ConnectSessionCompleteEnvelope":{"type":"object","properties":{"status":{"type":"string","enum":["created","unchanged"]},"session_id":{"type":"string"},"flow_id":{"type":"string"},"grant":{"$ref":"#/components/schemas/ConnectGrant"}},"required":["status","grant"],"additionalProperties":false},"ConnectSessionUnavailableEnvelope":{"type":"object","properties":{"status":{"type":"string","enum":["connect_unavailable","unsupported"]},"provider":{"type":"string"},"provider_status":{"type":"string","enum":["wired","byo-ready","catalog"]},"connect_mode":{"type":"string","enum":["oauth","byo","none"]},"reason":{"type":"string","enum":["directory_surface"]},"error":{"type":"string"}},"required":["status","provider","provider_status","connect_mode","error"],"additionalProperties":false},"ConnectSessionStatusEnvelope":{"oneOf":[{"type":"object","properties":{"status":{"type":"string","const":"pending"},"session_id":{"type":"string"},"flow_id":{"type":"string"},"poll_after_ms":{"type":"integer"}},"required":["status","session_id","flow_id","poll_after_ms"],"additionalProperties":false},{"type":"object","properties":{"status":{"type":"string","const":"failed"},"session_id":{"type":"string"},"flow_id":{"type":"string"},"error":{"type":"string"}},"required":["status","session_id","flow_id","error"],"additionalProperties":false},{"type":"object","properties":{"status":{"type":"string","const":"pending_verification"},"session_id":{"type":"string"},"flow_id":{"type":"string"},"provider":{"type":"string"},"credential_material_bound":{"type":"boolean"},"verified_at":{"type":"string","format":"date-time"}},"required":["status","session_id","flow_id","provider","credential_material_bound"],"additionalProperties":false},{"type":"object","properties":{"status":{"type":"string","enum":["created","unchanged"]},"session_id":{"type":"string"},"flow_id":{"type":"string"},"grant":{"$ref":"#/components/schemas/ConnectGrant"}},"required":["status","session_id","flow_id","grant"],"additionalProperties":false}]},"GenericEnvelope":{"type":"object","additionalProperties":true},"PublicSystemStatusEnvelope":{"type":"object","properties":{"overall":{"type":"string"},"checked_at":{"type":"string","format":"date-time"},"summary":{"type":"string"},"checks":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"label":{"type":"string"},"status":{"type":"string"},"detail":{"type":"string"}},"required":["id","label","status"],"additionalProperties":false}}},"required":["overall","checked_at","summary","checks"],"additionalProperties":false},"PublicIntegrationSummary":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"category":{"type":"string"},"status":{"type":"string","enum":["wired","byo-ready","catalog"]},"connect_mode":{"type":"string","enum":["oauth","byo","none"]},"source":{"type":"string","enum":["live","seeded"]},"listing_kind":{"type":"string","enum":["provider","orchestrator","developer-workflow","agent-registry"]},"auth_mode":{"type":"string"},"docs_url":{"type":"string","format":"uri"},"brand_color":{"type":"string","pattern":"^#[A-Fa-f0-9]{6}$"},"logo_url":{"type":"string","format":"uri"},"featured_rank":{"type":"integer"},"auth_methods":{"type":"array","items":{"type":"string"}},"connect_tiers":{"type":"array","items":{"type":"string","enum":["byo","connect"]}},"variants":{"type":"array","items":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"},"auth_mode":{"type":"string"}},"required":["slug","name"],"additionalProperties":false}}},"required":["slug","name","description","category","status","connect_mode","source"],"additionalProperties":false},"PublicIntegrationListEnvelope":{"type":"object","properties":{"status":{"type":"string","const":"success"},"as_of":{"type":"string","format":"date-time"},"source":{"type":"string","enum":["live","seeded"]},"total":{"type":"integer"},"integrations":{"type":"array","items":{"$ref":"#/components/schemas/PublicIntegrationSummary"}}},"required":["status","as_of","source","total","integrations"],"additionalProperties":false},"PublicIntegrationEnvelope":{"type":"object","properties":{"status":{"type":"string","const":"success"},"as_of":{"type":"string","format":"date-time"},"source":{"type":"string","enum":["live","seeded"]},"integration":{"$ref":"#/components/schemas/PublicIntegrationSummary"}},"required":["status","as_of","source","integration"],"additionalProperties":false},"PublicIntegrationDemandRequest":{"type":"object","properties":{"client_id":{"type":"string","minLength":8,"maxLength":128}},"required":["client_id"],"additionalProperties":false},"PublicIntegrationDemandEnvelope":{"type":"object","properties":{"status":{"type":"string","const":"success"},"demand":{"type":"object","properties":{"provider":{"type":"string"},"request_count":{"type":"integer","minimum":1},"status":{"type":"string","enum":["open","closed"]},"first_requested_at":{"type":"string","format":"date-time"},"last_requested_at":{"type":"string","format":"date-time"}},"required":["provider","request_count","status","first_requested_at","last_requested_at"],"additionalProperties":false}},"required":["status","demand"],"additionalProperties":false},"PublicFeedItem":{"type":"object","properties":{"id":{"type":"string"},"source":{"type":"string"},"status":{"type":"string","enum":["success","failure","pending","running","waiting","cancelled"]},"title":{"type":"string"},"target":{"type":"string"},"timestamp":{"type":"string","format":"date-time"},"summary":{"type":"string"},"repo":{"type":"string"},"workflow":{"type":"string"},"branch":{"type":"string"},"commit":{"type":"string"},"run_id":{"type":"string"},"receipt_id":{"type":"string"},"skill_id":{"type":"string"},"actions_count":{"type":"integer"},"url":{"type":"string","format":"uri"},"metadata":{"type":"object","additionalProperties":true}},"required":["id","source","status","title","target","timestamp"],"additionalProperties":false},"PublicFeedEnvelope":{"type":"object","properties":{"status":{"type":"string","const":"success"},"as_of":{"type":"string","format":"date-time"},"feed":{"type":"array","items":{"$ref":"#/components/schemas/PublicFeedItem"}}},"required":["status","as_of","feed"],"additionalProperties":false},"PublicReceiptProjection":{"type":"object","properties":{"seq":{"type":"integer","minimum":1},"event":{"type":"string","enum":["published","unpublished"]},"digest":{"type":"string"},"public_hash":{"type":"string"},"receipt_id":{"type":"string"},"kid":{"type":"string"},"schema":{"type":"string"},"subject_kind":{"type":"string"},"seal":{"type":"object","additionalProperties":true},"lineage_refs":{"type":"array","items":{"type":"string"}},"tombstone_reason":{"type":"string"},"published_at":{"type":"string","format":"date-time"}},"required":["seq","event","digest","public_hash","lineage_refs","published_at"],"additionalProperties":false},"PublicReceiptProjectionFeedEnvelope":{"type":"object","properties":{"status":{"type":"string","const":"success"},"cursor":{"type":"integer","minimum":0},"next_cursor":{"type":"integer","minimum":1},"receipts":{"type":"array","items":{"$ref":"#/components/schemas/PublicReceiptProjection"}}},"required":["status","cursor","receipts"],"additionalProperties":false},"TrustRootKey":{"type":"object","properties":{"kty":{"type":"string","const":"OKP"},"crv":{"type":"string","const":"Ed25519"},"alg":{"type":"string","const":"EdDSA"},"use":{"type":"string","const":"sig"},"kid":{"type":"string"},"purpose":{"type":"string","enum":["receipt_signature","payment_admission"]},"issuer_type":{"type":"string"},"x":{"type":"string"},"public_key_sha256":{"type":"string"}},"required":["kty","crv","alg","use","kid","purpose","x","public_key_sha256"],"additionalProperties":false},"TrustRootDocument":{"type":"object","properties":{"schema":{"type":"string","const":"runx.trust_root.v1"},"keys":{"type":"array","items":{"$ref":"#/components/schemas/TrustRootKey"}}},"required":["schema","keys"],"additionalProperties":false},"PublicReceiptNotarizationEnvelope":{"type":"object","properties":{"status":{"type":"string","const":"success"},"receipt":{"$ref":"#/components/schemas/PublicReceiptNotarization"}},"required":["status","receipt"],"additionalProperties":false},"PublicReceiptTrustRungDetail":{"type":"object","properties":{"passed":{"type":"boolean"},"evaluable":{"type":"boolean"},"summary":{"type":"string"}},"required":["passed","evaluable","summary"],"additionalProperties":false},"PublicReceiptTrust":{"type":"object","properties":{"trust_rung":{"type":"integer","enum":[0,1,2,3,4]},"label":{"type":"string"},"claim":{"type":"string"},"not_proved":{"type":"array","items":{"type":"string"}},"next":{"type":"object","properties":{"label":{"type":"string"},"href":{"type":"string"}},"required":["label","href"],"additionalProperties":false},"rungs":{"type":"object","properties":{"l0":{"$ref":"#/components/schemas/PublicReceiptTrustRungDetail"},"l1":{"$ref":"#/components/schemas/PublicReceiptTrustRungDetail"},"l2":{"$ref":"#/components/schemas/PublicReceiptTrustRungDetail"},"l3":{"$ref":"#/components/schemas/PublicReceiptTrustRungDetail"},"l4":{"$ref":"#/components/schemas/PublicReceiptTrustRungDetail"}},"required":["l0","l1","l2","l3","l4"],"additionalProperties":false}},"required":["trust_rung","label","claim","not_proved","next","rungs"],"additionalProperties":false},"PublicReceiptNotarization":{"type":"object","properties":{"notarization_status":{"type":"string","const":"notarized"},"digest":{"type":"string"},"public_hash":{"type":"string"},"mode":{"type":"string","enum":["full","hash_only"]},"receipt_id":{"type":"string"},"verified_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"binary_version":{"type":"string"},"edge_key":{"type":"object","properties":{"identity_status":{"type":"string","enum":["unclaimed","claimed","claimed_later_disavowed","disavowed"]},"type":{"type":"string"},"kid":{"type":"string"},"public_key_sha256":{"type":"string"}},"required":["identity_status"],"additionalProperties":false},"verdict":{"type":"object","properties":{"valid":{"type":"boolean"},"signature_mode":{"type":"string"},"signature_status":{"type":"string"},"signature_kid":{"type":"string"},"digest_status":{"type":"string"},"content_address_status":{"type":"string"},"lineage_status":{"type":"string"},"findings_count":{"type":"integer"},"finding_codes":{"type":"array","items":{"type":"string"}}},"required":["findings_count","finding_codes"],"additionalProperties":false},"subject":{"type":"object","properties":{"kind":{"type":"string"},"ref_type":{"type":"string"}},"additionalProperties":false},"public_claim":{"type":"object","required":["kind","title","venue","occurred_at"],"properties":{"kind":{"type":"string","enum":["payout","funding","judgment","profile_update","delivery","signup"]},"title":{"type":"string"},"venue":{"type":"object","required":["id"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"url":{"type":"string","format":"uri"}},"additionalProperties":false},"subject":{"type":"object","required":["type","id"],"properties":{"type":{"type":"string"},"id":{"type":"string"},"label":{"type":"string"}},"additionalProperties":false},"amount":{"type":"object","required":["cents","currency"],"properties":{"cents":{"type":"integer"},"currency":{"type":"string"}},"additionalProperties":false},"source_url":{"type":"string","format":"uri"},"occurred_at":{"type":"string","format":"date-time"}},"additionalProperties":false},"hash_only_notice":{"type":"string"},"trust_rung":{"type":"integer","enum":[0,1,2,3,4]},"trust":{"$ref":"#/components/schemas/PublicReceiptTrust"},"verify_command":{"type":"string"},"claims":{"type":"array","items":{"type":"string"}},"limitations":{"type":"array","items":{"type":"string"}}},"required":["notarization_status","digest","public_hash","mode","verified_at","updated_at","binary_version","edge_key","verdict","trust_rung","trust","verify_command","claims","limitations"],"additionalProperties":false},"PublicSkillSummary":{"type":"object","properties":{"skill_id":{"type":"string"},"owner":{"type":"string"},"owner_handle":{"type":"string"},"trust_tier":{"type":"string","enum":["first_party","verified","community"]},"name":{"type":"string"},"description":{"type":"string"},"catalog_kind":{"type":"string","enum":["skill","graph"]},"version":{"type":"string"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"source_type":{"type":"string"},"profile_mode":{"type":"string","enum":["profiled","portable"]},"runner_names":{"type":"array","items":{"type":"string"}},"required_scopes":{"type":"array","items":{"type":"string"}},"tags":{"type":"array","items":{"type":"string"}},"category":{"type":"string"},"category_label":{"type":"string"},"trust_signals":{"type":"array","items":{"$ref":"#/components/schemas/PublicTrustSignal"}},"install_count":{"type":"integer"},"verified_run_count":{"type":"integer"},"last_verified_run_at":{"type":"string","format":"date-time"},"page_url":{"type":"string","format":"uri"},"install_command":{"type":"string"},"run_command":{"type":"string"},"latest_receipt":{"$ref":"#/components/schemas/PublicLatestReceipt"}},"required":["skill_id","owner","owner_handle","trust_tier","name","catalog_kind","version","created_at","updated_at","source_type","profile_mode","runner_names","required_scopes","tags","category","category_label","trust_signals","install_count","verified_run_count","page_url","install_command","run_command"],"additionalProperties":false},"PublicTrustSignal":{"type":"object","properties":{"id":{"type":"string"},"label":{"type":"string"},"status":{"type":"string","enum":["verified","declared","not_declared","placeholder"]},"value":{"type":"string"}},"required":["id","label","status","value"],"additionalProperties":false},"PublicPublisher":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["organization","user","team","service","publisher"]},"handle":{"type":"string"},"display_name":{"type":"string"}},"required":["id","kind"],"additionalProperties":false},"PublicAttestation":{"type":"object","properties":{"kind":{"type":"string","enum":["source","publisher","verification"]},"id":{"type":"string"},"status":{"type":"string","enum":["verified","declared"]},"summary":{"type":"string"},"source":{"type":"string","format":"uri"},"issued_at":{"type":"string","format":"date-time"},"metadata":{"type":"object","additionalProperties":true}},"required":["kind","id","status","summary"],"additionalProperties":false},"PublicLatestReceipt":{"type":"object","properties":{"receipt_id":{"type":"string"},"run_id":{"type":"string"},"created_at":{"type":"string","format":"date-time"},"status":{"type":"string"}},"required":["receipt_id","created_at","status"],"additionalProperties":false},"PublicFacetCount":{"type":"object","properties":{"value":{"type":"string"},"count":{"type":"integer"}},"required":["value","count"],"additionalProperties":false},"PublicSkillListQuery":{"type":"object","properties":{"q":{"type":"string"},"owner":{"type":"string"},"tag":{"type":"string"},"kind":{"type":"string","enum":["skill","graph"]},"category":{"type":"string"},"source_type":{"type":"string"},"profile_mode":{"type":"string","enum":["profiled","portable"]},"sort":{"type":"string","enum":["newest","a-z","most-installed"]},"include":{"type":"string","enum":["unverified"]},"trust_tier":{"type":"string","enum":["first_party","verified","community"]},"limit":{"type":"integer","minimum":1,"maximum":100}},"required":["q","sort","limit"],"additionalProperties":false},"PublicSkillFacets":{"type":"object","properties":{"owners":{"type":"array","items":{"$ref":"#/components/schemas/PublicFacetCount"}},"tags":{"type":"array","items":{"$ref":"#/components/schemas/PublicFacetCount"}},"kinds":{"type":"array","items":{"$ref":"#/components/schemas/PublicFacetCount"}},"categories":{"type":"array","items":{"$ref":"#/components/schemas/PublicCategoryFacetCount"}},"source_types":{"type":"array","items":{"$ref":"#/components/schemas/PublicFacetCount"}},"profile_modes":{"type":"array","items":{"$ref":"#/components/schemas/PublicFacetCount"}}},"required":["owners","tags","kinds","categories","source_types","profile_modes"],"additionalProperties":false},"PublicCategoryFacetCount":{"type":"object","properties":{"value":{"type":"string"},"label":{"type":"string"},"count":{"type":"integer"}},"required":["value","label","count"],"additionalProperties":false},"PublicOwnerProfileLink":{"type":"object","properties":{"label":{"type":"string"},"url":{"type":"string","format":"uri"}},"required":["label","url"],"additionalProperties":false},"PublicOwnerProfile":{"type":"object","properties":{"owner":{"type":"string"},"handle":{"type":"string"},"display_name":{"type":"string"},"description":{"type":"string"},"website_url":{"type":"string","format":"uri"},"github_url":{"type":"string","format":"uri"},"kind":{"type":"string","enum":["org","user","team"]},"verified":{"type":"boolean"},"links":{"type":"array","items":{"$ref":"#/components/schemas/PublicOwnerProfileLink"}},"skill_count":{"type":"integer"},"install_count":{"type":"integer"},"categories":{"type":"array","items":{"$ref":"#/components/schemas/PublicCategoryFacetCount"}},"updated_at":{"type":"string","format":"date-time"}},"required":["owner","handle","display_name","description","kind","verified","links","skill_count","install_count","categories"],"additionalProperties":false},"PublicOwnerProfileEnvelope":{"type":"object","properties":{"status":{"type":"string","const":"success"},"owner":{"$ref":"#/components/schemas/PublicOwnerProfile"},"profile":{"$ref":"#/components/schemas/PublicOwnerProfile"}},"required":["status"],"additionalProperties":false},"PublicSkillListEnvelope":{"type":"object","properties":{"status":{"type":"string","const":"success"},"query":{"$ref":"#/components/schemas/PublicSkillListQuery"},"total":{"type":"integer"},"facets":{"$ref":"#/components/schemas/PublicSkillFacets"},"skills":{"type":"array","items":{"$ref":"#/components/schemas/PublicSkillSummary"}}},"required":["status","query","total","facets","skills"],"additionalProperties":false},"HostedSkillPublishRequest":{"type":"object","properties":{"markdown":{"type":"string","description":"Complete SKILL.md document, including frontmatter."},"profile_document":{"type":"string","description":"Optional X.yaml profile document published with the skill."},"version":{"type":"string","description":"Optional version or content ref. If omitted, the registry derives one from content."},"package_files":{"type":"array","description":"Optional UTF-8 skill package files persisted with the registry version and used by hosted publish admission to rerun the package harness. Allowed paths are root JS runners referenced by X.yaml, nested SKILL.md/X.yaml packages, references markdown, and tool manifests/minimal runtimes.","maxItems":500,"items":{"$ref":"#/components/schemas/HostedSkillPackageFile"}}},"required":["markdown"],"additionalProperties":false},"HostedSkillPackageFile":{"type":"object","properties":{"path":{"type":"string","description":"Relative allowlisted package path. Root SKILL.md and X.yaml use their dedicated fields."},"content":{"type":"string","description":"UTF-8 file content."}},"required":["path","content"],"additionalProperties":false},"HostedSkillPublishResult":{"type":"object","properties":{"status":{"type":"string","enum":["published","unchanged"]},"skill_id":{"type":"string"},"owner":{"type":"string"},"name":{"type":"string"},"version":{"type":"string"},"digest":{"type":"string"},"profile_digest":{"type":"string"},"trust_tier":{"type":"string","const":"community"},"maturity":{"type":"string","enum":["alpha","beta","stable"]},"install_command":{"type":"string"},"run_command":{"type":"string"},"public_url":{"type":"string","format":"uri"},"harness":{"$ref":"#/components/schemas/HarnessPublishSummary"}},"required":["status","skill_id","owner","name","version","digest","trust_tier","maturity","install_command","run_command","public_url"],"additionalProperties":false},"HostedSkillPublishEnvelope":{"type":"object","properties":{"status":{"type":"string","const":"success"},"publish":{"$ref":"#/components/schemas/HostedSkillPublishResult"}},"required":["status","publish"],"additionalProperties":false},"HostedSkillReportRequest":{"type":"object","properties":{"version":{"type":"string","description":"Optional skill version to report. If omitted, the latest public version is reported."},"reason":{"type":"string","enum":["spam","malware","unsafe_authority","misleading","rights","other"]},"detail":{"type":"string","maxLength":2000,"description":"Optional reporter detail. Stored for moderation review, never used as trust evidence."}},"required":["reason"],"additionalProperties":false},"HostedSkillReportResult":{"type":"object","properties":{"status":{"type":"string","enum":["recorded","already_recorded"]},"id":{"type":"string"},"skill_id":{"type":"string"},"version":{"type":"string"},"reason":{"type":"string","enum":["spam","malware","unsafe_authority","misleading","rights","other"]},"created_at":{"type":"string","format":"date-time"}},"required":["status","id","skill_id","version","reason","created_at"],"additionalProperties":false},"HostedSkillReportEnvelope":{"type":"object","properties":{"status":{"type":"string","const":"success"},"report":{"$ref":"#/components/schemas/HostedSkillReportResult"}},"required":["status","report"],"additionalProperties":false},"PublicToolSearchResult":{"type":"object","properties":{"tool_id":{"type":"string"},"name":{"type":"string"},"summary":{"type":"string"},"source":{"type":"string"},"source_label":{"type":"string"},"source_type":{"type":"string"},"namespace":{"type":"string"},"external_name":{"type":"string"},"required_scopes":{"type":"array","items":{"type":"string"}},"tags":{"type":"array","items":{"type":"string"}},"catalog_ref":{"type":"string"}},"required":["tool_id","name","source","source_label","source_type","namespace","external_name","required_scopes","tags","catalog_ref"],"additionalProperties":false},"PublicToolListQuery":{"type":"object","properties":{"q":{"type":"string"},"source":{"type":"string"},"limit":{"type":"integer","minimum":1,"maximum":100}},"required":["q","source","limit"],"additionalProperties":false},"PublicToolListEnvelope":{"type":"object","properties":{"status":{"type":"string","const":"success"},"query":{"$ref":"#/components/schemas/PublicToolListQuery"},"total":{"type":"integer"},"tools":{"type":"array","items":{"$ref":"#/components/schemas/PublicToolSearchResult"}}},"required":["status","query","total","tools"],"additionalProperties":false},"PublicToolInput":{"type":"object","properties":{"type":{"type":"string"},"required":{"type":"boolean"},"description":{"type":"string"}},"required":["type","required"],"additionalProperties":true},"PublicToolInspectProvenance":{"type":"object","properties":{"origin":{"type":"string","enum":["local","imported"]},"source":{"type":"string"},"source_label":{"type":"string"},"source_type":{"type":"string"},"namespace":{"type":"string"},"external_name":{"type":"string"},"catalog_ref":{"type":"string"},"tool_id":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}}},"required":["origin"],"additionalProperties":false},"PublicToolDetail":{"type":"object","properties":{"ref":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"execution_source_type":{"type":"string"},"inputs":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/PublicToolInput"}},"scopes":{"type":"array","items":{"type":"string"}},"mutating":{"type":"boolean"},"runtime":{"type":"object","additionalProperties":true},"risk":{"type":"object","additionalProperties":true},"runx":{"type":"object","additionalProperties":true},"reference_path":{"type":"string"},"skill_directory":{"type":"string"},"provenance":{"$ref":"#/components/schemas/PublicToolInspectProvenance"}},"required":["ref","name","execution_source_type","inputs","scopes","reference_path","skill_directory","provenance"],"additionalProperties":false},"PublicToolDetailEnvelope":{"type":"object","properties":{"status":{"type":"string","const":"success"},"tool":{"$ref":"#/components/schemas/PublicToolDetail"}},"required":["status","tool"],"additionalProperties":false},"PublicEvidenceEvent":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string","description":"Publisher-defined evidence kind. Reserved runtime values include runx_run and harness_run."},"source":{"type":"string"},"status":{"type":"string","enum":["success","failure","pending","running","waiting","cancelled"]},"title":{"type":"string"},"timestamp":{"type":"string","format":"date-time"},"summary":{"type":"string"},"repo":{"type":"string"},"workflow":{"type":"string"},"branch":{"type":"string"},"commit":{"type":"string"},"skill_id":{"type":"string"},"run_id":{"type":"string"},"receipt_id":{"type":"string"},"url":{"type":"string","format":"uri"},"metadata":{"type":"object","additionalProperties":true}},"required":["id","kind","source","status","title","timestamp"],"additionalProperties":false},"PublicHarnessDeclaredCase":{"type":"object","properties":{"name":{"type":"string"},"runner":{"type":"string"},"expected_status":{"type":"string","enum":["sealed","failure","needs_agent","policy_denied","escalated"]}},"required":["name"],"additionalProperties":false},"PublicHarnessSummary":{"type":"object","properties":{"status":{"type":"string","enum":["passed","failed","not_recorded"]},"declared_case_count":{"type":"integer"},"declared_cases":{"type":"array","items":{"$ref":"#/components/schemas/PublicHarnessDeclaredCase"}},"case_count":{"type":"integer"},"checks_passed":{"type":"integer"},"checks_failed":{"type":"integer"},"receipt_ids":{"type":"array","items":{"type":"string"}},"evidence_url":{"type":"string","format":"uri"},"latest_run":{"$ref":"#/components/schemas/PublicEvidenceEvent"},"recent_runs":{"type":"array","items":{"$ref":"#/components/schemas/PublicEvidenceEvent"}}},"required":["status","declared_case_count","declared_cases","case_count","receipt_ids","recent_runs"],"additionalProperties":false},"PublicSkillDetail":{"type":"object","properties":{"skill_id":{"type":"string"},"owner":{"type":"string"},"owner_handle":{"type":"string"},"trust_tier":{"type":"string","enum":["first_party","verified","community"]},"name":{"type":"string"},"description":{"type":"string"},"catalog_kind":{"type":"string","enum":["skill","graph"]},"version":{"type":"string"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"source_type":{"type":"string"},"profile_mode":{"type":"string","enum":["profiled","portable"]},"runner_names":{"type":"array","items":{"type":"string"}},"required_scopes":{"type":"array","items":{"type":"string"}},"tags":{"type":"array","items":{"type":"string"}},"category":{"type":"string"},"category_label":{"type":"string"},"trust_signals":{"type":"array","items":{"$ref":"#/components/schemas/PublicTrustSignal"}},"install_count":{"type":"integer"},"page_url":{"type":"string","format":"uri"},"install_command":{"type":"string"},"run_command":{"type":"string"},"latest_receipt":{"$ref":"#/components/schemas/PublicLatestReceipt"},"publisher":{"$ref":"#/components/schemas/PublicPublisher"},"attestations":{"type":"array","items":{"$ref":"#/components/schemas/PublicAttestation"}},"digest":{"type":"string"},"profile_digest":{"type":"string"},"markdown":{"type":"string"},"harness":{"$ref":"#/components/schemas/PublicHarnessSummary"},"recent_activity":{"type":"array","items":{"$ref":"#/components/schemas/PublicFeedItem"}},"source":{"$ref":"#/components/schemas/PublicSkillSource"}},"required":["skill_id","owner","owner_handle","trust_tier","name","catalog_kind","version","created_at","updated_at","source_type","profile_mode","runner_names","required_scopes","tags","category","category_label","trust_signals","install_count","page_url","install_command","run_command","publisher","attestations","digest","markdown","harness","recent_activity"],"additionalProperties":false},"PublicSkillDetailEnvelope":{"type":"object","properties":{"status":{"type":"string","const":"success"},"skill":{"$ref":"#/components/schemas/PublicSkillDetail"}},"required":["status","skill"],"additionalProperties":false},"PublicSkillSource":{"type":"object","properties":{"provider":{"type":"string","const":"github"},"repo":{"type":"string"},"repo_url":{"type":"string","format":"uri"},"skill_path":{"type":"string"},"profile_path":{"type":"string"},"ref":{"type":"string"},"sha":{"type":"string"},"event":{"type":"string","enum":["enrollment","push","tag","tombstone"]},"immutable":{"type":"boolean"},"live":{"type":"boolean"},"tombstoned":{"type":"boolean"},"tag":{"type":"string"},"publisher_handle":{"type":"string"}},"required":["provider","repo","repo_url","skill_path","ref","sha","event","immutable","live"],"additionalProperties":false},"AcquireSkillRequest":{"type":"object","properties":{"installation_id":{"type":"string"},"version":{"type":"string"},"channel":{"type":"string"}},"required":["installation_id"],"additionalProperties":false},"AcquireSkillResponse":{"type":"object","properties":{"status":{"type":"string","const":"success"},"install_count":{"type":"integer"},"acquisition":{"type":"object","properties":{"skill_id":{"type":"string"},"owner":{"type":"string"},"name":{"type":"string"},"version":{"type":"string"},"digest":{"type":"string"},"signed_manifest":{"$ref":"#/components/schemas/RegistrySignedManifest"},"markdown":{"type":"string"},"profile_document":{"type":"string"},"profile_digest":{"type":"string"},"package_files":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"content":{"type":"string"}},"required":["path","content"],"additionalProperties":false}},"package_digest":{"type":"string"},"trust_tier":{"type":"string","enum":["first_party","verified","community"]},"publisher":{"$ref":"#/components/schemas/PublicPublisher"},"source_metadata":{"$ref":"#/components/schemas/PublicSkillSource"},"attestations":{"type":"array","items":{"$ref":"#/components/schemas/PublicAttestation"}},"runner_names":{"type":"array","items":{"type":"string"}}},"required":["skill_id","owner","name","version","digest","markdown","trust_tier","publisher","attestations","runner_names"],"additionalProperties":false}},"required":["status","install_count","acquisition"],"additionalProperties":false},"RegistrySignedManifest":{"type":"object","properties":{"schema":{"type":"string","const":"runx.registry.signed_manifest.v1"},"skill_id":{"type":"string"},"version":{"type":"string"},"digest":{"type":"string"},"profile_digest":{"type":"string"},"package_digest":{"type":"string"},"signer":{"type":"object","properties":{"id":{"type":"string"},"key_id":{"type":"string"}},"required":["id","key_id"],"additionalProperties":false},"signature":{"type":"object","properties":{"alg":{"type":"string","const":"ed25519"},"value":{"type":"string"}},"required":["alg","value"],"additionalProperties":false}},"required":["schema","skill_id","version","digest","signer","signature"],"additionalProperties":false},"SelfPublishRepositorySummary":{"type":"object","properties":{"full_name":{"type":"string"},"owner":{"type":"string"},"repo":{"type":"string"},"default_branch":{"type":"string"},"description":{"type":"string"},"skill_name":{"type":"string"},"has_skill_markdown":{"type":"boolean"},"has_root_profile":{"type":"boolean"},"has_fallback_profile":{"type":"boolean"}},"required":["full_name","owner","repo","default_branch","has_skill_markdown","has_root_profile","has_fallback_profile"],"additionalProperties":false},"SelfPublishEnrollment":{"type":"object","properties":{"handle":{"type":"string"},"repo_full_name":{"type":"string"},"owner":{"type":"string"},"repo":{"type":"string"},"default_branch":{"type":"string"},"skill_name":{"type":"string"},"status":{"type":"string","enum":["indexed","sync_disabled","tombstoned"]},"source_url":{"type":"string","format":"uri"},"page_url":{"type":"string","format":"uri"},"indexed_skill_id":{"type":"string"},"active_version":{"type":"string"},"active_ref":{"type":"string"},"source_sha":{"type":"string"},"profile_path":{"type":"string"},"published_versions":{"type":"array","items":{"type":"string"}},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"last_indexed_at":{"type":"string","format":"date-time"},"sync_disabled_at":{"type":"string","format":"date-time"},"sync_disabled_reason":{"type":"string"},"tombstoned_at":{"type":"string","format":"date-time"}},"required":["handle","repo_full_name","owner","repo","default_branch","status","source_url","published_versions","created_at","updated_at"],"additionalProperties":false},"SelfPublishRepoListEnvelope":{"type":"object","properties":{"status":{"type":"string","const":"success"},"repos":{"type":"array","items":{"$ref":"#/components/schemas/SelfPublishRepositorySummary"}}},"required":["status","repos"],"additionalProperties":false},"SelfPublishEnrollmentEnvelope":{"type":"object","properties":{"status":{"type":"string","const":"success"},"enrollment":{"$ref":"#/components/schemas/SelfPublishEnrollment"}},"required":["status","enrollment"],"additionalProperties":false},"WebhookAcceptedEnvelope":{"type":"object","properties":{"status":{"type":"string","const":"accepted"},"updated":{"type":"integer"}},"required":["status","updated"],"additionalProperties":false},"IndexRequest":{"type":"object","properties":{"repo_url":{"type":"string"},"ref":{"type":"string"}},"required":["repo_url"],"additionalProperties":false},"IndexedListing":{"type":"object","properties":{"owner":{"type":"string"},"name":{"type":"string"},"skill_id":{"type":"string"},"version":{"type":"string"},"permalink":{"type":"string","format":"uri"},"trust_tier":{"type":"string","enum":["first_party","verified","community"]},"skill_path":{"type":"string"},"digest_unchanged":{"type":"boolean"}},"required":["owner","name","skill_id","version","permalink","trust_tier","skill_path","digest_unchanged"],"additionalProperties":false},"IndexWarning":{"type":"object","properties":{"skill_path":{"type":"string"},"code":{"type":"string","enum":["skill_md_invalid","skill_md_skipped","profile_missing"]},"detail":{"type":"string"}},"required":["code","detail"],"additionalProperties":false},"IndexResultEnvelope":{"type":"object","properties":{"status":{"type":"string","const":"success"},"listings":{"type":"array","items":{"$ref":"#/components/schemas/IndexedListing"}},"warnings":{"type":"array","items":{"$ref":"#/components/schemas/IndexWarning"}},"repo":{"type":"object","properties":{"owner":{"type":"string"},"repo":{"type":"string"},"ref":{"type":"string"},"sha":{"type":"string"}},"required":["owner","repo","ref","sha"],"additionalProperties":false}},"required":["status","listings","warnings","repo"],"additionalProperties":false},"IndexErrorEnvelope":{"type":"object","properties":{"status":{"type":"string","const":"error"},"error":{"type":"object","properties":{"code":{"type":"string","enum":["handle_mismatch","skill_md_invalid","name_taken_by_repo","repo_unreachable","rate_limited","repo_url_invalid","no_skills_found","claim_request_invalid","claim_not_configured","claim_not_found","claim_unclaimable","claim_state_mismatch","claim_installation_missing","claim_installation_wrong_repo","claim_internal_error"]},"detail":{"type":"string"},"hint":{"type":"string"},"retry_after_seconds":{"type":"integer"}},"required":["code","detail"],"additionalProperties":false}},"required":["status","error"],"additionalProperties":false},"IndexStatusEnvelope":{"type":"object","properties":{"status":{"type":"string","const":"success"},"skill_id":{"type":"string"},"trust_tier":{"type":"string","enum":["first_party","verified","community"]},"latest_version":{"type":"string"},"latest_digest":{"type":"string"}},"required":["status","skill_id","trust_tier","latest_version","latest_digest"],"additionalProperties":false},"ClaimSessionRequest":{"type":"object","properties":{"owner":{"type":"string"},"name":{"type":"string"}},"required":["owner","name"],"additionalProperties":false},"ClaimSessionEnvelope":{"type":"object","properties":{"status":{"type":"string","const":"success"},"request_id":{"type":"string"},"connect_session_token":{"type":"string"},"authorization_url":{"type":"string","format":"uri"},"expires_at":{"type":"string","format":"date-time"}},"required":["status","request_id","connect_session_token","expires_at"],"additionalProperties":false},"ClaimSessionStatusEnvelope":{"type":"object","properties":{"status":{"type":"string","const":"success"},"request_id":{"type":"string"},"request_status":{"type":"string","enum":["pending_connection","verified","rejected","expired","error"]},"github_user":{"type":"string"},"github_permission":{"type":"string"},"claim_reason":{"type":"string"},"listing_promoted":{"type":"boolean"}},"required":["status","request_id","request_status","listing_promoted"],"additionalProperties":false},"GitHubAppClaimListingTarget":{"type":"object","properties":{"owner":{"type":"string"},"name":{"type":"string"},"skill_id":{"type":"string"},"repo_full_name":{"type":"string"}},"required":["owner","name","skill_id","repo_full_name"],"additionalProperties":false},"GitHubAppClaimSessionRequest":{"type":"object","properties":{"repo_url":{"type":"string"},"owner":{"type":"string"},"name":{"type":"string"}},"required":["repo_url"],"additionalProperties":false},"GitHubAppClaimFinalizeRequest":{"type":"object","properties":{"state":{"type":"string"},"installation_id":{"oneOf":[{"type":"string"},{"type":"integer"}]},"setup_action":{"type":"string"}},"required":["state"],"additionalProperties":false},"GitHubAppClaimSessionEnvelope":{"type":"object","properties":{"status":{"type":"string","const":"success"},"request_id":{"type":"string"},"request_status":{"type":"string","enum":["pending_installation","verified","rejected","expired","error"]},"state":{"type":"string"},"install_url":{"type":"string","format":"uri"},"expires_at":{"type":"string","format":"date-time"},"listing":{"$ref":"#/components/schemas/GitHubAppClaimListingTarget"},"github_app_installation_id":{"type":"string"},"github_app_account_login":{"type":"string"},"github_app_account_type":{"type":"string"},"claim_reason":{"type":"string"},"listing_promoted":{"type":"boolean"}},"required":["status","request_id","request_status","state","listing","listing_promoted"],"additionalProperties":false},"GitHubAppClaimSessionStatusEnvelope":{"type":"object","properties":{"status":{"type":"string","const":"success"},"request_id":{"type":"string"},"request_status":{"type":"string","enum":["pending_installation","verified","rejected","expired","error"]},"install_url":{"type":"string","format":"uri"},"expires_at":{"type":"string","format":"date-time"},"listing":{"$ref":"#/components/schemas/GitHubAppClaimListingTarget"},"github_app_installation_id":{"type":"string"},"github_app_account_login":{"type":"string"},"github_app_account_type":{"type":"string"},"claim_reason":{"type":"string"},"listing_promoted":{"type":"boolean"}},"required":["status","request_id","request_status","listing","listing_promoted"],"additionalProperties":false},"GitHubAppWebhookRequest":{"type":"object","additionalProperties":true},"PublicHarnessEnvelope":{"type":"object","properties":{"status":{"type":"string","const":"success"},"skill_id":{"type":"string"},"harness":{"$ref":"#/components/schemas/PublicHarnessSummary"}},"required":["status","skill_id","harness"],"additionalProperties":false},"PublicEvidenceEventInput":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string","description":"Publisher-defined evidence kind. Reserved runtime values include runx_run and harness_run."},"source":{"type":"string"},"status":{"type":"string","enum":["success","failure","pending","running","waiting","cancelled"]},"title":{"type":"string"},"timestamp":{"type":"string","format":"date-time"},"summary":{"type":"string"},"repo":{"type":"string"},"workflow":{"type":"string"},"branch":{"type":"string"},"commit":{"type":"string"},"skill_id":{"type":"string"},"run_id":{"type":"string"},"receipt_id":{"type":"string"},"url":{"type":"string","format":"uri"},"metadata":{"type":"object","additionalProperties":true}},"required":["kind","source","status","title","timestamp"],"additionalProperties":false},"PublicEvidenceIngestRequest":{"type":"object","properties":{"events":{"type":"array","items":{"$ref":"#/components/schemas/PublicEvidenceEventInput"}}},"required":["events"],"additionalProperties":false},"PublicEvidenceIngestEnvelope":{"type":"object","properties":{"status":{"type":"string","const":"accepted"},"count":{"type":"integer"},"events":{"type":"array","items":{"$ref":"#/components/schemas/PublicEvidenceEventInput"}}},"required":["status","count","events"],"additionalProperties":false},"HarnessPublishSummary":{"type":"object","properties":{"status":{"type":"string","enum":["passed","failed","not_declared"]},"case_count":{"type":"integer"},"assertion_error_count":{"type":"integer"},"assertion_errors":{"type":"array","items":{"type":"string"}},"case_names":{"type":"array","items":{"type":"string"}},"receipt_ids":{"type":"array","items":{"type":"string"}},"graph_case_count":{"type":"integer"},"evidence_id":{"type":"string"},"evidence_url":{"type":"string","format":"uri"}},"required":["status","case_count","assertion_error_count","assertion_errors","case_names","receipt_ids"],"additionalProperties":false},"AdminRegistryPublishRequest":{"type":"object","properties":{"owner":{"type":"string"},"version":{"type":"string"},"created_at":{"type":"string","format":"date-time"},"markdown":{"type":"string"},"profile_document":{"type":"string"},"harness":{"$ref":"#/components/schemas/HarnessPublishSummary"}},"required":["owner","markdown","harness"],"additionalProperties":false},"AdminOwnerProfileRequest":{"type":"object","properties":{"handle":{"type":"string"},"display_name":{"type":"string"},"description":{"type":"string"},"website_url":{"type":"string","format":"uri"},"github_url":{"type":"string","format":"uri"},"kind":{"type":"string","enum":["org","user","team"]},"verified":{"type":"boolean"},"links":{"type":"array","items":{"$ref":"#/components/schemas/PublicOwnerProfileLink"}}},"additionalProperties":false},"AdminRegistryPublishEnvelope":{"type":"object","properties":{"status":{"type":"string","const":"success"},"publish":{"type":"object","additionalProperties":true},"harness":{"$ref":"#/components/schemas/HarnessPublishSummary"}},"required":["status","publish","harness"],"additionalProperties":false},"ReceiptKeyProof":{"type":"object","required":["challenge_id","public_key_pem","signature"],"properties":{"challenge_id":{"type":"string"},"public_key_pem":{"type":"string"},"signature":{"type":"object","required":["alg","value"],"properties":{"alg":{"type":"string","const":"Ed25519"},"value":{"type":"string"}},"additionalProperties":false}},"additionalProperties":false},"ReceiptKeyChallengeRequest":{"type":"object","required":["intent","kid","public_key_sha256"],"allOf":[{"if":{"properties":{"intent":{"const":"notarize"}},"required":["intent"]},"then":{"required":["digest"]}}],"properties":{"intent":{"type":"string","enum":["notarize","claim"]},"kid":{"type":"string"},"public_key_sha256":{"type":"string"},"digest":{"type":"string"}},"additionalProperties":false},"ReceiptKeyChallengeEnvelope":{"type":"object","required":["status","challenge"],"properties":{"status":{"type":"string","const":"challenge_created"},"challenge":{"type":"object","required":["schema","id","challenge","intent","kid","public_key_sha256","expires_at"],"properties":{"schema":{"type":"string","const":"runx.receipt_key_challenge.v1"},"id":{"type":"string"},"challenge":{"type":"string"},"intent":{"type":"string","enum":["notarize","claim"]},"kid":{"type":"string"},"public_key_sha256":{"type":"string"},"digest":{"type":"string"},"expires_at":{"type":"string","format":"date-time"}},"additionalProperties":false}},"additionalProperties":false},"ReceiptKeyClaimRequest":{"type":"object","required":["kid","proof"],"properties":{"kid":{"type":"string"},"proof":{"$ref":"#/components/schemas/ReceiptKeyProof"}},"additionalProperties":false},"ReceiptKeyDisavowRequest":{"type":"object","required":["kid","public_key_sha256"],"properties":{"kid":{"type":"string"},"public_key_sha256":{"type":"string"},"disavowed_from":{"type":"string","format":"date-time"}},"additionalProperties":false},"ReceiptKeyBinding":{"type":"object","required":["id","kid","public_key_sha256","principal_id","status","created_at"],"properties":{"id":{"type":"string"},"kid":{"type":"string"},"public_key_sha256":{"type":"string"},"principal_id":{"type":"string"},"status":{"type":"string","enum":["bound","disavowed"]},"bound_at":{"type":"string","format":"date-time"},"disavowed_from":{"type":"string","format":"date-time"},"created_at":{"type":"string","format":"date-time"}},"additionalProperties":false},"ReceiptKeyClaimEnvelope":{"type":"object","required":["status","binding"],"properties":{"status":{"type":"string","enum":["claimed","disavowed"]},"binding":{"$ref":"#/components/schemas/ReceiptKeyBinding"}},"additionalProperties":false},"ReceiptKeyBindingListEnvelope":{"type":"object","required":["status","bindings"],"properties":{"status":{"type":"string","const":"success"},"bindings":{"type":"array","items":{"$ref":"#/components/schemas/ReceiptKeyBinding"}}},"additionalProperties":false},"ReceiptNotarizeRequest":{"oneOf":[{"type":"object","required":["receipt"],"properties":{"publish":{"type":"boolean"},"public_claim":{"$ref":"#/components/schemas/ReceiptPublicClaim"},"receipt":{"type":"object","additionalProperties":true},"proof":{"$ref":"#/components/schemas/ReceiptKeyProof"}},"additionalProperties":false},{"type":"object","required":["receipt_raw"],"properties":{"publish":{"type":"boolean"},"public_claim":{"$ref":"#/components/schemas/ReceiptPublicClaim"},"receipt_raw":{"type":"string"}},"additionalProperties":false},{"type":"object","required":["mode","digest"],"properties":{"mode":{"type":"string","const":"hash_only"},"publish":{"type":"boolean"},"public_claim":{"$ref":"#/components/schemas/ReceiptPublicClaim"},"digest":{"type":"string"},"receipt_id":{"type":"string"},"proof":{"$ref":"#/components/schemas/ReceiptKeyProof"},"edge_issuer":{"type":"object","properties":{"type":{"type":"string"},"kid":{"type":"string"},"public_key_sha256":{"type":"string"}},"additionalProperties":false}},"additionalProperties":false}]},"ReceiptPublicClaim":{"type":"object","required":["schema","kind","title","venue","occurred_at"],"properties":{"schema":{"type":"string","const":"runx.public_receipt_claim.v1"},"kind":{"type":"string","enum":["payout","funding","judgment","profile_update","delivery","signup"]},"title":{"type":"string","maxLength":96},"venue":{"type":"object","required":["id"],"properties":{"id":{"type":"string"},"name":{"type":"string","maxLength":48},"url":{"type":"string","format":"uri"}},"additionalProperties":false},"subject":{"type":"object","required":["type","id"],"properties":{"type":{"type":"string"},"id":{"type":"string"},"label":{"type":"string","maxLength":80}},"additionalProperties":false},"amount":{"type":"object","required":["cents","currency"],"properties":{"cents":{"type":"integer","minimum":0},"currency":{"type":"string","minLength":3,"maxLength":3}},"additionalProperties":false},"source_url":{"type":"string","format":"uri"},"occurred_at":{"type":"string","format":"date-time"}},"additionalProperties":false},"ReceiptNotaryEnvelope":{"type":"object","required":["status","replay_status","digest","public_hash","mode","published","binary_version","verified_at","verdict","counter_seal"],"properties":{"status":{"type":"string","const":"notarized"},"replay_status":{"type":"string","enum":["created","existing"]},"digest":{"type":"string"},"public_hash":{"type":"string"},"mode":{"type":"string","enum":["full","hash_only"]},"published":{"type":"boolean"},"receipt_id":{"type":"string"},"public_claim":{"$ref":"#/components/schemas/ReceiptPublicClaim"},"public_url":{"type":"string","format":"uri"},"edge_issuer":{"type":"object","additionalProperties":true},"binary_version":{"type":"string"},"verified_at":{"type":"string","format":"date-time"},"verdict":{"type":"object","additionalProperties":true},"counter_seal":{"type":"object","additionalProperties":true}},"additionalProperties":false},"ReceiptVerificationFailedEnvelope":{"type":"object","required":["error","code","verdict"],"properties":{"error":{"type":"string"},"code":{"type":"string","const":"receipt_verification_failed"},"verdict":{"type":"object","additionalProperties":true}},"additionalProperties":false},"CreateAccountRequest":{"type":"object","properties":{"display_name":{"type":"string"}}},"AccountCreatedEnvelope":{"type":"object","required":["status","principal","credential"],"properties":{"status":{"const":"created"},"principal":{"type":"object"},"credential":{"type":"object","required":["credential_id","token"],"properties":{"credential_id":{"type":"string"},"token":{"type":"string"}}}}},"StripeSetupIntentRequest":{"type":"object","properties":{"idempotency_key":{"type":"string"}}},"StripeSetupIntentEnvelope":{"type":"object","required":["status","stripe_setup"],"properties":{"status":{"const":"created"},"stripe_setup":{"type":"object","required":["customer","setup_intent_id","client_secret"],"properties":{"customer":{"type":"string"},"setup_intent_id":{"type":"string"},"client_secret":{"type":"string"}}}}},"StripePaymentMethodEnvelope":{"type":"object","required":["status","stripe_payment_method"],"properties":{"status":{"const":"success"},"stripe_payment_method":{"type":"object","required":["principal_id","paymentMethod","created_at","updated_at"],"properties":{"principal_id":{"type":"string"},"customer":{"type":"string"},"paymentMethod":{"type":"string"},"created_at":{"type":"string"},"updated_at":{"type":"string"}}}}},"BillingTopupRequest":{"type":"object","required":["amount"],"properties":{"amount":{"type":"integer","minimum":1},"idempotency_key":{"type":"string"}}},"BillingTopupEnvelope":{"type":"object","required":["status","balance","credited","debited","receipt_id"],"properties":{"status":{"enum":["applied","already_applied"]},"balance":{"type":"integer"},"credited":{"type":"integer"},"debited":{"type":"integer"},"receipt_id":{"type":"string"}}},"BillingBalanceEnvelope":{"type":"object","required":["status","balance","credited","debited"],"properties":{"status":{"const":"success"},"balance":{"type":"integer"},"credited":{"type":"integer"},"debited":{"type":"integer"}}},"EntitlementEnvelope":{"type":"object","required":["status","entitlement"],"properties":{"status":{"const":"success"},"entitlement":{"type":"object"}}},"EntitlementListEnvelope":{"type":"object","required":["status","entitlements"],"properties":{"status":{"const":"success"},"entitlements":{"type":"array","items":{"type":"object"}}}},"PutEntitlementRequest":{"type":"object","required":["subscription_reference"],"properties":{"principal_id":{"type":"string"},"subscription_reference":{"type":"string"}}},"StripeConnectOnboardingStartRequest":{"type":"object","required":["refresh_url","return_url"],"properties":{"refresh_url":{"type":"string","format":"uri"},"return_url":{"type":"string","format":"uri"},"seller_principal_id":{"type":"string"},"email":{"type":"string"},"country":{"type":"string"}},"additionalProperties":false},"StripeConnectSeller":{"type":"object","required":["principal_id","stripe_account_id","charges_enabled","payouts_enabled","details_submitted","status","registered_at","updated_at"],"properties":{"principal_id":{"type":"string"},"stripe_account_id":{"type":"string"},"charges_enabled":{"type":"boolean"},"payouts_enabled":{"type":"boolean"},"details_submitted":{"type":"boolean"},"status":{"type":"string","enum":["pending","enabled","restricted"]},"registered_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}},"additionalProperties":false},"StripeConnectOnboardingStartEnvelope":{"type":"object","required":["ok","onboarding_url","expires_at","seller"],"properties":{"ok":{"const":true},"onboarding_url":{"type":"string","format":"uri"},"expires_at":{"oneOf":[{"type":"integer"},{"type":"string"}]},"seller":{"$ref":"#/components/schemas/StripeConnectSeller"}},"additionalProperties":false},"StripeConnectOnboardingStatusEnvelope":{"type":"object","required":["ok","seller"],"properties":{"ok":{"const":true},"seller":{"oneOf":[{"$ref":"#/components/schemas/StripeConnectSeller"},{"type":"null"}]}},"additionalProperties":false},"MarketplaceFundingRequest":{"type":"object","required":["idempotency_key","posting_id","payer_ref","payee_ref","currency","price_cents","fee_cents","claim_limit","funded_claim_slots"],"properties":{"principal_id":{"type":"string"},"idempotency_key":{"type":"string"},"posting_id":{"type":"string"},"payer_ref":{"type":"string"},"payee_ref":{"type":"string"},"currency":{"type":"string"},"price_cents":{"type":"integer","minimum":1},"fee_cents":{"type":"integer","minimum":0},"claim_limit":{"type":"integer","minimum":1},"funded_claim_slots":{"type":"integer","minimum":1},"quote_digest":{"type":"string"},"quote_expires_at":{"type":"string","format":"date-time"},"refund_policy_ref":{"type":"string"}},"additionalProperties":false},"PayPalMarketplaceOrderRequest":{"type":"object","required":["idempotency_key","posting_id","payer_ref","payee_ref","currency","price_cents","fee_cents","claim_limit","funded_claim_slots"],"properties":{"principal_id":{"type":"string"},"idempotency_key":{"type":"string"},"posting_id":{"type":"string"},"payer_ref":{"type":"string"},"payee_ref":{"type":"string"},"currency":{"type":"string"},"price_cents":{"type":"integer","minimum":1},"fee_cents":{"type":"integer","minimum":0},"claim_limit":{"type":"integer","minimum":1},"funded_claim_slots":{"type":"integer","minimum":1},"quote_digest":{"type":"string"},"quote_expires_at":{"type":"string","format":"date-time"},"refund_policy_ref":{"type":"string"},"return_url":{"type":"string","format":"uri"},"cancel_url":{"type":"string","format":"uri"}},"additionalProperties":false},"PayPalMarketplaceCaptureRequest":{"type":"object","required":["idempotency_key","posting_id","payer_ref","payee_ref","currency","price_cents","fee_cents","claim_limit","funded_claim_slots","order_id"],"properties":{"principal_id":{"type":"string"},"idempotency_key":{"type":"string"},"posting_id":{"type":"string"},"payer_ref":{"type":"string"},"payee_ref":{"type":"string"},"currency":{"type":"string"},"price_cents":{"type":"integer","minimum":1},"fee_cents":{"type":"integer","minimum":0},"claim_limit":{"type":"integer","minimum":1},"funded_claim_slots":{"type":"integer","minimum":1},"quote_digest":{"type":"string"},"quote_expires_at":{"type":"string","format":"date-time"},"refund_policy_ref":{"type":"string"},"order_id":{"type":"string"}},"additionalProperties":false},"PayPalOrderEnvelope":{"type":"object","required":["ok","order_id","status","amount_cents","currency"],"properties":{"ok":{"const":true},"order_id":{"type":"string"},"status":{"type":"string"},"approval_url":{"type":"string","format":"uri"},"amount_cents":{"type":"integer","minimum":1},"currency":{"type":"string"}},"additionalProperties":false},"X402MarketplaceFundingRequest":{"type":"object","required":["idempotency_key","posting_id","payer_ref","payee_ref","currency","price_cents","fee_cents","claim_limit","funded_claim_slots","payment_payload","payment_requirements"],"properties":{"principal_id":{"type":"string"},"idempotency_key":{"type":"string"},"posting_id":{"type":"string"},"payer_ref":{"type":"string"},"payee_ref":{"type":"string"},"currency":{"type":"string"},"price_cents":{"type":"integer","minimum":1},"fee_cents":{"type":"integer","minimum":0},"claim_limit":{"type":"integer","minimum":1},"funded_claim_slots":{"type":"integer","minimum":1},"quote_digest":{"type":"string"},"quote_expires_at":{"type":"string","format":"date-time"},"refund_policy_ref":{"type":"string"},"payment_payload":{"type":"object","additionalProperties":true},"payment_requirements":{"type":"object","additionalProperties":true}},"additionalProperties":false},"X402MarketplaceRefundRequest":{"type":"object","required":["funding_receipt_id","idempotency_key","amount_cents","refund_basis","reason","worker_slots_refunded","worker_refunded_cents","fee_refunded_cents"],"properties":{"funding_receipt_id":{"type":"string"},"idempotency_key":{"type":"string"},"amount_cents":{"type":"integer","minimum":1},"refund_basis":{"type":"string"},"reason":{"type":"string"},"worker_slots_refunded":{"type":"integer","minimum":0},"worker_refunded_cents":{"type":"integer","minimum":0},"fee_refunded_cents":{"type":"integer","minimum":0},"policy_decision_ref":{"type":"string"}},"additionalProperties":false},"X402SettlementPendingEnvelope":{"type":"object","required":["ok","status","code","message","retryable"],"properties":{"ok":{"const":true},"status":{"const":"pending"},"code":{"const":"settlement_pending"},"message":{"type":"string"},"retryable":{"const":true}},"additionalProperties":false},"X402MarketplacePayoutRequest":{"type":"object","required":["idempotency_key","posting_id","claim_id","worker_principal_id","rail","payout_identity_hash","payee_ref","currency","amount_cents","source_funding_intent_id","settled_at"],"properties":{"idempotency_key":{"type":"string"},"posting_id":{"type":"string"},"claim_id":{"type":"string"},"worker_principal_id":{"type":"string"},"rail":{"type":"string"},"payout_identity_hash":{"type":"string"},"payee_ref":{"type":"string"},"payer_ref":{"type":"string"},"currency":{"type":"string"},"amount_cents":{"type":"integer","minimum":1},"source_funding_intent_id":{"type":"string"},"payout_basis_ref":{"type":"string"},"settled_at":{"type":"string","format":"date-time"}},"additionalProperties":false},"X402MarketplaceFloatPayoutRequest":{"type":"object","required":["idempotency_key","posting_id","claim_id","worker_principal_id","rail","payout_identity_hash","payee_ref","currency","amount_cents","settled_at"],"properties":{"idempotency_key":{"type":"string"},"posting_id":{"type":"string"},"claim_id":{"type":"string"},"worker_principal_id":{"type":"string"},"rail":{"type":"string"},"payout_identity_hash":{"type":"string"},"payee_ref":{"type":"string"},"payer_ref":{"type":"string"},"currency":{"type":"string"},"amount_cents":{"type":"integer","minimum":1},"source_funding_intent_id":{"type":"string"},"payout_basis_ref":{"type":"string"},"settled_at":{"type":"string","format":"date-time"}},"additionalProperties":false},"X402WorkerWalletRequest":{"type":"object","required":["worker_principal_id","rail","address"],"properties":{"worker_principal_id":{"type":"string"},"rail":{"type":"string"},"address":{"type":"string"}},"additionalProperties":false},"X402WorkerWalletEnvelope":{"type":"object","required":["ok"],"properties":{"ok":{"const":true}},"additionalProperties":false},"MarketplacePayoutRequest":{"type":"object","required":["idempotency_key","posting_id","claim_id","destination_account_id","payee_ref","currency","amount_cents","source_funding_intent_id","settled_at"],"properties":{"principal_id":{"type":"string"},"idempotency_key":{"type":"string"},"posting_id":{"type":"string"},"claim_id":{"type":"string"},"destination_account_id":{"type":"string"},"payee_ref":{"type":"string"},"payer_ref":{"type":"string"},"currency":{"type":"string"},"amount_cents":{"type":"integer","minimum":1},"source_funding_intent_id":{"type":"string"},"settled_at":{"type":"string","format":"date-time"}},"additionalProperties":false},"MarketplaceRefundRequest":{"type":"object","required":["idempotency_key","amount_cents","refund_basis","reason"],"oneOf":[{"required":["funding_receipt_id","worker_slots_refunded","worker_refunded_cents","fee_refunded_cents"]},{"required":["payout_receipt_id","payer_ref"]}],"properties":{"funding_receipt_id":{"type":"string"},"payout_receipt_id":{"type":"string"},"idempotency_key":{"type":"string"},"amount_cents":{"type":"integer","minimum":1},"refund_basis":{"type":"string"},"reason":{"type":"string"},"payer_ref":{"type":"string"},"worker_slots_refunded":{"type":"integer","minimum":0},"worker_refunded_cents":{"type":"integer","minimum":0},"fee_refunded_cents":{"type":"integer","minimum":0},"policy_decision_ref":{"type":"string"}},"additionalProperties":false},"PayPalMarketplaceRefundRequest":{"type":"object","required":["funding_receipt_id","idempotency_key","amount_cents","refund_basis","reason","worker_slots_refunded","worker_refunded_cents","fee_refunded_cents"],"properties":{"funding_receipt_id":{"type":"string"},"idempotency_key":{"type":"string"},"amount_cents":{"type":"integer","minimum":1},"refund_basis":{"type":"string"},"reason":{"type":"string"},"worker_slots_refunded":{"type":"integer","minimum":0},"worker_refunded_cents":{"type":"integer","minimum":0},"fee_refunded_cents":{"type":"integer","minimum":0},"policy_decision_ref":{"type":"string"}},"additionalProperties":false},"MarketplaceReceiptEnvelope":{"type":"object","required":["ok","receipt","idempotent_replay"],"properties":{"ok":{"const":true},"receipt":{"type":"object","additionalProperties":true},"idempotent_replay":{"type":"boolean"}},"additionalProperties":false},"X402MarketplaceQuoteRequest":{"type":"object","required":["resource","price_cents","fee_cents","funded_claim_slots"],"properties":{"resource":{"type":"string"},"description":{"type":"string"},"price_cents":{"type":"integer","minimum":1},"fee_cents":{"type":"integer","minimum":0},"funded_claim_slots":{"type":"integer","minimum":1},"max_timeout_seconds":{"type":"integer","minimum":1}},"additionalProperties":false},"X402SettlementTarget":{"type":"object","required":["network","asset","pay_to","asset_decimals"],"properties":{"network":{"type":"string","enum":["base-sepolia","base"]},"asset":{"type":"string"},"pay_to":{"type":"string"},"asset_decimals":{"type":"integer","minimum":0},"recommended":{"type":"boolean"}},"additionalProperties":false},"X402SettlementTargetsRequest":{"type":"object","required":["targets"],"properties":{"targets":{"type":"array","minItems":1,"items":{"$ref":"#/components/schemas/X402SettlementTarget"}}},"additionalProperties":false},"X402SettlementTargetsEnvelope":{"type":"object","required":["ok","outbound_configured","targets"],"properties":{"ok":{"const":true},"grant_id":{"type":"string"},"outbound_configured":{"type":"boolean"},"targets":{"type":"array","minItems":1,"items":{"$ref":"#/components/schemas/X402SettlementTarget"}}},"additionalProperties":false},"X402QuoteEnvelope":{"type":"object","required":["ok","accepts","payment_requirements"],"properties":{"ok":{"const":true},"accepts":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true}},"payment_requirements":{"type":"object","additionalProperties":true}},"additionalProperties":false}}}}