@langchain/langgraph-sdk 1.8.9 → 1.9.0

package/dist/client/stream/transport/agent-server.js

@@ -0,0 +1,45 @@
+import { ProtocolSseTransportAdapter } from "./http.js";
+import { ProtocolWebSocketTransportAdapter } from "./websocket.js";
+//#region src/client/stream/transport/agent-server.ts
+var HttpAgentServerAdapter = class {
+	threadId;
+	#delegate;
+	constructor(options) {
+		this.threadId = options.threadId;
+		this.#delegate = options.webSocketFactory != null ? new ProtocolWebSocketTransportAdapter({
+			apiUrl: options.apiUrl,
+			threadId: options.threadId,
+			defaultHeaders: options.defaultHeaders,
+			onRequest: options.onRequest,
+			paths: options.paths,
+			webSocketFactory: options.webSocketFactory
+		}) : new ProtocolSseTransportAdapter({
+			apiUrl: options.apiUrl,
+			threadId: options.threadId,
+			defaultHeaders: options.defaultHeaders,
+			onRequest: options.onRequest,
+			fetch: options.fetch,
+			paths: options.paths
+		});
+	}
+	open() {
+		return this.#delegate.open();
+	}
+	send(command) {
+		return this.#delegate.send(command);
+	}
+	events() {
+		return this.#delegate.events();
+	}
+	openEventStream(params) {
+		if (this.#delegate.openEventStream == null) throw new Error("HttpAgentServerAdapter delegate does not support openEventStream (WebSocket path).");
+		return this.#delegate.openEventStream(params);
+	}
+	close() {
+		return this.#delegate.close();
+	}
+};
+//#endregion
+export { HttpAgentServerAdapter };
+
+//# sourceMappingURL=agent-server.js.map

