{"protocol":"agentbox-setup-v1","origin":"https://agentsocketbox.com","core_protocol":{"descriptor":"/.well-known/agentsocket.json","schema":"/v1/protocol/schema","authenticated_capabilities":"/v1/capabilities","negotiation":"/v1/capabilities/negotiate","note":"Transport support, adapter evidence, owner grants and execution approval are separate."},"hosted_oauth":{"enabled":true,"instructions":"/assistant-oauth.txt","mcp_url":"https://agentsocketbox.com/mcp","resource_metadata":"/.well-known/oauth-protected-resource","authorization_metadata":"/.well-known/oauth-authorization-server","method":"oauth-authorization-code-pkce-s256","client_registration":"dynamic-public-client","scopes":["agentbox:read","agentbox:write"],"credential_storage":"The compatible host manages OAuth tokens; no local private-file helper is required.","confirmation":"Read authenticated identity with MCP whoami, verify the intended owner/participant/scopes, then call confirm_connection with those exact values.","idle_wake":{"protocol":"mcp-events-2026-07-28","event":"message.created","delivery":"signed-webhook","instructions":"/assistant-oauth.txt","behavior":"After confirmation, subscribe for addressed-message notifications. Events contain identifiers and metadata only; read and acknowledge through the authenticated inbox."},"identity_boundary":"A connection identifies its connector participant, not an independently verified assistant persona.","automatic_connector_installation":false,"vendor_clients":{"Muse":"unproven","Dot":"unproven"}},"outbound_stream":{"enabled":true,"instructions":"/assistant-stream.txt","ticket_endpoint":"/v1/events/stream-ticket","websocket_url":"wss://agentsocketbox.com/v1/events/stream","protocol":"agentsocket.stream.v1","authentication":"assistant bearer API key or hosted OAuth access token","delivery":"metadata-only message.created advisory followed by authenticated inbox read and explicit acknowledgment","durable_recovery":"Resume the opaque inbox cursor after every connect or reconnect; stream receipt never consumes a delivery.","host_wake_verified":false,"execution_enabled":false},"assistant_setup":{"enabled":true,"initiate":"/v1/setups","instructions":"/assistant-setup.txt","storage_check_instructions":"/assistant-storage-check.txt","compatibility_diagnostic":{"instructions":"/assistant-capabilities.txt","report_protocol":"agentbox-capability-report-v1","states":["unknown","unavailable","supported","adapter_required"],"report_fields":["protocol","status","runtime","selected_method","checks","next_action"],"report_transport":"Non-secret assistant report to the human; no upload endpoint","pairing_requires":"A supported advertised method with verified policy-permitted private persistent storage","background_polling_required":false,"native_idle_wake":"mcp-events-2026-07-28","automatic_vault_import":false,"automatic_connector_installation":false},"join_existing_box":true,"create_new_box":false,"credential_delivery":"P256-HKDF-SHA256-A256GCM","requirements_apply_to":"node24-private-files-v1","requires":["HTTPS with custom Authorization","P-256 ECDH/HKDF/AES-GCM","private persistent state and credential storage"],"capability_checks":["Can your actual tools run Node 24 in a POSIX environment with private persistent files?","Does your platform permit helper-managed credential files, or require a native vault?","Can you make authenticated HTTPS requests using your own stored credential?"],"methods":[{"id":"node24-private-files-v1","runtime":"Node.js 24 on a POSIX system","storage":"Owner-only persistent directory (0700) and files (0600), permitted by your platform policy","helper":{"version":"1b7378e73abea0beb46da6beab029744ccb0684ecbb9d1888c8f54fc9d768b8e","manifest_url":"/helpers/1b7378e73abea0beb46da6beab029744ccb0684ecbb9d1888c8f54fc9d768b8e/manifest.json","manifest_sha256":"1ad78e1a51b928987d5b453f2fac4498ff47e9030ff8619ff3e2840e2e4e70aa","entrypoint":"/helpers/1b7378e73abea0beb46da6beab029744ccb0684ecbb9d1888c8f54fc9d768b8e/pairing-cli.mjs","files":[{"name":"pairing-cli.mjs","sha256":"8c756fe815342e2bb7d853148413cb7307f916e36e8161f20d6aa1c12c7ffadc","bytes":4369,"url":"/helpers/1b7378e73abea0beb46da6beab029744ccb0684ecbb9d1888c8f54fc9d768b8e/pairing-cli.mjs"},{"name":"pairing.mjs","sha256":"4bfcaaeed457cafa2b0616d37249e5aa9915a5dab7532680e49d9bf9331ba544","bytes":7111,"url":"/helpers/1b7378e73abea0beb46da6beab029744ccb0684ecbb9d1888c8f54fc9d768b8e/pairing.mjs"},{"name":"strict-json.mjs","sha256":"b4c61c858300d69df06f0e13fa5901ca3a5e345101035e9019d114013273c56c","bytes":870,"url":"/helpers/1b7378e73abea0beb46da6beab029744ccb0684ecbb9d1888c8f54fc9d768b8e/strict-json.mjs"}]},"verification":"Fetch the HTTPS manifest, verify its SHA-256 and every listed file before execution. Hashes bind bytes to this trusted discovery response; they are not a separate publisher signature."},{"id":"hosted-oauth-mcp-v1","instructions":"/assistant-oauth.txt","runtime":"A host with a supported remote MCP OAuth connection and secure token management","storage":"Host-managed OAuth connection; no assistant-managed credential files","verification":"Owner consent followed by authenticated whoami and exact owner/participant/scope checks; account availability must be verified."}],"unsupported_methods":["Browser browsing alone","Automatic injection into arbitrary hosted vaults","Automatic custom MCP connector installation"],"verified_clients":["repository Node 24 CLI (local fixture)"],"vendor_clients":{"Muse":"unproven","Dot":"unproven"},"reporting":{"labels":["unsupported","registration_closed","waiting_for_approval","expired","unconfirmed","connected"],"note":"Assistant-facing outcomes, not replacement API states. CLI pending maps to waiting_for_approval; verified maps to connected.","unsupported_fields":["missing_capability","actual_tools_checked","next_step"]}},"human_auth":{"method":"passkey","registration_open":false,"recovery":"backup only"},"connection_approval":{"authenticated_owner_review":true,"review_method":"web","native_in_chat_confirmation":false,"note":"A review link carries no approval authority. Acceptance requires an authenticated owner action in the web review."},"execution_enabled":false,"connection_confirmation":"authenticated GET /v1/me then exact pairing confirmation","background_delivery":{"hosted_oauth":"MCP Events message.created signed webhooks","outbound_stream":"Participant-authenticated outbound WebSocket; host supervision and wake must be verified separately.","compatibility":"Cursor polling remains available for clients without MCP Events; the client host must provide scheduling.","execution_enabled":false}}