@langchain/langgraph-sdk 1.8.9 → 1.9.0

package/dist/client/stream/transport/utils.js

@@ -0,0 +1,39 @@
+//#region src/client/stream/transport/utils.ts
+const isRecord = (value) => typeof value === "object" && value !== null;
+const toAbsoluteUrl = (apiUrl, path) => new URL(path, apiUrl.endsWith("/") ? apiUrl : `${apiUrl}/`);
+const toError = (error) => error instanceof Error ? error : new Error(String(error));
+const toWebSocketUrl = (apiUrl) => {
+	const url = new URL(apiUrl);
+	url.protocol = url.protocol === "https:" ? "wss:" : "ws:";
+	url.search = "";
+	url.hash = "";
+	return url.toString();
+};
+const hasHeaders = (headers) => Object.values(headers ?? {}).some((value) => value != null);
+function mergeHeaders(...headerGroups) {
+	const merged = new Headers();
+	for (const group of headerGroups) {
+		if (!group) continue;
+		if (group instanceof Headers) {
+			group.forEach((value, key) => {
+				merged.set(key, value);
+			});
+			continue;
+		}
+		if (Array.isArray(group)) {
+			for (const [key, value] of group) if (value == null) merged.delete(key);
+			else merged.set(key, value);
+			continue;
+		}
+		for (const [key, value] of Object.entries(group)) if (value == null) merged.delete(key);
+		else merged.set(key, value);
+	}
+	return merged;
+}
+function isProtocolResponse(value) {
+	return isRecord(value) && typeof value.type === "string" && (value.type === "success" || value.type === "error");
+}
+//#endregion
+export { hasHeaders, isProtocolResponse, isRecord, mergeHeaders, toAbsoluteUrl, toError, toWebSocketUrl };
+
+//# sourceMappingURL=utils.js.map

package/dist/client/stream/transport/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","names":[],"sources":["../../../../src/client/stream/transport/utils.ts"],"sourcesContent":["import type { HeaderValue } from \"./types.js\";\nimport type { CommandResponse, ErrorResponse } from \"@langchain/protocol\";\n\nexport const isRecord = (value: unknown): value is Record<string, unknown> =>\n  typeof value === \"object\" && value !== null;\n\nexport const toAbsoluteUrl = (apiUrl: string, path: string) =>\n  new URL(path, apiUrl.endsWith(\"/\") ? apiUrl : `${apiUrl}/`);\n\nexport const toError = (error: unknown) =>\n  // oxlint-disable-next-line no-instanceof/no-instanceof\n  error instanceof Error ? error : new Error(String(error));\n\nexport const toWebSocketUrl = (apiUrl: string): string => {\n  // Extract path from the input (e.g. \"http://host/threads/X/stream\") and\n  // swap the scheme to ws/wss. The caller passes a fully-formed URL\n  // with the desired path.\n  const url = new URL(apiUrl);\n  url.protocol = url.protocol === \"https:\" ? \"wss:\" : \"ws:\";\n  url.search = \"\";\n  url.hash = \"\";\n  return url.toString();\n};\n\nexport const hasHeaders = (headers?: Record<string, HeaderValue>) =>\n  Object.values(headers ?? {}).some((value) => value != null);\n\nexport function mergeHeaders(\n  ...headerGroups: Array<\n    HeadersInit | Record<string, HeaderValue> | undefined | null\n  >\n): Headers {\n  const merged = new Headers();\n\n  for (const group of headerGroups) {\n    if (!group) {\n      continue;\n    }\n\n    // oxlint-disable-next-line no-instanceof/no-instanceof\n    if (group instanceof Headers) {\n      group.forEach((value, key) => {\n        merged.set(key, value);\n      });\n      continue;\n    }\n\n    if (Array.isArray(group)) {\n      for (const [key, value] of group) {\n        if (value == null) {\n          merged.delete(key);\n        } else {\n          merged.set(key, value);\n        }\n      }\n      continue;\n    }\n\n    for (const [key, value] of Object.entries(group)) {\n      if (value == null) {\n        merged.delete(key);\n      } else {\n        merged.set(key, value);\n      }\n    }\n  }\n\n  return merged;\n}\n\nexport function isProtocolResponse(\n  value: unknown\n): value is CommandResponse | ErrorResponse {\n  return (\n    isRecord(value) &&\n    typeof value.type === \"string\" &&\n    (value.type === \"success\" || value.type === \"error\")\n  );\n}\n"],"mappings":";AAGA,MAAa,YAAY,UACvB,OAAO,UAAU,YAAY,UAAU;AAEzC,MAAa,iBAAiB,QAAgB,SAC5C,IAAI,IAAI,MAAM,OAAO,SAAS,IAAI,GAAG,SAAS,GAAG,OAAO,GAAG;AAE7D,MAAa,WAAW,UAEtB,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,OAAO,MAAM,CAAC;AAE3D,MAAa,kBAAkB,WAA2B;CAIxD,MAAM,MAAM,IAAI,IAAI,OAAO;AAC3B,KAAI,WAAW,IAAI,aAAa,WAAW,SAAS;AACpD,KAAI,SAAS;AACb,KAAI,OAAO;AACX,QAAO,IAAI,UAAU;;AAGvB,MAAa,cAAc,YACzB,OAAO,OAAO,WAAW,EAAE,CAAC,CAAC,MAAM,UAAU,SAAS,KAAK;AAE7D,SAAgB,aACd,GAAG,cAGM;CACT,MAAM,SAAS,IAAI,SAAS;AAE5B,MAAK,MAAM,SAAS,cAAc;AAChC,MAAI,CAAC,MACH;AAIF,MAAI,iBAAiB,SAAS;AAC5B,SAAM,SAAS,OAAO,QAAQ;AAC5B,WAAO,IAAI,KAAK,MAAM;KACtB;AACF;;AAGF,MAAI,MAAM,QAAQ,MAAM,EAAE;AACxB,QAAK,MAAM,CAAC,KAAK,UAAU,MACzB,KAAI,SAAS,KACX,QAAO,OAAO,IAAI;OAElB,QAAO,IAAI,KAAK,MAAM;AAG1B;;AAGF,OAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,MAAM,CAC9C,KAAI,SAAS,KACX,QAAO,OAAO,IAAI;MAElB,QAAO,IAAI,KAAK,MAAM;;AAK5B,QAAO;;AAGT,SAAgB,mBACd,OAC0C;AAC1C,QACE,SAAS,MAAM,IACf,OAAO,MAAM,SAAS,aACrB,MAAM,SAAS,aAAa,MAAM,SAAS"}

