{"_id":"@cognitum-one/sdk","_rev":"4-d4737b7c7dbb150c633a1fcf3dfe2d28","name":"@cognitum-one/sdk","dist-tags":{"latest":"0.3.0"},"versions":{"0.2.1":{"name":"@cognitum-one/sdk","version":"0.2.1","keywords":["cognitum","ai","mcp","sdk","seed"],"license":"MIT","_id":"@cognitum-one/sdk@0.2.1","maintainers":[{"name":"ruvnet","email":"ruv@ruv.net"}],"bin":{"cognitum":"dist/cli.mjs","cognitum-sdk":"dist/cli.mjs"},"dist":{"shasum":"837f05c3af9d9087e89d9c85f41b82f3483be230","tarball":"https://registry.npmjs.org/@cognitum-one/sdk/-/sdk-0.2.1.tgz","fileCount":23,"integrity":"sha512-ZIYKq6Tqc7zcDQRSrxphm0Uji497Mf1bi7azn2aTM4F0k+IEdPpTmAngGVaXX/hR7DYhOQ5gkUCja0DiOJLOJw==","signatures":[{"sig":"MEYCIQC1gishyMm+EeXqmi9iJKiFxx13xhzeLxRwuDsJAIXBVgIhAJG4ssl3XjyUbG+JmBVpjwmblV7gswx7MJgXpUEmWhbS","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":807404},"main":"./dist/index.cjs","type":"module","types":"./dist/index.d.ts","module":"./dist/index.js","engines":{"node":">=18"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","require":"./dist/index.cjs"},"./seed":{"types":"./dist/seed/index.d.ts","import":"./dist/seed/index.js","require":"./dist/seed/index.cjs"},"./seed/discovery/mdns":{"types":"./dist/seed/discovery/mdns.d.ts","import":"./dist/seed/discovery/mdns.js","require":"./dist/seed/discovery/mdns.cjs"}},"gitHead":"244b3456ec7c7e8289640b00196bfb8c50c9575a","scripts":{"test":"vitest run","build":"tsup","typecheck":"tsc --noEmit"},"_npmUser":{"name":"ruvnet","email":"ruv@ruv.net"},"_npmVersion":"9.8.1","description":"Official Cognitum SDK for Node.js and TypeScript","directories":{},"_nodeVersion":"22.21.1","dependencies":{"undici":"^6.0.0"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.0.0","vitest":"^2.0.0","typescript":"^5.4.0","@types/node":"^25.6.0"},"peerDependencies":{"multicast-dns":"^7.2.5"},"peerDependenciesMeta":{"multicast-dns":{"optional":true}},"_npmOperationalInternal":{"tmp":"tmp/sdk_0.2.1_1777485654919_0.5201450060494563","host":"s3://npm-registry-packages-npm-production"}},"0.3.0":{"name":"@cognitum-one/sdk","version":"0.3.0","keywords":["cognitum","ai","mcp","sdk","seed"],"license":"MIT","_id":"@cognitum-one/sdk@0.3.0","maintainers":[{"name":"ruvnet","email":"ruv@ruv.net"},{"name":"shaal","email":"shaalofer@gmail.com"}],"bin":{"cognitum":"dist/cli.mjs","cognitum-sdk":"dist/cli.mjs"},"dist":{"shasum":"25843f00804fe97e0c0ef217392a0b251c8b2c7d","tarball":"https://registry.npmjs.org/@cognitum-one/sdk/-/sdk-0.3.0.tgz","fileCount":59,"integrity":"sha512-LohbTitIwYkhSp+CQe63K+rDgXXWxI3wTSp8QfczsRWfal8FA8KeecFUPRjMLG2ZNSL8aPRIK9SM/hQSjC9eyQ==","signatures":[{"sig":"MEUCIH15IPMHFqaWS27qwSqPNKEpX56V9v6KtZYIBKalrMQ0AiEAm1l6jSw4ze5yNdNenK9qAbw87L5EUq70T3PfTK+qGGA=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":3578994},"main":"./dist/index.cjs","type":"module","types":"./dist/index.d.ts","module":"./dist/index.js","engines":{"node":">=18"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","require":"./dist/index.cjs"},"./sse":{"types":"./dist/sse/index.d.ts","import":"./dist/sse/index.js","require":"./dist/sse/index.cjs"},"./seed":{"types":"./dist/seed/index.d.ts","import":"./dist/seed/index.js","require":"./dist/seed/index.cjs"},"./agentic":{"types":"./dist/agentic/index.d.ts","import":"./dist/agentic/index.js","require":"./dist/agentic/index.cjs"},"./meta-llm":{"types":"./dist/meta-llm/index.d.ts","import":"./dist/meta-llm/index.js","require":"./dist/meta-llm/index.cjs"},"./harnessaas":{"types":"./dist/harnessaas/index.d.ts","import":"./dist/harnessaas/index.js","require":"./dist/harnessaas/index.cjs"},"./meta-proxy":{"types":"./dist/meta-proxy/index.d.ts","import":"./dist/meta-proxy/index.js","require":"./dist/meta-proxy/index.cjs"},"./metaharness":{"types":"./dist/metaharness/index.d.ts","import":"./dist/metaharness/index.js","require":"./dist/metaharness/index.cjs"},"./seed/discovery/mdns":{"types":"./dist/seed/discovery/mdns.d.ts","import":"./dist/seed/discovery/mdns.js","require":"./dist/seed/discovery/mdns.cjs"}},"gitHead":"b3f8b93bb6d33825228f1d8a553fb35c08f4545c","scripts":{"lint":"eslint src tests","test":"vitest run","build":"tsup","typecheck":"tsc --noEmit"},"_npmUser":{"name":"ruvnet","email":"ruv@ruv.net"},"_npmVersion":"10.9.7","description":"Official Cognitum SDK for Node.js and TypeScript","directories":{},"_nodeVersion":"22.22.2","dependencies":{"undici":"^6.0.0"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.0.0","eslint":"9.39.5","vitest":"^3.2.6","@eslint/js":"9.39.5","typescript":"^5.4.0","@types/node":"^25.6.0","typescript-eslint":"8.64.0"},"peerDependencies":{"multicast-dns":"^7.2.5"},"peerDependenciesMeta":{"multicast-dns":{"optional":true}},"_npmOperationalInternal":{"tmp":"tmp/sdk_0.3.0_1784481342845_0.5135531777079061","host":"s3://npm-registry-packages-npm-production"}}},"time":{"created":"2026-04-29T18:00:54.681Z","modified":"2026-07-31T15:10:37.296Z","0.2.1":"2026-04-29T18:00:55.145Z","0.3.0":"2026-07-19T17:15:43.050Z"},"license":"MIT","keywords":["cognitum","ai","mcp","sdk","seed"],"description":"Official Cognitum SDK for Node.js and TypeScript","maintainers":[{"email":"ruv@ruv.net","name":"ruvnet"},{"email":"shaalofer@gmail.com","name":"shaal"},{"email":"spiridonovdragan@gmail.com","name":"proffesor-for-testing"}],"readme":"# @cognitum-one/sdk\n\nOfficial [Cognitum](https://cognitum.one) SDK for Node.js and TypeScript.\n\nTalk to a **Cognitum Seed** appliance (direct, over mDNS / USB gadget / LAN)\nor the **Cognitum Cloud** control plane (`api.cognitum.one`).\n\n## Install\n\n```bash\nnpm install @cognitum-one/sdk\n# optional: mDNS discovery\nnpm install multicast-dns\n```\n\nRequires Node.js `>=18`.\n\n## Quick start — talking to a Seed\n\n```ts\nimport { SeedClient } from \"@cognitum-one/sdk/seed\";\n\nconst client = new SeedClient({\n  endpoints: \"https://cognitum.local:8443\",\n  tls: { insecure: true }, // dev-only; use tls.ca for production\n});\n\nconst status = await client.status();\nconsole.log(`seed ${status.deviceId}, epoch ${status.epoch}`);\n\nconst result = await client.store.query({ vector: [0.1, 0.2, /*...*/ 0.8], k: 3 });\n```\n\n## Features\n\n- 12 typed seed endpoints (status, pair, witness, custody, store, OTA, …)\n- Mesh routing with closest-first, session-sticky reads, failover on 5xx\n- `client.mesh()` observability wrappers (status / peers / swarm / cluster)\n- Per-call `CallOptions` — `peer` / `prefer` / `consistency` / `timeout` / `retries`\n- Discovery providers: `ExplicitDiscovery`, `MdnsDiscovery`, `TailscaleDiscovery`\n- TLS — explicit CA, `fp=sha256:<hex>` cert pinning, or dev-only `insecure`\n- Trust-score 3-strike cutoff; redacting `SecretString` around pairing tokens\n- ADR-0005 retry / rate-limit (500 ms base, 30 s cap, 60 s wall-clock)\n- MCP client with both HTTP and stdio transports\n\n## Documentation\n\n- Cross-cutting: [`../../docs/adr/`](../../docs/adr/)\n- Node-specific ADRs: [`docs/adr/`](docs/adr/)\n- Changelog: [`CHANGELOG.md`](CHANGELOG.md)\n\n## License\n\nMIT — see [`LICENSE`](LICENSE).\n","readmeFilename":"README.md"}