@langchain/langgraph-sdk 1.8.10 → 1.9.1

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

@@ -0,0 +1,183 @@
+import { AsyncQueue } from "./queue.js";
+import { isProtocolResponse, isRecord, mergeHeaders, toAbsoluteUrl, toError } from "./utils.js";
+import { BytesLineDecoder, SSEDecoder } from "./decoder.js";
+import { IterableReadableStream } from "./stream.js";
+//#region src/client/stream/transport/http.ts
+/**
+* Transport adapter that speaks the thread-centric protocol over HTTP
+* commands plus SSE event streams. Bound to a specific `threadId`
+* at construction. Each {@link openEventStream} call opens an independent
+* filtered SSE connection via `POST /threads/:thread_id/stream/events`.
+*/
+var ProtocolSseTransportAdapter = class {
+	threadId;
+	queue = new AsyncQueue();
+	fetchImpl;
+	apiUrl;
+	defaultHeaders;
+	onRequest;
+	fetchFactory;
+	commandsUrl;
+	streamUrl;
+	sessionAbortController = new AbortController();
+	eventStreams = /* @__PURE__ */ new Set();
+	closed = false;
+	constructor(options) {
+		this.fetchImpl = options.fetch ?? fetch;
+		this.apiUrl = options.apiUrl;
+		this.defaultHeaders = options.defaultHeaders ?? {};
+		this.onRequest = options.onRequest;
+		this.fetchFactory = options.fetchFactory;
+		this.threadId = options.threadId;
+		this.commandsUrl = options.paths?.commands ?? `/threads/${this.threadId}/commands`;
+		this.streamUrl = options.paths?.stream ?? `/threads/${this.threadId}/stream/events`;
+	}
+	async resolveFetch() {
+		if (this.fetchFactory) return await this.fetchFactory();
+		return this.fetchImpl;
+	}
+	/**
+	* HTTP/SSE transports have no handshake — connections are made
+	* per-command and per-subscription.
+	*/
+	async open() {}
+	async send(command) {
+		const response = await this.request(this.commandsUrl, {
+			method: "POST",
+			headers: { "content-type": "application/json" },
+			body: JSON.stringify(command),
+			signal: this.sessionAbortController.signal
+		});
+		if (response.status === 202 || response.status === 204) return;
+		const payload = await response.json();
+		if (!isProtocolResponse(payload)) throw new Error("Protocol command did not return a valid response.");
+		return payload;
+	}
+	/**
+	* WebSocket-style single event stream.
+	* For the SSE transport this returns a dummy iterable; real event
+	* delivery happens via {@link openEventStream}.
+	*/
+	events() {
+		const queue = this.queue;
+		return { [Symbol.asyncIterator]: () => ({
+			next: async () => await queue.shift(),
+			return: async () => {
+				queue.close();
+				return {
+					done: true,
+					value: void 0
+				};
+			}
+		}) };
+	}
+	openEventStream(params) {
+		if (this.closed) throw new Error("Protocol transport is closed.");
+		const ac = new AbortController();
+		this.eventStreams.add(ac);
+		const streamQueue = new AsyncQueue();
+		const streamUrl = this.streamUrl;
+		let resolveReady;
+		let rejectReady;
+		const ready = new Promise((resolve, reject) => {
+			resolveReady = resolve;
+			rejectReady = reject;
+		});
+		const since = params.since;
+		const startStream = async () => {
+			try {
+				const response = await this.request(streamUrl, {
+					method: "POST",
+					headers: {
+						"content-type": "application/json",
+						accept: "text/event-stream"
+					},
+					body: JSON.stringify({
+						channels: params.channels,
+						...params.namespaces ? { namespaces: params.namespaces } : {},
+						...params.depth != null ? { depth: params.depth } : {},
+						...typeof since === "number" ? { since } : {}
+					}),
+					signal: ac.signal
+				});
+				resolveReady();
+				const stream = (response.body ?? new ReadableStream({ start(controller) {
+					controller.close();
+				} })).pipeThrough(BytesLineDecoder()).pipeThrough(SSEDecoder());
+				const iterable = IterableReadableStream.fromReadableStream(stream);
+				for await (const event of iterable) {
+					if (ac.signal.aborted || this.closed) break;
+					if (isRecord(event.data)) {
+						const msg = event.data;
+						streamQueue.push(msg);
+					}
+				}
+				streamQueue.close();
+			} catch (error) {
+				rejectReady(error);
+				if (ac.signal.aborted || this.closed) {
+					streamQueue.close();
+					return;
+				}
+				streamQueue.close(error);
+			}
+		};
+		startStream();
+		const cleanup = () => {
+			this.eventStreams.delete(ac);
+			ac.abort();
+			streamQueue.close();
+		};
+		return {
+			events: { [Symbol.asyncIterator]: () => ({
+				next: async () => await streamQueue.shift(),
+				return: async () => {
+					cleanup();
+					return {
+						done: true,
+						value: void 0
+					};
+				}
+			}) },
+			ready,
+			close: cleanup
+		};
+	}
+	async close() {
+		if (this.closed) return;
+		this.closed = true;
+		this.sessionAbortController.abort();
+		for (const ac of this.eventStreams) ac.abort();
+		this.eventStreams.clear();
+		this.queue.close();
+	}
+	async request(path, init) {
+		const url = toAbsoluteUrl(this.apiUrl, path);
+		let requestInit = {
+			...init,
+			headers: mergeHeaders(this.defaultHeaders, init.headers)
+		};
+		if (this.onRequest) requestInit = await this.onRequest(url, requestInit);
+		try {
+			const response = await (await this.resolveFetch())(url.toString(), requestInit);
+			if (!response.ok) {
+				let detail = "";
+				try {
+					const body = await response.text();
+					const parsed = JSON.parse(body);
+					if (typeof parsed === "object" && parsed != null) detail = parsed.message ?? parsed.error ?? "";
+					if (!detail) detail = body;
+				} catch {}
+				const message = detail ? `Protocol request failed: ${response.status} ${response.statusText} — ${detail}` : `Protocol request failed: ${response.status} ${response.statusText}`;
+				throw new Error(message);
+			}
+			return response;
+		} catch (error) {
+			throw toError(error);
+		}
+	}
+};
+//#endregion
+export { ProtocolSseTransportAdapter };
+
+//# sourceMappingURL=http.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","names":[],"sources":["../../../../src/client/stream/transport/http.ts"],"sourcesContent":["import { AsyncQueue } from \"./queue.js\";\nimport type {\n  Message,\n  SubscribeParams,\n  Command,\n  CommandResponse,\n  ErrorResponse,\n} from \"@langchain/protocol\";\n\nimport type {\n  HeaderValue,\n  ProtocolRequestHook,\n  ProtocolSseTransportOptions,\n} from \"./types.js\";\nimport type { TransportAdapter, EventStreamHandle } from \"../transport.js\";\nimport {\n  toAbsoluteUrl,\n  isRecord,\n  mergeHeaders,\n  toError,\n  isProtocolResponse,\n} from \"./utils.js\";\nimport { BytesLineDecoder, SSEDecoder } from \"./decoder.js\";\nimport { IterableReadableStream } from \"./stream.js\";\n\n/**\n * Transport adapter that speaks the thread-centric protocol over HTTP\n * commands plus SSE event streams. Bound to a specific `threadId`\n * at construction. Each {@link openEventStream} call opens an independent\n * filtered SSE connection via `POST /threads/:thread_id/stream/events`.\n */\nexport class ProtocolSseTransportAdapter implements TransportAdapter {\n  readonly threadId: string;\n\n  private readonly queue = new AsyncQueue<Message>();\n\n  private readonly fetchImpl: typeof fetch;\n\n  private readonly apiUrl: string;\n\n  private readonly defaultHeaders: Record<string, HeaderValue>;\n\n  private readonly onRequest?: ProtocolRequestHook;\n\n  private readonly fetchFactory?: () => typeof fetch | Promise<typeof fetch>;\n\n  private readonly commandsUrl: string;\n\n  private readonly streamUrl: string;\n\n  private readonly sessionAbortController = new AbortController();\n\n  private readonly eventStreams = new Set<AbortController>();\n\n  private closed = false;\n\n  constructor(options: ProtocolSseTransportOptions) {\n    this.fetchImpl = options.fetch ?? fetch;\n    this.apiUrl = options.apiUrl;\n    this.defaultHeaders = options.defaultHeaders ?? {};\n    this.onRequest = options.onRequest;\n    this.fetchFactory = options.fetchFactory;\n    this.threadId = options.threadId;\n    this.commandsUrl =\n      options.paths?.commands ?? `/threads/${this.threadId}/commands`;\n    this.streamUrl =\n      options.paths?.stream ?? `/threads/${this.threadId}/stream/events`;\n  }\n\n  private async resolveFetch(): Promise<typeof fetch> {\n    if (this.fetchFactory) {\n      return await this.fetchFactory();\n    }\n    return this.fetchImpl;\n  }\n\n  /**\n   * HTTP/SSE transports have no handshake — connections are made\n   * per-command and per-subscription.\n   */\n  async open(): Promise<void> {\n    // no-op\n  }\n\n  async send(\n    command: Command\n  ): Promise<CommandResponse | ErrorResponse | void> {\n    const response = await this.request(this.commandsUrl, {\n      method: \"POST\",\n      headers: { \"content-type\": \"application/json\" },\n      body: JSON.stringify(command),\n      signal: this.sessionAbortController.signal,\n    });\n\n    if (response.status === 202 || response.status === 204) {\n      return undefined;\n    }\n\n    const payload = (await response.json()) as unknown;\n    if (!isProtocolResponse(payload)) {\n      throw new Error(\"Protocol command did not return a valid response.\");\n    }\n    return payload;\n  }\n\n  /**\n   * WebSocket-style single event stream.\n   * For the SSE transport this returns a dummy iterable; real event\n   * delivery happens via {@link openEventStream}.\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  openEventStream(params: SubscribeParams): EventStreamHandle {\n    if (this.closed) {\n      throw new Error(\"Protocol transport is closed.\");\n    }\n\n    const ac = new AbortController();\n    this.eventStreams.add(ac);\n    const streamQueue = new AsyncQueue<Message>();\n    const streamUrl = this.streamUrl;\n\n    let resolveReady!: () => void;\n    let rejectReady!: (err: unknown) => void;\n    const ready = new Promise<void>((resolve, reject) => {\n      resolveReady = resolve;\n      rejectReady = reject;\n    });\n\n    const since = (params as SubscribeParams & { since?: unknown }).since;\n\n    const startStream = async () => {\n      try {\n        const response = await this.request(streamUrl, {\n          method: \"POST\",\n          headers: {\n            \"content-type\": \"application/json\",\n            accept: \"text/event-stream\",\n          },\n          body: JSON.stringify({\n            channels: params.channels,\n            ...(params.namespaces ? { namespaces: params.namespaces } : {}),\n            ...(params.depth != null ? { depth: params.depth } : {}),\n            ...(typeof since === \"number\" ? { since } : {}),\n          }),\n          signal: ac.signal,\n        });\n\n        resolveReady();\n\n        const readable =\n          response.body ??\n          new ReadableStream<Uint8Array>({\n            start(controller) {\n              controller.close();\n            },\n          });\n\n        const stream = readable\n          .pipeThrough(BytesLineDecoder())\n          .pipeThrough(SSEDecoder());\n        const iterable = IterableReadableStream.fromReadableStream(stream);\n\n        for await (const event of iterable) {\n          if (ac.signal.aborted || this.closed) {\n            break;\n          }\n          if (isRecord(event.data)) {\n            const msg = event.data as Message & {\n              seq?: number;\n              method?: string;\n            };\n            streamQueue.push(msg);\n          }\n        }\n        streamQueue.close();\n      } catch (error) {\n        rejectReady(error);\n        if (ac.signal.aborted || this.closed) {\n          streamQueue.close();\n          return;\n        }\n        streamQueue.close(error);\n      }\n    };\n\n    void startStream();\n\n    const cleanup = () => {\n      this.eventStreams.delete(ac);\n      ac.abort();\n      streamQueue.close();\n    };\n\n    return {\n      events: {\n        [Symbol.asyncIterator]: () => ({\n          next: async () => await streamQueue.shift(),\n          return: async () => {\n            cleanup();\n            return { done: true, value: undefined };\n          },\n        }),\n      },\n      ready,\n      close: cleanup,\n    };\n  }\n\n  async close(): Promise<void> {\n    if (this.closed) {\n      return;\n    }\n    this.closed = true;\n    this.sessionAbortController.abort();\n    for (const ac of this.eventStreams) ac.abort();\n    this.eventStreams.clear();\n    this.queue.close();\n  }\n\n  private async request(path: string, init: RequestInit): Promise<Response> {\n    const url = toAbsoluteUrl(this.apiUrl, path);\n    let requestInit: RequestInit = {\n      ...init,\n      headers: mergeHeaders(this.defaultHeaders, init.headers),\n    };\n\n    if (this.onRequest) {\n      requestInit = await this.onRequest(url, requestInit);\n    }\n\n    try {\n      const fetchImpl = await this.resolveFetch();\n      const response = await fetchImpl(url.toString(), requestInit);\n      if (!response.ok) {\n        let detail = \"\";\n        try {\n          const body = await response.text();\n          const parsed = JSON.parse(body);\n          if (typeof parsed === \"object\" && parsed != null) {\n            detail =\n              ((parsed as Record<string, unknown>).message as string) ??\n              ((parsed as Record<string, unknown>).error as string) ??\n              \"\";\n          }\n          if (!detail) detail = body;\n        } catch {\n          // body unreadable or not JSON — fall through\n        }\n        const message = detail\n          ? `Protocol request failed: ${response.status} ${response.statusText} — ${detail}`\n          : `Protocol request failed: ${response.status} ${response.statusText}`;\n        throw new Error(message);\n      }\n      return response;\n    } catch (error) {\n      throw toError(error);\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;;AA+BA,IAAa,8BAAb,MAAqE;CACnE;CAEA,QAAyB,IAAI,YAAqB;CAElD;CAEA;CAEA;CAEA;CAEA;CAEA;CAEA;CAEA,yBAA0C,IAAI,iBAAiB;CAE/D,+BAAgC,IAAI,KAAsB;CAE1D,SAAiB;CAEjB,YAAY,SAAsC;AAChD,OAAK,YAAY,QAAQ,SAAS;AAClC,OAAK,SAAS,QAAQ;AACtB,OAAK,iBAAiB,QAAQ,kBAAkB,EAAE;AAClD,OAAK,YAAY,QAAQ;AACzB,OAAK,eAAe,QAAQ;AAC5B,OAAK,WAAW,QAAQ;AACxB,OAAK,cACH,QAAQ,OAAO,YAAY,YAAY,KAAK,SAAS;AACvD,OAAK,YACH,QAAQ,OAAO,UAAU,YAAY,KAAK,SAAS;;CAGvD,MAAc,eAAsC;AAClD,MAAI,KAAK,aACP,QAAO,MAAM,KAAK,cAAc;AAElC,SAAO,KAAK;;;;;;CAOd,MAAM,OAAsB;CAI5B,MAAM,KACJ,SACiD;EACjD,MAAM,WAAW,MAAM,KAAK,QAAQ,KAAK,aAAa;GACpD,QAAQ;GACR,SAAS,EAAE,gBAAgB,oBAAoB;GAC/C,MAAM,KAAK,UAAU,QAAQ;GAC7B,QAAQ,KAAK,uBAAuB;GACrC,CAAC;AAEF,MAAI,SAAS,WAAW,OAAO,SAAS,WAAW,IACjD;EAGF,MAAM,UAAW,MAAM,SAAS,MAAM;AACtC,MAAI,CAAC,mBAAmB,QAAQ,CAC9B,OAAM,IAAI,MAAM,oDAAoD;AAEtE,SAAO;;;;;;;CAQT,SAAiC;EAC/B,MAAM,QAAQ,KAAK;AACnB,SAAO,GACJ,OAAO,uBAAuB;GAC7B,MAAM,YAAY,MAAM,MAAM,OAAO;GACrC,QAAQ,YAAY;AAClB,UAAM,OAAO;AACb,WAAO;KAAE,MAAM;KAAM,OAAO,KAAA;KAAW;;GAE1C,GACF;;CAGH,gBAAgB,QAA4C;AAC1D,MAAI,KAAK,OACP,OAAM,IAAI,MAAM,gCAAgC;EAGlD,MAAM,KAAK,IAAI,iBAAiB;AAChC,OAAK,aAAa,IAAI,GAAG;EACzB,MAAM,cAAc,IAAI,YAAqB;EAC7C,MAAM,YAAY,KAAK;EAEvB,IAAI;EACJ,IAAI;EACJ,MAAM,QAAQ,IAAI,SAAe,SAAS,WAAW;AACnD,kBAAe;AACf,iBAAc;IACd;EAEF,MAAM,QAAS,OAAiD;EAEhE,MAAM,cAAc,YAAY;AAC9B,OAAI;IACF,MAAM,WAAW,MAAM,KAAK,QAAQ,WAAW;KAC7C,QAAQ;KACR,SAAS;MACP,gBAAgB;MAChB,QAAQ;MACT;KACD,MAAM,KAAK,UAAU;MACnB,UAAU,OAAO;MACjB,GAAI,OAAO,aAAa,EAAE,YAAY,OAAO,YAAY,GAAG,EAAE;MAC9D,GAAI,OAAO,SAAS,OAAO,EAAE,OAAO,OAAO,OAAO,GAAG,EAAE;MACvD,GAAI,OAAO,UAAU,WAAW,EAAE,OAAO,GAAG,EAAE;MAC/C,CAAC;KACF,QAAQ,GAAG;KACZ,CAAC;AAEF,kBAAc;IAUd,MAAM,UAPJ,SAAS,QACT,IAAI,eAA2B,EAC7B,MAAM,YAAY;AAChB,gBAAW,OAAO;OAErB,CAAC,EAGD,YAAY,kBAAkB,CAAC,CAC/B,YAAY,YAAY,CAAC;IAC5B,MAAM,WAAW,uBAAuB,mBAAmB,OAAO;AAElE,eAAW,MAAM,SAAS,UAAU;AAClC,SAAI,GAAG,OAAO,WAAW,KAAK,OAC5B;AAEF,SAAI,SAAS,MAAM,KAAK,EAAE;MACxB,MAAM,MAAM,MAAM;AAIlB,kBAAY,KAAK,IAAI;;;AAGzB,gBAAY,OAAO;YACZ,OAAO;AACd,gBAAY,MAAM;AAClB,QAAI,GAAG,OAAO,WAAW,KAAK,QAAQ;AACpC,iBAAY,OAAO;AACnB;;AAEF,gBAAY,MAAM,MAAM;;;AAIvB,eAAa;EAElB,MAAM,gBAAgB;AACpB,QAAK,aAAa,OAAO,GAAG;AAC5B,MAAG,OAAO;AACV,eAAY,OAAO;;AAGrB,SAAO;GACL,QAAQ,GACL,OAAO,uBAAuB;IAC7B,MAAM,YAAY,MAAM,YAAY,OAAO;IAC3C,QAAQ,YAAY;AAClB,cAAS;AACT,YAAO;MAAE,MAAM;MAAM,OAAO,KAAA;MAAW;;IAE1C,GACF;GACD;GACA,OAAO;GACR;;CAGH,MAAM,QAAuB;AAC3B,MAAI,KAAK,OACP;AAEF,OAAK,SAAS;AACd,OAAK,uBAAuB,OAAO;AACnC,OAAK,MAAM,MAAM,KAAK,aAAc,IAAG,OAAO;AAC9C,OAAK,aAAa,OAAO;AACzB,OAAK,MAAM,OAAO;;CAGpB,MAAc,QAAQ,MAAc,MAAsC;EACxE,MAAM,MAAM,cAAc,KAAK,QAAQ,KAAK;EAC5C,IAAI,cAA2B;GAC7B,GAAG;GACH,SAAS,aAAa,KAAK,gBAAgB,KAAK,QAAQ;GACzD;AAED,MAAI,KAAK,UACP,eAAc,MAAM,KAAK,UAAU,KAAK,YAAY;AAGtD,MAAI;GAEF,MAAM,WAAW,OADC,MAAM,KAAK,cAAc,EACV,IAAI,UAAU,EAAE,YAAY;AAC7D,OAAI,CAAC,SAAS,IAAI;IAChB,IAAI,SAAS;AACb,QAAI;KACF,MAAM,OAAO,MAAM,SAAS,MAAM;KAClC,MAAM,SAAS,KAAK,MAAM,KAAK;AAC/B,SAAI,OAAO,WAAW,YAAY,UAAU,KAC1C,UACI,OAAmC,WACnC,OAAmC,SACrC;AAEJ,SAAI,CAAC,OAAQ,UAAS;YAChB;IAGR,MAAM,UAAU,SACZ,4BAA4B,SAAS,OAAO,GAAG,SAAS,WAAW,KAAK,WACxE,4BAA4B,SAAS,OAAO,GAAG,SAAS;AAC5D,UAAM,IAAI,MAAM,QAAQ;;AAE1B,UAAO;WACA,OAAO;AACd,SAAM,QAAQ,MAAM"}

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

