{ "openapi": "3.0.3", "info": { "title": "ODEI API", "version": "0.2.0", "description": "Public ODEI runtime contract for health, context, metrics, world-model projection, intake/write gate, token telemetry, bidwall telemetry, and Blink surfaces.", "termsOfService": "https://api.odei.ai/terms/", "contact": { "url": "https://api.odei.ai/legal/" }, "x-legal": { "privacy": "https://api.odei.ai/privacy/", "sla": "https://api.odei.ai/sla/" } }, "servers": [ { "url": "https://api.odei.ai" } ], "paths": { "/health": { "get": { "summary": "Service health", "responses": { "200": { "description": "OK" } } } }, "/openapi.json": { "get": { "summary": "OpenAPI spec", "responses": { "200": { "description": "OpenAPI JSON" } } } }, "/openapi-v2.yaml": { "get": { "summary": "Digital World Model API v2 OpenAPI", "responses": { "200": { "description": "OpenAPI v2 YAML" } } } }, "/mcp": { "options": { "summary": "ODEI Connect MCP preflight", "responses": { "204": { "description": "CORS preflight for JSON-RPC MCP transport" } } }, "post": { "summary": "ODEI Connect MCP JSON-RPC transport", "description": "Deterministic MCP control plane for agent-assisted ODEI local runtime setup. Pairing requires app.odei.ai handoff verification; tools do not invoke a model API.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "jsonrpc", "method" ], "properties": { "jsonrpc": { "type": "string", "enum": [ "2.0" ] }, "id": { "oneOf": [ { "type": "string" }, { "type": "number" }, { "type": "null" } ] }, "method": { "type": "string" }, "params": { "type": "object", "additionalProperties": true } } } } } }, "responses": { "200": { "description": "JSON-RPC result envelope" }, "400": { "description": "Invalid JSON-RPC request" }, "413": { "description": "Request body too large" }, "415": { "description": "Expected application/json" } } } }, "/.well-known/mcp.json": { "get": { "summary": "ODEI Connect MCP discovery", "responses": { "200": { "description": "Machine-readable MCP discovery metadata" } } } }, "/.well-known/agent-card.json": { "get": { "summary": "ODEI agent card", "responses": { "200": { "description": "Machine-readable ODEI agent activation card" } } } }, "/.well-known/agent.json": { "get": { "summary": "ODEI agent manifest", "responses": { "200": { "description": "Machine-readable ODEI agent manifest" } } } }, "/.well-known/x402.json": { "get": { "summary": "x402 manifest", "responses": { "200": { "description": "x402 capability metadata" } } } }, "/.well-known/odei-base-capabilities.json": { "get": { "summary": "Base capability registry", "responses": { "200": { "description": "Machine-readable Base integration registry" } } } }, "/api/agent-access/plans": { "get": { "summary": "Agent access plans and Base USDC payment rail", "responses": { "200": { "description": "ODEI agent access plan catalog", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AgentAccessPlansResponse" } } } } } } }, "/api/agent-access/quote": { "post": { "summary": "Create an agent access quote", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AgentAccessQuoteRequest" } } } }, "responses": { "201": { "description": "Quote created", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AgentAccessQuoteResponse" } } } }, "400": { "description": "Bad Request" }, "429": { "description": "Rate limit exceeded" } } } }, "/api/agent-access/claim": { "post": { "summary": "Verify Base USDC payment and issue activation packet", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AgentAccessClaimRequest" } } } }, "responses": { "201": { "description": "Activation packet issued", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AgentAccessClaimResponse" } } } }, "202": { "description": "Transaction pending" }, "402": { "description": "Payment not matched" }, "409": { "description": "Claim already exists or is currently being serialized" } } } }, "/api/agent-access/claims/{claimId}": { "get": { "summary": "Fetch redacted agent access receipt", "parameters": [ { "name": "claimId", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Redacted agent access receipt", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AgentAccessReceiptResponse" } } } }, "404": { "description": "Claim not found" } } } }, "/api/context": { "get": { "summary": "Public ODEI context snapshot", "responses": { "200": { "description": "Live or fallback context snapshot" }, "429": { "description": "Route budget exceeded" } } } }, "/api/site-metrics": { "get": { "summary": "Aggregated live site metrics snapshot", "responses": { "200": { "description": "Unified metrics payload for public surfaces" }, "429": { "description": "Route budget exceeded" } } } }, "/api/worldmodel": { "get": { "summary": "Legacy live projection alias", "responses": { "200": { "description": "Projection snapshot" }, "429": { "description": "Route budget exceeded" } } } }, "/api/worldmodel/public-projection": { "get": { "summary": "Public projection alias (redirect)", "responses": { "302": { "description": "Redirect to /api/worldmodel/live" } } } }, "/api/worldmodel/live": { "get": { "summary": "Live projection payload", "responses": { "200": { "description": "Projection snapshot" }, "429": { "description": "Route budget exceeded" } } } }, "/api/worldmodel/render": { "get": { "summary": "Render-optimized public World Model projection", "parameters": [ { "name": "view", "in": "query", "required": false, "description": "Optional render profile such as app-hero, hero, or shell.", "schema": { "type": "string" } }, { "name": "compact", "in": "query", "required": false, "description": "Request compact projection mode when set to 1 or true.", "schema": { "type": "string", "enum": [ "1", "true" ] } } ], "responses": { "200": { "description": "Render-ready projection snapshot" }, "304": { "description": "Projection not modified for the supplied ETag" }, "429": { "description": "Route budget exceeded" } } } }, "/api/worldmodel/create": { "post": { "summary": "Create onboarding capsule", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WorldModelCreateRequest" } } } }, "responses": { "201": { "description": "Created" }, "400": { "description": "Bad Request" }, "429": { "description": "Rate limit exceeded" } } } }, "/api/intake/stats": { "get": { "summary": "Intake registration counts by lane", "responses": { "200": { "description": "Stats" } } } }, "/api/intake/recent": { "get": { "summary": "Recent intake activity", "responses": { "200": { "description": "Recent anonymized lane timeline" } } } }, "/api/intake/{intakeId}": { "get": { "summary": "Provisioning status for a specific intake ID", "parameters": [ { "name": "intakeId", "in": "path", "required": true, "description": "Canonical intake identifier returned by POST /api/intake", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Provisioning status envelope", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/IntakeStatusResponse" } } } }, "404": { "description": "Intake not found" } } } }, "/api/intake/{intakeId}/capsule": { "get": { "summary": "Canonical provisioning capsule for a specific intake ID", "parameters": [ { "name": "intakeId", "in": "path", "required": true, "description": "Canonical intake identifier returned by POST /api/intake", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Provisioning capsule handoff artifact", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/IntakeProvisioningCapsule" } } } }, "404": { "description": "Intake not found" } } } }, "/api/intake": { "post": { "summary": "Register agent, human operator, or enterprise onboarding (consent required)", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/IntakeRequest" } } } }, "responses": { "201": { "description": "Intake registered", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/IntakeResponse" } } } }, "400": { "description": "Bad Request" }, "429": { "description": "Rate limit exceeded" } } } }, "/api/token/price": { "get": { "summary": "ODAI token telemetry snapshot", "responses": { "200": { "description": "Price, market-cap and activity metrics" } } } }, "/api/token/holders": { "get": { "summary": "ODAI holder count (exact + provenance)", "responses": { "200": { "description": "Holder count with source/quality/stale/fetchedAt, consistency level and source discrepancy metadata" } } } }, "/api/token/holders-map": { "get": { "summary": "ODAI holders map", "parameters": [ { "name": "limit", "in": "query", "required": false, "description": "Number of holder rows to return (60..5000)", "schema": { "type": "integer", "minimum": 60, "maximum": 5000 } } ], "responses": { "200": { "description": "Paginated holder map payload" } } } }, "/api/token/holders-map-temporal": { "get": { "summary": "ODAI holder temporal intelligence", "responses": { "200": { "description": "Comparison window across persisted holder snapshots, including churn, movers, and cohort deltas" } } } }, "/api/integrations/giza/base-snapshot": { "get": { "summary": "Giza read-only integration snapshot", "responses": { "200": { "description": "Server-side Giza Base USDC intelligence envelope without browser-exposed partner credentials" }, "429": { "description": "Route budget exceeded" } } } }, "/api/revenue/moltlaunch": { "get": { "summary": "MoltLaunch revenue telemetry", "responses": { "200": { "description": "Revenue snapshot for ODEI agent profile" } } } }, "/blink/guardrail": { "get": { "summary": "Guardrail Blink action", "responses": { "200": { "description": "Solana action payload for guardrail flow" } } } }, "/blink/worldmodel": { "get": { "summary": "World-model Blink action", "responses": { "200": { "description": "Solana action payload for world-model query flow" } } } }, "/api/bidwall/balance": { "get": { "summary": "BidWall contract native ETH balance (wei)", "responses": { "200": { "description": "Balance payload with cache/stale metadata" } } } }, "/api/bidwall/eth-price": { "get": { "summary": "ETH/USD spot proxy for BidWall valuation", "responses": { "200": { "description": "ETH/USD payload with source and stale metadata" } } } }, "/api/bidwall/snapshot": { "get": { "summary": "BidWall merged telemetry snapshot (scope-aware provenance)", "parameters": [ { "name": "scope", "in": "query", "required": false, "description": "Activity scope (`all` or `odai`)", "schema": { "type": "string", "enum": [ "all", "odai" ] } }, { "name": "token", "in": "query", "required": false, "description": "Optional ERC-20 address filter for events (overrides `scope`)", "schema": { "type": "string" } }, { "name": "events_limit", "in": "query", "required": false, "description": "Number of preview events to include in snapshot (1..20, default 8)", "schema": { "type": "integer", "minimum": 1, "maximum": 20 } } ], "responses": { "200": { "description": "Balance + ETH/USD + trigger progress + freshness/quality/scope metadata" } } } }, "/api/bidwall/events": { "get": { "summary": "Recent BidWall token transfer activity (scope-aware)", "parameters": [ { "name": "limit", "in": "query", "required": false, "description": "Number of events to return (1..40, default 20)", "schema": { "type": "integer", "minimum": 1, "maximum": 40 } }, { "name": "scope", "in": "query", "required": false, "description": "Activity scope (`all` or `odai`)", "schema": { "type": "string", "enum": [ "all", "odai" ] } }, { "name": "token", "in": "query", "required": false, "description": "Optional ERC-20 address filter for events (overrides `scope`)", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Recent token transfer events touching BidWall contract with source/quality/scope metadata" } } } } }, "components": { "schemas": { "AgentAccessPlansResponse": { "type": "object", "description": "Base USDC activation plan catalog with discover, quote, payment, and claim links", "required": [ "ok", "artifact", "plans", "quoteUrl", "claimUrl", "receiptUrlTemplate", "flow", "payment", "network", "signing" ], "properties": { "ok": { "type": "boolean", "enum": [ true ] }, "artifact": { "type": "string", "enum": [ "odei.agent-access.plans" ] }, "schema": { "type": "string", "enum": [ "odei.agent_access.plans.v1" ] }, "service": { "type": "string" }, "quoteUrl": { "type": "string", "format": "uri" }, "claimUrl": { "type": "string", "format": "uri" }, "receiptUrlTemplate": { "type": "string" }, "network": { "type": "string", "enum": [ "eip155:8453" ] }, "payment": { "type": "object", "additionalProperties": true }, "signing": { "type": "object", "additionalProperties": true }, "flow": { "type": "object", "required": [ "discover", "quote", "pay", "claim", "receipt", "activation" ], "properties": { "discover": { "type": "string" }, "quote": { "type": "string" }, "pay": { "type": "string" }, "claim": { "type": "string" }, "receipt": { "type": "string" }, "activation": { "type": "string" } } }, "plans": { "type": "array", "items": { "type": "object", "required": [ "id", "name", "price", "payment", "claimable", "deliverable", "status" ], "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "description": { "type": "string" }, "price": { "type": "object", "additionalProperties": true }, "payment": { "type": "object", "additionalProperties": true }, "claimable": { "type": "boolean" }, "deliverable": { "type": "string" }, "status": { "type": "string" } } } } } }, "AgentAccessQuoteRequest": { "type": "object", "anyOf": [ { "required": [ "operatorAddress" ] }, { "required": [ "payerAddress" ] } ], "properties": { "planId": { "type": "string", "default": "agent_runtime_activation" }, "agentId": { "type": "string", "minLength": 1 }, "agentName": { "type": "string" }, "assistantId": { "type": "string" }, "userId": { "type": "string" }, "operatorAddress": { "type": "string", "pattern": "^0x[a-fA-F0-9]{40}$" }, "payerAddress": { "type": "string", "pattern": "^0x[a-fA-F0-9]{40}$" }, "callbackUrl": { "type": "string", "format": "uri" } } }, "AgentAccessClaimRequest": { "type": "object", "required": [ "quoteId", "transactionHash", "quoteHash", "paymentRequirementHash" ], "properties": { "quoteId": { "type": "string" }, "transactionHash": { "type": "string", "pattern": "^0x[a-fA-F0-9]{64}$" }, "quoteHash": { "type": "string", "description": "Expected sha256-canonical-json hash returned by the quote response." }, "paymentRequirementHash": { "type": "string", "description": "Expected sha256-canonical-json payment requirement hash returned by the quote response." }, "integrity": { "type": "object", "additionalProperties": true } } }, "AgentAccessQuoteResponse": { "type": "object", "required": [ "ok", "schema", "quoteId", "quoteHash", "paymentRequirementHash", "expiresAt", "signature", "data" ], "properties": { "ok": { "type": "boolean", "enum": [ true ] }, "schema": { "type": "string", "enum": [ "odei.agent_access.quote_response.v1" ] }, "quoteId": { "type": "string" }, "quoteHash": { "type": "string" }, "paymentRequirementHash": { "type": "string" }, "expiresAt": { "type": "string" }, "price": { "type": "object", "additionalProperties": true }, "payment": { "type": "object", "additionalProperties": true }, "integrity": { "type": "object", "additionalProperties": true }, "signature": { "type": "object", "additionalProperties": true }, "data": { "type": "object", "required": [ "quote", "paymentRequirement", "next" ], "properties": { "quote": { "type": "object", "additionalProperties": true }, "paymentRequirement": { "type": "object", "additionalProperties": true }, "next": { "type": "object", "additionalProperties": true } } } } }, "AgentAccessClaimResponse": { "type": "object", "required": [ "ok", "schema", "data" ], "properties": { "ok": { "type": "boolean", "enum": [ true ] }, "schema": { "type": "string", "enum": [ "odei.agent_access.claim_response.v1" ] }, "data": { "type": "object", "required": [ "claim", "receipt", "activationPacket" ], "properties": { "claim": { "type": "object", "additionalProperties": true }, "receipt": { "$ref": "#/components/schemas/AgentAccessReceiptResponse" }, "activationPacket": { "type": "object", "additionalProperties": true } } } } }, "AgentAccessReceiptResponse": { "type": "object", "required": [ "ok", "schema", "artifact", "receiptId", "receiptHash", "claimId", "quoteId", "signature", "claim", "governance", "recovery", "links" ], "properties": { "ok": { "type": "boolean", "enum": [ true ] }, "schema": { "type": "string", "enum": [ "odei.agent_access.receipt.v1" ] }, "artifact": { "type": "string", "enum": [ "odei.agent-access.receipt" ] }, "receiptId": { "type": "string" }, "receiptHash": { "type": "string" }, "claimId": { "type": "string" }, "quoteId": { "type": "string" }, "status": { "type": "string" }, "claimedAt": { "type": "string" }, "accessExpiresAt": { "type": "string" }, "integrity": { "type": "object", "additionalProperties": true }, "signature": { "type": "object", "additionalProperties": true }, "claim": { "type": "object", "additionalProperties": true }, "payment": { "type": "object", "additionalProperties": true }, "governance": { "type": "object", "additionalProperties": true }, "recovery": { "type": "object", "additionalProperties": true }, "links": { "type": "object", "additionalProperties": true } } }, "ConsentPayload": { "oneOf": [ { "type": "boolean", "enum": [ true ] }, { "type": "object", "required": [ "accepted" ], "properties": { "accepted": { "type": "boolean", "enum": [ true ] }, "at": { "type": "string", "format": "date-time" }, "policyVersion": { "type": "string" } } } ] }, "WorldModelCreateRequest": { "type": "object", "required": [ "ownerId", "name" ], "properties": { "ownerId": { "type": "string", "minLength": 1 }, "name": { "type": "string", "minLength": 1 }, "isAI": { "type": "boolean" }, "displayName": { "type": "string" }, "visibility": { "type": "string", "enum": [ "private", "public" ] }, "values": { "type": "array", "items": { "type": "string" }, "maxItems": 32 } } }, "IntakeAgentRequest": { "type": "object", "required": [ "lane", "consent", "agentId", "serviceOffer", "endpoint" ], "properties": { "lane": { "type": "string", "enum": [ "agent" ] }, "consent": { "$ref": "#/components/schemas/ConsentPayload" }, "consentAt": { "type": "string", "format": "date-time" }, "consentVersion": { "type": "string" }, "agentId": { "type": "string", "minLength": 3 }, "runtime": { "type": "string" }, "serviceOffer": { "type": "string", "minLength": 8 }, "endpoint": { "type": "string", "format": "uri" }, "proof": { "type": "string", "format": "uri" }, "wallet": { "type": "string" }, "rail": { "type": "string" }, "domain": { "type": "string" }, "type": { "type": "string" }, "sector": { "type": "string" }, "agentContact": { "type": "string" }, "source": { "type": "string" } } }, "IntakeHumanRequest": { "type": "object", "required": [ "lane", "consent", "name", "useCase", "telegram" ], "properties": { "lane": { "type": "string", "enum": [ "human" ] }, "consent": { "$ref": "#/components/schemas/ConsentPayload" }, "consentAt": { "type": "string", "format": "date-time" }, "consentVersion": { "type": "string" }, "name": { "type": "string", "minLength": 2 }, "agentName": { "type": "string" }, "role": { "type": "string" }, "assistantId": { "type": "string", "enum": [ "codex", "claude-code", "gemini", "grok", "custom" ] }, "experiencePath": { "type": "string", "enum": [ "new_to_agents", "existing_agent_operator" ] }, "launchPath": { "type": "string", "enum": [ "/create-my-agent", "/upgrade-my-agent", "/launch-builder" ] }, "useCase": { "type": "string", "minLength": 10 }, "workspaceName": { "type": "string" }, "operatorScope": { "type": "string" }, "modelProvider": { "type": "string" }, "modelAccess": { "type": "string" }, "governanceMode": { "type": "string" }, "runtimeProfile": { "type": "string" }, "activationPreference": { "type": "string" }, "billingReadiness": { "type": "string" }, "firstMission": { "type": "string" }, "worldSources": { "type": "array", "items": { "type": "string" }, "maxItems": 8 }, "executionSurfaces": { "type": "array", "items": { "type": "string" }, "maxItems": 6 }, "telegram": { "type": "string", "minLength": 2 }, "email": { "type": "string", "format": "email" }, "twitter": { "type": "string" }, "source": { "type": "string" } } }, "IntakeEnterpriseRequest": { "type": "object", "required": [ "lane", "consent", "orgName", "contactFullName", "contactRole", "contactEmail", "useCase" ], "properties": { "lane": { "type": "string", "enum": [ "enterprise" ] }, "consent": { "$ref": "#/components/schemas/ConsentPayload" }, "consentAt": { "type": "string", "format": "date-time" }, "consentVersion": { "type": "string" }, "orgName": { "type": "string", "minLength": 2 }, "contactFullName": { "type": "string", "minLength": 2 }, "contactName": { "type": "string", "minLength": 2 }, "contactRole": { "type": "string", "minLength": 2 }, "teamSize": { "type": "string" }, "contactEmail": { "type": "string", "format": "email" }, "telegram": { "type": "string" }, "useCase": { "type": "string", "minLength": 10 }, "source": { "type": "string" } } }, "IntakeRequest": { "oneOf": [ { "$ref": "#/components/schemas/IntakeAgentRequest" }, { "$ref": "#/components/schemas/IntakeHumanRequest" }, { "$ref": "#/components/schemas/IntakeEnterpriseRequest" } ] }, "IntakeProvisioningLinks": { "type": "object", "properties": { "app": { "type": "string", "format": "uri" }, "intakeStatus": { "type": "string", "format": "uri" }, "provisioningCapsule": { "type": "string", "format": "uri" }, "resumeApp": { "type": "string", "format": "uri" }, "registrationContract": { "type": "string", "format": "uri" }, "launchStatus": { "type": "string", "format": "uri" }, "pricingArtifact": { "type": "string", "format": "uri" }, "billingContract": { "type": "string", "format": "uri" }, "firstMissionPack": { "type": "string", "format": "uri" }, "plansArtifact": { "type": "string", "format": "uri" }, "authContract": { "type": "string", "format": "uri" }, "authState": { "type": "string", "format": "uri" }, "entitlementsArtifact": { "type": "string", "format": "uri" }, "entitlementsState": { "type": "string", "format": "uri" }, "provisioningSchema": { "type": "string", "format": "uri" }, "activationContract": { "type": "string", "format": "uri" }, "activationState": { "type": "string", "format": "uri" }, "activationPackage": { "type": "string", "format": "uri" }, "launchChecklist": { "type": "string", "format": "uri" }, "cohortContract": { "type": "string", "format": "uri" }, "activationTimeline": { "type": "string", "format": "uri" }, "intakeTemplate": { "type": "string", "format": "uri" } } }, "IntakeCommercialModel": { "type": "object", "properties": { "priceShape": { "type": "string" }, "setup": { "type": "string", "enum": [ "one_time" ] }, "runtime": { "type": "string", "enum": [ "recurring" ] }, "usage": { "type": "string", "enum": [ "metered" ] } } }, "IntakeProvisioningTrail": { "type": "object", "required": [ "currentState", "nextSteps", "links" ], "properties": { "currentState": { "type": "string" }, "nextSteps": { "type": "array", "items": { "type": "string" } }, "commercialModel": { "anyOf": [ { "$ref": "#/components/schemas/IntakeCommercialModel" }, { "type": "null" } ] }, "links": { "$ref": "#/components/schemas/IntakeProvisioningLinks" } } }, "IntakeProvisioningCapsule": { "type": "object", "required": [ "ok", "artifact", "version", "id", "intakeId", "lane", "source", "receivedAt", "consentAt", "summary", "normalized", "provisioningTrail", "activationPackage", "launchChecklist", "activation", "readiness", "generatedAt" ], "properties": { "ok": { "type": "boolean", "enum": [ true ] }, "artifact": { "type": "string" }, "version": { "type": "string" }, "id": { "type": "string" }, "intakeId": { "type": "string" }, "lane": { "type": "string", "enum": [ "agent", "human", "enterprise" ] }, "source": { "type": "string" }, "receivedAt": { "type": "string", "format": "date-time" }, "consentAt": { "type": "string", "format": "date-time" }, "summary": { "$ref": "#/components/schemas/IntakeResponseSummary" }, "normalized": { "type": "object", "additionalProperties": true }, "provisioningTrail": { "$ref": "#/components/schemas/IntakeProvisioningTrail" }, "activationPackage": { "$ref": "#/components/schemas/IntakeActivationPackage" }, "launchChecklist": { "$ref": "#/components/schemas/IntakeLaunchChecklist" }, "activation": { "$ref": "#/components/schemas/IntakeActivationStatus" }, "readiness": { "$ref": "#/components/schemas/IntakeReadiness" }, "generatedAt": { "type": "string", "format": "date-time" } } }, "IntakeActivationStatus": { "type": "object", "required": [ "reviewState", "activationState", "publicLaunch", "selfServeActivation" ], "properties": { "reviewState": { "type": "string" }, "activationState": { "type": "string" }, "publicLaunch": { "type": "string" }, "selfServeActivation": { "type": "string" } } }, "IntakeReadinessLane": { "type": "object", "required": [ "state", "next", "note" ], "properties": { "state": { "type": "string" }, "next": { "type": "string" }, "note": { "type": "string" } } }, "IntakeReadiness": { "type": "object", "required": [ "auth", "entitlements", "billing", "activation" ], "properties": { "auth": { "$ref": "#/components/schemas/IntakeReadinessLane" }, "entitlements": { "$ref": "#/components/schemas/IntakeReadinessLane" }, "billing": { "$ref": "#/components/schemas/IntakeReadinessLane" }, "activation": { "$ref": "#/components/schemas/IntakeReadinessLane" } } }, "IntakeActivationPackage": { "type": "object", "required": [ "profileId", "profileLabel", "workspaceBoundary", "governanceBoundary", "firstMission", "firstDelivery", "receiptSurface", "includedEntitlements", "activationReview", "billingMode" ], "properties": { "profileId": { "type": "string" }, "profileLabel": { "type": "string" }, "workspaceBoundary": { "type": "string" }, "workspaceBoundaryNote": { "type": "string" }, "operatorScope": { "type": "string" }, "governanceBoundary": { "type": "string" }, "governanceBoundaryNote": { "type": "string" }, "worldSources": { "type": "array", "items": { "type": "string" } }, "executionSurfaces": { "type": "array", "items": { "type": "string" } }, "firstMission": { "type": "string" }, "firstDelivery": { "type": "string" }, "firstDeliveryNote": { "type": "string" }, "receiptSurface": { "type": "string" }, "receiptSurfaceNote": { "type": "string" }, "includedEntitlements": { "type": "array", "items": { "type": "string" } }, "includedEntitlementsNote": { "type": "string" }, "activationReview": { "type": "string" }, "activationReviewNote": { "type": "string" }, "billingMode": { "type": "string" }, "billingNote": { "type": "string" } } }, "IntakeLaunchChecklistItem": { "type": "object", "required": [ "id", "label", "state", "summary", "next" ], "properties": { "id": { "type": "string" }, "label": { "type": "string" }, "state": { "type": "string", "enum": [ "captured", "defined", "pending_input", "pending_review" ] }, "summary": { "type": "string" }, "next": { "type": "string" } } }, "IntakeLaunchChecklist": { "type": "object", "required": [ "profileId", "profileLabel", "reviewState", "counts", "items" ], "properties": { "profileId": { "type": "string" }, "profileLabel": { "type": "string" }, "reviewState": { "type": "string" }, "counts": { "type": "object", "required": [ "captured", "defined", "pendingInput", "pendingReview" ], "properties": { "captured": { "type": "integer", "minimum": 0 }, "defined": { "type": "integer", "minimum": 0 }, "pendingInput": { "type": "integer", "minimum": 0 }, "pendingReview": { "type": "integer", "minimum": 0 } } }, "items": { "type": "array", "items": { "$ref": "#/components/schemas/IntakeLaunchChecklistItem" } } } }, "IntakeHumanSummary": { "type": "object", "properties": { "headline": { "type": "string" }, "assistantId": { "type": "string" }, "experiencePath": { "type": "string" }, "launchPath": { "type": "string" }, "runtimeProfile": { "type": "string" }, "runtimeLabel": { "type": "string" }, "workspaceName": { "type": "string" }, "operatorScope": { "type": "string" }, "governanceMode": { "type": "string" }, "modelProvider": { "type": "string" }, "modelAccess": { "type": "string" }, "activationPreference": { "type": "string" }, "billingReadiness": { "type": "string" }, "firstMission": { "type": "string" }, "worldSources": { "type": "array", "items": { "type": "string" } }, "executionSurfaces": { "type": "array", "items": { "type": "string" } }, "priceShape": { "type": "string" } } }, "IntakeAgentSummary": { "type": "object", "properties": { "headline": { "type": "string" }, "runtime": { "type": "string" }, "agentId": { "type": "string" }, "serviceOffer": { "type": "string" }, "endpoint": { "type": "string", "format": "uri" } } }, "IntakeEnterpriseSummary": { "type": "object", "properties": { "headline": { "type": "string" }, "orgName": { "type": "string" }, "contactFullName": { "type": "string" }, "teamSize": { "type": "string" }, "useCase": { "type": "string" } } }, "IntakeResponseSummary": { "oneOf": [ { "$ref": "#/components/schemas/IntakeHumanSummary" }, { "$ref": "#/components/schemas/IntakeAgentSummary" }, { "$ref": "#/components/schemas/IntakeEnterpriseSummary" } ] }, "IntakeResponse": { "type": "object", "required": [ "ok", "id", "intakeId", "lane", "source", "receivedAt", "consentAt", "summary", "normalized", "provisioningTrail", "activationPackage", "launchChecklist", "readiness" ], "properties": { "ok": { "type": "boolean", "enum": [ true ] }, "id": { "type": "string" }, "intakeId": { "type": "string" }, "lane": { "type": "string", "enum": [ "agent", "human", "enterprise" ] }, "source": { "type": "string" }, "receivedAt": { "type": "string", "format": "date-time" }, "consentAt": { "type": "string", "format": "date-time" }, "summary": { "$ref": "#/components/schemas/IntakeResponseSummary" }, "normalized": { "type": "object", "additionalProperties": true }, "provisioningTrail": { "$ref": "#/components/schemas/IntakeProvisioningTrail" }, "activationPackage": { "$ref": "#/components/schemas/IntakeActivationPackage" }, "launchChecklist": { "$ref": "#/components/schemas/IntakeLaunchChecklist" }, "readiness": { "$ref": "#/components/schemas/IntakeReadiness" } } }, "IntakeStatusResponse": { "type": "object", "required": [ "ok", "id", "intakeId", "lane", "source", "receivedAt", "consentAt", "summary", "normalized", "provisioningTrail", "activationPackage", "launchChecklist", "activation", "readiness" ], "properties": { "ok": { "type": "boolean", "enum": [ true ] }, "id": { "type": "string" }, "intakeId": { "type": "string" }, "lane": { "type": "string", "enum": [ "agent", "human", "enterprise" ] }, "source": { "type": "string" }, "receivedAt": { "type": "string", "format": "date-time" }, "consentAt": { "type": "string", "format": "date-time" }, "summary": { "$ref": "#/components/schemas/IntakeResponseSummary" }, "normalized": { "type": "object", "additionalProperties": true }, "provisioningTrail": { "$ref": "#/components/schemas/IntakeProvisioningTrail" }, "activationPackage": { "$ref": "#/components/schemas/IntakeActivationPackage" }, "launchChecklist": { "$ref": "#/components/schemas/IntakeLaunchChecklist" }, "activation": { "$ref": "#/components/schemas/IntakeActivationStatus" }, "readiness": { "$ref": "#/components/schemas/IntakeReadiness" } } } } } }