@langchain/langgraph-sdk 1.8.9 → 1.9.0

package/dist/client/stream/handles/tools.cjs

@@ -0,0 +1,92 @@
+//#region src/client/stream/handles/tools.ts
+/**
+* Incrementally assembles `tools` events into complete
+* {@link AssembledToolCall} objects with promise-based output/status/error.
+*
+* Each `tool-started` event produces an {@link AssembledToolCall} whose
+* `output`, `status`, and `error` promises resolve when `tool-finished`
+* or `tool-error` arrives for the same `tool_call_id`.
+*/
+var ToolCallAssembler = class {
+	active = /* @__PURE__ */ new Map();
+	consume(event) {
+		const data = event.params.data;
+		if (data.event === "tool-started") return this.handleStarted(event, data);
+		if (data.event === "tool-finished") {
+			this.handleFinished(data);
+			return;
+		}
+		if (data.event === "tool-error") {
+			this.handleError(data);
+			return;
+		}
+	}
+	/**
+	* Reject any in-flight tool calls (e.g. on session close).
+	*/
+	failAll(reason) {
+		for (const tc of this.active.values()) {
+			tc.rejectOutput(reason);
+			tc.resolveStatus("error");
+			tc.resolveError(reason.message);
+		}
+		this.active.clear();
+	}
+	handleStarted(event, data) {
+		let resolveOutput;
+		let rejectOutput;
+		let resolveStatus;
+		let resolveError;
+		const output = new Promise((resolve, reject) => {
+			resolveOutput = resolve;
+			rejectOutput = reject;
+		});
+		output.catch(() => void 0);
+		const status = new Promise((resolve) => {
+			resolveStatus = resolve;
+		});
+		const error = new Promise((resolve) => {
+			resolveError = resolve;
+		});
+		const entry = {
+			name: data.tool_name,
+			callId: data.tool_call_id,
+			namespace: [...event.params.namespace],
+			input: data.input,
+			resolveOutput,
+			rejectOutput,
+			resolveStatus,
+			resolveError
+		};
+		this.active.set(data.tool_call_id, entry);
+		return {
+			name: entry.name,
+			callId: entry.callId,
+			namespace: entry.namespace,
+			input: entry.input,
+			output,
+			status,
+			error
+		};
+	}
+	handleFinished(data) {
+		const entry = this.active.get(data.tool_call_id);
+		if (!entry) return;
+		this.active.delete(data.tool_call_id);
+		entry.resolveOutput(data.output);
+		entry.resolveStatus("finished");
+		entry.resolveError(void 0);
+	}
+	handleError(data) {
+		const entry = this.active.get(data.tool_call_id);
+		if (!entry) return;
+		this.active.delete(data.tool_call_id);
+		entry.rejectOutput(new Error(data.message));
+		entry.resolveStatus("error");
+		entry.resolveError(data.message);
+	}
+};
+//#endregion
+exports.ToolCallAssembler = ToolCallAssembler;
+
+//# sourceMappingURL=tools.cjs.map

