{"_id":"@aerograph/adapter-langchain","_rev":"5-934d1c90c6a686e008c8a14ec4d5e9d6","name":"@aerograph/adapter-langchain","dist-tags":{"latest":"0.3.1"},"versions":{"0.1.0":{"name":"@aerograph/adapter-langchain","version":"0.1.0","keywords":["ai","adapter","langchain","trace","observability"],"license":"Apache-2.0","_id":"@aerograph/adapter-langchain@0.1.0","maintainers":[{"name":"sgcpu","email":"sian.frcrce.stuco@gmail.com"}],"homepage":"https://github.com/SGcpu/AeroGraph#readme","bugs":{"url":"https://github.com/SGcpu/AeroGraph/issues"},"dist":{"shasum":"bec1524a9639877c921bf8be81642f4d80fb003a","tarball":"https://registry.npmjs.org/@aerograph/adapter-langchain/-/adapter-langchain-0.1.0.tgz","fileCount":22,"integrity":"sha512-Tx7FQc6EGwyQN+5rpUdKLP/kGe53bZaiTv9715ehVumSq5ZNJO89GiNJdvG82RnzK5hBrSo0LYzC4zLNpbraqA==","signatures":[{"sig":"MEQCICvHbF4RSNsKlzrhZkfvCngPXaessUXY9vdKFLx4WqQAAiACU8kaGXHUC6Fg3tXDutsv0Coa0CBCSA3tN22CyCeMBQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":32420},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"78b10bff882d92a0e04cb1b777b5dd7579105ca5","private":false,"scripts":{"dev":"tsc -p tsconfig.json --watch","lint":"eslint .","test":"vitest run","build":"tsc -p tsconfig.json","prebuild":"node -e \"require('fs').rmSync('dist', { recursive: true, force: true })\""},"_npmUser":{"name":"sgcpu","email":"sian.frcrce.stuco@gmail.com"},"repository":{"url":"git+https://github.com/SGcpu/AeroGraph.git","type":"git"},"_npmVersion":"11.5.2","description":"LangChain adapter for emitting AeroGraph traces from agent workflows.","directories":{},"_nodeVersion":"22.17.1","dependencies":{"langchain":"^0.3.0","@aerograph/sdk":"^0.1.0","@langchain/core":"^0.3.0","@aerograph/contracts":"^0.1.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"eslint":"^9.9.0","vitest":"^2.1.0","@eslint/js":"^9.9.0","typescript":"^5.6.0","typescript-eslint":"^8.0.0"},"_npmOperationalInternal":{"tmp":"tmp/adapter-langchain_0.1.0_1779656924960_0.7066448844707356","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@aerograph/adapter-langchain","version":"0.2.0","keywords":["ai","adapter","langchain","trace","observability"],"license":"Apache-2.0","_id":"@aerograph/adapter-langchain@0.2.0","maintainers":[{"name":"sgcpu","email":"sian.frcrce.stuco@gmail.com"}],"homepage":"https://github.com/SGcpu/AeroGraph#readme","bugs":{"url":"https://github.com/SGcpu/AeroGraph/issues"},"dist":{"shasum":"d160886542ee9a5d2de094cb1887db206f4c240c","tarball":"https://registry.npmjs.org/@aerograph/adapter-langchain/-/adapter-langchain-0.2.0.tgz","fileCount":22,"integrity":"sha512-6zmovnz0lYvFBRO1KD4wmizr1VMlTWMtA5PH0kztGwbkJ4MSFYpWBWOlRyzA9IgxMt8M7zSHpyLkfNNlX6azAQ==","signatures":[{"sig":"MEUCIQCQO1fiVbvXPKI6T2wZpfXuS0pxe0FIJRjr6iyB6VOVBQIgR8DB+krqzGHdgJp5VPWxig5s/JQK3d3Z1ImUPg8wupc=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":32420},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"f4f3747cd6026d768e7f6f4d1b43de22f10b0d30","private":false,"scripts":{"dev":"tsc -p tsconfig.json --watch","lint":"eslint .","test":"vitest run","build":"tsc -p tsconfig.json","prebuild":"node -e \"require('fs').rmSync('dist', { recursive: true, force: true })\""},"_npmUser":{"name":"sgcpu","email":"sian.frcrce.stuco@gmail.com"},"repository":{"url":"git+https://github.com/SGcpu/AeroGraph.git","type":"git"},"_npmVersion":"11.5.2","description":"LangChain adapter for emitting AeroGraph traces from agent workflows.","directories":{},"_nodeVersion":"22.17.1","dependencies":{"langchain":"^0.3.0","@aerograph/sdk":"^0.2.0","@langchain/core":"^0.3.0","@aerograph/contracts":"^0.2.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"eslint":"^9.9.0","vitest":"^2.1.0","@eslint/js":"^9.9.0","typescript":"^5.6.0","typescript-eslint":"^8.0.0"},"_npmOperationalInternal":{"tmp":"tmp/adapter-langchain_0.2.0_1780467911155_0.7903708511557179","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"@aerograph/adapter-langchain","version":"0.2.1","keywords":["ai","adapter","langchain","trace","observability"],"license":"Apache-2.0","_id":"@aerograph/adapter-langchain@0.2.1","maintainers":[{"name":"sgcpu","email":"sian.frcrce.stuco@gmail.com"}],"homepage":"https://github.com/SGcpu/AeroGraph#readme","bugs":{"url":"https://github.com/SGcpu/AeroGraph/issues"},"dist":{"shasum":"4834a7943c2989539d983c300ca5b00b6d847804","tarball":"https://registry.npmjs.org/@aerograph/adapter-langchain/-/adapter-langchain-0.2.1.tgz","fileCount":22,"integrity":"sha512-e1d8O5AAbnGF7wWW1TsHHtA1XU1I8vGo1/TAdSq0M8qbgXb+hf5FSBFRFOoEEE1OefknGsoN1++b7coYlyR86g==","signatures":[{"sig":"MEQCIG4BzArz48XGDpcXZuVz8hDM3wevFh5gUD5LQtC4nxlrAiARQjIhck9Yb9XTZBHJmSZ4l+N1i8wTYBibbfLG5BiXYA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":33366},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"73ae8bebcf941d8f9abd0649da761cca15d19794","private":false,"scripts":{"dev":"tsc -p tsconfig.json --watch","lint":"eslint .","test":"vitest run","build":"tsc -p tsconfig.json","prebuild":"node -e \"require('fs').rmSync('dist', { recursive: true, force: true })\""},"_npmUser":{"name":"sgcpu","email":"sian.frcrce.stuco@gmail.com"},"repository":{"url":"git+https://github.com/SGcpu/AeroGraph.git","type":"git"},"_npmVersion":"11.5.2","description":"LangChain adapter for emitting AeroGraph traces from agent workflows.","directories":{},"_nodeVersion":"22.17.1","dependencies":{"langchain":"^0.3.0","@aerograph/sdk":"^0.2.0","@langchain/core":"^0.3.0","@aerograph/contracts":"^0.2.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"eslint":"^9.9.0","vitest":"^2.1.0","@eslint/js":"^9.9.0","typescript":"^5.6.0","typescript-eslint":"^8.0.0"},"_npmOperationalInternal":{"tmp":"tmp/adapter-langchain_0.2.1_1781117152681_0.7365741726688295","host":"s3://npm-registry-packages-npm-production"}},"0.3.0":{"name":"@aerograph/adapter-langchain","version":"0.3.0","keywords":["ai","adapter","langchain","trace","observability"],"license":"Apache-2.0","_id":"@aerograph/adapter-langchain@0.3.0","maintainers":[{"name":"sgcpu","email":"sian.frcrce.stuco@gmail.com"}],"homepage":"https://github.com/SGcpu/AeroGraph#readme","bugs":{"url":"https://github.com/SGcpu/AeroGraph/issues"},"dist":{"shasum":"80dd5639916b3eeed487a47ba880837687c50ff9","tarball":"https://registry.npmjs.org/@aerograph/adapter-langchain/-/adapter-langchain-0.3.0.tgz","fileCount":22,"integrity":"sha512-30EuTbVs+VLR3bJZv2+zbjaBO5fpoZFEKvssSjcGIKbg5YD9xnask9dC9n5M75Cd7MZZ4u+czoOPjhe2TWRZjQ==","signatures":[{"sig":"MEUCIGjzKtV+rofJ9GE0TsVGNWbCTM8GknMcJivTeOVg8bbpAiEAg9MDo6NUkk+xs4ysKR1DP+XDS8G2939c0BCeOcrHfIA=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":33319},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"9504b907ff5e3c49d3ec8c6e8f47fb2f46d1436f","private":false,"scripts":{"dev":"tsc -p tsconfig.json --watch","lint":"eslint .","test":"vitest run","build":"tsc -p tsconfig.json","prebuild":"node -e \"require('fs').rmSync('dist', { recursive: true, force: true })\""},"_npmUser":{"name":"sgcpu","email":"sian.frcrce.stuco@gmail.com"},"repository":{"url":"git+https://github.com/SGcpu/AeroGraph.git","type":"git"},"_npmVersion":"11.5.2","description":"LangChain adapter for emitting AeroGraph traces from agent workflows.","directories":{},"_nodeVersion":"22.17.1","dependencies":{"langchain":"^0.3.0","@aerograph/sdk":"0.3.0","@langchain/core":"^0.3.0","@aerograph/contracts":"0.3.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"eslint":"^9.9.0","vitest":"^2.1.0","@eslint/js":"^9.9.0","typescript":"^5.6.0","typescript-eslint":"^8.0.0"},"_npmOperationalInternal":{"tmp":"tmp/adapter-langchain_0.3.0_1782813443552_0.9876213232442039","host":"s3://npm-registry-packages-npm-production"}},"0.3.1":{"name":"@aerograph/adapter-langchain","version":"0.3.1","private":false,"description":"LangChain adapter for emitting AeroGraph traces from agent workflows.","type":"module","main":"dist/index.js","types":"dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"license":"Apache-2.0","repository":{"type":"git","url":"git+https://github.com/SGcpu/AeroGraph.git"},"bugs":{"url":"https://github.com/SGcpu/AeroGraph/issues"},"homepage":"https://github.com/SGcpu/AeroGraph#readme","publishConfig":{"access":"public"},"keywords":["ai","adapter","langchain","trace","observability"],"scripts":{"prebuild":"node -e \"require('fs').rmSync('dist', { recursive: true, force: true })\"","build":"tsc -p tsconfig.json","dev":"tsc -p tsconfig.json --watch","test":"vitest run","lint":"eslint ."},"dependencies":{"@aerograph/contracts":"0.3.0","@aerograph/sdk":"0.3.0","@langchain/core":"^1.2.2","langchain":"^0.3.0"},"devDependencies":{"@eslint/js":"^9.9.0","@langchain/langgraph":"^1.4.7","@langchain/openai":"^0.6.17","eslint":"^9.9.0","typescript":"^5.6.0","typescript-eslint":"^8.0.0","vitest":"^2.1.0"},"_id":"@aerograph/adapter-langchain@0.3.1","gitHead":"1e896ae4a233dca3824970620e6491939e97b2ba","_nodeVersion":"22.17.1","_npmVersion":"11.5.2","dist":{"integrity":"sha512-cfjya2hACHvZsjZgGC36MliJCDcFaMIFZQtqBDL/219WBwLFI3T4dMFA9qXi8Bt/xQE+QhGesHiA1Sgf+XS6Ww==","shasum":"1aab5ac4bb1619e420e48b1cbfa0af73b1faed13","tarball":"https://registry.npmjs.org/@aerograph/adapter-langchain/-/adapter-langchain-0.3.1.tgz","fileCount":22,"unpackedSize":38590,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDsggEwkoiAB+pTz2RohzK7tiv+bjv4pVHg4ohSYTyTJAIhAMkorM9179rPq1wMOSeGQfzAd/yQ/lnk+OJ1ZDyBDSXs"}]},"_npmUser":{"name":"sgcpu","email":"sian.frcrce.stuco@gmail.com"},"directories":{},"maintainers":[{"name":"sgcpu","email":"sian.frcrce.stuco@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/adapter-langchain_0.3.1_1784833292878_0.17062883036404686"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-24T21:08:44.756Z","modified":"2026-07-23T19:01:33.192Z","0.1.0":"2026-05-24T21:08:45.109Z","0.2.0":"2026-06-03T06:25:11.308Z","0.2.1":"2026-06-10T18:45:52.859Z","0.3.0":"2026-06-30T09:57:23.685Z","0.3.1":"2026-07-23T19:01:33.017Z"},"bugs":{"url":"https://github.com/SGcpu/AeroGraph/issues"},"license":"Apache-2.0","homepage":"https://github.com/SGcpu/AeroGraph#readme","keywords":["ai","adapter","langchain","trace","observability"],"repository":{"type":"git","url":"git+https://github.com/SGcpu/AeroGraph.git"},"description":"LangChain adapter for emitting AeroGraph traces from agent workflows.","maintainers":[{"name":"sgcpu","email":"sian.frcrce.stuco@gmail.com"}],"readme":"# @aerograph/adapter-langchain\r\n\r\nThis adapter bridges LangChain.js workflows into the AeroGraph.\r\n\r\n## Deterministic Mapping\r\n\r\nLangChain's complex callback hierarchy is deterministically mapped to the minimal Flight Recorder contracts as follows:\r\n\r\n| LangChain Callback | AFR Event Kind | Metadata Mapped |\r\n|---|---|---|\r\n| `handleLLMStart` | `prompt` | messages/prompts, `model.name`, parentSpanId, runId -> spanId |\r\n| `handleLLMEnd` | `response` | generations, streaming metrics, `usage` tokens, `durationMs`, runId -> spanId |\r\n| `handleLLMError` | `error` | error message, `durationMs`, runId -> spanId |\r\n| `handleToolStart` | `tool_call` | input string/JSON, runId -> spanId |\r\n| `handleToolEnd` | `tool_result` | output, `durationMs`, runId -> spanId |\r\n| `handleToolError` | `error` | error message, `durationMs`, runId -> spanId |\r\n| `handleChainStart` / `handleChainEnd` | `note` | Detects LangGraph node boundaries (`kind: \"langgraph_node\"`), capturing `state_before` (Inputs) and `state_update` (Outputs) |\r\n\r\n## Installation\r\n\r\n```bash\r\nnpm install @aerograph/adapter-langchain @aerograph/sdk\r\n```\r\n\r\n*(Requires Node.js >= 18.18.0)*\r\n\r\n## Quick Start\r\n\r\nThe adapter provides a callback handler that you inject into your LangChain invocations.\r\n\r\n```typescript\r\nimport { FlightRecorder } from \"@aerograph/sdk\";\r\nimport { AeroGraphCallbackHandler } from \"@aerograph/adapter-langchain\";\r\nimport { ChatOpenAI } from \"@langchain/openai\";\r\n\r\nconst recorder = new FlightRecorder({\r\n  endpoint: \"http://localhost:4317\",\r\n  actor: { id: \"my-langchain-agent\" }\r\n});\r\n\r\nconst handler = new AeroGraphCallbackHandler(recorder);\r\nconst model = new ChatOpenAI({ modelName: \"gpt-4\" });\r\n\r\n// The handler automatically maps LangChain callbacks to AeroGraph events\r\nawait model.invoke(\"Hello, how are you?\", {\r\n  callbacks: [handler]\r\n});\r\n```\r\n\r\n## Supported Features\r\n- LLM Call Tracking (Prompts & Responses)\r\n- Streaming Telemetry (TTFT, tokens/sec)\r\n- RAG Retriever Document Payloads\r\n- Tool Calls & Results\r\n- LangGraph State Snapshots\r\n\r\n## License\r\nApache-2.0\r\n| `handleAgentAction`| *(ignored)* | Caught by tool/llm events |\r\n\r\nFor Phase 1 MVP, we focus strictly on LLMs and Tools plus lightweight chain boundary notes to keep the graph comprehensible.\r\n","readmeFilename":"README.md"}