{"_id":"@01protocol/sdk","_rev":"2-4e585b189861a2d1613c5d57cfae2e1c","name":"@01protocol/sdk","dist-tags":{"latest":"0.2.0"},"versions":{"0.1.0":{"name":"@01protocol/sdk","version":"0.1.0","keywords":["ai-agent","identity","01-protocol","ed25519","cryptography","portable","agent-identity","open-standard"],"author":{"name":"01AI.ai","email":"info@01ai.ai"},"license":"MIT","_id":"@01protocol/sdk@0.1.0","maintainers":[{"name":"01ai-admin","email":"admin@01ai.ai"}],"homepage":"https://01ai.ai","bugs":{"url":"https://github.com/01ai-Admin/01ai_01protocol_mcp/issues"},"dist":{"shasum":"df779913a9d42cd7ff95109770510069082ed216","tarball":"https://registry.npmjs.org/@01protocol/sdk/-/sdk-0.1.0.tgz","fileCount":39,"integrity":"sha512-f1kQi9lY14ZuI9TSICjlbYGH1Q7iL7uATKQQTAnGztwALkClOmwDx82pAgKNKxUrtIHe1p5b8Z7W1NtVb7rCxw==","signatures":[{"sig":"MEYCIQCMJ1szr4tQnIueRuAXl+XNMA0+QqkJmHWp/ah7sfPB2wIhAP4KZbvwgmesxt1otD5HbrS5TPcIjZoQFgFv0LSoCK0l","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":73759},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"ea3cb51cc1bc8115badceedb91aa5f608c4a7e06","scripts":{"dev":"tsc --watch","test":"node --experimental-vm-modules node_modules/.bin/jest","build":"tsc"},"_npmUser":{"name":"01ai-admin","email":"admin@01ai.ai"},"repository":{"url":"git+https://github.com/01ai-Admin/01ai_01protocol_mcp.git","type":"git"},"_npmVersion":"11.9.0","description":"Official SDK for the 01 Protocol — portable, cryptographically verifiable AI agent identity","directories":{},"_nodeVersion":"25.6.1","dependencies":{"@noble/curves":"^1.4.0","@noble/hashes":"^1.4.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.9.3","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/sdk_0.1.0_1774424873962_0.7213744231488823","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@01protocol/sdk","version":"0.2.0","description":"Official SDK for the 01 Protocol — portable, cryptographically verifiable AI agent identity","type":"module","main":"./dist/index.js","types":"./dist/index.d.ts","exports":{".":{"import":"./dist/index.js","types":"./dist/index.d.ts"}},"scripts":{"build":"tsc","dev":"tsc --watch","test":"node --experimental-vm-modules node_modules/.bin/jest"},"keywords":["ai-agent","identity","01-protocol","ed25519","cryptography","portable","agent-identity","open-standard"],"author":{"name":"01AI.ai","email":"info@01ai.ai"},"license":"MIT","homepage":"https://01ai.ai","repository":{"type":"git","url":"git+https://github.com/01ai-Admin/01ai_01protocol_mcp.git"},"dependencies":{"@noble/curves":"^1.4.0","@noble/hashes":"^1.4.0"},"devDependencies":{"@types/node":"^25.5.0","typescript":"^5.9.3"},"engines":{"node":">=18.0.0"},"gitHead":"2cca96e40c56a9bc11dd28067558f23ba1168568","bugs":{"url":"https://github.com/01ai-Admin/01ai_01protocol_mcp/issues"},"_id":"@01protocol/sdk@0.2.0","_nodeVersion":"22.22.1","_npmVersion":"9.2.0","dist":{"integrity":"sha512-MPiW8vZeMrYJQsGc41HbXazBA4H+J8oEiqhVZMq6MZyxRsE5VxzQsmD40x2UIYZtAO8HteiaECzK7DUYPJFk/A==","shasum":"9a04c9858ec67d26359fdeda1c5bfbec678d145a","tarball":"https://registry.npmjs.org/@01protocol/sdk/-/sdk-0.2.0.tgz","fileCount":43,"unpackedSize":100746,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIAO5DPFp71O6RW3C4xd/UBmBlaWSfQ4B3Ca6KBUW7/9fAiEAnF4uZQIbaYq6lWKtOBZathx6Wca1Eoa5vSPUnRhRIP0="}]},"_npmUser":{"name":"01ai-admin","email":"admin@01ai.ai"},"directories":{},"maintainers":[{"name":"01ai-admin","email":"admin@01ai.ai"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/sdk_0.2.0_1775734346533_0.05691142169617325"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-25T07:47:53.847Z","modified":"2026-04-09T11:32:26.828Z","0.1.0":"2026-03-25T07:47:54.102Z","0.2.0":"2026-04-09T11:32:26.673Z"},"bugs":{"url":"https://github.com/01ai-Admin/01ai_01protocol_mcp/issues"},"author":{"name":"01AI.ai","email":"info@01ai.ai"},"license":"MIT","homepage":"https://01ai.ai","keywords":["ai-agent","identity","01-protocol","ed25519","cryptography","portable","agent-identity","open-standard"],"repository":{"type":"git","url":"git+https://github.com/01ai-Admin/01ai_01protocol_mcp.git"},"description":"Official SDK for the 01 Protocol — portable, cryptographically verifiable AI agent identity","maintainers":[{"name":"01ai-admin","email":"admin@01ai.ai"}],"readme":"# @01protocol/sdk\n\nOfficial JavaScript/TypeScript SDK for the [01 Protocol](https://01ai.ai) — portable, cryptographically verifiable AI agent identity.\n\n## Install\n\n```bash\nnpm install @01protocol/sdk\n```\n\n> **Note:** Until the npm package is published, install directly from GitHub:\n> ```bash\n> npm install github:01ai-Admin/01ai_01protocol_mcp#v0.1.0\n> ```\n\n## Quick Start\n\n```typescript\nimport { createAgent, verifyFromText } from \"@01protocol/sdk\";\n\n// Create a new agent identity\nconst result = createAgent({\n  name: \"Sales Analyst\",\n  role: \"Data Analyst\",\n  goal: \"Analyze quarterly sales data and surface insights\",\n});\n\nconsole.log(\"Agent ID:\", result.agent.instanceId);\nconsole.log(\"SAVE THIS KEY:\", result.privateKeyHex); // shown once\n\n// Verify a .01ai file\nimport { readFileSync } from \"node:fs\";\nconst text = readFileSync(\"agent.01ai\", \"utf-8\");\nconst verified = verifyFromText(text);\n\nif (verified.valid) {\n  console.log(\"✅ PASS:\", verified.agent.name);\n} else {\n  console.log(\"❌ FAIL:\", verified.error);\n}\n```\n\n## With Memory Vault\n\n```typescript\nconst result = createAgent({\n  name: \"Research Agent\",\n  role: \"Research Analyst\",\n  goal: \"Synthesize academic papers into actionable insights\",\n  includeMemory: true, // produces .01bundle\n});\n// result.bundle contains identity + memory vault\n```\n\n## Add Memory to Existing Agent\n\n```typescript\nimport { addMemoryEntry, computeVaultMerkleRoot, resignAgent } from \"@01protocol/sdk\";\n\nconst updatedVault = addMemoryEntry(vault, {\n  instanceId: agent.instanceId,\n  layer: \"persistent-vault\",\n  type: \"decision\",\n  summary: \"Chose PostgreSQL over MongoDB for the reporting module\",\n  tags: [\"architecture\", \"database\"],\n});\n\nconst merkleRoot = computeVaultMerkleRoot(updatedVault);\nconst updatedAgent = resignAgent(agent, privateKeyHex, { memoryMerkleRoot: merkleRoot });\n```\n\n## API\n\n| Function | Description |\n|---|---|\n| `createAgent(params)` | Mint a new agent identity with Ed25519 keypair |\n| `verifyFromText(text)` | Parse + verify a `.01ai` file from raw string |\n| `verifyAgentRecord(obj)` | Verify a pre-parsed agent object |\n| `resignAgent(agent, key, updates)` | Re-sign after updates, increments evolutionCounter |\n| `addMemoryEntry(vault, entry)` | Add a memory entry to a vault |\n| `computeVaultMerkleRoot(vault)` | Compute SHA-256 Merkle root of vault contents |\n| `createPortableBundle(agent, vault)` | Combine identity + vault into `.01bundle` |\n\n## Protocol\n\n- **Signing**: Ed25519 via [@noble/curves](https://github.com/paulmillr/noble-curves)\n- **Hashing**: SHA-256 via [@noble/hashes](https://github.com/paulmillr/noble-hashes)\n- **Format**: `.01ai` (identity only) or `.01bundle` (identity + memory)\n- **Offline-first**: Zero network calls for verification\n- **Patent**: US Provisional Patent pending\n\n## Links\n\n- [01AI.ai](https://01ai.ai) — Main site\n- [app.01ai.ai](https://app.01ai.ai) — Web app\n- [GitHub](https://github.com/01ai-Admin/01ai_01protocol_mcp) — Spec and source\n- [Developers](https://01ai.ai/developers) — Full documentation\n\n## License\n\nMIT — see [LICENSE](../../LICENSE)\n","readmeFilename":"README.md"}