package/dist/client/stream/handles/tools.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.cjs","names":[],"sources":["../../../../src/client/stream/handles/tools.ts"],"sourcesContent":["import type {\n  ToolsEvent,\n  ToolStartedData,\n  ToolFinishedData,\n  ToolErrorData,\n} from \"@langchain/protocol\";\n\n/**\n * High-level outcome of a single tool call.\n */\nexport type ToolCallStatus = \"running\" | \"finished\" | \"error\";\n\n/**\n * Assembled view of a single tool call lifecycle (`tool-started` →\n * optional `tool-output-delta` → `tool-finished` | `tool-error`).\n *\n * Mirrors the in-process `ToolCallStream` interface so that remote\n * consumers get the same ergonomics.\n */\nexport interface AssembledToolCall {\n  readonly name: string;\n  readonly callId: string;\n  readonly namespace: string[];\n  readonly input: unknown;\n  readonly output: Promise<unknown>;\n  readonly status: Promise<ToolCallStatus>;\n  readonly error: Promise<string | undefined>;\n}\n\ntype ActiveToolCall = {\n  name: string;\n  callId: string;\n  namespace: string[];\n  input: unknown;\n  resolveOutput: (value: unknown) => void;\n  rejectOutput: (err: Error) => void;\n  resolveStatus: (value: ToolCallStatus) => void;\n  resolveError: (value: string | undefined) => void;\n};\n\n/**\n * Incrementally assembles `tools` events into complete\n * {@link AssembledToolCall} objects with promise-based output/status/error.\n *\n * Each `tool-started` event produces an {@link AssembledToolCall} whose\n * `output`, `status`, and `error` promises resolve when `tool-finished`\n * or `tool-error` arrives for the same `tool_call_id`.\n */\nexport class ToolCallAssembler {\n  private readonly active = new Map<string, ActiveToolCall>();\n\n  consume(event: ToolsEvent): AssembledToolCall | undefined {\n    const data = event.params.data;\n\n    if (data.event === \"tool-started\") {\n      return this.handleStarted(event, data);\n    }\n\n    if (data.event === \"tool-finished\") {\n      this.handleFinished(data);\n      return undefined;\n    }\n\n    if (data.event === \"tool-error\") {\n      this.handleError(data);\n      return undefined;\n    }\n\n    // tool-output-delta: no action needed at assembly level\n    return undefined;\n  }\n\n  /**\n   * Reject any in-flight tool calls (e.g. on session close).\n   */\n  failAll(reason: Error): void {\n    for (const tc of this.active.values()) {\n      tc.rejectOutput(reason);\n      tc.resolveStatus(\"error\");\n      tc.resolveError(reason.message);\n    }\n    this.active.clear();\n  }\n\n  private handleStarted(\n    event: ToolsEvent,\n    data: ToolStartedData\n  ): AssembledToolCall {\n    let resolveOutput!: (value: unknown) => void;\n    let rejectOutput!: (err: Error) => void;\n    let resolveStatus!: (value: ToolCallStatus) => void;\n    let resolveError!: (value: string | undefined) => void;\n\n    const output = new Promise<unknown>((resolve, reject) => {\n      resolveOutput = resolve;\n      rejectOutput = reject;\n    });\n    // Attach a default no-op catch so if no consumer awaits\n    // `output` the eventual rejection on `tool-error` / `failAll`\n    // doesn't surface as an unhandled Promise rejection.\n    output.catch(() => undefined);\n    const status = new Promise<ToolCallStatus>((resolve) => {\n      resolveStatus = resolve;\n    });\n    const error = new Promise<string | undefined>((resolve) => {\n      resolveError = resolve;\n    });\n\n    const entry: ActiveToolCall = {\n      name: data.tool_name,\n      callId: data.tool_call_id,\n      namespace: [...event.params.namespace],\n      input: data.input,\n      resolveOutput,\n      rejectOutput,\n      resolveStatus,\n      resolveError,\n    };\n    this.active.set(data.tool_call_id, entry);\n\n    return {\n      name: entry.name,\n      callId: entry.callId,\n      namespace: entry.namespace,\n      input: entry.input,\n      output,\n      status,\n      error,\n    };\n  }\n\n  private handleFinished(data: ToolFinishedData): void {\n    const entry = this.active.get(data.tool_call_id);\n    if (!entry) return;\n    this.active.delete(data.tool_call_id);\n    entry.resolveOutput(data.output);\n    entry.resolveStatus(\"finished\");\n    entry.resolveError(undefined);\n  }\n\n  private handleError(data: ToolErrorData): void {\n    const entry = this.active.get(data.tool_call_id);\n    if (!entry) return;\n    this.active.delete(data.tool_call_id);\n    entry.rejectOutput(new Error(data.message));\n    entry.resolveStatus(\"error\");\n    entry.resolveError(data.message);\n  }\n}\n"],"mappings":";;;;;;;;;AAgDA,IAAa,oBAAb,MAA+B;CAC7B,yBAA0B,IAAI,KAA6B;CAE3D,QAAQ,OAAkD;EACxD,MAAM,OAAO,MAAM,OAAO;AAE1B,MAAI,KAAK,UAAU,eACjB,QAAO,KAAK,cAAc,OAAO,KAAK;AAGxC,MAAI,KAAK,UAAU,iBAAiB;AAClC,QAAK,eAAe,KAAK;AACzB;;AAGF,MAAI,KAAK,UAAU,cAAc;AAC/B,QAAK,YAAY,KAAK;AACtB;;;;;;CAUJ,QAAQ,QAAqB;AAC3B,OAAK,MAAM,MAAM,KAAK,OAAO,QAAQ,EAAE;AACrC,MAAG,aAAa,OAAO;AACvB,MAAG,cAAc,QAAQ;AACzB,MAAG,aAAa,OAAO,QAAQ;;AAEjC,OAAK,OAAO,OAAO;;CAGrB,cACE,OACA,MACmB;EACnB,IAAI;EACJ,IAAI;EACJ,IAAI;EACJ,IAAI;EAEJ,MAAM,SAAS,IAAI,SAAkB,SAAS,WAAW;AACvD,mBAAgB;AAChB,kBAAe;IACf;AAIF,SAAO,YAAY,KAAA,EAAU;EAC7B,MAAM,SAAS,IAAI,SAAyB,YAAY;AACtD,mBAAgB;IAChB;EACF,MAAM,QAAQ,IAAI,SAA6B,YAAY;AACzD,kBAAe;IACf;EAEF,MAAM,QAAwB;GAC5B,MAAM,KAAK;GACX,QAAQ,KAAK;GACb,WAAW,CAAC,GAAG,MAAM,OAAO,UAAU;GACtC,OAAO,KAAK;GACZ;GACA;GACA;GACA;GACD;AACD,OAAK,OAAO,IAAI,KAAK,cAAc,MAAM;AAEzC,SAAO;GACL,MAAM,MAAM;GACZ,QAAQ,MAAM;GACd,WAAW,MAAM;GACjB,OAAO,MAAM;GACb;GACA;GACA;GACD;;CAGH,eAAuB,MAA8B;EACnD,MAAM,QAAQ,KAAK,OAAO,IAAI,KAAK,aAAa;AAChD,MAAI,CAAC,MAAO;AACZ,OAAK,OAAO,OAAO,KAAK,aAAa;AACrC,QAAM,cAAc,KAAK,OAAO;AAChC,QAAM,cAAc,WAAW;AAC/B,QAAM,aAAa,KAAA,EAAU;;CAG/B,YAAoB,MAA2B;EAC7C,MAAM,QAAQ,KAAK,OAAO,IAAI,KAAK,aAAa;AAChD,MAAI,CAAC,MAAO;AACZ,OAAK,OAAO,OAAO,KAAK,aAAa;AACrC,QAAM,aAAa,IAAI,MAAM,KAAK,QAAQ,CAAC;AAC3C,QAAM,cAAc,QAAQ;AAC5B,QAAM,aAAa,KAAK,QAAQ"}