@@ -0,0 +1,3 @@
+require("./http.cjs");
+require("./websocket.cjs");
+require("./agent-server.cjs");

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

@@ -0,0 +1,4 @@
+import "./http.js";
+import "./websocket.js";
+import "./agent-server.js";
+export {};

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

@@ -0,0 +1,55 @@
+//#region src/client/stream/transport/queue.ts
+var AsyncQueue = class {
+	values = [];
+	waiters = [];
+	rejecters = [];
+	closed = false;
+	error = null;
+	push(value) {
+		if (this.closed) return;
+		const waiter = this.waiters.shift();
+		this.rejecters.shift();
+		if (waiter) {
+			waiter({
+				done: false,
+				value
+			});
+			return;
+		}
+		this.values.push(value);
+	}
+	close(error) {
+		if (this.closed) return;
+		this.closed = true;
+		this.error = error == null ? null : error instanceof Error ? error : new Error(String(error));
+		if (this.error) {
+			for (const rejecter of this.rejecters.splice(0)) rejecter(this.error);
+			this.waiters.length = 0;
+			return;
+		}
+		for (const waiter of this.waiters.splice(0)) waiter({
+			done: true,
+			value: void 0
+		});
+		this.rejecters.length = 0;
+	}
+	async shift() {
+		if (this.values.length > 0) return {
+			done: false,
+			value: this.values.shift()
+		};
+		if (this.error) throw this.error;
+		if (this.closed) return {
+			done: true,
+			value: void 0
+		};
+		return await new Promise((resolve, reject) => {
+			this.waiters.push(resolve);
+			this.rejecters.push(reject);
+		});
+	}
+};
+//#endregion
+exports.AsyncQueue = AsyncQueue;
+
+//# sourceMappingURL=queue.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"queue.cjs","names":[],"sources":["../../../../src/client/stream/transport/queue.ts"],"sourcesContent":["import type { QueueResult } from \"./types.js\";\n\nexport class AsyncQueue<T> {\n  private readonly values: T[] = [];\n\n  private readonly waiters: Array<(result: QueueResult<T>) => void> = [];\n\n  private readonly rejecters: Array<(error: Error) => void> = [];\n\n  private closed = false;\n\n  private error: Error | null = null;\n\n  push(value: T): void {\n    if (this.closed) {\n      return;\n    }\n\n    const waiter = this.waiters.shift();\n    this.rejecters.shift();\n    if (waiter) {\n      waiter({ done: false, value });\n      return;\n    }\n\n    this.values.push(value);\n  }\n\n  close(error?: unknown): void {\n    if (this.closed) {\n      return;\n    }\n\n    this.closed = true;\n    this.error =\n      error == null\n        ? null\n        : // oxlint-disable-next-line no-instanceof/no-instanceof\n          error instanceof Error\n          ? error\n          : new Error(String(error));\n\n    if (this.error) {\n      for (const rejecter of this.rejecters.splice(0)) {\n        rejecter(this.error);\n      }\n      this.waiters.length = 0;\n      return;\n    }\n\n    for (const waiter of this.waiters.splice(0)) {\n      waiter({ done: true, value: undefined });\n    }\n    this.rejecters.length = 0;\n  }\n\n  async shift(): Promise<QueueResult<T>> {\n    if (this.values.length > 0) {\n      return { done: false, value: this.values.shift() as T };\n    }\n\n    if (this.error) {\n      throw this.error;\n    }\n\n    if (this.closed) {\n      return { done: true, value: undefined };\n    }\n\n    return await new Promise<QueueResult<T>>((resolve, reject) => {\n      this.waiters.push(resolve);\n      this.rejecters.push(reject);\n    });\n  }\n}\n"],"mappings":";AAEA,IAAa,aAAb,MAA2B;CACzB,SAA+B,EAAE;CAEjC,UAAoE,EAAE;CAEtE,YAA4D,EAAE;CAE9D,SAAiB;CAEjB,QAA8B;CAE9B,KAAK,OAAgB;AACnB,MAAI,KAAK,OACP;EAGF,MAAM,SAAS,KAAK,QAAQ,OAAO;AACnC,OAAK,UAAU,OAAO;AACtB,MAAI,QAAQ;AACV,UAAO;IAAE,MAAM;IAAO;IAAO,CAAC;AAC9B;;AAGF,OAAK,OAAO,KAAK,MAAM;;CAGzB,MAAM,OAAuB;AAC3B,MAAI,KAAK,OACP;AAGF,OAAK,SAAS;AACd,OAAK,QACH,SAAS,OACL,OAEA,iBAAiB,QACf,QACA,IAAI,MAAM,OAAO,MAAM,CAAC;AAEhC,MAAI,KAAK,OAAO;AACd,QAAK,MAAM,YAAY,KAAK,UAAU,OAAO,EAAE,CAC7C,UAAS,KAAK,MAAM;AAEtB,QAAK,QAAQ,SAAS;AACtB;;AAGF,OAAK,MAAM,UAAU,KAAK,QAAQ,OAAO,EAAE,CACzC,QAAO;GAAE,MAAM;GAAM,OAAO,KAAA;GAAW,CAAC;AAE1C,OAAK,UAAU,SAAS;;CAG1B,MAAM,QAAiC;AACrC,MAAI,KAAK,OAAO,SAAS,EACvB,QAAO;GAAE,MAAM;GAAO,OAAO,KAAK,OAAO,OAAO;GAAO;AAGzD,MAAI,KAAK,MACP,OAAM,KAAK;AAGb,MAAI,KAAK,OACP,QAAO;GAAE,MAAM;GAAM,OAAO,KAAA;GAAW;AAGzC,SAAO,MAAM,IAAI,SAAyB,SAAS,WAAW;AAC5D,QAAK,QAAQ,KAAK,QAAQ;AAC1B,QAAK,UAAU,KAAK,OAAO;IAC3B"}

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

