{"_id":"@agentlens-sdk/sdk","_rev":"2-67d64b5bf5b19e76306936bd0331ab8c","name":"@agentlens-sdk/sdk","dist-tags":{"latest":"0.2.0"},"versions":{"0.1.0":{"name":"@agentlens-sdk/sdk","version":"0.1.0","keywords":["ai","agents","observability","tracing","llm","debugging","openai","anthropic"],"license":"MIT","_id":"@agentlens-sdk/sdk@0.1.0","maintainers":[{"name":"arkfelix7","email":"aaryashah130402@gmail.com"}],"homepage":"https://github.com/ArkFelix7/agentlens#readme","bugs":{"url":"https://github.com/ArkFelix7/agentlens/issues"},"dist":{"shasum":"420ef5591377c24e509e6fe496cada174b62c910","tarball":"https://registry.npmjs.org/@agentlens-sdk/sdk/-/sdk-0.1.0.tgz","fileCount":34,"integrity":"sha512-4We+tY+y34ngTQKULzTNxcki4NaSwxGPbfXR4gtR4YJhEMcvYvBo4MbirHtkrkYGWu8fwEuZEjbMRoeXlcZnzg==","signatures":[{"sig":"MEUCIQCSuDozOUbvPvEVLVGltAgkyVk9k/1bA+NVSF0wl2h9FQIgU/rEgboAH0JR7+W8vHKjfiIq4ywSy0d2QT1DkcaiFaw=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":47819},"main":"dist/index.js","types":"dist/index.d.ts","gitHead":"199deed95c6d97acf96949b0e4fc4916a24ed9e7","scripts":{"dev":"tsc --watch","build":"tsc","prepublishOnly":"npm run build"},"_npmUser":{"name":"arkfelix7","email":"aaryashah130402@gmail.com"},"repository":{"url":"git+https://github.com/ArkFelix7/agentlens.git","type":"git"},"_npmVersion":"11.8.0","description":"TypeScript SDK for AgentLens — real-time observability for AI agents","directories":{},"_nodeVersion":"24.13.1","dependencies":{"ws":"^8.18.0","ulid":"^2.3.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"@types/ws":"^8.5.0","typescript":"^5.5.0","@types/node":"^22.0.0"},"peerDependencies":{"openai":">=4.0.0","@anthropic-ai/sdk":">=0.25.0"},"peerDependenciesMeta":{"openai":{"optional":true},"@anthropic-ai/sdk":{"optional":true}},"_npmOperationalInternal":{"tmp":"tmp/sdk_0.1.0_1772834156775_0.7353883708769","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@agentlens-sdk/sdk","version":"0.2.0","description":"TypeScript SDK for AgentLens — real-time observability for AI agents","main":"dist/index.js","types":"dist/index.d.ts","scripts":{"build":"tsc","dev":"tsc --watch","prepublishOnly":"npm run build"},"publishConfig":{"access":"public"},"keywords":["ai","agents","observability","tracing","llm","debugging","openai","anthropic"],"license":"MIT","repository":{"type":"git","url":"git+https://github.com/ArkFelix7/agentlens.git"},"homepage":"https://github.com/ArkFelix7/agentlens#readme","dependencies":{"ws":"^8.18.0","ulid":"^2.3.0"},"peerDependencies":{"openai":">=4.0.0","@anthropic-ai/sdk":">=0.25.0"},"peerDependenciesMeta":{"openai":{"optional":true},"@anthropic-ai/sdk":{"optional":true}},"devDependencies":{"@types/node":"^22.0.0","@types/ws":"^8.5.0","typescript":"^5.5.0"},"gitHead":"b6f7d932840ff71f9b35695feda9d3aaf98b5a8b","_id":"@agentlens-sdk/sdk@0.2.0","bugs":{"url":"https://github.com/ArkFelix7/agentlens/issues"},"_nodeVersion":"24.13.1","_npmVersion":"11.8.0","dist":{"integrity":"sha512-0JyBXI830THVweWsUwT6kXv4khHasansxdI4LW07fpjQz0lxrkxxgVMKjAOU3nOwD/+HJxc1oyTYuJL9Eh/qlA==","shasum":"ae8c6e41963a84c6f3d3777327af4d2452941c27","tarball":"https://registry.npmjs.org/@agentlens-sdk/sdk/-/sdk-0.2.0.tgz","fileCount":34,"unpackedSize":53608,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDd+BNqp8wcv5dUVS7RsmzBcjrjd9ZS/56EwFPMiNNSwwIgZoEGTQrwOifiQk/tC/wCA9jC8Nyr6cf9MI2bmQDs+ao="}]},"_npmUser":{"name":"arkfelix7","email":"aaryashah130402@gmail.com"},"directories":{},"maintainers":[{"name":"arkfelix7","email":"aaryashah130402@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/sdk_0.2.0_1773808484624_0.5609395934498898"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-06T21:55:56.680Z","modified":"2026-03-18T04:34:44.925Z","0.1.0":"2026-03-06T21:55:56.918Z","0.2.0":"2026-03-18T04:34:44.789Z"},"bugs":{"url":"https://github.com/ArkFelix7/agentlens/issues"},"license":"MIT","homepage":"https://github.com/ArkFelix7/agentlens#readme","keywords":["ai","agents","observability","tracing","llm","debugging","openai","anthropic"],"repository":{"type":"git","url":"git+https://github.com/ArkFelix7/agentlens.git"},"description":"TypeScript SDK for AgentLens — real-time observability for AI agents","maintainers":[{"name":"arkfelix7","email":"aaryashah130402@gmail.com"}],"readme":"# @agentlens-sdk/sdk\n\nTypeScript/Node.js SDK for [AgentLens](https://github.com/ArkFelix7/agentlens) — real-time observability and debugging for AI agents.\n\n## Install\n\n```bash\nnpm install @agentlens-sdk/sdk\n```\n\nWith peer dependencies for your AI provider:\n\n```bash\nnpm install @agentlens-sdk/sdk openai                  # for OpenAI\nnpm install @agentlens-sdk/sdk @anthropic-ai/sdk       # for Anthropic\n```\n\n## Prerequisites\n\nStart the AgentLens server first:\n\n```bash\npip install agentlens-server\nagentlens-server\n# Server running at http://localhost:8766\n```\n\nThen open the dashboard at `http://localhost:5173`.\n\n## Usage\n\n### Option 1: Auto-instrument (recommended)\n\n```typescript\nimport { autoInstrument } from '@agentlens-sdk/sdk';\n\nautoInstrument(); // patches OpenAI + Anthropic Node SDKs\n\n// All subsequent calls are traced automatically\nimport OpenAI from 'openai';\nconst client = new OpenAI();\nconst response = await client.chat.completions.create({ ... });\n```\n\n### Option 2: trace() wrapper\n\n```typescript\nimport { init, trace } from '@agentlens-sdk/sdk';\n\ninit({ serverUrl: 'ws://localhost:8766/ws' });\n\nconst myAgent = trace(\n  async (query: string) => {\n    const result = await callLLM(query);\n    return result;\n  },\n  { name: 'my_agent' }\n);\n```\n\n## Configuration\n\n```typescript\nimport { init } from '@agentlens-sdk/sdk';\n\ninit({\n  serverUrl: 'ws://localhost:8766/ws',   // AgentLens server WebSocket URL\n  httpUrl: 'http://localhost:8766',       // AgentLens server HTTP URL\n  sessionName: 'my-agent-v2',            // Optional: name shown in dashboard\n});\n```\n\n## Design Principles\n\n- **Never throws** — all SDK operations are wrapped in try/catch. Your agent always runs.\n- **Non-blocking** — async, buffered batch sends. Minimal overhead.\n- **Graceful degradation** — if the server isn't running, events are silently dropped.\n\n## License\n\nMIT\n","readmeFilename":"README.md"}