package/dist/client/stream/handles/tools.d.cts

@@ -0,0 +1,26 @@
+import { ToolsEvent } from "@langchain/protocol";
+
+//#region src/client/stream/handles/tools.d.ts
+/**
+ * High-level outcome of a single tool call.
+ */
+type ToolCallStatus = "running" | "finished" | "error";
+/**
+ * Assembled view of a single tool call lifecycle (`tool-started` →
+ * optional `tool-output-delta` → `tool-finished` | `tool-error`).
+ *
+ * Mirrors the in-process `ToolCallStream` interface so that remote
+ * consumers get the same ergonomics.
+ */
+interface AssembledToolCall {
+  readonly name: string;
+  readonly callId: string;
+  readonly namespace: string[];
+  readonly input: unknown;
+  readonly output: Promise<unknown>;
+  readonly status: Promise<ToolCallStatus>;
+  readonly error: Promise<string | undefined>;
+}
+//#endregion
+export { AssembledToolCall, ToolCallStatus };
+//# sourceMappingURL=tools.d.cts.map

package/dist/client/stream/handles/tools.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.cts","names":[],"sources":["../../../../src/client/stream/handles/tools.ts"],"mappings":";;;;;AAUA;KAAY,cAAA;;;;AASZ;;;;UAAiB,iBAAA;EAAA,SACN,IAAA;EAAA,SACA,MAAA;EAAA,SACA,SAAA;EAAA,SACA,KAAA;EAAA,SACA,MAAA,EAAQ,OAAA;EAAA,SACR,MAAA,EAAQ,OAAA,CAAQ,cAAA;EAAA,SAChB,KAAA,EAAO,OAAA;AAAA"}