package/dist/client/stream/transport/agent-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-server.js","names":["#delegate"],"sources":["../../../../src/client/stream/transport/agent-server.ts"],"sourcesContent":["/**\n * Stock `AgentServerAdapter` implementation for \"point `useStream` at a\n * single HTTP endpoint that speaks the v2 protocol\" deployments.\n *\n * Internally delegates to the appropriate built-in transport:\n *  - `new HttpAgentServerAdapter({ apiUrl, threadId })`      → SSE\n *  - `new HttpAgentServerAdapter({ apiUrl, threadId, webSocketFactory })`\n *    → WebSocket\n *\n * Keeps the user-facing import surface small: callers only ever import\n * `HttpAgentServerAdapter` from `@langchain/langgraph-sdk` instead of\n * knowing the two wire-specific class names. The class is deliberately\n * thin — it forwards every method on {@link AgentServerAdapter} to the\n * delegate it picked at construction time.\n *\n * See `plan-custom-transport.md` §4.3 for motivation.\n */\nimport type {\n  AgentServerAdapter,\n  EventStreamHandle,\n  TransportAdapter,\n} from \"../transport.js\";\nimport type {\n  Command,\n  CommandResponse,\n  ErrorResponse,\n  Message,\n  SubscribeParams,\n} from \"@langchain/protocol\";\nimport { ProtocolSseTransportAdapter } from \"./http.js\";\nimport { ProtocolWebSocketTransportAdapter } from \"./websocket.js\";\nimport type {\n  HeaderValue,\n  ProtocolRequestHook,\n  ProtocolTransportPaths,\n} from \"./types.js\";\n\nexport interface HttpAgentServerAdapterOptions {\n  apiUrl: string;\n  threadId: string;\n  /** Auth / tenant / diagnostic headers applied to every request. */\n  defaultHeaders?: Record<string, HeaderValue>;\n  /** Per-request hook for last-mile header mutation. */\n  onRequest?: ProtocolRequestHook;\n  /** Override the default `/v2/threads/:threadId/...` protocol paths. */\n  paths?: ProtocolTransportPaths;\n  /**\n   * Optional `fetch` override, forwarded to the SSE transport. Useful\n   * for auth proxies, Next.js route handlers, or tests with injected\n   * mocks. Ignored when `webSocketFactory` is also supplied.\n   */\n  fetch?: typeof fetch;\n  /**\n   * Optional WebSocket factory. Supplying it flips the adapter into\n   * WebSocket mode — SSE is bypassed entirely.\n   */\n  webSocketFactory?: (url: string) => WebSocket;\n}\n\nexport class HttpAgentServerAdapter implements AgentServerAdapter {\n  readonly threadId: string;\n\n  readonly #delegate: TransportAdapter;\n\n  constructor(options: HttpAgentServerAdapterOptions) {\n    this.threadId = options.threadId;\n    this.#delegate =\n      options.webSocketFactory != null\n        ? new ProtocolWebSocketTransportAdapter({\n            apiUrl: options.apiUrl,\n            threadId: options.threadId,\n            defaultHeaders: options.defaultHeaders,\n            onRequest: options.onRequest,\n            paths: options.paths,\n            webSocketFactory: options.webSocketFactory,\n          })\n        : new ProtocolSseTransportAdapter({\n            apiUrl: options.apiUrl,\n            threadId: options.threadId,\n            defaultHeaders: options.defaultHeaders,\n            onRequest: options.onRequest,\n            fetch: options.fetch,\n            paths: options.paths,\n          });\n  }\n\n  open(): Promise<void> {\n    return this.#delegate.open();\n  }\n\n  send(command: Command): Promise<CommandResponse | ErrorResponse | void> {\n    return this.#delegate.send(command);\n  }\n\n  events(): AsyncIterable<Message> {\n    return this.#delegate.events();\n  }\n\n  openEventStream(params: SubscribeParams): EventStreamHandle {\n    if (this.#delegate.openEventStream == null) {\n      throw new Error(\n        \"HttpAgentServerAdapter delegate does not support openEventStream (WebSocket path).\"\n      );\n    }\n    return this.#delegate.openEventStream(params);\n  }\n\n  close(): Promise<void> {\n    return this.#delegate.close();\n  }\n}\n"],"mappings":";;;AA2DA,IAAa,yBAAb,MAAkE;CAChE;CAEA;CAEA,YAAY,SAAwC;AAClD,OAAK,WAAW,QAAQ;AACxB,QAAA,WACE,QAAQ,oBAAoB,OACxB,IAAI,kCAAkC;GACpC,QAAQ,QAAQ;GAChB,UAAU,QAAQ;GAClB,gBAAgB,QAAQ;GACxB,WAAW,QAAQ;GACnB,OAAO,QAAQ;GACf,kBAAkB,QAAQ;GAC3B,CAAC,GACF,IAAI,4BAA4B;GAC9B,QAAQ,QAAQ;GAChB,UAAU,QAAQ;GAClB,gBAAgB,QAAQ;GACxB,WAAW,QAAQ;GACnB,OAAO,QAAQ;GACf,OAAO,QAAQ;GAChB,CAAC;;CAGV,OAAsB;AACpB,SAAO,MAAA,SAAe,MAAM;;CAG9B,KAAK,SAAmE;AACtE,SAAO,MAAA,SAAe,KAAK,QAAQ;;CAGrC,SAAiC;AAC/B,SAAO,MAAA,SAAe,QAAQ;;CAGhC,gBAAgB,QAA4C;AAC1D,MAAI,MAAA,SAAe,mBAAmB,KACpC,OAAM,IAAI,MACR,qFACD;AAEH,SAAO,MAAA,SAAe,gBAAgB,OAAO;;CAG/C,QAAuB;AACrB,SAAO,MAAA,SAAe,OAAO"}

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

@@ -0,0 +1,10 @@
+"\r".charCodeAt(0);
+"\n".charCodeAt(0);
+"\0".charCodeAt(0);
+":".charCodeAt(0);
+" ".charCodeAt(0);
+const TRAILING_NEWLINE = [13, 10];
+//#endregion
+exports.TRAILING_NEWLINE = TRAILING_NEWLINE;
+
+//# sourceMappingURL=constants.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.cjs","names":[],"sources":["../../../../src/client/stream/transport/constants.ts"],"sourcesContent":["export const CR = \"\\r\".charCodeAt(0);\nexport const LF = \"\\n\".charCodeAt(0);\nexport const NULL = \"\\0\".charCodeAt(0);\nexport const COLON = \":\".charCodeAt(0);\nexport const SPACE = \" \".charCodeAt(0);\nexport const TRAILING_NEWLINE = [CR, LF];\n"],"mappings":"AAAkB,KAAK,WAAW,EAAE;AAClB,KAAK,WAAW,EAAE;AAChB,KAAK,WAAW,EAAE;AACjB,IAAI,WAAW,EAAE;AACjB,IAAI,WAAW,EAAE;AACtC,MAAa,mBAAmB,CAAA,IAAA,GAAQ"}

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

