{"title":"AHCP Transport Bindings","version":"1.0.0","description":"How AHCP commands are exposed to agents. Shape is stable; transport is interchangeable.","bindings":[{"kind":"builtin","id":"agentos-x-builtin-tool","description":"Host tool executor (AgentOS X ConversationAutonomy tool_calls).","invoke":{"shape":{"tool_name":"<command.id>","args":"<command.input_schema instance>"},"result":"AHCP result envelope (see errors.json result_envelope) or host legacy {status, output, error}"},"example":{"tool_name":"chrome.nav.open_url","args":{"url":"https://example.com"}}},{"kind":"mcp","id":"mcp.tools_call","description":"MCP tools/call where each AHCP command is one MCP tool.","invoke":{"method":"tools/call","params":{"name":"<command.id>","arguments":"<args>","_meta":{"agentnet":{"agin":"<agent identity card fields — see agent-web entrance>","call_id":"<uuid>"}}}},"example":{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"chrome.bookmark.add","arguments":{"title":"Example","url":"https://example.com"},"_meta":{"agentnet":{"agin_id":"agin_example_public_id","agent_principal":"agent:example","call_id":"call_01HZXAMPLE"}}}}},{"kind":"http","id":"http.ahcp.v1","description":"Optional HTTP binding for remote hosts.","invoke":{"method":"POST","path":"/ahcp/v1/commands/{command_id}","headers":{"content-type":"application/json","x-agentnet-agin-id":"<agin id>","x-agentnet-call-id":"<call id>"},"body":{"args":{}}},"example_request":{"method":"POST","url":"https://host.example/ahcp/v1/commands/chrome.tab.list","headers":{"content-type":"application/json","x-agentnet-agin-id":"agin_example_public_id","x-agentnet-call-id":"call_01HZXAMPLE"},"body":{"args":{}}},"example_response":{"command_id":"chrome.tab.list","ok":true,"code":"ahcp.ok","output":{"tabs":[],"count":0}}},{"kind":"cli","id":"cli.ahcp","description":"CLI binding for operators and scripts.","invoke":{"argv":["ahcp","call","<command.id>","--args","<json>"]},"example":"ahcp call chrome.history.search --args '{\"query\":\"invoice\"}'"}],"discovery":{"surface_uri":"/ahcp/v1/surface.json","description":"Hosts SHOULD publish the active ahcp.surface package at a stable URI for agents to discover commands."}}