@langchain/angular 0.4.7 → 1.0.0

package/dist/index.d.cts

@@ -1,330 +1,12 @@
-import { injectStreamCustom, useStreamCustom } from "./stream.custom.cjs";
+import { AgentServerOptions, AnyStream, CustomAdapterOptions, STREAM_CONTROLLER, StateOf, StreamApi, ThreadStream, UseStreamOptions, UseStreamResult, UseStreamReturn, useStream } from "./use-stream.cjs";
+import { injectStream } from "./inject-stream.cjs";
+import { injectProjection } from "./inject-projection.cjs";
+import { SelectorTarget, injectAudio, injectChannel, injectExtension, injectFiles, injectImages, injectMessages, injectToolCalls, injectValues, injectVideo } from "./selectors.cjs";
+import { InjectSubmissionQueueReturn, SubmissionQueueEntry, SubmissionQueueSnapshot, injectSubmissionQueue } from "./selectors-queue.cjs";
+import { MessageMetadata, MessageMetadataMap, injectMessageMetadata } from "./selectors-metadata.cjs";
+import { injectMediaUrl } from "./inject-media-url.cjs";
 import { STREAM_DEFAULTS, STREAM_INSTANCE, StreamDefaults, provideStream, provideStreamDefaults } from "./context.cjs";