@@ -0,0 +1,55 @@
+//#region src/client/stream/transport/queue.ts
+var AsyncQueue = class {
+	values = [];
+	waiters = [];
+	rejecters = [];
+	closed = false;
+	error = null;
+	push(value) {
+		if (this.closed) return;
+		const waiter = this.waiters.shift();
+		this.rejecters.shift();
+		if (waiter) {
+			waiter({
+				done: false,
+				value
+			});
+			return;
+		}
+		this.values.push(value);
+	}
+	close(error) {
+		if (this.closed) return;
+		this.closed = true;
+		this.error = error == null ? null : error instanceof Error ? error : new Error(String(error));
+		if (this.error) {
+			for (const rejecter of this.rejecters.splice(0)) rejecter(this.error);
+			this.waiters.length = 0;
+			return;
+		}
+		for (const waiter of this.waiters.splice(0)) waiter({
+			done: true,
+			value: void 0
+		});
+		this.rejecters.length = 0;
+	}
+	async shift() {
+		if (this.values.length > 0) return {
+			done: false,
+			value: this.values.shift()
+		};
+		if (this.error) throw this.error;
+		if (this.closed) return {
+			done: true,
+			value: void 0
+		};
+		return await new Promise((resolve, reject) => {
+			this.waiters.push(resolve);
+			this.rejecters.push(reject);
+		});
+	}
+};
+//#endregion
+export { AsyncQueue };
+
+//# sourceMappingURL=queue.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"queue.js","names":[],"sources":["../../../../src/client/stream/transport/queue.ts"],"sourcesContent":["import type { QueueResult } from \"./types.js\";\n\nexport class AsyncQueue<T> {\n  private readonly values: T[] = [];\n\n  private readonly waiters: Array<(result: QueueResult<T>) => void> = [];\n\n  private readonly rejecters: Array<(error: Error) => void> = [];\n\n  private closed = false;\n\n  private error: Error | null = null;\n\n  push(value: T): void {\n    if (this.closed) {\n      return;\n    }\n\n    const waiter = this.waiters.shift();\n    this.rejecters.shift();\n    if (waiter) {\n      waiter({ done: false, value });\n      return;\n    }\n\n    this.values.push(value);\n  }\n\n  close(error?: unknown): void {\n    if (this.closed) {\n      return;\n    }\n\n    this.closed = true;\n    this.error =\n      error == null\n        ? null\n        : // oxlint-disable-next-line no-instanceof/no-instanceof\n          error instanceof Error\n          ? error\n          : new Error(String(error));\n\n    if (this.error) {\n      for (const rejecter of this.rejecters.splice(0)) {\n        rejecter(this.error);\n      }\n      this.waiters.length = 0;\n      return;\n    }\n\n    for (const waiter of this.waiters.splice(0)) {\n      waiter({ done: true, value: undefined });\n    }\n    this.rejecters.length = 0;\n  }\n\n  async shift(): Promise<QueueResult<T>> {\n    if (this.values.length > 0) {\n      return { done: false, value: this.values.shift() as T };\n    }\n\n    if (this.error) {\n      throw this.error;\n    }\n\n    if (this.closed) {\n      return { done: true, value: undefined };\n    }\n\n    return await new Promise<QueueResult<T>>((resolve, reject) => {\n      this.waiters.push(resolve);\n      this.rejecters.push(reject);\n    });\n  }\n}\n"],"mappings":";AAEA,IAAa,aAAb,MAA2B;CACzB,SAA+B,EAAE;CAEjC,UAAoE,EAAE;CAEtE,YAA4D,EAAE;CAE9D,SAAiB;CAEjB,QAA8B;CAE9B,KAAK,OAAgB;AACnB,MAAI,KAAK,OACP;EAGF,MAAM,SAAS,KAAK,QAAQ,OAAO;AACnC,OAAK,UAAU,OAAO;AACtB,MAAI,QAAQ;AACV,UAAO;IAAE,MAAM;IAAO;IAAO,CAAC;AAC9B;;AAGF,OAAK,OAAO,KAAK,MAAM;;CAGzB,MAAM,OAAuB;AAC3B,MAAI,KAAK,OACP;AAGF,OAAK,SAAS;AACd,OAAK,QACH,SAAS,OACL,OAEA,iBAAiB,QACf,QACA,IAAI,MAAM,OAAO,MAAM,CAAC;AAEhC,MAAI,KAAK,OAAO;AACd,QAAK,MAAM,YAAY,KAAK,UAAU,OAAO,EAAE,CAC7C,UAAS,KAAK,MAAM;AAEtB,QAAK,QAAQ,SAAS;AACtB;;AAGF,OAAK,MAAM,UAAU,KAAK,QAAQ,OAAO,EAAE,CACzC,QAAO;GAAE,MAAM;GAAM,OAAO,KAAA;GAAW,CAAC;AAE1C,OAAK,UAAU,SAAS;;CAG1B,MAAM,QAAiC;AACrC,MAAI,KAAK,OAAO,SAAS,EACvB,QAAO;GAAE,MAAM;GAAO,OAAO,KAAK,OAAO,OAAO;GAAO;AAGzD,MAAI,KAAK,MACP,OAAM,KAAK;AAGb,MAAI,KAAK,OACP,QAAO;GAAE,MAAM;GAAM,OAAO,KAAA;GAAW;AAGzC,SAAO,MAAM,IAAI,SAAyB,SAAS,WAAW;AAC5D,QAAK,QAAQ,KAAK,QAAQ;AAC1B,QAAK,UAAU,KAAK,OAAO;IAC3B"}

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

