@langchain/langgraph-sdk 1.9.3 → 1.9.5

package/dist/stream/types-inference.d.cts

@@ -1,9 +1,63 @@
-import { DefaultToolCall, ToolCallFromTool } from "../types.messages.cjs";
+import { DefaultToolCall, InferToolOutput, ToolCallFromTool } from "../types.messages.cjs";
+import { AssembledToolCall } from "../client/stream/handles/tools.cjs";
 import { AgentTypeConfigLike, CompiledSubAgentLike, DeepAgentTypeConfigLike, DefaultSubagentStates, ExtractAgentConfig, ExtractDeepAgentConfig, ExtractSubAgentMiddleware, InferAgentToolCalls, InferDeepAgentSubagents, InferSubagentByName, InferSubagentNames, InferSubagentState, IsAgentLike, IsDeepAgentLike, SubAgentLike, SubagentStateMap, SubagentToolCall } from "../ui/types.cjs";
 import { InferBag, InferNodeNames, InferStateType as InferStateType$1, InferSubagentStates as InferSubagentStates$1, InferToolCalls as InferToolCalls$1 } from "../ui/stream/index.cjs";
 import { BaseMessage } from "@langchain/core/messages";
 
 //#region src/stream/types-inference.d.ts
+/** @internal Map a {@link ToolCallFromTool} message shape to {@link AssembledToolCall}. */
+type AssembledToolCallFromToolCall<TCall extends {
+  name: string;
+  args: Record<string, unknown>;
+}, TOutput = unknown> = TCall extends {
+  name: infer N;
+  args: infer A;
+} ? N extends string ? A extends Record<string, any> ? AssembledToolCall<N, A, TOutput> : never : never : never;
+/**
+ * Infer the streaming {@link AssembledToolCall} handle for a single
+ * LangChain tool.
+ *
+ * Parallel to {@link ToolCallFromTool} for message-level tool calls —
+ * use this when a component receives one entry from `stream.toolCalls`
+ * and you know which tool definition it came from.
+ *
+ * @example
+ * ```ts
+ * const searchWeb = tool(/* ... *\/);
+ *
+ * function SearchWebCall({ toolCall }: {
+ *   toolCall: AssembledToolCallFromTool<typeof searchWeb>;
+ * }) {
+ *   // toolCall.name is "search_web", args/input are schema-inferred
+ * }
+ *
+ * v1 framework packages (`@langchain/react`, `@langchain/vue`, etc.) re-export
+ * this type as {@link ToolCallFromTool}. {@link AssembledToolCall.output} is
+ * `null` until the call succeeds; use {@link status} / {@link error} for UI.
+ * ```
+ */
+type AssembledToolCallFromTool<T> = AssembledToolCallFromToolCall<ToolCallFromTool<T>, InferToolOutput<T>>;
+/** @internal Resolve a tool definition's registered name. */
+type ToolNameOf<T> = T extends {
+  name: infer N extends string;
+} ? N : T extends {
+  tool: {
+    name: infer N extends string;
+  };
+} ? N : never;
+/** @internal Look up the return type of a tool in a tuple by its `name`. */
+type MatchedToolOutput<Tools extends readonly unknown[], N extends string> = Tools extends readonly [infer First, ...infer Rest] ? ToolNameOf<First> extends N ? InferToolOutput<First> : MatchedToolOutput<Rest, N> : unknown;
+/**
+ * @internal Bridge a message-level tool-call shape from {@link InferToolCallsFromUi}
+ * to a streaming {@link AssembledToolCall}, resolving `output` from the agent's
+ * declared tool list.
+ */
+type AssembledFromMessageToolCall<TC extends {
+  name: string;
+  args: Record<string, unknown>;
+}, Tools extends readonly unknown[]> = TC extends {
+  name: infer N;
+} ? N extends string ? AssembledToolCallFromToolCall<TC, MatchedToolOutput<Tools, N>> : AssembledToolCall : AssembledToolCall;
 /**
  * Unwrap the state shape from a compiled graph, a create-agent brand,
  * or a plain type. Used by `useStream<T>()` to resolve `T = typeof
@@ -16,13 +70,17 @@ import { BaseMessage } from "@langchain/core/messages";
  */
 type InferStateType<T> = InferStateType$1<T>;
 /**
- * Infer the discriminated union of tool call shapes from an input that
- * may be an agent brand, an array of LangGraph tools, or a direct
- * `DefaultToolCall` shape.
+ * Infer the discriminated union of {@link AssembledToolCall} handles
+ * from an agent brand, an array of LangChain tools, or fall back to the
+ * untyped default handle.
  *
- * See {@link InferToolCallsFromUi} for the full resolution table.
+ * Pass `typeof agent` or `typeof tools` and narrow on `name` / `args`
+ * (aliases for `input`) in tool-call UI components.
  */
-type InferToolCalls<T> = T extends readonly unknown[] ? ToolCallFromTool<T[number]> : InferToolCalls$1<T>;
+type InferToolCalls<T> = T extends readonly unknown[] ? AssembledToolCallFromTool<T[number]> : ExtractAgentConfig<T>["Tools"] extends infer Tools extends readonly unknown[] ? InferToolCalls$1<T> extends infer TC ? TC extends {
+  name: string;
+  args: Record<string, unknown>;
+} ? AssembledFromMessageToolCall<TC, Tools> : AssembledToolCall : AssembledToolCall : AssembledToolCall;
 /**
  * Infer the subagent → state map from a DeepAgent brand. Non-brands
  * collapse to {@link DefaultSubagentStates}.
@@ -39,5 +97,5 @@ type InferSubagentStates<T> = InferSubagentStates$1<T>;
  */
 type WidenUpdateMessages<T> = T extends Record<string, unknown> ? { [K in keyof T]: K extends "messages" ? T[K] | BaseMessage | BaseMessage[] : T[K] } : T;
 //#endregion
-export { InferStateType, InferSubagentStates, InferToolCalls, WidenUpdateMessages };
+export { AssembledToolCallFromTool, InferStateType, InferSubagentStates, InferToolCalls, WidenUpdateMessages };
 //# sourceMappingURL=types-inference.d.cts.map