package/dist/client/stream/handles/tools.d.ts

@@ -0,0 +1,26 @@
+import { ToolsEvent } from "@langchain/protocol";
+
+//#region src/client/stream/handles/tools.d.ts
+/**
+ * High-level outcome of a single tool call.
+ */
+type ToolCallStatus = "running" | "finished" | "error";
+/**
+ * Assembled view of a single tool call lifecycle (`tool-started` →
+ * optional `tool-output-delta` → `tool-finished` | `tool-error`).
+ *
+ * Mirrors the in-process `ToolCallStream` interface so that remote
+ * consumers get the same ergonomics.
+ */
+interface AssembledToolCall {
+  readonly name: string;
+  readonly callId: string;
+  readonly namespace: string[];
+  readonly input: unknown;
+  readonly output: Promise<unknown>;
+  readonly status: Promise<ToolCallStatus>;
+  readonly error: Promise<string | undefined>;
+}
+//#endregion
+export { AssembledToolCall, ToolCallStatus };
+//# sourceMappingURL=tools.d.ts.map

package/dist/client/stream/handles/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","names":[],"sources":["../../../../src/client/stream/handles/tools.ts"],"mappings":";;;;;AAUA;KAAY,cAAA;;;;AASZ;;;;UAAiB,iBAAA;EAAA,SACN,IAAA;EAAA,SACA,MAAA;EAAA,SACA,SAAA;EAAA,SACA,KAAA;EAAA,SACA,MAAA,EAAQ,OAAA;EAAA,SACR,MAAA,EAAQ,OAAA,CAAQ,cAAA;EAAA,SAChB,KAAA,EAAO,OAAA;AAAA"}

package/dist/client/stream/handles/tools.js

@@ -0,0 +1,92 @@
+//#region src/client/stream/handles/tools.ts
+/**
+* Incrementally assembles `tools` events into complete
+* {@link AssembledToolCall} objects with promise-based output/status/error.
+*
+* Each `tool-started` event produces an {@link AssembledToolCall} whose
+* `output`, `status`, and `error` promises resolve when `tool-finished`
+* or `tool-error` arrives for the same `tool_call_id`.
+*/
+var ToolCallAssembler = class {
+	active = /* @__PURE__ */ new Map();
+	consume(event) {
+		const data = event.params.data;
+		if (data.event === "tool-started") return this.handleStarted(event, data);
+		if (data.event === "tool-finished") {
+			this.handleFinished(data);
+			return;
+		}
+		if (data.event === "tool-error") {
+			this.handleError(data);
+			return;
+		}
+	}
+	/**
+	* Reject any in-flight tool calls (e.g. on session close).
+	*/
+	failAll(reason) {
+		for (const tc of this.active.values()) {
+			tc.rejectOutput(reason);
+			tc.resolveStatus("error");
+			tc.resolveError(reason.message);
+		}
+		this.active.clear();
+	}
+	handleStarted(event, data) {
+		let resolveOutput;
+		let rejectOutput;
+		let resolveStatus;
+		let resolveError;
+		const output = new Promise((resolve, reject) => {
+			resolveOutput = resolve;
+			rejectOutput = reject;
+		});
+		output.catch(() => void 0);
+		const status = new Promise((resolve) => {
+			resolveStatus = resolve;
+		});
+		const error = new Promise((resolve) => {
+			resolveError = resolve;
+		});
+		const entry = {
+			name: data.tool_name,
+			callId: data.tool_call_id,
+			namespace: [...event.params.namespace],
+			input: data.input,
+			resolveOutput,
+			rejectOutput,
+			resolveStatus,
+			resolveError
+		};
+		this.active.set(data.tool_call_id, entry);
+		return {
+			name: entry.name,
+			callId: entry.callId,
+			namespace: entry.namespace,
+			input: entry.input,
+			output,
+			status,
+			error
+		};
+	}
+	handleFinished(data) {
+		const entry = this.active.get(data.tool_call_id);
+		if (!entry) return;
+		this.active.delete(data.tool_call_id);
+		entry.resolveOutput(data.output);
+		entry.resolveStatus("finished");
+		entry.resolveError(void 0);
+	}
+	handleError(data) {
+		const entry = this.active.get(data.tool_call_id);
+		if (!entry) return;
+		this.active.delete(data.tool_call_id);
+		entry.rejectOutput(new Error(data.message));
+		entry.resolveStatus("error");
+		entry.resolveError(data.message);
+	}
+};
+//#endregion
+export { ToolCallAssembler };
+
+//# sourceMappingURL=tools.js.map

