{"_id":"@bound-ai/sdk-js","name":"@bound-ai/sdk-js","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@bound-ai/sdk-js","version":"0.1.0","description":"JavaScript SDK for Agent Guardrails — AI agent governance platform","type":"module","main":"src/index.js","types":"index.d.ts","exports":{".":{"import":"./src/index.js","types":"./index.d.ts"}},"keywords":["ai","agents","guardrails","governance","sdk"],"license":"MIT","engines":{"node":">=18.0.0"},"publishConfig":{"access":"public"},"_id":"@bound-ai/sdk-js@0.1.0","gitHead":"11ac8db295f7f58a60b5b4952a18621537375fae","_nodeVersion":"23.5.0","_npmVersion":"11.0.0","dist":{"integrity":"sha512-qYfXStBhyKZEXFzEET2f3W1jpmfJ/vvBlXTMp7e8fxuiEOXRqw5SirB1SNLd0AhgpBAUyRQPjjmmaVy0SuLJWg==","shasum":"d395c0713a37017fdcd49ae9ab8b2ba61f222169","tarball":"https://registry.npmjs.org/@bound-ai/sdk-js/-/sdk-js-0.1.0.tgz","fileCount":4,"unpackedSize":14593,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIFKNEz3g4vPq4b7S5K8Kr6nQNxqmdsaUishrrfCTaz3rAiEA1ws6Ha7cf/wO4/uDFJ28c9tEp1TAXMdPB5ohoiQiIIg="}]},"_npmUser":{"name":"spof10","email":"sp.osoriofuentes@hotmail.com"},"directories":{},"maintainers":[{"name":"spof10","email":"sp.osoriofuentes@hotmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/sdk-js_0.1.0_1772149854808_0.8307795707216012"},"_hasShrinkwrap":false}},"time":{"created":"2026-02-26T23:50:54.632Z","0.1.0":"2026-02-26T23:50:54.947Z","modified":"2026-02-26T23:50:55.504Z"},"maintainers":[{"name":"spof10","email":"sp.osoriofuentes@hotmail.com"}],"description":"JavaScript SDK for Agent Guardrails — AI agent governance platform","keywords":["ai","agents","guardrails","governance","sdk"],"license":"MIT","readme":"# @agent-guardrails/sdk-js\r\n\r\nJavaScript SDK for [Agent Guardrails](https://agentguardrails.com) — the governance platform for AI agents.\r\n\r\nZero dependencies. Works in Node.js 18+ and modern browsers.\r\n\r\n## Install\r\n\r\n```bash\r\nnpm install @agent-guardrails/sdk-js\r\n```\r\n\r\n## Quick Start\r\n\r\n```javascript\r\nimport { AgentGuardrails } from '@agent-guardrails/sdk-js';\r\n\r\nconst client = new AgentGuardrails({ apiKey: 'ag_sk_...', baseUrl: 'http://localhost:3001' });\r\n\r\n// Guardrail mode: evaluate + execute\r\nconst result = await client.guardrail({\r\n  actionType: 'stripe.refund',\r\n  payload: { amount: 2500, currency: 'usd' },\r\n  execute: async () => stripe.refunds.create({ amount: 2500 }),\r\n});\r\n\r\nif (result.status === 'executed') {\r\n  console.log('Refund processed:', result.result);\r\n} else if (result.status === 'blocked') {\r\n  console.log('Action blocked:', result.explanation);\r\n} else if (result.status === 'pending_approval') {\r\n  const approval = await client.waitForApproval(result.approvalId);\r\n  console.log('Approval:', approval.status);\r\n}\r\n\r\n// Decide-only mode\r\nconst decision = await client.decide({\r\n  actionType: 'stripe.refund',\r\n  payload: { amount: 2500 },\r\n});\r\nconsole.log(decision.decision); // \"allow\" | \"block\" | \"require_approval\"\r\n```\r\n\r\n## API\r\n\r\n### `new AgentGuardrails({ apiKey, baseUrl })`\r\n\r\nCreate a client instance.\r\n\r\n- `apiKey` (string): Your agent API key (starts with `ag_sk_`).\r\n- `baseUrl` (string): API base URL. Default: `http://localhost:3001`.\r\n\r\n### `client.guardrail(options)` → `Promise<GuardrailResult>`\r\n\r\nEvaluate a policy decision and execute if allowed.\r\n\r\n### `client.decide(options)` → `Promise<DecideResult>`\r\n\r\nGet a policy decision without executing.\r\n\r\n### `client.waitForApproval(approvalId, options?)` → `Promise<ApprovalStatus>`\r\n\r\nPoll until an approval is resolved.\r\n\r\n## TypeScript\r\n\r\nThis package includes TypeScript declarations (`index.d.ts`). For a full TypeScript SDK, see `@agent-guardrails/sdk`.\r\n\r\n## License\r\n\r\nMIT\r\n","readmeFilename":"README.md","_rev":"1-204398e3ff19b35a851b3ff8f483cbbc"}