@@ -0,0 +1,10 @@
+"\r".charCodeAt(0);
+"\n".charCodeAt(0);
+"\0".charCodeAt(0);
+":".charCodeAt(0);
+" ".charCodeAt(0);
+const TRAILING_NEWLINE = [13, 10];
+//#endregion
+export { TRAILING_NEWLINE };
+
+//# sourceMappingURL=constants.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","names":[],"sources":["../../../../src/client/stream/transport/constants.ts"],"sourcesContent":["export const CR = \"\\r\".charCodeAt(0);\nexport const LF = \"\\n\".charCodeAt(0);\nexport const NULL = \"\\0\".charCodeAt(0);\nexport const COLON = \":\".charCodeAt(0);\nexport const SPACE = \" \".charCodeAt(0);\nexport const TRAILING_NEWLINE = [CR, LF];\n"],"mappings":"AAAkB,KAAK,WAAW,EAAE;AAClB,KAAK,WAAW,EAAE;AAChB,KAAK,WAAW,EAAE;AACjB,IAAI,WAAW,EAAE;AACjB,IAAI,WAAW,EAAE;AACtC,MAAa,mBAAmB,CAAA,IAAA,GAAQ"}

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

@@ -0,0 +1,115 @@
+const require_constants = require("./constants.cjs");
+//#region src/client/stream/transport/decoder.ts
+function joinArrays(data) {
+	const totalLength = data.reduce((acc, curr) => acc + curr.length, 0);
+	const merged = new Uint8Array(totalLength);
+	let offset = 0;
+	for (const chunk of data) {
+		merged.set(chunk, offset);
+		offset += chunk.length;
+	}
+	return merged;
+}
+function decodeArraysToJson(decoder, data) {
+	return JSON.parse(decoder.decode(joinArrays(data)));
+}
+function BytesLineDecoder() {
+	let buffer = [];
+	let trailingCr = false;
+	return new TransformStream({
+		start() {
+			buffer = [];
+			trailingCr = false;
+		},
+		transform(chunk, controller) {
+			let text = chunk;
+			if (trailingCr) {
+				text = joinArrays([[13], text]);
+				trailingCr = false;
+			}
+			if (text.length > 0 && text.at(-1) === 13) {
+				trailingCr = true;
+				text = text.subarray(0, -1);
+			}
+			if (!text.length) return;
+			const trailingNewline = require_constants.TRAILING_NEWLINE.includes(text.at(-1));
+			const lastIdx = text.length - 1;
+			const { lines } = text.reduce((acc, cur, idx) => {
+				if (acc.from > idx) return acc;
+				if (cur === 13 || cur === 10) {
+					acc.lines.push(text.subarray(acc.from, idx));
+					if (cur === 13 && text[idx + 1] === 10) acc.from = idx + 2;
+					else acc.from = idx + 1;
+				}
+				if (idx === lastIdx && acc.from <= lastIdx) acc.lines.push(text.subarray(acc.from));
+				return acc;
+			}, {
+				lines: [],
+				from: 0
+			});
+			if (lines.length === 1 && !trailingNewline) {
+				buffer.push(lines[0]);
+				return;
+			}
+			if (buffer.length) {
+				buffer.push(lines[0]);
+				lines[0] = joinArrays(buffer);
+				buffer = [];
+			}
+			if (!trailingNewline && lines.length) buffer = [lines.pop()];
+			for (const line of lines) controller.enqueue(line);
+		},
+		flush(controller) {
+			if (buffer.length) controller.enqueue(joinArrays(buffer));
+		}
+	});
+}
+function SSEDecoder() {
+	let event = "";
+	let data = [];
+	let lastEventId = "";
+	let retry = null;
+	const decoder = new TextDecoder();
+	return new TransformStream({
+		transform(chunk, controller) {
+			if (!chunk.length) {
+				if (!event && !data.length && !lastEventId && retry == null) return;
+				controller.enqueue({
+					id: lastEventId || void 0,
+					event,
+					data: data.length ? decodeArraysToJson(decoder, data) : null
+				});
+				event = "";
+				data = [];
+				retry = null;
+				return;
+			}
+			if (chunk[0] === 58) return;
+			const sepIdx = chunk.indexOf(58);
+			if (sepIdx === -1) return;
+			const fieldName = decoder.decode(chunk.subarray(0, sepIdx));
+			let value = chunk.subarray(sepIdx + 1);
+			if (value[0] === 32) value = value.subarray(1);
+			if (fieldName === "event") event = decoder.decode(value);
+			else if (fieldName === "data") data.push(value);
+			else if (fieldName === "id") {
+				if (value.indexOf(0) === -1) lastEventId = decoder.decode(value);
+			} else if (fieldName === "retry") {
+				const retryNum = Number.parseInt(decoder.decode(value), 10);
+				if (!Number.isNaN(retryNum)) retry = retryNum;
+			}
+		},
+		flush(controller) {
+			if (event) controller.enqueue({
+				id: lastEventId || void 0,
+				event,
+				data: data.length ? decodeArraysToJson(decoder, data) : null
+			});
+		}
+	});
+}
+//#endregion
+exports.BytesLineDecoder = BytesLineDecoder;
+exports.SSEDecoder = SSEDecoder;
+
+//# sourceMappingURL=decoder.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"decoder.cjs","names":["TRAILING_NEWLINE"],"sources":["../../../../src/client/stream/transport/decoder.ts"],"sourcesContent":["import type { StreamPart } from \"./types.js\";\nimport { CR, LF, NULL, COLON, SPACE, TRAILING_NEWLINE } from \"./constants.js\";\n\nfunction joinArrays(data: ArrayLike<number>[]) {\n  const totalLength = data.reduce((acc, curr) => acc + curr.length, 0);\n  const merged = new Uint8Array(totalLength);\n  let offset = 0;\n  for (const chunk of data) {\n    merged.set(chunk, offset);\n    offset += chunk.length;\n  }\n  return merged;\n}\n\nfunction decodeArraysToJson(decoder: TextDecoder, data: ArrayLike<number>[]) {\n  return JSON.parse(decoder.decode(joinArrays(data)));\n}\n\nexport function BytesLineDecoder() {\n  let buffer: Uint8Array[] = [];\n  let trailingCr = false;\n\n  return new TransformStream<Uint8Array, Uint8Array>({\n    start() {\n      buffer = [];\n      trailingCr = false;\n    },\n\n    transform(chunk, controller) {\n      let text = chunk;\n\n      if (trailingCr) {\n        text = joinArrays([[CR], text]);\n        trailingCr = false;\n      }\n\n      if (text.length > 0 && text.at(-1) === CR) {\n        trailingCr = true;\n        text = text.subarray(0, -1);\n      }\n\n      if (!text.length) {\n        return;\n      }\n      const trailingNewline = TRAILING_NEWLINE.includes(text.at(-1)!);\n\n      const lastIdx = text.length - 1;\n      const { lines } = text.reduce<{ lines: Uint8Array[]; from: number }>(\n        (acc, cur, idx) => {\n          if (acc.from > idx) {\n            return acc;\n          }\n\n          if (cur === CR || cur === LF) {\n            acc.lines.push(text.subarray(acc.from, idx));\n            if (cur === CR && text[idx + 1] === LF) {\n              acc.from = idx + 2;\n            } else {\n              acc.from = idx + 1;\n            }\n          }\n\n          if (idx === lastIdx && acc.from <= lastIdx) {\n            acc.lines.push(text.subarray(acc.from));\n          }\n\n          return acc;\n        },\n        { lines: [], from: 0 }\n      );\n\n      if (lines.length === 1 && !trailingNewline) {\n        buffer.push(lines[0]);\n        return;\n      }\n\n      if (buffer.length) {\n        buffer.push(lines[0]);\n        lines[0] = joinArrays(buffer);\n        buffer = [];\n      }\n\n      if (!trailingNewline && lines.length) {\n        buffer = [lines.pop()!];\n      }\n\n      for (const line of lines) {\n        controller.enqueue(line);\n      }\n    },\n\n    flush(controller) {\n      if (buffer.length) {\n        controller.enqueue(joinArrays(buffer));\n      }\n    },\n  });\n}\n\nexport function SSEDecoder() {\n  let event = \"\";\n  let data: Uint8Array[] = [];\n  let lastEventId = \"\";\n  let retry: number | null = null;\n\n  const decoder = new TextDecoder();\n\n  return new TransformStream<Uint8Array, StreamPart>({\n    transform(chunk, controller) {\n      if (!chunk.length) {\n        if (!event && !data.length && !lastEventId && retry == null) {\n          return;\n        }\n\n        controller.enqueue({\n          id: lastEventId || undefined,\n          event,\n          data: data.length ? decodeArraysToJson(decoder, data) : null,\n        });\n\n        event = \"\";\n        data = [];\n        retry = null;\n        return;\n      }\n\n      if (chunk[0] === COLON) {\n        return;\n      }\n\n      const sepIdx = chunk.indexOf(COLON);\n      if (sepIdx === -1) {\n        return;\n      }\n\n      const fieldName = decoder.decode(chunk.subarray(0, sepIdx));\n      let value = chunk.subarray(sepIdx + 1);\n      if (value[0] === SPACE) {\n        value = value.subarray(1);\n      }\n\n      if (fieldName === \"event\") {\n        event = decoder.decode(value);\n      } else if (fieldName === \"data\") {\n        data.push(value);\n      } else if (fieldName === \"id\") {\n        if (value.indexOf(NULL) === -1) {\n          lastEventId = decoder.decode(value);\n        }\n      } else if (fieldName === \"retry\") {\n        const retryNum = Number.parseInt(decoder.decode(value), 10);\n        if (!Number.isNaN(retryNum)) {\n          retry = retryNum;\n        }\n      }\n    },\n\n    flush(controller) {\n      if (event) {\n        controller.enqueue({\n          id: lastEventId || undefined,\n          event,\n          data: data.length ? decodeArraysToJson(decoder, data) : null,\n        });\n      }\n    },\n  });\n}\n"],"mappings":"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"}

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