package/dist/client/stream/transport/websocket.cjs

@@ -0,0 +1,155 @@
+const require_queue = require("./queue.cjs");
+const require_utils = require("./utils.cjs");
+//#region src/client/stream/transport/websocket.ts
+/**
+* Transport adapter that speaks the thread-centric protocol over a
+* bidirectional WebSocket. Bound to a specific `threadId` — the socket
+* connects to `ws://.../v2/threads/:thread_id/stream`.
+*/
+var ProtocolWebSocketTransportAdapter = class {
+	threadId;
+	queue = new require_queue.AsyncQueue();
+	apiUrl;
+	defaultHeaders;
+	onRequest;
+	webSocketFactory;
+	streamUrl;
+	pending = /* @__PURE__ */ new Map();
+	socket = null;
+	closed = false;
+	intentionalClose = false;
+	constructor(options) {
+		this.apiUrl = options.apiUrl;
+		this.threadId = options.threadId;
+		this.defaultHeaders = options.defaultHeaders;
+		this.onRequest = options.onRequest;
+		this.webSocketFactory = options.webSocketFactory ?? ((url) => new WebSocket(url));
+		this.streamUrl = options.paths?.stream ?? `/v2/threads/${this.threadId}/stream`;
+	}
+	async open() {
+		if (this.socket != null) return;
+		this.assertBrowserSafeTransportConfig();
+		const wsUrl = require_utils.toWebSocketUrl(new URL(this.streamUrl, this.apiUrl.endsWith("/") ? this.apiUrl : `${this.apiUrl}/`).toString());
+		const socket = this.webSocketFactory(wsUrl);
+		this.socket = socket;
+		this.closed = false;
+		this.intentionalClose = false;
+		socket.addEventListener("message", this.handleMessage);
+		socket.addEventListener("close", this.handleClose);
+		socket.addEventListener("error", this.handleSocketError);
+		await new Promise((resolve, reject) => {
+			const onOpen = () => {
+				cleanup();
+				resolve();
+			};
+			const onError = () => {
+				cleanup();
+				reject(/* @__PURE__ */ new Error("Failed to open protocol WebSocket."));
+			};
+			const cleanup = () => {
+				socket.removeEventListener("open", onOpen);
+				socket.removeEventListener("error", onError);
+			};
+			socket.addEventListener("open", onOpen, { once: true });
+			socket.addEventListener("error", onError, { once: true });
+		});
+	}
+	async send(command) {
+		return await this.sendCommand(command);
+	}
+	events() {
+		const queue = this.queue;
+		return { [Symbol.asyncIterator]: () => ({
+			next: async () => await queue.shift(),
+			return: async () => {
+				queue.close();
+				return {
+					done: true,
+					value: void 0
+				};
+			}
+		}) };
+	}
+	async close() {
+		if (this.closed) return;
+		this.closed = true;
+		this.intentionalClose = true;
+		for (const { reject } of this.pending.values()) reject(/* @__PURE__ */ new Error("Protocol WebSocket connection closed."));
+		this.pending.clear();
+		this.queue.close();
+		const socket = this.socket;
+		this.socket = null;
+		if (!socket) return;
+		await new Promise((resolve) => {
+			if (socket.readyState === WebSocket.CLOSED) {
+				resolve();
+				return;
+			}
+			const onClose = () => {
+				socket.removeEventListener("close", onClose);
+				resolve();
+			};
+			socket.addEventListener("close", onClose, { once: true });
+			if (socket.readyState === WebSocket.OPEN || socket.readyState === WebSocket.CONNECTING) socket.close();
+			else resolve();
+		});
+	}
+	assertBrowserSafeTransportConfig() {
+		if (require_utils.hasHeaders(this.defaultHeaders) || this.onRequest != null) throw new Error("Browser WebSocket protocol transport does not support defaultHeaders or onRequest hooks. Supply a custom protocolWebSocketFactory if you need custom WebSocket setup.");
+	}
+	async sendCommand(command) {
+		const socket = this.socket;
+		if (socket == null || socket.readyState !== WebSocket.OPEN) throw new Error("Protocol WebSocket is not open.");
+		return await new Promise((resolve, reject) => {
+			this.pending.set(command.id, {
+				resolve,
+				reject
+			});
+			try {
+				socket.send(JSON.stringify(command));
+			} catch (error) {
+				this.pending.delete(command.id);
+				reject(require_utils.toError(error));
+			}
+		});
+	}
+	handleMessage = (event) => {
+		let payload;
+		try {
+			payload = JSON.parse(String(event.data));
+		} catch {
+			return;
+		}
+		if (require_utils.isRecord(payload) && typeof payload.id === "number" && (payload.type === "success" || payload.type === "error")) {
+			const pending = this.pending.get(payload.id);
+			if (pending) {
+				this.pending.delete(payload.id);
+				pending.resolve(payload);
+			}
+			return;
+		}
+		if (require_utils.isRecord(payload) && payload.type === "event") this.queue.push(payload);
+	};
+	handleClose = () => {
+		this.socket = null;
+		if (this.intentionalClose || this.closed) {
+			this.queue.close();
+			return;
+		}
+		const error = /* @__PURE__ */ new Error("Protocol WebSocket closed unexpectedly.");
+		for (const { reject } of this.pending.values()) reject(error);
+		this.pending.clear();
+		this.queue.close(error);
+	};
+	handleSocketError = () => {
+		if (this.closed || this.intentionalClose) return;
+		const error = /* @__PURE__ */ new Error("Protocol WebSocket encountered an error.");
+		for (const { reject } of this.pending.values()) reject(error);
+		this.pending.clear();
+		this.queue.close(error);
+	};
+};
+//#endregion
+exports.ProtocolWebSocketTransportAdapter = ProtocolWebSocketTransportAdapter;
+
+//# sourceMappingURL=websocket.cjs.map