@@ -0,0 +1,79 @@
+//#region src/client/stream/transport/stream.ts
+var IterableReadableStream = class IterableReadableStream extends ReadableStream {
+	reader;
+	ensureReader() {
+		if (!this.reader) this.reader = this.getReader();
+	}
+	async next() {
+		this.ensureReader();
+		try {
+			const result = await this.reader.read();
+			if (result.done) {
+				this.reader.releaseLock();
+				return {
+					done: true,
+					value: void 0
+				};
+			}
+			return {
+				done: false,
+				value: result.value
+			};
+		} catch (error) {
+			this.reader.releaseLock();
+			throw error;
+		}
+	}
+	async return() {
+		this.ensureReader();
+		if (this.locked) {
+			const cancelPromise = this.reader.cancel();
+			this.reader.releaseLock();
+			await cancelPromise;
+		}
+		return {
+			done: true,
+			value: void 0
+		};
+	}
+	async throw(error) {
+		this.ensureReader();
+		if (this.locked) {
+			const cancelPromise = this.reader.cancel();
+			this.reader.releaseLock();
+			await cancelPromise;
+		}
+		throw error;
+	}
+	async [Symbol.asyncDispose]() {
+		await this.return();
+	}
+	[Symbol.asyncIterator]() {
+		return this;
+	}
+	static fromReadableStream(stream) {
+		const reader = stream.getReader();
+		return new IterableReadableStream({
+			start(controller) {
+				return pump();
+				function pump() {
+					return reader.read().then(({ done, value }) => {
+						if (done) {
+							controller.close();
+							return;
+						}
+						controller.enqueue(value);
+						return pump();
+					});
+				}
+			},
+			cancel() {
+				reader.releaseLock();
+			}
+		});
+	}
+};
+//#endregion
+exports.IterableReadableStream = IterableReadableStream;
+
+//# sourceMappingURL=stream.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stream.cjs","names":[],"sources":["../../../../src/client/stream/transport/stream.ts"],"sourcesContent":["export class IterableReadableStream<T>\n  extends ReadableStream<T>\n  implements AsyncIterable<T>\n{\n  public reader!: ReadableStreamDefaultReader<T>;\n\n  ensureReader() {\n    if (!this.reader) {\n      this.reader = this.getReader();\n    }\n  }\n\n  async next(): Promise<IteratorResult<T>> {\n    this.ensureReader();\n    try {\n      const result = await this.reader.read();\n      if (result.done) {\n        this.reader.releaseLock();\n        return {\n          done: true,\n          value: undefined,\n        };\n      }\n\n      return {\n        done: false,\n        value: result.value,\n      };\n    } catch (error) {\n      this.reader.releaseLock();\n      throw error;\n    }\n  }\n\n  async return(): Promise<IteratorResult<T>> {\n    this.ensureReader();\n    if (this.locked) {\n      const cancelPromise = this.reader.cancel();\n      this.reader.releaseLock();\n      await cancelPromise;\n    }\n    return { done: true, value: undefined };\n  }\n\n  async throw(error: unknown): Promise<IteratorResult<T>> {\n    this.ensureReader();\n    if (this.locked) {\n      const cancelPromise = this.reader.cancel();\n      this.reader.releaseLock();\n      await cancelPromise;\n    }\n    throw error;\n  }\n\n  // eslint-disable-next-line @typescript-eslint/ban-ts-comment\n  // @ts-ignore Not present in Node 18 types, required in latest Node 22\n  async [Symbol.asyncDispose]() {\n    await this.return();\n  }\n\n  [Symbol.asyncIterator]() {\n    return this;\n  }\n\n  static fromReadableStream<T>(stream: ReadableStream<T>) {\n    const reader = stream.getReader();\n    return new IterableReadableStream<T>({\n      start(controller) {\n        return pump();\n\n        function pump(): Promise<T | undefined> {\n          return reader.read().then(({ done, value }) => {\n            if (done) {\n              controller.close();\n              return;\n            }\n            controller.enqueue(value);\n            return pump();\n          });\n        }\n      },\n      cancel() {\n        reader.releaseLock();\n      },\n    });\n  }\n}\n"],"mappings":";AAAA,IAAa,yBAAb,MAAa,+BACH,eAEV;CACE;CAEA,eAAe;AACb,MAAI,CAAC,KAAK,OACR,MAAK,SAAS,KAAK,WAAW;;CAIlC,MAAM,OAAmC;AACvC,OAAK,cAAc;AACnB,MAAI;GACF,MAAM,SAAS,MAAM,KAAK,OAAO,MAAM;AACvC,OAAI,OAAO,MAAM;AACf,SAAK,OAAO,aAAa;AACzB,WAAO;KACL,MAAM;KACN,OAAO,KAAA;KACR;;AAGH,UAAO;IACL,MAAM;IACN,OAAO,OAAO;IACf;WACM,OAAO;AACd,QAAK,OAAO,aAAa;AACzB,SAAM;;;CAIV,MAAM,SAAqC;AACzC,OAAK,cAAc;AACnB,MAAI,KAAK,QAAQ;GACf,MAAM,gBAAgB,KAAK,OAAO,QAAQ;AAC1C,QAAK,OAAO,aAAa;AACzB,SAAM;;AAER,SAAO;GAAE,MAAM;GAAM,OAAO,KAAA;GAAW;;CAGzC,MAAM,MAAM,OAA4C;AACtD,OAAK,cAAc;AACnB,MAAI,KAAK,QAAQ;GACf,MAAM,gBAAgB,KAAK,OAAO,QAAQ;AAC1C,QAAK,OAAO,aAAa;AACzB,SAAM;;AAER,QAAM;;CAKR,OAAO,OAAO,gBAAgB;AAC5B,QAAM,KAAK,QAAQ;;CAGrB,CAAC,OAAO,iBAAiB;AACvB,SAAO;;CAGT,OAAO,mBAAsB,QAA2B;EACtD,MAAM,SAAS,OAAO,WAAW;AACjC,SAAO,IAAI,uBAA0B;GACnC,MAAM,YAAY;AAChB,WAAO,MAAM;IAEb,SAAS,OAA+B;AACtC,YAAO,OAAO,MAAM,CAAC,MAAM,EAAE,MAAM,YAAY;AAC7C,UAAI,MAAM;AACR,kBAAW,OAAO;AAClB;;AAEF,iBAAW,QAAQ,MAAM;AACzB,aAAO,MAAM;OACb;;;GAGN,SAAS;AACP,WAAO,aAAa;;GAEvB,CAAC"}

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

