{"openapi":"3.1.0","info":{"title":"AI Task Hub Discovery API","version":"3.0.5","description":"Discovery-only OpenAPI. Authenticated execution is described under x-skill-hub."},"servers":[{"url":"https://gateway-api.binaryworks.app"},{"url":"https://gateway.binaryworks.app"}],"paths":{"/.well-known/ai-plugin.json":{"get":{"summary":"Read AI plugin manifest","operationId":"getAiPluginManifest","responses":{"200":{"description":"ai-plugin manifest"}}}},"/.well-known/skill-hub.json":{"get":{"summary":"Read ai-task-hub discovery document","operationId":"getSkillHubDiscoveryDocument","responses":{"200":{"description":"skill-hub discovery JSON"}}}},"/llms.txt":{"get":{"summary":"Read LLMs discovery text","operationId":"getLlmsDiscoveryText","responses":{"200":{"description":"llms.txt content"}}}},"/SKILL.md":{"get":{"summary":"Read site SKILL markdown","operationId":"getSiteSkillMarkdown","responses":{"200":{"description":"site SKILL.md markdown"}}}},"/connectors":{"get":{"summary":"Read connector install catalog page","operationId":"getConnectorCatalogPage","responses":{"200":{"description":"Connector install catalog"}}}},"/connectors/remote":{"get":{"summary":"Read hosted connector install guide","operationId":"getHostedConnectorInstallGuide","responses":{"200":{"description":"Hosted connector install guide"}}}},"/connectors/remote/manifest.json":{"get":{"summary":"Read hosted connector manifest","operationId":"getHostedConnectorManifest","responses":{"200":{"description":"Hosted connector manifest"}}}},"/agent/hosted-connector/install":{"post":{"summary":"Install a hosted connector connection","operationId":"installHostedConnectorConnection","responses":{"200":{"description":"Hosted connector install response"}}}},"/agent/hosted-connector/connect":{"post":{"summary":"Start or resume hosted connector browser authorization","operationId":"connectHostedConnectorConnection","responses":{"200":{"description":"Hosted connector connect response"}}}},"/agent/hosted-connector/invoke":{"post":{"summary":"Invoke the hosted connector runtime","operationId":"invokeHostedConnectorConnection","responses":{"200":{"description":"Hosted connector invoke response"}}}},"/agent/hosted-connector/status":{"post":{"summary":"Read hosted connector connection status","operationId":"getHostedConnectorConnectionStatus","responses":{"200":{"description":"Hosted connector status response"}}}},"/agent/hosted-connector/logout":{"post":{"summary":"Log out a hosted connector connection","operationId":"logoutHostedConnectorConnection","responses":{"200":{"description":"Hosted connector logout response"}}}},"/connectors/local-bootstrap":{"get":{"summary":"Read local bootstrap install guide","operationId":"getLocalBootstrapInstallGuide","responses":{"200":{"description":"Local bootstrap install guide"}}}},"/skills/manifest.json":{"get":{"summary":"Read skill manifest","operationId":"getSkillManifest","responses":{"200":{"description":"Skill manifest JSON"}}}},"/skills/SKILL.md":{"get":{"summary":"Read SKILL markdown","operationId":"getSkillMarkdown","responses":{"200":{"description":"SKILL.md markdown"}}}},"/agent/install-code/issue":{"post":{"summary":"Issue install code for first-time bootstrap","operationId":"issueInstallCode","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["channel"],"properties":{"channel":{"type":"string","enum":["local","clawhub"]},"owner_uid_hint":{"type":"string"}}}}}},"responses":{"201":{"description":"Install code issued"}}}},"/agent/bootstrap":{"post":{"summary":"Bootstrap agent account and receive api_key (install_code preferred)","operationId":"bootstrapAgentAccount","parameters":[{"name":"x-agent-signature","in":"header","required":false,"schema":{"type":"string"}},{"name":"x-agent-timestamp","in":"header","required":false,"schema":{"type":"string"}},{"name":"x-agent-source","in":"header","required":false,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["agent_uid","install_code"],"properties":{"agent_uid":{"type":"string"},"install_code":{"type":"string"}}},{"type":"object","required":["agent_uid","owner_uid"],"properties":{"agent_uid":{"type":"string"},"owner_uid":{"type":"string"}}}]}}}},"responses":{"201":{"description":"Bootstrap success"}}}},"/skill/execute":{"post":{"summary":"Submit unified async skill execution","operationId":"executeSkillRun","responses":{"202":{"description":"Skill run accepted"}}}},"/skill/runs/{run_id}":{"get":{"summary":"Poll unified skill run","operationId":"getSkillRun","responses":{"200":{"description":"Skill run status"}}}}},"x-skill-hub":{"api_base_url":"https://gateway-api.binaryworks.app","manifest_url":"https://gateway-api.binaryworks.app/skills/manifest.json","skill_markdown_url":"https://gateway-api.binaryworks.app/skills/SKILL.md","install_code_issue_url":"https://gateway-api.binaryworks.app/agent/install-code/issue","agent_read_this_first":["Do not mix connector lifecycle commands with published skill actions.","Connector lifecycle commands are host/runtime controls; published skill actions are the stable AI and account operations.","Default product path is connector-first and result-first; raw published skill actions remain compatibility or asset-delivery follow-up surfaces.","Public capability inventory below lists only enabled capabilities intentionally advertised to agents."],"interaction_layers":{"connector_lifecycle":{"purpose":"host/runtime installation and continuity controls","commands":["connect","status","invoke","logout"],"when_to_use":"Use only when the host is managing connector installation state or browser authorization continuity."},"published_skill_actions":{"purpose":"user-facing AI execution and account queries through the public bridge","actions":["portal.account.connect","portal.skill.execute","portal.skill.poll","portal.skill.presentation","portal.account.balance","portal.account.ledger"],"when_to_use":"Use for explicit account binding, AI task execution, follow-up poll or presentation only when the capability requires it, and points queries. Treat these as compatibility or follow-up surfaces, not a universal primary UX."}},"public_capability_families":[{"id":"image_analysis","title":"Image Analysis","capability_names":["Human Detect","Image Tagging","Face Detect","Body Keypoints 2D","Face Emotion Recognition"]},{"id":"background_removal","title":"Background Removal","capability_names":["Person Instance Segmentation","Person Semantic Segmentation","Concert Cutout","Full Body Matting","Head Matting","Product Cutout"]},{"id":"audio","title":"Audio","capability_names":["ASR","TTS Report","TTS Low Cost"]},{"id":"document","title":"Document","capability_names":["Markdown Convert"]},{"id":"retrieval","title":"Retrieval","capability_names":["Embeddings","Reranker"]},{"id":"generation","title":"Generation","capability_names":["Image Generation"]},{"id":"video","title":"Video","capability_names":["Video Face Generation"]}],"bootstrap_url":"https://gateway-api.binaryworks.app/agent/bootstrap","skill_execute_url":"https://gateway-api.binaryworks.app/skill/execute","skill_runs_url":"https://gateway-api.binaryworks.app/skill/runs/%7Brun_id%7D","agent_me_url":"https://gateway-api.binaryworks.app/agent/me","auth":{"type":"api_key","headers":["x-api-key","authorization: Bearer <api_key>"],"bootstrap_required_when_missing_key":true},"onboarding":{"first_step":"POST /agent/install-code/issue to receive install_code","api_key_path":"data.api_key","runtime_auth_headers":["x-api-key","authorization: Bearer <api_key>"]},"connectors":{"strategy":"connector_first","catalog_url":"https://gateway.binaryworks.app/connectors","remote":{"cta":"Add AI Task Hub Connector","guide_url":"https://gateway.binaryworks.app/connectors/remote","manifest_url":"https://gateway.binaryworks.app/connectors/remote/manifest.json","install_endpoint_url":"https://gateway-api.binaryworks.app/agent/hosted-connector/install","connect_endpoint_url":"https://gateway-api.binaryworks.app/agent/hosted-connector/connect","invoke_endpoint_url":"https://gateway-api.binaryworks.app/agent/hosted-connector/invoke","status_endpoint_url":"https://gateway-api.binaryworks.app/agent/hosted-connector/status","logout_endpoint_url":"https://gateway-api.binaryworks.app/agent/hosted-connector/logout","auth":{"type":"connection_token","header_name":"x-connector-token","connect_action":"portal.account.connect","browser_auth_only":true,"portal_connections_url":"https://gateway.binaryworks.app/portal/account/connections"},"supported_actions":["install","connect","invoke","status","logout"]},"local_bootstrap":{"cta":"One-command Bootstrap","guide_url":"https://gateway.binaryworks.app/connectors/local-bootstrap","bootstrap_command":"npx -y @binaryworks1024/ai-task-hub-connector@latest bootstrap --host <host_name> --check","data_dir_scope":"<host_data_dir>/binaryworks/ai-task-hub"},"published_skill_fallback":{"role":"fallback_only","skill_markdown_url":"https://gateway.binaryworks.app/SKILL.md"}},"bootstrap_signature_headers":{"x-agent-signature":"hex hmac_sha256(AGENT_BOOTSTRAP_SECRET, x-agent-timestamp + \".\" + raw_body)","x-agent-timestamp":"unix epoch seconds; must be inside AGENT_BOOTSTRAP_TTL_SECONDS window (default 300)","x-agent-source":"agent source id; must be included in AGENT_SOURCE_ALLOWLIST (or allow all with \"*\")"}}}