package/dist/client/stream/transport/websocket.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket.cjs","names":["AsyncQueue","toWebSocketUrl","hasHeaders","toError","isRecord"],"sources":["../../../../src/client/stream/transport/websocket.ts"],"sourcesContent":["import { AsyncQueue } from \"./queue.js\";\nimport type {\n  Message,\n  Command,\n  CommandResponse,\n  ErrorResponse,\n} from \"@langchain/protocol\";\n\nimport { toWebSocketUrl, isRecord, hasHeaders, toError } from \"./utils.js\";\nimport type {\n  HeaderValue,\n  ProtocolRequestHook,\n  PendingResponse,\n  ProtocolWebSocketTransportOptions,\n} from \"./types.js\";\nimport type { TransportAdapter } from \"../transport.js\";\n\n/**\n * Transport adapter that speaks the thread-centric protocol over a\n * bidirectional WebSocket. Bound to a specific `threadId` — the socket\n * connects to `ws://.../v2/threads/:thread_id/stream`.\n */\nexport class ProtocolWebSocketTransportAdapter implements TransportAdapter {\n  readonly threadId: string;\n\n  private readonly queue = new AsyncQueue<Message>();\n\n  private readonly apiUrl: string;\n\n  private readonly defaultHeaders?: Record<string, HeaderValue>;\n\n  private readonly onRequest?: ProtocolRequestHook;\n\n  private readonly webSocketFactory: (url: string) => WebSocket;\n\n  private readonly streamUrl: string;\n\n  private readonly pending = new Map<number, PendingResponse>();\n\n  private socket: WebSocket | null = null;\n\n  private closed = false;\n\n  private intentionalClose = false;\n\n  constructor(options: ProtocolWebSocketTransportOptions) {\n    this.apiUrl = options.apiUrl;\n    this.threadId = options.threadId;\n    this.defaultHeaders = options.defaultHeaders;\n    this.onRequest = options.onRequest;\n    this.webSocketFactory =\n      options.webSocketFactory ?? ((url) => new WebSocket(url));\n    this.streamUrl =\n      options.paths?.stream ?? `/v2/threads/${this.threadId}/stream`;\n  }\n\n  async open(): Promise<void> {\n    if (this.socket != null) return;\n    this.assertBrowserSafeTransportConfig();\n\n    const wsUrl = toWebSocketUrl(\n      new URL(\n        this.streamUrl,\n        this.apiUrl.endsWith(\"/\") ? this.apiUrl : `${this.apiUrl}/`\n      ).toString()\n    );\n    const socket = this.webSocketFactory(wsUrl);\n    this.socket = socket;\n    this.closed = false;\n    this.intentionalClose = false;\n\n    socket.addEventListener(\"message\", this.handleMessage);\n    socket.addEventListener(\"close\", this.handleClose);\n    socket.addEventListener(\"error\", this.handleSocketError);\n\n    await new Promise<void>((resolve, reject) => {\n      const onOpen = () => {\n        cleanup();\n        resolve();\n      };\n      const onError = () => {\n        cleanup();\n        reject(new Error(\"Failed to open protocol WebSocket.\"));\n      };\n      const cleanup = () => {\n        socket.removeEventListener(\"open\", onOpen);\n        socket.removeEventListener(\"error\", onError);\n      };\n      socket.addEventListener(\"open\", onOpen, { once: true });\n      socket.addEventListener(\"error\", onError, { once: true });\n    });\n  }\n\n  async send(\n    command: Command\n  ): Promise<CommandResponse | ErrorResponse | void> {\n    return await this.sendCommand(command);\n  }\n\n  events(): AsyncIterable<Message> {\n    const queue = this.queue;\n    return {\n      [Symbol.asyncIterator]: () => ({\n        next: async () => await queue.shift(),\n        return: async () => {\n          queue.close();\n          return { done: true, value: undefined };\n        },\n      }),\n    };\n  }\n\n  async close(): Promise<void> {\n    if (this.closed) {\n      return;\n    }\n\n    this.closed = true;\n    this.intentionalClose = true;\n\n    for (const { reject } of this.pending.values()) {\n      reject(new Error(\"Protocol WebSocket connection closed.\"));\n    }\n    this.pending.clear();\n    this.queue.close();\n\n    const socket = this.socket;\n    this.socket = null;\n    if (!socket) {\n      return;\n    }\n\n    await new Promise<void>((resolve) => {\n      if (socket.readyState === WebSocket.CLOSED) {\n        resolve();\n        return;\n      }\n\n      const onClose = () => {\n        socket.removeEventListener(\"close\", onClose);\n        resolve();\n      };\n\n      socket.addEventListener(\"close\", onClose, { once: true });\n      if (\n        socket.readyState === WebSocket.OPEN ||\n        socket.readyState === WebSocket.CONNECTING\n      ) {\n        socket.close();\n      } else {\n        resolve();\n      }\n    });\n  }\n\n  private assertBrowserSafeTransportConfig(): void {\n    if (hasHeaders(this.defaultHeaders) || this.onRequest != null) {\n      throw new Error(\n        \"Browser WebSocket protocol transport does not support defaultHeaders or onRequest hooks. Supply a custom protocolWebSocketFactory if you need custom WebSocket setup.\"\n      );\n    }\n  }\n\n  private async sendCommand(\n    command: Command\n  ): Promise<CommandResponse | ErrorResponse> {\n    const socket = this.socket;\n    if (socket == null || socket.readyState !== WebSocket.OPEN) {\n      throw new Error(\"Protocol WebSocket is not open.\");\n    }\n\n    return await new Promise<CommandResponse | ErrorResponse>(\n      (resolve, reject) => {\n        this.pending.set(command.id, { resolve, reject });\n\n        try {\n          socket.send(JSON.stringify(command));\n        } catch (error) {\n          this.pending.delete(command.id);\n          reject(toError(error));\n        }\n      }\n    );\n  }\n\n  private readonly handleMessage = (event: MessageEvent): void => {\n    let payload: unknown;\n    try {\n      payload = JSON.parse(String(event.data));\n    } catch {\n      return;\n    }\n\n    if (\n      isRecord(payload) &&\n      typeof payload.id === \"number\" &&\n      (payload.type === \"success\" || payload.type === \"error\")\n    ) {\n      const pending = this.pending.get(payload.id);\n      if (pending) {\n        this.pending.delete(payload.id);\n        pending.resolve(payload as CommandResponse | ErrorResponse);\n      }\n      return;\n    }\n\n    if (isRecord(payload) && payload.type === \"event\") {\n      this.queue.push(payload as Message);\n    }\n  };\n\n  private readonly handleClose = (): void => {\n    this.socket = null;\n\n    if (this.intentionalClose || this.closed) {\n      this.queue.close();\n      return;\n    }\n\n    const error = new Error(\"Protocol WebSocket closed unexpectedly.\");\n    for (const { reject } of this.pending.values()) {\n      reject(error);\n    }\n    this.pending.clear();\n    this.queue.close(error);\n  };\n\n  private readonly handleSocketError = (): void => {\n    if (this.closed || this.intentionalClose) {\n      return;\n    }\n\n    const error = new Error(\"Protocol WebSocket encountered an error.\");\n    for (const { reject } of this.pending.values()) {\n      reject(error);\n    }\n    this.pending.clear();\n    this.queue.close(error);\n  };\n}\n"],"mappings":"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"}