@@ -0,0 +1,79 @@
+//#region src/client/stream/transport/stream.ts
+var IterableReadableStream = class IterableReadableStream extends ReadableStream {
+	reader;
+	ensureReader() {
+		if (!this.reader) this.reader = this.getReader();
+	}
+	async next() {
+		this.ensureReader();
+		try {
+			const result = await this.reader.read();
+			if (result.done) {
+				this.reader.releaseLock();
+				return {
+					done: true,
+					value: void 0
+				};
+			}
+			return {
+				done: false,
+				value: result.value
+			};
+		} catch (error) {
+			this.reader.releaseLock();
+			throw error;
+		}
+	}
+	async return() {
+		this.ensureReader();
+		if (this.locked) {
+			const cancelPromise = this.reader.cancel();
+			this.reader.releaseLock();
+			await cancelPromise;
+		}
+		return {
+			done: true,
+			value: void 0
+		};
+	}
+	async throw(error) {
+		this.ensureReader();
+		if (this.locked) {
+			const cancelPromise = this.reader.cancel();
+			this.reader.releaseLock();
+			await cancelPromise;
+		}
+		throw error;
+	}
+	async [Symbol.asyncDispose]() {
+		await this.return();
+	}
+	[Symbol.asyncIterator]() {
+		return this;
+	}
+	static fromReadableStream(stream) {
+		const reader = stream.getReader();
+		return new IterableReadableStream({
+			start(controller) {
+				return pump();
+				function pump() {
+					return reader.read().then(({ done, value }) => {
+						if (done) {
+							controller.close();
+							return;
+						}
+						controller.enqueue(value);
+						return pump();
+					});
+				}
+			},
+			cancel() {
+				reader.releaseLock();
+			}
+		});
+	}
+};
+//#endregion
+export { IterableReadableStream };
+
+//# sourceMappingURL=stream.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stream.js","names":[],"sources":["../../../../src/client/stream/transport/stream.ts"],"sourcesContent":["export class IterableReadableStream<T>\n  extends ReadableStream<T>\n  implements AsyncIterable<T>\n{\n  public reader!: ReadableStreamDefaultReader<T>;\n\n  ensureReader() {\n    if (!this.reader) {\n      this.reader = this.getReader();\n    }\n  }\n\n  async next(): Promise<IteratorResult<T>> {\n    this.ensureReader();\n    try {\n      const result = await this.reader.read();\n      if (result.done) {\n        this.reader.releaseLock();\n        return {\n          done: true,\n          value: undefined,\n        };\n      }\n\n      return {\n        done: false,\n        value: result.value,\n      };\n    } catch (error) {\n      this.reader.releaseLock();\n      throw error;\n    }\n  }\n\n  async return(): Promise<IteratorResult<T>> {\n    this.ensureReader();\n    if (this.locked) {\n      const cancelPromise = this.reader.cancel();\n      this.reader.releaseLock();\n      await cancelPromise;\n    }\n    return { done: true, value: undefined };\n  }\n\n  async throw(error: unknown): Promise<IteratorResult<T>> {\n    this.ensureReader();\n    if (this.locked) {\n      const cancelPromise = this.reader.cancel();\n      this.reader.releaseLock();\n      await cancelPromise;\n    }\n    throw error;\n  }\n\n  // eslint-disable-next-line @typescript-eslint/ban-ts-comment\n  // @ts-ignore Not present in Node 18 types, required in latest Node 22\n  async [Symbol.asyncDispose]() {\n    await this.return();\n  }\n\n  [Symbol.asyncIterator]() {\n    return this;\n  }\n\n  static fromReadableStream<T>(stream: ReadableStream<T>) {\n    const reader = stream.getReader();\n    return new IterableReadableStream<T>({\n      start(controller) {\n        return pump();\n\n        function pump(): Promise<T | undefined> {\n          return reader.read().then(({ done, value }) => {\n            if (done) {\n              controller.close();\n              return;\n            }\n            controller.enqueue(value);\n            return pump();\n          });\n        }\n      },\n      cancel() {\n        reader.releaseLock();\n      },\n    });\n  }\n}\n"],"mappings":";AAAA,IAAa,yBAAb,MAAa,+BACH,eAEV;CACE;CAEA,eAAe;AACb,MAAI,CAAC,KAAK,OACR,MAAK,SAAS,KAAK,WAAW;;CAIlC,MAAM,OAAmC;AACvC,OAAK,cAAc;AACnB,MAAI;GACF,MAAM,SAAS,MAAM,KAAK,OAAO,MAAM;AACvC,OAAI,OAAO,MAAM;AACf,SAAK,OAAO,aAAa;AACzB,WAAO;KACL,MAAM;KACN,OAAO,KAAA;KACR;;AAGH,UAAO;IACL,MAAM;IACN,OAAO,OAAO;IACf;WACM,OAAO;AACd,QAAK,OAAO,aAAa;AACzB,SAAM;;;CAIV,MAAM,SAAqC;AACzC,OAAK,cAAc;AACnB,MAAI,KAAK,QAAQ;GACf,MAAM,gBAAgB,KAAK,OAAO,QAAQ;AAC1C,QAAK,OAAO,aAAa;AACzB,SAAM;;AAER,SAAO;GAAE,MAAM;GAAM,OAAO,KAAA;GAAW;;CAGzC,MAAM,MAAM,OAA4C;AACtD,OAAK,cAAc;AACnB,MAAI,KAAK,QAAQ;GACf,MAAM,gBAAgB,KAAK,OAAO,QAAQ;AAC1C,QAAK,OAAO,aAAa;AACzB,SAAM;;AAER,QAAM;;CAKR,OAAO,OAAO,gBAAgB;AAC5B,QAAM,KAAK,QAAQ;;CAGrB,CAAC,OAAO,iBAAiB;AACvB,SAAO;;CAGT,OAAO,mBAAsB,QAA2B;EACtD,MAAM,SAAS,OAAO,WAAW;AACjC,SAAO,IAAI,uBAA0B;GACnC,MAAM,YAAY;AAChB,WAAO,MAAM;IAEb,SAAS,OAA+B;AACtC,YAAO,OAAO,MAAM,CAAC,MAAM,EAAE,MAAM,YAAY;AAC7C,UAAI,MAAM;AACR,kBAAW,OAAO;AAClB;;AAEF,iBAAW,QAAQ,MAAM;AACzB,aAAO,MAAM;OACb;;;GAGN,SAAS;AACP,WAAO,aAAa;;GAEvB,CAAC"}

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

