@langchain/angular 0.4.7 → 1.0.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +79 -584
- package/dist/context.cjs +13 -11
- package/dist/context.cjs.map +1 -1
- package/dist/context.d.cts +7 -76
- package/dist/context.d.cts.map +1 -1
- package/dist/context.d.ts +7 -76
- package/dist/context.d.ts.map +1 -1
- package/dist/context.js +13 -11
- package/dist/context.js.map +1 -1
- package/dist/index.cjs +33 -149
- package/dist/index.d.cts +11 -329
- package/dist/index.d.ts +11 -329
- package/dist/index.js +11 -114
- package/dist/inject-media-url.cjs +54 -0
- package/dist/inject-media-url.cjs.map +1 -0
- package/dist/inject-media-url.d.cts +34 -0
- package/dist/inject-media-url.d.cts.map +1 -0
- package/dist/inject-media-url.d.ts +34 -0
- package/dist/inject-media-url.d.ts.map +1 -0
- package/dist/inject-media-url.js +54 -0
- package/dist/inject-media-url.js.map +1 -0
- package/dist/inject-projection.cjs +74 -0
- package/dist/inject-projection.cjs.map +1 -0
- package/dist/inject-projection.d.cts +34 -0
- package/dist/inject-projection.d.cts.map +1 -0
- package/dist/inject-projection.d.ts +34 -0
- package/dist/inject-projection.d.ts.map +1 -0
- package/dist/inject-projection.js +74 -0
- package/dist/inject-projection.js.map +1 -0
- package/dist/inject-stream.cjs +27 -0
- package/dist/inject-stream.cjs.map +1 -0
- package/dist/inject-stream.d.cts +31 -0
- package/dist/inject-stream.d.cts.map +1 -0
- package/dist/inject-stream.d.ts +31 -0
- package/dist/inject-stream.d.ts.map +1 -0
- package/dist/inject-stream.js +27 -0
- package/dist/inject-stream.js.map +1 -0
- package/dist/selectors-metadata.cjs +39 -0
- package/dist/selectors-metadata.cjs.map +1 -0
- package/dist/selectors-metadata.d.cts +28 -0
- package/dist/selectors-metadata.d.cts.map +1 -0
- package/dist/selectors-metadata.d.ts +28 -0
- package/dist/selectors-metadata.d.ts.map +1 -0
- package/dist/selectors-metadata.js +39 -0
- package/dist/selectors-metadata.js.map +1 -0
- package/dist/selectors-queue.cjs +21 -0
- package/dist/selectors-queue.cjs.map +1 -0
- package/dist/selectors-queue.d.cts +36 -0
- package/dist/selectors-queue.d.cts.map +1 -0
- package/dist/selectors-queue.d.ts +36 -0
- package/dist/selectors-queue.d.ts.map +1 -0
- package/dist/selectors-queue.js +21 -0
- package/dist/selectors-queue.js.map +1 -0
- package/dist/selectors.cjs +144 -0
- package/dist/selectors.cjs.map +1 -0
- package/dist/selectors.d.cts +111 -0
- package/dist/selectors.d.cts.map +1 -0
- package/dist/selectors.d.ts +111 -0
- package/dist/selectors.d.ts.map +1 -0
- package/dist/selectors.js +136 -0
- package/dist/selectors.js.map +1 -0
- package/dist/stream-service.cjs +84 -0
- package/dist/stream-service.cjs.map +1 -0
- package/dist/stream-service.d.cts +67 -0
- package/dist/stream-service.d.cts.map +1 -0
- package/dist/stream-service.d.ts +67 -0
- package/dist/stream-service.d.ts.map +1 -0
- package/dist/stream-service.js +79 -0
- package/dist/stream-service.js.map +1 -0
- package/dist/use-stream.cjs +155 -0
- package/dist/use-stream.cjs.map +1 -0
- package/dist/use-stream.d.cts +97 -0
- package/dist/use-stream.d.cts.map +1 -0
- package/dist/use-stream.d.ts +97 -0
- package/dist/use-stream.d.ts.map +1 -0
- package/dist/use-stream.js +153 -0
- package/dist/use-stream.js.map +1 -0
- package/package.json +26 -25
- package/dist/index.cjs.map +0 -1
- package/dist/index.d.cts.map +0 -1
- package/dist/index.d.ts.map +0 -1
- package/dist/index.js.map +0 -1
- package/dist/node_modules/.pnpm/@langchain_langgraph@1.2.6_@langchain_core@1.1.40_@opentelemetry_api@1.9.0_openai@6.33._a807b9e815d3fdb40e51117306822e31/node_modules/@langchain/langgraph/dist/channels/base.d.cts +0 -83
- package/dist/node_modules/.pnpm/@langchain_langgraph@1.2.6_@langchain_core@1.1.40_@opentelemetry_api@1.9.0_openai@6.33._a807b9e815d3fdb40e51117306822e31/node_modules/@langchain/langgraph/dist/channels/base.d.cts.map +0 -1
- package/dist/node_modules/.pnpm/@langchain_langgraph@1.2.6_@langchain_core@1.1.40_@opentelemetry_api@1.9.0_openai@6.33._a807b9e815d3fdb40e51117306822e31/node_modules/@langchain/langgraph/dist/channels/base.d.ts +0 -83
- package/dist/node_modules/.pnpm/@langchain_langgraph@1.2.6_@langchain_core@1.1.40_@opentelemetry_api@1.9.0_openai@6.33._a807b9e815d3fdb40e51117306822e31/node_modules/@langchain/langgraph/dist/channels/base.d.ts.map +0 -1
- package/dist/node_modules/.pnpm/@langchain_langgraph@1.2.6_@langchain_core@1.1.40_@opentelemetry_api@1.9.0_openai@6.33._a807b9e815d3fdb40e51117306822e31/node_modules/@langchain/langgraph/dist/constants.d.cts +0 -42
- package/dist/node_modules/.pnpm/@langchain_langgraph@1.2.6_@langchain_core@1.1.40_@opentelemetry_api@1.9.0_openai@6.33._a807b9e815d3fdb40e51117306822e31/node_modules/@langchain/langgraph/dist/constants.d.cts.map +0 -1
- package/dist/node_modules/.pnpm/@langchain_langgraph@1.2.6_@langchain_core@1.1.40_@opentelemetry_api@1.9.0_openai@6.33._a807b9e815d3fdb40e51117306822e31/node_modules/@langchain/langgraph/dist/constants.d.ts +0 -42
- package/dist/node_modules/.pnpm/@langchain_langgraph@1.2.6_@langchain_core@1.1.40_@opentelemetry_api@1.9.0_openai@6.33._a807b9e815d3fdb40e51117306822e31/node_modules/@langchain/langgraph/dist/constants.d.ts.map +0 -1
- package/dist/node_modules/.pnpm/@langchain_langgraph@1.2.6_@langchain_core@1.1.40_@opentelemetry_api@1.9.0_openai@6.33._a807b9e815d3fdb40e51117306822e31/node_modules/@langchain/langgraph/dist/graph/zod/index.d.cts +0 -2
- package/dist/node_modules/.pnpm/@langchain_langgraph@1.2.6_@langchain_core@1.1.40_@opentelemetry_api@1.9.0_openai@6.33._a807b9e815d3fdb40e51117306822e31/node_modules/@langchain/langgraph/dist/graph/zod/index.d.ts +0 -2
- package/dist/node_modules/.pnpm/@langchain_langgraph@1.2.6_@langchain_core@1.1.40_@opentelemetry_api@1.9.0_openai@6.33._a807b9e815d3fdb40e51117306822e31/node_modules/@langchain/langgraph/dist/graph/zod/meta.d.cts +0 -109
- package/dist/node_modules/.pnpm/@langchain_langgraph@1.2.6_@langchain_core@1.1.40_@opentelemetry_api@1.9.0_openai@6.33._a807b9e815d3fdb40e51117306822e31/node_modules/@langchain/langgraph/dist/graph/zod/meta.d.cts.map +0 -1
- package/dist/node_modules/.pnpm/@langchain_langgraph@1.2.6_@langchain_core@1.1.40_@opentelemetry_api@1.9.0_openai@6.33._a807b9e815d3fdb40e51117306822e31/node_modules/@langchain/langgraph/dist/graph/zod/meta.d.ts +0 -109
- package/dist/node_modules/.pnpm/@langchain_langgraph@1.2.6_@langchain_core@1.1.40_@opentelemetry_api@1.9.0_openai@6.33._a807b9e815d3fdb40e51117306822e31/node_modules/@langchain/langgraph/dist/graph/zod/meta.d.ts.map +0 -1
- package/dist/node_modules/.pnpm/@langchain_langgraph@1.2.6_@langchain_core@1.1.40_@opentelemetry_api@1.9.0_openai@6.33._a807b9e815d3fdb40e51117306822e31/node_modules/@langchain/langgraph/dist/graph/zod/zod-registry.d.cts +0 -49
- package/dist/node_modules/.pnpm/@langchain_langgraph@1.2.6_@langchain_core@1.1.40_@opentelemetry_api@1.9.0_openai@6.33._a807b9e815d3fdb40e51117306822e31/node_modules/@langchain/langgraph/dist/graph/zod/zod-registry.d.cts.map +0 -1
- package/dist/node_modules/.pnpm/@langchain_langgraph@1.2.6_@langchain_core@1.1.40_@opentelemetry_api@1.9.0_openai@6.33._a807b9e815d3fdb40e51117306822e31/node_modules/@langchain/langgraph/dist/graph/zod/zod-registry.d.ts +0 -49
- package/dist/node_modules/.pnpm/@langchain_langgraph@1.2.6_@langchain_core@1.1.40_@opentelemetry_api@1.9.0_openai@6.33._a807b9e815d3fdb40e51117306822e31/node_modules/@langchain/langgraph/dist/graph/zod/zod-registry.d.ts.map +0 -1
- package/dist/node_modules/.pnpm/langchain@1.3.0_@langchain_core@1.1.40_@opentelemetry_api@1.9.0_openai@6.33.0_ws@8.19.0_41511a57baf32de01f36b804226da973/node_modules/langchain/dist/agents/ReactAgent.d.cts +0 -1
- package/dist/node_modules/.pnpm/langchain@1.3.0_@langchain_core@1.1.40_@opentelemetry_api@1.9.0_openai@6.33.0_ws@8.19.0_41511a57baf32de01f36b804226da973/node_modules/langchain/dist/agents/ReactAgent.d.ts +0 -1
- package/dist/node_modules/.pnpm/langchain@1.3.0_@langchain_core@1.1.40_@opentelemetry_api@1.9.0_openai@6.33.0_ws@8.19.0_41511a57baf32de01f36b804226da973/node_modules/langchain/dist/agents/index.d.cts +0 -1
- package/dist/node_modules/.pnpm/langchain@1.3.0_@langchain_core@1.1.40_@opentelemetry_api@1.9.0_openai@6.33.0_ws@8.19.0_41511a57baf32de01f36b804226da973/node_modules/langchain/dist/agents/index.d.ts +0 -1
- package/dist/node_modules/.pnpm/langchain@1.3.0_@langchain_core@1.1.40_@opentelemetry_api@1.9.0_openai@6.33.0_ws@8.19.0_41511a57baf32de01f36b804226da973/node_modules/langchain/dist/agents/middleware/contextEditing.d.cts +0 -1
- package/dist/node_modules/.pnpm/langchain@1.3.0_@langchain_core@1.1.40_@opentelemetry_api@1.9.0_openai@6.33.0_ws@8.19.0_41511a57baf32de01f36b804226da973/node_modules/langchain/dist/agents/middleware/contextEditing.d.ts +0 -1
- package/dist/node_modules/.pnpm/langchain@1.3.0_@langchain_core@1.1.40_@opentelemetry_api@1.9.0_openai@6.33.0_ws@8.19.0_41511a57baf32de01f36b804226da973/node_modules/langchain/dist/agents/middleware/dynamicSystemPrompt.d.cts +0 -1
- package/dist/node_modules/.pnpm/langchain@1.3.0_@langchain_core@1.1.40_@opentelemetry_api@1.9.0_openai@6.33.0_ws@8.19.0_41511a57baf32de01f36b804226da973/node_modules/langchain/dist/agents/middleware/dynamicSystemPrompt.d.ts +0 -1
- package/dist/node_modules/.pnpm/langchain@1.3.0_@langchain_core@1.1.40_@opentelemetry_api@1.9.0_openai@6.33.0_ws@8.19.0_41511a57baf32de01f36b804226da973/node_modules/langchain/dist/agents/middleware/hitl.d.cts +0 -1
- package/dist/node_modules/.pnpm/langchain@1.3.0_@langchain_core@1.1.40_@opentelemetry_api@1.9.0_openai@6.33.0_ws@8.19.0_41511a57baf32de01f36b804226da973/node_modules/langchain/dist/agents/middleware/hitl.d.ts +0 -1
- package/dist/node_modules/.pnpm/langchain@1.3.0_@langchain_core@1.1.40_@opentelemetry_api@1.9.0_openai@6.33.0_ws@8.19.0_41511a57baf32de01f36b804226da973/node_modules/langchain/dist/agents/middleware/llmToolSelector.d.cts +0 -1
- package/dist/node_modules/.pnpm/langchain@1.3.0_@langchain_core@1.1.40_@opentelemetry_api@1.9.0_openai@6.33.0_ws@8.19.0_41511a57baf32de01f36b804226da973/node_modules/langchain/dist/agents/middleware/llmToolSelector.d.ts +0 -1
- package/dist/node_modules/.pnpm/langchain@1.3.0_@langchain_core@1.1.40_@opentelemetry_api@1.9.0_openai@6.33.0_ws@8.19.0_41511a57baf32de01f36b804226da973/node_modules/langchain/dist/agents/middleware/modelCallLimit.d.cts +0 -1
- package/dist/node_modules/.pnpm/langchain@1.3.0_@langchain_core@1.1.40_@opentelemetry_api@1.9.0_openai@6.33.0_ws@8.19.0_41511a57baf32de01f36b804226da973/node_modules/langchain/dist/agents/middleware/modelCallLimit.d.ts +0 -1
- package/dist/node_modules/.pnpm/langchain@1.3.0_@langchain_core@1.1.40_@opentelemetry_api@1.9.0_openai@6.33.0_ws@8.19.0_41511a57baf32de01f36b804226da973/node_modules/langchain/dist/agents/middleware/modelFallback.d.cts +0 -1
- package/dist/node_modules/.pnpm/langchain@1.3.0_@langchain_core@1.1.40_@opentelemetry_api@1.9.0_openai@6.33.0_ws@8.19.0_41511a57baf32de01f36b804226da973/node_modules/langchain/dist/agents/middleware/modelFallback.d.ts +0 -1
- package/dist/node_modules/.pnpm/langchain@1.3.0_@langchain_core@1.1.40_@opentelemetry_api@1.9.0_openai@6.33.0_ws@8.19.0_41511a57baf32de01f36b804226da973/node_modules/langchain/dist/agents/middleware/modelRetry.d.cts +0 -1
- package/dist/node_modules/.pnpm/langchain@1.3.0_@langchain_core@1.1.40_@opentelemetry_api@1.9.0_openai@6.33.0_ws@8.19.0_41511a57baf32de01f36b804226da973/node_modules/langchain/dist/agents/middleware/modelRetry.d.ts +0 -1
- package/dist/node_modules/.pnpm/langchain@1.3.0_@langchain_core@1.1.40_@opentelemetry_api@1.9.0_openai@6.33.0_ws@8.19.0_41511a57baf32de01f36b804226da973/node_modules/langchain/dist/agents/middleware/pii.d.cts +0 -1
- package/dist/node_modules/.pnpm/langchain@1.3.0_@langchain_core@1.1.40_@opentelemetry_api@1.9.0_openai@6.33.0_ws@8.19.0_41511a57baf32de01f36b804226da973/node_modules/langchain/dist/agents/middleware/pii.d.ts +0 -1
- package/dist/node_modules/.pnpm/langchain@1.3.0_@langchain_core@1.1.40_@opentelemetry_api@1.9.0_openai@6.33.0_ws@8.19.0_41511a57baf32de01f36b804226da973/node_modules/langchain/dist/agents/middleware/piiRedaction.d.cts +0 -1
- package/dist/node_modules/.pnpm/langchain@1.3.0_@langchain_core@1.1.40_@opentelemetry_api@1.9.0_openai@6.33.0_ws@8.19.0_41511a57baf32de01f36b804226da973/node_modules/langchain/dist/agents/middleware/piiRedaction.d.ts +0 -1
- package/dist/node_modules/.pnpm/langchain@1.3.0_@langchain_core@1.1.40_@opentelemetry_api@1.9.0_openai@6.33.0_ws@8.19.0_41511a57baf32de01f36b804226da973/node_modules/langchain/dist/agents/middleware/provider/anthropic/promptCaching.d.cts +0 -1
- package/dist/node_modules/.pnpm/langchain@1.3.0_@langchain_core@1.1.40_@opentelemetry_api@1.9.0_openai@6.33.0_ws@8.19.0_41511a57baf32de01f36b804226da973/node_modules/langchain/dist/agents/middleware/provider/anthropic/promptCaching.d.ts +0 -1
- package/dist/node_modules/.pnpm/langchain@1.3.0_@langchain_core@1.1.40_@opentelemetry_api@1.9.0_openai@6.33.0_ws@8.19.0_41511a57baf32de01f36b804226da973/node_modules/langchain/dist/agents/middleware/provider/openai/moderation.d.cts +0 -1
- package/dist/node_modules/.pnpm/langchain@1.3.0_@langchain_core@1.1.40_@opentelemetry_api@1.9.0_openai@6.33.0_ws@8.19.0_41511a57baf32de01f36b804226da973/node_modules/langchain/dist/agents/middleware/provider/openai/moderation.d.ts +0 -1
- package/dist/node_modules/.pnpm/langchain@1.3.0_@langchain_core@1.1.40_@opentelemetry_api@1.9.0_openai@6.33.0_ws@8.19.0_41511a57baf32de01f36b804226da973/node_modules/langchain/dist/agents/middleware/summarization.d.cts +0 -1
- package/dist/node_modules/.pnpm/langchain@1.3.0_@langchain_core@1.1.40_@opentelemetry_api@1.9.0_openai@6.33.0_ws@8.19.0_41511a57baf32de01f36b804226da973/node_modules/langchain/dist/agents/middleware/summarization.d.ts +0 -1
- package/dist/node_modules/.pnpm/langchain@1.3.0_@langchain_core@1.1.40_@opentelemetry_api@1.9.0_openai@6.33.0_ws@8.19.0_41511a57baf32de01f36b804226da973/node_modules/langchain/dist/agents/middleware/todoListMiddleware.d.cts +0 -1
- package/dist/node_modules/.pnpm/langchain@1.3.0_@langchain_core@1.1.40_@opentelemetry_api@1.9.0_openai@6.33.0_ws@8.19.0_41511a57baf32de01f36b804226da973/node_modules/langchain/dist/agents/middleware/todoListMiddleware.d.ts +0 -1
- package/dist/node_modules/.pnpm/langchain@1.3.0_@langchain_core@1.1.40_@opentelemetry_api@1.9.0_openai@6.33.0_ws@8.19.0_41511a57baf32de01f36b804226da973/node_modules/langchain/dist/agents/middleware/toolCallLimit.d.cts +0 -1
- package/dist/node_modules/.pnpm/langchain@1.3.0_@langchain_core@1.1.40_@opentelemetry_api@1.9.0_openai@6.33.0_ws@8.19.0_41511a57baf32de01f36b804226da973/node_modules/langchain/dist/agents/middleware/toolCallLimit.d.ts +0 -1
- package/dist/node_modules/.pnpm/langchain@1.3.0_@langchain_core@1.1.40_@opentelemetry_api@1.9.0_openai@6.33.0_ws@8.19.0_41511a57baf32de01f36b804226da973/node_modules/langchain/dist/agents/middleware/toolEmulator.d.cts +0 -1
- package/dist/node_modules/.pnpm/langchain@1.3.0_@langchain_core@1.1.40_@opentelemetry_api@1.9.0_openai@6.33.0_ws@8.19.0_41511a57baf32de01f36b804226da973/node_modules/langchain/dist/agents/middleware/toolEmulator.d.ts +0 -1
- package/dist/node_modules/.pnpm/langchain@1.3.0_@langchain_core@1.1.40_@opentelemetry_api@1.9.0_openai@6.33.0_ws@8.19.0_41511a57baf32de01f36b804226da973/node_modules/langchain/dist/agents/middleware/toolRetry.d.cts +0 -1
- package/dist/node_modules/.pnpm/langchain@1.3.0_@langchain_core@1.1.40_@opentelemetry_api@1.9.0_openai@6.33.0_ws@8.19.0_41511a57baf32de01f36b804226da973/node_modules/langchain/dist/agents/middleware/toolRetry.d.ts +0 -1
- package/dist/node_modules/.pnpm/langchain@1.3.0_@langchain_core@1.1.40_@opentelemetry_api@1.9.0_openai@6.33.0_ws@8.19.0_41511a57baf32de01f36b804226da973/node_modules/langchain/dist/agents/middleware/types.d.cts +0 -2
- package/dist/node_modules/.pnpm/langchain@1.3.0_@langchain_core@1.1.40_@opentelemetry_api@1.9.0_openai@6.33.0_ws@8.19.0_41511a57baf32de01f36b804226da973/node_modules/langchain/dist/agents/middleware/types.d.ts +0 -2
- package/dist/node_modules/.pnpm/langchain@1.3.0_@langchain_core@1.1.40_@opentelemetry_api@1.9.0_openai@6.33.0_ws@8.19.0_41511a57baf32de01f36b804226da973/node_modules/langchain/dist/agents/middleware.d.cts +0 -1
- package/dist/node_modules/.pnpm/langchain@1.3.0_@langchain_core@1.1.40_@opentelemetry_api@1.9.0_openai@6.33.0_ws@8.19.0_41511a57baf32de01f36b804226da973/node_modules/langchain/dist/agents/middleware.d.ts +0 -1
- package/dist/node_modules/.pnpm/langchain@1.3.0_@langchain_core@1.1.40_@opentelemetry_api@1.9.0_openai@6.33.0_ws@8.19.0_41511a57baf32de01f36b804226da973/node_modules/langchain/dist/agents/types.d.cts +0 -2
- package/dist/node_modules/.pnpm/langchain@1.3.0_@langchain_core@1.1.40_@opentelemetry_api@1.9.0_openai@6.33.0_ws@8.19.0_41511a57baf32de01f36b804226da973/node_modules/langchain/dist/agents/types.d.ts +0 -2
- package/dist/node_modules/.pnpm/langchain@1.3.0_@langchain_core@1.1.40_@opentelemetry_api@1.9.0_openai@6.33.0_ws@8.19.0_41511a57baf32de01f36b804226da973/node_modules/langchain/dist/index.d.cts +0 -2
- package/dist/node_modules/.pnpm/langchain@1.3.0_@langchain_core@1.1.40_@opentelemetry_api@1.9.0_openai@6.33.0_ws@8.19.0_41511a57baf32de01f36b804226da973/node_modules/langchain/dist/index.d.ts +0 -2
- package/dist/node_modules/.pnpm/zod@4.3.6/node_modules/zod/v4/core/checks.d.cts +0 -29
- package/dist/node_modules/.pnpm/zod@4.3.6/node_modules/zod/v4/core/checks.d.cts.map +0 -1
- package/dist/node_modules/.pnpm/zod@4.3.6/node_modules/zod/v4/core/checks.d.ts +0 -29
- package/dist/node_modules/.pnpm/zod@4.3.6/node_modules/zod/v4/core/checks.d.ts.map +0 -1
- package/dist/node_modules/.pnpm/zod@4.3.6/node_modules/zod/v4/core/core.d.cts +0 -29
- package/dist/node_modules/.pnpm/zod@4.3.6/node_modules/zod/v4/core/core.d.cts.map +0 -1
- package/dist/node_modules/.pnpm/zod@4.3.6/node_modules/zod/v4/core/core.d.ts +0 -29
- package/dist/node_modules/.pnpm/zod@4.3.6/node_modules/zod/v4/core/core.d.ts.map +0 -1
- package/dist/node_modules/.pnpm/zod@4.3.6/node_modules/zod/v4/core/errors.d.cts +0 -105
- package/dist/node_modules/.pnpm/zod@4.3.6/node_modules/zod/v4/core/errors.d.cts.map +0 -1
- package/dist/node_modules/.pnpm/zod@4.3.6/node_modules/zod/v4/core/errors.d.ts +0 -105
- package/dist/node_modules/.pnpm/zod@4.3.6/node_modules/zod/v4/core/errors.d.ts.map +0 -1
- package/dist/node_modules/.pnpm/zod@4.3.6/node_modules/zod/v4/core/json-schema.d.cts +0 -70
- package/dist/node_modules/.pnpm/zod@4.3.6/node_modules/zod/v4/core/json-schema.d.cts.map +0 -1
- package/dist/node_modules/.pnpm/zod@4.3.6/node_modules/zod/v4/core/json-schema.d.ts +0 -70
- package/dist/node_modules/.pnpm/zod@4.3.6/node_modules/zod/v4/core/json-schema.d.ts.map +0 -1
- package/dist/node_modules/.pnpm/zod@4.3.6/node_modules/zod/v4/core/registries.d.cts +0 -24
- package/dist/node_modules/.pnpm/zod@4.3.6/node_modules/zod/v4/core/registries.d.cts.map +0 -1
- package/dist/node_modules/.pnpm/zod@4.3.6/node_modules/zod/v4/core/registries.d.ts +0 -24
- package/dist/node_modules/.pnpm/zod@4.3.6/node_modules/zod/v4/core/registries.d.ts.map +0 -1
- package/dist/node_modules/.pnpm/zod@4.3.6/node_modules/zod/v4/core/schemas.d.cts +0 -97
- package/dist/node_modules/.pnpm/zod@4.3.6/node_modules/zod/v4/core/schemas.d.cts.map +0 -1
- package/dist/node_modules/.pnpm/zod@4.3.6/node_modules/zod/v4/core/schemas.d.ts +0 -97
- package/dist/node_modules/.pnpm/zod@4.3.6/node_modules/zod/v4/core/schemas.d.ts.map +0 -1
- package/dist/node_modules/.pnpm/zod@4.3.6/node_modules/zod/v4/core/standard-schema.d.cts +0 -79
- package/dist/node_modules/.pnpm/zod@4.3.6/node_modules/zod/v4/core/standard-schema.d.cts.map +0 -1
- package/dist/node_modules/.pnpm/zod@4.3.6/node_modules/zod/v4/core/standard-schema.d.ts +0 -79
- package/dist/node_modules/.pnpm/zod@4.3.6/node_modules/zod/v4/core/standard-schema.d.ts.map +0 -1
- package/dist/node_modules/.pnpm/zod@4.3.6/node_modules/zod/v4/core/to-json-schema.d.cts +0 -52
- package/dist/node_modules/.pnpm/zod@4.3.6/node_modules/zod/v4/core/to-json-schema.d.cts.map +0 -1
- package/dist/node_modules/.pnpm/zod@4.3.6/node_modules/zod/v4/core/to-json-schema.d.ts +0 -52
- package/dist/node_modules/.pnpm/zod@4.3.6/node_modules/zod/v4/core/to-json-schema.d.ts.map +0 -1
- package/dist/node_modules/.pnpm/zod@4.3.6/node_modules/zod/v4/core/util.d.cts +0 -17
- package/dist/node_modules/.pnpm/zod@4.3.6/node_modules/zod/v4/core/util.d.cts.map +0 -1
- package/dist/node_modules/.pnpm/zod@4.3.6/node_modules/zod/v4/core/util.d.ts +0 -17
- package/dist/node_modules/.pnpm/zod@4.3.6/node_modules/zod/v4/core/util.d.ts.map +0 -1
- package/dist/node_modules/.pnpm/zod@4.3.6/node_modules/zod/v4/core/versions.d.cts +0 -9
- package/dist/node_modules/.pnpm/zod@4.3.6/node_modules/zod/v4/core/versions.d.cts.map +0 -1
- package/dist/node_modules/.pnpm/zod@4.3.6/node_modules/zod/v4/core/versions.d.ts +0 -9
- package/dist/node_modules/.pnpm/zod@4.3.6/node_modules/zod/v4/core/versions.d.ts.map +0 -1
- package/dist/stream-service-instance.d.cts +0 -70
- package/dist/stream-service-instance.d.cts.map +0 -1
- package/dist/stream-service-instance.d.ts +0 -70
- package/dist/stream-service-instance.d.ts.map +0 -1
- package/dist/stream.custom.cjs +0 -117
- package/dist/stream.custom.cjs.map +0 -1
- package/dist/stream.custom.d.cts +0 -45
- package/dist/stream.custom.d.cts.map +0 -1
- package/dist/stream.custom.d.ts +0 -45
- package/dist/stream.custom.d.ts.map +0 -1
- package/dist/stream.custom.js +0 -116
- package/dist/stream.custom.js.map +0 -1
- package/dist/stream.lgp.cjs +0 -174
- package/dist/stream.lgp.cjs.map +0 -1
- package/dist/stream.lgp.d.cts +0 -57
- package/dist/stream.lgp.d.cts.map +0 -1
- package/dist/stream.lgp.d.ts +0 -57
- package/dist/stream.lgp.d.ts.map +0 -1
- package/dist/stream.lgp.js +0 -174
- package/dist/stream.lgp.js.map +0 -1
- package/dist/subagents.cjs +0 -76
- package/dist/subagents.cjs.map +0 -1
- package/dist/subagents.js +0 -76
- package/dist/subagents.js.map +0 -1
|
@@ -0,0 +1,155 @@
|
|
|
1
|
+
let _angular_core = require("@angular/core");
|
|
2
|
+
let _langchain_langgraph_sdk = require("@langchain/langgraph-sdk");
|
|
3
|
+
let _langchain_langgraph_sdk_client = require("@langchain/langgraph-sdk/client");
|
|
4
|
+
let _langchain_langgraph_sdk_stream = require("@langchain/langgraph-sdk/stream");
|
|
5
|
+
//#region src/use-stream.ts
|
|
6
|
+
/**
|
|
7
|
+
* Private field on the handle that carries the
|
|
8
|
+
* {@link StreamController} reference. Selector primitives read this
|
|
9
|
+
* to reach the shared {@link ChannelRegistry}. Use the companion
|
|
10
|
+
* `inject*` selectors (`injectMessages`, `injectToolCalls`,
|
|
11
|
+
* `injectValues`, …) instead of reading this directly.
|
|
12
|
+
*/
|
|
13
|
+
const STREAM_CONTROLLER = Symbol.for("@langchain/angular/controller");
|
|
14
|
+
/**
|
|
15
|
+
* Framework-free factory that constructs a {@link StreamController}
|
|
16
|
+
* and wraps its stores in Angular Signals. Callers must supply the
|
|
17
|
+
* {@link DestroyRef} that owns the controller's lifetime — it's
|
|
18
|
+
* already captured by the public `injectStream` helper.
|
|
19
|
+
*
|
|
20
|
+
* Exported for advanced callers (e.g. testing utilities, custom
|
|
21
|
+
* factories) that prefer to manage injection scope themselves.
|
|
22
|
+
*/
|
|
23
|
+
function useStream(options, destroyRef) {
|
|
24
|
+
const asBag = options;
|
|
25
|
+
const hasCustomAdapter = asBag.transport != null && typeof asBag.transport !== "string";
|
|
26
|
+
const transport = asBag.transport;
|
|
27
|
+
const client = asBag.client ?? new _langchain_langgraph_sdk_client.Client({
|
|
28
|
+
apiUrl: asBag.apiUrl,
|
|
29
|
+
apiKey: asBag.apiKey,
|
|
30
|
+
callerOptions: asBag.callerOptions,
|
|
31
|
+
defaultHeaders: asBag.defaultHeaders
|
|
32
|
+
});
|
|
33
|
+
const sentinel = "_";
|
|
34
|
+
const assistantId = "assistantId" in options ? options.assistantId ?? sentinel : sentinel;
|
|
35
|
+
const threadIdInput = (() => {
|
|
36
|
+
const raw = asBag.threadId;
|
|
37
|
+
if ((0, _angular_core.isSignal)(raw)) return (0, _angular_core.computed)(() => raw() ?? null);
|
|
38
|
+
return (0, _angular_core.signal)(raw ?? null);
|
|
39
|
+
})();
|
|
40
|
+
const controller = new _langchain_langgraph_sdk_stream.StreamController({
|
|
41
|
+
assistantId,
|
|
42
|
+
client,
|
|
43
|
+
threadId: (0, _angular_core.untracked)(() => threadIdInput()),
|
|
44
|
+
transport,
|
|
45
|
+
fetch: hasCustomAdapter ? void 0 : asBag.fetch,
|
|
46
|
+
webSocketFactory: hasCustomAdapter ? void 0 : asBag.webSocketFactory,
|
|
47
|
+
onThreadId: options.onThreadId,
|
|
48
|
+
onCreated: options.onCreated,
|
|
49
|
+
initialValues: options.initialValues,
|
|
50
|
+
messagesKey: options.messagesKey
|
|
51
|
+
});
|
|
52
|
+
const deactivate = controller.activate();
|
|
53
|
+
const ref = destroyRef ?? (0, _angular_core.inject)(_angular_core.DestroyRef);
|
|
54
|
+
ref.onDestroy(deactivate);
|
|
55
|
+
function bindStore(subscribe, getSnapshot) {
|
|
56
|
+
const s = (0, _angular_core.signal)(getSnapshot());
|
|
57
|
+
const unsubscribe = subscribe(() => {
|
|
58
|
+
s.set(getSnapshot());
|
|
59
|
+
});
|
|
60
|
+
ref.onDestroy(unsubscribe);
|
|
61
|
+
return (0, _angular_core.computed)(() => s());
|
|
62
|
+
}
|
|
63
|
+
const rootSignal = bindStore(controller.rootStore.subscribe, controller.rootStore.getSnapshot);
|
|
64
|
+
const subagentSignal = bindStore(controller.subagentStore.subscribe, controller.subagentStore.getSnapshot);
|
|
65
|
+
const subgraphSignal = bindStore(controller.subgraphStore.subscribe, controller.subgraphStore.getSnapshot);
|
|
66
|
+
const subgraphByNodeSignal = bindStore(controller.subgraphByNodeStore.subscribe, controller.subgraphByNodeStore.getSnapshot);
|
|
67
|
+
const values = (0, _angular_core.computed)(() => rootSignal().values);
|
|
68
|
+
const messages = (0, _angular_core.computed)(() => rootSignal().messages);
|
|
69
|
+
const toolCalls = (0, _angular_core.computed)(() => rootSignal().toolCalls);
|
|
70
|
+
const interrupts = (0, _angular_core.computed)(() => (0, _langchain_langgraph_sdk.filterOutHeadlessToolInterrupts)(rootSignal().interrupts));
|
|
71
|
+
const interrupt = (0, _angular_core.computed)(() => interrupts()[0]);
|
|
72
|
+
const isLoading = (0, _angular_core.computed)(() => rootSignal().isLoading);
|
|
73
|
+
const isThreadLoading = (0, _angular_core.computed)(() => rootSignal().isThreadLoading);
|
|
74
|
+
const error = (0, _angular_core.computed)(() => rootSignal().error);
|
|
75
|
+
const threadId = (0, _angular_core.computed)(() => rootSignal().threadId);
|
|
76
|
+
const hydrationPromise = (0, _angular_core.computed)(() => {
|
|
77
|
+
rootSignal();
|
|
78
|
+
return controller.hydrationPromise;
|
|
79
|
+
});
|
|
80
|
+
let lastAppliedThreadId = (0, _angular_core.untracked)(() => threadIdInput()) ?? null;
|
|
81
|
+
(0, _angular_core.effect)(() => {
|
|
82
|
+
const next = threadIdInput() ?? null;
|
|
83
|
+
if (next === lastAppliedThreadId) return;
|
|
84
|
+
lastAppliedThreadId = next;
|
|
85
|
+
(0, _angular_core.untracked)(() => {
|
|
86
|
+
controller.hydrate(next);
|
|
87
|
+
});
|
|
88
|
+
});
|
|
89
|
+
const tools = options.tools;
|
|
90
|
+
const onTool = options.onTool;
|
|
91
|
+
if (tools?.length) {
|
|
92
|
+
const handledTools = /* @__PURE__ */ new Set();
|
|
93
|
+
(0, _angular_core.effect)(() => {
|
|
94
|
+
threadIdInput();
|
|
95
|
+
(0, _angular_core.untracked)(() => handledTools.clear());
|
|
96
|
+
});
|
|
97
|
+
(0, _angular_core.effect)(() => {
|
|
98
|
+
const snapshot = rootSignal();
|
|
99
|
+
const bag = snapshot.values;
|
|
100
|
+
const combined = [...Array.isArray(bag?.__interrupt__) ? bag.__interrupt__ : [], ...snapshot.interrupts];
|
|
101
|
+
if (combined.length === 0) return;
|
|
102
|
+
(0, _angular_core.untracked)(() => {
|
|
103
|
+
(0, _langchain_langgraph_sdk.flushPendingHeadlessToolInterrupts)({
|
|
104
|
+
...bag,
|
|
105
|
+
__interrupt__: combined
|
|
106
|
+
}, tools, handledTools, {
|
|
107
|
+
onTool,
|
|
108
|
+
defer: (run) => {
|
|
109
|
+
Promise.resolve().then(run);
|
|
110
|
+
},
|
|
111
|
+
resumeSubmit: (command) => controller.submit(null, { command })
|
|
112
|
+
});
|
|
113
|
+
});
|
|
114
|
+
});
|
|
115
|
+
}
|
|
116
|
+
return {
|
|
117
|
+
values,
|
|
118
|
+
messages,
|
|
119
|
+
toolCalls,
|
|
120
|
+
interrupts,
|
|
121
|
+
interrupt,
|
|
122
|
+
isLoading,
|
|
123
|
+
isThreadLoading,
|
|
124
|
+
error,
|
|
125
|
+
threadId,
|
|
126
|
+
hydrationPromise,
|
|
127
|
+
subagents: subagentSignal,
|
|
128
|
+
subgraphs: subgraphSignal,
|
|
129
|
+
subgraphsByNode: subgraphByNodeSignal,
|
|
130
|
+
submit: (input, submitOptions) => controller.submit(input, submitOptions),
|
|
131
|
+
stop: () => controller.stop(),
|
|
132
|
+
respond: (response, target) => controller.respond(response, target),
|
|
133
|
+
getThread: () => controller.getThread(),
|
|
134
|
+
client,
|
|
135
|
+
assistantId,
|
|
136
|
+
[STREAM_CONTROLLER]: controller
|
|
137
|
+
};
|
|
138
|
+
}
|
|
139
|
+
/**
|
|
140
|
+
* Helper used by the selector primitives to reach the underlying
|
|
141
|
+
* {@link ChannelRegistry} from a stream handle. Kept internal —
|
|
142
|
+
* application code should call `injectMessages`, `injectToolCalls`,
|
|
143
|
+
* etc. instead of reading this directly.
|
|
144
|
+
*
|
|
145
|
+
* @internal
|
|
146
|
+
*/
|
|
147
|
+
function getRegistry(stream) {
|
|
148
|
+
return stream[STREAM_CONTROLLER].registry;
|
|
149
|
+
}
|
|
150
|
+
//#endregion
|
|
151
|
+
exports.STREAM_CONTROLLER = STREAM_CONTROLLER;
|
|
152
|
+
exports.getRegistry = getRegistry;
|
|
153
|
+
exports.useStream = useStream;
|
|
154
|
+
|
|
155
|
+
//# sourceMappingURL=use-stream.cjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"use-stream.cjs","names":["ClientCtor","StreamController","DestroyRef"],"sources":["../src/use-stream.ts"],"sourcesContent":["import {\n DestroyRef,\n computed,\n effect,\n inject,\n isSignal,\n signal,\n untracked,\n type Signal,\n} from \"@angular/core\";\nimport type { BaseMessage } from \"@langchain/core/messages\";\nimport type { Client, Interrupt } from \"@langchain/langgraph-sdk\";\nimport {\n filterOutHeadlessToolInterrupts,\n flushPendingHeadlessToolInterrupts,\n type AnyHeadlessToolImplementation,\n type OnToolCallback,\n} from \"@langchain/langgraph-sdk\";\nimport {\n Client as ClientCtor,\n type ClientConfig,\n type ThreadStream,\n} from \"@langchain/langgraph-sdk/client\";\nimport {\n StreamController,\n type AgentServerAdapter,\n type AgentServerOptions as StreamAgentServerOptions,\n type AssembledToolCall,\n type ChannelRegistry,\n type CustomAdapterOptions as StreamCustomAdapterOptions,\n type InferStateType,\n type InferSubagentStates,\n type RootSnapshot,\n type StateOf as StreamStateOf,\n type StreamSubmitOptions,\n type SubagentDiscoverySnapshot,\n type SubagentMap,\n type SubgraphByNodeMap,\n type SubgraphDiscoverySnapshot,\n type SubgraphMap,\n type UseStreamOptions as StreamUseStreamOptions,\n type WidenUpdateMessages,\n} from \"@langchain/langgraph-sdk/stream\";\n\n/** @deprecated Prefer {@link InferStateType}. */\nexport type StateOf<T> = StreamStateOf<T>;\n\ntype AngularThreadId = string | null | Signal<string | null | undefined>;\n\nexport type AgentServerOptions<StateType extends object> =\n StreamAgentServerOptions<StateType, AngularThreadId>;\n\nexport type CustomAdapterOptions<StateType extends object> =\n StreamCustomAdapterOptions<StateType, AngularThreadId, string>;\n\nexport type UseStreamOptions<\n StateType extends object = Record<string, unknown>,\n> = StreamUseStreamOptions<\n StateType,\n AngularThreadId,\n string | undefined,\n string | undefined,\n string\n>;\n\n/**\n * Private field on the handle that carries the\n * {@link StreamController} reference. Selector primitives read this\n * to reach the shared {@link ChannelRegistry}. Use the companion\n * `inject*` selectors (`injectMessages`, `injectToolCalls`,\n * `injectValues`, …) instead of reading this directly.\n */\nexport const STREAM_CONTROLLER: unique symbol = Symbol.for(\n \"@langchain/angular/controller\"\n);\n\n/**\n * Return shape of {@link useStream} — the Angular `StreamApi`.\n *\n * Reactivity primitives follow Angular conventions:\n *\n * - Data projections are `Signal<T>`; call them as functions in\n * templates (`stream.messages()`). They are snapshots — never\n * mutate the returned arrays / maps.\n * - Imperative methods (`submit` / `stop` / `respond`) are plain\n * functions. No `WritableSignal`s are exposed on the root handle.\n * - Identity values captured at construction time (`client`,\n * `assistantId`) are exposed as plain values; remount the\n * component to swap them.\n */\nexport interface UseStreamReturn<\n T = Record<string, unknown>,\n InterruptType = unknown,\n ConfigurableType extends object = Record<string, unknown>,\n StateType extends object = InferStateType<T>,\n SubagentStates = InferSubagentStates<T>,\n> {\n readonly values: Signal<StateType>;\n readonly messages: Signal<BaseMessage[]>;\n readonly toolCalls: Signal<AssembledToolCall[]>;\n readonly interrupts: Signal<Interrupt<InterruptType>[]>;\n readonly interrupt: Signal<Interrupt<InterruptType> | undefined>;\n readonly isLoading: Signal<boolean>;\n readonly isThreadLoading: Signal<boolean>;\n readonly error: Signal<unknown>;\n readonly threadId: Signal<string | null>;\n\n /**\n * Promise that settles when the active thread's initial hydration\n * completes. Exposed so SSR/render-before-flush pipelines can\n * `await stream.hydrationPromise` before serialising.\n */\n readonly hydrationPromise: Signal<Promise<void>>;\n\n readonly subagents: Signal<\n ReadonlyMap<\n keyof SubagentStates & string extends never\n ? string\n : keyof SubagentStates & string,\n SubagentDiscoverySnapshot\n >\n >;\n readonly subgraphs: Signal<ReadonlyMap<string, SubgraphDiscoverySnapshot>>;\n readonly subgraphsByNode: Signal<\n ReadonlyMap<string, readonly SubgraphDiscoverySnapshot[]>\n >;\n\n submit(\n input: WidenUpdateMessages<Partial<StateType>> | null | undefined,\n options?: StreamSubmitOptions<StateType, ConfigurableType>\n ): Promise<void>;\n stop(): Promise<void>;\n respond(\n response: unknown,\n target?: { interruptId: string; namespace?: string[] }\n ): Promise<void>;\n\n readonly client: Client;\n readonly assistantId: string;\n\n /** v2 escape hatch — returns the bound {@link ThreadStream}. */\n getThread(): ThreadStream | undefined;\n\n /** @internal Used by selector primitives. */\n readonly [STREAM_CONTROLLER]: StreamController<\n StateType,\n InterruptType,\n ConfigurableType\n >;\n}\n\n/**\n * Erased handle useful as a parameter type for helper components that\n * pass a `stream` through to selector primitives without reading\n * `values` directly. Mirrors the React/Vue `AnyStream` alias.\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type AnyStream = UseStreamReturn<any, any, any>;\n\n/**\n * Convenience alias — the fully-resolved return type of\n * {@link useStream} for a given source type `T`.\n */\nexport type StreamApi<\n T = Record<string, unknown>,\n InterruptType = unknown,\n ConfigurableType extends object = Record<string, unknown>,\n> = UseStreamReturn<T, InterruptType, ConfigurableType>;\n\n/**\n * React-compatible alias for the fully-resolved stream handle type.\n * Angular docs prefer {@link StreamApi}, but shared libraries can use\n * this name across framework bindings.\n */\nexport type UseStreamResult<\n T = Record<string, unknown>,\n InterruptType = unknown,\n ConfigurableType extends object = Record<string, unknown>,\n> = UseStreamReturn<T, InterruptType, ConfigurableType>;\n\n/**\n * Framework-free factory that constructs a {@link StreamController}\n * and wraps its stores in Angular Signals. Callers must supply the\n * {@link DestroyRef} that owns the controller's lifetime — it's\n * already captured by the public `injectStream` helper.\n *\n * Exported for advanced callers (e.g. testing utilities, custom\n * factories) that prefer to manage injection scope themselves.\n */\nexport function useStream<\n T = Record<string, unknown>,\n InterruptType = unknown,\n ConfigurableType extends object = Record<string, unknown>,\n>(\n options: UseStreamOptions<InferStateType<T>>,\n destroyRef?: DestroyRef\n): UseStreamReturn<T, InterruptType, ConfigurableType> {\n type StateType = InferStateType<T>;\n\n interface OptionsBag {\n assistantId?: string;\n threadId?: string | null | Signal<string | null | undefined>;\n client?: Client;\n apiUrl?: string;\n apiKey?: string;\n callerOptions?: ClientConfig[\"callerOptions\"];\n defaultHeaders?: ClientConfig[\"defaultHeaders\"];\n transport?: \"sse\" | \"websocket\" | AgentServerAdapter;\n fetch?: typeof fetch;\n webSocketFactory?: (url: string) => WebSocket;\n onThreadId?: (threadId: string) => void;\n onCreated?: (meta: { run_id: string; thread_id: string }) => void;\n initialValues?: StateType;\n messagesKey?: string;\n tools?: AnyHeadlessToolImplementation[];\n onTool?: OnToolCallback;\n }\n const asBag = options as OptionsBag;\n\n const hasCustomAdapter =\n asBag.transport != null && typeof asBag.transport !== \"string\";\n const transport = asBag.transport;\n\n const client: Client =\n asBag.client ??\n (new ClientCtor({\n apiUrl: asBag.apiUrl,\n apiKey: asBag.apiKey,\n callerOptions: asBag.callerOptions,\n defaultHeaders: asBag.defaultHeaders,\n }) as unknown as Client);\n\n // Custom adapters may omit `assistantId`; the controller still\n // requires one so it has something to forward to `threads.stream`.\n const sentinel = \"_\";\n const assistantId =\n \"assistantId\" in options ? (options.assistantId ?? sentinel) : sentinel;\n\n // Normalize threadId input to a signal — callers may pass plain\n // values, nulls, or their own signals.\n const threadIdInput: Signal<string | null> = (() => {\n const raw = asBag.threadId;\n if (isSignal(raw)) {\n return computed(\n () => (raw as Signal<string | null | undefined>)() ?? null\n );\n }\n const initial: string | null = (raw as string | null | undefined) ?? null;\n return signal(initial) as unknown as Signal<string | null>;\n })();\n\n const controller = new StreamController<\n StateType,\n InterruptType,\n ConfigurableType\n >({\n assistantId,\n // Cast: the runtime `Client` is state-shape agnostic, but the\n // controller declares `client: Client<StateType>` for its own\n // typings. Same cast is applied in the React/Vue bindings.\n client: client as unknown as Client<StateType>,\n threadId: untracked(() => threadIdInput()),\n transport,\n fetch: hasCustomAdapter ? undefined : asBag.fetch,\n webSocketFactory: hasCustomAdapter ? undefined : asBag.webSocketFactory,\n onThreadId: options.onThreadId,\n onCreated: options.onCreated,\n initialValues: options.initialValues,\n messagesKey: options.messagesKey,\n });\n\n // Deferred dispose — matches the React `useEffect(() =>\n // controller.activate())` and Vue `onScopeDispose(deactivate)`\n // patterns. HMR / scope-reuse scenarios stay clean because\n // `activate()` cancels the pending dispose if the scope survives.\n const deactivate = controller.activate();\n const ref = destroyRef ?? inject(DestroyRef);\n ref.onDestroy(deactivate);\n\n // ─── Reactivity bridge: StreamStore → Signal ────────────────────────\n function bindStore<S>(\n subscribe: (listener: () => void) => () => void,\n getSnapshot: () => S\n ): Signal<S> {\n const s = signal<S>(getSnapshot());\n const unsubscribe = subscribe(() => {\n s.set(getSnapshot());\n });\n ref.onDestroy(unsubscribe);\n return computed(() => s());\n }\n\n const rootSignal = bindStore<RootSnapshot<StateType, InterruptType>>(\n controller.rootStore.subscribe,\n controller.rootStore.getSnapshot\n );\n const subagentSignal = bindStore<SubagentMap>(\n controller.subagentStore.subscribe,\n controller.subagentStore.getSnapshot\n );\n const subgraphSignal = bindStore<SubgraphMap>(\n controller.subgraphStore.subscribe,\n controller.subgraphStore.getSnapshot\n );\n const subgraphByNodeSignal = bindStore<SubgraphByNodeMap>(\n controller.subgraphByNodeStore.subscribe,\n controller.subgraphByNodeStore.getSnapshot\n );\n\n const values = computed(() => rootSignal().values);\n const messages = computed(() => rootSignal().messages);\n const toolCalls = computed(() => rootSignal().toolCalls);\n const interrupts = computed(() =>\n filterOutHeadlessToolInterrupts(rootSignal().interrupts)\n );\n const interrupt = computed(() => interrupts()[0]);\n const isLoading = computed(() => rootSignal().isLoading);\n const isThreadLoading = computed(() => rootSignal().isThreadLoading);\n const error = computed(() => rootSignal().error);\n const threadId = computed(() => rootSignal().threadId);\n\n // `hydrationPromise` is a property on the controller that gets\n // swapped on every `hydrate()` call. Exposing it as a signal lets\n // templates `await stream.hydrationPromise()` reactively; we\n // refresh the reference when the root store settles a new promise.\n const hydrationPromise = computed(() => {\n rootSignal();\n return controller.hydrationPromise;\n });\n\n // ─── threadId reactivity ────────────────────────────────────────────\n //\n // Re-hydrate whenever the caller's threadId input changes after\n // construction. The initial hydrate already fired synchronously in\n // the controller constructor, so we compare against the snapshot\n // captured at construction time rather than blindly skipping the\n // first run — in Angular, `@Input()` bindings apply *between*\n // construction and the first effect tick, so the first read can\n // legitimately be a different (updated) value that needs to\n // hydrate.\n const initialThreadId = untracked(() => threadIdInput()) ?? null;\n let lastAppliedThreadId: string | null = initialThreadId;\n effect(() => {\n const next = threadIdInput() ?? null;\n if (next === lastAppliedThreadId) return;\n lastAppliedThreadId = next;\n untracked(() => {\n void controller.hydrate(next);\n });\n });\n\n // ─── Headless-tool handling ─────────────────────────────────────────\n const tools = options.tools;\n const onTool = options.onTool;\n if (tools?.length) {\n const handledTools = new Set<string>();\n\n // Clear the dedup set whenever the thread id changes.\n effect(() => {\n threadIdInput();\n untracked(() => handledTools.clear());\n });\n\n effect(() => {\n const snapshot = rootSignal();\n const bag = snapshot.values as unknown as Record<string, unknown>;\n const existing = Array.isArray(bag?.__interrupt__)\n ? (bag.__interrupt__ as Interrupt[])\n : [];\n const combined: Interrupt[] = [\n ...existing,\n ...(snapshot.interrupts as unknown as Interrupt[]),\n ];\n if (combined.length === 0) return;\n untracked(() => {\n flushPendingHeadlessToolInterrupts(\n { ...bag, __interrupt__: combined },\n tools,\n handledTools,\n {\n onTool,\n defer: (run) => {\n void Promise.resolve().then(run);\n },\n resumeSubmit: (command) =>\n controller.submit(null, {\n command,\n } as StreamSubmitOptions<StateType, ConfigurableType>),\n }\n );\n });\n });\n }\n\n const handle: UseStreamReturn<T, InterruptType, ConfigurableType> = {\n values: values as UseStreamReturn<\n T,\n InterruptType,\n ConfigurableType\n >[\"values\"],\n messages,\n toolCalls,\n interrupts,\n interrupt,\n isLoading,\n isThreadLoading,\n error,\n threadId,\n hydrationPromise,\n subagents: subagentSignal as UseStreamReturn<\n T,\n InterruptType,\n ConfigurableType\n >[\"subagents\"],\n subgraphs: subgraphSignal,\n subgraphsByNode: subgraphByNodeSignal,\n submit: (input, submitOptions) => controller.submit(input, submitOptions),\n stop: () => controller.stop(),\n respond: (response, target) => controller.respond(response, target),\n getThread: () => controller.getThread(),\n client,\n assistantId,\n [STREAM_CONTROLLER]: controller,\n };\n\n return handle;\n}\n\n/**\n * Helper used by the selector primitives to reach the underlying\n * {@link ChannelRegistry} from a stream handle. Kept internal —\n * application code should call `injectMessages`, `injectToolCalls`,\n * etc. instead of reading this directly.\n *\n * @internal\n */\nexport function getRegistry(\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n stream: UseStreamReturn<any, any, any>\n): ChannelRegistry {\n return stream[STREAM_CONTROLLER].registry;\n}\n\nexport type { ThreadStream };\n"],"mappings":";;;;;;;;;;;;AAwEA,MAAa,oBAAmC,OAAO,IACrD,gCACD;;;;;;;;;;AAmHD,SAAgB,UAKd,SACA,YACqD;CAqBrD,MAAM,QAAQ;CAEd,MAAM,mBACJ,MAAM,aAAa,QAAQ,OAAO,MAAM,cAAc;CACxD,MAAM,YAAY,MAAM;CAExB,MAAM,SACJ,MAAM,UACL,IAAIA,gCAAAA,OAAW;EACd,QAAQ,MAAM;EACd,QAAQ,MAAM;EACd,eAAe,MAAM;EACrB,gBAAgB,MAAM;EACvB,CAAC;CAIJ,MAAM,WAAW;CACjB,MAAM,cACJ,iBAAiB,UAAW,QAAQ,eAAe,WAAY;CAIjE,MAAM,uBAA8C;EAClD,MAAM,MAAM,MAAM;AAClB,OAAA,GAAA,cAAA,UAAa,IAAI,CACf,SAAA,GAAA,cAAA,gBACS,KAA2C,IAAI,KACvD;AAGH,UAAA,GAAA,cAAA,QADgC,OAAqC,KAC/C;KACpB;CAEJ,MAAM,aAAa,IAAIC,gCAAAA,iBAIrB;EACA;EAIQ;EACR,WAAA,GAAA,cAAA,iBAA0B,eAAe,CAAC;EAC1C;EACA,OAAO,mBAAmB,KAAA,IAAY,MAAM;EAC5C,kBAAkB,mBAAmB,KAAA,IAAY,MAAM;EACvD,YAAY,QAAQ;EACpB,WAAW,QAAQ;EACnB,eAAe,QAAQ;EACvB,aAAa,QAAQ;EACtB,CAAC;CAMF,MAAM,aAAa,WAAW,UAAU;CACxC,MAAM,MAAM,eAAA,GAAA,cAAA,QAAqBC,cAAAA,WAAW;AAC5C,KAAI,UAAU,WAAW;CAGzB,SAAS,UACP,WACA,aACW;EACX,MAAM,KAAA,GAAA,cAAA,QAAc,aAAa,CAAC;EAClC,MAAM,cAAc,gBAAgB;AAClC,KAAE,IAAI,aAAa,CAAC;IACpB;AACF,MAAI,UAAU,YAAY;AAC1B,UAAA,GAAA,cAAA,gBAAsB,GAAG,CAAC;;CAG5B,MAAM,aAAa,UACjB,WAAW,UAAU,WACrB,WAAW,UAAU,YACtB;CACD,MAAM,iBAAiB,UACrB,WAAW,cAAc,WACzB,WAAW,cAAc,YAC1B;CACD,MAAM,iBAAiB,UACrB,WAAW,cAAc,WACzB,WAAW,cAAc,YAC1B;CACD,MAAM,uBAAuB,UAC3B,WAAW,oBAAoB,WAC/B,WAAW,oBAAoB,YAChC;CAED,MAAM,UAAA,GAAA,cAAA,gBAAwB,YAAY,CAAC,OAAO;CAClD,MAAM,YAAA,GAAA,cAAA,gBAA0B,YAAY,CAAC,SAAS;CACtD,MAAM,aAAA,GAAA,cAAA,gBAA2B,YAAY,CAAC,UAAU;CACxD,MAAM,cAAA,GAAA,cAAA,iBAAA,GAAA,yBAAA,iCAC4B,YAAY,CAAC,WAAW,CACzD;CACD,MAAM,aAAA,GAAA,cAAA,gBAA2B,YAAY,CAAC,GAAG;CACjD,MAAM,aAAA,GAAA,cAAA,gBAA2B,YAAY,CAAC,UAAU;CACxD,MAAM,mBAAA,GAAA,cAAA,gBAAiC,YAAY,CAAC,gBAAgB;CACpE,MAAM,SAAA,GAAA,cAAA,gBAAuB,YAAY,CAAC,MAAM;CAChD,MAAM,YAAA,GAAA,cAAA,gBAA0B,YAAY,CAAC,SAAS;CAMtD,MAAM,oBAAA,GAAA,cAAA,gBAAkC;AACtC,cAAY;AACZ,SAAO,WAAW;GAClB;CAaF,IAAI,uBAAA,GAAA,cAAA,iBADoC,eAAe,CAAC,IAAI;AAE5D,EAAA,GAAA,cAAA,cAAa;EACX,MAAM,OAAO,eAAe,IAAI;AAChC,MAAI,SAAS,oBAAqB;AAClC,wBAAsB;AACtB,GAAA,GAAA,cAAA,iBAAgB;AACT,cAAW,QAAQ,KAAK;IAC7B;GACF;CAGF,MAAM,QAAQ,QAAQ;CACtB,MAAM,SAAS,QAAQ;AACvB,KAAI,OAAO,QAAQ;EACjB,MAAM,+BAAe,IAAI,KAAa;AAGtC,GAAA,GAAA,cAAA,cAAa;AACX,kBAAe;AACf,IAAA,GAAA,cAAA,iBAAgB,aAAa,OAAO,CAAC;IACrC;AAEF,GAAA,GAAA,cAAA,cAAa;GACX,MAAM,WAAW,YAAY;GAC7B,MAAM,MAAM,SAAS;GAIrB,MAAM,WAAwB,CAC5B,GAJe,MAAM,QAAQ,KAAK,cAAc,GAC7C,IAAI,gBACL,EAAE,EAGJ,GAAI,SAAS,WACd;AACD,OAAI,SAAS,WAAW,EAAG;AAC3B,IAAA,GAAA,cAAA,iBAAgB;AACd,KAAA,GAAA,yBAAA,oCACE;KAAE,GAAG;KAAK,eAAe;KAAU,EACnC,OACA,cACA;KACE;KACA,QAAQ,QAAQ;AACT,cAAQ,SAAS,CAAC,KAAK,IAAI;;KAElC,eAAe,YACb,WAAW,OAAO,MAAM,EACtB,SACD,CAAqD;KACzD,CACF;KACD;IACF;;AAkCJ,QA/BoE;EAC1D;EAKR;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA,WAAW;EAKX,WAAW;EACX,iBAAiB;EACjB,SAAS,OAAO,kBAAkB,WAAW,OAAO,OAAO,cAAc;EACzE,YAAY,WAAW,MAAM;EAC7B,UAAU,UAAU,WAAW,WAAW,QAAQ,UAAU,OAAO;EACnE,iBAAiB,WAAW,WAAW;EACvC;EACA;GACC,oBAAoB;EACtB;;;;;;;;;;AAaH,SAAgB,YAEd,QACiB;AACjB,QAAO,OAAO,mBAAmB"}
|
|
@@ -0,0 +1,97 @@
|
|
|
1
|
+
import { AgentServerOptions, AssembledToolCall, ChannelRegistry, CustomAdapterOptions, InferStateType, InferSubagentStates, StateOf, StreamController, StreamSubmitOptions, SubagentDiscoverySnapshot, SubgraphDiscoverySnapshot, UseStreamOptions, WidenUpdateMessages } from "@langchain/langgraph-sdk/stream";
|
|
2
|
+
import { DestroyRef, Signal } from "@angular/core";
|
|
3
|
+
import { BaseMessage } from "@langchain/core/messages";
|
|
4
|
+
import { Client, Interrupt } from "@langchain/langgraph-sdk";
|
|
5
|
+
import { ThreadStream as ThreadStream$1 } from "@langchain/langgraph-sdk/client";
|
|
6
|
+
|
|
7
|
+
//#region src/use-stream.d.ts
|
|
8
|
+
/** @deprecated Prefer {@link InferStateType}. */
|
|
9
|
+
type StateOf$1<T> = StateOf<T>;
|
|
10
|
+
type AngularThreadId = string | null | Signal<string | null | undefined>;
|
|
11
|
+
type AgentServerOptions$1<StateType extends object> = AgentServerOptions<StateType, AngularThreadId>;
|
|
12
|
+
type CustomAdapterOptions$1<StateType extends object> = CustomAdapterOptions<StateType, AngularThreadId, string>;
|
|
13
|
+
type UseStreamOptions$1<StateType extends object = Record<string, unknown>> = UseStreamOptions<StateType, AngularThreadId, string | undefined, string | undefined, string>;
|
|
14
|
+
/**
|
|
15
|
+
* Private field on the handle that carries the
|
|
16
|
+
* {@link StreamController} reference. Selector primitives read this
|
|
17
|
+
* to reach the shared {@link ChannelRegistry}. Use the companion
|
|
18
|
+
* `inject*` selectors (`injectMessages`, `injectToolCalls`,
|
|
19
|
+
* `injectValues`, …) instead of reading this directly.
|
|
20
|
+
*/
|
|
21
|
+
declare const STREAM_CONTROLLER: unique symbol;
|
|
22
|
+
/**
|
|
23
|
+
* Return shape of {@link useStream} — the Angular `StreamApi`.
|
|
24
|
+
*
|
|
25
|
+
* Reactivity primitives follow Angular conventions:
|
|
26
|
+
*
|
|
27
|
+
* - Data projections are `Signal<T>`; call them as functions in
|
|
28
|
+
* templates (`stream.messages()`). They are snapshots — never
|
|
29
|
+
* mutate the returned arrays / maps.
|
|
30
|
+
* - Imperative methods (`submit` / `stop` / `respond`) are plain
|
|
31
|
+
* functions. No `WritableSignal`s are exposed on the root handle.
|
|
32
|
+
* - Identity values captured at construction time (`client`,
|
|
33
|
+
* `assistantId`) are exposed as plain values; remount the
|
|
34
|
+
* component to swap them.
|
|
35
|
+
*/
|
|
36
|
+
interface UseStreamReturn<T = Record<string, unknown>, InterruptType = unknown, ConfigurableType extends object = Record<string, unknown>, StateType extends object = InferStateType<T>, SubagentStates = InferSubagentStates<T>> {
|
|
37
|
+
readonly values: Signal<StateType>;
|
|
38
|
+
readonly messages: Signal<BaseMessage[]>;
|
|
39
|
+
readonly toolCalls: Signal<AssembledToolCall[]>;
|
|
40
|
+
readonly interrupts: Signal<Interrupt<InterruptType>[]>;
|
|
41
|
+
readonly interrupt: Signal<Interrupt<InterruptType> | undefined>;
|
|
42
|
+
readonly isLoading: Signal<boolean>;
|
|
43
|
+
readonly isThreadLoading: Signal<boolean>;
|
|
44
|
+
readonly error: Signal<unknown>;
|
|
45
|
+
readonly threadId: Signal<string | null>;
|
|
46
|
+
/**
|
|
47
|
+
* Promise that settles when the active thread's initial hydration
|
|
48
|
+
* completes. Exposed so SSR/render-before-flush pipelines can
|
|
49
|
+
* `await stream.hydrationPromise` before serialising.
|
|
50
|
+
*/
|
|
51
|
+
readonly hydrationPromise: Signal<Promise<void>>;
|
|
52
|
+
readonly subagents: Signal<ReadonlyMap<keyof SubagentStates & string extends never ? string : keyof SubagentStates & string, SubagentDiscoverySnapshot>>;
|
|
53
|
+
readonly subgraphs: Signal<ReadonlyMap<string, SubgraphDiscoverySnapshot>>;
|
|
54
|
+
readonly subgraphsByNode: Signal<ReadonlyMap<string, readonly SubgraphDiscoverySnapshot[]>>;
|
|
55
|
+
submit(input: WidenUpdateMessages<Partial<StateType>> | null | undefined, options?: StreamSubmitOptions<StateType, ConfigurableType>): Promise<void>;
|
|
56
|
+
stop(): Promise<void>;
|
|
57
|
+
respond(response: unknown, target?: {
|
|
58
|
+
interruptId: string;
|
|
59
|
+
namespace?: string[];
|
|
60
|
+
}): Promise<void>;
|
|
61
|
+
readonly client: Client;
|
|
62
|
+
readonly assistantId: string;
|
|
63
|
+
/** v2 escape hatch — returns the bound {@link ThreadStream}. */
|
|
64
|
+
getThread(): ThreadStream$1 | undefined;
|
|
65
|
+
/** @internal Used by selector primitives. */
|
|
66
|
+
readonly [STREAM_CONTROLLER]: StreamController<StateType, InterruptType, ConfigurableType>;
|
|
67
|
+
}
|
|
68
|
+
/**
|
|
69
|
+
* Erased handle useful as a parameter type for helper components that
|
|
70
|
+
* pass a `stream` through to selector primitives without reading
|
|
71
|
+
* `values` directly. Mirrors the React/Vue `AnyStream` alias.
|
|
72
|
+
*/
|
|
73
|
+
type AnyStream = UseStreamReturn<any, any, any>;
|
|
74
|
+
/**
|
|
75
|
+
* Convenience alias — the fully-resolved return type of
|
|
76
|
+
* {@link useStream} for a given source type `T`.
|
|
77
|
+
*/
|
|
78
|
+
type StreamApi<T = Record<string, unknown>, InterruptType = unknown, ConfigurableType extends object = Record<string, unknown>> = UseStreamReturn<T, InterruptType, ConfigurableType>;
|
|
79
|
+
/**
|
|
80
|
+
* React-compatible alias for the fully-resolved stream handle type.
|
|
81
|
+
* Angular docs prefer {@link StreamApi}, but shared libraries can use
|
|
82
|
+
* this name across framework bindings.
|
|
83
|
+
*/
|
|
84
|
+
type UseStreamResult<T = Record<string, unknown>, InterruptType = unknown, ConfigurableType extends object = Record<string, unknown>> = UseStreamReturn<T, InterruptType, ConfigurableType>;
|
|
85
|
+
/**
|
|
86
|
+
* Framework-free factory that constructs a {@link StreamController}
|
|
87
|
+
* and wraps its stores in Angular Signals. Callers must supply the
|
|
88
|
+
* {@link DestroyRef} that owns the controller's lifetime — it's
|
|
89
|
+
* already captured by the public `injectStream` helper.
|
|
90
|
+
*
|
|
91
|
+
* Exported for advanced callers (e.g. testing utilities, custom
|
|
92
|
+
* factories) that prefer to manage injection scope themselves.
|
|
93
|
+
*/
|
|
94
|
+
declare function useStream<T = Record<string, unknown>, InterruptType = unknown, ConfigurableType extends object = Record<string, unknown>>(options: UseStreamOptions$1<InferStateType<T>>, destroyRef?: DestroyRef): UseStreamReturn<T, InterruptType, ConfigurableType>;
|
|
95
|
+
//#endregion
|
|
96
|
+
export { AgentServerOptions$1 as AgentServerOptions, AnyStream, CustomAdapterOptions$1 as CustomAdapterOptions, STREAM_CONTROLLER, StateOf$1 as StateOf, StreamApi, type ThreadStream$1 as ThreadStream, UseStreamOptions$1 as UseStreamOptions, UseStreamResult, UseStreamReturn, useStream };
|
|
97
|
+
//# sourceMappingURL=use-stream.d.cts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"use-stream.d.cts","names":[],"sources":["../src/use-stream.ts"],"mappings":";;;;;;;;KA6CY,SAAA,MAAa,OAAA,CAAc,CAAA;AAAA,KAElC,eAAA,mBAAkC,MAAA;AAAA,KAE3B,oBAAA,6BACV,kBAAA,CAAyB,SAAA,EAAW,eAAA;AAAA,KAE1B,sBAAA,6BACV,oBAAA,CAA2B,SAAA,EAAW,eAAA;AAAA,KAE5B,kBAAA,4BACiB,MAAA,qBACzB,gBAAA,CACF,SAAA,EACA,eAAA;;;;;;AAdwC;;cA2B7B,iBAAA;;;AAvBb;;;;;;;;;;;;UAyCiB,eAAA,KACX,MAAA,8EAE8B,MAAA,8CACP,cAAA,CAAe,CAAA,oBACzB,mBAAA,CAAoB,CAAA;EAAA,SAE5B,MAAA,EAAQ,MAAA,CAAO,SAAA;EAAA,SACf,QAAA,EAAU,MAAA,CAAO,WAAA;EAAA,SACjB,SAAA,EAAW,MAAA,CAAO,iBAAA;EAAA,SAClB,UAAA,EAAY,MAAA,CAAO,SAAA,CAAU,aAAA;EAAA,SAC7B,SAAA,EAAW,MAAA,CAAO,SAAA,CAAU,aAAA;EAAA,SAC5B,SAAA,EAAW,MAAA;EAAA,SACX,eAAA,EAAiB,MAAA;EAAA,SACjB,KAAA,EAAO,MAAA;EAAA,SACP,QAAA,EAAU,MAAA;EArDY;;;;;EAAA,SA4DtB,gBAAA,EAAkB,MAAA,CAAO,OAAA;EAAA,SAEzB,SAAA,EAAW,MAAA,CAClB,WAAA,OACQ,cAAA,yCAEI,cAAA,WACV,yBAAA;EAAA,SAGK,SAAA,EAAW,MAAA,CAAO,WAAA,SAAoB,yBAAA;EAAA,SACtC,eAAA,EAAiB,MAAA,CACxB,WAAA,kBAA6B,yBAAA;EAG/B,MAAA,CACE,KAAA,EAAO,mBAAA,CAAoB,OAAA,CAAQ,SAAA,uBACnC,OAAA,GAAU,mBAAA,CAAoB,SAAA,EAAW,gBAAA,IACxC,OAAA;EACH,IAAA,IAAQ,OAAA;EACR,OAAA,CACE,QAAA,WACA,MAAA;IAAW,WAAA;IAAqB,SAAA;EAAA,IAC/B,OAAA;EAAA,SAEM,MAAA,EAAQ,MAAA;EAAA,SACR,WAAA;EAjFP;EAoFF,SAAA,IAAa,cAAA;EAlFb;EAAA,UAqFU,iBAAA,GAAoB,gBAAA,CAC5B,SAAA,EACA,aAAA,EACA,gBAAA;AAAA;AA3EJ;;;;;AAAA,KAqFY,SAAA,GAAY,eAAA;;;;;KAMZ,SAAA,KACN,MAAA,8EAE8B,MAAA,qBAChC,eAAA,CAAgB,CAAA,EAAG,aAAA,EAAe,gBAAA;;;;;;KAO1B,eAAA,KACN,MAAA,8EAE8B,MAAA,qBAChC,eAAA,CAAgB,CAAA,EAAG,aAAA,EAAe,gBAAA;;;;;;;;;;iBAWtB,SAAA,KACV,MAAA,8EAE8B,MAAA,kBAAA,CAElC,OAAA,EAAS,kBAAA,CAAiB,cAAA,CAAe,CAAA,IACzC,UAAA,GAAa,UAAA,GACZ,eAAA,CAAgB,CAAA,EAAG,aAAA,EAAe,gBAAA"}
|
|
@@ -0,0 +1,97 @@
|
|
|
1
|
+
import { DestroyRef, Signal } from "@angular/core";
|
|
2
|
+
import { Client, Interrupt } from "@langchain/langgraph-sdk";
|
|
3
|
+
import { ThreadStream as ThreadStream$1 } from "@langchain/langgraph-sdk/client";
|
|
4
|
+
import { AgentServerOptions, AssembledToolCall, ChannelRegistry, CustomAdapterOptions, InferStateType, InferSubagentStates, StateOf, StreamController, StreamSubmitOptions, SubagentDiscoverySnapshot, SubgraphDiscoverySnapshot, UseStreamOptions, WidenUpdateMessages } from "@langchain/langgraph-sdk/stream";
|
|
5
|
+
import { BaseMessage } from "@langchain/core/messages";
|
|
6
|
+
|
|
7
|
+
//#region src/use-stream.d.ts
|
|
8
|
+
/** @deprecated Prefer {@link InferStateType}. */
|
|
9
|
+
type StateOf$1<T> = StateOf<T>;
|
|
10
|
+
type AngularThreadId = string | null | Signal<string | null | undefined>;
|
|
11
|
+
type AgentServerOptions$1<StateType extends object> = AgentServerOptions<StateType, AngularThreadId>;
|
|
12
|
+
type CustomAdapterOptions$1<StateType extends object> = CustomAdapterOptions<StateType, AngularThreadId, string>;
|
|
13
|
+
type UseStreamOptions$1<StateType extends object = Record<string, unknown>> = UseStreamOptions<StateType, AngularThreadId, string | undefined, string | undefined, string>;
|
|
14
|
+
/**
|
|
15
|
+
* Private field on the handle that carries the
|
|
16
|
+
* {@link StreamController} reference. Selector primitives read this
|
|
17
|
+
* to reach the shared {@link ChannelRegistry}. Use the companion
|
|
18
|
+
* `inject*` selectors (`injectMessages`, `injectToolCalls`,
|
|
19
|
+
* `injectValues`, …) instead of reading this directly.
|
|
20
|
+
*/
|
|
21
|
+
declare const STREAM_CONTROLLER: unique symbol;
|
|
22
|
+
/**
|
|
23
|
+
* Return shape of {@link useStream} — the Angular `StreamApi`.
|
|
24
|
+
*
|
|
25
|
+
* Reactivity primitives follow Angular conventions:
|
|
26
|
+
*
|
|
27
|
+
* - Data projections are `Signal<T>`; call them as functions in
|
|
28
|
+
* templates (`stream.messages()`). They are snapshots — never
|
|
29
|
+
* mutate the returned arrays / maps.
|
|
30
|
+
* - Imperative methods (`submit` / `stop` / `respond`) are plain
|
|
31
|
+
* functions. No `WritableSignal`s are exposed on the root handle.
|
|
32
|
+
* - Identity values captured at construction time (`client`,
|
|
33
|
+
* `assistantId`) are exposed as plain values; remount the
|
|
34
|
+
* component to swap them.
|
|
35
|
+
*/
|
|
36
|
+
interface UseStreamReturn<T = Record<string, unknown>, InterruptType = unknown, ConfigurableType extends object = Record<string, unknown>, StateType extends object = InferStateType<T>, SubagentStates = InferSubagentStates<T>> {
|
|
37
|
+
readonly values: Signal<StateType>;
|
|
38
|
+
readonly messages: Signal<BaseMessage[]>;
|
|
39
|
+
readonly toolCalls: Signal<AssembledToolCall[]>;
|
|
40
|
+
readonly interrupts: Signal<Interrupt<InterruptType>[]>;
|
|
41
|
+
readonly interrupt: Signal<Interrupt<InterruptType> | undefined>;
|
|
42
|
+
readonly isLoading: Signal<boolean>;
|
|
43
|
+
readonly isThreadLoading: Signal<boolean>;
|
|
44
|
+
readonly error: Signal<unknown>;
|
|
45
|
+
readonly threadId: Signal<string | null>;
|
|
46
|
+
/**
|
|
47
|
+
* Promise that settles when the active thread's initial hydration
|
|
48
|
+
* completes. Exposed so SSR/render-before-flush pipelines can
|
|
49
|
+
* `await stream.hydrationPromise` before serialising.
|
|
50
|
+
*/
|
|
51
|
+
readonly hydrationPromise: Signal<Promise<void>>;
|
|
52
|
+
readonly subagents: Signal<ReadonlyMap<keyof SubagentStates & string extends never ? string : keyof SubagentStates & string, SubagentDiscoverySnapshot>>;
|
|
53
|
+
readonly subgraphs: Signal<ReadonlyMap<string, SubgraphDiscoverySnapshot>>;
|
|
54
|
+
readonly subgraphsByNode: Signal<ReadonlyMap<string, readonly SubgraphDiscoverySnapshot[]>>;
|
|
55
|
+
submit(input: WidenUpdateMessages<Partial<StateType>> | null | undefined, options?: StreamSubmitOptions<StateType, ConfigurableType>): Promise<void>;
|
|
56
|
+
stop(): Promise<void>;
|
|
57
|
+
respond(response: unknown, target?: {
|
|
58
|
+
interruptId: string;
|
|
59
|
+
namespace?: string[];
|
|
60
|
+
}): Promise<void>;
|
|
61
|
+
readonly client: Client;
|
|
62
|
+
readonly assistantId: string;
|
|
63
|
+
/** v2 escape hatch — returns the bound {@link ThreadStream}. */
|
|
64
|
+
getThread(): ThreadStream$1 | undefined;
|
|
65
|
+
/** @internal Used by selector primitives. */
|
|
66
|
+
readonly [STREAM_CONTROLLER]: StreamController<StateType, InterruptType, ConfigurableType>;
|
|
67
|
+
}
|
|
68
|
+
/**
|
|
69
|
+
* Erased handle useful as a parameter type for helper components that
|
|
70
|
+
* pass a `stream` through to selector primitives without reading
|
|
71
|
+
* `values` directly. Mirrors the React/Vue `AnyStream` alias.
|
|
72
|
+
*/
|
|
73
|
+
type AnyStream = UseStreamReturn<any, any, any>;
|
|
74
|
+
/**
|
|
75
|
+
* Convenience alias — the fully-resolved return type of
|
|
76
|
+
* {@link useStream} for a given source type `T`.
|
|
77
|
+
*/
|
|
78
|
+
type StreamApi<T = Record<string, unknown>, InterruptType = unknown, ConfigurableType extends object = Record<string, unknown>> = UseStreamReturn<T, InterruptType, ConfigurableType>;
|
|
79
|
+
/**
|
|
80
|
+
* React-compatible alias for the fully-resolved stream handle type.
|
|
81
|
+
* Angular docs prefer {@link StreamApi}, but shared libraries can use
|
|
82
|
+
* this name across framework bindings.
|
|
83
|
+
*/
|
|
84
|
+
type UseStreamResult<T = Record<string, unknown>, InterruptType = unknown, ConfigurableType extends object = Record<string, unknown>> = UseStreamReturn<T, InterruptType, ConfigurableType>;
|
|
85
|
+
/**
|
|
86
|
+
* Framework-free factory that constructs a {@link StreamController}
|
|
87
|
+
* and wraps its stores in Angular Signals. Callers must supply the
|
|
88
|
+
* {@link DestroyRef} that owns the controller's lifetime — it's
|
|
89
|
+
* already captured by the public `injectStream` helper.
|
|
90
|
+
*
|
|
91
|
+
* Exported for advanced callers (e.g. testing utilities, custom
|
|
92
|
+
* factories) that prefer to manage injection scope themselves.
|
|
93
|
+
*/
|
|
94
|
+
declare function useStream<T = Record<string, unknown>, InterruptType = unknown, ConfigurableType extends object = Record<string, unknown>>(options: UseStreamOptions$1<InferStateType<T>>, destroyRef?: DestroyRef): UseStreamReturn<T, InterruptType, ConfigurableType>;
|
|
95
|
+
//#endregion
|
|
96
|
+
export { AgentServerOptions$1 as AgentServerOptions, AnyStream, CustomAdapterOptions$1 as CustomAdapterOptions, STREAM_CONTROLLER, StateOf$1 as StateOf, StreamApi, type ThreadStream$1 as ThreadStream, UseStreamOptions$1 as UseStreamOptions, UseStreamResult, UseStreamReturn, useStream };
|
|
97
|
+
//# sourceMappingURL=use-stream.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"use-stream.d.ts","names":[],"sources":["../src/use-stream.ts"],"mappings":";;;;;;;;KA6CY,SAAA,MAAa,OAAA,CAAc,CAAA;AAAA,KAElC,eAAA,mBAAkC,MAAA;AAAA,KAE3B,oBAAA,6BACV,kBAAA,CAAyB,SAAA,EAAW,eAAA;AAAA,KAE1B,sBAAA,6BACV,oBAAA,CAA2B,SAAA,EAAW,eAAA;AAAA,KAE5B,kBAAA,4BACiB,MAAA,qBACzB,gBAAA,CACF,SAAA,EACA,eAAA;;;;;;AAdwC;;cA2B7B,iBAAA;;;AAvBb;;;;;;;;;;;;UAyCiB,eAAA,KACX,MAAA,8EAE8B,MAAA,8CACP,cAAA,CAAe,CAAA,oBACzB,mBAAA,CAAoB,CAAA;EAAA,SAE5B,MAAA,EAAQ,MAAA,CAAO,SAAA;EAAA,SACf,QAAA,EAAU,MAAA,CAAO,WAAA;EAAA,SACjB,SAAA,EAAW,MAAA,CAAO,iBAAA;EAAA,SAClB,UAAA,EAAY,MAAA,CAAO,SAAA,CAAU,aAAA;EAAA,SAC7B,SAAA,EAAW,MAAA,CAAO,SAAA,CAAU,aAAA;EAAA,SAC5B,SAAA,EAAW,MAAA;EAAA,SACX,eAAA,EAAiB,MAAA;EAAA,SACjB,KAAA,EAAO,MAAA;EAAA,SACP,QAAA,EAAU,MAAA;EArDY;;;;;EAAA,SA4DtB,gBAAA,EAAkB,MAAA,CAAO,OAAA;EAAA,SAEzB,SAAA,EAAW,MAAA,CAClB,WAAA,OACQ,cAAA,yCAEI,cAAA,WACV,yBAAA;EAAA,SAGK,SAAA,EAAW,MAAA,CAAO,WAAA,SAAoB,yBAAA;EAAA,SACtC,eAAA,EAAiB,MAAA,CACxB,WAAA,kBAA6B,yBAAA;EAG/B,MAAA,CACE,KAAA,EAAO,mBAAA,CAAoB,OAAA,CAAQ,SAAA,uBACnC,OAAA,GAAU,mBAAA,CAAoB,SAAA,EAAW,gBAAA,IACxC,OAAA;EACH,IAAA,IAAQ,OAAA;EACR,OAAA,CACE,QAAA,WACA,MAAA;IAAW,WAAA;IAAqB,SAAA;EAAA,IAC/B,OAAA;EAAA,SAEM,MAAA,EAAQ,MAAA;EAAA,SACR,WAAA;EAjFP;EAoFF,SAAA,IAAa,cAAA;EAlFb;EAAA,UAqFU,iBAAA,GAAoB,gBAAA,CAC5B,SAAA,EACA,aAAA,EACA,gBAAA;AAAA;AA3EJ;;;;;AAAA,KAqFY,SAAA,GAAY,eAAA;;;;;KAMZ,SAAA,KACN,MAAA,8EAE8B,MAAA,qBAChC,eAAA,CAAgB,CAAA,EAAG,aAAA,EAAe,gBAAA;;;;;;KAO1B,eAAA,KACN,MAAA,8EAE8B,MAAA,qBAChC,eAAA,CAAgB,CAAA,EAAG,aAAA,EAAe,gBAAA;;;;;;;;;;iBAWtB,SAAA,KACV,MAAA,8EAE8B,MAAA,kBAAA,CAElC,OAAA,EAAS,kBAAA,CAAiB,cAAA,CAAe,CAAA,IACzC,UAAA,GAAa,UAAA,GACZ,eAAA,CAAgB,CAAA,EAAG,aAAA,EAAe,gBAAA"}
|
|
@@ -0,0 +1,153 @@
|
|
|
1
|
+
import { DestroyRef, computed, effect, inject, isSignal, signal, untracked } from "@angular/core";
|
|
2
|
+
import { filterOutHeadlessToolInterrupts, flushPendingHeadlessToolInterrupts } from "@langchain/langgraph-sdk";
|
|
3
|
+
import { Client as Client$1 } from "@langchain/langgraph-sdk/client";
|
|
4
|
+
import { StreamController } from "@langchain/langgraph-sdk/stream";
|
|
5
|
+
//#region src/use-stream.ts
|
|
6
|
+
/**
|
|
7
|
+
* Private field on the handle that carries the
|
|
8
|
+
* {@link StreamController} reference. Selector primitives read this
|
|
9
|
+
* to reach the shared {@link ChannelRegistry}. Use the companion
|
|
10
|
+
* `inject*` selectors (`injectMessages`, `injectToolCalls`,
|
|
11
|
+
* `injectValues`, …) instead of reading this directly.
|
|
12
|
+
*/
|
|
13
|
+
const STREAM_CONTROLLER = Symbol.for("@langchain/angular/controller");
|
|
14
|
+
/**
|
|
15
|
+
* Framework-free factory that constructs a {@link StreamController}
|
|
16
|
+
* and wraps its stores in Angular Signals. Callers must supply the
|
|
17
|
+
* {@link DestroyRef} that owns the controller's lifetime — it's
|
|
18
|
+
* already captured by the public `injectStream` helper.
|
|
19
|
+
*
|
|
20
|
+
* Exported for advanced callers (e.g. testing utilities, custom
|
|
21
|
+
* factories) that prefer to manage injection scope themselves.
|
|
22
|
+
*/
|
|
23
|
+
function useStream(options, destroyRef) {
|
|
24
|
+
const asBag = options;
|
|
25
|
+
const hasCustomAdapter = asBag.transport != null && typeof asBag.transport !== "string";
|
|
26
|
+
const transport = asBag.transport;
|
|
27
|
+
const client = asBag.client ?? new Client$1({
|
|
28
|
+
apiUrl: asBag.apiUrl,
|
|
29
|
+
apiKey: asBag.apiKey,
|
|
30
|
+
callerOptions: asBag.callerOptions,
|
|
31
|
+
defaultHeaders: asBag.defaultHeaders
|
|
32
|
+
});
|
|
33
|
+
const sentinel = "_";
|
|
34
|
+
const assistantId = "assistantId" in options ? options.assistantId ?? sentinel : sentinel;
|
|
35
|
+
const threadIdInput = (() => {
|
|
36
|
+
const raw = asBag.threadId;
|
|
37
|
+
if (isSignal(raw)) return computed(() => raw() ?? null);
|
|
38
|
+
return signal(raw ?? null);
|
|
39
|
+
})();
|
|
40
|
+
const controller = new StreamController({
|
|
41
|
+
assistantId,
|
|
42
|
+
client,
|
|
43
|
+
threadId: untracked(() => threadIdInput()),
|
|
44
|
+
transport,
|
|
45
|
+
fetch: hasCustomAdapter ? void 0 : asBag.fetch,
|
|
46
|
+
webSocketFactory: hasCustomAdapter ? void 0 : asBag.webSocketFactory,
|
|
47
|
+
onThreadId: options.onThreadId,
|
|
48
|
+
onCreated: options.onCreated,
|
|
49
|
+
initialValues: options.initialValues,
|
|
50
|
+
messagesKey: options.messagesKey
|
|
51
|
+
});
|
|
52
|
+
const deactivate = controller.activate();
|
|
53
|
+
const ref = destroyRef ?? inject(DestroyRef);
|
|
54
|
+
ref.onDestroy(deactivate);
|
|
55
|
+
function bindStore(subscribe, getSnapshot) {
|
|
56
|
+
const s = signal(getSnapshot());
|
|
57
|
+
const unsubscribe = subscribe(() => {
|
|
58
|
+
s.set(getSnapshot());
|
|
59
|
+
});
|
|
60
|
+
ref.onDestroy(unsubscribe);
|
|
61
|
+
return computed(() => s());
|
|
62
|
+
}
|
|
63
|
+
const rootSignal = bindStore(controller.rootStore.subscribe, controller.rootStore.getSnapshot);
|
|
64
|
+
const subagentSignal = bindStore(controller.subagentStore.subscribe, controller.subagentStore.getSnapshot);
|
|
65
|
+
const subgraphSignal = bindStore(controller.subgraphStore.subscribe, controller.subgraphStore.getSnapshot);
|
|
66
|
+
const subgraphByNodeSignal = bindStore(controller.subgraphByNodeStore.subscribe, controller.subgraphByNodeStore.getSnapshot);
|
|
67
|
+
const values = computed(() => rootSignal().values);
|
|
68
|
+
const messages = computed(() => rootSignal().messages);
|
|
69
|
+
const toolCalls = computed(() => rootSignal().toolCalls);
|
|
70
|
+
const interrupts = computed(() => filterOutHeadlessToolInterrupts(rootSignal().interrupts));
|
|
71
|
+
const interrupt = computed(() => interrupts()[0]);
|
|
72
|
+
const isLoading = computed(() => rootSignal().isLoading);
|
|
73
|
+
const isThreadLoading = computed(() => rootSignal().isThreadLoading);
|
|
74
|
+
const error = computed(() => rootSignal().error);
|
|
75
|
+
const threadId = computed(() => rootSignal().threadId);
|
|
76
|
+
const hydrationPromise = computed(() => {
|
|
77
|
+
rootSignal();
|
|
78
|
+
return controller.hydrationPromise;
|
|
79
|
+
});
|
|
80
|
+
let lastAppliedThreadId = untracked(() => threadIdInput()) ?? null;
|
|
81
|
+
effect(() => {
|
|
82
|
+
const next = threadIdInput() ?? null;
|
|
83
|
+
if (next === lastAppliedThreadId) return;
|
|
84
|
+
lastAppliedThreadId = next;
|
|
85
|
+
untracked(() => {
|
|
86
|
+
controller.hydrate(next);
|
|
87
|
+
});
|
|
88
|
+
});
|
|
89
|
+
const tools = options.tools;
|
|
90
|
+
const onTool = options.onTool;
|
|
91
|
+
if (tools?.length) {
|
|
92
|
+
const handledTools = /* @__PURE__ */ new Set();
|
|
93
|
+
effect(() => {
|
|
94
|
+
threadIdInput();
|
|
95
|
+
untracked(() => handledTools.clear());
|
|
96
|
+
});
|
|
97
|
+
effect(() => {
|
|
98
|
+
const snapshot = rootSignal();
|
|
99
|
+
const bag = snapshot.values;
|
|
100
|
+
const combined = [...Array.isArray(bag?.__interrupt__) ? bag.__interrupt__ : [], ...snapshot.interrupts];
|
|
101
|
+
if (combined.length === 0) return;
|
|
102
|
+
untracked(() => {
|
|
103
|
+
flushPendingHeadlessToolInterrupts({
|
|
104
|
+
...bag,
|
|
105
|
+
__interrupt__: combined
|
|
106
|
+
}, tools, handledTools, {
|
|
107
|
+
onTool,
|
|
108
|
+
defer: (run) => {
|
|
109
|
+
Promise.resolve().then(run);
|
|
110
|
+
},
|
|
111
|
+
resumeSubmit: (command) => controller.submit(null, { command })
|
|
112
|
+
});
|
|
113
|
+
});
|
|
114
|
+
});
|
|
115
|
+
}
|
|
116
|
+
return {
|
|
117
|
+
values,
|
|
118
|
+
messages,
|
|
119
|
+
toolCalls,
|
|
120
|
+
interrupts,
|
|
121
|
+
interrupt,
|
|
122
|
+
isLoading,
|
|
123
|
+
isThreadLoading,
|
|
124
|
+
error,
|
|
125
|
+
threadId,
|
|
126
|
+
hydrationPromise,
|
|
127
|
+
subagents: subagentSignal,
|
|
128
|
+
subgraphs: subgraphSignal,
|
|
129
|
+
subgraphsByNode: subgraphByNodeSignal,
|
|
130
|
+
submit: (input, submitOptions) => controller.submit(input, submitOptions),
|
|
131
|
+
stop: () => controller.stop(),
|
|
132
|
+
respond: (response, target) => controller.respond(response, target),
|
|
133
|
+
getThread: () => controller.getThread(),
|
|
134
|
+
client,
|
|
135
|
+
assistantId,
|
|
136
|
+
[STREAM_CONTROLLER]: controller
|
|
137
|
+
};
|
|
138
|
+
}
|
|
139
|
+
/**
|
|
140
|
+
* Helper used by the selector primitives to reach the underlying
|
|
141
|
+
* {@link ChannelRegistry} from a stream handle. Kept internal —
|
|
142
|
+
* application code should call `injectMessages`, `injectToolCalls`,
|
|
143
|
+
* etc. instead of reading this directly.
|
|
144
|
+
*
|
|
145
|
+
* @internal
|
|
146
|
+
*/
|
|
147
|
+
function getRegistry(stream) {
|
|
148
|
+
return stream[STREAM_CONTROLLER].registry;
|
|
149
|
+
}
|
|
150
|
+
//#endregion
|
|
151
|
+
export { STREAM_CONTROLLER, getRegistry, useStream };
|
|
152
|
+
|
|
153
|
+
//# sourceMappingURL=use-stream.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"use-stream.js","names":["ClientCtor"],"sources":["../src/use-stream.ts"],"sourcesContent":["import {\n DestroyRef,\n computed,\n effect,\n inject,\n isSignal,\n signal,\n untracked,\n type Signal,\n} from \"@angular/core\";\nimport type { BaseMessage } from \"@langchain/core/messages\";\nimport type { Client, Interrupt } from \"@langchain/langgraph-sdk\";\nimport {\n filterOutHeadlessToolInterrupts,\n flushPendingHeadlessToolInterrupts,\n type AnyHeadlessToolImplementation,\n type OnToolCallback,\n} from \"@langchain/langgraph-sdk\";\nimport {\n Client as ClientCtor,\n type ClientConfig,\n type ThreadStream,\n} from \"@langchain/langgraph-sdk/client\";\nimport {\n StreamController,\n type AgentServerAdapter,\n type AgentServerOptions as StreamAgentServerOptions,\n type AssembledToolCall,\n type ChannelRegistry,\n type CustomAdapterOptions as StreamCustomAdapterOptions,\n type InferStateType,\n type InferSubagentStates,\n type RootSnapshot,\n type StateOf as StreamStateOf,\n type StreamSubmitOptions,\n type SubagentDiscoverySnapshot,\n type SubagentMap,\n type SubgraphByNodeMap,\n type SubgraphDiscoverySnapshot,\n type SubgraphMap,\n type UseStreamOptions as StreamUseStreamOptions,\n type WidenUpdateMessages,\n} from \"@langchain/langgraph-sdk/stream\";\n\n/** @deprecated Prefer {@link InferStateType}. */\nexport type StateOf<T> = StreamStateOf<T>;\n\ntype AngularThreadId = string | null | Signal<string | null | undefined>;\n\nexport type AgentServerOptions<StateType extends object> =\n StreamAgentServerOptions<StateType, AngularThreadId>;\n\nexport type CustomAdapterOptions<StateType extends object> =\n StreamCustomAdapterOptions<StateType, AngularThreadId, string>;\n\nexport type UseStreamOptions<\n StateType extends object = Record<string, unknown>,\n> = StreamUseStreamOptions<\n StateType,\n AngularThreadId,\n string | undefined,\n string | undefined,\n string\n>;\n\n/**\n * Private field on the handle that carries the\n * {@link StreamController} reference. Selector primitives read this\n * to reach the shared {@link ChannelRegistry}. Use the companion\n * `inject*` selectors (`injectMessages`, `injectToolCalls`,\n * `injectValues`, …) instead of reading this directly.\n */\nexport const STREAM_CONTROLLER: unique symbol = Symbol.for(\n \"@langchain/angular/controller\"\n);\n\n/**\n * Return shape of {@link useStream} — the Angular `StreamApi`.\n *\n * Reactivity primitives follow Angular conventions:\n *\n * - Data projections are `Signal<T>`; call them as functions in\n * templates (`stream.messages()`). They are snapshots — never\n * mutate the returned arrays / maps.\n * - Imperative methods (`submit` / `stop` / `respond`) are plain\n * functions. No `WritableSignal`s are exposed on the root handle.\n * - Identity values captured at construction time (`client`,\n * `assistantId`) are exposed as plain values; remount the\n * component to swap them.\n */\nexport interface UseStreamReturn<\n T = Record<string, unknown>,\n InterruptType = unknown,\n ConfigurableType extends object = Record<string, unknown>,\n StateType extends object = InferStateType<T>,\n SubagentStates = InferSubagentStates<T>,\n> {\n readonly values: Signal<StateType>;\n readonly messages: Signal<BaseMessage[]>;\n readonly toolCalls: Signal<AssembledToolCall[]>;\n readonly interrupts: Signal<Interrupt<InterruptType>[]>;\n readonly interrupt: Signal<Interrupt<InterruptType> | undefined>;\n readonly isLoading: Signal<boolean>;\n readonly isThreadLoading: Signal<boolean>;\n readonly error: Signal<unknown>;\n readonly threadId: Signal<string | null>;\n\n /**\n * Promise that settles when the active thread's initial hydration\n * completes. Exposed so SSR/render-before-flush pipelines can\n * `await stream.hydrationPromise` before serialising.\n */\n readonly hydrationPromise: Signal<Promise<void>>;\n\n readonly subagents: Signal<\n ReadonlyMap<\n keyof SubagentStates & string extends never\n ? string\n : keyof SubagentStates & string,\n SubagentDiscoverySnapshot\n >\n >;\n readonly subgraphs: Signal<ReadonlyMap<string, SubgraphDiscoverySnapshot>>;\n readonly subgraphsByNode: Signal<\n ReadonlyMap<string, readonly SubgraphDiscoverySnapshot[]>\n >;\n\n submit(\n input: WidenUpdateMessages<Partial<StateType>> | null | undefined,\n options?: StreamSubmitOptions<StateType, ConfigurableType>\n ): Promise<void>;\n stop(): Promise<void>;\n respond(\n response: unknown,\n target?: { interruptId: string; namespace?: string[] }\n ): Promise<void>;\n\n readonly client: Client;\n readonly assistantId: string;\n\n /** v2 escape hatch — returns the bound {@link ThreadStream}. */\n getThread(): ThreadStream | undefined;\n\n /** @internal Used by selector primitives. */\n readonly [STREAM_CONTROLLER]: StreamController<\n StateType,\n InterruptType,\n ConfigurableType\n >;\n}\n\n/**\n * Erased handle useful as a parameter type for helper components that\n * pass a `stream` through to selector primitives without reading\n * `values` directly. Mirrors the React/Vue `AnyStream` alias.\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type AnyStream = UseStreamReturn<any, any, any>;\n\n/**\n * Convenience alias — the fully-resolved return type of\n * {@link useStream} for a given source type `T`.\n */\nexport type StreamApi<\n T = Record<string, unknown>,\n InterruptType = unknown,\n ConfigurableType extends object = Record<string, unknown>,\n> = UseStreamReturn<T, InterruptType, ConfigurableType>;\n\n/**\n * React-compatible alias for the fully-resolved stream handle type.\n * Angular docs prefer {@link StreamApi}, but shared libraries can use\n * this name across framework bindings.\n */\nexport type UseStreamResult<\n T = Record<string, unknown>,\n InterruptType = unknown,\n ConfigurableType extends object = Record<string, unknown>,\n> = UseStreamReturn<T, InterruptType, ConfigurableType>;\n\n/**\n * Framework-free factory that constructs a {@link StreamController}\n * and wraps its stores in Angular Signals. Callers must supply the\n * {@link DestroyRef} that owns the controller's lifetime — it's\n * already captured by the public `injectStream` helper.\n *\n * Exported for advanced callers (e.g. testing utilities, custom\n * factories) that prefer to manage injection scope themselves.\n */\nexport function useStream<\n T = Record<string, unknown>,\n InterruptType = unknown,\n ConfigurableType extends object = Record<string, unknown>,\n>(\n options: UseStreamOptions<InferStateType<T>>,\n destroyRef?: DestroyRef\n): UseStreamReturn<T, InterruptType, ConfigurableType> {\n type StateType = InferStateType<T>;\n\n interface OptionsBag {\n assistantId?: string;\n threadId?: string | null | Signal<string | null | undefined>;\n client?: Client;\n apiUrl?: string;\n apiKey?: string;\n callerOptions?: ClientConfig[\"callerOptions\"];\n defaultHeaders?: ClientConfig[\"defaultHeaders\"];\n transport?: \"sse\" | \"websocket\" | AgentServerAdapter;\n fetch?: typeof fetch;\n webSocketFactory?: (url: string) => WebSocket;\n onThreadId?: (threadId: string) => void;\n onCreated?: (meta: { run_id: string; thread_id: string }) => void;\n initialValues?: StateType;\n messagesKey?: string;\n tools?: AnyHeadlessToolImplementation[];\n onTool?: OnToolCallback;\n }\n const asBag = options as OptionsBag;\n\n const hasCustomAdapter =\n asBag.transport != null && typeof asBag.transport !== \"string\";\n const transport = asBag.transport;\n\n const client: Client =\n asBag.client ??\n (new ClientCtor({\n apiUrl: asBag.apiUrl,\n apiKey: asBag.apiKey,\n callerOptions: asBag.callerOptions,\n defaultHeaders: asBag.defaultHeaders,\n }) as unknown as Client);\n\n // Custom adapters may omit `assistantId`; the controller still\n // requires one so it has something to forward to `threads.stream`.\n const sentinel = \"_\";\n const assistantId =\n \"assistantId\" in options ? (options.assistantId ?? sentinel) : sentinel;\n\n // Normalize threadId input to a signal — callers may pass plain\n // values, nulls, or their own signals.\n const threadIdInput: Signal<string | null> = (() => {\n const raw = asBag.threadId;\n if (isSignal(raw)) {\n return computed(\n () => (raw as Signal<string | null | undefined>)() ?? null\n );\n }\n const initial: string | null = (raw as string | null | undefined) ?? null;\n return signal(initial) as unknown as Signal<string | null>;\n })();\n\n const controller = new StreamController<\n StateType,\n InterruptType,\n ConfigurableType\n >({\n assistantId,\n // Cast: the runtime `Client` is state-shape agnostic, but the\n // controller declares `client: Client<StateType>` for its own\n // typings. Same cast is applied in the React/Vue bindings.\n client: client as unknown as Client<StateType>,\n threadId: untracked(() => threadIdInput()),\n transport,\n fetch: hasCustomAdapter ? undefined : asBag.fetch,\n webSocketFactory: hasCustomAdapter ? undefined : asBag.webSocketFactory,\n onThreadId: options.onThreadId,\n onCreated: options.onCreated,\n initialValues: options.initialValues,\n messagesKey: options.messagesKey,\n });\n\n // Deferred dispose — matches the React `useEffect(() =>\n // controller.activate())` and Vue `onScopeDispose(deactivate)`\n // patterns. HMR / scope-reuse scenarios stay clean because\n // `activate()` cancels the pending dispose if the scope survives.\n const deactivate = controller.activate();\n const ref = destroyRef ?? inject(DestroyRef);\n ref.onDestroy(deactivate);\n\n // ─── Reactivity bridge: StreamStore → Signal ────────────────────────\n function bindStore<S>(\n subscribe: (listener: () => void) => () => void,\n getSnapshot: () => S\n ): Signal<S> {\n const s = signal<S>(getSnapshot());\n const unsubscribe = subscribe(() => {\n s.set(getSnapshot());\n });\n ref.onDestroy(unsubscribe);\n return computed(() => s());\n }\n\n const rootSignal = bindStore<RootSnapshot<StateType, InterruptType>>(\n controller.rootStore.subscribe,\n controller.rootStore.getSnapshot\n );\n const subagentSignal = bindStore<SubagentMap>(\n controller.subagentStore.subscribe,\n controller.subagentStore.getSnapshot\n );\n const subgraphSignal = bindStore<SubgraphMap>(\n controller.subgraphStore.subscribe,\n controller.subgraphStore.getSnapshot\n );\n const subgraphByNodeSignal = bindStore<SubgraphByNodeMap>(\n controller.subgraphByNodeStore.subscribe,\n controller.subgraphByNodeStore.getSnapshot\n );\n\n const values = computed(() => rootSignal().values);\n const messages = computed(() => rootSignal().messages);\n const toolCalls = computed(() => rootSignal().toolCalls);\n const interrupts = computed(() =>\n filterOutHeadlessToolInterrupts(rootSignal().interrupts)\n );\n const interrupt = computed(() => interrupts()[0]);\n const isLoading = computed(() => rootSignal().isLoading);\n const isThreadLoading = computed(() => rootSignal().isThreadLoading);\n const error = computed(() => rootSignal().error);\n const threadId = computed(() => rootSignal().threadId);\n\n // `hydrationPromise` is a property on the controller that gets\n // swapped on every `hydrate()` call. Exposing it as a signal lets\n // templates `await stream.hydrationPromise()` reactively; we\n // refresh the reference when the root store settles a new promise.\n const hydrationPromise = computed(() => {\n rootSignal();\n return controller.hydrationPromise;\n });\n\n // ─── threadId reactivity ────────────────────────────────────────────\n //\n // Re-hydrate whenever the caller's threadId input changes after\n // construction. The initial hydrate already fired synchronously in\n // the controller constructor, so we compare against the snapshot\n // captured at construction time rather than blindly skipping the\n // first run — in Angular, `@Input()` bindings apply *between*\n // construction and the first effect tick, so the first read can\n // legitimately be a different (updated) value that needs to\n // hydrate.\n const initialThreadId = untracked(() => threadIdInput()) ?? null;\n let lastAppliedThreadId: string | null = initialThreadId;\n effect(() => {\n const next = threadIdInput() ?? null;\n if (next === lastAppliedThreadId) return;\n lastAppliedThreadId = next;\n untracked(() => {\n void controller.hydrate(next);\n });\n });\n\n // ─── Headless-tool handling ─────────────────────────────────────────\n const tools = options.tools;\n const onTool = options.onTool;\n if (tools?.length) {\n const handledTools = new Set<string>();\n\n // Clear the dedup set whenever the thread id changes.\n effect(() => {\n threadIdInput();\n untracked(() => handledTools.clear());\n });\n\n effect(() => {\n const snapshot = rootSignal();\n const bag = snapshot.values as unknown as Record<string, unknown>;\n const existing = Array.isArray(bag?.__interrupt__)\n ? (bag.__interrupt__ as Interrupt[])\n : [];\n const combined: Interrupt[] = [\n ...existing,\n ...(snapshot.interrupts as unknown as Interrupt[]),\n ];\n if (combined.length === 0) return;\n untracked(() => {\n flushPendingHeadlessToolInterrupts(\n { ...bag, __interrupt__: combined },\n tools,\n handledTools,\n {\n onTool,\n defer: (run) => {\n void Promise.resolve().then(run);\n },\n resumeSubmit: (command) =>\n controller.submit(null, {\n command,\n } as StreamSubmitOptions<StateType, ConfigurableType>),\n }\n );\n });\n });\n }\n\n const handle: UseStreamReturn<T, InterruptType, ConfigurableType> = {\n values: values as UseStreamReturn<\n T,\n InterruptType,\n ConfigurableType\n >[\"values\"],\n messages,\n toolCalls,\n interrupts,\n interrupt,\n isLoading,\n isThreadLoading,\n error,\n threadId,\n hydrationPromise,\n subagents: subagentSignal as UseStreamReturn<\n T,\n InterruptType,\n ConfigurableType\n >[\"subagents\"],\n subgraphs: subgraphSignal,\n subgraphsByNode: subgraphByNodeSignal,\n submit: (input, submitOptions) => controller.submit(input, submitOptions),\n stop: () => controller.stop(),\n respond: (response, target) => controller.respond(response, target),\n getThread: () => controller.getThread(),\n client,\n assistantId,\n [STREAM_CONTROLLER]: controller,\n };\n\n return handle;\n}\n\n/**\n * Helper used by the selector primitives to reach the underlying\n * {@link ChannelRegistry} from a stream handle. Kept internal —\n * application code should call `injectMessages`, `injectToolCalls`,\n * etc. instead of reading this directly.\n *\n * @internal\n */\nexport function getRegistry(\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n stream: UseStreamReturn<any, any, any>\n): ChannelRegistry {\n return stream[STREAM_CONTROLLER].registry;\n}\n\nexport type { ThreadStream };\n"],"mappings":"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"}
|