package/dist/client/stream/transport/websocket.d.cts

@@ -0,0 +1,36 @@
+import { TransportAdapter } from "../transport.cjs";
+import { ProtocolWebSocketTransportOptions } from "./types.cjs";
+import { Command, CommandResponse, ErrorResponse, Message } from "@langchain/protocol";
+
+//#region src/client/stream/transport/websocket.d.ts
+/**
+ * Transport adapter that speaks the thread-centric protocol over a
+ * bidirectional WebSocket. Bound to a specific `threadId` — the socket
+ * connects to `ws://.../v2/threads/:thread_id/stream`.
+ */
+declare class ProtocolWebSocketTransportAdapter implements TransportAdapter {
+  readonly threadId: string;
+  private readonly queue;
+  private readonly apiUrl;
+  private readonly defaultHeaders?;
+  private readonly onRequest?;
+  private readonly webSocketFactory;
+  private readonly streamUrl;
+  private readonly pending;
+  private socket;
+  private closed;
+  private intentionalClose;
+  constructor(options: ProtocolWebSocketTransportOptions);
+  open(): Promise<void>;
+  send(command: Command): Promise<CommandResponse | ErrorResponse | void>;
+  events(): AsyncIterable<Message>;
+  close(): Promise<void>;
+  private assertBrowserSafeTransportConfig;
+  private sendCommand;
+  private readonly handleMessage;
+  private readonly handleClose;
+  private readonly handleSocketError;
+}
+//#endregion
+export { ProtocolWebSocketTransportAdapter };
+//# sourceMappingURL=websocket.d.cts.map

package/dist/client/stream/transport/websocket.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket.d.cts","names":[],"sources":["../../../../src/client/stream/transport/websocket.ts"],"mappings":";;;;;;;AAsBA;;;cAAa,iCAAA,YAA6C,gBAAA;EAAA,SAC/C,QAAA;EAAA,iBAEQ,KAAA;EAAA,iBAEA,MAAA;EAAA,iBAEA,cAAA;EAAA,iBAEA,SAAA;EAAA,iBAEA,gBAAA;EAAA,iBAEA,SAAA;EAAA,iBAEA,OAAA;EAAA,QAET,MAAA;EAAA,QAEA,MAAA;EAAA,QAEA,gBAAA;EAER,WAAA,CAAY,OAAA,EAAS,iCAAA;EAWf,IAAA,CAAA,GAAQ,OAAA;EAqCR,IAAA,CACJ,OAAA,EAAS,OAAA,GACR,OAAA,CAAQ,eAAA,GAAkB,aAAA;EAI7B,MAAA,CAAA,GAAU,aAAA,CAAc,OAAA;EAalB,KAAA,CAAA,GAAS,OAAA;EAAA,QA2CP,gCAAA;EAAA,QAQM,WAAA;EAAA,iBAsBG,aAAA;EAAA,iBA0BA,WAAA;EAAA,iBAgBA,iBAAA;AAAA"}

