{"_id":"@2434addy/agentledger-sdk","_rev":"2-cdda61c78ad92b9ce3ecbe5c62557c81","name":"@2434addy/agentledger-sdk","dist-tags":{"latest":"0.2.1"},"versions":{"0.2.0":{"name":"@2434addy/agentledger-sdk","version":"0.2.0","keywords":["ai-agents","audit-trail","compliance","observability","monitoring","langchain","openai","crewai"],"author":{"name":"AgentLedger"},"license":"MIT","_id":"@2434addy/agentledger-sdk@0.2.0","maintainers":[{"name":"2434addy","email":"adityapandey20043@gmail.com"}],"homepage":"https://github.com/2434addy/AgentLedger#readme","bugs":{"url":"https://github.com/2434addy/AgentLedger/issues"},"dist":{"shasum":"2dd34fc9aae34b974338f7eda3ebd2c12f686cef","tarball":"https://registry.npmjs.org/@2434addy/agentledger-sdk/-/agentledger-sdk-0.2.0.tgz","fileCount":6,"integrity":"sha512-Vtr5b3qaBico2nGoI/WFIcz9IQ4i5nodT5HTN0umLzbnB9hMIli8MVSdyrWddWBCMaL/OOOiRhe6ucPmbp/vEA==","signatures":[{"sig":"MEYCIQC5yvrqNb7E+J71K3xpGkictJ2peOlX2YBx6/gsIYtvsAIhANcVyjlTMLgyzsUa4/yXAUcpOQ6TAx+YZS+nQmKbAyR0","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":20564},"main":"dist/index.js","types":"dist/index.d.ts","module":"dist/index.mjs","engines":{"node":">=18.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.mjs","require":"./dist/index.js"}},"gitHead":"d02712b6a4b46ee61ec8d985f6756d309a8dd1b9","scripts":{"dev":"tsup src/index.ts --format cjs,esm --dts --watch","lint":"tsc --noEmit","build":"tsup src/index.ts --format cjs,esm --dts"},"_npmUser":{"name":"2434addy","email":"adityapandey20043@gmail.com"},"repository":{"url":"git+https://github.com/2434addy/AgentLedger.git","type":"git","directory":"sdk"},"_npmVersion":"11.6.2","description":"TypeScript SDK for AgentLedger — track, audit, and monitor your AI agents.","directories":{},"_nodeVersion":"24.13.0","_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.0.0","typescript":"^5.0.0"},"_npmOperationalInternal":{"tmp":"tmp/agentledger-sdk_0.2.0_1774506339907_0.8244510859415111","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"@2434addy/agentledger-sdk","version":"0.2.1","description":"TypeScript SDK for AgentLedger — track, audit, and monitor your AI agents.","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 cjs,esm --dts","dev":"tsup src/index.ts --format cjs,esm --dts --watch","lint":"tsc --noEmit"},"keywords":["ai-agents","audit-trail","compliance","observability","monitoring","langchain","openai","crewai"],"author":{"name":"AgentLedger"},"license":"MIT","devDependencies":{"tsup":"^8.0.0","typescript":"^5.0.0"},"engines":{"node":">=18.0.0"},"repository":{"type":"git","url":"git+https://github.com/2434addy/AgentLedger.git","directory":"sdk"},"gitHead":"22bc56af586b6860d3ed33d171db42d838cb1e9f","_id":"@2434addy/agentledger-sdk@0.2.1","bugs":{"url":"https://github.com/2434addy/AgentLedger/issues"},"homepage":"https://github.com/2434addy/AgentLedger#readme","_nodeVersion":"24.13.0","_npmVersion":"11.6.2","dist":{"integrity":"sha512-ztibFFdouPRNzYLVfMxTIjIt8/Hus2cHb4VTAJ/9N/1DQO4qsq5gCw9tWLsQoXqTwvxTguQH4WJYAADQsZ2NkQ==","shasum":"f60cdbca463d1ccade0ee09251988dc506d551cd","tarball":"https://registry.npmjs.org/@2434addy/agentledger-sdk/-/agentledger-sdk-0.2.1.tgz","fileCount":6,"unpackedSize":20682,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIFH+69r2guzvoAQxGWum2naD3WES3ZNK/yqvBSRW1vhHAiEAokJoTrrUx2JGTXxZX6aTl/xBMliWtQnnXRRlz0tkD2g="}]},"_npmUser":{"name":"2434addy","email":"adityapandey20043@gmail.com"},"directories":{},"maintainers":[{"name":"2434addy","email":"adityapandey20043@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/agentledger-sdk_0.2.1_1775024788370_0.9704997283893584"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-26T06:25:39.795Z","modified":"2026-04-01T06:26:28.635Z","0.2.0":"2026-03-26T06:25:40.060Z","0.2.1":"2026-04-01T06:26:28.502Z"},"bugs":{"url":"https://github.com/2434addy/AgentLedger/issues"},"author":{"name":"AgentLedger"},"license":"MIT","homepage":"https://github.com/2434addy/AgentLedger#readme","keywords":["ai-agents","audit-trail","compliance","observability","monitoring","langchain","openai","crewai"],"repository":{"type":"git","url":"git+https://github.com/2434addy/AgentLedger.git","directory":"sdk"},"description":"TypeScript SDK for AgentLedger — track, audit, and monitor your AI agents.","maintainers":[{"name":"2434addy","email":"adityapandey20043@gmail.com"}],"readme":"# @agentledger/sdk\r\n\r\nTypeScript SDK for AgentLedger — track, audit, and monitor your AI agents.\r\n\r\n## Install\r\n\r\n```bash\r\nnpm install @agentledger/sdk\r\n```\r\n\r\n## Quick Start\r\n\r\n```typescript\r\nimport { AgentLedger } from '@agentledger/sdk'\r\n\r\nconst al = new AgentLedger({ apiKey: 'al_live_sk_...' })\r\n\r\n// Create an agent\r\nconst agent = await al.createAgent({\r\n  name: 'My Assistant',\r\n  description: 'Customer support bot',\r\n  modelProvider: 'anthropic',\r\n  modelId: 'claude-sonnet-4-6',\r\n})\r\n\r\n// Create a session\r\nconst session = await al.createSession({ agentId: agent.id })\r\n\r\n// Track events (batched automatically)\r\nal.track({\r\n  agentId: agent.id,\r\n  sessionId: session.id,\r\n  category: 'llm_call',\r\n  level: 'info',\r\n  message: 'Called Claude API',\r\n  payload: { prompt: 'Hello world' },\r\n})\r\n\r\n// Send all queued events now\r\nawait al.flush()\r\n```\r\n\r\n## API\r\n\r\n### `new AgentLedger(config)`\r\n\r\n| Option          | Type     | Default                                    | Description              |\r\n| --------------- | -------- | ------------------------------------------ | ------------------------ |\r\n| `apiKey`        | `string` | *required*                                 | Your API key             |\r\n| `baseUrl`       | `string` | `https://api.agentledger.io/api/v1`        | API base URL             |\r\n| `timeout`       | `number` | `5000`                                     | Request timeout (ms)     |\r\n| `flushInterval` | `number` | `5000`                                     | Auto-flush interval (ms) |\r\n| `maxBatchSize`  | `number` | `50`                                       | Max events per batch     |\r\n| `debug`         | `boolean`| `false`                                    | Log warnings to console  |\r\n\r\n### `al.createAgent(input)`\r\n\r\nCreate a registered agent.\r\n\r\n```typescript\r\nconst agent = await al.createAgent({\r\n  name: 'Email Agent',\r\n  modelProvider: 'openai',\r\n  modelId: 'gpt-4o',\r\n})\r\n```\r\n\r\n### `al.createSession(input)`\r\n\r\nStart a new session for an agent.\r\n\r\n```typescript\r\nconst session = await al.createSession({ agentId: agent.id })\r\n```\r\n\r\n### `al.track(event)`\r\n\r\nQueue an event for batched sending. Fires immediately when the batch reaches `maxBatchSize`.\r\n\r\n```typescript\r\nal.track({\r\n  agentId: agent.id,\r\n  sessionId: session.id,\r\n  category: 'llm_call',\r\n  level: 'info',\r\n  message: 'Generated response',\r\n  payload: { model: 'claude-sonnet-4-6' },\r\n  tokensInput: 150,\r\n  tokensOutput: 420,\r\n  latencyMs: 1200,\r\n})\r\n```\r\n\r\n### `al.flush()`\r\n\r\nSend all queued events immediately. Returns the created events.\r\n\r\n```typescript\r\nconst events = await al.flush()\r\n```\r\n\r\n### `al.shutdown()`\r\n\r\nStop the auto-flush timer and send remaining events. Call before process exit.\r\n\r\n```typescript\r\nprocess.on('beforeExit', () => al.shutdown())\r\n```\r\n\r\n## Event Categories\r\n\r\n`agent_lifecycle` | `llm_call` | `tool_invocation` | `user_action` | `system` | `security` | `guardrail`\r\n\r\n## Event Levels\r\n\r\n`debug` | `info` | `warn` | `error` | `fatal`\r\n\r\n## License\r\n\r\nMIT\r\n","readmeFilename":"README.md"}