{"_id":"@acumenlogs/sdk","name":"@acumenlogs/sdk","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@acumenlogs/sdk","version":"1.0.0","description":"Acumen Logs AI monitoring SDK for Node.js and browser feedback tracking","type":"module","main":"./src/index.js","repository":{"type":"git","url":"git+https://github.com/deferdie/acumen-sdk-node.git"},"homepage":"https://www.acumenlogs.com/docs/1.0/ai-monitoring-sdks","bugs":{"url":"https://github.com/deferdie/acumen-sdk-node/issues"},"publishConfig":{"access":"public"},"exports":{".":{"import":"./src/index.js","require":"./src/index.cjs"},"./browser":{"import":"./src/browser/index.js","types":"./src/browser/index.d.ts"},"./browser/react":{"import":"./src/browser/react.js","types":"./src/browser/react.d.ts"}},"scripts":{"test":"node --test test/browser.test.js"},"engines":{"node":">=18.0.0"},"keywords":["acumenlogs","ai-monitoring","llm","observability"],"license":"MIT","_id":"@acumenlogs/sdk@1.0.0","gitHead":"c4baa1144c609759be1cd2f18ba67703f180cbe3","_nodeVersion":"20.19.5","_npmVersion":"10.8.2","dist":{"integrity":"sha512-2NhAtEVaJVxhzUs9Gj3be7nVM98If9oKefm2xOdE54DaIeAFzSZI2Bk4E36y0JpOGMC8SUsyMRG0K8bMaIZ3dw==","shasum":"89269e9d61b00461deec442285d4321d5ff558bb","tarball":"https://registry.npmjs.org/@acumenlogs/sdk/-/sdk-1.0.0.tgz","fileCount":11,"unpackedSize":16448,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIFGwlKn5COBLsoFBSaHHJhf2sDk3gLaym82Oz0Oti7TjAiEA2W1Q7e26SkbedKOHvLZ+F5Lsd8B00iYqTAzosc1CTQo="}]},"_npmUser":{"name":"deferdie","email":"deferdie@gmail.com"},"directories":{},"maintainers":[{"name":"deferdie","email":"deferdie@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/sdk_1.0.0_1780060613161_0.41641768478944385"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-29T13:16:52.974Z","1.0.0":"2026-05-29T13:16:53.312Z","modified":"2026-05-29T13:16:53.585Z"},"maintainers":[{"name":"deferdie","email":"deferdie@gmail.com"}],"description":"Acumen Logs AI monitoring SDK for Node.js and browser feedback tracking","homepage":"https://www.acumenlogs.com/docs/1.0/ai-monitoring-sdks","keywords":["acumenlogs","ai-monitoring","llm","observability"],"repository":{"type":"git","url":"git+https://github.com/deferdie/acumen-sdk-node.git"},"bugs":{"url":"https://github.com/deferdie/acumen-sdk-node/issues"},"license":"MIT","readme":"# @acumenlogs/sdk\r\n\r\nOfficial [Acumen Logs](https://www.acumenlogs.com) SDK for AI monitoring — trace LLM calls on the server and record user feedback in the browser.\r\n\r\n## Install\r\n\r\n```bash\r\nnpm install @acumenlogs/sdk\r\n```\r\n\r\n## Server (Node.js)\r\n\r\nSet your monitor report URL:\r\n\r\n```env\r\nACUMEN_LOGS_MONITOR_URL=https://app.acumenlogs.com/api/monitor/{uuid}/report\r\n```\r\n\r\n```javascript\r\nimport AcumenLogs from '@acumenlogs/sdk';\r\n\r\nconst traceId = await AcumenLogs.beginTrace('meal_planner', {\r\n  session_id: sessionId,\r\n  user_id: userId,\r\n});\r\n\r\nlet response, error;\r\ntry {\r\n  response = await openai.chat.completions.create({ model: 'gpt-4o', messages });\r\n} catch (err) {\r\n  error = err;\r\n} finally {\r\n  AcumenLogs.logSpan(traceId, 'draft_plan', response, error, { kind: 'llm' });\r\n}\r\n\r\nAcumenLogs.recordFeedback(traceId, 'accepted', { source: 'explicit' });\r\n```\r\n\r\n## Browser (feedback only)\r\n\r\n```javascript\r\nimport { createAcumenLogsClient } from '@acumenlogs/sdk/browser';\r\n\r\nconst acumen = createAcumenLogsClient({\r\n  monitorUrl: import.meta.env.VITE_ACUMEN_LOGS_MONITOR_URL,\r\n});\r\n\r\nacumen.trackAccept(traceId);\r\nacumen.trackRegenerate(traceId);\r\n```\r\n\r\n### React\r\n\r\n```javascript\r\nimport { useAcumenFeedback } from '@acumenlogs/sdk/browser/react';\r\n\r\nconst { accept, reject, regenerate } = useAcumenFeedback(acumen, traceId);\r\n```\r\n\r\n## Documentation\r\n\r\n- [AI Monitoring Quickstart](https://www.acumenlogs.com/docs/1.0/ai-monitoring-quickstart)\r\n- [SDK reference](https://www.acumenlogs.com/docs/1.0/ai-monitoring-sdks)\r\n\r\n## License\r\n\r\nMIT\r\n","readmeFilename":"README.md","_rev":"1-01f157797d847dccd98ead54e32ca07c"}