package/dist/client/stream/transport/websocket.d.ts

@@ -0,0 +1,36 @@
+import { TransportAdapter } from "../transport.js";
+import { ProtocolWebSocketTransportOptions } from "./types.js";
+import { Command, CommandResponse, ErrorResponse, Message } from "@langchain/protocol";
+
+//#region src/client/stream/transport/websocket.d.ts
+/**
+ * Transport adapter that speaks the thread-centric protocol over a
+ * bidirectional WebSocket. Bound to a specific `threadId` — the socket
+ * connects to `ws://.../v2/threads/:thread_id/stream`.
+ */
+declare class ProtocolWebSocketTransportAdapter implements TransportAdapter {
+  readonly threadId: string;
+  private readonly queue;
+  private readonly apiUrl;
+  private readonly defaultHeaders?;
+  private readonly onRequest?;
+  private readonly webSocketFactory;
+  private readonly streamUrl;
+  private readonly pending;
+  private socket;
+  private closed;
+  private intentionalClose;
+  constructor(options: ProtocolWebSocketTransportOptions);
+  open(): Promise<void>;
+  send(command: Command): Promise<CommandResponse | ErrorResponse | void>;
+  events(): AsyncIterable<Message>;
+  close(): Promise<void>;
+  private assertBrowserSafeTransportConfig;
+  private sendCommand;
+  private readonly handleMessage;
+  private readonly handleClose;
+  private readonly handleSocketError;
+}
+//#endregion
+export { ProtocolWebSocketTransportAdapter };
+//# sourceMappingURL=websocket.d.ts.map

package/dist/client/stream/transport/websocket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket.d.ts","names":[],"sources":["../../../../src/client/stream/transport/websocket.ts"],"mappings":";;;;;;;AAsBA;;;cAAa,iCAAA,YAA6C,gBAAA;EAAA,SAC/C,QAAA;EAAA,iBAEQ,KAAA;EAAA,iBAEA,MAAA;EAAA,iBAEA,cAAA;EAAA,iBAEA,SAAA;EAAA,iBAEA,gBAAA;EAAA,iBAEA,SAAA;EAAA,iBAEA,OAAA;EAAA,QAET,MAAA;EAAA,QAEA,MAAA;EAAA,QAEA,gBAAA;EAER,WAAA,CAAY,OAAA,EAAS,iCAAA;EAWf,IAAA,CAAA,GAAQ,OAAA;EAqCR,IAAA,CACJ,OAAA,EAAS,OAAA,GACR,OAAA,CAAQ,eAAA,GAAkB,aAAA;EAI7B,MAAA,CAAA,GAAU,aAAA,CAAc,OAAA;EAalB,KAAA,CAAA,GAAS,OAAA;EAAA,QA2CP,gCAAA;EAAA,QAQM,WAAA;EAAA,iBAsBG,aAAA;EAAA,iBA0BA,WAAA;EAAA,iBAgBA,iBAAA;AAAA"}

package/dist/client/stream/transport/websocket.js