package/dist/stream/types-inference.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"types-inference.d.cts","names":[],"sources":["../../src/stream/types-inference.ts"],"mappings":";;;;;;AA2DA;;;;;;;;;;AAAA,KATY,cAAA,MAAoB,gBAAA,CAAqB,CAAA;;;;;;;;KASzC,cAAA,MAEV,CAAA,8BACI,gBAAA,CAAiB,CAAA,YACjB,gBAAA,CAAqB,CAAA;;;;;KAMf,mBAAA,MAAyB,qBAAA,CAA0B,CAAA;;;;AAW/D;;;;;;KAAY,mBAAA,MACV,CAAA,SAAU,MAAA,kCAEQ,CAAA,GAAI,CAAA,sBACZ,CAAA,CAAE,CAAA,IAAK,WAAA,GAAc,WAAA,KACrB,CAAA,CAAE,CAAA,MAER,CAAA"}
+{"version":3,"file":"types-inference.d.cts","names":[],"sources":["../../src/stream/types-inference.ts"],"mappings":";;;;;;;;KA8CK,6BAAA;EACa,IAAA;EAAc,IAAA,EAAM,MAAA;AAAA,wBAElC,KAAA;EAAgB,IAAA;EAAe,IAAA;AAAA,IAC/B,CAAA,kBAEE,CAAA,SAAU,MAAA,gBACR,iBAAA,CAAkB,CAAA,EAAG,CAAA,EAAG,OAAA;;;;;;;;;;;;;;;AA4BhC;;;;;;;;;KAAY,yBAAA,MAA+B,6BAAA,CACzC,gBAAA,CAAiB,CAAA,GACjB,eAAA,CAAgB,CAAA;;KAIb,UAAA,MAAgB,CAAA;EAAY,IAAA;AAAA,IAC7B,CAAA,GACA,CAAA;EAAY,IAAA;IAAQ,IAAA;EAAA;AAAA,IAClB,CAAA;AANJ;AAAA,KAUG,iBAAA,uDAGD,KAAA,iDACA,UAAA,CAAW,KAAA,UAAe,CAAA,GACxB,eAAA,CAAgB,KAAA,IAChB,iBAAA,CAAkB,IAAA,EAAM,CAAA;;;;;;KAQzB,4BAAA;EACU,IAAA;EAAc,IAAA,EAAM,MAAA;AAAA,uCAE/B,EAAA;EAAa,IAAA;AAAA,IACb,CAAA,kBACE,6BAAA,CAA8B,EAAA,EAAI,iBAAA,CAAkB,KAAA,EAAO,CAAA,KAC3D,iBAAA,GACF,iBAAA;;;;AAzBG;;;;;;;KAqCK,cAAA,MAAoB,gBAAA,CAAqB,CAAA;;;;;;;;;KAUzC,cAAA,MAAoB,CAAA,8BAC5B,yBAAA,CAA0B,CAAA,YAC1B,kBAAA,CAAmB,CAAA,4DAEjB,gBAAA,CAAqB,CAAA,qBACnB,EAAA;EAAa,IAAA;EAAc,IAAA,EAAM,MAAA;AAAA,IAC/B,4BAAA,CAA6B,EAAA,EAAI,KAAA,IACjC,iBAAA,GACF,iBAAA,GACF,iBAAA;;;;;KAMM,mBAAA,MAAyB,qBAAA,CAA0B,CAAA;;;;;AApDhC;;;;;KA+DnB,mBAAA,MACV,CAAA,SAAU,MAAA,kCAEQ,CAAA,GAAI,CAAA,sBACZ,CAAA,CAAE,CAAA,IAAK,WAAA,GAAc,WAAA,KACrB,CAAA,CAAE,CAAA,MAER,CAAA"}

package/dist/stream/types-inference.d.ts

@@ -1,9 +1,63 @@
-import { DefaultToolCall, ToolCallFromTool } from "../types.messages.js";
+import { DefaultToolCall, InferToolOutput, ToolCallFromTool } from "../types.messages.js";
+import { AssembledToolCall } from "../client/stream/handles/tools.js";
 import { AgentTypeConfigLike, CompiledSubAgentLike, DeepAgentTypeConfigLike, DefaultSubagentStates, ExtractAgentConfig, ExtractDeepAgentConfig, ExtractSubAgentMiddleware, InferAgentToolCalls, InferDeepAgentSubagents, InferSubagentByName, InferSubagentNames, InferSubagentState, IsAgentLike, IsDeepAgentLike, SubAgentLike, SubagentStateMap, SubagentToolCall } from "../ui/types.js";
 import { InferBag, InferNodeNames, InferStateType as InferStateType$1, InferSubagentStates as InferSubagentStates$1, InferToolCalls as InferToolCalls$1 } from "../ui/stream/index.js";
 import { BaseMessage } from "@langchain/core/messages";
 
 //#region src/stream/types-inference.d.ts
+/** @internal Map a {@link ToolCallFromTool} message shape to {@link AssembledToolCall}. */
+type AssembledToolCallFromToolCall<TCall extends {
+  name: string;
+  args: Record<string, unknown>;
+}, TOutput = unknown> = TCall extends {
+  name: infer N;
+  args: infer A;
+} ? N extends string ? A extends Record<string, any> ? AssembledToolCall<N, A, TOutput> : never : never : never;
+/**
+ * Infer the streaming {@link AssembledToolCall} handle for a single
+ * LangChain tool.
+ *
+ * Parallel to {@link ToolCallFromTool} for message-level tool calls —
+ * use this when a component receives one entry from `stream.toolCalls`
+ * and you know which tool definition it came from.
+ *
+ * @example
+ * ```ts
+ * const searchWeb = tool(/* ... *\/);
+ *
+ * function SearchWebCall({ toolCall }: {
+ *   toolCall: AssembledToolCallFromTool<typeof searchWeb>;
+ * }) {
+ *   // toolCall.name is "search_web", args/input are schema-inferred
+ * }
+ *
+ * v1 framework packages (`@langchain/react`, `@langchain/vue`, etc.) re-export
+ * this type as {@link ToolCallFromTool}. {@link AssembledToolCall.output} is
+ * `null` until the call succeeds; use {@link status} / {@link error} for UI.
+ * ```
+ */
+type AssembledToolCallFromTool<T> = AssembledToolCallFromToolCall<ToolCallFromTool<T>, InferToolOutput<T>>;
+/** @internal Resolve a tool definition's registered name. */
+type ToolNameOf<T> = T extends {
+  name: infer N extends string;
+} ? N : T extends {
+  tool: {
+    name: infer N extends string;
+  };
+} ? N : never;
+/** @internal Look up the return type of a tool in a tuple by its `name`. */
+type MatchedToolOutput<Tools extends readonly unknown[], N extends string> = Tools extends readonly [infer First, ...infer Rest] ? ToolNameOf<First> extends N ? InferToolOutput<First> : MatchedToolOutput<Rest, N> : unknown;
+/**
+ * @internal Bridge a message-level tool-call shape from {@link InferToolCallsFromUi}
+ * to a streaming {@link AssembledToolCall}, resolving `output` from the agent's
+ * declared tool list.
+ */
+type AssembledFromMessageToolCall<TC extends {
+  name: string;
+  args: Record<string, unknown>;
+}, Tools extends readonly unknown[]> = TC extends {
+  name: infer N;
+} ? N extends string ? AssembledToolCallFromToolCall<TC, MatchedToolOutput<Tools, N>> : AssembledToolCall : AssembledToolCall;
 /**
  * Unwrap the state shape from a compiled graph, a create-agent brand,
  * or a plain type. Used by `useStream<T>()` to resolve `T = typeof
@@ -16,13 +70,17 @@ import { BaseMessage } from "@langchain/core/messages";
  */
 type InferStateType<T> = InferStateType$1<T>;
 /**
- * Infer the discriminated union of tool call shapes from an input that
- * may be an agent brand, an array of LangGraph tools, or a direct
- * `DefaultToolCall` shape.
+ * Infer the discriminated union of {@link AssembledToolCall} handles
+ * from an agent brand, an array of LangChain tools, or fall back to the
+ * untyped default handle.
  *
- * See {@link InferToolCallsFromUi} for the full resolution table.
+ * Pass `typeof agent` or `typeof tools` and narrow on `name` / `args`
+ * (aliases for `input`) in tool-call UI components.
  */