@@ -0,0 +1,29 @@
+import { CommandResponse, ErrorResponse } from "@langchain/protocol";
+
+//#region src/client/stream/transport/types.d.ts
+type ProtocolRequestHook = (url: URL, init: RequestInit) => Promise<RequestInit> | RequestInit;
+interface ProtocolTransportPaths {
+  commands?: string;
+  stream?: string;
+}
+interface ProtocolSseTransportOptions {
+  apiUrl: string;
+  threadId: string;
+  defaultHeaders?: Record<string, HeaderValue>;
+  onRequest?: ProtocolRequestHook;
+  fetch?: typeof fetch;
+  fetchFactory?: () => typeof fetch | Promise<typeof fetch>;
+  paths?: ProtocolTransportPaths;
+}
+interface ProtocolWebSocketTransportOptions {
+  apiUrl: string;
+  threadId: string;
+  defaultHeaders?: Record<string, HeaderValue>;
+  onRequest?: ProtocolRequestHook;
+  webSocketFactory?: (url: string) => WebSocket;
+  paths?: Pick<ProtocolTransportPaths, "stream">;
+}
+type HeaderValue = string | undefined | null;
+//#endregion
+export { HeaderValue, ProtocolRequestHook, ProtocolSseTransportOptions, ProtocolTransportPaths, ProtocolWebSocketTransportOptions };
+//# sourceMappingURL=types.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.cts","names":[],"sources":["../../../../src/client/stream/transport/types.ts"],"mappings":";;;KAEY,mBAAA,IACV,GAAA,EAAK,GAAA,EACL,IAAA,EAAM,WAAA,KACH,OAAA,CAAQ,WAAA,IAAe,WAAA;AAAA,UAEX,sBAAA;EACf,QAAA;EACA,MAAA;AAAA;AAAA,UAGe,2BAAA;EACf,MAAA;EACA,QAAA;EACA,cAAA,GAAiB,MAAA,SAAe,WAAA;EAChC,SAAA,GAAY,mBAAA;EACZ,KAAA,UAAe,KAAA;EACf,YAAA,gBAA4B,KAAA,GAAQ,OAAA,QAAe,KAAA;EACnD,KAAA,GAAQ,sBAAA;AAAA;AAAA,UAGO,iCAAA;EACf,MAAA;EACA,QAAA;EACA,cAAA,GAAiB,MAAA,SAAe,WAAA;EAChC,SAAA,GAAY,mBAAA;EACZ,gBAAA,IAAoB,GAAA,aAAgB,SAAA;EACpC,KAAA,GAAQ,IAAA,CAAK,sBAAA;AAAA;AAAA,KAGH,WAAA"}

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