@@ -0,0 +1,114 @@
+import { TRAILING_NEWLINE } from "./constants.js";
+//#region src/client/stream/transport/decoder.ts
+function joinArrays(data) {
+	const totalLength = data.reduce((acc, curr) => acc + curr.length, 0);
+	const merged = new Uint8Array(totalLength);
+	let offset = 0;
+	for (const chunk of data) {
+		merged.set(chunk, offset);
+		offset += chunk.length;
+	}
+	return merged;
+}
+function decodeArraysToJson(decoder, data) {
+	return JSON.parse(decoder.decode(joinArrays(data)));
+}
+function BytesLineDecoder() {
+	let buffer = [];
+	let trailingCr = false;
+	return new TransformStream({
+		start() {
+			buffer = [];
+			trailingCr = false;
+		},
+		transform(chunk, controller) {
+			let text = chunk;
+			if (trailingCr) {
+				text = joinArrays([[13], text]);
+				trailingCr = false;
+			}
+			if (text.length > 0 && text.at(-1) === 13) {
+				trailingCr = true;
+				text = text.subarray(0, -1);
+			}
+			if (!text.length) return;
+			const trailingNewline = TRAILING_NEWLINE.includes(text.at(-1));
+			const lastIdx = text.length - 1;
+			const { lines } = text.reduce((acc, cur, idx) => {
+				if (acc.from > idx) return acc;
+				if (cur === 13 || cur === 10) {
+					acc.lines.push(text.subarray(acc.from, idx));
+					if (cur === 13 && text[idx + 1] === 10) acc.from = idx + 2;
+					else acc.from = idx + 1;
+				}
+				if (idx === lastIdx && acc.from <= lastIdx) acc.lines.push(text.subarray(acc.from));
+				return acc;
+			}, {
+				lines: [],
+				from: 0
+			});
+			if (lines.length === 1 && !trailingNewline) {
+				buffer.push(lines[0]);
+				return;
+			}
+			if (buffer.length) {
+				buffer.push(lines[0]);
+				lines[0] = joinArrays(buffer);
+				buffer = [];
+			}
+			if (!trailingNewline && lines.length) buffer = [lines.pop()];
+			for (const line of lines) controller.enqueue(line);
+		},
+		flush(controller) {
+			if (buffer.length) controller.enqueue(joinArrays(buffer));
+		}
+	});
+}
+function SSEDecoder() {
+	let event = "";
+	let data = [];
+	let lastEventId = "";
+	let retry = null;
+	const decoder = new TextDecoder();
+	return new TransformStream({
+		transform(chunk, controller) {
+			if (!chunk.length) {
+				if (!event && !data.length && !lastEventId && retry == null) return;
+				controller.enqueue({
+					id: lastEventId || void 0,
+					event,
+					data: data.length ? decodeArraysToJson(decoder, data) : null
+				});
+				event = "";
+				data = [];
+				retry = null;
+				return;
+			}
+			if (chunk[0] === 58) return;
+			const sepIdx = chunk.indexOf(58);
+			if (sepIdx === -1) return;
+			const fieldName = decoder.decode(chunk.subarray(0, sepIdx));
+			let value = chunk.subarray(sepIdx + 1);
+			if (value[0] === 32) value = value.subarray(1);
+			if (fieldName === "event") event = decoder.decode(value);
+			else if (fieldName === "data") data.push(value);
+			else if (fieldName === "id") {
+				if (value.indexOf(0) === -1) lastEventId = decoder.decode(value);
+			} else if (fieldName === "retry") {
+				const retryNum = Number.parseInt(decoder.decode(value), 10);
+				if (!Number.isNaN(retryNum)) retry = retryNum;
+			}
+		},
+		flush(controller) {
+			if (event) controller.enqueue({
+				id: lastEventId || void 0,
+				event,
+				data: data.length ? decodeArraysToJson(decoder, data) : null
+			});
+		}
+	});
+}
+//#endregion
+export { BytesLineDecoder, SSEDecoder };
+
+//# sourceMappingURL=decoder.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"decoder.js","names":[],"sources":["../../../../src/client/stream/transport/decoder.ts"],"sourcesContent":["import type { StreamPart } from \"./types.js\";\nimport { CR, LF, NULL, COLON, SPACE, TRAILING_NEWLINE } from \"./constants.js\";\n\nfunction joinArrays(data: ArrayLike<number>[]) {\n  const totalLength = data.reduce((acc, curr) => acc + curr.length, 0);\n  const merged = new Uint8Array(totalLength);\n  let offset = 0;\n  for (const chunk of data) {\n    merged.set(chunk, offset);\n    offset += chunk.length;\n  }\n  return merged;\n}\n\nfunction decodeArraysToJson(decoder: TextDecoder, data: ArrayLike<number>[]) {\n  return JSON.parse(decoder.decode(joinArrays(data)));\n}\n\nexport function BytesLineDecoder() {\n  let buffer: Uint8Array[] = [];\n  let trailingCr = false;\n\n  return new TransformStream<Uint8Array, Uint8Array>({\n    start() {\n      buffer = [];\n      trailingCr = false;\n    },\n\n    transform(chunk, controller) {\n      let text = chunk;\n\n      if (trailingCr) {\n        text = joinArrays([[CR], text]);\n        trailingCr = false;\n      }\n\n      if (text.length > 0 && text.at(-1) === CR) {\n        trailingCr = true;\n        text = text.subarray(0, -1);\n      }\n\n      if (!text.length) {\n        return;\n      }\n      const trailingNewline = TRAILING_NEWLINE.includes(text.at(-1)!);\n\n      const lastIdx = text.length - 1;\n      const { lines } = text.reduce<{ lines: Uint8Array[]; from: number }>(\n        (acc, cur, idx) => {\n          if (acc.from > idx) {\n            return acc;\n          }\n\n          if (cur === CR || cur === LF) {\n            acc.lines.push(text.subarray(acc.from, idx));\n            if (cur === CR && text[idx + 1] === LF) {\n              acc.from = idx + 2;\n            } else {\n              acc.from = idx + 1;\n            }\n          }\n\n          if (idx === lastIdx && acc.from <= lastIdx) {\n            acc.lines.push(text.subarray(acc.from));\n          }\n\n          return acc;\n        },\n        { lines: [], from: 0 }\n      );\n\n      if (lines.length === 1 && !trailingNewline) {\n        buffer.push(lines[0]);\n        return;\n      }\n\n      if (buffer.length) {\n        buffer.push(lines[0]);\n        lines[0] = joinArrays(buffer);\n        buffer = [];\n      }\n\n      if (!trailingNewline && lines.length) {\n        buffer = [lines.pop()!];\n      }\n\n      for (const line of lines) {\n        controller.enqueue(line);\n      }\n    },\n\n    flush(controller) {\n      if (buffer.length) {\n        controller.enqueue(joinArrays(buffer));\n      }\n    },\n  });\n}\n\nexport function SSEDecoder() {\n  let event = \"\";\n  let data: Uint8Array[] = [];\n  let lastEventId = \"\";\n  let retry: number | null = null;\n\n  const decoder = new TextDecoder();\n\n  return new TransformStream<Uint8Array, StreamPart>({\n    transform(chunk, controller) {\n      if (!chunk.length) {\n        if (!event && !data.length && !lastEventId && retry == null) {\n          return;\n        }\n\n        controller.enqueue({\n          id: lastEventId || undefined,\n          event,\n          data: data.length ? decodeArraysToJson(decoder, data) : null,\n        });\n\n        event = \"\";\n        data = [];\n        retry = null;\n        return;\n      }\n\n      if (chunk[0] === COLON) {\n        return;\n      }\n\n      const sepIdx = chunk.indexOf(COLON);\n      if (sepIdx === -1) {\n        return;\n      }\n\n      const fieldName = decoder.decode(chunk.subarray(0, sepIdx));\n      let value = chunk.subarray(sepIdx + 1);\n      if (value[0] === SPACE) {\n        value = value.subarray(1);\n      }\n\n      if (fieldName === \"event\") {\n        event = decoder.decode(value);\n      } else if (fieldName === \"data\") {\n        data.push(value);\n      } else if (fieldName === \"id\") {\n        if (value.indexOf(NULL) === -1) {\n          lastEventId = decoder.decode(value);\n        }\n      } else if (fieldName === \"retry\") {\n        const retryNum = Number.parseInt(decoder.decode(value), 10);\n        if (!Number.isNaN(retryNum)) {\n          retry = retryNum;\n        }\n      }\n    },\n\n    flush(controller) {\n      if (event) {\n        controller.enqueue({\n          id: lastEventId || undefined,\n          event,\n          data: data.length ? decodeArraysToJson(decoder, data) : null,\n        });\n      }\n    },\n  });\n}\n"],"mappings":"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"}

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