-type InferToolCalls<T> = T extends readonly unknown[] ? ToolCallFromTool<T[number]> : InferToolCalls$1<T>;
+type InferToolCalls<T> = T extends readonly unknown[] ? AssembledToolCallFromTool<T[number]> : ExtractAgentConfig<T>["Tools"] extends infer Tools extends readonly unknown[] ? InferToolCalls$1<T> extends infer TC ? TC extends {
+  name: string;
+  args: Record<string, unknown>;
+} ? AssembledFromMessageToolCall<TC, Tools> : AssembledToolCall : AssembledToolCall : AssembledToolCall;
 /**
  * Infer the subagent → state map from a DeepAgent brand. Non-brands
  * collapse to {@link DefaultSubagentStates}.
@@ -39,5 +97,5 @@ type InferSubagentStates<T> = InferSubagentStates$1<T>;
  */
 type WidenUpdateMessages<T> = T extends Record<string, unknown> ? { [K in keyof T]: K extends "messages" ? T[K] | BaseMessage | BaseMessage[] : T[K] } : T;
 //#endregion
-export { InferStateType, InferSubagentStates, InferToolCalls, WidenUpdateMessages };
+export { AssembledToolCallFromTool, InferStateType, InferSubagentStates, InferToolCalls, WidenUpdateMessages };
 //# sourceMappingURL=types-inference.d.ts.map

package/dist/stream/types-inference.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types-inference.d.ts","names":[],"sources":["../../src/stream/types-inference.ts"],"mappings":";;;;;;AA2DA;;;;;;;;;;AAAA,KATY,cAAA,MAAoB,gBAAA,CAAqB,CAAA;;;;;;;;KASzC,cAAA,MAEV,CAAA,8BACI,gBAAA,CAAiB,CAAA,YACjB,gBAAA,CAAqB,CAAA;;;;;KAMf,mBAAA,MAAyB,qBAAA,CAA0B,CAAA;;;;AAW/D;;;;;;KAAY,mBAAA,MACV,CAAA,SAAU,MAAA,kCAEQ,CAAA,GAAI,CAAA,sBACZ,CAAA,CAAE,CAAA,IAAK,WAAA,GAAc,WAAA,KACrB,CAAA,CAAE,CAAA,MAER,CAAA"}
+{"version":3,"file":"types-inference.d.ts","names":[],"sources":["../../src/stream/types-inference.ts"],"mappings":";;;;;;;;KA8CK,6BAAA;EACa,IAAA;EAAc,IAAA,EAAM,MAAA;AAAA,wBAElC,KAAA;EAAgB,IAAA;EAAe,IAAA;AAAA,IAC/B,CAAA,kBAEE,CAAA,SAAU,MAAA,gBACR,iBAAA,CAAkB,CAAA,EAAG,CAAA,EAAG,OAAA;;;;;;;;;;;;;;;AA4BhC;;;;;;;;;KAAY,yBAAA,MAA+B,6BAAA,CACzC,gBAAA,CAAiB,CAAA,GACjB,eAAA,CAAgB,CAAA;;KAIb,UAAA,MAAgB,CAAA;EAAY,IAAA;AAAA,IAC7B,CAAA,GACA,CAAA;EAAY,IAAA;IAAQ,IAAA;EAAA;AAAA,IAClB,CAAA;AANJ;AAAA,KAUG,iBAAA,uDAGD,KAAA,iDACA,UAAA,CAAW,KAAA,UAAe,CAAA,GACxB,eAAA,CAAgB,KAAA,IAChB,iBAAA,CAAkB,IAAA,EAAM,CAAA;;;;;;KAQzB,4BAAA;EACU,IAAA;EAAc,IAAA,EAAM,MAAA;AAAA,uCAE/B,EAAA;EAAa,IAAA;AAAA,IACb,CAAA,kBACE,6BAAA,CAA8B,EAAA,EAAI,iBAAA,CAAkB,KAAA,EAAO,CAAA,KAC3D,iBAAA,GACF,iBAAA;;;;AAzBG;;;;;;;KAqCK,cAAA,MAAoB,gBAAA,CAAqB,CAAA;;;;;;;;;KAUzC,cAAA,MAAoB,CAAA,8BAC5B,yBAAA,CAA0B,CAAA,YAC1B,kBAAA,CAAmB,CAAA,4DAEjB,gBAAA,CAAqB,CAAA,qBACnB,EAAA;EAAa,IAAA;EAAc,IAAA,EAAM,MAAA;AAAA,IAC/B,4BAAA,CAA6B,EAAA,EAAI,KAAA,IACjC,iBAAA,GACF,iBAAA,GACF,iBAAA;;;;;KAMM,mBAAA,MAAyB,qBAAA,CAA0B,CAAA;;;;;AApDhC;;;;;KA+DnB,mBAAA,MACV,CAAA,SAAU,MAAA,kCAEQ,CAAA,GAAI,CAAA,sBACZ,CAAA,CAAE,CAAA,IAAK,WAAA,GAAc,WAAA,KACrB,CAAA,CAAE,CAAA,MAER,CAAA"}

package/dist/stream/types.d.cts

@@ -6,27 +6,40 @@ import { ThreadStreamOptions } from "../client/stream/types.cjs";
 import { ThreadStream } from "../client/stream/index.cjs";
 import { Client } from "../client/index.cjs";
 import { AnyHeadlessToolImplementation, OnToolCallback } from "../headless-tools.cjs";
-import { InferStateType } from "./types-inference.cjs";
 import { StreamStore } from "./store.cjs";
 import { Channel, Event as Event$1 } from "@langchain/protocol";
 import { BaseMessage as BaseMessage$1 } from "@langchain/core/messages";
 
 //#region src/stream/types.d.ts
