{"_id":"@agora-protocol/sdk","_rev":"3-f26448839659bafca45f763566205bb8","name":"@agora-protocol/sdk","dist-tags":{"latest":"0.3.3"},"versions":{"0.3.1":{"name":"@agora-protocol/sdk","version":"0.3.1","keywords":["acp","agent","protocol","ai-agents","sdk"],"author":{"name":"ACP Protocol Contributors"},"license":"MIT","_id":"@agora-protocol/sdk@0.3.1","maintainers":[{"name":"mscarlos107","email":"mscarlos107@gmail.com"}],"homepage":"https://github.com/mscarlos107/acp-protocol#readme","bugs":{"url":"https://github.com/mscarlos107/acp-protocol/issues"},"dist":{"shasum":"4c7d759b72e303c8c3b3c8ed11368b9da491400d","tarball":"https://registry.npmjs.org/@agora-protocol/sdk/-/sdk-0.3.1.tgz","fileCount":5,"integrity":"sha512-VU9VSeL8YNwUKwddFw1G4Ift4CApcSXSKDGLVMxdDUhtjQGXox4t4wLdx6f1qp4clooSm2zPuPV6oeB8unx43Q==","signatures":[{"sig":"MEYCIQD6eldDRr6UtrPZZnWr9aTUaI1My8a43bfFR7G6hwSkgQIhAPRhp/7baO2a2Mt4A4U4YgWxffpYtn3saBEu9y2Dj27V","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":45982},"main":"./dist/index.js","type":"module","_from":"file:agora-protocol-sdk-0.3.1.tgz","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","default":"./dist/index.js"}},"scripts":{"build":"tsup src/index.ts --format esm --dts","clean":"rm -rf dist","typecheck":"tsc --noEmit"},"_npmUser":{"name":"mscarlos107","email":"mscarlos107@gmail.com"},"_resolved":"C:\\Users\\mscar\\AppData\\Local\\Temp\\0a8c039ef745c9d1c1d15229f8d7ea2e\\agora-protocol-sdk-0.3.1.tgz","_integrity":"sha512-VU9VSeL8YNwUKwddFw1G4Ift4CApcSXSKDGLVMxdDUhtjQGXox4t4wLdx6f1qp4clooSm2zPuPV6oeB8unx43Q==","repository":{"url":"git+https://github.com/mscarlos107/acp-protocol.git","type":"git","directory":"packages/sdk"},"_npmVersion":"11.6.2","description":"ACP SDK: public API re-exporting all @agora-protocol/* modules + ACPRoom and ACPClient facades","directories":{},"_nodeVersion":"24.11.1","dependencies":{"@agora-protocol/core":"0.3.1","@agora-protocol/crypto":"0.3.1","@agora-protocol/gateway":"0.3.1","@agora-protocol/sandbox":"0.3.1","@agora-protocol/session":"0.3.1","@agora-protocol/registry":"0.3.1","@agora-protocol/transport":"0.3.1","@agora-protocol/extensions":"0.3.1","@agora-protocol/reputation":"0.3.1","@agora-protocol/room-engine":"0.3.1","@agora-protocol/observability":"0.3.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"ws":"^8.18.0","tsup":"^8.5.0","@types/ws":"^8.5.13","typescript":"^5.8.3"},"_npmOperationalInternal":{"tmp":"tmp/sdk_0.3.1_1777469022002_0.9392879327674639","host":"s3://npm-registry-packages-npm-production"}},"0.3.2":{"name":"@agora-protocol/sdk","version":"0.3.2","keywords":["acp","agent","protocol","ai-agents","sdk"],"author":{"name":"ACP Protocol Contributors"},"license":"MIT","_id":"@agora-protocol/sdk@0.3.2","maintainers":[{"name":"mscarlos107","email":"mscarlos107@gmail.com"}],"homepage":"https://github.com/mscarlos107/acp-protocol#readme","bugs":{"url":"https://github.com/mscarlos107/acp-protocol/issues"},"bin":{"acp-showcase":"examples/showcase.mjs"},"dist":{"shasum":"118693023338a0f09f6357fe61f216cfded20384","tarball":"https://registry.npmjs.org/@agora-protocol/sdk/-/sdk-0.3.2.tgz","fileCount":6,"integrity":"sha512-QsXfL7JZ55b7RcRMR5cLjJmGE1v7VQWldNX0sysaCYt2TH60RcYrFZi9hanVFUFEyQ4LzWXAZ83I2FUdaxpWPg==","signatures":[{"sig":"MEYCIQDn1VAsRs5Ktna7gm5/L6lfXhKaG+083A1mvwu1WgEILgIhAOBQKX9fEquK6thKMZwhkNaK1t+L3PxbQkCBur6wHwOM","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":54607},"main":"./dist/index.js","type":"module","_from":"file:agora-protocol-sdk-0.3.2.tgz","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","default":"./dist/index.js"}},"scripts":{"build":"tsup src/index.ts --format esm --dts","clean":"rm -rf dist","typecheck":"tsc --noEmit"},"_npmUser":{"name":"mscarlos107","email":"mscarlos107@gmail.com"},"_resolved":"C:\\Users\\mscar\\AppData\\Local\\Temp\\57ae7ee0217b91efca36a23349adacb4\\agora-protocol-sdk-0.3.2.tgz","_integrity":"sha512-QsXfL7JZ55b7RcRMR5cLjJmGE1v7VQWldNX0sysaCYt2TH60RcYrFZi9hanVFUFEyQ4LzWXAZ83I2FUdaxpWPg==","repository":{"url":"git+https://github.com/mscarlos107/acp-protocol.git","type":"git","directory":"packages/sdk"},"_npmVersion":"11.6.2","description":"ACP SDK: public API re-exporting all @agora-protocol/* modules + ACPRoom and ACPClient facades + createInProcessPair helper","directories":{},"_nodeVersion":"24.11.1","dependencies":{"@agora-protocol/core":"0.3.2","@agora-protocol/crypto":"0.3.2","@agora-protocol/gateway":"0.3.2","@agora-protocol/sandbox":"0.3.2","@agora-protocol/session":"0.3.2","@agora-protocol/registry":"0.3.2","@agora-protocol/transport":"0.3.2","@agora-protocol/extensions":"0.3.2","@agora-protocol/reputation":"0.3.2","@agora-protocol/room-engine":"0.3.2","@agora-protocol/observability":"0.3.2"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"ws":"^8.18.0","tsup":"^8.5.0","@types/ws":"^8.5.13","typescript":"^5.8.3"},"_npmOperationalInternal":{"tmp":"tmp/sdk_0.3.2_1777740053206_0.6866838292432722","host":"s3://npm-registry-packages-npm-production"}},"0.3.3":{"name":"@agora-protocol/sdk","version":"0.3.3","description":"ACP SDK: public API re-exporting all @agora-protocol/* modules + ACPRoom and ACPClient facades + createInProcessPair helper + acp-showcase / acp-ws-pair runnable bin demos","keywords":["acp","agent","protocol","ai-agents","sdk"],"homepage":"https://github.com/mscarlos107/acp-protocol#readme","bugs":{"url":"https://github.com/mscarlos107/acp-protocol/issues"},"repository":{"type":"git","url":"git+https://github.com/mscarlos107/acp-protocol.git","directory":"packages/sdk"},"license":"MIT","author":{"name":"ACP Protocol Contributors"},"type":"module","main":"./dist/index.js","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","default":"./dist/index.js"}},"bin":{"acp-showcase":"examples/showcase.mjs","acp-ws-pair":"examples/ws-pair.mjs"},"publishConfig":{"access":"public"},"dependencies":{"@agora-protocol/core":"0.3.3","@agora-protocol/crypto":"0.3.3","@agora-protocol/room-engine":"0.3.3","@agora-protocol/transport":"0.3.3","@agora-protocol/session":"0.3.3","@agora-protocol/gateway":"0.3.3","@agora-protocol/registry":"0.3.3","@agora-protocol/reputation":"0.3.3","@agora-protocol/observability":"0.3.3","@agora-protocol/sandbox":"0.3.3","@agora-protocol/extensions":"0.3.3"},"devDependencies":{"@types/ws":"^8.5.13","tsup":"^8.5.0","typescript":"^5.8.3","ws":"^8.18.0"},"scripts":{"build":"tsup src/index.ts --format esm --dts","typecheck":"tsc --noEmit","clean":"rm -rf dist"},"_id":"@agora-protocol/sdk@0.3.3","_integrity":"sha512-ag2erc2aErgEDVgHEXvdvzPohPm4xzg7sEbcAIiMUkBTWNv/lftAqwnvmOx2C0Gsmj/08CptB3PfUzaVRr9uIg==","_resolved":"C:\\Users\\mscar\\AppData\\Local\\Temp\\03053489e0324cfd1ff69bb60f9927fe\\agora-protocol-sdk-0.3.3.tgz","_from":"file:agora-protocol-sdk-0.3.3.tgz","_nodeVersion":"24.11.1","_npmVersion":"11.6.2","dist":{"integrity":"sha512-ag2erc2aErgEDVgHEXvdvzPohPm4xzg7sEbcAIiMUkBTWNv/lftAqwnvmOx2C0Gsmj/08CptB3PfUzaVRr9uIg==","shasum":"573649ee061ac638e21f7a6c97ce32f93dcbb1e7","tarball":"https://registry.npmjs.org/@agora-protocol/sdk/-/sdk-0.3.3.tgz","fileCount":7,"unpackedSize":67344,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIGI1MfWaRKjeCIEI2604O48jDGOU6Gsh5rNO5SSS2hbAAiEAtbZsHBRhQE0B5kBMHskaAf/C/rZumSiMyUQQrfNSZj4="}]},"_npmUser":{"name":"mscarlos107","email":"mscarlos107@gmail.com"},"directories":{},"maintainers":[{"name":"mscarlos107","email":"mscarlos107@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/sdk_0.3.3_1778072968498_0.3984373673379462"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-29T13:23:41.904Z","modified":"2026-05-06T13:09:28.781Z","0.3.1":"2026-04-29T13:23:42.152Z","0.3.2":"2026-05-02T16:40:53.366Z","0.3.3":"2026-05-06T13:09:28.651Z"},"bugs":{"url":"https://github.com/mscarlos107/acp-protocol/issues"},"author":{"name":"ACP Protocol Contributors"},"license":"MIT","homepage":"https://github.com/mscarlos107/acp-protocol#readme","keywords":["acp","agent","protocol","ai-agents","sdk"],"repository":{"type":"git","url":"git+https://github.com/mscarlos107/acp-protocol.git","directory":"packages/sdk"},"description":"ACP SDK: public API re-exporting all @agora-protocol/* modules + ACPRoom and ACPClient facades + createInProcessPair helper + acp-showcase / acp-ws-pair runnable bin demos","maintainers":[{"name":"mscarlos107","email":"mscarlos107@gmail.com"}],"readme":"# @agora-protocol/sdk\n\nOne-stop SDK for the [ACP Protocol](https://github.com/mscarlos107/acp-protocol) v0.3 — the universal conversation layer for AI agent communication. Re-exports every `@agora-protocol/*` module plus the `ACPRoom` and `ACPClient` facades.\n\n## Install\n\n```bash\nnpm install @agora-protocol/sdk\n```\n\n## Quick start (two-agent room in-process)\n\n```ts\nimport { randomUUID } from \"node:crypto\";\nimport {\n  ACPRoom,\n  CORE_INTENTS,\n  generateEd25519KeyPair,\n  InMemorySyncTransport,\n  type RoomInstance,\n} from \"@agora-protocol/sdk\";\n\nconst alice = generateEd25519KeyPair();\nconst bob = generateEd25519KeyPair();\n\nconst room: RoomInstance = {\n  room_id: randomUUID(),\n  config: {\n    type: \"1:1\",\n    mode: \"sync\",\n    privacy_level: \"open\",\n    language: \"en\",\n    max_turns: 10,\n    extensions: [],\n  },\n  rules: {\n    structured_layer_required: true,\n    allowed_intents: [...CORE_INTENTS],\n    max_turns: 10,\n    turn_timeout_seconds: 300,\n    max_natural_length_chars: 2000,\n    language_preference: \"en\",\n    privacy_level: \"open\",\n    mode: \"sync\",\n    compaction_interval_turns: 15,\n    active_extensions: [],\n  },\n  state: \"active\",\n  participants: [\"alice:org\", \"bob:org\"],\n  created_at: new Date().toISOString(),\n};\n\nconst aliceRoom = new ACPRoom({\n  room,\n  agentId: \"alice:org\",\n  privateKey: alice.privateKey,\n  peerPublicKey: bob.publicKey,\n});\nconst bobRoom = new ACPRoom({\n  room,\n  agentId: \"bob:org\",\n  privateKey: bob.privateKey,\n  peerPublicKey: alice.publicKey,\n});\n\nconst [tA, tB] = InMemorySyncTransport.createPair();\naliceRoom.attachTransport(tA);\nbobRoom.attachTransport(tB);\n\nconst sent = aliceRoom.send(\"Hi Bob — quote for 5000 units please.\", {\n  intent: \"proposal\",\n  requires_response: true,\n});\nif (\"error\" in sent) throw new Error(sent.error);\n```\n\n## What's inside\n\n- **`ACPRoom`** — high-level facade over `RoomController` with transport attachment and event wiring.\n- **`ACPClient`** — agent-level wrapper that owns a keypair, manages multiple rooms, and exposes discovery.\n- Re-exports from **`@agora-protocol/core`**, **`@agora-protocol/crypto`**, **`@agora-protocol/room-engine`**, **`@agora-protocol/session`**, **`@agora-protocol/transport`**, **`@agora-protocol/registry`**, **`@agora-protocol/gateway`**, **`@agora-protocol/reputation`**, **`@agora-protocol/observability`**, **`@agora-protocol/extensions`**, **`@agora-protocol/sandbox`**.\n\n## Runnable examples\n\nThe monorepo ships several real-LLM and transport demos under `packages/sdk/examples/`:\n\n- `quickstart-verify.ts` — minimal in-process two-agent room with hash-chain verification (no LLM, no network).\n- `conformance-demo.ts` — runs the conformance suite, writes an `ACP Compliant` certificate.\n- `cli-bridge.ts` — two Claude-backed agents negotiating via in-process rooms.\n- `tri-party-bridge.ts` — three participants, agreements + partial-accept.\n- `python-auditor-bridge.ts` — **cross-language 3-party negotiation** (TypeScript buyer + seller + Python+LangChain auditor signed via delegated key).\n- `full-negotiation.ts` — full ACP flow (discovery → handshake → room → agreement → close).\n- `remote-bridge/` — `ws://` and `http://` 2-process bridges with MITM / netdown / replay / split-brain injectors.\n- `gateway-demo/` — non-ACP external agent bridged via the Gateway.\n- `production-e2e/` — **2-container Docker harness with TLS end-to-end and configurable soak (448 rounds, 0 failures in the archived run).**\n\n## Certify your implementation\n\n```bash\npnpm exec tsx packages/sdk/examples/conformance-demo.ts\n# writes run-conformance-<timestamp>.{json,md} to examples/e2e-workspaces/\n```\n\n## License\n\nMIT\n","readmeFilename":"README.md"}