@@ -0,0 +1,155 @@
+import { AsyncQueue } from "./queue.js";
+import { hasHeaders, isRecord, toError, toWebSocketUrl } from "./utils.js";
+//#region src/client/stream/transport/websocket.ts
+/**
+* Transport adapter that speaks the thread-centric protocol over a
+* bidirectional WebSocket. Bound to a specific `threadId` — the socket
+* connects to `ws://.../v2/threads/:thread_id/stream`.
+*/
+var ProtocolWebSocketTransportAdapter = class {
+	threadId;
+	queue = new AsyncQueue();
+	apiUrl;
+	defaultHeaders;
+	onRequest;
+	webSocketFactory;
+	streamUrl;
+	pending = /* @__PURE__ */ new Map();
+	socket = null;
+	closed = false;
+	intentionalClose = false;
+	constructor(options) {
+		this.apiUrl = options.apiUrl;
+		this.threadId = options.threadId;
+		this.defaultHeaders = options.defaultHeaders;
+		this.onRequest = options.onRequest;
+		this.webSocketFactory = options.webSocketFactory ?? ((url) => new WebSocket(url));
+		this.streamUrl = options.paths?.stream ?? `/v2/threads/${this.threadId}/stream`;
+	}
+	async open() {
+		if (this.socket != null) return;
+		this.assertBrowserSafeTransportConfig();
+		const wsUrl = toWebSocketUrl(new URL(this.streamUrl, this.apiUrl.endsWith("/") ? this.apiUrl : `${this.apiUrl}/`).toString());
+		const socket = this.webSocketFactory(wsUrl);
+		this.socket = socket;
+		this.closed = false;
+		this.intentionalClose = false;
+		socket.addEventListener("message", this.handleMessage);
+		socket.addEventListener("close", this.handleClose);
+		socket.addEventListener("error", this.handleSocketError);
+		await new Promise((resolve, reject) => {
+			const onOpen = () => {
+				cleanup();
+				resolve();
+			};
+			const onError = () => {
+				cleanup();
+				reject(/* @__PURE__ */ new Error("Failed to open protocol WebSocket."));
+			};
+			const cleanup = () => {
+				socket.removeEventListener("open", onOpen);
+				socket.removeEventListener("error", onError);
+			};
+			socket.addEventListener("open", onOpen, { once: true });
+			socket.addEventListener("error", onError, { once: true });
+		});
+	}
+	async send(command) {
+		return await this.sendCommand(command);
+	}
+	events() {
+		const queue = this.queue;
+		return { [Symbol.asyncIterator]: () => ({
+			next: async () => await queue.shift(),
+			return: async () => {
+				queue.close();
+				return {
+					done: true,
+					value: void 0
+				};
+			}
+		}) };
+	}
+	async close() {
+		if (this.closed) return;
+		this.closed = true;
+		this.intentionalClose = true;
+		for (const { reject } of this.pending.values()) reject(/* @__PURE__ */ new Error("Protocol WebSocket connection closed."));
+		this.pending.clear();
+		this.queue.close();
+		const socket = this.socket;
+		this.socket = null;
+		if (!socket) return;
+		await new Promise((resolve) => {
+			if (socket.readyState === WebSocket.CLOSED) {
+				resolve();
+				return;
+			}
+			const onClose = () => {
+				socket.removeEventListener("close", onClose);
+				resolve();
+			};
+			socket.addEventListener("close", onClose, { once: true });
+			if (socket.readyState === WebSocket.OPEN || socket.readyState === WebSocket.CONNECTING) socket.close();
+			else resolve();
+		});
+	}
+	assertBrowserSafeTransportConfig() {
+		if (hasHeaders(this.defaultHeaders) || this.onRequest != null) throw new Error("Browser WebSocket protocol transport does not support defaultHeaders or onRequest hooks. Supply a custom protocolWebSocketFactory if you need custom WebSocket setup.");
+	}
+	async sendCommand(command) {
+		const socket = this.socket;
+		if (socket == null || socket.readyState !== WebSocket.OPEN) throw new Error("Protocol WebSocket is not open.");
+		return await new Promise((resolve, reject) => {
+			this.pending.set(command.id, {
+				resolve,
+				reject
+			});
+			try {
+				socket.send(JSON.stringify(command));
+			} catch (error) {
+				this.pending.delete(command.id);
+				reject(toError(error));
+			}
+		});
+	}
+	handleMessage = (event) => {
+		let payload;
+		try {
+			payload = JSON.parse(String(event.data));
+		} catch {
+			return;
+		}
+		if (isRecord(payload) && typeof payload.id === "number" && (payload.type === "success" || payload.type === "error")) {
+			const pending = this.pending.get(payload.id);
+			if (pending) {
+				this.pending.delete(payload.id);
+				pending.resolve(payload);
+			}
+			return;
+		}
+		if (isRecord(payload) && payload.type === "event") this.queue.push(payload);
+	};
+	handleClose = () => {
+		this.socket = null;
+		if (this.intentionalClose || this.closed) {
+			this.queue.close();
+			return;
+		}
+		const error = /* @__PURE__ */ new Error("Protocol WebSocket closed unexpectedly.");
+		for (const { reject } of this.pending.values()) reject(error);
+		this.pending.clear();
+		this.queue.close(error);
+	};
+	handleSocketError = () => {
+		if (this.closed || this.intentionalClose) return;
+		const error = /* @__PURE__ */ new Error("Protocol WebSocket encountered an error.");
+		for (const { reject } of this.pending.values()) reject(error);
+		this.pending.clear();
+		this.queue.close(error);
+	};
+};
+//#endregion
+export { ProtocolWebSocketTransportAdapter };
+
+//# sourceMappingURL=websocket.js.map