-/**
- * Legacy alias shared by the framework bindings.
- * Unwraps a compiled graph or agent brand into its state shape.
- *
- * @deprecated Prefer {@link InferStateType}.
- */
-type StateOf<T> = InferStateType<T> extends Record<string, unknown> ? InferStateType<T> : Record<string, unknown>;
+/** Why a run's active streaming phase ended. */
+type RunExecutionReason = /** The run reached the protocol `completed` lifecycle event. */"success" /** The run reached the protocol `failed` lifecycle event. */ | "error" /** The run paused on a protocol `interrupted` lifecycle event. */ | "interrupt" /** The run was stopped by a client-side abort. */ | "stopped";
+/** Payload for run-start callbacks. */
+interface RunExecutionInfo {
+  runId: string;
+}
+/** Payload for run-end callbacks. */
+interface RunCompletedInfo extends Omit<RunExecutionInfo, "runId"> {
+  /** Omitted when re-attaching to an in-flight run without local dispatch. */
+  runId?: string;
+  /** Why the active streaming phase ended. */
+  reason: RunExecutionReason;
+}
 /** Options common to both transport branches of framework `useStream` APIs. */
 interface UseStreamCommonOptions<StateType extends object, ThreadIdType = string | null> {
   threadId?: ThreadIdType;
   onThreadId?: (threadId: string) => void;
-  onCreated?: (meta: {
-    run_id: string;
-    thread_id: string;
-  }) => void;
+  /**
+   * Convenience callback fired when this hook instance's run is accepted
+   * by the server. Prefer `stream.isLoading` for UI; use this for
+   * imperative run-execution side effects.
+   */
+  onCreated?: (info: RunExecutionInfo) => void;
+  /**
+   * Convenience callback fired when a run's active streaming phase ends.
+   * `runId` may be omitted for re-attached in-flight runs because no local
+   * dispatch response was observed.
+   */
+  onCompleted?: (info: RunCompletedInfo) => void;
   initialValues?: StateType;
   /** State key holding the message array. Defaults to `"messages"`. */
   messagesKey?: string;
@@ -138,9 +151,8 @@ interface StreamControllerOptions<StateType extends object = Record<string, unkn
   /**
    * How the controller talks to the agent server. Accepts either a
    * built-in transport string (`"sse"` / `"websocket"`) or a custom
-   * {@link import("../client/stream/transport.js").AgentServerAdapter}
-   * that bypasses the built-in factories entirely. Forwarded to
-   * `client.threads.stream({ transport })`.
+   * {@link AgentServerAdapter} that bypasses the built-in factories
+   * entirely. Forwarded to `client.threads.stream({ transport })`.
    */
   transport?: ThreadStreamOptions["transport"];
   /** Optional `fetch` override forwarded to the built-in SSE transport. */
@@ -149,11 +161,18 @@ interface StreamControllerOptions<StateType extends object = Record<string, unkn
   webSocketFactory?: (url: string) => WebSocket;
   /** Called when a thread id is first produced (new-thread submits). */
   onThreadId?: (threadId: string) => void;
-  /** Called when a run starts (mirrors v1 `onCreated`). */
-  onCreated?: (meta: {
-    run_id: string;
-    thread_id: string;
-  }) => void;
+  /**
+   * Convenience callback fired when this hook instance's run is accepted
+   * by the server. Prefer `root.isLoading` for UI; use this for
+   * imperative run-execution side effects.
+   */
+  onCreated?: (info: RunExecutionInfo) => void;
+  /**
+   * Convenience callback fired when a run's active streaming phase ends.
+   * `runId` may be omitted for re-attached in-flight runs because no local
+   * dispatch response was observed.
+   */
+  onCompleted?: (info: RunCompletedInfo) => void;
   /** Initial state for `root.values` before hydration lands. */
   initialValues?: StateType;
   /** Key inside `values` that holds the message array. Defaults to `"messages"`. */
@@ -350,5 +369,5 @@ interface AcquiredProjection<T> {
   release(): void;
 }
 //#endregion
-export { AcquiredProjection, AgentServerOptions, CustomAdapterOptions, ProjectionRuntime, ProjectionSpec, RootEventBus, RootSnapshot, StateOf, StreamControllerOptions, StreamSubmitOptions, SubagentDiscoverySnapshot, SubgraphDiscoverySnapshot, Target, UseStreamCommonOptions, UseStreamOptions };
+export { AcquiredProjection, AgentServerOptions, CustomAdapterOptions, ProjectionRuntime, ProjectionSpec, RootEventBus, RootSnapshot, RunCompletedInfo, RunExecutionInfo, RunExecutionReason, StreamControllerOptions, StreamSubmitOptions, SubagentDiscoverySnapshot, SubgraphDiscoverySnapshot, Target, UseStreamCommonOptions, UseStreamOptions };
 //# sourceMappingURL=types.d.cts.map

package/dist/stream/types.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.cts","names":[],"sources":["../../src/stream/types.ts"],"mappings":"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"}
+{"version":3,"file":"types.d.cts","names":[],"sources":["../../src/stream/types.ts"],"mappings":"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"}

package/dist/stream/types.d.ts

@@ -6,27 +6,40 @@ import { ThreadStreamOptions } from "../client/stream/types.js";
 import { ThreadStream } from "../client/stream/index.js";
 import { Client } from "../client/index.js";
 import { AnyHeadlessToolImplementation, OnToolCallback } from "../headless-tools.js";
-import { InferStateType } from "./types-inference.js";
 import { StreamStore } from "./store.js";
 import { BaseMessage as BaseMessage$1 } from "@langchain/core/messages";
 import { Channel, Event as Event$1 } from "@langchain/protocol";
 
 //#region src/stream/types.d.ts
-/**
- * Legacy alias shared by the framework bindings.
- * Unwraps a compiled graph or agent brand into its state shape.
- *
- * @deprecated Prefer {@link InferStateType}.
- */
-type StateOf<T> = InferStateType<T> extends Record<string, unknown> ? InferStateType<T> : Record<string, unknown>;
+/** Why a run's active streaming phase ended. */
+type RunExecutionReason = /** The run reached the protocol `completed` lifecycle event. */"success" /** The run reached the protocol `failed` lifecycle event. */ | "error" /** The run paused on a protocol `interrupted` lifecycle event. */ | "interrupt" /** The run was stopped by a client-side abort. */ | "stopped";
+/** Payload for run-start callbacks. */
+interface RunExecutionInfo {
+  runId: string;
+}
+/** Payload for run-end callbacks. */
+interface RunCompletedInfo extends Omit<RunExecutionInfo, "runId"> {
+  /** Omitted when re-attaching to an in-flight run without local dispatch. */
+  runId?: string;
+  /** Why the active streaming phase ended. */
+  reason: RunExecutionReason;
+}
 /** Options common to both transport branches of framework `useStream` APIs. */
 interface UseStreamCommonOptions<StateType extends object, ThreadIdType = string | null> {
   threadId?: ThreadIdType;
   onThreadId?: (threadId: string) => void;
-  onCreated?: (meta: {
-    run_id: string;
-    thread_id: string;
-  }) => void;
+  /**
+   * Convenience callback fired when this hook instance's run is accepted
+   * by the server. Prefer `stream.isLoading` for UI; use this for
+   * imperative run-execution side effects.
+   */
+  onCreated?: (info: RunExecutionInfo) => void;
+  /**
+   * Convenience callback fired when a run's active streaming phase ends.
+   * `runId` may be omitted for re-attached in-flight runs because no local
+   * dispatch response was observed.
+   */
+  onCompleted?: (info: RunCompletedInfo) => void;
   initialValues?: StateType;
   /** State key holding the message array. Defaults to `"messages"`. */
   messagesKey?: string;
@@ -138,9 +151,8 @@ interface StreamControllerOptions<StateType extends object = Record<string, unkn
   /**
    * How the controller talks to the agent server. Accepts either a
    * built-in transport string (`"sse"` / `"websocket"`) or a custom
-   * {@link import("../client/stream/transport.js").AgentServerAdapter}
-   * that bypasses the built-in factories entirely. Forwarded to
-   * `client.threads.stream({ transport })`.
+   * {@link AgentServerAdapter} that bypasses the built-in factories
+   * entirely. Forwarded to `client.threads.stream({ transport })`.
    */
   transport?: ThreadStreamOptions["transport"];
   /** Optional `fetch` override forwarded to the built-in SSE transport. */
@@ -149,11 +161,18 @@ interface StreamControllerOptions<StateType extends object = Record<string, unkn
   webSocketFactory?: (url: string) => WebSocket;
   /** Called when a thread id is first produced (new-thread submits). */
   onThreadId?: (threadId: string) => void;
-  /** Called when a run starts (mirrors v1 `onCreated`). */
-  onCreated?: (meta: {
-    run_id: string;
-    thread_id: string;
-  }) => void;
+  /**
+   * Convenience callback fired when this hook instance's run is accepted
+   * by the server. Prefer `root.isLoading` for UI; use this for
+   * imperative run-execution side effects.
+   */
+  onCreated?: (info: RunExecutionInfo) => void;
+  /**
+   * Convenience callback fired when a run's active streaming phase ends.
+   * `runId` may be omitted for re-attached in-flight runs because no local
+   * dispatch response was observed.
+   */
+  onCompleted?: (info: RunCompletedInfo) => void;
   /** Initial state for `root.values` before hydration lands. */
   initialValues?: StateType;
   /** Key inside `values` that holds the message array. Defaults to `"messages"`. */
@@ -350,5 +369,5 @@ interface AcquiredProjection<T> {
   release(): void;
 }
 //#endregion
-export { AcquiredProjection, AgentServerOptions, CustomAdapterOptions, ProjectionRuntime, ProjectionSpec, RootEventBus, RootSnapshot, StateOf, StreamControllerOptions, StreamSubmitOptions, SubagentDiscoverySnapshot, SubgraphDiscoverySnapshot, Target, UseStreamCommonOptions, UseStreamOptions };
+export { AcquiredProjection, AgentServerOptions, CustomAdapterOptions, ProjectionRuntime, ProjectionSpec, RootEventBus, RootSnapshot, RunCompletedInfo, RunExecutionInfo, RunExecutionReason, StreamControllerOptions, StreamSubmitOptions, SubagentDiscoverySnapshot, SubgraphDiscoverySnapshot, Target, UseStreamCommonOptions, UseStreamOptions };
 //# sourceMappingURL=types.d.ts.map

package/dist/stream/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","names":[],"sources":["../../src/stream/types.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;KAkCY,OAAA,MACV,cAAA,CAAe,CAAA,UAAW,MAAA,oBACtB,cAAA,CAAe,CAAA,IACf,MAAA;;UAGW,sBAAA;EAIf,QAAA,GAAW,YAAA;EACX,UAAA,IAAc,QAAA;EACd,SAAA,IAAa,IAAA;IAAQ,MAAA;IAAgB,SAAA;EAAA;EACrC,aAAA,GAAgB,SAAA;EAPD;EASf,WAAA;EATqC;EAWrC,KAAA,GAAQ,6BAAA;EAJQ;EAMhB,MAAA,GAAS,cAAA;AAAA;;;;;;UAQM,kBAAA,mIAKP,sBAAA,CAAuB,SAAA,EAAW,YAAA;EAC1C,WAAA;EACA,MAAA,GAAS,MAAA;EACT,MAAA,GAAS,UAAA;EACT,MAAA,GAAS,UAAA;EACT,aAAA,GAAgB,YAAA;EAChB,cAAA,GAAiB,YAAA;EAzBjB;EA2BA,SAAA;EAzBA;EA2BA,KAAA,UAAe,KAAA;EAzBP;EA2BR,gBAAA,IAAoB,GAAA,aAAgB,SAAA;AAAA;;;AAjBtC;;;UAyBiB,oBAAA,gGAIP,sBAAA,CAAuB,SAAA,EAAW,YAAA;EAxBA;;;;;EA8B1C,SAAA,EAAW,kBAAA;EApBI;;;;EAyBf,WAAA,GAAc,qBAAA;EACd,MAAA;EACA,MAAA;EACA,MAAA;EACA,aAAA;EACA,cAAA;EACA,KAAA;EACA,gBAAA;AAAA;;;;;;;;;;KAYU,gBAAA,4BACiB,MAAA,oJAMzB,kBAAA,CAAmB,SAAA,EAAW,YAAA,EAAc,UAAA,EAAY,UAAA,IACxD,oBAAA,CAAqB,SAAA,EAAW,YAAA,EAAc,qBAAA;;;;;;;UAQjC,YAAA;EA1D8B;EAAA,SA4DpC,QAAA,WAAmB,OAAA;EApDO;EAsDnC,SAAA,CAAU,QAAA,GAAW,KAAA,EAAO,OAAA;AAAA;;;;;;;;UAUb,YAAA,4BACY,MAAA;EA9D3B;EAkEA,MAAA,EAAQ,SAAA;EAjEuB;EAmE/B,QAAA,EAAU,aAAA;EA7DV;EA+DA,SAAA,EAAW,iBAAA;EA1DX;EA4DA,UAAA,EAAY,SAAA,CAAU,aAAA;EA3DtB;EA6DA,SAAA,EAAW,SAAA,CAAU,aAAA;EA3DrB;EA6DA,SAAA;EA3DA;EA6DA,eAAA;EA3DA;EA6DA,KAAA;EA7DgB;EA+DhB,QAAA;AAAA;AAAA,UAGe,uBAAA,4BACY,MAAA;EAtDA;EAyD3B,WAAA;EAnDgC;EAqDhC,MAAA,EAAQ,MAAA,CAAO,SAAA;EArD2C;EAuD1D,QAAA;EAtDuB;;;;;;;EA8DvB,SAAA,GAAY,mBAAA;EApEZ;EAsEA,KAAA,UAAe,KAAA;EApEf;EAsEA,gBAAA,IAAoB,GAAA,aAAgB,SAAA;EAnElC;EAqEF,UAAA,IAAc,QAAA;EArEkB;EAuEhC,SAAA,IAAa,IAAA;IAAQ,MAAA;IAAgB,SAAA;EAAA;EAtEH;EAwElC,aAAA,GAAgB,SAAA;EAxEqD;EA0ErE,WAAA;AAAA;AAAA,UAGe,mBAAA,4BACY,MAAA,qDACO,MAAA;EAElC,MAAA;IACE,YAAA,GAAe,gBAAA;IACf,eAAA;IACA,IAAA;IAAA,CACC,GAAA;EAAA;EAEH,QAAA,GAAW,MAAA;EA3ED;;;AAUZ;;;;;;;;;;;;EAiFE,OAAA;IACE,MAAA;IACA,IAAA;MAAkB,IAAA;MAAc,KAAA;IAAA;IAChC,MAAA,GAAS,OAAA,CAAQ,SAAA;EAAA;EA3EnB;;;;;;;;EAqFA,QAAA;IAAa,YAAA;EAAA;EAzEb;;;AAGF;;;;;;;;;;;;;;;EAyFE,iBAAA;EACA,MAAA,GAAS,WAAA;EApFM;;;;;;;EA4Ff,QAAA;EA9EoC;;;;;;;;;EAwFpC,OAAA,IAAW,KAAA;EAEX,UAAA,GAAa,SAAA;AAAA;AA/Ef;;;;;;;;AAAA,UA0FiB,yBAAA;EA/BN;EAAA,SAiCA,EAAA;EAba;EAAA,SAeb,IAAA;EA7FT;EAAA,SA+FS,SAAA;EA9FT;EAAA,SAgGS,QAAA;EA9FT;EAAA,SAgGS,KAAA;EA/FQ;EAAA,SAiGR,MAAA;EA/FP;EAAA,SAiGO,SAAA;EA9FT;EAAA,SAgGS,MAAA;EAhFT;EAAA,SAkFS,KAAA;EAhFP;EAAA,SAkFO,SAAA,EAAW,IAAA;EAlFc;EAAA,SAoFzB,WAAA,EAAa,IAAA;AAAA;;;;UAMP,yBAAA;EAAA,SACN,EAAA;EAAA,SACA,SAAA;EArDT;;;;;;;AAuBF;EAvBE,SA8DS,QAAA;EAAA,SACA,MAAA;EAAA,SACA,SAAA,EAAW,IAAA;EAAA,SACX,WAAA,EAAa,IAAA;AAAA;;;;;;;KASZ,MAAA;EAAA,SAAgC,SAAA;AAAA;;;;;AAvB5C;;UA+BiB,cAAA;EAjBW;;;;;EAAA,SAuBjB,GAAA;EAxBW;EAAA,SA0BX,SAAA;EAzBa;EAAA,SA2Bb,OAAA,EAAS,CAAA;EA3BQ;AAS5B;;;;;AAQA;EAkBE,IAAA,CAAK,MAAA;IACH,MAAA,EAAQ,YAAA;IACR,KAAA,EAAO,WAAA,CAAY,CAAA;IADX;;;;;;IAQR,OAAA,EAAS,YAAA;EAAA,IACP,iBAAA;AAAA;AAAA,UAGW,iBAAA;EACf,OAAA,IAAW,OAAA;AAAA;;;;;;UAQI,kBAAA;EAAA,SACN,KAAA,EAAO,WAAA,CAAY,CAAA;EAC5B,OAAA;AAAA"}
+{"version":3,"file":"types.d.ts","names":[],"sources":["../../src/stream/types.ts"],"mappings":"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"}

package/dist/types.messages.d.cts

@@ -146,12 +146,40 @@ type InferSchemaInput<S> = S extends {
  * Helper type to extract the input type from a DynamicStructuredTool's _call method.
  * This is more reliable than trying to infer from the schema directly because
  * DynamicStructuredTool has the input type baked into its _call signature.
+ *
+ * Headless tools returned by `tool({ ... }).implement(...)` expose `execute`
+ * instead and nest the registered name under `tool.name`.
  */
 type InferToolInput<T> = T extends {
+  tool: {
+    name: string;
+  };
+  execute: (args: infer Args) => any;
+} ? Args : T extends {
   _call: (arg: infer Args, ...rest: any[]) => any;
 } ? Args : T extends {
   schema: infer S;
 } ? InferSchemaInput<S> : never;
+type UnwrapToolFuncOutput<R> = R extends Promise<infer Out> ? Out : R extends AsyncGenerator<unknown, infer Out, unknown> ? Out : R;
+/**
+ * Infer the successful return type of a LangChain tool.
+ *
+ * Resolution order mirrors {@link InferToolInput}: `func`, then
+ * `invoke`, then `_call`, so inference survives cross-package
+ * boundaries where `_call` is `protected`.
+ */
+type InferToolOutput<T> = T extends {
+  tool: {
+    name: string;
+  };
+  execute: (...args: any[]) => Promise<infer Out>;
+} ? Out : T extends {
+  func: (...args: any[]) => infer R;
+} ? UnwrapToolFuncOutput<R> : T extends {
+  invoke: (...args: any[]) => Promise<infer Out>;
+} ? Out : T extends {
+  _call: (...args: any[]) => infer R;
+} ? UnwrapToolFuncOutput<R> : unknown;
 /**
  * Infer a tool call type from a single tool.
  * Works with tools created via `tool()` from `@langchain/core/tools`.
@@ -176,6 +204,15 @@ type InferToolInput<T> = T extends {
  * ```
  */
 type ToolCallFromTool<T> = T extends {
+  tool: {
+    name: infer N extends string;
+  };
+} ? InferToolInput<T> extends infer Args ? Args extends never ? never : Args extends Record<string, any> ? {
+  name: N;
+  args: Args;
+  id?: string;
+  type?: "tool_call";
+} : never : never : T extends {
   name: infer N;
 } ? InferToolInput<T> extends infer Args ? Args extends never ? never : Args extends Record<string, any> ? {
   name: N;
@@ -262,5 +299,5 @@ type ToolCallWithResult<ToolCall = DefaultToolCall, TToolMessage = ToolMessage,
   state: ToolCallState;
 };
 //#endregion
-export { AIMessage, DefaultToolCall, FunctionMessage, HumanMessage, Message, RemoveMessage, SystemMessage, ToolCallFromTool, ToolCallState, ToolCallWithResult, ToolCallsFromTools, ToolMessage };
+export { AIMessage, DefaultToolCall, FunctionMessage, HumanMessage, InferToolOutput, Message, RemoveMessage, SystemMessage, ToolCallFromTool, ToolCallState, ToolCallWithResult, ToolCallsFromTools, ToolMessage };
 //# sourceMappingURL=types.messages.d.cts.map

package/dist/types.messages.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"types.messages.d.cts","names":[],"sources":["../src/types.messages.ts"],"mappings":";KAAK,WAAA;AAAA,KACA,sBAAA;EACH,IAAA;EACA,SAAA;IAAsB,GAAA;IAAa,MAAA,GAAS,WAAA;EAAA;AAAA;AAAA,KAGzC,kBAAA;EAAuB,IAAA;EAAc,IAAA;AAAA;AAAA,KACrC,qBAAA,GAAwB,kBAAA,GAAqB,sBAAA;AAAA,KAC7C,cAAA,YAA0B,qBAAA;;;;KAK1B,uBAAA,GAA0B,MAAA;AAAA,KAE1B,WAAA;EACH,iBAAA,GAAoB,uBAAA;EACpB,OAAA,EAAS,cAAA;EACT,EAAA;EACA,IAAA;EACA,iBAAA,GAAoB,MAAA;AAAA;AAAA,KAGV,YAAA,GAAe,WAAA;EACzB,IAAA;EACA,OAAA;AAAA;;;;KAMU,eAAA;EACV,IAAA;EAEA,IAAA;IAAA,CAAS,CAAA;EAAA;EACT,EAAA;EACA,IAAA;AAAA;;;;KAMU,eAAA;EACV,IAAA;EACA,IAAA;EACA,EAAA;EACA,KAAA;EACA,IAAA;AAAA;;;;KAMU,aAAA;EACV,YAAA;EACA,aAAA;EACA,YAAA;EACA,mBAAA;IAEM,KAAA;IACA,UAAA;IACA,cAAA;EAAA;EAGN,oBAAA;IACM,KAAA;IAA4B,SAAA;EAAA;AAAA;;;;;;;;;AAvBpC;;;;;;;;;;;AAWA;;;;;;;;KA2CY,SAAA,YAAqB,eAAA,IAAmB,WAAA;EAClD,IAAA;EACA,OAAA;EACA,UAAA,GAAa,QAAA;EACb,kBAAA,GAAqB,eAAA;EACrB,cAAA,GAAiB,aAAA;AAAA;AAAA,KAGP,WAAA,GAAc,WAAA;EACxB,IAAA;EACA,MAAA;EACA,YAAA;EAX+B;;;;;;;EAoB/B,QAAA;AAAA;AAAA,KAGU,aAAA,GAAgB,WAAA;EAC1B,IAAA;AAAA;AAAA,KAGU,eAAA,GAAkB,WAAA;EAC5B,IAAA;AAAA;AAAA,KAGU,aAAA,GAAgB,WAAA;EAC1B,IAAA;AAAA;;;AAxBF;;;KAgCY,OAAA,YAAmB,eAAA,IAC3B,YAAA,GACA,SAAA,CAAU,QAAA,IACV,WAAA,GACA,aAAA,GACA,eAAA,GACA,aAAA;;;;;;;;KAUC,gBAAA,MAAsB,CAAA;EAAY,IAAA;IAAQ,KAAA;EAAA;AAAA,IAC3C,IAAA,GACA,CAAA;EAAY,MAAA;AAAA,IACV,IAAA;;;;AA5BN;;KAoCK,cAAA,MAAoB,CAAA;EAEvB,KAAA,GAAQ,GAAA,iBAAoB,IAAA;AAAA,IAE1B,IAAA,GACA,CAAA;EAAY,MAAA;AAAA,IACV,gBAAA,CAAiB,CAAA;;;;;;;;;;;;;;;;;;;;;;;AA3BL;KAsDN,gBAAA,MAAsB,CAAA;EAAY,IAAA;AAAA,IAC1C,cAAA,CAAe,CAAA,uBACb,IAAA,yBAGE,IAAA,SAAa,MAAA;EACT,IAAA,EAAM,CAAA;EAAG,IAAA,EAAM,IAAA;EAAM,EAAA;EAAa,IAAA;AAAA;;;;;;;;AA/CpC;;;;;;;;;;;;;;;;;;;;;;KAiFE,kBAAA,iCACV,CAAA,iDACI,gBAAA,CAAiB,KAAA,IAAS,kBAAA,CAAmB,IAAA;AA1CnD;;;;;;;AAAA,KAoDY,aAAA;;;;;;;;;KAUA,kBAAA,YACC,eAAA,iBACI,WAAA,eACF,SAAA,CAAU,QAAA;EAhEW;;;;EAsElC,EAAA;EAjEgB;;;EAsEhB,IAAA,EAAM,QAAA;EAtEsC;;;AAkC9C;EA0CE,MAAA,EAAQ,YAAA;EA1CoB;;;EA+C5B,SAAA,EAAW,UAAA;EA7CsC;;;EAkDjD,KAAA;EApD6B;;;;;;;EA6D7B,KAAA,EAAO,aAAA;AAAA"}
+{"version":3,"file":"types.messages.d.cts","names":[],"sources":["../src/types.messages.ts"],"mappings":"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"}

package/dist/types.messages.d.ts

@@ -146,12 +146,40 @@ type InferSchemaInput<S> = S extends {
  * Helper type to extract the input type from a DynamicStructuredTool's _call method.
  * This is more reliable than trying to infer from the schema directly because
  * DynamicStructuredTool has the input type baked into its _call signature.
+ *
+ * Headless tools returned by `tool({ ... }).implement(...)` expose `execute`
+ * instead and nest the registered name under `tool.name`.
  */
 type InferToolInput<T> = T extends {
+  tool: {
+    name: string;
+  };
+  execute: (args: infer Args) => any;
+} ? Args : T extends {
   _call: (arg: infer Args, ...rest: any[]) => any;
 } ? Args : T extends {
   schema: infer S;
 } ? InferSchemaInput<S> : never;
+type UnwrapToolFuncOutput<R> = R extends Promise<infer Out> ? Out : R extends AsyncGenerator<unknown, infer Out, unknown> ? Out : R;
+/**
+ * Infer the successful return type of a LangChain tool.
+ *
+ * Resolution order mirrors {@link InferToolInput}: `func`, then
+ * `invoke`, then `_call`, so inference survives cross-package
+ * boundaries where `_call` is `protected`.
+ */
+type InferToolOutput<T> = T extends {
+  tool: {
+    name: string;
+  };
+  execute: (...args: any[]) => Promise<infer Out>;
+} ? Out : T extends {
+  func: (...args: any[]) => infer R;
+} ? UnwrapToolFuncOutput<R> : T extends {
+  invoke: (...args: any[]) => Promise<infer Out>;
+} ? Out : T extends {
+  _call: (...args: any[]) => infer R;
+} ? UnwrapToolFuncOutput<R> : unknown;
 /**
  * Infer a tool call type from a single tool.
  * Works with tools created via `tool()` from `@langchain/core/tools`.
@@ -176,6 +204,15 @@ type InferToolInput<T> = T extends {
  * ```
  */
 type ToolCallFromTool<T> = T extends {
+  tool: {
+    name: infer N extends string;
+  };
+} ? InferToolInput<T> extends infer Args ? Args extends never ? never : Args extends Record<string, any> ? {
+  name: N;
+  args: Args;
+  id?: string;
+  type?: "tool_call";
+} : never : never : T extends {
   name: infer N;
 } ? InferToolInput<T> extends infer Args ? Args extends never ? never : Args extends Record<string, any> ? {
   name: N;
@@ -262,5 +299,5 @@ type ToolCallWithResult<ToolCall = DefaultToolCall, TToolMessage = ToolMessage,
   state: ToolCallState;
 };
 //#endregion
-export { AIMessage, DefaultToolCall, FunctionMessage, HumanMessage, Message, RemoveMessage, SystemMessage, ToolCallFromTool, ToolCallState, ToolCallWithResult, ToolCallsFromTools, ToolMessage };
+export { AIMessage, DefaultToolCall, FunctionMessage, HumanMessage, InferToolOutput, Message, RemoveMessage, SystemMessage, ToolCallFromTool, ToolCallState, ToolCallWithResult, ToolCallsFromTools, ToolMessage };
 //# sourceMappingURL=types.messages.d.ts.map

package/dist/types.messages.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.messages.d.ts","names":[],"sources":["../src/types.messages.ts"],"mappings":";KAAK,WAAA;AAAA,KACA,sBAAA;EACH,IAAA;EACA,SAAA;IAAsB,GAAA;IAAa,MAAA,GAAS,WAAA;EAAA;AAAA;AAAA,KAGzC,kBAAA;EAAuB,IAAA;EAAc,IAAA;AAAA;AAAA,KACrC,qBAAA,GAAwB,kBAAA,GAAqB,sBAAA;AAAA,KAC7C,cAAA,YAA0B,qBAAA;;;;KAK1B,uBAAA,GAA0B,MAAA;AAAA,KAE1B,WAAA;EACH,iBAAA,GAAoB,uBAAA;EACpB,OAAA,EAAS,cAAA;EACT,EAAA;EACA,IAAA;EACA,iBAAA,GAAoB,MAAA;AAAA;AAAA,KAGV,YAAA,GAAe,WAAA;EACzB,IAAA;EACA,OAAA;AAAA;;;;KAMU,eAAA;EACV,IAAA;EAEA,IAAA;IAAA,CAAS,CAAA;EAAA;EACT,EAAA;EACA,IAAA;AAAA;;;;KAMU,eAAA;EACV,IAAA;EACA,IAAA;EACA,EAAA;EACA,KAAA;EACA,IAAA;AAAA;;;;KAMU,aAAA;EACV,YAAA;EACA,aAAA;EACA,YAAA;EACA,mBAAA;IAEM,KAAA;IACA,UAAA;IACA,cAAA;EAAA;EAGN,oBAAA;IACM,KAAA;IAA4B,SAAA;EAAA;AAAA;;;;;;;;;AAvBpC;;;;;;;;;;;AAWA;;;;;;;;KA2CY,SAAA,YAAqB,eAAA,IAAmB,WAAA;EAClD,IAAA;EACA,OAAA;EACA,UAAA,GAAa,QAAA;EACb,kBAAA,GAAqB,eAAA;EACrB,cAAA,GAAiB,aAAA;AAAA;AAAA,KAGP,WAAA,GAAc,WAAA;EACxB,IAAA;EACA,MAAA;EACA,YAAA;EAX+B;;;;;;;EAoB/B,QAAA;AAAA;AAAA,KAGU,aAAA,GAAgB,WAAA;EAC1B,IAAA;AAAA;AAAA,KAGU,eAAA,GAAkB,WAAA;EAC5B,IAAA;AAAA;AAAA,KAGU,aAAA,GAAgB,WAAA;EAC1B,IAAA;AAAA;;;AAxBF;;;KAgCY,OAAA,YAAmB,eAAA,IAC3B,YAAA,GACA,SAAA,CAAU,QAAA,IACV,WAAA,GACA,aAAA,GACA,eAAA,GACA,aAAA;;;;;;;;KAUC,gBAAA,MAAsB,CAAA;EAAY,IAAA;IAAQ,KAAA;EAAA;AAAA,IAC3C,IAAA,GACA,CAAA;EAAY,MAAA;AAAA,IACV,IAAA;;;;AA5BN;;KAoCK,cAAA,MAAoB,CAAA;EAEvB,KAAA,GAAQ,GAAA,iBAAoB,IAAA;AAAA,IAE1B,IAAA,GACA,CAAA;EAAY,MAAA;AAAA,IACV,gBAAA,CAAiB,CAAA;;;;;;;;;;;;;;;;;;;;;;;AA3BL;KAsDN,gBAAA,MAAsB,CAAA;EAAY,IAAA;AAAA,IAC1C,cAAA,CAAe,CAAA,uBACb,IAAA,yBAGE,IAAA,SAAa,MAAA;EACT,IAAA,EAAM,CAAA;EAAG,IAAA,EAAM,IAAA;EAAM,EAAA;EAAa,IAAA;AAAA;;;;;;;;AA/CpC;;;;;;;;;;;;;;;;;;;;;;KAiFE,kBAAA,iCACV,CAAA,iDACI,gBAAA,CAAiB,KAAA,IAAS,kBAAA,CAAmB,IAAA;AA1CnD;;;;;;;AAAA,KAoDY,aAAA;;;;;;;;;KAUA,kBAAA,YACC,eAAA,iBACI,WAAA,eACF,SAAA,CAAU,QAAA;EAhEW;;;;EAsElC,EAAA;EAjEgB;;;EAsEhB,IAAA,EAAM,QAAA;EAtEsC;;;AAkC9C;EA0CE,MAAA,EAAQ,YAAA;EA1CoB;;;EA+C5B,SAAA,EAAW,UAAA;EA7CsC;;;EAkDjD,KAAA;EApD6B;;;;;;;EA6D7B,KAAA,EAAO,aAAA;AAAA"}
+{"version":3,"file":"types.messages.d.ts","names":[],"sources":["../src/types.messages.ts"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@langchain/langgraph-sdk",
-  "version": "1.9.3",
+  "version": "1.9.5",
   "description": "Client library for interacting with the LangGraph API",
   "type": "module",
   "repository": {
@@ -10,7 +10,6 @@
   },
   "license": "MIT",
   "dependencies": {
-    "@langchain/core": "^1.1.44",
     "@langchain/protocol": "^0.0.15",
     "@types/json-schema": "^7.0.15",
     "p-queue": "^9.0.1",
@@ -36,6 +35,7 @@
     "zod": "^4.3.5"
   },
   "peerDependencies": {
+    "@langchain/core": "^1.1.44",
     "react": "^18 || ^19",
     "react-dom": "^18 || ^19",
     "svelte": "^4.0.0 || ^5.0.0",