{"_id":"@blackbox-ai/sdk","_rev":"3-df0f733a23b2e5b324024b3e9fdc28fb","name":"@blackbox-ai/sdk","dist-tags":{"latest":"0.1.2"},"versions":{"0.1.0":{"name":"@blackbox-ai/sdk","version":"0.1.0","keywords":["ai","agents","audit","flight-recorder","blackbox","llm","observability"],"license":"MIT","_id":"@blackbox-ai/sdk@0.1.0","maintainers":[{"name":"leclezio69","email":"Richard.leclezio@gmail.com"}],"homepage":"https://github.com/Leclezio69/blackbox#readme","bugs":{"url":"https://github.com/Leclezio69/blackbox/issues"},"dist":{"shasum":"9078011c4ba9273830b8a2f3ad9197d0d1952a20","tarball":"https://registry.npmjs.org/@blackbox-ai/sdk/-/sdk-0.1.0.tgz","fileCount":6,"integrity":"sha512-uGQa6bqLEbfTPLnZkJUNUTtqvsUwOpcP9IAOzTmQ3ICJgdR6hFuUMJoTQLsxxY5WmhxaA3UoNsdOYcEC9C7vMg==","signatures":[{"sig":"MEQCID8+WV9926hPol+hoAvqoT2N2gCWrKOXCaKCAfZWiHFMAiBAURgrWAG4D434bAKDa3yclxysPDaAYyDvkFWZtBjfQg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":22714},"main":"dist/index.cjs","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"}},"gitHead":"fc75cddd2bc71f30d7f99220a2ec2cdd511acb34","scripts":{"build":"tsup src/index.ts --format esm,cjs --dts --clean","typecheck":"tsc --noEmit","prepublishOnly":"npm run build"},"_npmUser":{"name":"leclezio69","email":"Richard.leclezio@gmail.com"},"repository":{"url":"git+https://github.com/Leclezio69/blackbox.git","type":"git","directory":"sdk/js"},"_npmVersion":"11.6.2","description":"TypeScript/JavaScript SDK for the BLACKBOX AI flight recorder","directories":{},"_nodeVersion":"24.12.0","_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.0.0","typescript":"^5.0.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/sdk_0.1.0_1781611241855_0.0974975819858217","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@blackbox-ai/sdk","version":"0.1.1","keywords":["ai","agents","audit","flight-recorder","blackbox","llm","observability"],"license":"MIT","_id":"@blackbox-ai/sdk@0.1.1","maintainers":[{"name":"leclezio69","email":"Richard.leclezio@gmail.com"}],"homepage":"https://github.com/Leclezio69/blackbox#readme","bugs":{"url":"https://github.com/Leclezio69/blackbox/issues"},"dist":{"shasum":"e115497f9cbb47ac0b75867d0a79c0d29cfcc56e","tarball":"https://registry.npmjs.org/@blackbox-ai/sdk/-/sdk-0.1.1.tgz","fileCount":6,"integrity":"sha512-FcV6rQLPnL1fNQJK4VPbg0LjOyNSr0+RF9GSpEoWdmitGADlb/6bS8igFo3qRwt088aDn8SgNYQaPzdgM1X9Jw==","signatures":[{"sig":"MEQCICrG+UCJCV1G+XA/3lhEAp8vfWhLgEztGsJP9ioimfG0AiAUbnBUUBEcsRTY6OQ9Oyk9HVZ8NrnoJvgKuwYH60KDZA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":22768},"main":"dist/index.js","types":"dist/index.d.ts","module":"dist/index.mjs","engines":{"node":">=18"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.mjs","require":"./dist/index.js"}},"gitHead":"8bc7478d0c4fab8f86b53dddced18de47131c2ea","scripts":{"build":"tsup src/index.ts --format esm,cjs --dts --clean","typecheck":"tsc --noEmit","prepublishOnly":"npm run build"},"_npmUser":{"name":"leclezio69","email":"Richard.leclezio@gmail.com"},"repository":{"url":"git+https://github.com/Leclezio69/blackbox.git","type":"git","directory":"sdk/js"},"_npmVersion":"11.6.2","description":"TypeScript/JavaScript SDK for the BLACKBOX AI flight recorder","directories":{},"_nodeVersion":"24.12.0","_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.0.0","typescript":"^5.0.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/sdk_0.1.1_1781657979220_0.9270211287222996","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@blackbox-ai/sdk","version":"0.1.2","description":"TypeScript/JavaScript SDK for the BLACKBOX AI flight recorder","main":"dist/index.js","module":"dist/index.mjs","types":"dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.mjs","require":"./dist/index.js"}},"scripts":{"build":"tsup src/index.ts --format esm,cjs --dts --clean","typecheck":"tsc --noEmit","prepublishOnly":"npm run build"},"keywords":["ai","agents","audit","flight-recorder","blackbox","llm","observability"],"license":"MIT","repository":{"type":"git","url":"git+https://github.com/Leclezio69/blackbox.git","directory":"sdk/js"},"engines":{"node":">=18"},"devDependencies":{"@types/node":"^20.0.0","tsup":"^8.0.0","typescript":"^5.0.0"},"gitHead":"e6c285f38e6518872839f42f5687cb9e850c00a9","_id":"@blackbox-ai/sdk@0.1.2","bugs":{"url":"https://github.com/Leclezio69/blackbox/issues"},"homepage":"https://github.com/Leclezio69/blackbox#readme","_nodeVersion":"24.12.0","_npmVersion":"11.6.2","dist":{"integrity":"sha512-NAJg7S+fTZ8HH4EbA5O/hPP9vgXiiH8vH/2Tc2xevsGR1lyk2jRTwRyed1/WG/ekGcZ+MQ9fw730Tp3gfJ/fWg==","shasum":"bbbd2088f2e94ee888f49516032863288b1657f9","tarball":"https://registry.npmjs.org/@blackbox-ai/sdk/-/sdk-0.1.2.tgz","fileCount":6,"unpackedSize":30228,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCZC+1qrXkUQ0ZRgH4IAPunmz9+FHeoMYDH+rxLbS46hQIgeU4FgR7w3S81tfM3BluNQd4+IUkPLH9F2SpaxjDn4Gg="}]},"_npmUser":{"name":"leclezio69","email":"Richard.leclezio@gmail.com"},"directories":{},"maintainers":[{"name":"leclezio69","email":"Richard.leclezio@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/sdk_0.1.2_1781662147059_0.5557842468366676"},"_hasShrinkwrap":false}},"time":{"created":"2026-06-16T12:00:41.685Z","modified":"2026-06-17T02:09:07.339Z","0.1.0":"2026-06-16T12:00:42.031Z","0.1.1":"2026-06-17T00:59:39.401Z","0.1.2":"2026-06-17T02:09:07.199Z"},"bugs":{"url":"https://github.com/Leclezio69/blackbox/issues"},"license":"MIT","homepage":"https://github.com/Leclezio69/blackbox#readme","keywords":["ai","agents","audit","flight-recorder","blackbox","llm","observability"],"repository":{"type":"git","url":"git+https://github.com/Leclezio69/blackbox.git","directory":"sdk/js"},"description":"TypeScript/JavaScript SDK for the BLACKBOX AI flight recorder","maintainers":[{"name":"leclezio69","email":"Richard.leclezio@gmail.com"}],"readme":"# @blackbox-ai/sdk\n\nTypeScript/JavaScript SDK for [BLACKBOX](https://blackbox-gold.vercel.app) — the flight recorder for AI agents.\n\n## Install\n\n```bash\nnpm install @blackbox-ai/sdk\n# or\npnpm add @blackbox-ai/sdk\n```\n\n## Quickstart\n\n```typescript\nimport { BlackboxClient } from \"@blackbox-ai/sdk\";\n\nconst bb = new BlackboxClient({\n  apiUrl: \"https://your-blackbox.railway.app\",\n  apiKey: process.env.BLACKBOX_AGENT_KEY,\n});\n\nconst run = bb.run(\"invoice-review-4821\");\n\nawait run.genesis({\n  system_prompt: \"You are a helpful assistant.\",\n  model_snapshot: \"gpt-4o\",\n  tools: [\"web_search\"],\n});\n\nawait run.reasoning(\"Analysing the user request...\");\nawait run.toolCall(\"web_search\", { query: \"latest AAPL price\" });\nawait run.seal();\n```\n\nEvery event is hashed and chained. Replay, diff, and audit any run in the BLACKBOX UI.\n\n## Environment variables\n\n```bash\nBLACKBOX_API_URL=https://your-blackbox.railway.app\nBLACKBOX_AGENT_KEY=bb_agent_...\n```\n\n## API\n\n### `BlackboxClient`\n\n```typescript\nconst bb = new BlackboxClient({ apiUrl?, apiKey? });\n\nbb.run(runId)            // → BlackboxRun helper\nbb.record(event)         // → EventOut\nbb.getRun(runId)         // → RunOut (with chain_valid)\nbb.listRuns()            // → RunSummary[]\nbb.verify(runId, input)  // → VerifyOut\nbb.getAuditCertificate(runId) // → AuditCertificate (no auth)\nbb.streamEvents({ onEvent }) // → EventSource (SSE)\n```\n\n### `BlackboxRun`\n\n```typescript\nconst run = bb.run(\"my-run-id\");\n\nawait run.genesis({ system_prompt, model_snapshot, tools })\nawait run.reasoning(\"title\", payload?, { model?, tokens_in?, tokens_out?, cost_usd?, latency_ms? })\nawait run.toolCall(\"tool_name\", payload?, { latency_ms? })\nawait run.retrieval(\"title\", payload?)\nawait run.fault(\"title\", payload?)\nawait run.verify({ output_text, cost_usd?, latency_ms? })\nawait run.seal()\n```\n\n## OpenTelemetry alternative\n\nBLACKBOX also accepts standard OTLP traces — no SDK needed:\n\n```bash\nexport OTEL_EXPORTER_OTLP_TRACES_ENDPOINT=https://your-blackbox.railway.app/v1/otel/traces\n```\n\n## License\n\nMIT\n","readmeFilename":"README.md"}