package/dist/client/stream/transport/websocket.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket.js","names":[],"sources":["../../../../src/client/stream/transport/websocket.ts"],"sourcesContent":["import { AsyncQueue } from \"./queue.js\";\nimport type {\n  Message,\n  Command,\n  CommandResponse,\n  ErrorResponse,\n} from \"@langchain/protocol\";\n\nimport { toWebSocketUrl, isRecord, hasHeaders, toError } from \"./utils.js\";\nimport type {\n  HeaderValue,\n  ProtocolRequestHook,\n  PendingResponse,\n  ProtocolWebSocketTransportOptions,\n} from \"./types.js\";\nimport type { TransportAdapter } from \"../transport.js\";\n\n/**\n * Transport adapter that speaks the thread-centric protocol over a\n * bidirectional WebSocket. Bound to a specific `threadId` — the socket\n * connects to `ws://.../v2/threads/:thread_id/stream`.\n */\nexport class ProtocolWebSocketTransportAdapter implements TransportAdapter {\n  readonly threadId: string;\n\n  private readonly queue = new AsyncQueue<Message>();\n\n  private readonly apiUrl: string;\n\n  private readonly defaultHeaders?: Record<string, HeaderValue>;\n\n  private readonly onRequest?: ProtocolRequestHook;\n\n  private readonly webSocketFactory: (url: string) => WebSocket;\n\n  private readonly streamUrl: string;\n\n  private readonly pending = new Map<number, PendingResponse>();\n\n  private socket: WebSocket | null = null;\n\n  private closed = false;\n\n  private intentionalClose = false;\n\n  constructor(options: ProtocolWebSocketTransportOptions) {\n    this.apiUrl = options.apiUrl;\n    this.threadId = options.threadId;\n    this.defaultHeaders = options.defaultHeaders;\n    this.onRequest = options.onRequest;\n    this.webSocketFactory =\n      options.webSocketFactory ?? ((url) => new WebSocket(url));\n    this.streamUrl =\n      options.paths?.stream ?? `/v2/threads/${this.threadId}/stream`;\n  }\n\n  async open(): Promise<void> {\n    if (this.socket != null) return;\n    this.assertBrowserSafeTransportConfig();\n\n    const wsUrl = toWebSocketUrl(\n      new URL(\n        this.streamUrl,\n        this.apiUrl.endsWith(\"/\") ? this.apiUrl : `${this.apiUrl}/`\n      ).toString()\n    );\n    const socket = this.webSocketFactory(wsUrl);\n    this.socket = socket;\n    this.closed = false;\n    this.intentionalClose = false;\n\n    socket.addEventListener(\"message\", this.handleMessage);\n    socket.addEventListener(\"close\", this.handleClose);\n    socket.addEventListener(\"error\", this.handleSocketError);\n\n    await new Promise<void>((resolve, reject) => {\n      const onOpen = () => {\n        cleanup();\n        resolve();\n      };\n      const onError = () => {\n        cleanup();\n        reject(new Error(\"Failed to open protocol WebSocket.\"));\n      };\n      const cleanup = () => {\n        socket.removeEventListener(\"open\", onOpen);\n        socket.removeEventListener(\"error\", onError);\n      };\n      socket.addEventListener(\"open\", onOpen, { once: true });\n      socket.addEventListener(\"error\", onError, { once: true });\n    });\n  }\n\n  async send(\n    command: Command\n  ): Promise<CommandResponse | ErrorResponse | void> {\n    return await this.sendCommand(command);\n  }\n\n  events(): AsyncIterable<Message> {\n    const queue = this.queue;\n    return {\n      [Symbol.asyncIterator]: () => ({\n        next: async () => await queue.shift(),\n        return: async () => {\n          queue.close();\n          return { done: true, value: undefined };\n        },\n      }),\n    };\n  }\n\n  async close(): Promise<void> {\n    if (this.closed) {\n      return;\n    }\n\n    this.closed = true;\n    this.intentionalClose = true;\n\n    for (const { reject } of this.pending.values()) {\n      reject(new Error(\"Protocol WebSocket connection closed.\"));\n    }\n    this.pending.clear();\n    this.queue.close();\n\n    const socket = this.socket;\n    this.socket = null;\n    if (!socket) {\n      return;\n    }\n\n    await new Promise<void>((resolve) => {\n      if (socket.readyState === WebSocket.CLOSED) {\n        resolve();\n        return;\n      }\n\n      const onClose = () => {\n        socket.removeEventListener(\"close\", onClose);\n        resolve();\n      };\n\n      socket.addEventListener(\"close\", onClose, { once: true });\n      if (\n        socket.readyState === WebSocket.OPEN ||\n        socket.readyState === WebSocket.CONNECTING\n      ) {\n        socket.close();\n      } else {\n        resolve();\n      }\n    });\n  }\n\n  private assertBrowserSafeTransportConfig(): void {\n    if (hasHeaders(this.defaultHeaders) || this.onRequest != null) {\n      throw new Error(\n        \"Browser WebSocket protocol transport does not support defaultHeaders or onRequest hooks. Supply a custom protocolWebSocketFactory if you need custom WebSocket setup.\"\n      );\n    }\n  }\n\n  private async sendCommand(\n    command: Command\n  ): Promise<CommandResponse | ErrorResponse> {\n    const socket = this.socket;\n    if (socket == null || socket.readyState !== WebSocket.OPEN) {\n      throw new Error(\"Protocol WebSocket is not open.\");\n    }\n\n    return await new Promise<CommandResponse | ErrorResponse>(\n      (resolve, reject) => {\n        this.pending.set(command.id, { resolve, reject });\n\n        try {\n          socket.send(JSON.stringify(command));\n        } catch (error) {\n          this.pending.delete(command.id);\n          reject(toError(error));\n        }\n      }\n    );\n  }\n\n  private readonly handleMessage = (event: MessageEvent): void => {\n    let payload: unknown;\n    try {\n      payload = JSON.parse(String(event.data));\n    } catch {\n      return;\n    }\n\n    if (\n      isRecord(payload) &&\n      typeof payload.id === \"number\" &&\n      (payload.type === \"success\" || payload.type === \"error\")\n    ) {\n      const pending = this.pending.get(payload.id);\n      if (pending) {\n        this.pending.delete(payload.id);\n        pending.resolve(payload as CommandResponse | ErrorResponse);\n      }\n      return;\n    }\n\n    if (isRecord(payload) && payload.type === \"event\") {\n      this.queue.push(payload as Message);\n    }\n  };\n\n  private readonly handleClose = (): void => {\n    this.socket = null;\n\n    if (this.intentionalClose || this.closed) {\n      this.queue.close();\n      return;\n    }\n\n    const error = new Error(\"Protocol WebSocket closed unexpectedly.\");\n    for (const { reject } of this.pending.values()) {\n      reject(error);\n    }\n    this.pending.clear();\n    this.queue.close(error);\n  };\n\n  private readonly handleSocketError = (): void => {\n    if (this.closed || this.intentionalClose) {\n      return;\n    }\n\n    const error = new Error(\"Protocol WebSocket encountered an error.\");\n    for (const { reject } of this.pending.values()) {\n      reject(error);\n    }\n    this.pending.clear();\n    this.queue.close(error);\n  };\n}\n"],"mappings":"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"}

package/dist/client/stream/transport.d.cts