@@ -0,0 +1,183 @@
+const require_queue = require("./queue.cjs");
+const require_utils = require("./utils.cjs");
+const require_decoder = require("./decoder.cjs");
+const require_stream = require("./stream.cjs");
+//#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 /v2/threads/:thread_id/stream`.
+*/
+var ProtocolSseTransportAdapter = class {
+	threadId;
+	queue = new require_queue.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 ?? `/v2/threads/${this.threadId}/commands`;
+		this.streamUrl = options.paths?.stream ?? `/v2/threads/${this.threadId}/stream`;
+	}
+	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 (!require_utils.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 require_queue.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(require_decoder.BytesLineDecoder()).pipeThrough(require_decoder.SSEDecoder());
+				const iterable = require_stream.IterableReadableStream.fromReadableStream(stream);
+				for await (const event of iterable) {
+					if (ac.signal.aborted || this.closed) break;
+					if (require_utils.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 = require_utils.toAbsoluteUrl(this.apiUrl, path);
+		let requestInit = {
+			...init,
+			headers: require_utils.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 require_utils.toError(error);
+		}
+	}
+};
+//#endregion
+exports.ProtocolSseTransportAdapter = ProtocolSseTransportAdapter;
+
+//# sourceMappingURL=http.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"http.cjs","names":["AsyncQueue","isProtocolResponse","BytesLineDecoder","SSEDecoder","IterableReadableStream","isRecord","toAbsoluteUrl","mergeHeaders","toError"],"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 /v2/threads/:thread_id/stream`.\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 ?? `/v2/threads/${this.threadId}/commands`;\n    this.streamUrl =\n      options.paths?.stream ?? `/v2/threads/${this.threadId}/stream`;\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":"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"}

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

@@ -0,0 +1,45 @@
+import { EventStreamHandle, TransportAdapter } from "../transport.cjs";
+import { ProtocolSseTransportOptions } from "./types.cjs";
+import { Command, CommandResponse, ErrorResponse, Message, SubscribeParams } from "@langchain/protocol";
+
+//#region src/client/stream/transport/http.d.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 /v2/threads/:thread_id/stream`.
+ */
+declare class ProtocolSseTransportAdapter implements TransportAdapter {
+  readonly threadId: string;
+  private readonly queue;
+  private readonly fetchImpl;
+  private readonly apiUrl;
+  private readonly defaultHeaders;
+  private readonly onRequest?;
+  private readonly fetchFactory?;
+  private readonly commandsUrl;
+  private readonly streamUrl;
+  private readonly sessionAbortController;
+  private readonly eventStreams;
+  private closed;
+  constructor(options: ProtocolSseTransportOptions);
+  private resolveFetch;
+  /**
+   * HTTP/SSE transports have no handshake — connections are made
+   * per-command and per-subscription.
+   */
+  open(): Promise<void>;
+  send(command: Command): Promise<CommandResponse | ErrorResponse | void>;
+  /**
+   * WebSocket-style single event stream.
+   * For the SSE transport this returns a dummy iterable; real event
+   * delivery happens via {@link openEventStream}.
+   */
+  events(): AsyncIterable<Message>;
+  openEventStream(params: SubscribeParams): EventStreamHandle;
+  close(): Promise<void>;
+  private request;
+}
+//#endregion
+export { ProtocolSseTransportAdapter };
+//# sourceMappingURL=http.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.cts","names":[],"sources":["../../../../src/client/stream/transport/http.ts"],"mappings":";;;;;;;AA+BA;;;;cAAa,2BAAA,YAAuC,gBAAA;EAAA,SACzC,QAAA;EAAA,iBAEQ,KAAA;EAAA,iBAEA,SAAA;EAAA,iBAEA,MAAA;EAAA,iBAEA,cAAA;EAAA,iBAEA,SAAA;EAAA,iBAEA,YAAA;EAAA,iBAEA,WAAA;EAAA,iBAEA,SAAA;EAAA,iBAEA,sBAAA;EAAA,iBAEA,YAAA;EAAA,QAET,MAAA;EAER,WAAA,CAAY,OAAA,EAAS,2BAAA;EAAA,QAaP,YAAA;EAnCG;;;;EA8CX,IAAA,CAAA,GAAQ,OAAA;EAIR,IAAA,CACJ,OAAA,EAAS,OAAA,GACR,OAAA,CAAQ,eAAA,GAAkB,aAAA;EAxCZ;;;;;EAgEjB,MAAA,CAAA,GAAU,aAAA,CAAc,OAAA;EAaxB,eAAA,CAAgB,MAAA,EAAQ,eAAA,GAAkB,iBAAA;EAiGpC,KAAA,CAAA,GAAS,OAAA;EAAA,QAWD,OAAA;AAAA"}

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

@@ -0,0 +1,45 @@
+import { EventStreamHandle, TransportAdapter } from "../transport.js";
+import { ProtocolSseTransportOptions } from "./types.js";
+import { Command, CommandResponse, ErrorResponse, Message, SubscribeParams } from "@langchain/protocol";
+
+//#region src/client/stream/transport/http.d.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 /v2/threads/:thread_id/stream`.
+ */
+declare class ProtocolSseTransportAdapter implements TransportAdapter {
+  readonly threadId: string;
+  private readonly queue;
+  private readonly fetchImpl;
+  private readonly apiUrl;
+  private readonly defaultHeaders;
+  private readonly onRequest?;
+  private readonly fetchFactory?;
+  private readonly commandsUrl;
+  private readonly streamUrl;
+  private readonly sessionAbortController;
+  private readonly eventStreams;
+  private closed;
+  constructor(options: ProtocolSseTransportOptions);
+  private resolveFetch;
+  /**
+   * HTTP/SSE transports have no handshake — connections are made
+   * per-command and per-subscription.
+   */
+  open(): Promise<void>;
+  send(command: Command): Promise<CommandResponse | ErrorResponse | void>;
+  /**
+   * WebSocket-style single event stream.
+   * For the SSE transport this returns a dummy iterable; real event
+   * delivery happens via {@link openEventStream}.
+   */
+  events(): AsyncIterable<Message>;
+  openEventStream(params: SubscribeParams): EventStreamHandle;
+  close(): Promise<void>;
+  private request;
+}
+//#endregion
+export { ProtocolSseTransportAdapter };
+//# sourceMappingURL=http.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","names":[],"sources":["../../../../src/client/stream/transport/http.ts"],"mappings":";;;;;;;AA+BA;;;;cAAa,2BAAA,YAAuC,gBAAA;EAAA,SACzC,QAAA;EAAA,iBAEQ,KAAA;EAAA,iBAEA,SAAA;EAAA,iBAEA,MAAA;EAAA,iBAEA,cAAA;EAAA,iBAEA,SAAA;EAAA,iBAEA,YAAA;EAAA,iBAEA,WAAA;EAAA,iBAEA,SAAA;EAAA,iBAEA,sBAAA;EAAA,iBAEA,YAAA;EAAA,QAET,MAAA;EAER,WAAA,CAAY,OAAA,EAAS,2BAAA;EAAA,QAaP,YAAA;EAnCG;;;;EA8CX,IAAA,CAAA,GAAQ,OAAA;EAIR,IAAA,CACJ,OAAA,EAAS,OAAA,GACR,OAAA,CAAQ,eAAA,GAAkB,aAAA;EAxCZ;;;;;EAgEjB,MAAA,CAAA,GAAU,aAAA,CAAc,OAAA;EAaxB,eAAA,CAAgB,MAAA,EAAQ,eAAA,GAAkB,iBAAA;EAiGpC,KAAA,CAAA,GAAS,OAAA;EAAA,QAWD,OAAA;AAAA"}