-import { useStreamLGP } from "./stream.lgp.cjs";
-import { Signal, WritableSignal } from "@angular/core";
-import { AIMessage, BaseMessage, ToolMessage } from "@langchain/core/messages";
-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";
-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";
-
-//#region src/index.d.ts
-type AngularWritableKeys = "isLoading" | "branch";
-type AngularPlainKeys = "submit" | "stop" | "joinStream" | "switchThread" | "setBranch" | "getMessagesMetadata" | "getToolCalls" | "getSubagent" | "getSubagentsByType" | "getSubagentsByMessage" | "client" | "assistantId";
-type AngularQueueInterface<T> = T extends {
-  entries: infer E;
-  size: infer S;
-  cancel: infer C;
-  clear: infer Cl;
-} ? {
-  entries: WritableSignal<E>;
-  size: WritableSignal<S>;
-  cancel: C;
-  clear: Cl;
-} : T;
-type AngularSignalWrap<T> = { [K in keyof T]: K extends AngularPlainKeys ? T[K] : K extends AngularWritableKeys ? WritableSignal<T[K]> : K extends "queue" ? AngularQueueInterface<T[K]> : Signal<T[K]> };
-/**
- * Injects the shared stream instance from the nearest ancestor that provided
- * one via {@link provideStream}. Throws if no ancestor provides a stream
- * instance.
- *
- * @example
- * ```typescript
- * import { Component } from "@angular/core";
- * import { injectStream } from "@langchain/angular";
- *
- * @Component({
- *   template: `
- *     @for (msg of stream.messages(); track msg.id) {
- *       <div>{{ msg.content }}</div>
- *     }
- *     <button
- *       [disabled]="stream.isLoading()"
- *       (click)="onSubmit()"
- *     >Send</button>
- *   `,
- * })
- * export class ChatComponent {
- *   stream = injectStream();
- *
- *   onSubmit() {
- *     void this.stream.submit({
- *       messages: [{ type: "human", content: "Hello!" }],
- *     });
- *   }
- * }
- * ```
- *
- * @example With type parameters for full type safety:
- * ```typescript
- * import type { agent } from "./agent";
- *
- * export class ChatComponent {
- *   stream = injectStream<typeof agent>();
- *   // stream.messages() returns typed messages
- * }
- * ```
- */
-declare function injectStream<T = Record<string, unknown>, Bag extends BagTemplate = BagTemplate>(): AngularSignalWrap<WithClassMessages<ResolveStreamInterface$1<T, InferBag$1<T, Bag>>>>;
-/**
- * Angular entry point for LangGraph streaming. Call from a component, directive,
- * or service field initializer to get a **Signals-based** stream controller
- * connected to the LangGraph Platform (HTTP + threads API).
- *
- * The returned object mirrors the shared `useStream` API from
- * `@langchain/langgraph-sdk/ui`, but reactive fields are
- * {@link https://angular.dev/guide/signals | Angular `Signal`s}:
- * read state with calls like `stream.messages()`, `stream.values()`, and
- * `stream.isLoading()`, and use `WritableSignal` setters where exposed (for
- * example `stream.branch` for branch selection).
- *
- * ## Typing with `createDeepAgent`
- *
- * Expect `export const agent = createDeepAgent({ ... })` from `deepagents`. In
- * UI code, `import { type agent } from "./agent"` (or `import type { agent }`)
- * is a **type-only** import: it is erased when compiling, so the agent module
- * does not run in the browser. You still pass **`typeof agent`** to
- * `injectStream`, not `agent` alone — `agent` is a value; TypeScript only
- * accepts it in a type position via `typeof` (otherwise: *refers to a value,
- * but is being used as a type*). If you prefer a named type in generics, add
- * `export type Agent = typeof agent` next to the const and use
- * `injectStream<Agent>(...)`.
- *
- * @example
- * ```typescript
- * // agent.ts
- * import { createDeepAgent } from "deepagents";
- * import { tool } from "langchain";
- * import { z } from "zod";
- *
- * const getWeather = tool(
- *   async ({ location }) => `Weather in ${location}`,
- *   { name: "get_weather", schema: z.object({ location: z.string() }) },
- * );
- *
- * export const agent = createDeepAgent({
- *   model: "openai:gpt-4o",
- *   tools: [getWeather],
- * });
- *
- * // chat.component.ts — type-only import; no agent runtime in the frontend
- * import { Component } from "@angular/core";
- * import { injectStream } from "@langchain/angular";
- * import { type agent } from "./agent";
- *
- * @Component({
- *   standalone: true,
- *   template: `
- *     @for (msg of stream.messages(); track msg.id ?? $index) {
- *       <p>{{ msg.content }}</p>
- *     }
- *   `,
- * })
- * export class ChatComponent {
- *   readonly stream = injectStream<typeof agent>({
- *     assistantId: "agent",
- *     apiUrl: "http://localhost:2024",
- *   });
- *   // stream.toolCalls()[0].call.name is typed as "get_weather"
- * }
- * ```
- *
- * ## Typing with `StateGraph` / custom graph state
- *
- * Use your graph state interface as `T` and embed tool call unions in
- * `Message<...>[]` when you need discriminated tool types.
- *
- * @example
- * ```typescript
- * import { Message } from "@langchain/langgraph-sdk";
- * import { Component } from "@angular/core";
- * import { injectStream } from "@langchain/angular";
- *
- * type MyToolCalls =
- *   | { name: "search"; args: { query: string }; id?: string }
- *   | { name: "calculate"; args: { expression: string }; id?: string };
- *
- * interface MyGraphState {
- *   messages: Message<MyToolCalls>[];
- *   context?: string;
- * }
- *
- * @Component({ standalone: true, template: "" })
- * export class ChatComponent {
- *   readonly stream = injectStream<MyGraphState>({
- *     assistantId: "my-graph",
- *     apiUrl: "http://localhost:2024",
- *   });
- *   // stream.values() is typed as MyGraphState | null
- * }
- * ```
- *
- * @example
- * ```typescript
- * // Optional bag for interrupts, configurable, custom events, and updates
- * import { Component } from "@angular/core";
- * import { injectStream } from "@langchain/angular";
- * import type { Message } from "@langchain/langgraph-sdk";
- *
- * interface MyGraphState {
- *   messages: Message[];
- * }
- *
- * @Component({ standalone: true, template: "" })
- * export class ChatComponent {
- *   readonly stream = injectStream<
- *     MyGraphState,
- *     {
- *       InterruptType: { question: string };
- *       ConfigurableType: { userId: string };
- *     }
- *   >({
- *     assistantId: "my-graph",
- *     apiUrl: "http://localhost:2024",
- *   });
- *   // stream.interrupt() is typed as { question: string } | undefined
- * }
- * ```
- *
- * ## Subagent streaming
- *
- * For `createDeepAgent` agents with `subagents`, set `filterSubagentMessages`
- * and use `streamSubgraphs` on `submit` to populate `stream.subagents` and
- * related helpers.
- *
- * @example
- * ```typescript
- * import { Component } from "@angular/core";
- * import { injectStream } from "@langchain/angular";
- * import { type agent } from "./agent";
- *
- * @Component({ standalone: true, template: "" })
- * export class DeepAgentChatComponent {
- *   readonly stream = injectStream<typeof agent>({
- *     assistantId: "deepagent",
- *     apiUrl: "http://localhost:2024",
- *     filterSubagentMessages: true,
- *   });
- *
- *   send(content: string) {
- *     void this.stream.submit(
- *       { messages: [{ content, type: "human" }] },
- *       { streamSubgraphs: true },
- *     );
- *   }
- * }
- * ```
- *
- * @param options - LangGraph Platform client options (`apiUrl` or `client`),
- *   `assistantId`, stream modes, history, reconnect, subagent settings, etc.
- *
- * @returns A stream controller backed by Signals: graph values, messages,
- *   loading and error state, interrupts, tool calls, branching, queue, and
- *   `submit` / `stop` / `switchThread` helpers (writable where the UI layer
- *   requires mutation).
- *
- * @template T Agent type (with `~agentTypes`) from `createDeepAgent` or
- *   `createAgent`, or a state shape extending `Record<string, unknown>`.
- * @template Bag Optional configuration bag:
- *   - `ConfigurableType` — `config.configurable` typing
- *   - `InterruptType` — human-in-the-loop interrupt payloads
- *   - `CustomEventType` — custom stream events
- *   - `UpdateType` — payload typing for `submit`
- *
- * @see {@link https://docs.langchain.com/oss/javascript/langgraph/overview | LangGraph JavaScript overview}
- * @see {@link https://docs.langchain.com/oss/javascript/langchain/overview | LangChain JavaScript overview}
- * @see {@link https://docs.langchain.com/oss/javascript/deepagents/overview | Deep Agents JavaScript overview}
- */
-declare function injectStream<T = Record<string, unknown>, Bag extends BagTemplate = BagTemplate>(options: ResolveStreamOptions$1<T, InferBag$1<T, Bag>>): AngularSignalWrap<WithClassMessages<ResolveStreamInterface$1<T, InferBag$1<T, Bag>>>>;
-/**
- * Overload for a **custom transport** (`options.transport`), for example
- * {@link FetchStreamTransport} or any implementation compatible with
- * {@link injectStreamCustom}. Prefer {@link injectStreamCustom} directly when
- * you only use custom transports and want a narrower import.
- *
- * @param options - Custom transport and stream options (must include
- *   `transport`).
- *
- * @returns The same Signals-based controller shape as the LangGraph Platform
- *   overload.
- *
- * @template T Agent type or state shape, matching the custom transport.
- * @template Bag Same optional bag as the platform overload.
- *
- * @see {@link injectStreamCustom}
- */
-declare function injectStream<T = Record<string, unknown>, Bag extends BagTemplate = BagTemplate>(options: UseStreamCustomOptions$1<InferStateType$1<T>, InferBag$1<T, Bag>>): AngularSignalWrap<WithClassMessages<ResolveStreamInterface$1<T, InferBag$1<T, Bag>>>>;
-/**
- * @deprecated Use `injectStream` instead. `useStream` will be removed in a
- * future major version. `injectStream` follows Angular's `inject*` naming
- * convention for injection-based patterns.
- */
-declare const useStream: typeof injectStream;
-/**
- * Injectable Angular service that wraps {@link injectStream}.
- *
- * Extend this class with your own `@Injectable()` service and call
- * `super(options)` in the constructor:
- *
- * ```ts
- * \@Injectable({ providedIn: 'root' })
- * export class ChatService extends StreamService {
- *   constructor() {
- *     super({ assistantId: 'agent', apiUrl: '...' });
- *   }
- * }
- * ```
- *
- * The service exposes the same signals and methods as `injectStream`
- * (e.g. `values`, `messages`, `isLoading`, `submit`, `stop`).
- *
- * Must be created within an Angular injection context (via DI or
- * `runInInjectionContext`).
- */
-declare class StreamService<T = Record<string, unknown>, Bag extends BagTemplate = BagTemplate> {
-  private readonly _stream;
-  constructor(options: ResolveStreamOptions$1<T, InferBag$1<T, Bag>> | UseStreamCustomOptions$1<InferStateType$1<T>, InferBag$1<T, Bag>>);
-  get values(): Signal<T>;
-  get messages(): Signal<BaseMessage[]>;
-  get isLoading(): WritableSignal<boolean>;
-  get error(): Signal<unknown>;
-  get branch(): WritableSignal<string>;
-  get interrupt(): Signal<Interrupt<GetInterruptType<Bag>> | undefined>;
-  get interrupts(): Signal<Interrupt<GetInterruptType<Bag>>[]>;
-  get toolCalls(): Signal<ToolCallWithResult$1<DefaultToolCall$1>[]>;
-  get queue(): AngularQueueInterface<{
-    entries: readonly {
-      id: string;
-      values: Partial<T> | null | undefined;
-    }[];
-    size: number;
-    cancel: (id: string) => Promise<boolean>;
-    clear: () => Promise<void>;
-  }>;
-  get subagents(): Signal<ReadonlyMap<string, SubagentStreamInterface$1>>;
-  get activeSubagents(): Signal<readonly SubagentStreamInterface$1[]>;
-  get history(): Signal<unknown>;
-  get isThreadLoading(): Signal<boolean>;
-  get experimental_branchTree(): Signal<unknown>;
-  get client(): Client;
-  get assistantId(): string;
-  submit(values: AcceptBaseMessages<Exclude<T, null | undefined>> | null | undefined, options?: SubmitOptions<T extends Record<string, unknown> ? T : Record<string, unknown>, GetConfigurableType<Bag>>): ReturnType<typeof this._stream.submit>;
-  stop(): Promise<void>;
-  setBranch(value: string): void;
-  switchThread(newThreadId: string | null): void;
-  joinStream(runId: string, lastEventId?: string, options?: {
-    streamMode?: StreamMode | StreamMode[];
-    filter?: (event: {
-      id?: string;
-      event: StreamEvent;
-      data: unknown;
-    }) => boolean;
-  }): Promise<void>;
-  getMessagesMetadata(message: BaseMessage, index?: number): MessageMetadata$1<T extends Record<string, unknown> ? T : Record<string, unknown>> | undefined;
-  getToolCalls(message: BaseMessage): ToolCallWithResult$1<DefaultToolCall$1>[];
-  getSubagent(toolCallId: string): SubagentStreamInterface$1 | undefined;
-  getSubagentsByType(type: string): SubagentStreamInterface$1[];
-  getSubagentsByMessage(messageId: string): SubagentStreamInterface$1[];
-}
-type ToolCallWithResult<ToolCall = DefaultToolCall$1> = ToolCallWithResult$1<ToolCall, ToolMessage, AIMessage>;
-//#endregion
-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 };
-//# sourceMappingURL=index.d.cts.map
+import { StreamService } from "./stream-service.cjs";
+import { AgentServerAdapter, AnyMediaHandle, AssembledToolCall, AudioMedia, Channel, Event, FileMedia, ImageMedia, InferStateType, InferSubagentStates, InferToolCalls, MediaAssemblyError, MediaAssemblyErrorKind, MediaBase, MediaBlockType, StreamSubmitOptions, SubagentDiscoverySnapshot, SubgraphDiscoverySnapshot, ToolCallStatus, VideoMedia, WidenUpdateMessages } from "@langchain/langgraph-sdk/stream";
+import { AnyHeadlessToolImplementation, DefaultToolCall, FlushPendingHeadlessToolInterruptsOptions, HeadlessToolImplementation, HeadlessToolInterrupt, HttpAgentServerAdapter, HttpAgentServerAdapterOptions, OnToolCallback, ToolCallFromTool, ToolCallState, ToolCallsFromTools, ToolEvent, executeHeadlessTool, filterOutHeadlessToolInterrupts, findHeadlessTool, flushPendingHeadlessToolInterrupts, handleHeadlessToolInterrupt, headlessToolResumeCommand, isHeadlessToolInterrupt, parseHeadlessToolInterruptPayload } from "@langchain/langgraph-sdk";
+export { type AgentServerAdapter, type AgentServerOptions, type AnyHeadlessToolImplementation, type AnyMediaHandle, type AnyStream, type AssembledToolCall, type AudioMedia, type Channel, type CustomAdapterOptions, type DefaultToolCall, type Event, type FileMedia, type FlushPendingHeadlessToolInterruptsOptions, type HeadlessToolImplementation, type HeadlessToolInterrupt, HttpAgentServerAdapter, type HttpAgentServerAdapterOptions, type ImageMedia, type InferStateType, type InferSubagentStates, type InferToolCalls, type InjectSubmissionQueueReturn, MediaAssemblyError, type MediaAssemblyErrorKind, type MediaBase, type MediaBlockType, type MessageMetadata, type MessageMetadataMap, type OnToolCallback, STREAM_CONTROLLER, STREAM_DEFAULTS, STREAM_INSTANCE, type SelectorTarget, type StateOf, type StreamApi, type StreamDefaults, StreamService, type StreamSubmitOptions, type SubagentDiscoverySnapshot, type SubgraphDiscoverySnapshot, type SubmissionQueueEntry, type SubmissionQueueSnapshot, type ThreadStream, type ToolCallFromTool, type ToolCallState, type ToolCallStatus, type ToolCallsFromTools, type ToolEvent, type UseStreamOptions, type UseStreamResult, type UseStreamReturn, type VideoMedia, type WidenUpdateMessages, executeHeadlessTool, filterOutHeadlessToolInterrupts, findHeadlessTool, flushPendingHeadlessToolInterrupts, handleHeadlessToolInterrupt, headlessToolResumeCommand, injectAudio, injectChannel, injectExtension, injectFiles, injectImages, injectMediaUrl, injectMessageMetadata, injectMessages, injectProjection, injectStream, injectSubmissionQueue, injectToolCalls, injectValues, injectVideo, isHeadlessToolInterrupt, parseHeadlessToolInterruptPayload, provideStream, provideStreamDefaults, useStream };