@@ -0,0 +1,104 @@
+import { Command, CommandResponse, ErrorResponse, Message, SubscribeParams } from "@langchain/protocol";
+
+//#region src/client/stream/transport.d.ts
+/**
+ * Handle returned by {@link TransportAdapter.openEventStream} representing
+ * a single filtered SSE connection.
+ *
+ * The `ready` promise resolves once the underlying connection is
+ * established (response headers received), letting callers ensure the
+ * subscription is active server-side before proceeding.
+ */
+interface EventStreamHandle {
+  events: AsyncIterable<Message>;
+  ready: Promise<void>;
+  close(): void;
+}
+/**
+ * Transport abstraction implemented by concrete client transports such as
+ * WebSocket or SSE adapters.
+ *
+ * In the thread-centric protocol, transports are bound to a specific
+ * thread at construction time — the thread ID is part of the connection URL.
+ */
+interface TransportAdapter {
+  /**
+   * Thread ID this transport is bound to.
+   */
+  readonly threadId: string;
+  /**
+   * Opens the underlying connection (e.g. WebSocket handshake).
+   * For HTTP/SSE transports this is a no-op.
+   */
+  open(): Promise<void>;
+  /**
+   * Sends a command and optionally returns an immediate response.
+   *
+   * @param command - Protocol command to send over the transport.
+   */
+  send(command: Command): Promise<CommandResponse | ErrorResponse | void>;
+  /**
+   * Streams incoming protocol messages from the remote peer.
+   * Used by WebSocket transports where all events share one connection.
+   */
+  events(): AsyncIterable<Message>;
+  /**
+   * Opens an independent filtered SSE event stream.
+   * Each call creates a new server connection with the given filter.
+   * Returns `undefined` when the transport does not support per-subscription
+   * streams (e.g. WebSocket), in which case the caller should fall back to
+   * command-based subscriptions over {@link events}.
+   */
+  openEventStream?(params: SubscribeParams): EventStreamHandle;
+  /**
+   * Shuts down the transport and releases any underlying resources.
+   */
+  close(): Promise<void>;
+}
+/**
+ * Public v1 name for {@link TransportAdapter} plus optional high-level
+ * capabilities. Renamed to reflect that this interface now denotes the
+ * full agent-server protocol contract (not merely wire transport):
+ * any object that satisfies it can back a `useStream` call. See
+ * `plan-custom-transport.md` §4 for the rollout.
+ *
+ * The extra optional methods let adapters surface thread state and
+ * history without the framework needing to issue a parallel HTTP
+ * request — `useStream.hydrate()` calls `getState?()` when present
+ * and falls back to `client.threads.getState` otherwise. Adapters
+ * that don't know how to produce these values can simply omit them.
+ *
+ * The legacy `TransportAdapter` export is retained for back-compat and
+ * resolves to the same structural type; new code should prefer
+ * `AgentServerAdapter`.
+ */
+interface AgentServerAdapter extends TransportAdapter {
+  /**
+   * Fetch the latest checkpointed state for the bound thread. When
+   * the adapter doesn't expose state (e.g. a purely event-replay
+   * backend), leave this undefined — the framework will skip
+   * hydration.
+   */
+  getState?<StateType = unknown>(): Promise<{
+    values: StateType;
+    checkpoint?: {
+      checkpoint_id?: string;
+    } | null;
+  } | null>;
+  /**
+   * Fetch a slice of checkpoint history for the bound thread. Used
+   * by branching and time-travel UIs. Optional — omitting it turns
+   * those UIs into no-ops rather than surfacing an error.
+   */
+  getHistory?<StateType = unknown>(options?: {
+    limit?: number;
+  }): Promise<Array<{
+    values: StateType;
+    checkpoint?: {
+      checkpoint_id?: string;
+    } | null;
+  }>>;
+}
+//#endregion
+export { AgentServerAdapter, EventStreamHandle, TransportAdapter };
+//# sourceMappingURL=transport.d.cts.map

package/dist/client/stream/transport.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.cts","names":[],"sources":["../../../src/client/stream/transport.ts"],"mappings":";;;;;AAgBA;;;;;;UAAiB,iBAAA;EACf,MAAA,EAAQ,aAAA,CAAc,OAAA;EACtB,KAAA,EAAO,OAAA;EACP,KAAA;AAAA;;;;;;AAUF;;UAAiB,gBAAA;EASP;;;EAAA,SALC,QAAA;EAWe;;;;EANxB,IAAA,IAAQ,OAAA;EAuBC;;;;;EAjBT,IAAA,CAAK,OAAA,EAAS,OAAA,GAAU,OAAA,CAAQ,eAAA,GAAkB,aAAA;EAAlD;;;;EAKA,MAAA,IAAU,aAAA,CAAc,OAAA;EAL0B;;;;;;;EAalD,eAAA,EAAiB,MAAA,EAAQ,eAAA,GAAkB,iBAAA;EAI3C;;;EAAA,KAAA,IAAS,OAAA;AAAA;;;;;;;;;;;;;;;;;;UAoBM,kBAAA,SAA2B,gBAAA;EAgB1C;;;;;;EATA,QAAA,0BAAkC,OAAA;IAChC,MAAA,EAAQ,SAAA;IACR,UAAA;MAAe,aAAA;IAAA;EAAA;;;;;;EAOjB,UAAA,uBAAiC,OAAA;IAC/B,KAAA;EAAA,IACE,OAAA,CACF,KAAA;IACE,MAAA,EAAQ,SAAA;IACR,UAAA;MAAe,aAAA;IAAA;EAAA;AAAA"}