@@ -0,0 +1,29 @@
+import { CommandResponse, ErrorResponse } from "@langchain/protocol";
+
+//#region src/client/stream/transport/types.d.ts
+type ProtocolRequestHook = (url: URL, init: RequestInit) => Promise<RequestInit> | RequestInit;
+interface ProtocolTransportPaths {
+  commands?: string;
+  stream?: string;
+}
+interface ProtocolSseTransportOptions {
+  apiUrl: string;
+  threadId: string;
+  defaultHeaders?: Record<string, HeaderValue>;
+  onRequest?: ProtocolRequestHook;
+  fetch?: typeof fetch;
+  fetchFactory?: () => typeof fetch | Promise<typeof fetch>;
+  paths?: ProtocolTransportPaths;
+}
+interface ProtocolWebSocketTransportOptions {
+  apiUrl: string;
+  threadId: string;
+  defaultHeaders?: Record<string, HeaderValue>;
+  onRequest?: ProtocolRequestHook;
+  webSocketFactory?: (url: string) => WebSocket;
+  paths?: Pick<ProtocolTransportPaths, "stream">;
+}
+type HeaderValue = string | undefined | null;
+//#endregion
+export { HeaderValue, ProtocolRequestHook, ProtocolSseTransportOptions, ProtocolTransportPaths, ProtocolWebSocketTransportOptions };
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","names":[],"sources":["../../../../src/client/stream/transport/types.ts"],"mappings":";;;KAEY,mBAAA,IACV,GAAA,EAAK,GAAA,EACL,IAAA,EAAM,WAAA,KACH,OAAA,CAAQ,WAAA,IAAe,WAAA;AAAA,UAEX,sBAAA;EACf,QAAA;EACA,MAAA;AAAA;AAAA,UAGe,2BAAA;EACf,MAAA;EACA,QAAA;EACA,cAAA,GAAiB,MAAA,SAAe,WAAA;EAChC,SAAA,GAAY,mBAAA;EACZ,KAAA,UAAe,KAAA;EACf,YAAA,gBAA4B,KAAA,GAAQ,OAAA,QAAe,KAAA;EACnD,KAAA,GAAQ,sBAAA;AAAA;AAAA,UAGO,iCAAA;EACf,MAAA;EACA,QAAA;EACA,cAAA,GAAiB,MAAA,SAAe,WAAA;EAChC,SAAA,GAAY,mBAAA;EACZ,gBAAA,IAAoB,GAAA,aAAgB,SAAA;EACpC,KAAA,GAAQ,IAAA,CAAK,sBAAA;AAAA;AAAA,KAGH,WAAA"}

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

@@ -0,0 +1,45 @@
+//#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
+exports.hasHeaders = hasHeaders;
+exports.isProtocolResponse = isProtocolResponse;
+exports.isRecord = isRecord;
+exports.mergeHeaders = mergeHeaders;
+exports.toAbsoluteUrl = toAbsoluteUrl;
+exports.toError = toError;
+exports.toWebSocketUrl = toWebSocketUrl;
+
+//# sourceMappingURL=utils.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.cjs","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"}