@langchain/angular 0.4.0 → 0.4.2
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/dist/index.cjs +49 -0
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +2 -2
- package/dist/index.d.ts +2 -2
- package/dist/index.js +2 -1
- package/dist/index.js.map +1 -1
- package/package.json +2 -2
package/dist/index.cjs
CHANGED
|
@@ -5,6 +5,7 @@ const require_context = require("./context.cjs");
|
|
|
5
5
|
const require_decorate = require("./_virtual/_@oxc-project_runtime@0.115.0/helpers/decorate.cjs");
|
|
6
6
|
let _angular_core = require("@angular/core");
|
|
7
7
|
let _langchain_langgraph_sdk_ui = require("@langchain/langgraph-sdk/ui");
|
|
8
|
+
let _langchain_langgraph_sdk = require("@langchain/langgraph-sdk");
|
|
8
9
|
//#region src/index.ts
|
|
9
10
|
/**
|
|
10
11
|
* @internal Merges DI, LangGraph Platform, and custom transport overloads.
|
|
@@ -136,6 +137,12 @@ Object.defineProperty(exports, "calculateDepthFromNamespace", {
|
|
|
136
137
|
return _langchain_langgraph_sdk_ui.calculateDepthFromNamespace;
|
|
137
138
|
}
|
|
138
139
|
});
|
|
140
|
+
Object.defineProperty(exports, "executeHeadlessTool", {
|
|
141
|
+
enumerable: true,
|
|
142
|
+
get: function() {
|
|
143
|
+
return _langchain_langgraph_sdk.executeHeadlessTool;
|
|
144
|
+
}
|
|
145
|
+
});
|
|
139
146
|
Object.defineProperty(exports, "extractParentIdFromNamespace", {
|
|
140
147
|
enumerable: true,
|
|
141
148
|
get: function() {
|
|
@@ -148,14 +155,56 @@ Object.defineProperty(exports, "extractToolCallIdFromNamespace", {
|
|
|
148
155
|
return _langchain_langgraph_sdk_ui.extractToolCallIdFromNamespace;
|
|
149
156
|
}
|
|
150
157
|
});
|
|
158
|
+
Object.defineProperty(exports, "filterOutHeadlessToolInterrupts", {
|
|
159
|
+
enumerable: true,
|
|
160
|
+
get: function() {
|
|
161
|
+
return _langchain_langgraph_sdk.filterOutHeadlessToolInterrupts;
|
|
162
|
+
}
|
|
163
|
+
});
|
|
164
|
+
Object.defineProperty(exports, "findHeadlessTool", {
|
|
165
|
+
enumerable: true,
|
|
166
|
+
get: function() {
|
|
167
|
+
return _langchain_langgraph_sdk.findHeadlessTool;
|
|
168
|
+
}
|
|
169
|
+
});
|
|
170
|
+
Object.defineProperty(exports, "flushPendingHeadlessToolInterrupts", {
|
|
171
|
+
enumerable: true,
|
|
172
|
+
get: function() {
|
|
173
|
+
return _langchain_langgraph_sdk.flushPendingHeadlessToolInterrupts;
|
|
174
|
+
}
|
|
175
|
+
});
|
|
176
|
+
Object.defineProperty(exports, "handleHeadlessToolInterrupt", {
|
|
177
|
+
enumerable: true,
|
|
178
|
+
get: function() {
|
|
179
|
+
return _langchain_langgraph_sdk.handleHeadlessToolInterrupt;
|
|
180
|
+
}
|
|
181
|
+
});
|
|
182
|
+
Object.defineProperty(exports, "headlessToolResumeCommand", {
|
|
183
|
+
enumerable: true,
|
|
184
|
+
get: function() {
|
|
185
|
+
return _langchain_langgraph_sdk.headlessToolResumeCommand;
|
|
186
|
+
}
|
|
187
|
+
});
|
|
151
188
|
exports.injectStream = injectStream;
|
|
152
189
|
exports.injectStreamCustom = require_stream_custom.injectStreamCustom;
|
|
190
|
+
Object.defineProperty(exports, "isHeadlessToolInterrupt", {
|
|
191
|
+
enumerable: true,
|
|
192
|
+
get: function() {
|
|
193
|
+
return _langchain_langgraph_sdk.isHeadlessToolInterrupt;
|
|
194
|
+
}
|
|
195
|
+
});
|
|
153
196
|
Object.defineProperty(exports, "isSubagentNamespace", {
|
|
154
197
|
enumerable: true,
|
|
155
198
|
get: function() {
|
|
156
199
|
return _langchain_langgraph_sdk_ui.isSubagentNamespace;
|
|
157
200
|
}
|
|
158
201
|
});
|
|
202
|
+
Object.defineProperty(exports, "parseHeadlessToolInterruptPayload", {
|
|
203
|
+
enumerable: true,
|
|
204
|
+
get: function() {
|
|
205
|
+
return _langchain_langgraph_sdk.parseHeadlessToolInterruptPayload;
|
|
206
|
+
}
|
|
207
|
+
});
|
|
159
208
|
exports.provideStream = require_context.provideStream;
|
|
160
209
|
exports.provideStreamDefaults = require_context.provideStreamDefaults;
|
|
161
210
|
exports.useStream = useStream;
|
package/dist/index.cjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.cjs","names":["STREAM_INSTANCE","injectStreamCustom","useStreamLGP"],"sources":["../src/index.ts"],"sourcesContent":["import { Injectable, inject as angularInject } from \"@angular/core\";\nimport type { Signal, WritableSignal } from \"@angular/core\";\nimport type {\n BaseMessage,\n ToolMessage as CoreToolMessage,\n AIMessage as CoreAIMessage,\n} from \"@langchain/core/messages\";\nimport type {\n MessageMetadata,\n SubmitOptions,\n ResolveStreamOptions,\n ResolveStreamInterface,\n InferBag,\n InferStateType,\n AcceptBaseMessages,\n UseStreamCustomOptions,\n SubagentStreamInterface,\n WithClassMessages,\n GetConfigurableType,\n GetInterruptType,\n} from \"@langchain/langgraph-sdk/ui\";\n\nimport {\n Client,\n type StreamEvent,\n type StreamMode,\n type Message,\n type Interrupt,\n type BagTemplate,\n type ToolCallWithResult as SdkToolCallWithResult,\n type DefaultToolCall,\n} from \"@langchain/langgraph-sdk\";\nimport type { StreamServiceInstance } from \"./stream-service-instance.js\";\nimport { injectStreamCustom } from \"./stream.custom.js\";\nimport { useStreamLGP } from \"./stream.lgp.js\";\nimport { STREAM_INSTANCE } from \"./context.js\";\n\nexport { injectStreamCustom, useStreamCustom } from \"./stream.custom.js\";\nexport { FetchStreamTransport } from \"@langchain/langgraph-sdk/ui\";\nexport {\n provideStreamDefaults,\n provideStream,\n STREAM_DEFAULTS,\n STREAM_INSTANCE,\n} from \"./context.js\";\nexport type { StreamDefaults } from \"./context.js\";\nexport type { ClassSubagentStreamInterface } from \"@langchain/langgraph-sdk/ui\";\n\ntype AngularWritableKeys = \"isLoading\" | \"branch\";\n\ntype AngularPlainKeys =\n | \"submit\"\n | \"stop\"\n | \"joinStream\"\n | \"switchThread\"\n | \"setBranch\"\n | \"getMessagesMetadata\"\n | \"getToolCalls\"\n | \"getSubagent\"\n | \"getSubagentsByType\"\n | \"getSubagentsByMessage\"\n | \"client\"\n | \"assistantId\";\n\ntype AngularQueueInterface<T> = T extends {\n entries: infer E;\n size: infer S;\n cancel: infer C;\n clear: infer Cl;\n}\n ? {\n entries: WritableSignal<E>;\n size: WritableSignal<S>;\n cancel: C;\n clear: Cl;\n }\n : T;\n\ntype AngularSignalWrap<T> = {\n [K in keyof T]: K extends AngularPlainKeys\n ? T[K]\n : K extends AngularWritableKeys\n ? WritableSignal<T[K]>\n : K extends \"queue\"\n ? AngularQueueInterface<T[K]>\n : Signal<T[K]>;\n};\n\n/**\n * Injects the shared stream instance from the nearest ancestor that provided\n * one via {@link provideStream}. Throws if no ancestor provides a stream\n * instance.\n *\n * @example\n * ```typescript\n * import { Component } from \"@angular/core\";\n * import { injectStream } from \"@langchain/angular\";\n *\n * @Component({\n * template: `\n * @for (msg of stream.messages(); track msg.id) {\n * <div>{{ msg.content }}</div>\n * }\n * <button\n * [disabled]=\"stream.isLoading()\"\n * (click)=\"onSubmit()\"\n * >Send</button>\n * `,\n * })\n * export class ChatComponent {\n * stream = injectStream();\n *\n * onSubmit() {\n * void this.stream.submit({\n * messages: [{ type: \"human\", content: \"Hello!\" }],\n * });\n * }\n * }\n * ```\n *\n * @example With type parameters for full type safety:\n * ```typescript\n * import type { agent } from \"./agent\";\n *\n * export class ChatComponent {\n * stream = injectStream<typeof agent>();\n * // stream.messages() returns typed messages\n * }\n * ```\n */\nfunction injectStream<\n T = Record<string, unknown>,\n Bag extends BagTemplate = BagTemplate,\n>(): AngularSignalWrap<\n WithClassMessages<ResolveStreamInterface<T, InferBag<T, Bag>>>\n>;\n\n/**\n * Angular entry point for LangGraph streaming. Call from a component, directive,\n * or service field initializer to get a **Signals-based** stream controller\n * connected to the LangGraph Platform (HTTP + threads API).\n *\n * The returned object mirrors the shared `useStream` API from\n * `@langchain/langgraph-sdk/ui`, but reactive fields are\n * {@link https://angular.dev/guide/signals | Angular `Signal`s}:\n * read state with calls like `stream.messages()`, `stream.values()`, and\n * `stream.isLoading()`, and use `WritableSignal` setters where exposed (for\n * example `stream.branch` for branch selection).\n *\n * ## Typing with `createDeepAgent`\n *\n * Expect `export const agent = createDeepAgent({ ... })` from `deepagents`. In\n * UI code, `import { type agent } from \"./agent\"` (or `import type { agent }`)\n * is a **type-only** import: it is erased when compiling, so the agent module\n * does not run in the browser. You still pass **`typeof agent`** to\n * `injectStream`, not `agent` alone — `agent` is a value; TypeScript only\n * accepts it in a type position via `typeof` (otherwise: *refers to a value,\n * but is being used as a type*). If you prefer a named type in generics, add\n * `export type Agent = typeof agent` next to the const and use\n * `injectStream<Agent>(...)`.\n *\n * @example\n * ```typescript\n * // agent.ts\n * import { createDeepAgent } from \"deepagents\";\n * import { tool } from \"langchain\";\n * import { z } from \"zod\";\n *\n * const getWeather = tool(\n * async ({ location }) => `Weather in ${location}`,\n * { name: \"get_weather\", schema: z.object({ location: z.string() }) },\n * );\n *\n * export const agent = createDeepAgent({\n * model: \"openai:gpt-4o\",\n * tools: [getWeather],\n * });\n *\n * // chat.component.ts — type-only import; no agent runtime in the frontend\n * import { Component } from \"@angular/core\";\n * import { injectStream } from \"@langchain/angular\";\n * import { type agent } from \"./agent\";\n *\n * @Component({\n * standalone: true,\n * template: `\n * @for (msg of stream.messages(); track msg.id ?? $index) {\n * <p>{{ msg.content }}</p>\n * }\n * `,\n * })\n * export class ChatComponent {\n * readonly stream = injectStream<typeof agent>({\n * assistantId: \"agent\",\n * apiUrl: \"http://localhost:2024\",\n * });\n * // stream.toolCalls()[0].call.name is typed as \"get_weather\"\n * }\n * ```\n *\n * ## Typing with `StateGraph` / custom graph state\n *\n * Use your graph state interface as `T` and embed tool call unions in\n * `Message<...>[]` when you need discriminated tool types.\n *\n * @example\n * ```typescript\n * import { Message } from \"@langchain/langgraph-sdk\";\n * import { Component } from \"@angular/core\";\n * import { injectStream } from \"@langchain/angular\";\n *\n * type MyToolCalls =\n * | { name: \"search\"; args: { query: string }; id?: string }\n * | { name: \"calculate\"; args: { expression: string }; id?: string };\n *\n * interface MyGraphState {\n * messages: Message<MyToolCalls>[];\n * context?: string;\n * }\n *\n * @Component({ standalone: true, template: \"\" })\n * export class ChatComponent {\n * readonly stream = injectStream<MyGraphState>({\n * assistantId: \"my-graph\",\n * apiUrl: \"http://localhost:2024\",\n * });\n * // stream.values() is typed as MyGraphState | null\n * }\n * ```\n *\n * @example\n * ```typescript\n * // Optional bag for interrupts, configurable, custom events, and updates\n * import { Component } from \"@angular/core\";\n * import { injectStream } from \"@langchain/angular\";\n * import type { Message } from \"@langchain/langgraph-sdk\";\n *\n * interface MyGraphState {\n * messages: Message[];\n * }\n *\n * @Component({ standalone: true, template: \"\" })\n * export class ChatComponent {\n * readonly stream = injectStream<\n * MyGraphState,\n * {\n * InterruptType: { question: string };\n * ConfigurableType: { userId: string };\n * }\n * >({\n * assistantId: \"my-graph\",\n * apiUrl: \"http://localhost:2024\",\n * });\n * // stream.interrupt() is typed as { question: string } | undefined\n * }\n * ```\n *\n * ## Subagent streaming\n *\n * For `createDeepAgent` agents with `subagents`, set `filterSubagentMessages`\n * and use `streamSubgraphs` on `submit` to populate `stream.subagents` and\n * related helpers.\n *\n * @example\n * ```typescript\n * import { Component } from \"@angular/core\";\n * import { injectStream } from \"@langchain/angular\";\n * import { type agent } from \"./agent\";\n *\n * @Component({ standalone: true, template: \"\" })\n * export class DeepAgentChatComponent {\n * readonly stream = injectStream<typeof agent>({\n * assistantId: \"deepagent\",\n * apiUrl: \"http://localhost:2024\",\n * filterSubagentMessages: true,\n * });\n *\n * send(content: string) {\n * void this.stream.submit(\n * { messages: [{ content, type: \"human\" }] },\n * { streamSubgraphs: true },\n * );\n * }\n * }\n * ```\n *\n * @param options - LangGraph Platform client options (`apiUrl` or `client`),\n * `assistantId`, stream modes, history, reconnect, subagent settings, etc.\n *\n * @returns A stream controller backed by Signals: graph values, messages,\n * loading and error state, interrupts, tool calls, branching, queue, and\n * `submit` / `stop` / `switchThread` helpers (writable where the UI layer\n * requires mutation).\n *\n * @template T Agent type (with `~agentTypes`) from `createDeepAgent` or\n * `createAgent`, or a state shape extending `Record<string, unknown>`.\n * @template Bag Optional configuration bag:\n * - `ConfigurableType` — `config.configurable` typing\n * - `InterruptType` — human-in-the-loop interrupt payloads\n * - `CustomEventType` — custom stream events\n * - `UpdateType` — payload typing for `submit`\n *\n * @see {@link https://docs.langchain.com/oss/javascript/langgraph/overview | LangGraph JavaScript overview}\n * @see {@link https://docs.langchain.com/oss/javascript/langchain/overview | LangChain JavaScript overview}\n * @see {@link https://docs.langchain.com/oss/javascript/deepagents/overview | Deep Agents JavaScript overview}\n */\nfunction injectStream<\n T = Record<string, unknown>,\n Bag extends BagTemplate = BagTemplate,\n>(\n options: ResolveStreamOptions<T, InferBag<T, Bag>>\n): AngularSignalWrap<\n WithClassMessages<ResolveStreamInterface<T, InferBag<T, Bag>>>\n>;\n\n/**\n * Overload for a **custom transport** (`options.transport`), for example\n * {@link FetchStreamTransport} or any implementation compatible with\n * {@link injectStreamCustom}. Prefer {@link injectStreamCustom} directly when\n * you only use custom transports and want a narrower import.\n *\n * @param options - Custom transport and stream options (must include\n * `transport`).\n *\n * @returns The same Signals-based controller shape as the LangGraph Platform\n * overload.\n *\n * @template T Agent type or state shape, matching the custom transport.\n * @template Bag Same optional bag as the platform overload.\n *\n * @see {@link injectStreamCustom}\n */\nfunction injectStream<\n T = Record<string, unknown>,\n Bag extends BagTemplate = BagTemplate,\n>(\n options: UseStreamCustomOptions<InferStateType<T>, InferBag<T, Bag>>\n): AngularSignalWrap<\n WithClassMessages<ResolveStreamInterface<T, InferBag<T, Bag>>>\n>;\n\n/**\n * @internal Merges DI, LangGraph Platform, and custom transport overloads.\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nfunction injectStream(options?: any): any {\n if (arguments.length === 0) {\n const instance = angularInject(STREAM_INSTANCE, { optional: true });\n if (instance == null) {\n throw new Error(\n \"injectStream() requires an ancestor component to provide a stream via provideStream(). \" +\n \"Add provideStream({ assistantId: '...' }) to the providers array of a parent component, \" +\n \"or use injectStream(options) directly.\"\n );\n }\n return instance;\n }\n if (\"transport\" in options) {\n return injectStreamCustom(options);\n }\n return useStreamLGP(options);\n}\n\nexport { injectStream };\n\n/**\n * @deprecated Use `injectStream` instead. `useStream` will be removed in a\n * future major version. `injectStream` follows Angular's `inject*` naming\n * convention for injection-based patterns.\n */\nexport const useStream = injectStream;\n\nexport { useStreamLGP } from \"./stream.lgp.js\";\n\n/**\n * Injectable Angular service that wraps {@link injectStream}.\n *\n * Extend this class with your own `@Injectable()` service and call\n * `super(options)` in the constructor:\n *\n * ```ts\n * \\@Injectable({ providedIn: 'root' })\n * export class ChatService extends StreamService {\n * constructor() {\n * super({ assistantId: 'agent', apiUrl: '...' });\n * }\n * }\n * ```\n *\n * The service exposes the same signals and methods as `injectStream`\n * (e.g. `values`, `messages`, `isLoading`, `submit`, `stop`).\n *\n * Must be created within an Angular injection context (via DI or\n * `runInInjectionContext`).\n */\n@Injectable()\nexport class StreamService<\n T = Record<string, unknown>,\n Bag extends BagTemplate = BagTemplate,\n> {\n private readonly _stream: StreamServiceInstance<T, Bag>;\n\n constructor(\n options:\n | ResolveStreamOptions<T, InferBag<T, Bag>>\n | UseStreamCustomOptions<InferStateType<T>, InferBag<T, Bag>>\n ) {\n this._stream = injectStream(\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n options as any\n ) as unknown as StreamServiceInstance<T, Bag>;\n }\n\n get values(): Signal<T> {\n return this._stream.values;\n }\n\n get messages(): Signal<BaseMessage[]> {\n return this._stream.messages;\n }\n\n get isLoading(): WritableSignal<boolean> {\n return this._stream.isLoading;\n }\n\n get error(): Signal<unknown> {\n return this._stream.error;\n }\n\n get branch(): WritableSignal<string> {\n return this._stream.branch;\n }\n\n get interrupt(): Signal<Interrupt<GetInterruptType<Bag>> | undefined> {\n return this._stream.interrupt;\n }\n\n get interrupts(): Signal<Interrupt<GetInterruptType<Bag>>[]> {\n return this._stream.interrupts;\n }\n\n get toolCalls(): Signal<SdkToolCallWithResult<DefaultToolCall>[]> {\n return this._stream.toolCalls;\n }\n\n get queue(): AngularQueueInterface<{\n entries: readonly { id: string; values: Partial<T> | null | undefined }[];\n size: number;\n cancel: (id: string) => Promise<boolean>;\n clear: () => Promise<void>;\n }> {\n return this._stream.queue;\n }\n\n get subagents(): Signal<ReadonlyMap<string, SubagentStreamInterface>> {\n return this._stream.subagents;\n }\n\n get activeSubagents(): Signal<readonly SubagentStreamInterface[]> {\n return this._stream.activeSubagents;\n }\n\n get history(): Signal<unknown> {\n return this._stream.history;\n }\n\n get isThreadLoading(): Signal<boolean> {\n return this._stream.isThreadLoading;\n }\n\n get experimental_branchTree(): Signal<unknown> {\n return this._stream.experimental_branchTree;\n }\n\n get client(): Client {\n return this._stream.client;\n }\n\n get assistantId(): string {\n return this._stream.assistantId;\n }\n\n submit(\n values: AcceptBaseMessages<Exclude<T, null | undefined>> | null | undefined,\n options?: SubmitOptions<\n T extends Record<string, unknown> ? T : Record<string, unknown>,\n GetConfigurableType<Bag>\n >\n ): ReturnType<typeof this._stream.submit> {\n return this._stream.submit(values, options);\n }\n\n async stop(): Promise<void> {\n await this._stream.stop();\n }\n\n setBranch(value: string): void {\n this._stream.setBranch(value);\n }\n\n switchThread(newThreadId: string | null): void {\n this._stream.switchThread(newThreadId);\n }\n\n joinStream(\n runId: string,\n lastEventId?: string,\n options?: {\n streamMode?: StreamMode | StreamMode[];\n filter?: (event: {\n id?: string;\n event: StreamEvent;\n data: unknown;\n }) => boolean;\n }\n ): Promise<void> {\n return this._stream.joinStream(runId, lastEventId, options);\n }\n\n getMessagesMetadata(\n message: BaseMessage,\n index?: number\n ):\n | MessageMetadata<\n T extends Record<string, unknown> ? T : Record<string, unknown>\n >\n | undefined {\n return this._stream.getMessagesMetadata(message as Message, index);\n }\n\n getToolCalls(message: BaseMessage): SdkToolCallWithResult<DefaultToolCall>[] {\n return this._stream.getToolCalls(message as Message);\n }\n\n getSubagent(toolCallId: string): SubagentStreamInterface | undefined {\n return this._stream.getSubagent(toolCallId);\n }\n\n getSubagentsByType(type: string): SubagentStreamInterface[] {\n return this._stream.getSubagentsByType(type);\n }\n\n getSubagentsByMessage(messageId: string): SubagentStreamInterface[] {\n return this._stream.getSubagentsByMessage(messageId);\n }\n}\n\nexport type {\n BaseStream,\n UseAgentStream,\n UseAgentStreamOptions,\n UseDeepAgentStream,\n UseDeepAgentStreamOptions,\n ResolveStreamInterface,\n ResolveStreamOptions,\n InferStateType,\n InferToolCalls,\n InferSubagentStates,\n InferNodeNames,\n InferBag,\n MessageMetadata,\n UseStreamOptions,\n UseStreamCustomOptions,\n UseStreamTransport,\n UseStreamThread,\n GetToolCallsType,\n AgentTypeConfigLike,\n IsAgentLike,\n ExtractAgentConfig,\n InferAgentToolCalls,\n SubagentToolCall,\n SubagentStatus,\n SubagentApi,\n SubagentStream,\n SubagentStreamInterface,\n SubAgentLike,\n CompiledSubAgentLike,\n DeepAgentTypeConfigLike,\n IsDeepAgentLike,\n ExtractDeepAgentConfig,\n ExtractSubAgentMiddleware,\n InferDeepAgentSubagents,\n InferSubagentByName,\n InferSubagentState,\n InferSubagentNames,\n SubagentStateMap,\n DefaultSubagentStates,\n BaseSubagentState,\n QueueEntry,\n QueueInterface,\n} from \"@langchain/langgraph-sdk/ui\";\n\nexport type ToolCallWithResult<ToolCall = DefaultToolCall> =\n SdkToolCallWithResult<ToolCall, CoreToolMessage, CoreAIMessage>;\nexport type {\n ToolCallState,\n DefaultToolCall,\n ToolCallFromTool,\n ToolCallsFromTools,\n} from \"@langchain/langgraph-sdk\";\n\nexport {\n SubagentManager,\n extractToolCallIdFromNamespace,\n calculateDepthFromNamespace,\n extractParentIdFromNamespace,\n isSubagentNamespace,\n} from \"@langchain/langgraph-sdk/ui\";\n"],"mappings":";;;;;;;;;;;AAyVA,SAAS,aAAa,SAAoB;AACxC,KAAI,UAAU,WAAW,GAAG;EAC1B,MAAM,YAAA,GAAA,cAAA,QAAyBA,gBAAAA,iBAAiB,EAAE,UAAU,MAAM,CAAC;AACnE,MAAI,YAAY,KACd,OAAM,IAAI,MACR,wNAGD;AAEH,SAAO;;AAET,KAAI,eAAe,QACjB,QAAOC,sBAAAA,mBAAmB,QAAQ;AAEpC,QAAOC,mBAAAA,aAAa,QAAQ;;;;;;;AAU9B,MAAa,YAAY;AA0BlB,IAAA,gBAAA,MAAM,cAGX;CACA;CAEA,YACE,SAGA;AACA,OAAK,UAAU,aAEb,QACD;;CAGH,IAAI,SAAoB;AACtB,SAAO,KAAK,QAAQ;;CAGtB,IAAI,WAAkC;AACpC,SAAO,KAAK,QAAQ;;CAGtB,IAAI,YAAqC;AACvC,SAAO,KAAK,QAAQ;;CAGtB,IAAI,QAAyB;AAC3B,SAAO,KAAK,QAAQ;;CAGtB,IAAI,SAAiC;AACnC,SAAO,KAAK,QAAQ;;CAGtB,IAAI,YAAkE;AACpE,SAAO,KAAK,QAAQ;;CAGtB,IAAI,aAAyD;AAC3D,SAAO,KAAK,QAAQ;;CAGtB,IAAI,YAA8D;AAChE,SAAO,KAAK,QAAQ;;CAGtB,IAAI,QAKD;AACD,SAAO,KAAK,QAAQ;;CAGtB,IAAI,YAAkE;AACpE,SAAO,KAAK,QAAQ;;CAGtB,IAAI,kBAA8D;AAChE,SAAO,KAAK,QAAQ;;CAGtB,IAAI,UAA2B;AAC7B,SAAO,KAAK,QAAQ;;CAGtB,IAAI,kBAAmC;AACrC,SAAO,KAAK,QAAQ;;CAGtB,IAAI,0BAA2C;AAC7C,SAAO,KAAK,QAAQ;;CAGtB,IAAI,SAAiB;AACnB,SAAO,KAAK,QAAQ;;CAGtB,IAAI,cAAsB;AACxB,SAAO,KAAK,QAAQ;;CAGtB,OACE,QACA,SAIwC;AACxC,SAAO,KAAK,QAAQ,OAAO,QAAQ,QAAQ;;CAG7C,MAAM,OAAsB;AAC1B,QAAM,KAAK,QAAQ,MAAM;;CAG3B,UAAU,OAAqB;AAC7B,OAAK,QAAQ,UAAU,MAAM;;CAG/B,aAAa,aAAkC;AAC7C,OAAK,QAAQ,aAAa,YAAY;;CAGxC,WACE,OACA,aACA,SAQe;AACf,SAAO,KAAK,QAAQ,WAAW,OAAO,aAAa,QAAQ;;CAG7D,oBACE,SACA,OAKY;AACZ,SAAO,KAAK,QAAQ,oBAAoB,SAAoB,MAAM;;CAGpE,aAAa,SAAgE;AAC3E,SAAO,KAAK,QAAQ,aAAa,QAAmB;;CAGtD,YAAY,YAAyD;AACnE,SAAO,KAAK,QAAQ,YAAY,WAAW;;CAG7C,mBAAmB,MAAyC;AAC1D,SAAO,KAAK,QAAQ,mBAAmB,KAAK;;CAG9C,sBAAsB,WAA8C;AAClE,SAAO,KAAK,QAAQ,sBAAsB,UAAU;;;4EApJ3C,CAAA,EAAA,cAAA"}
|
|
1
|
+
{"version":3,"file":"index.cjs","names":["STREAM_INSTANCE","injectStreamCustom","useStreamLGP"],"sources":["../src/index.ts"],"sourcesContent":["import { Injectable, inject as angularInject } from \"@angular/core\";\nimport type { Signal, WritableSignal } from \"@angular/core\";\nimport type {\n BaseMessage,\n ToolMessage as CoreToolMessage,\n AIMessage as CoreAIMessage,\n} from \"@langchain/core/messages\";\nimport type {\n MessageMetadata,\n SubmitOptions,\n ResolveStreamOptions,\n ResolveStreamInterface,\n InferBag,\n InferStateType,\n AcceptBaseMessages,\n UseStreamCustomOptions,\n SubagentStreamInterface,\n WithClassMessages,\n GetConfigurableType,\n GetInterruptType,\n} from \"@langchain/langgraph-sdk/ui\";\n\nimport {\n Client,\n type StreamEvent,\n type StreamMode,\n type Message,\n type Interrupt,\n type BagTemplate,\n type ToolCallWithResult as SdkToolCallWithResult,\n type DefaultToolCall,\n} from \"@langchain/langgraph-sdk\";\nimport type { StreamServiceInstance } from \"./stream-service-instance.js\";\nimport { injectStreamCustom } from \"./stream.custom.js\";\nimport { useStreamLGP } from \"./stream.lgp.js\";\nimport { STREAM_INSTANCE } from \"./context.js\";\n\nexport { injectStreamCustom, useStreamCustom } from \"./stream.custom.js\";\nexport { FetchStreamTransport } from \"@langchain/langgraph-sdk/ui\";\nexport {\n provideStreamDefaults,\n provideStream,\n STREAM_DEFAULTS,\n STREAM_INSTANCE,\n} from \"./context.js\";\nexport type { StreamDefaults } from \"./context.js\";\nexport type { ClassSubagentStreamInterface } from \"@langchain/langgraph-sdk/ui\";\n\ntype AngularWritableKeys = \"isLoading\" | \"branch\";\n\ntype AngularPlainKeys =\n | \"submit\"\n | \"stop\"\n | \"joinStream\"\n | \"switchThread\"\n | \"setBranch\"\n | \"getMessagesMetadata\"\n | \"getToolCalls\"\n | \"getSubagent\"\n | \"getSubagentsByType\"\n | \"getSubagentsByMessage\"\n | \"client\"\n | \"assistantId\";\n\ntype AngularQueueInterface<T> = T extends {\n entries: infer E;\n size: infer S;\n cancel: infer C;\n clear: infer Cl;\n}\n ? {\n entries: WritableSignal<E>;\n size: WritableSignal<S>;\n cancel: C;\n clear: Cl;\n }\n : T;\n\ntype AngularSignalWrap<T> = {\n [K in keyof T]: K extends AngularPlainKeys\n ? T[K]\n : K extends AngularWritableKeys\n ? WritableSignal<T[K]>\n : K extends \"queue\"\n ? AngularQueueInterface<T[K]>\n : Signal<T[K]>;\n};\n\n/**\n * Injects the shared stream instance from the nearest ancestor that provided\n * one via {@link provideStream}. Throws if no ancestor provides a stream\n * instance.\n *\n * @example\n * ```typescript\n * import { Component } from \"@angular/core\";\n * import { injectStream } from \"@langchain/angular\";\n *\n * @Component({\n * template: `\n * @for (msg of stream.messages(); track msg.id) {\n * <div>{{ msg.content }}</div>\n * }\n * <button\n * [disabled]=\"stream.isLoading()\"\n * (click)=\"onSubmit()\"\n * >Send</button>\n * `,\n * })\n * export class ChatComponent {\n * stream = injectStream();\n *\n * onSubmit() {\n * void this.stream.submit({\n * messages: [{ type: \"human\", content: \"Hello!\" }],\n * });\n * }\n * }\n * ```\n *\n * @example With type parameters for full type safety:\n * ```typescript\n * import type { agent } from \"./agent\";\n *\n * export class ChatComponent {\n * stream = injectStream<typeof agent>();\n * // stream.messages() returns typed messages\n * }\n * ```\n */\nfunction injectStream<\n T = Record<string, unknown>,\n Bag extends BagTemplate = BagTemplate,\n>(): AngularSignalWrap<\n WithClassMessages<ResolveStreamInterface<T, InferBag<T, Bag>>>\n>;\n\n/**\n * Angular entry point for LangGraph streaming. Call from a component, directive,\n * or service field initializer to get a **Signals-based** stream controller\n * connected to the LangGraph Platform (HTTP + threads API).\n *\n * The returned object mirrors the shared `useStream` API from\n * `@langchain/langgraph-sdk/ui`, but reactive fields are\n * {@link https://angular.dev/guide/signals | Angular `Signal`s}:\n * read state with calls like `stream.messages()`, `stream.values()`, and\n * `stream.isLoading()`, and use `WritableSignal` setters where exposed (for\n * example `stream.branch` for branch selection).\n *\n * ## Typing with `createDeepAgent`\n *\n * Expect `export const agent = createDeepAgent({ ... })` from `deepagents`. In\n * UI code, `import { type agent } from \"./agent\"` (or `import type { agent }`)\n * is a **type-only** import: it is erased when compiling, so the agent module\n * does not run in the browser. You still pass **`typeof agent`** to\n * `injectStream`, not `agent` alone — `agent` is a value; TypeScript only\n * accepts it in a type position via `typeof` (otherwise: *refers to a value,\n * but is being used as a type*). If you prefer a named type in generics, add\n * `export type Agent = typeof agent` next to the const and use\n * `injectStream<Agent>(...)`.\n *\n * @example\n * ```typescript\n * // agent.ts\n * import { createDeepAgent } from \"deepagents\";\n * import { tool } from \"langchain\";\n * import { z } from \"zod\";\n *\n * const getWeather = tool(\n * async ({ location }) => `Weather in ${location}`,\n * { name: \"get_weather\", schema: z.object({ location: z.string() }) },\n * );\n *\n * export const agent = createDeepAgent({\n * model: \"openai:gpt-4o\",\n * tools: [getWeather],\n * });\n *\n * // chat.component.ts — type-only import; no agent runtime in the frontend\n * import { Component } from \"@angular/core\";\n * import { injectStream } from \"@langchain/angular\";\n * import { type agent } from \"./agent\";\n *\n * @Component({\n * standalone: true,\n * template: `\n * @for (msg of stream.messages(); track msg.id ?? $index) {\n * <p>{{ msg.content }}</p>\n * }\n * `,\n * })\n * export class ChatComponent {\n * readonly stream = injectStream<typeof agent>({\n * assistantId: \"agent\",\n * apiUrl: \"http://localhost:2024\",\n * });\n * // stream.toolCalls()[0].call.name is typed as \"get_weather\"\n * }\n * ```\n *\n * ## Typing with `StateGraph` / custom graph state\n *\n * Use your graph state interface as `T` and embed tool call unions in\n * `Message<...>[]` when you need discriminated tool types.\n *\n * @example\n * ```typescript\n * import { Message } from \"@langchain/langgraph-sdk\";\n * import { Component } from \"@angular/core\";\n * import { injectStream } from \"@langchain/angular\";\n *\n * type MyToolCalls =\n * | { name: \"search\"; args: { query: string }; id?: string }\n * | { name: \"calculate\"; args: { expression: string }; id?: string };\n *\n * interface MyGraphState {\n * messages: Message<MyToolCalls>[];\n * context?: string;\n * }\n *\n * @Component({ standalone: true, template: \"\" })\n * export class ChatComponent {\n * readonly stream = injectStream<MyGraphState>({\n * assistantId: \"my-graph\",\n * apiUrl: \"http://localhost:2024\",\n * });\n * // stream.values() is typed as MyGraphState | null\n * }\n * ```\n *\n * @example\n * ```typescript\n * // Optional bag for interrupts, configurable, custom events, and updates\n * import { Component } from \"@angular/core\";\n * import { injectStream } from \"@langchain/angular\";\n * import type { Message } from \"@langchain/langgraph-sdk\";\n *\n * interface MyGraphState {\n * messages: Message[];\n * }\n *\n * @Component({ standalone: true, template: \"\" })\n * export class ChatComponent {\n * readonly stream = injectStream<\n * MyGraphState,\n * {\n * InterruptType: { question: string };\n * ConfigurableType: { userId: string };\n * }\n * >({\n * assistantId: \"my-graph\",\n * apiUrl: \"http://localhost:2024\",\n * });\n * // stream.interrupt() is typed as { question: string } | undefined\n * }\n * ```\n *\n * ## Subagent streaming\n *\n * For `createDeepAgent` agents with `subagents`, set `filterSubagentMessages`\n * and use `streamSubgraphs` on `submit` to populate `stream.subagents` and\n * related helpers.\n *\n * @example\n * ```typescript\n * import { Component } from \"@angular/core\";\n * import { injectStream } from \"@langchain/angular\";\n * import { type agent } from \"./agent\";\n *\n * @Component({ standalone: true, template: \"\" })\n * export class DeepAgentChatComponent {\n * readonly stream = injectStream<typeof agent>({\n * assistantId: \"deepagent\",\n * apiUrl: \"http://localhost:2024\",\n * filterSubagentMessages: true,\n * });\n *\n * send(content: string) {\n * void this.stream.submit(\n * { messages: [{ content, type: \"human\" }] },\n * { streamSubgraphs: true },\n * );\n * }\n * }\n * ```\n *\n * @param options - LangGraph Platform client options (`apiUrl` or `client`),\n * `assistantId`, stream modes, history, reconnect, subagent settings, etc.\n *\n * @returns A stream controller backed by Signals: graph values, messages,\n * loading and error state, interrupts, tool calls, branching, queue, and\n * `submit` / `stop` / `switchThread` helpers (writable where the UI layer\n * requires mutation).\n *\n * @template T Agent type (with `~agentTypes`) from `createDeepAgent` or\n * `createAgent`, or a state shape extending `Record<string, unknown>`.\n * @template Bag Optional configuration bag:\n * - `ConfigurableType` — `config.configurable` typing\n * - `InterruptType` — human-in-the-loop interrupt payloads\n * - `CustomEventType` — custom stream events\n * - `UpdateType` — payload typing for `submit`\n *\n * @see {@link https://docs.langchain.com/oss/javascript/langgraph/overview | LangGraph JavaScript overview}\n * @see {@link https://docs.langchain.com/oss/javascript/langchain/overview | LangChain JavaScript overview}\n * @see {@link https://docs.langchain.com/oss/javascript/deepagents/overview | Deep Agents JavaScript overview}\n */\nfunction injectStream<\n T = Record<string, unknown>,\n Bag extends BagTemplate = BagTemplate,\n>(\n options: ResolveStreamOptions<T, InferBag<T, Bag>>\n): AngularSignalWrap<\n WithClassMessages<ResolveStreamInterface<T, InferBag<T, Bag>>>\n>;\n\n/**\n * Overload for a **custom transport** (`options.transport`), for example\n * {@link FetchStreamTransport} or any implementation compatible with\n * {@link injectStreamCustom}. Prefer {@link injectStreamCustom} directly when\n * you only use custom transports and want a narrower import.\n *\n * @param options - Custom transport and stream options (must include\n * `transport`).\n *\n * @returns The same Signals-based controller shape as the LangGraph Platform\n * overload.\n *\n * @template T Agent type or state shape, matching the custom transport.\n * @template Bag Same optional bag as the platform overload.\n *\n * @see {@link injectStreamCustom}\n */\nfunction injectStream<\n T = Record<string, unknown>,\n Bag extends BagTemplate = BagTemplate,\n>(\n options: UseStreamCustomOptions<InferStateType<T>, InferBag<T, Bag>>\n): AngularSignalWrap<\n WithClassMessages<ResolveStreamInterface<T, InferBag<T, Bag>>>\n>;\n\n/**\n * @internal Merges DI, LangGraph Platform, and custom transport overloads.\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nfunction injectStream(options?: any): any {\n if (arguments.length === 0) {\n const instance = angularInject(STREAM_INSTANCE, { optional: true });\n if (instance == null) {\n throw new Error(\n \"injectStream() requires an ancestor component to provide a stream via provideStream(). \" +\n \"Add provideStream({ assistantId: '...' }) to the providers array of a parent component, \" +\n \"or use injectStream(options) directly.\"\n );\n }\n return instance;\n }\n if (\"transport\" in options) {\n return injectStreamCustom(options);\n }\n return useStreamLGP(options);\n}\n\nexport { injectStream };\n\n/**\n * @deprecated Use `injectStream` instead. `useStream` will be removed in a\n * future major version. `injectStream` follows Angular's `inject*` naming\n * convention for injection-based patterns.\n */\nexport const useStream = injectStream;\n\nexport { useStreamLGP } from \"./stream.lgp.js\";\n\n/**\n * Injectable Angular service that wraps {@link injectStream}.\n *\n * Extend this class with your own `@Injectable()` service and call\n * `super(options)` in the constructor:\n *\n * ```ts\n * \\@Injectable({ providedIn: 'root' })\n * export class ChatService extends StreamService {\n * constructor() {\n * super({ assistantId: 'agent', apiUrl: '...' });\n * }\n * }\n * ```\n *\n * The service exposes the same signals and methods as `injectStream`\n * (e.g. `values`, `messages`, `isLoading`, `submit`, `stop`).\n *\n * Must be created within an Angular injection context (via DI or\n * `runInInjectionContext`).\n */\n@Injectable()\nexport class StreamService<\n T = Record<string, unknown>,\n Bag extends BagTemplate = BagTemplate,\n> {\n private readonly _stream: StreamServiceInstance<T, Bag>;\n\n constructor(\n options:\n | ResolveStreamOptions<T, InferBag<T, Bag>>\n | UseStreamCustomOptions<InferStateType<T>, InferBag<T, Bag>>\n ) {\n this._stream = injectStream(\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n options as any\n ) as unknown as StreamServiceInstance<T, Bag>;\n }\n\n get values(): Signal<T> {\n return this._stream.values;\n }\n\n get messages(): Signal<BaseMessage[]> {\n return this._stream.messages;\n }\n\n get isLoading(): WritableSignal<boolean> {\n return this._stream.isLoading;\n }\n\n get error(): Signal<unknown> {\n return this._stream.error;\n }\n\n get branch(): WritableSignal<string> {\n return this._stream.branch;\n }\n\n get interrupt(): Signal<Interrupt<GetInterruptType<Bag>> | undefined> {\n return this._stream.interrupt;\n }\n\n get interrupts(): Signal<Interrupt<GetInterruptType<Bag>>[]> {\n return this._stream.interrupts;\n }\n\n get toolCalls(): Signal<SdkToolCallWithResult<DefaultToolCall>[]> {\n return this._stream.toolCalls;\n }\n\n get queue(): AngularQueueInterface<{\n entries: readonly { id: string; values: Partial<T> | null | undefined }[];\n size: number;\n cancel: (id: string) => Promise<boolean>;\n clear: () => Promise<void>;\n }> {\n return this._stream.queue;\n }\n\n get subagents(): Signal<ReadonlyMap<string, SubagentStreamInterface>> {\n return this._stream.subagents;\n }\n\n get activeSubagents(): Signal<readonly SubagentStreamInterface[]> {\n return this._stream.activeSubagents;\n }\n\n get history(): Signal<unknown> {\n return this._stream.history;\n }\n\n get isThreadLoading(): Signal<boolean> {\n return this._stream.isThreadLoading;\n }\n\n get experimental_branchTree(): Signal<unknown> {\n return this._stream.experimental_branchTree;\n }\n\n get client(): Client {\n return this._stream.client;\n }\n\n get assistantId(): string {\n return this._stream.assistantId;\n }\n\n submit(\n values: AcceptBaseMessages<Exclude<T, null | undefined>> | null | undefined,\n options?: SubmitOptions<\n T extends Record<string, unknown> ? T : Record<string, unknown>,\n GetConfigurableType<Bag>\n >\n ): ReturnType<typeof this._stream.submit> {\n return this._stream.submit(values, options);\n }\n\n async stop(): Promise<void> {\n await this._stream.stop();\n }\n\n setBranch(value: string): void {\n this._stream.setBranch(value);\n }\n\n switchThread(newThreadId: string | null): void {\n this._stream.switchThread(newThreadId);\n }\n\n joinStream(\n runId: string,\n lastEventId?: string,\n options?: {\n streamMode?: StreamMode | StreamMode[];\n filter?: (event: {\n id?: string;\n event: StreamEvent;\n data: unknown;\n }) => boolean;\n }\n ): Promise<void> {\n return this._stream.joinStream(runId, lastEventId, options);\n }\n\n getMessagesMetadata(\n message: BaseMessage,\n index?: number\n ):\n | MessageMetadata<\n T extends Record<string, unknown> ? T : Record<string, unknown>\n >\n | undefined {\n return this._stream.getMessagesMetadata(message as Message, index);\n }\n\n getToolCalls(message: BaseMessage): SdkToolCallWithResult<DefaultToolCall>[] {\n return this._stream.getToolCalls(message as Message);\n }\n\n getSubagent(toolCallId: string): SubagentStreamInterface | undefined {\n return this._stream.getSubagent(toolCallId);\n }\n\n getSubagentsByType(type: string): SubagentStreamInterface[] {\n return this._stream.getSubagentsByType(type);\n }\n\n getSubagentsByMessage(messageId: string): SubagentStreamInterface[] {\n return this._stream.getSubagentsByMessage(messageId);\n }\n}\n\nexport type {\n BaseStream,\n UseAgentStream,\n UseAgentStreamOptions,\n UseDeepAgentStream,\n UseDeepAgentStreamOptions,\n ResolveStreamInterface,\n ResolveStreamOptions,\n InferStateType,\n InferToolCalls,\n InferSubagentStates,\n InferNodeNames,\n InferBag,\n MessageMetadata,\n UseStreamOptions,\n UseStreamCustomOptions,\n UseStreamTransport,\n UseStreamThread,\n GetToolCallsType,\n AgentTypeConfigLike,\n IsAgentLike,\n ExtractAgentConfig,\n InferAgentToolCalls,\n SubagentToolCall,\n SubagentStatus,\n SubagentApi,\n SubagentStream,\n SubagentStreamInterface,\n SubAgentLike,\n CompiledSubAgentLike,\n DeepAgentTypeConfigLike,\n IsDeepAgentLike,\n ExtractDeepAgentConfig,\n ExtractSubAgentMiddleware,\n InferDeepAgentSubagents,\n InferSubagentByName,\n InferSubagentState,\n InferSubagentNames,\n SubagentStateMap,\n DefaultSubagentStates,\n BaseSubagentState,\n QueueEntry,\n QueueInterface,\n} from \"@langchain/langgraph-sdk/ui\";\n\nexport type ToolCallWithResult<ToolCall = DefaultToolCall> =\n SdkToolCallWithResult<ToolCall, CoreToolMessage, CoreAIMessage>;\nexport type {\n ToolCallState,\n DefaultToolCall,\n ToolCallFromTool,\n ToolCallsFromTools,\n} from \"@langchain/langgraph-sdk\";\nexport type {\n HeadlessToolImplementation,\n AnyHeadlessToolImplementation,\n ToolEvent,\n HeadlessToolInterrupt,\n OnToolCallback,\n FlushPendingHeadlessToolInterruptsOptions,\n} from \"@langchain/langgraph-sdk\";\n\nexport {\n SubagentManager,\n extractToolCallIdFromNamespace,\n calculateDepthFromNamespace,\n extractParentIdFromNamespace,\n isSubagentNamespace,\n} from \"@langchain/langgraph-sdk/ui\";\nexport {\n isHeadlessToolInterrupt,\n parseHeadlessToolInterruptPayload,\n filterOutHeadlessToolInterrupts,\n findHeadlessTool,\n executeHeadlessTool,\n handleHeadlessToolInterrupt,\n headlessToolResumeCommand,\n flushPendingHeadlessToolInterrupts,\n} from \"@langchain/langgraph-sdk\";\n"],"mappings":";;;;;;;;;;;;AAyVA,SAAS,aAAa,SAAoB;AACxC,KAAI,UAAU,WAAW,GAAG;EAC1B,MAAM,YAAA,GAAA,cAAA,QAAyBA,gBAAAA,iBAAiB,EAAE,UAAU,MAAM,CAAC;AACnE,MAAI,YAAY,KACd,OAAM,IAAI,MACR,wNAGD;AAEH,SAAO;;AAET,KAAI,eAAe,QACjB,QAAOC,sBAAAA,mBAAmB,QAAQ;AAEpC,QAAOC,mBAAAA,aAAa,QAAQ;;;;;;;AAU9B,MAAa,YAAY;AA0BlB,IAAA,gBAAA,MAAM,cAGX;CACA;CAEA,YACE,SAGA;AACA,OAAK,UAAU,aAEb,QACD;;CAGH,IAAI,SAAoB;AACtB,SAAO,KAAK,QAAQ;;CAGtB,IAAI,WAAkC;AACpC,SAAO,KAAK,QAAQ;;CAGtB,IAAI,YAAqC;AACvC,SAAO,KAAK,QAAQ;;CAGtB,IAAI,QAAyB;AAC3B,SAAO,KAAK,QAAQ;;CAGtB,IAAI,SAAiC;AACnC,SAAO,KAAK,QAAQ;;CAGtB,IAAI,YAAkE;AACpE,SAAO,KAAK,QAAQ;;CAGtB,IAAI,aAAyD;AAC3D,SAAO,KAAK,QAAQ;;CAGtB,IAAI,YAA8D;AAChE,SAAO,KAAK,QAAQ;;CAGtB,IAAI,QAKD;AACD,SAAO,KAAK,QAAQ;;CAGtB,IAAI,YAAkE;AACpE,SAAO,KAAK,QAAQ;;CAGtB,IAAI,kBAA8D;AAChE,SAAO,KAAK,QAAQ;;CAGtB,IAAI,UAA2B;AAC7B,SAAO,KAAK,QAAQ;;CAGtB,IAAI,kBAAmC;AACrC,SAAO,KAAK,QAAQ;;CAGtB,IAAI,0BAA2C;AAC7C,SAAO,KAAK,QAAQ;;CAGtB,IAAI,SAAiB;AACnB,SAAO,KAAK,QAAQ;;CAGtB,IAAI,cAAsB;AACxB,SAAO,KAAK,QAAQ;;CAGtB,OACE,QACA,SAIwC;AACxC,SAAO,KAAK,QAAQ,OAAO,QAAQ,QAAQ;;CAG7C,MAAM,OAAsB;AAC1B,QAAM,KAAK,QAAQ,MAAM;;CAG3B,UAAU,OAAqB;AAC7B,OAAK,QAAQ,UAAU,MAAM;;CAG/B,aAAa,aAAkC;AAC7C,OAAK,QAAQ,aAAa,YAAY;;CAGxC,WACE,OACA,aACA,SAQe;AACf,SAAO,KAAK,QAAQ,WAAW,OAAO,aAAa,QAAQ;;CAG7D,oBACE,SACA,OAKY;AACZ,SAAO,KAAK,QAAQ,oBAAoB,SAAoB,MAAM;;CAGpE,aAAa,SAAgE;AAC3E,SAAO,KAAK,QAAQ,aAAa,QAAmB;;CAGtD,YAAY,YAAyD;AACnE,SAAO,KAAK,QAAQ,YAAY,WAAW;;CAG7C,mBAAmB,MAAyC;AAC1D,SAAO,KAAK,QAAQ,mBAAmB,KAAK;;CAG9C,sBAAsB,WAA8C;AAClE,SAAO,KAAK,QAAQ,sBAAsB,UAAU;;;4EApJ3C,CAAA,EAAA,cAAA"}
|
package/dist/index.d.cts
CHANGED
|
@@ -4,7 +4,7 @@ import { useStreamLGP } from "./stream.lgp.cjs";
|
|
|
4
4
|
import { Signal, WritableSignal } from "@angular/core";
|
|
5
5
|
import { AIMessage, BaseMessage, ToolMessage } from "@langchain/core/messages";
|
|
6
6
|
import { AcceptBaseMessages, AgentTypeConfigLike, BaseStream, BaseSubagentState, ClassSubagentStreamInterface, CompiledSubAgentLike, DeepAgentTypeConfigLike, DefaultSubagentStates, ExtractAgentConfig, ExtractDeepAgentConfig, ExtractSubAgentMiddleware, FetchStreamTransport, GetConfigurableType, GetInterruptType, GetToolCallsType, InferAgentToolCalls, InferBag, InferBag as InferBag$1, InferDeepAgentSubagents, InferNodeNames, InferStateType, InferStateType as InferStateType$1, InferSubagentByName, InferSubagentNames, InferSubagentState, InferSubagentStates, InferToolCalls, IsAgentLike, IsDeepAgentLike, MessageMetadata, MessageMetadata as MessageMetadata$1, QueueEntry, QueueInterface, ResolveStreamInterface, ResolveStreamInterface as ResolveStreamInterface$1, ResolveStreamOptions, ResolveStreamOptions as ResolveStreamOptions$1, SubAgentLike, SubagentApi, SubagentManager, SubagentStateMap, SubagentStatus, SubagentStream, SubagentStreamInterface, SubagentStreamInterface as SubagentStreamInterface$1, SubagentToolCall, SubmitOptions, UseAgentStream, UseAgentStreamOptions, UseDeepAgentStream, UseDeepAgentStreamOptions, UseStreamCustomOptions, UseStreamCustomOptions as UseStreamCustomOptions$1, UseStreamOptions, UseStreamThread, UseStreamTransport, WithClassMessages, calculateDepthFromNamespace, extractParentIdFromNamespace, extractToolCallIdFromNamespace, isSubagentNamespace } from "@langchain/langgraph-sdk/ui";
|
|
7
|
-
import { BagTemplate, Client, DefaultToolCall, DefaultToolCall as DefaultToolCall$1, Interrupt, StreamEvent, StreamMode, ToolCallFromTool, ToolCallState, ToolCallWithResult as ToolCallWithResult$1, ToolCallsFromTools } from "@langchain/langgraph-sdk";
|
|
7
|
+
import { AnyHeadlessToolImplementation, BagTemplate, Client, DefaultToolCall, DefaultToolCall as DefaultToolCall$1, FlushPendingHeadlessToolInterruptsOptions, HeadlessToolImplementation, HeadlessToolInterrupt, Interrupt, OnToolCallback, StreamEvent, StreamMode, ToolCallFromTool, ToolCallState, ToolCallWithResult as ToolCallWithResult$1, ToolCallsFromTools, ToolEvent, executeHeadlessTool, filterOutHeadlessToolInterrupts, findHeadlessTool, flushPendingHeadlessToolInterrupts, handleHeadlessToolInterrupt, headlessToolResumeCommand, isHeadlessToolInterrupt, parseHeadlessToolInterruptPayload } from "@langchain/langgraph-sdk";
|
|
8
8
|
|
|
9
9
|
//#region src/index.d.ts
|
|
10
10
|
type AngularWritableKeys = "isLoading" | "branch";
|
|
@@ -326,5 +326,5 @@ declare class StreamService<T = Record<string, unknown>, Bag extends BagTemplate
|
|
|
326
326
|
}
|
|
327
327
|
type ToolCallWithResult<ToolCall = DefaultToolCall$1> = ToolCallWithResult$1<ToolCall, ToolMessage, AIMessage>;
|
|
328
328
|
//#endregion
|
|
329
|
-
export { type AgentTypeConfigLike, type BaseStream, type BaseSubagentState, type ClassSubagentStreamInterface, type CompiledSubAgentLike, type DeepAgentTypeConfigLike, type DefaultSubagentStates, type DefaultToolCall, type ExtractAgentConfig, type ExtractDeepAgentConfig, type ExtractSubAgentMiddleware, FetchStreamTransport, type GetToolCallsType, type InferAgentToolCalls, type InferBag, type InferDeepAgentSubagents, type InferNodeNames, type InferStateType, type InferSubagentByName, type InferSubagentNames, type InferSubagentState, type InferSubagentStates, type InferToolCalls, type IsAgentLike, type IsDeepAgentLike, type MessageMetadata, type QueueEntry, type QueueInterface, type ResolveStreamInterface, type ResolveStreamOptions, STREAM_DEFAULTS, STREAM_INSTANCE, type StreamDefaults, StreamService, type SubAgentLike, type SubagentApi, SubagentManager, type SubagentStateMap, type SubagentStatus, type SubagentStream, type SubagentStreamInterface, type SubagentToolCall, type ToolCallFromTool, type ToolCallState, ToolCallWithResult, type ToolCallsFromTools, type UseAgentStream, type UseAgentStreamOptions, type UseDeepAgentStream, type UseDeepAgentStreamOptions, type UseStreamCustomOptions, type UseStreamOptions, type UseStreamThread, type UseStreamTransport, calculateDepthFromNamespace, extractParentIdFromNamespace, extractToolCallIdFromNamespace, injectStream, injectStreamCustom, isSubagentNamespace, provideStream, provideStreamDefaults, useStream, useStreamCustom, useStreamLGP };
|
|
329
|
+
export { type AgentTypeConfigLike, type AnyHeadlessToolImplementation, type BaseStream, type BaseSubagentState, type ClassSubagentStreamInterface, type CompiledSubAgentLike, type DeepAgentTypeConfigLike, type DefaultSubagentStates, type DefaultToolCall, type ExtractAgentConfig, type ExtractDeepAgentConfig, type ExtractSubAgentMiddleware, FetchStreamTransport, type FlushPendingHeadlessToolInterruptsOptions, type GetToolCallsType, type HeadlessToolImplementation, type HeadlessToolInterrupt, type InferAgentToolCalls, type InferBag, type InferDeepAgentSubagents, type InferNodeNames, type InferStateType, type InferSubagentByName, type InferSubagentNames, type InferSubagentState, type InferSubagentStates, type InferToolCalls, type IsAgentLike, type IsDeepAgentLike, type MessageMetadata, type OnToolCallback, type QueueEntry, type QueueInterface, type ResolveStreamInterface, type ResolveStreamOptions, STREAM_DEFAULTS, STREAM_INSTANCE, type StreamDefaults, StreamService, type SubAgentLike, type SubagentApi, SubagentManager, type SubagentStateMap, type SubagentStatus, type SubagentStream, type SubagentStreamInterface, type SubagentToolCall, type ToolCallFromTool, type ToolCallState, ToolCallWithResult, type ToolCallsFromTools, type ToolEvent, type UseAgentStream, type UseAgentStreamOptions, type UseDeepAgentStream, type UseDeepAgentStreamOptions, type UseStreamCustomOptions, type UseStreamOptions, type UseStreamThread, type UseStreamTransport, calculateDepthFromNamespace, executeHeadlessTool, extractParentIdFromNamespace, extractToolCallIdFromNamespace, filterOutHeadlessToolInterrupts, findHeadlessTool, flushPendingHeadlessToolInterrupts, handleHeadlessToolInterrupt, headlessToolResumeCommand, injectStream, injectStreamCustom, isHeadlessToolInterrupt, isSubagentNamespace, parseHeadlessToolInterruptPayload, provideStream, provideStreamDefaults, useStream, useStreamCustom, useStreamLGP };
|
|
330
330
|
//# sourceMappingURL=index.d.cts.map
|
package/dist/index.d.ts
CHANGED
|
@@ -3,7 +3,7 @@ import { STREAM_DEFAULTS, STREAM_INSTANCE, StreamDefaults, provideStream, provid
|
|
|
3
3
|
import { useStreamLGP } from "./stream.lgp.js";
|
|
4
4
|
import { Signal, WritableSignal } from "@angular/core";
|
|
5
5
|
import { AcceptBaseMessages, AgentTypeConfigLike, BaseStream, BaseSubagentState, ClassSubagentStreamInterface, CompiledSubAgentLike, DeepAgentTypeConfigLike, DefaultSubagentStates, ExtractAgentConfig, ExtractDeepAgentConfig, ExtractSubAgentMiddleware, FetchStreamTransport, GetConfigurableType, GetInterruptType, GetToolCallsType, InferAgentToolCalls, InferBag, InferBag as InferBag$1, InferDeepAgentSubagents, InferNodeNames, InferStateType, InferStateType as InferStateType$1, InferSubagentByName, InferSubagentNames, InferSubagentState, InferSubagentStates, InferToolCalls, IsAgentLike, IsDeepAgentLike, MessageMetadata, MessageMetadata as MessageMetadata$1, QueueEntry, QueueInterface, ResolveStreamInterface, ResolveStreamInterface as ResolveStreamInterface$1, ResolveStreamOptions, ResolveStreamOptions as ResolveStreamOptions$1, SubAgentLike, SubagentApi, SubagentManager, SubagentStateMap, SubagentStatus, SubagentStream, SubagentStreamInterface, SubagentStreamInterface as SubagentStreamInterface$1, SubagentToolCall, SubmitOptions, UseAgentStream, UseAgentStreamOptions, UseDeepAgentStream, UseDeepAgentStreamOptions, UseStreamCustomOptions, UseStreamCustomOptions as UseStreamCustomOptions$1, UseStreamOptions, UseStreamThread, UseStreamTransport, WithClassMessages, calculateDepthFromNamespace, extractParentIdFromNamespace, extractToolCallIdFromNamespace, isSubagentNamespace } from "@langchain/langgraph-sdk/ui";
|
|
6
|
-
import { BagTemplate, Client, DefaultToolCall, DefaultToolCall as DefaultToolCall$1, Interrupt, StreamEvent, StreamMode, ToolCallFromTool, ToolCallState, ToolCallWithResult as ToolCallWithResult$1, ToolCallsFromTools } from "@langchain/langgraph-sdk";
|
|
6
|
+
import { AnyHeadlessToolImplementation, BagTemplate, Client, DefaultToolCall, DefaultToolCall as DefaultToolCall$1, FlushPendingHeadlessToolInterruptsOptions, HeadlessToolImplementation, HeadlessToolInterrupt, Interrupt, OnToolCallback, StreamEvent, StreamMode, ToolCallFromTool, ToolCallState, ToolCallWithResult as ToolCallWithResult$1, ToolCallsFromTools, ToolEvent, executeHeadlessTool, filterOutHeadlessToolInterrupts, findHeadlessTool, flushPendingHeadlessToolInterrupts, handleHeadlessToolInterrupt, headlessToolResumeCommand, isHeadlessToolInterrupt, parseHeadlessToolInterruptPayload } from "@langchain/langgraph-sdk";
|
|
7
7
|
import { AIMessage, BaseMessage, ToolMessage } from "@langchain/core/messages";
|
|
8
8
|
|
|
9
9
|
//#region src/index.d.ts
|
|
@@ -326,5 +326,5 @@ declare class StreamService<T = Record<string, unknown>, Bag extends BagTemplate
|
|
|
326
326
|
}
|
|
327
327
|
type ToolCallWithResult<ToolCall = DefaultToolCall$1> = ToolCallWithResult$1<ToolCall, ToolMessage, AIMessage>;
|
|
328
328
|
//#endregion
|
|
329
|
-
export { type AgentTypeConfigLike, type BaseStream, type BaseSubagentState, type ClassSubagentStreamInterface, type CompiledSubAgentLike, type DeepAgentTypeConfigLike, type DefaultSubagentStates, type DefaultToolCall, type ExtractAgentConfig, type ExtractDeepAgentConfig, type ExtractSubAgentMiddleware, FetchStreamTransport, type GetToolCallsType, type InferAgentToolCalls, type InferBag, type InferDeepAgentSubagents, type InferNodeNames, type InferStateType, type InferSubagentByName, type InferSubagentNames, type InferSubagentState, type InferSubagentStates, type InferToolCalls, type IsAgentLike, type IsDeepAgentLike, type MessageMetadata, type QueueEntry, type QueueInterface, type ResolveStreamInterface, type ResolveStreamOptions, STREAM_DEFAULTS, STREAM_INSTANCE, type StreamDefaults, StreamService, type SubAgentLike, type SubagentApi, SubagentManager, type SubagentStateMap, type SubagentStatus, type SubagentStream, type SubagentStreamInterface, type SubagentToolCall, type ToolCallFromTool, type ToolCallState, ToolCallWithResult, type ToolCallsFromTools, type UseAgentStream, type UseAgentStreamOptions, type UseDeepAgentStream, type UseDeepAgentStreamOptions, type UseStreamCustomOptions, type UseStreamOptions, type UseStreamThread, type UseStreamTransport, calculateDepthFromNamespace, extractParentIdFromNamespace, extractToolCallIdFromNamespace, injectStream, injectStreamCustom, isSubagentNamespace, provideStream, provideStreamDefaults, useStream, useStreamCustom, useStreamLGP };
|
|
329
|
+
export { type AgentTypeConfigLike, type AnyHeadlessToolImplementation, type BaseStream, type BaseSubagentState, type ClassSubagentStreamInterface, type CompiledSubAgentLike, type DeepAgentTypeConfigLike, type DefaultSubagentStates, type DefaultToolCall, type ExtractAgentConfig, type ExtractDeepAgentConfig, type ExtractSubAgentMiddleware, FetchStreamTransport, type FlushPendingHeadlessToolInterruptsOptions, type GetToolCallsType, type HeadlessToolImplementation, type HeadlessToolInterrupt, type InferAgentToolCalls, type InferBag, type InferDeepAgentSubagents, type InferNodeNames, type InferStateType, type InferSubagentByName, type InferSubagentNames, type InferSubagentState, type InferSubagentStates, type InferToolCalls, type IsAgentLike, type IsDeepAgentLike, type MessageMetadata, type OnToolCallback, type QueueEntry, type QueueInterface, type ResolveStreamInterface, type ResolveStreamOptions, STREAM_DEFAULTS, STREAM_INSTANCE, type StreamDefaults, StreamService, type SubAgentLike, type SubagentApi, SubagentManager, type SubagentStateMap, type SubagentStatus, type SubagentStream, type SubagentStreamInterface, type SubagentToolCall, type ToolCallFromTool, type ToolCallState, ToolCallWithResult, type ToolCallsFromTools, type ToolEvent, type UseAgentStream, type UseAgentStreamOptions, type UseDeepAgentStream, type UseDeepAgentStreamOptions, type UseStreamCustomOptions, type UseStreamOptions, type UseStreamThread, type UseStreamTransport, calculateDepthFromNamespace, executeHeadlessTool, extractParentIdFromNamespace, extractToolCallIdFromNamespace, filterOutHeadlessToolInterrupts, findHeadlessTool, flushPendingHeadlessToolInterrupts, handleHeadlessToolInterrupt, headlessToolResumeCommand, injectStream, injectStreamCustom, isHeadlessToolInterrupt, isSubagentNamespace, parseHeadlessToolInterruptPayload, provideStream, provideStreamDefaults, useStream, useStreamCustom, useStreamLGP };
|
|
330
330
|
//# sourceMappingURL=index.d.ts.map
|
package/dist/index.js
CHANGED
|
@@ -4,6 +4,7 @@ import { STREAM_DEFAULTS, STREAM_INSTANCE, provideStream, provideStreamDefaults
|
|
|
4
4
|
import { __decorate } from "./_virtual/_@oxc-project_runtime@0.115.0/helpers/decorate.js";
|
|
5
5
|
import { Injectable, inject } from "@angular/core";
|
|
6
6
|
import { FetchStreamTransport, SubagentManager, calculateDepthFromNamespace, extractParentIdFromNamespace, extractToolCallIdFromNamespace, isSubagentNamespace } from "@langchain/langgraph-sdk/ui";
|
|
7
|
+
import { executeHeadlessTool, filterOutHeadlessToolInterrupts, findHeadlessTool, flushPendingHeadlessToolInterrupts, handleHeadlessToolInterrupt, headlessToolResumeCommand, isHeadlessToolInterrupt, parseHeadlessToolInterruptPayload } from "@langchain/langgraph-sdk";
|
|
7
8
|
//#region src/index.ts
|
|
8
9
|
/**
|
|
9
10
|
* @internal Merges DI, LangGraph Platform, and custom transport overloads.
|
|
@@ -109,6 +110,6 @@ let StreamService = class StreamService {
|
|
|
109
110
|
};
|
|
110
111
|
StreamService = __decorate([Injectable()], StreamService);
|
|
111
112
|
//#endregion
|
|
112
|
-
export { FetchStreamTransport, STREAM_DEFAULTS, STREAM_INSTANCE, StreamService, SubagentManager, calculateDepthFromNamespace, extractParentIdFromNamespace, extractToolCallIdFromNamespace, injectStream, injectStreamCustom, isSubagentNamespace, provideStream, provideStreamDefaults, useStream, useStreamCustom, useStreamLGP };
|
|
113
|
+
export { FetchStreamTransport, STREAM_DEFAULTS, STREAM_INSTANCE, StreamService, SubagentManager, calculateDepthFromNamespace, executeHeadlessTool, extractParentIdFromNamespace, extractToolCallIdFromNamespace, filterOutHeadlessToolInterrupts, findHeadlessTool, flushPendingHeadlessToolInterrupts, handleHeadlessToolInterrupt, headlessToolResumeCommand, injectStream, injectStreamCustom, isHeadlessToolInterrupt, isSubagentNamespace, parseHeadlessToolInterruptPayload, provideStream, provideStreamDefaults, useStream, useStreamCustom, useStreamLGP };
|
|
113
114
|
|
|
114
115
|
//# sourceMappingURL=index.js.map
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","names":["angularInject"],"sources":["../src/index.ts"],"sourcesContent":["import { Injectable, inject as angularInject } from \"@angular/core\";\nimport type { Signal, WritableSignal } from \"@angular/core\";\nimport type {\n BaseMessage,\n ToolMessage as CoreToolMessage,\n AIMessage as CoreAIMessage,\n} from \"@langchain/core/messages\";\nimport type {\n MessageMetadata,\n SubmitOptions,\n ResolveStreamOptions,\n ResolveStreamInterface,\n InferBag,\n InferStateType,\n AcceptBaseMessages,\n UseStreamCustomOptions,\n SubagentStreamInterface,\n WithClassMessages,\n GetConfigurableType,\n GetInterruptType,\n} from \"@langchain/langgraph-sdk/ui\";\n\nimport {\n Client,\n type StreamEvent,\n type StreamMode,\n type Message,\n type Interrupt,\n type BagTemplate,\n type ToolCallWithResult as SdkToolCallWithResult,\n type DefaultToolCall,\n} from \"@langchain/langgraph-sdk\";\nimport type { StreamServiceInstance } from \"./stream-service-instance.js\";\nimport { injectStreamCustom } from \"./stream.custom.js\";\nimport { useStreamLGP } from \"./stream.lgp.js\";\nimport { STREAM_INSTANCE } from \"./context.js\";\n\nexport { injectStreamCustom, useStreamCustom } from \"./stream.custom.js\";\nexport { FetchStreamTransport } from \"@langchain/langgraph-sdk/ui\";\nexport {\n provideStreamDefaults,\n provideStream,\n STREAM_DEFAULTS,\n STREAM_INSTANCE,\n} from \"./context.js\";\nexport type { StreamDefaults } from \"./context.js\";\nexport type { ClassSubagentStreamInterface } from \"@langchain/langgraph-sdk/ui\";\n\ntype AngularWritableKeys = \"isLoading\" | \"branch\";\n\ntype AngularPlainKeys =\n | \"submit\"\n | \"stop\"\n | \"joinStream\"\n | \"switchThread\"\n | \"setBranch\"\n | \"getMessagesMetadata\"\n | \"getToolCalls\"\n | \"getSubagent\"\n | \"getSubagentsByType\"\n | \"getSubagentsByMessage\"\n | \"client\"\n | \"assistantId\";\n\ntype AngularQueueInterface<T> = T extends {\n entries: infer E;\n size: infer S;\n cancel: infer C;\n clear: infer Cl;\n}\n ? {\n entries: WritableSignal<E>;\n size: WritableSignal<S>;\n cancel: C;\n clear: Cl;\n }\n : T;\n\ntype AngularSignalWrap<T> = {\n [K in keyof T]: K extends AngularPlainKeys\n ? T[K]\n : K extends AngularWritableKeys\n ? WritableSignal<T[K]>\n : K extends \"queue\"\n ? AngularQueueInterface<T[K]>\n : Signal<T[K]>;\n};\n\n/**\n * Injects the shared stream instance from the nearest ancestor that provided\n * one via {@link provideStream}. Throws if no ancestor provides a stream\n * instance.\n *\n * @example\n * ```typescript\n * import { Component } from \"@angular/core\";\n * import { injectStream } from \"@langchain/angular\";\n *\n * @Component({\n * template: `\n * @for (msg of stream.messages(); track msg.id) {\n * <div>{{ msg.content }}</div>\n * }\n * <button\n * [disabled]=\"stream.isLoading()\"\n * (click)=\"onSubmit()\"\n * >Send</button>\n * `,\n * })\n * export class ChatComponent {\n * stream = injectStream();\n *\n * onSubmit() {\n * void this.stream.submit({\n * messages: [{ type: \"human\", content: \"Hello!\" }],\n * });\n * }\n * }\n * ```\n *\n * @example With type parameters for full type safety:\n * ```typescript\n * import type { agent } from \"./agent\";\n *\n * export class ChatComponent {\n * stream = injectStream<typeof agent>();\n * // stream.messages() returns typed messages\n * }\n * ```\n */\nfunction injectStream<\n T = Record<string, unknown>,\n Bag extends BagTemplate = BagTemplate,\n>(): AngularSignalWrap<\n WithClassMessages<ResolveStreamInterface<T, InferBag<T, Bag>>>\n>;\n\n/**\n * Angular entry point for LangGraph streaming. Call from a component, directive,\n * or service field initializer to get a **Signals-based** stream controller\n * connected to the LangGraph Platform (HTTP + threads API).\n *\n * The returned object mirrors the shared `useStream` API from\n * `@langchain/langgraph-sdk/ui`, but reactive fields are\n * {@link https://angular.dev/guide/signals | Angular `Signal`s}:\n * read state with calls like `stream.messages()`, `stream.values()`, and\n * `stream.isLoading()`, and use `WritableSignal` setters where exposed (for\n * example `stream.branch` for branch selection).\n *\n * ## Typing with `createDeepAgent`\n *\n * Expect `export const agent = createDeepAgent({ ... })` from `deepagents`. In\n * UI code, `import { type agent } from \"./agent\"` (or `import type { agent }`)\n * is a **type-only** import: it is erased when compiling, so the agent module\n * does not run in the browser. You still pass **`typeof agent`** to\n * `injectStream`, not `agent` alone — `agent` is a value; TypeScript only\n * accepts it in a type position via `typeof` (otherwise: *refers to a value,\n * but is being used as a type*). If you prefer a named type in generics, add\n * `export type Agent = typeof agent` next to the const and use\n * `injectStream<Agent>(...)`.\n *\n * @example\n * ```typescript\n * // agent.ts\n * import { createDeepAgent } from \"deepagents\";\n * import { tool } from \"langchain\";\n * import { z } from \"zod\";\n *\n * const getWeather = tool(\n * async ({ location }) => `Weather in ${location}`,\n * { name: \"get_weather\", schema: z.object({ location: z.string() }) },\n * );\n *\n * export const agent = createDeepAgent({\n * model: \"openai:gpt-4o\",\n * tools: [getWeather],\n * });\n *\n * // chat.component.ts — type-only import; no agent runtime in the frontend\n * import { Component } from \"@angular/core\";\n * import { injectStream } from \"@langchain/angular\";\n * import { type agent } from \"./agent\";\n *\n * @Component({\n * standalone: true,\n * template: `\n * @for (msg of stream.messages(); track msg.id ?? $index) {\n * <p>{{ msg.content }}</p>\n * }\n * `,\n * })\n * export class ChatComponent {\n * readonly stream = injectStream<typeof agent>({\n * assistantId: \"agent\",\n * apiUrl: \"http://localhost:2024\",\n * });\n * // stream.toolCalls()[0].call.name is typed as \"get_weather\"\n * }\n * ```\n *\n * ## Typing with `StateGraph` / custom graph state\n *\n * Use your graph state interface as `T` and embed tool call unions in\n * `Message<...>[]` when you need discriminated tool types.\n *\n * @example\n * ```typescript\n * import { Message } from \"@langchain/langgraph-sdk\";\n * import { Component } from \"@angular/core\";\n * import { injectStream } from \"@langchain/angular\";\n *\n * type MyToolCalls =\n * | { name: \"search\"; args: { query: string }; id?: string }\n * | { name: \"calculate\"; args: { expression: string }; id?: string };\n *\n * interface MyGraphState {\n * messages: Message<MyToolCalls>[];\n * context?: string;\n * }\n *\n * @Component({ standalone: true, template: \"\" })\n * export class ChatComponent {\n * readonly stream = injectStream<MyGraphState>({\n * assistantId: \"my-graph\",\n * apiUrl: \"http://localhost:2024\",\n * });\n * // stream.values() is typed as MyGraphState | null\n * }\n * ```\n *\n * @example\n * ```typescript\n * // Optional bag for interrupts, configurable, custom events, and updates\n * import { Component } from \"@angular/core\";\n * import { injectStream } from \"@langchain/angular\";\n * import type { Message } from \"@langchain/langgraph-sdk\";\n *\n * interface MyGraphState {\n * messages: Message[];\n * }\n *\n * @Component({ standalone: true, template: \"\" })\n * export class ChatComponent {\n * readonly stream = injectStream<\n * MyGraphState,\n * {\n * InterruptType: { question: string };\n * ConfigurableType: { userId: string };\n * }\n * >({\n * assistantId: \"my-graph\",\n * apiUrl: \"http://localhost:2024\",\n * });\n * // stream.interrupt() is typed as { question: string } | undefined\n * }\n * ```\n *\n * ## Subagent streaming\n *\n * For `createDeepAgent` agents with `subagents`, set `filterSubagentMessages`\n * and use `streamSubgraphs` on `submit` to populate `stream.subagents` and\n * related helpers.\n *\n * @example\n * ```typescript\n * import { Component } from \"@angular/core\";\n * import { injectStream } from \"@langchain/angular\";\n * import { type agent } from \"./agent\";\n *\n * @Component({ standalone: true, template: \"\" })\n * export class DeepAgentChatComponent {\n * readonly stream = injectStream<typeof agent>({\n * assistantId: \"deepagent\",\n * apiUrl: \"http://localhost:2024\",\n * filterSubagentMessages: true,\n * });\n *\n * send(content: string) {\n * void this.stream.submit(\n * { messages: [{ content, type: \"human\" }] },\n * { streamSubgraphs: true },\n * );\n * }\n * }\n * ```\n *\n * @param options - LangGraph Platform client options (`apiUrl` or `client`),\n * `assistantId`, stream modes, history, reconnect, subagent settings, etc.\n *\n * @returns A stream controller backed by Signals: graph values, messages,\n * loading and error state, interrupts, tool calls, branching, queue, and\n * `submit` / `stop` / `switchThread` helpers (writable where the UI layer\n * requires mutation).\n *\n * @template T Agent type (with `~agentTypes`) from `createDeepAgent` or\n * `createAgent`, or a state shape extending `Record<string, unknown>`.\n * @template Bag Optional configuration bag:\n * - `ConfigurableType` — `config.configurable` typing\n * - `InterruptType` — human-in-the-loop interrupt payloads\n * - `CustomEventType` — custom stream events\n * - `UpdateType` — payload typing for `submit`\n *\n * @see {@link https://docs.langchain.com/oss/javascript/langgraph/overview | LangGraph JavaScript overview}\n * @see {@link https://docs.langchain.com/oss/javascript/langchain/overview | LangChain JavaScript overview}\n * @see {@link https://docs.langchain.com/oss/javascript/deepagents/overview | Deep Agents JavaScript overview}\n */\nfunction injectStream<\n T = Record<string, unknown>,\n Bag extends BagTemplate = BagTemplate,\n>(\n options: ResolveStreamOptions<T, InferBag<T, Bag>>\n): AngularSignalWrap<\n WithClassMessages<ResolveStreamInterface<T, InferBag<T, Bag>>>\n>;\n\n/**\n * Overload for a **custom transport** (`options.transport`), for example\n * {@link FetchStreamTransport} or any implementation compatible with\n * {@link injectStreamCustom}. Prefer {@link injectStreamCustom} directly when\n * you only use custom transports and want a narrower import.\n *\n * @param options - Custom transport and stream options (must include\n * `transport`).\n *\n * @returns The same Signals-based controller shape as the LangGraph Platform\n * overload.\n *\n * @template T Agent type or state shape, matching the custom transport.\n * @template Bag Same optional bag as the platform overload.\n *\n * @see {@link injectStreamCustom}\n */\nfunction injectStream<\n T = Record<string, unknown>,\n Bag extends BagTemplate = BagTemplate,\n>(\n options: UseStreamCustomOptions<InferStateType<T>, InferBag<T, Bag>>\n): AngularSignalWrap<\n WithClassMessages<ResolveStreamInterface<T, InferBag<T, Bag>>>\n>;\n\n/**\n * @internal Merges DI, LangGraph Platform, and custom transport overloads.\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nfunction injectStream(options?: any): any {\n if (arguments.length === 0) {\n const instance = angularInject(STREAM_INSTANCE, { optional: true });\n if (instance == null) {\n throw new Error(\n \"injectStream() requires an ancestor component to provide a stream via provideStream(). \" +\n \"Add provideStream({ assistantId: '...' }) to the providers array of a parent component, \" +\n \"or use injectStream(options) directly.\"\n );\n }\n return instance;\n }\n if (\"transport\" in options) {\n return injectStreamCustom(options);\n }\n return useStreamLGP(options);\n}\n\nexport { injectStream };\n\n/**\n * @deprecated Use `injectStream` instead. `useStream` will be removed in a\n * future major version. `injectStream` follows Angular's `inject*` naming\n * convention for injection-based patterns.\n */\nexport const useStream = injectStream;\n\nexport { useStreamLGP } from \"./stream.lgp.js\";\n\n/**\n * Injectable Angular service that wraps {@link injectStream}.\n *\n * Extend this class with your own `@Injectable()` service and call\n * `super(options)` in the constructor:\n *\n * ```ts\n * \\@Injectable({ providedIn: 'root' })\n * export class ChatService extends StreamService {\n * constructor() {\n * super({ assistantId: 'agent', apiUrl: '...' });\n * }\n * }\n * ```\n *\n * The service exposes the same signals and methods as `injectStream`\n * (e.g. `values`, `messages`, `isLoading`, `submit`, `stop`).\n *\n * Must be created within an Angular injection context (via DI or\n * `runInInjectionContext`).\n */\n@Injectable()\nexport class StreamService<\n T = Record<string, unknown>,\n Bag extends BagTemplate = BagTemplate,\n> {\n private readonly _stream: StreamServiceInstance<T, Bag>;\n\n constructor(\n options:\n | ResolveStreamOptions<T, InferBag<T, Bag>>\n | UseStreamCustomOptions<InferStateType<T>, InferBag<T, Bag>>\n ) {\n this._stream = injectStream(\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n options as any\n ) as unknown as StreamServiceInstance<T, Bag>;\n }\n\n get values(): Signal<T> {\n return this._stream.values;\n }\n\n get messages(): Signal<BaseMessage[]> {\n return this._stream.messages;\n }\n\n get isLoading(): WritableSignal<boolean> {\n return this._stream.isLoading;\n }\n\n get error(): Signal<unknown> {\n return this._stream.error;\n }\n\n get branch(): WritableSignal<string> {\n return this._stream.branch;\n }\n\n get interrupt(): Signal<Interrupt<GetInterruptType<Bag>> | undefined> {\n return this._stream.interrupt;\n }\n\n get interrupts(): Signal<Interrupt<GetInterruptType<Bag>>[]> {\n return this._stream.interrupts;\n }\n\n get toolCalls(): Signal<SdkToolCallWithResult<DefaultToolCall>[]> {\n return this._stream.toolCalls;\n }\n\n get queue(): AngularQueueInterface<{\n entries: readonly { id: string; values: Partial<T> | null | undefined }[];\n size: number;\n cancel: (id: string) => Promise<boolean>;\n clear: () => Promise<void>;\n }> {\n return this._stream.queue;\n }\n\n get subagents(): Signal<ReadonlyMap<string, SubagentStreamInterface>> {\n return this._stream.subagents;\n }\n\n get activeSubagents(): Signal<readonly SubagentStreamInterface[]> {\n return this._stream.activeSubagents;\n }\n\n get history(): Signal<unknown> {\n return this._stream.history;\n }\n\n get isThreadLoading(): Signal<boolean> {\n return this._stream.isThreadLoading;\n }\n\n get experimental_branchTree(): Signal<unknown> {\n return this._stream.experimental_branchTree;\n }\n\n get client(): Client {\n return this._stream.client;\n }\n\n get assistantId(): string {\n return this._stream.assistantId;\n }\n\n submit(\n values: AcceptBaseMessages<Exclude<T, null | undefined>> | null | undefined,\n options?: SubmitOptions<\n T extends Record<string, unknown> ? T : Record<string, unknown>,\n GetConfigurableType<Bag>\n >\n ): ReturnType<typeof this._stream.submit> {\n return this._stream.submit(values, options);\n }\n\n async stop(): Promise<void> {\n await this._stream.stop();\n }\n\n setBranch(value: string): void {\n this._stream.setBranch(value);\n }\n\n switchThread(newThreadId: string | null): void {\n this._stream.switchThread(newThreadId);\n }\n\n joinStream(\n runId: string,\n lastEventId?: string,\n options?: {\n streamMode?: StreamMode | StreamMode[];\n filter?: (event: {\n id?: string;\n event: StreamEvent;\n data: unknown;\n }) => boolean;\n }\n ): Promise<void> {\n return this._stream.joinStream(runId, lastEventId, options);\n }\n\n getMessagesMetadata(\n message: BaseMessage,\n index?: number\n ):\n | MessageMetadata<\n T extends Record<string, unknown> ? T : Record<string, unknown>\n >\n | undefined {\n return this._stream.getMessagesMetadata(message as Message, index);\n }\n\n getToolCalls(message: BaseMessage): SdkToolCallWithResult<DefaultToolCall>[] {\n return this._stream.getToolCalls(message as Message);\n }\n\n getSubagent(toolCallId: string): SubagentStreamInterface | undefined {\n return this._stream.getSubagent(toolCallId);\n }\n\n getSubagentsByType(type: string): SubagentStreamInterface[] {\n return this._stream.getSubagentsByType(type);\n }\n\n getSubagentsByMessage(messageId: string): SubagentStreamInterface[] {\n return this._stream.getSubagentsByMessage(messageId);\n }\n}\n\nexport type {\n BaseStream,\n UseAgentStream,\n UseAgentStreamOptions,\n UseDeepAgentStream,\n UseDeepAgentStreamOptions,\n ResolveStreamInterface,\n ResolveStreamOptions,\n InferStateType,\n InferToolCalls,\n InferSubagentStates,\n InferNodeNames,\n InferBag,\n MessageMetadata,\n UseStreamOptions,\n UseStreamCustomOptions,\n UseStreamTransport,\n UseStreamThread,\n GetToolCallsType,\n AgentTypeConfigLike,\n IsAgentLike,\n ExtractAgentConfig,\n InferAgentToolCalls,\n SubagentToolCall,\n SubagentStatus,\n SubagentApi,\n SubagentStream,\n SubagentStreamInterface,\n SubAgentLike,\n CompiledSubAgentLike,\n DeepAgentTypeConfigLike,\n IsDeepAgentLike,\n ExtractDeepAgentConfig,\n ExtractSubAgentMiddleware,\n InferDeepAgentSubagents,\n InferSubagentByName,\n InferSubagentState,\n InferSubagentNames,\n SubagentStateMap,\n DefaultSubagentStates,\n BaseSubagentState,\n QueueEntry,\n QueueInterface,\n} from \"@langchain/langgraph-sdk/ui\";\n\nexport type ToolCallWithResult<ToolCall = DefaultToolCall> =\n SdkToolCallWithResult<ToolCall, CoreToolMessage, CoreAIMessage>;\nexport type {\n ToolCallState,\n DefaultToolCall,\n ToolCallFromTool,\n ToolCallsFromTools,\n} from \"@langchain/langgraph-sdk\";\n\nexport {\n SubagentManager,\n extractToolCallIdFromNamespace,\n calculateDepthFromNamespace,\n extractParentIdFromNamespace,\n isSubagentNamespace,\n} from \"@langchain/langgraph-sdk/ui\";\n"],"mappings":";;;;;;;;;;AAyVA,SAAS,aAAa,SAAoB;AACxC,KAAI,UAAU,WAAW,GAAG;EAC1B,MAAM,WAAWA,OAAc,iBAAiB,EAAE,UAAU,MAAM,CAAC;AACnE,MAAI,YAAY,KACd,OAAM,IAAI,MACR,wNAGD;AAEH,SAAO;;AAET,KAAI,eAAe,QACjB,QAAO,mBAAmB,QAAQ;AAEpC,QAAO,aAAa,QAAQ;;;;;;;AAU9B,MAAa,YAAY;AA0BlB,IAAA,gBAAA,MAAM,cAGX;CACA;CAEA,YACE,SAGA;AACA,OAAK,UAAU,aAEb,QACD;;CAGH,IAAI,SAAoB;AACtB,SAAO,KAAK,QAAQ;;CAGtB,IAAI,WAAkC;AACpC,SAAO,KAAK,QAAQ;;CAGtB,IAAI,YAAqC;AACvC,SAAO,KAAK,QAAQ;;CAGtB,IAAI,QAAyB;AAC3B,SAAO,KAAK,QAAQ;;CAGtB,IAAI,SAAiC;AACnC,SAAO,KAAK,QAAQ;;CAGtB,IAAI,YAAkE;AACpE,SAAO,KAAK,QAAQ;;CAGtB,IAAI,aAAyD;AAC3D,SAAO,KAAK,QAAQ;;CAGtB,IAAI,YAA8D;AAChE,SAAO,KAAK,QAAQ;;CAGtB,IAAI,QAKD;AACD,SAAO,KAAK,QAAQ;;CAGtB,IAAI,YAAkE;AACpE,SAAO,KAAK,QAAQ;;CAGtB,IAAI,kBAA8D;AAChE,SAAO,KAAK,QAAQ;;CAGtB,IAAI,UAA2B;AAC7B,SAAO,KAAK,QAAQ;;CAGtB,IAAI,kBAAmC;AACrC,SAAO,KAAK,QAAQ;;CAGtB,IAAI,0BAA2C;AAC7C,SAAO,KAAK,QAAQ;;CAGtB,IAAI,SAAiB;AACnB,SAAO,KAAK,QAAQ;;CAGtB,IAAI,cAAsB;AACxB,SAAO,KAAK,QAAQ;;CAGtB,OACE,QACA,SAIwC;AACxC,SAAO,KAAK,QAAQ,OAAO,QAAQ,QAAQ;;CAG7C,MAAM,OAAsB;AAC1B,QAAM,KAAK,QAAQ,MAAM;;CAG3B,UAAU,OAAqB;AAC7B,OAAK,QAAQ,UAAU,MAAM;;CAG/B,aAAa,aAAkC;AAC7C,OAAK,QAAQ,aAAa,YAAY;;CAGxC,WACE,OACA,aACA,SAQe;AACf,SAAO,KAAK,QAAQ,WAAW,OAAO,aAAa,QAAQ;;CAG7D,oBACE,SACA,OAKY;AACZ,SAAO,KAAK,QAAQ,oBAAoB,SAAoB,MAAM;;CAGpE,aAAa,SAAgE;AAC3E,SAAO,KAAK,QAAQ,aAAa,QAAmB;;CAGtD,YAAY,YAAyD;AACnE,SAAO,KAAK,QAAQ,YAAY,WAAW;;CAG7C,mBAAmB,MAAyC;AAC1D,SAAO,KAAK,QAAQ,mBAAmB,KAAK;;CAG9C,sBAAsB,WAA8C;AAClE,SAAO,KAAK,QAAQ,sBAAsB,UAAU;;;4BApJvD,YAAY,CAAA,EAAA,cAAA"}
|
|
1
|
+
{"version":3,"file":"index.js","names":["angularInject"],"sources":["../src/index.ts"],"sourcesContent":["import { Injectable, inject as angularInject } from \"@angular/core\";\nimport type { Signal, WritableSignal } from \"@angular/core\";\nimport type {\n BaseMessage,\n ToolMessage as CoreToolMessage,\n AIMessage as CoreAIMessage,\n} from \"@langchain/core/messages\";\nimport type {\n MessageMetadata,\n SubmitOptions,\n ResolveStreamOptions,\n ResolveStreamInterface,\n InferBag,\n InferStateType,\n AcceptBaseMessages,\n UseStreamCustomOptions,\n SubagentStreamInterface,\n WithClassMessages,\n GetConfigurableType,\n GetInterruptType,\n} from \"@langchain/langgraph-sdk/ui\";\n\nimport {\n Client,\n type StreamEvent,\n type StreamMode,\n type Message,\n type Interrupt,\n type BagTemplate,\n type ToolCallWithResult as SdkToolCallWithResult,\n type DefaultToolCall,\n} from \"@langchain/langgraph-sdk\";\nimport type { StreamServiceInstance } from \"./stream-service-instance.js\";\nimport { injectStreamCustom } from \"./stream.custom.js\";\nimport { useStreamLGP } from \"./stream.lgp.js\";\nimport { STREAM_INSTANCE } from \"./context.js\";\n\nexport { injectStreamCustom, useStreamCustom } from \"./stream.custom.js\";\nexport { FetchStreamTransport } from \"@langchain/langgraph-sdk/ui\";\nexport {\n provideStreamDefaults,\n provideStream,\n STREAM_DEFAULTS,\n STREAM_INSTANCE,\n} from \"./context.js\";\nexport type { StreamDefaults } from \"./context.js\";\nexport type { ClassSubagentStreamInterface } from \"@langchain/langgraph-sdk/ui\";\n\ntype AngularWritableKeys = \"isLoading\" | \"branch\";\n\ntype AngularPlainKeys =\n | \"submit\"\n | \"stop\"\n | \"joinStream\"\n | \"switchThread\"\n | \"setBranch\"\n | \"getMessagesMetadata\"\n | \"getToolCalls\"\n | \"getSubagent\"\n | \"getSubagentsByType\"\n | \"getSubagentsByMessage\"\n | \"client\"\n | \"assistantId\";\n\ntype AngularQueueInterface<T> = T extends {\n entries: infer E;\n size: infer S;\n cancel: infer C;\n clear: infer Cl;\n}\n ? {\n entries: WritableSignal<E>;\n size: WritableSignal<S>;\n cancel: C;\n clear: Cl;\n }\n : T;\n\ntype AngularSignalWrap<T> = {\n [K in keyof T]: K extends AngularPlainKeys\n ? T[K]\n : K extends AngularWritableKeys\n ? WritableSignal<T[K]>\n : K extends \"queue\"\n ? AngularQueueInterface<T[K]>\n : Signal<T[K]>;\n};\n\n/**\n * Injects the shared stream instance from the nearest ancestor that provided\n * one via {@link provideStream}. Throws if no ancestor provides a stream\n * instance.\n *\n * @example\n * ```typescript\n * import { Component } from \"@angular/core\";\n * import { injectStream } from \"@langchain/angular\";\n *\n * @Component({\n * template: `\n * @for (msg of stream.messages(); track msg.id) {\n * <div>{{ msg.content }}</div>\n * }\n * <button\n * [disabled]=\"stream.isLoading()\"\n * (click)=\"onSubmit()\"\n * >Send</button>\n * `,\n * })\n * export class ChatComponent {\n * stream = injectStream();\n *\n * onSubmit() {\n * void this.stream.submit({\n * messages: [{ type: \"human\", content: \"Hello!\" }],\n * });\n * }\n * }\n * ```\n *\n * @example With type parameters for full type safety:\n * ```typescript\n * import type { agent } from \"./agent\";\n *\n * export class ChatComponent {\n * stream = injectStream<typeof agent>();\n * // stream.messages() returns typed messages\n * }\n * ```\n */\nfunction injectStream<\n T = Record<string, unknown>,\n Bag extends BagTemplate = BagTemplate,\n>(): AngularSignalWrap<\n WithClassMessages<ResolveStreamInterface<T, InferBag<T, Bag>>>\n>;\n\n/**\n * Angular entry point for LangGraph streaming. Call from a component, directive,\n * or service field initializer to get a **Signals-based** stream controller\n * connected to the LangGraph Platform (HTTP + threads API).\n *\n * The returned object mirrors the shared `useStream` API from\n * `@langchain/langgraph-sdk/ui`, but reactive fields are\n * {@link https://angular.dev/guide/signals | Angular `Signal`s}:\n * read state with calls like `stream.messages()`, `stream.values()`, and\n * `stream.isLoading()`, and use `WritableSignal` setters where exposed (for\n * example `stream.branch` for branch selection).\n *\n * ## Typing with `createDeepAgent`\n *\n * Expect `export const agent = createDeepAgent({ ... })` from `deepagents`. In\n * UI code, `import { type agent } from \"./agent\"` (or `import type { agent }`)\n * is a **type-only** import: it is erased when compiling, so the agent module\n * does not run in the browser. You still pass **`typeof agent`** to\n * `injectStream`, not `agent` alone — `agent` is a value; TypeScript only\n * accepts it in a type position via `typeof` (otherwise: *refers to a value,\n * but is being used as a type*). If you prefer a named type in generics, add\n * `export type Agent = typeof agent` next to the const and use\n * `injectStream<Agent>(...)`.\n *\n * @example\n * ```typescript\n * // agent.ts\n * import { createDeepAgent } from \"deepagents\";\n * import { tool } from \"langchain\";\n * import { z } from \"zod\";\n *\n * const getWeather = tool(\n * async ({ location }) => `Weather in ${location}`,\n * { name: \"get_weather\", schema: z.object({ location: z.string() }) },\n * );\n *\n * export const agent = createDeepAgent({\n * model: \"openai:gpt-4o\",\n * tools: [getWeather],\n * });\n *\n * // chat.component.ts — type-only import; no agent runtime in the frontend\n * import { Component } from \"@angular/core\";\n * import { injectStream } from \"@langchain/angular\";\n * import { type agent } from \"./agent\";\n *\n * @Component({\n * standalone: true,\n * template: `\n * @for (msg of stream.messages(); track msg.id ?? $index) {\n * <p>{{ msg.content }}</p>\n * }\n * `,\n * })\n * export class ChatComponent {\n * readonly stream = injectStream<typeof agent>({\n * assistantId: \"agent\",\n * apiUrl: \"http://localhost:2024\",\n * });\n * // stream.toolCalls()[0].call.name is typed as \"get_weather\"\n * }\n * ```\n *\n * ## Typing with `StateGraph` / custom graph state\n *\n * Use your graph state interface as `T` and embed tool call unions in\n * `Message<...>[]` when you need discriminated tool types.\n *\n * @example\n * ```typescript\n * import { Message } from \"@langchain/langgraph-sdk\";\n * import { Component } from \"@angular/core\";\n * import { injectStream } from \"@langchain/angular\";\n *\n * type MyToolCalls =\n * | { name: \"search\"; args: { query: string }; id?: string }\n * | { name: \"calculate\"; args: { expression: string }; id?: string };\n *\n * interface MyGraphState {\n * messages: Message<MyToolCalls>[];\n * context?: string;\n * }\n *\n * @Component({ standalone: true, template: \"\" })\n * export class ChatComponent {\n * readonly stream = injectStream<MyGraphState>({\n * assistantId: \"my-graph\",\n * apiUrl: \"http://localhost:2024\",\n * });\n * // stream.values() is typed as MyGraphState | null\n * }\n * ```\n *\n * @example\n * ```typescript\n * // Optional bag for interrupts, configurable, custom events, and updates\n * import { Component } from \"@angular/core\";\n * import { injectStream } from \"@langchain/angular\";\n * import type { Message } from \"@langchain/langgraph-sdk\";\n *\n * interface MyGraphState {\n * messages: Message[];\n * }\n *\n * @Component({ standalone: true, template: \"\" })\n * export class ChatComponent {\n * readonly stream = injectStream<\n * MyGraphState,\n * {\n * InterruptType: { question: string };\n * ConfigurableType: { userId: string };\n * }\n * >({\n * assistantId: \"my-graph\",\n * apiUrl: \"http://localhost:2024\",\n * });\n * // stream.interrupt() is typed as { question: string } | undefined\n * }\n * ```\n *\n * ## Subagent streaming\n *\n * For `createDeepAgent` agents with `subagents`, set `filterSubagentMessages`\n * and use `streamSubgraphs` on `submit` to populate `stream.subagents` and\n * related helpers.\n *\n * @example\n * ```typescript\n * import { Component } from \"@angular/core\";\n * import { injectStream } from \"@langchain/angular\";\n * import { type agent } from \"./agent\";\n *\n * @Component({ standalone: true, template: \"\" })\n * export class DeepAgentChatComponent {\n * readonly stream = injectStream<typeof agent>({\n * assistantId: \"deepagent\",\n * apiUrl: \"http://localhost:2024\",\n * filterSubagentMessages: true,\n * });\n *\n * send(content: string) {\n * void this.stream.submit(\n * { messages: [{ content, type: \"human\" }] },\n * { streamSubgraphs: true },\n * );\n * }\n * }\n * ```\n *\n * @param options - LangGraph Platform client options (`apiUrl` or `client`),\n * `assistantId`, stream modes, history, reconnect, subagent settings, etc.\n *\n * @returns A stream controller backed by Signals: graph values, messages,\n * loading and error state, interrupts, tool calls, branching, queue, and\n * `submit` / `stop` / `switchThread` helpers (writable where the UI layer\n * requires mutation).\n *\n * @template T Agent type (with `~agentTypes`) from `createDeepAgent` or\n * `createAgent`, or a state shape extending `Record<string, unknown>`.\n * @template Bag Optional configuration bag:\n * - `ConfigurableType` — `config.configurable` typing\n * - `InterruptType` — human-in-the-loop interrupt payloads\n * - `CustomEventType` — custom stream events\n * - `UpdateType` — payload typing for `submit`\n *\n * @see {@link https://docs.langchain.com/oss/javascript/langgraph/overview | LangGraph JavaScript overview}\n * @see {@link https://docs.langchain.com/oss/javascript/langchain/overview | LangChain JavaScript overview}\n * @see {@link https://docs.langchain.com/oss/javascript/deepagents/overview | Deep Agents JavaScript overview}\n */\nfunction injectStream<\n T = Record<string, unknown>,\n Bag extends BagTemplate = BagTemplate,\n>(\n options: ResolveStreamOptions<T, InferBag<T, Bag>>\n): AngularSignalWrap<\n WithClassMessages<ResolveStreamInterface<T, InferBag<T, Bag>>>\n>;\n\n/**\n * Overload for a **custom transport** (`options.transport`), for example\n * {@link FetchStreamTransport} or any implementation compatible with\n * {@link injectStreamCustom}. Prefer {@link injectStreamCustom} directly when\n * you only use custom transports and want a narrower import.\n *\n * @param options - Custom transport and stream options (must include\n * `transport`).\n *\n * @returns The same Signals-based controller shape as the LangGraph Platform\n * overload.\n *\n * @template T Agent type or state shape, matching the custom transport.\n * @template Bag Same optional bag as the platform overload.\n *\n * @see {@link injectStreamCustom}\n */\nfunction injectStream<\n T = Record<string, unknown>,\n Bag extends BagTemplate = BagTemplate,\n>(\n options: UseStreamCustomOptions<InferStateType<T>, InferBag<T, Bag>>\n): AngularSignalWrap<\n WithClassMessages<ResolveStreamInterface<T, InferBag<T, Bag>>>\n>;\n\n/**\n * @internal Merges DI, LangGraph Platform, and custom transport overloads.\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nfunction injectStream(options?: any): any {\n if (arguments.length === 0) {\n const instance = angularInject(STREAM_INSTANCE, { optional: true });\n if (instance == null) {\n throw new Error(\n \"injectStream() requires an ancestor component to provide a stream via provideStream(). \" +\n \"Add provideStream({ assistantId: '...' }) to the providers array of a parent component, \" +\n \"or use injectStream(options) directly.\"\n );\n }\n return instance;\n }\n if (\"transport\" in options) {\n return injectStreamCustom(options);\n }\n return useStreamLGP(options);\n}\n\nexport { injectStream };\n\n/**\n * @deprecated Use `injectStream` instead. `useStream` will be removed in a\n * future major version. `injectStream` follows Angular's `inject*` naming\n * convention for injection-based patterns.\n */\nexport const useStream = injectStream;\n\nexport { useStreamLGP } from \"./stream.lgp.js\";\n\n/**\n * Injectable Angular service that wraps {@link injectStream}.\n *\n * Extend this class with your own `@Injectable()` service and call\n * `super(options)` in the constructor:\n *\n * ```ts\n * \\@Injectable({ providedIn: 'root' })\n * export class ChatService extends StreamService {\n * constructor() {\n * super({ assistantId: 'agent', apiUrl: '...' });\n * }\n * }\n * ```\n *\n * The service exposes the same signals and methods as `injectStream`\n * (e.g. `values`, `messages`, `isLoading`, `submit`, `stop`).\n *\n * Must be created within an Angular injection context (via DI or\n * `runInInjectionContext`).\n */\n@Injectable()\nexport class StreamService<\n T = Record<string, unknown>,\n Bag extends BagTemplate = BagTemplate,\n> {\n private readonly _stream: StreamServiceInstance<T, Bag>;\n\n constructor(\n options:\n | ResolveStreamOptions<T, InferBag<T, Bag>>\n | UseStreamCustomOptions<InferStateType<T>, InferBag<T, Bag>>\n ) {\n this._stream = injectStream(\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n options as any\n ) as unknown as StreamServiceInstance<T, Bag>;\n }\n\n get values(): Signal<T> {\n return this._stream.values;\n }\n\n get messages(): Signal<BaseMessage[]> {\n return this._stream.messages;\n }\n\n get isLoading(): WritableSignal<boolean> {\n return this._stream.isLoading;\n }\n\n get error(): Signal<unknown> {\n return this._stream.error;\n }\n\n get branch(): WritableSignal<string> {\n return this._stream.branch;\n }\n\n get interrupt(): Signal<Interrupt<GetInterruptType<Bag>> | undefined> {\n return this._stream.interrupt;\n }\n\n get interrupts(): Signal<Interrupt<GetInterruptType<Bag>>[]> {\n return this._stream.interrupts;\n }\n\n get toolCalls(): Signal<SdkToolCallWithResult<DefaultToolCall>[]> {\n return this._stream.toolCalls;\n }\n\n get queue(): AngularQueueInterface<{\n entries: readonly { id: string; values: Partial<T> | null | undefined }[];\n size: number;\n cancel: (id: string) => Promise<boolean>;\n clear: () => Promise<void>;\n }> {\n return this._stream.queue;\n }\n\n get subagents(): Signal<ReadonlyMap<string, SubagentStreamInterface>> {\n return this._stream.subagents;\n }\n\n get activeSubagents(): Signal<readonly SubagentStreamInterface[]> {\n return this._stream.activeSubagents;\n }\n\n get history(): Signal<unknown> {\n return this._stream.history;\n }\n\n get isThreadLoading(): Signal<boolean> {\n return this._stream.isThreadLoading;\n }\n\n get experimental_branchTree(): Signal<unknown> {\n return this._stream.experimental_branchTree;\n }\n\n get client(): Client {\n return this._stream.client;\n }\n\n get assistantId(): string {\n return this._stream.assistantId;\n }\n\n submit(\n values: AcceptBaseMessages<Exclude<T, null | undefined>> | null | undefined,\n options?: SubmitOptions<\n T extends Record<string, unknown> ? T : Record<string, unknown>,\n GetConfigurableType<Bag>\n >\n ): ReturnType<typeof this._stream.submit> {\n return this._stream.submit(values, options);\n }\n\n async stop(): Promise<void> {\n await this._stream.stop();\n }\n\n setBranch(value: string): void {\n this._stream.setBranch(value);\n }\n\n switchThread(newThreadId: string | null): void {\n this._stream.switchThread(newThreadId);\n }\n\n joinStream(\n runId: string,\n lastEventId?: string,\n options?: {\n streamMode?: StreamMode | StreamMode[];\n filter?: (event: {\n id?: string;\n event: StreamEvent;\n data: unknown;\n }) => boolean;\n }\n ): Promise<void> {\n return this._stream.joinStream(runId, lastEventId, options);\n }\n\n getMessagesMetadata(\n message: BaseMessage,\n index?: number\n ):\n | MessageMetadata<\n T extends Record<string, unknown> ? T : Record<string, unknown>\n >\n | undefined {\n return this._stream.getMessagesMetadata(message as Message, index);\n }\n\n getToolCalls(message: BaseMessage): SdkToolCallWithResult<DefaultToolCall>[] {\n return this._stream.getToolCalls(message as Message);\n }\n\n getSubagent(toolCallId: string): SubagentStreamInterface | undefined {\n return this._stream.getSubagent(toolCallId);\n }\n\n getSubagentsByType(type: string): SubagentStreamInterface[] {\n return this._stream.getSubagentsByType(type);\n }\n\n getSubagentsByMessage(messageId: string): SubagentStreamInterface[] {\n return this._stream.getSubagentsByMessage(messageId);\n }\n}\n\nexport type {\n BaseStream,\n UseAgentStream,\n UseAgentStreamOptions,\n UseDeepAgentStream,\n UseDeepAgentStreamOptions,\n ResolveStreamInterface,\n ResolveStreamOptions,\n InferStateType,\n InferToolCalls,\n InferSubagentStates,\n InferNodeNames,\n InferBag,\n MessageMetadata,\n UseStreamOptions,\n UseStreamCustomOptions,\n UseStreamTransport,\n UseStreamThread,\n GetToolCallsType,\n AgentTypeConfigLike,\n IsAgentLike,\n ExtractAgentConfig,\n InferAgentToolCalls,\n SubagentToolCall,\n SubagentStatus,\n SubagentApi,\n SubagentStream,\n SubagentStreamInterface,\n SubAgentLike,\n CompiledSubAgentLike,\n DeepAgentTypeConfigLike,\n IsDeepAgentLike,\n ExtractDeepAgentConfig,\n ExtractSubAgentMiddleware,\n InferDeepAgentSubagents,\n InferSubagentByName,\n InferSubagentState,\n InferSubagentNames,\n SubagentStateMap,\n DefaultSubagentStates,\n BaseSubagentState,\n QueueEntry,\n QueueInterface,\n} from \"@langchain/langgraph-sdk/ui\";\n\nexport type ToolCallWithResult<ToolCall = DefaultToolCall> =\n SdkToolCallWithResult<ToolCall, CoreToolMessage, CoreAIMessage>;\nexport type {\n ToolCallState,\n DefaultToolCall,\n ToolCallFromTool,\n ToolCallsFromTools,\n} from \"@langchain/langgraph-sdk\";\nexport type {\n HeadlessToolImplementation,\n AnyHeadlessToolImplementation,\n ToolEvent,\n HeadlessToolInterrupt,\n OnToolCallback,\n FlushPendingHeadlessToolInterruptsOptions,\n} from \"@langchain/langgraph-sdk\";\n\nexport {\n SubagentManager,\n extractToolCallIdFromNamespace,\n calculateDepthFromNamespace,\n extractParentIdFromNamespace,\n isSubagentNamespace,\n} from \"@langchain/langgraph-sdk/ui\";\nexport {\n isHeadlessToolInterrupt,\n parseHeadlessToolInterruptPayload,\n filterOutHeadlessToolInterrupts,\n findHeadlessTool,\n executeHeadlessTool,\n handleHeadlessToolInterrupt,\n headlessToolResumeCommand,\n flushPendingHeadlessToolInterrupts,\n} from \"@langchain/langgraph-sdk\";\n"],"mappings":";;;;;;;;;;;AAyVA,SAAS,aAAa,SAAoB;AACxC,KAAI,UAAU,WAAW,GAAG;EAC1B,MAAM,WAAWA,OAAc,iBAAiB,EAAE,UAAU,MAAM,CAAC;AACnE,MAAI,YAAY,KACd,OAAM,IAAI,MACR,wNAGD;AAEH,SAAO;;AAET,KAAI,eAAe,QACjB,QAAO,mBAAmB,QAAQ;AAEpC,QAAO,aAAa,QAAQ;;;;;;;AAU9B,MAAa,YAAY;AA0BlB,IAAA,gBAAA,MAAM,cAGX;CACA;CAEA,YACE,SAGA;AACA,OAAK,UAAU,aAEb,QACD;;CAGH,IAAI,SAAoB;AACtB,SAAO,KAAK,QAAQ;;CAGtB,IAAI,WAAkC;AACpC,SAAO,KAAK,QAAQ;;CAGtB,IAAI,YAAqC;AACvC,SAAO,KAAK,QAAQ;;CAGtB,IAAI,QAAyB;AAC3B,SAAO,KAAK,QAAQ;;CAGtB,IAAI,SAAiC;AACnC,SAAO,KAAK,QAAQ;;CAGtB,IAAI,YAAkE;AACpE,SAAO,KAAK,QAAQ;;CAGtB,IAAI,aAAyD;AAC3D,SAAO,KAAK,QAAQ;;CAGtB,IAAI,YAA8D;AAChE,SAAO,KAAK,QAAQ;;CAGtB,IAAI,QAKD;AACD,SAAO,KAAK,QAAQ;;CAGtB,IAAI,YAAkE;AACpE,SAAO,KAAK,QAAQ;;CAGtB,IAAI,kBAA8D;AAChE,SAAO,KAAK,QAAQ;;CAGtB,IAAI,UAA2B;AAC7B,SAAO,KAAK,QAAQ;;CAGtB,IAAI,kBAAmC;AACrC,SAAO,KAAK,QAAQ;;CAGtB,IAAI,0BAA2C;AAC7C,SAAO,KAAK,QAAQ;;CAGtB,IAAI,SAAiB;AACnB,SAAO,KAAK,QAAQ;;CAGtB,IAAI,cAAsB;AACxB,SAAO,KAAK,QAAQ;;CAGtB,OACE,QACA,SAIwC;AACxC,SAAO,KAAK,QAAQ,OAAO,QAAQ,QAAQ;;CAG7C,MAAM,OAAsB;AAC1B,QAAM,KAAK,QAAQ,MAAM;;CAG3B,UAAU,OAAqB;AAC7B,OAAK,QAAQ,UAAU,MAAM;;CAG/B,aAAa,aAAkC;AAC7C,OAAK,QAAQ,aAAa,YAAY;;CAGxC,WACE,OACA,aACA,SAQe;AACf,SAAO,KAAK,QAAQ,WAAW,OAAO,aAAa,QAAQ;;CAG7D,oBACE,SACA,OAKY;AACZ,SAAO,KAAK,QAAQ,oBAAoB,SAAoB,MAAM;;CAGpE,aAAa,SAAgE;AAC3E,SAAO,KAAK,QAAQ,aAAa,QAAmB;;CAGtD,YAAY,YAAyD;AACnE,SAAO,KAAK,QAAQ,YAAY,WAAW;;CAG7C,mBAAmB,MAAyC;AAC1D,SAAO,KAAK,QAAQ,mBAAmB,KAAK;;CAG9C,sBAAsB,WAA8C;AAClE,SAAO,KAAK,QAAQ,sBAAsB,UAAU;;;4BApJvD,YAAY,CAAA,EAAA,cAAA"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@langchain/angular",
|
|
3
|
-
"version": "0.4.
|
|
3
|
+
"version": "0.4.2",
|
|
4
4
|
"description": "Angular integration for LangGraph & LangChain",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"license": "MIT",
|
|
@@ -10,7 +10,7 @@
|
|
|
10
10
|
"directory": "libs/sdk-angular"
|
|
11
11
|
},
|
|
12
12
|
"dependencies": {
|
|
13
|
-
"@langchain/langgraph-sdk": "^1.8.
|
|
13
|
+
"@langchain/langgraph-sdk": "^1.8.7"
|
|
14
14
|
},
|
|
15
15
|
"devDependencies": {
|
|
16
16
|
"@analogjs/vite-plugin-angular": "^2.4.0",
|