{"_id":"@agenttracehq/sdk","name":"@agenttracehq/sdk","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@agenttracehq/sdk","version":"1.0.0","description":"Official Node.js SDK for AgentTraceHQ - Tamper-proof audit trails for AI agents","main":"index.js","types":"index.d.ts","keywords":["ai","agents","audit","audit-trail","trace","compliance","eu-ai-act","langchain","crewai","autogen","observability","governance"],"author":{"name":"AgentTraceHQ","email":"hello@agenttracehq.com","url":"https://agenttracehq.com"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/AgentTraceHQ/sdk.git"},"homepage":"https://agenttracehq.com","bugs":{"url":"https://github.com/AgentTraceHQ/sdk/issues"},"engines":{"node":">=18.0.0"},"_id":"@agenttracehq/sdk@1.0.0","_nodeVersion":"22.18.0","_npmVersion":"11.7.0","dist":{"integrity":"sha512-DiHjA2/X7OY7CzXN3BhMPeSP1nZ8yZ1JH2REQjVUdpCOiqIxrLJEGc21WksiTADngOM7Oaote0oyR4WNeub6Zg==","shasum":"a0b7582c6f69b965d721bfcc5298a30607eb0ea7","tarball":"https://registry.npmjs.org/@agenttracehq/sdk/-/sdk-1.0.0.tgz","fileCount":5,"unpackedSize":13110,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDYYCVlWSw0UkYxpDPebS9ndfUhXZyDL6HDA//9C0E9YwIhAITZz1e0NK6x1ADdl9/wdGGQwv2r10cYlRB2vIFxkXOe"}]},"_npmUser":{"name":"curts-packages","email":"curtisthomas08@hotmail.co.uk"},"directories":{},"maintainers":[{"name":"curts-packages","email":"curtisthomas08@hotmail.co.uk"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/sdk_1.0.0_1772817956363_0.32925565765530407"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-06T17:25:56.258Z","1.0.0":"2026-03-06T17:25:56.520Z","modified":"2026-03-06T17:25:56.756Z"},"maintainers":[{"name":"curts-packages","email":"curtisthomas08@hotmail.co.uk"}],"description":"Official Node.js SDK for AgentTraceHQ - Tamper-proof audit trails for AI agents","homepage":"https://agenttracehq.com","keywords":["ai","agents","audit","audit-trail","trace","compliance","eu-ai-act","langchain","crewai","autogen","observability","governance"],"repository":{"type":"git","url":"git+https://github.com/AgentTraceHQ/sdk.git"},"author":{"name":"AgentTraceHQ","email":"hello@agenttracehq.com","url":"https://agenttracehq.com"},"bugs":{"url":"https://github.com/AgentTraceHQ/sdk/issues"},"license":"MIT","readme":"# @agenttracehq/sdk\n\nOfficial Node.js SDK for AgentTraceHQ — Audit Trail for AI Agents.\n\n## Installation\n\n```bash\nnpm install @agenttracehq/sdk\n```\n\n## Quick Start\n\n```javascript\nconst { AgentTraceHQ } = require('@agenttracehq/sdk');\n\nconst tracer = new AgentTraceHQ({\n  apiKey: 'athq_live_...',\n  agentId: 'my-agent-001',\n});\n\nawait tracer.trace({\n  action: 'tool_call',\n  input: { query: 'What is the weather?' },\n  output: { result: 'Sunny, 72F' },\n  toolsUsed: ['weather_api'],\n});\n\nawait tracer.flush();\n```\n\n## Session Tracing\n\n```javascript\nconst session = tracer.session();\nawait session.trace({ action: 'user_input', input: { message: 'Hello' } });\nawait session.trace({ action: 'response', output: { message: 'Hi there!' } });\nawait session.end();\n```\n\n## LangChain Integration\n\n```javascript\nconst handler = tracer.langchainHandler();\n// Pass as callback to any LangChain component\nconst llm = new ChatOpenAI({ callbacks: [handler] });\n```\n\n## API Reference\n\n### `new AgentTraceHQ(options)`\n- `apiKey` (string, required) — Your API key\n- `agentId` (string, required) — Default agent identifier\n- `baseUrl` (string) — API URL (default: https://agenttracehq.com/api/v1)\n- `batchSize` (number) — Traces per batch (default: 10)\n- `flushIntervalMs` (number) — Auto-flush interval (default: 1000ms)\n\n### `tracer.trace(data)` — Send a trace\n### `tracer.session([id])` — Create a grouped session\n### `tracer.langchainHandler()` — Get LangChain callback handler\n### `tracer.flush()` — Flush pending traces\n### `tracer.shutdown()` — Flush and stop the SDK\n","readmeFilename":"README.md","_rev":"1-060b7a491f1d8e8fe04e8386ff436eb6"}