package/dist/client/stream/handles/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","names":[],"sources":["../../../../src/client/stream/handles/tools.ts"],"sourcesContent":["import type {\n  ToolsEvent,\n  ToolStartedData,\n  ToolFinishedData,\n  ToolErrorData,\n} from \"@langchain/protocol\";\n\n/**\n * High-level outcome of a single tool call.\n */\nexport type ToolCallStatus = \"running\" | \"finished\" | \"error\";\n\n/**\n * Assembled view of a single tool call lifecycle (`tool-started` →\n * optional `tool-output-delta` → `tool-finished` | `tool-error`).\n *\n * Mirrors the in-process `ToolCallStream` interface so that remote\n * consumers get the same ergonomics.\n */\nexport interface AssembledToolCall {\n  readonly name: string;\n  readonly callId: string;\n  readonly namespace: string[];\n  readonly input: unknown;\n  readonly output: Promise<unknown>;\n  readonly status: Promise<ToolCallStatus>;\n  readonly error: Promise<string | undefined>;\n}\n\ntype ActiveToolCall = {\n  name: string;\n  callId: string;\n  namespace: string[];\n  input: unknown;\n  resolveOutput: (value: unknown) => void;\n  rejectOutput: (err: Error) => void;\n  resolveStatus: (value: ToolCallStatus) => void;\n  resolveError: (value: string | undefined) => void;\n};\n\n/**\n * Incrementally assembles `tools` events into complete\n * {@link AssembledToolCall} objects with promise-based output/status/error.\n *\n * Each `tool-started` event produces an {@link AssembledToolCall} whose\n * `output`, `status`, and `error` promises resolve when `tool-finished`\n * or `tool-error` arrives for the same `tool_call_id`.\n */\nexport class ToolCallAssembler {\n  private readonly active = new Map<string, ActiveToolCall>();\n\n  consume(event: ToolsEvent): AssembledToolCall | undefined {\n    const data = event.params.data;\n\n    if (data.event === \"tool-started\") {\n      return this.handleStarted(event, data);\n    }\n\n    if (data.event === \"tool-finished\") {\n      this.handleFinished(data);\n      return undefined;\n    }\n\n    if (data.event === \"tool-error\") {\n      this.handleError(data);\n      return undefined;\n    }\n\n    // tool-output-delta: no action needed at assembly level\n    return undefined;\n  }\n\n  /**\n   * Reject any in-flight tool calls (e.g. on session close).\n   */\n  failAll(reason: Error): void {\n    for (const tc of this.active.values()) {\n      tc.rejectOutput(reason);\n      tc.resolveStatus(\"error\");\n      tc.resolveError(reason.message);\n    }\n    this.active.clear();\n  }\n\n  private handleStarted(\n    event: ToolsEvent,\n    data: ToolStartedData\n  ): AssembledToolCall {\n    let resolveOutput!: (value: unknown) => void;\n    let rejectOutput!: (err: Error) => void;\n    let resolveStatus!: (value: ToolCallStatus) => void;\n    let resolveError!: (value: string | undefined) => void;\n\n    const output = new Promise<unknown>((resolve, reject) => {\n      resolveOutput = resolve;\n      rejectOutput = reject;\n    });\n    // Attach a default no-op catch so if no consumer awaits\n    // `output` the eventual rejection on `tool-error` / `failAll`\n    // doesn't surface as an unhandled Promise rejection.\n    output.catch(() => undefined);\n    const status = new Promise<ToolCallStatus>((resolve) => {\n      resolveStatus = resolve;\n    });\n    const error = new Promise<string | undefined>((resolve) => {\n      resolveError = resolve;\n    });\n\n    const entry: ActiveToolCall = {\n      name: data.tool_name,\n      callId: data.tool_call_id,\n      namespace: [...event.params.namespace],\n      input: data.input,\n      resolveOutput,\n      rejectOutput,\n      resolveStatus,\n      resolveError,\n    };\n    this.active.set(data.tool_call_id, entry);\n\n    return {\n      name: entry.name,\n      callId: entry.callId,\n      namespace: entry.namespace,\n      input: entry.input,\n      output,\n      status,\n      error,\n    };\n  }\n\n  private handleFinished(data: ToolFinishedData): void {\n    const entry = this.active.get(data.tool_call_id);\n    if (!entry) return;\n    this.active.delete(data.tool_call_id);\n    entry.resolveOutput(data.output);\n    entry.resolveStatus(\"finished\");\n    entry.resolveError(undefined);\n  }\n\n  private handleError(data: ToolErrorData): void {\n    const entry = this.active.get(data.tool_call_id);\n    if (!entry) return;\n    this.active.delete(data.tool_call_id);\n    entry.rejectOutput(new Error(data.message));\n    entry.resolveStatus(\"error\");\n    entry.resolveError(data.message);\n  }\n}\n"],"mappings":";;;;;;;;;AAgDA,IAAa,oBAAb,MAA+B;CAC7B,yBAA0B,IAAI,KAA6B;CAE3D,QAAQ,OAAkD;EACxD,MAAM,OAAO,MAAM,OAAO;AAE1B,MAAI,KAAK,UAAU,eACjB,QAAO,KAAK,cAAc,OAAO,KAAK;AAGxC,MAAI,KAAK,UAAU,iBAAiB;AAClC,QAAK,eAAe,KAAK;AACzB;;AAGF,MAAI,KAAK,UAAU,cAAc;AAC/B,QAAK,YAAY,KAAK;AACtB;;;;;;CAUJ,QAAQ,QAAqB;AAC3B,OAAK,MAAM,MAAM,KAAK,OAAO,QAAQ,EAAE;AACrC,MAAG,aAAa,OAAO;AACvB,MAAG,cAAc,QAAQ;AACzB,MAAG,aAAa,OAAO,QAAQ;;AAEjC,OAAK,OAAO,OAAO;;CAGrB,cACE,OACA,MACmB;EACnB,IAAI;EACJ,IAAI;EACJ,IAAI;EACJ,IAAI;EAEJ,MAAM,SAAS,IAAI,SAAkB,SAAS,WAAW;AACvD,mBAAgB;AAChB,kBAAe;IACf;AAIF,SAAO,YAAY,KAAA,EAAU;EAC7B,MAAM,SAAS,IAAI,SAAyB,YAAY;AACtD,mBAAgB;IAChB;EACF,MAAM,QAAQ,IAAI,SAA6B,YAAY;AACzD,kBAAe;IACf;EAEF,MAAM,QAAwB;GAC5B,MAAM,KAAK;GACX,QAAQ,KAAK;GACb,WAAW,CAAC,GAAG,MAAM,OAAO,UAAU;GACtC,OAAO,KAAK;GACZ;GACA;GACA;GACA;GACD;AACD,OAAK,OAAO,IAAI,KAAK,cAAc,MAAM;AAEzC,SAAO;GACL,MAAM,MAAM;GACZ,QAAQ,MAAM;GACd,WAAW,MAAM;GACjB,OAAO,MAAM;GACb;GACA;GACA;GACD;;CAGH,eAAuB,MAA8B;EACnD,MAAM,QAAQ,KAAK,OAAO,IAAI,KAAK,aAAa;AAChD,MAAI,CAAC,MAAO;AACZ,OAAK,OAAO,OAAO,KAAK,aAAa;AACrC,QAAM,cAAc,KAAK,OAAO;AAChC,QAAM,cAAc,WAAW;AAC/B,QAAM,aAAa,KAAA,EAAU;;CAG/B,YAAoB,MAA2B;EAC7C,MAAM,QAAQ,KAAK,OAAO,IAAI,KAAK,aAAa;AAChD,MAAI,CAAC,MAAO;AACZ,OAAK,OAAO,OAAO,KAAK,aAAa;AACrC,QAAM,aAAa,IAAI,MAAM,KAAK,QAAQ,CAAC;AAC3C,QAAM,cAAc,QAAQ;AAC5B,QAAM,aAAa,KAAK,QAAQ"}