@langchain/langgraph-sdk 1.9.19 → 1.9.21

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

@@ -2,6 +2,7 @@ import { BytesLineDecoder, SSEDecoder } from "../../../utils/sse.js";
 import { IterableReadableStream } from "../../../utils/stream.js";
 import { AsyncQueue } from "./queue.js";
 import { isProtocolResponse, isRecord, mergeHeaders, toAbsoluteUrl, toError } from "./utils.js";
+import { webSocketReconnectDelayMs } from "./websocket.js";
 //#region src/client/stream/transport/http.ts
 /**
 * Transport adapter that speaks the thread-centric protocol over HTTP
@@ -11,14 +12,19 @@ import { isProtocolResponse, isRecord, mergeHeaders, toAbsoluteUrl, toError } fr
 */
 var ProtocolSseTransportAdapter = class {
 	threadId;
+	apiUrl;
 	queue = new AsyncQueue();
 	fetchImpl;
-	apiUrl;
 	defaultHeaders;
 	onRequest;
 	fetchFactory;
+	asyncCaller;
+	maxReconnectAttempts;
+	onReconnect;
+	reconnectDelayMs;
 	commandsUrl;
 	streamUrl;
+	stateUrl;
 	sessionAbortController = new AbortController();
 	eventStreams = /* @__PURE__ */ new Set();
 	closed = false;
@@ -28,9 +34,37 @@ var ProtocolSseTransportAdapter = class {
 		this.defaultHeaders = options.defaultHeaders ?? {};
 		this.onRequest = options.onRequest;
 		this.fetchFactory = options.fetchFactory;
+		this.asyncCaller = options.asyncCaller;
+		this.maxReconnectAttempts = options.fetch != null ? 0 : options.maxReconnectAttempts ?? 5;
+		this.onReconnect = options.onReconnect;
+		this.reconnectDelayMs = options.reconnectDelayMs ?? webSocketReconnectDelayMs;
 		this.threadId = options.threadId;
 		this.commandsUrl = options.paths?.commands ?? `/threads/${this.threadId}/commands`;
 		this.streamUrl = options.paths?.stream ?? `/threads/${this.threadId}/stream/events`;
+		this.stateUrl = options.paths?.state ?? `/threads/${this.threadId}/state`;
+	}
+	/**
+	* Fetch checkpointed thread state for hydration.
+	*
+	* Uses `GET`, matching `client.threads.getState()` and both LangGraph
+	* Platform and Agent Protocol custom backends (`POST` is reserved for
+	* `updateState`).
+	*/
+	async getState() {
+		const url = toAbsoluteUrl(this.apiUrl, this.stateUrl);
+		let requestInit = {
+			method: "GET",
+			headers: mergeHeaders(this.defaultHeaders, {})
+		};
+		if (this.onRequest) requestInit = await this.onRequest(url, requestInit);
+		const response = await (await this.resolveFetch())(url.toString(), requestInit);
+		if (response.status === 404) return null;
+		if (!response.ok) {
+			const error = toError(/* @__PURE__ */ new Error(`Thread state request failed: ${response.status} ${response.statusText}`));
+			error.status = response.status;
+			throw error;
+		}
+		return await response.json();
 	}
 	async resolveFetch() {
 		if (this.fetchFactory) return await this.fetchFactory();
@@ -83,9 +117,11 @@ var ProtocolSseTransportAdapter = class {
 			resolveReady = resolve;
 			rejectReady = reject;
 		});
-		const since = params.since;
+		let resumeAfterSeq = typeof params.since === "number" ? params.since : void 0;
+		let readySettled = false;
 		const startStream = async () => {
-			try {
+			let attempt = 0;
+			while (!ac.signal.aborted && !this.closed) try {
 				const response = await this.request(streamUrl, {
 					method: "POST",
 					headers: {
@@ -96,11 +132,14 @@ var ProtocolSseTransportAdapter = class {
 						channels: params.channels,
 						...params.namespaces ? { namespaces: params.namespaces } : {},
 						...params.depth != null ? { depth: params.depth } : {},
-						...typeof since === "number" ? { since } : {}
+						...resumeAfterSeq != null ? { since: resumeAfterSeq } : {}
 					}),
 					signal: ac.signal
-				});
-				resolveReady();
+				}, { stream: true });
+				if (!readySettled) {
+					readySettled = true;
+					resolveReady();
+				}
 				const stream = (response.body ?? new ReadableStream({ start(controller) {
 					controller.close();
 				} })).pipeThrough(BytesLineDecoder()).pipeThrough(SSEDecoder());
@@ -109,17 +148,37 @@ var ProtocolSseTransportAdapter = class {
 					if (ac.signal.aborted || this.closed) break;
 					if (isRecord(event.data)) {
 						const msg = event.data;
+						if (typeof msg.seq === "number") resumeAfterSeq = msg.seq;
 						streamQueue.push(msg);
 					}
 				}
 				streamQueue.close();
+				return;
 			} catch (error) {
-				rejectReady(error);
 				if (ac.signal.aborted || this.closed) {
+					if (!readySettled) rejectReady(error);
 					streamQueue.close();
 					return;
 				}
-				streamQueue.close(error);
+				if (this.maxReconnectAttempts <= 0) {
+					if (!readySettled) rejectReady(error);
+					streamQueue.close(toError(error));
+					return;
+				}
+				attempt += 1;
+				if (attempt > this.maxReconnectAttempts) {
+					if (!readySettled) rejectReady(error);
+					streamQueue.close(toError(error));
+					return;
+				}
+				this.onReconnect?.({
+					attempt,
+					cause: error
+				});
+				const delay = this.reconnectDelayMs(attempt);
+				if (delay > 0) await new Promise((resolve) => {
+					setTimeout(resolve, delay);
+				});
 			}
 		};
 		startStream();
@@ -151,16 +210,18 @@ var ProtocolSseTransportAdapter = class {
 		this.eventStreams.clear();
 		this.queue.close();
 	}
-	async request(path, init) {
+	async request(path, init, options) {
 		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 useAsyncCaller = this.asyncCaller != null && !options?.stream;
+		const execute = async () => {
 			const response = await (await this.resolveFetch())(url.toString(), requestInit);
 			if (!response.ok) {
+				if (useAsyncCaller) throw response;
 				let detail = "";
 				try {
 					const body = await response.text();
@@ -172,6 +233,9 @@ var ProtocolSseTransportAdapter = class {
 				throw new Error(message);
 			}
 			return response;
+		};
+		try {
+			return useAsyncCaller ? await this.asyncCaller.call(execute) : await execute();
 		} catch (error) {
 			throw toError(error);
 		}

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

@@ -1 +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 \"../../../utils/sse.js\";\nimport { IterableReadableStream } from \"../../../utils/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":"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"}
+{"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 { AsyncCaller } from \"../../../utils/async_caller.js\";\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 \"../../../utils/sse.js\";\nimport { IterableReadableStream } from \"../../../utils/stream.js\";\nimport { webSocketReconnectDelayMs } from \"./websocket.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  readonly apiUrl: string;\n\n  private readonly queue = new AsyncQueue<Message>();\n\n  private readonly fetchImpl: typeof fetch;\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 asyncCaller?: AsyncCaller;\n\n  private readonly maxReconnectAttempts: number;\n\n  private readonly onReconnect?: ProtocolSseTransportOptions[\"onReconnect\"];\n\n  private readonly reconnectDelayMs: (attempt: number) => number;\n\n  private readonly commandsUrl: string;\n\n  private readonly streamUrl: string;\n\n  private readonly stateUrl: 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.asyncCaller = options.asyncCaller;\n    // Custom fetch (tests/mocks) must not auto-reconnect — same policy as skipping AsyncCaller.\n    this.maxReconnectAttempts =\n      options.fetch != null ? 0 : (options.maxReconnectAttempts ?? 5);\n    this.onReconnect = options.onReconnect;\n    this.reconnectDelayMs =\n      options.reconnectDelayMs ?? webSocketReconnectDelayMs;\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    this.stateUrl = options.paths?.state ?? `/threads/${this.threadId}/state`;\n  }\n\n  /**\n   * Fetch checkpointed thread state for hydration.\n   *\n   * Uses `GET`, matching `client.threads.getState()` and both LangGraph\n   * Platform and Agent Protocol custom backends (`POST` is reserved for\n   * `updateState`).\n   */\n  async getState<StateType = unknown>(): Promise<{\n    values: StateType;\n    next?: unknown;\n    tasks?: unknown;\n    metadata?: unknown;\n    checkpoint?: { checkpoint_id?: string } | null;\n    parent_checkpoint?: { checkpoint_id?: string } | null;\n  } | null> {\n    const url = toAbsoluteUrl(this.apiUrl, this.stateUrl);\n    let requestInit: RequestInit = {\n      method: \"GET\",\n      headers: mergeHeaders(this.defaultHeaders, {}),\n    };\n\n    if (this.onRequest) {\n      requestInit = await this.onRequest(url, requestInit);\n    }\n\n    const fetchImpl = await this.resolveFetch();\n    const response = await fetchImpl(url.toString(), requestInit);\n    if (response.status === 404) return null;\n    if (!response.ok) {\n      const error = toError(\n        new Error(\n          `Thread state request failed: ${response.status} ${response.statusText}`\n        )\n      ) as Error & { status?: number };\n      error.status = response.status;\n      throw error;\n    }\n\n    return (await response.json()) as {\n      values: StateType;\n      next?: unknown;\n      tasks?: unknown;\n      metadata?: unknown;\n      checkpoint?: { checkpoint_id?: string } | null;\n      parent_checkpoint?: { checkpoint_id?: string } | null;\n    };\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    let resumeAfterSeq =\n      typeof (params as SubscribeParams & { since?: unknown }).since ===\n      \"number\"\n        ? (params as SubscribeParams & { since: number }).since\n        : undefined;\n\n    let readySettled = false;\n\n    const startStream = async () => {\n      let attempt = 0;\n\n      while (!ac.signal.aborted && !this.closed) {\n        try {\n          const response = await this.request(\n            streamUrl,\n            {\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                ...(resumeAfterSeq != null ? { since: resumeAfterSeq } : {}),\n              }),\n              signal: ac.signal,\n            },\n            { stream: true }\n          );\n\n          if (!readySettled) {\n            readySettled = true;\n            resolveReady();\n          }\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              if (typeof msg.seq === \"number\") {\n                resumeAfterSeq = msg.seq;\n              }\n              streamQueue.push(msg);\n            }\n          }\n          streamQueue.close();\n          return;\n        } catch (error) {\n          if (ac.signal.aborted || this.closed) {\n            if (!readySettled) {\n              rejectReady(error);\n            }\n            streamQueue.close();\n            return;\n          }\n          if (this.maxReconnectAttempts <= 0) {\n            if (!readySettled) {\n              rejectReady(error);\n            }\n            streamQueue.close(toError(error));\n            return;\n          }\n          attempt += 1;\n          if (attempt > this.maxReconnectAttempts) {\n            if (!readySettled) {\n              rejectReady(error);\n            }\n            streamQueue.close(toError(error));\n            return;\n          }\n          this.onReconnect?.({ attempt, cause: error });\n          const delay = this.reconnectDelayMs(attempt);\n          if (delay > 0) {\n            await new Promise<void>((resolve) => {\n              setTimeout(resolve, delay);\n            });\n          }\n        }\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(\n    path: string,\n    init: RequestInit,\n    options?: { stream?: boolean }\n  ): 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    // Long-lived SSE event streams must not run through AsyncCaller: its\n    // p-queue/p-retry semantics are designed for discrete request/response\n    // calls, and wrapping a streaming response stalls the call (and can\n    // leak retries). Stream resilience is handled separately by the\n    // reconnect loop in `openEventStream`.\n    const useAsyncCaller = this.asyncCaller != null && !options?.stream;\n\n    const execute = async (): Promise<Response> => {\n      const fetchImpl = await this.resolveFetch();\n      const response = await fetchImpl(url.toString(), requestInit);\n      if (!response.ok) {\n        // Reject with the Response so AsyncCaller maps it to HTTPError and\n        // applies STATUS_NO_RETRY / retry policy consistently with REST.\n        if (useAsyncCaller) {\n          throw response;\n        }\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    };\n\n    try {\n      return useAsyncCaller\n        ? await this.asyncCaller!.call(execute)\n        : await execute();\n    } catch (error) {\n      throw toError(error);\n    }\n  }\n}\n"],"mappings":"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"}

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

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

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

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

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

@@ -1,3 +1,4 @@
+import { AsyncCaller } from "../../../utils/async_caller.cjs";
 import { CommandResponse, ErrorResponse } from "@langchain/protocol";
 
 //#region src/client/stream/transport/types.d.ts
@@ -5,6 +6,8 @@ type ProtocolRequestHook = (url: URL, init: RequestInit) => Promise<RequestInit>
 interface ProtocolTransportPaths {
   commands?: string;
   stream?: string;
+  /** `GET` path for thread-state hydration. Defaults to `/threads/:threadId/state`. */
+  state?: string;
 }
 interface ProtocolSseTransportOptions {
   apiUrl: string;
@@ -13,7 +16,28 @@ interface ProtocolSseTransportOptions {
   onRequest?: ProtocolRequestHook;
   fetch?: typeof fetch;
   fetchFactory?: () => typeof fetch | Promise<typeof fetch>;
+  /**
+   * When set, command and SSE subscription HTTP requests are executed
+   * through {@link AsyncCaller} (retries, concurrency). Typically wired
+   * from {@link BaseClient} via `client.threads.stream()`.
+   */
+  asyncCaller?: AsyncCaller;
   paths?: ProtocolTransportPaths;
+  /**
+   * Maximum reconnect attempts after an unexpected SSE disconnect.
+   * Defaults to 5. Set to 0 to disable automatic reconnection.
+   */
+  maxReconnectAttempts?: number;
+  /** Called before each SSE reconnect attempt (after backoff delay). */
+  onReconnect?: (options: {
+    attempt: number;
+    cause: unknown;
+  }) => void;
+  /**
+   * Backoff before each SSE reconnect attempt. Defaults to
+   * {@link webSocketReconnectDelayMs} from `./websocket.js`.
+   */
+  reconnectDelayMs?: (attempt: number) => number;
 }
 interface ProtocolWebSocketTransportOptions {
   apiUrl: string;
@@ -22,6 +46,28 @@ interface ProtocolWebSocketTransportOptions {
   onRequest?: ProtocolRequestHook;
   webSocketFactory?: (url: string) => WebSocket;
   paths?: Pick<ProtocolTransportPaths, "stream">;
+  /**
+   * Maximum reconnect attempts after an unexpected socket close.
+   * Defaults to 5. Set to 0 to disable automatic reconnection.
+   */
+  maxReconnectAttempts?: number;
+  /**
+   * Called before each reconnect attempt (after backoff delay).
+   */
+  onReconnect?: (options: {
+    attempt: number;
+    cause: unknown;
+  }) => void;
+  /**
+   * Invoked after the socket has been re-established. Use to restore
+   * server-side subscription state (see `ThreadStream`).
+   */
+  onReconnected?: () => void | Promise<void>;
+  /**
+   * Backoff before each reconnect attempt. Defaults to
+   * {@link webSocketReconnectDelayMs}.
+   */
+  reconnectDelayMs?: (attempt: number) => number;
 }
 type HeaderValue = string | undefined | null;
 //#endregion

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

@@ -1 +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"}
+{"version":3,"file":"types.d.cts","names":[],"sources":["../../../../src/client/stream/transport/types.ts"],"mappings":";;;;KAGY,mBAAA,IACV,GAAA,EAAK,GAAA,EACL,IAAA,EAAM,WAAA,KACH,OAAA,CAAQ,WAAA,IAAe,WAAA;AAAA,UAEX,sBAAA;EACf,QAAA;EACA,MAAA;;EAEA,KAAA;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;EAhB7C;;;;;EAsBN,WAAA,GAAc,WAAA;EACd,KAAA,GAAQ,sBAAA;EApBO;;;;EAyBf,oBAAA;EAvBA;EAyBA,WAAA,IAAe,OAAA;IAAW,OAAA;IAAiB,KAAA;EAAA;EApBD;;;;EAyB1C,gBAAA,IAAoB,OAAA;AAAA;AAAA,UAGL,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;EAjCb;;;;EAsCA,oBAAA;EAnCA;;;EAuCA,WAAA,IAAe,OAAA;IAAW,OAAA;IAAiB,KAAA;EAAA;EArCQ;;;;EA0CnD,aAAA,gBAA6B,OAAA;EA9B7B;;;;EAmCA,gBAAA,IAAoB,OAAA;AAAA;AAAA,KAGV,WAAA"}

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

@@ -1,3 +1,4 @@
+import { AsyncCaller } from "../../../utils/async_caller.js";
 import { CommandResponse, ErrorResponse } from "@langchain/protocol";
 
 //#region src/client/stream/transport/types.d.ts
@@ -5,6 +6,8 @@ type ProtocolRequestHook = (url: URL, init: RequestInit) => Promise<RequestInit>
 interface ProtocolTransportPaths {
   commands?: string;
   stream?: string;
+  /** `GET` path for thread-state hydration. Defaults to `/threads/:threadId/state`. */
+  state?: string;
 }
 interface ProtocolSseTransportOptions {
   apiUrl: string;
@@ -13,7 +16,28 @@ interface ProtocolSseTransportOptions {
   onRequest?: ProtocolRequestHook;
   fetch?: typeof fetch;
   fetchFactory?: () => typeof fetch | Promise<typeof fetch>;
+  /**
+   * When set, command and SSE subscription HTTP requests are executed
+   * through {@link AsyncCaller} (retries, concurrency). Typically wired
+   * from {@link BaseClient} via `client.threads.stream()`.
+   */
+  asyncCaller?: AsyncCaller;
   paths?: ProtocolTransportPaths;
+  /**
+   * Maximum reconnect attempts after an unexpected SSE disconnect.
+   * Defaults to 5. Set to 0 to disable automatic reconnection.
+   */
+  maxReconnectAttempts?: number;
+  /** Called before each SSE reconnect attempt (after backoff delay). */
+  onReconnect?: (options: {
+    attempt: number;
+    cause: unknown;
+  }) => void;
+  /**
+   * Backoff before each SSE reconnect attempt. Defaults to
+   * {@link webSocketReconnectDelayMs} from `./websocket.js`.
+   */
+  reconnectDelayMs?: (attempt: number) => number;
 }
 interface ProtocolWebSocketTransportOptions {
   apiUrl: string;
@@ -22,6 +46,28 @@ interface ProtocolWebSocketTransportOptions {
   onRequest?: ProtocolRequestHook;
   webSocketFactory?: (url: string) => WebSocket;
   paths?: Pick<ProtocolTransportPaths, "stream">;
+  /**
+   * Maximum reconnect attempts after an unexpected socket close.
+   * Defaults to 5. Set to 0 to disable automatic reconnection.
+   */
+  maxReconnectAttempts?: number;
+  /**
+   * Called before each reconnect attempt (after backoff delay).
+   */
+  onReconnect?: (options: {
+    attempt: number;
+    cause: unknown;
+  }) => void;
+  /**
+   * Invoked after the socket has been re-established. Use to restore
+   * server-side subscription state (see `ThreadStream`).
+   */
+  onReconnected?: () => void | Promise<void>;
+  /**
+   * Backoff before each reconnect attempt. Defaults to
+   * {@link webSocketReconnectDelayMs}.
+   */
+  reconnectDelayMs?: (attempt: number) => number;
 }
 type HeaderValue = string | undefined | null;
 //#endregion

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

@@ -1 +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"}
+{"version":3,"file":"types.d.ts","names":[],"sources":["../../../../src/client/stream/transport/types.ts"],"mappings":";;;;KAGY,mBAAA,IACV,GAAA,EAAK,GAAA,EACL,IAAA,EAAM,WAAA,KACH,OAAA,CAAQ,WAAA,IAAe,WAAA;AAAA,UAEX,sBAAA;EACf,QAAA;EACA,MAAA;;EAEA,KAAA;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;EAhB7C;;;;;EAsBN,WAAA,GAAc,WAAA;EACd,KAAA,GAAQ,sBAAA;EApBO;;;;EAyBf,oBAAA;EAvBA;EAyBA,WAAA,IAAe,OAAA;IAAW,OAAA;IAAiB,KAAA;EAAA;EApBD;;;;EAyB1C,gBAAA,IAAoB,OAAA;AAAA;AAAA,UAGL,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;EAjCb;;;;EAsCA,oBAAA;EAnCA;;;EAuCA,WAAA,IAAe,OAAA;IAAW,OAAA;IAAiB,KAAA;EAAA;EArCQ;;;;EA0CnD,aAAA,gBAA6B,OAAA;EA9B7B;;;;EAmCA,gBAAA,IAAoB,OAAA;AAAA;AAAA,KAGV,WAAA"}

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

@@ -1,10 +1,28 @@
+const require_error = require("../error.cjs");
 const require_queue = require("./queue.cjs");
 const require_utils = require("./utils.cjs");
 //#region src/client/stream/transport/websocket.ts
+const WEB_SOCKET_CONNECTING = 0;
+const WEB_SOCKET_OPEN = 1;
+const WEB_SOCKET_CLOSED = 3;
+/**
+* Exponential backoff with jitter for WebSocket reconnect. Mirrors
+* {@link streamWithRetry} in `utils/stream.ts` (capped at 5s + 1s jitter).
+*/
+function webSocketReconnectDelayMs(attempt) {
+	return Math.min(1e3 * 2 ** (attempt - 1), 5e3) + Math.random() * 1e3;
+}
 /**
 * Transport adapter that speaks the thread-centric protocol over a
 * bidirectional WebSocket. Bound to a specific `threadId` — the socket
 * connects to `ws://.../threads/:thread_id/stream/events`.
+*
+* On unexpected disconnect the adapter reconnects with exponential
+* backoff (see {@link ProtocolWebSocketTransportOptions.maxReconnectAttempts}).
+* The server replays buffered events on the new socket; the SDK
+* deduplicates by `event_id`. {@link ProtocolWebSocketTransportOptions.onReconnected}
+* runs after each successful reconnect so `ThreadStream` can re-issue
+* `subscription.subscribe` commands.
 */
 var ProtocolWebSocketTransportAdapter = class {
 	threadId;
@@ -14,10 +32,15 @@ var ProtocolWebSocketTransportAdapter = class {
 	onRequest;
 	webSocketFactory;
 	streamUrl;
+	maxReconnectAttempts;
+	onReconnect;
+	reconnectDelayMs;
+	onReconnected;
 	pending = /* @__PURE__ */ new Map();
 	socket = null;
 	closed = false;
 	intentionalClose = false;
+	reconnectInFlight = null;
 	constructor(options) {
 		this.apiUrl = options.apiUrl;
 		this.threadId = options.threadId;
@@ -25,18 +48,32 @@ var ProtocolWebSocketTransportAdapter = class {
 		this.onRequest = options.onRequest;
 		this.webSocketFactory = options.webSocketFactory ?? ((url) => new WebSocket(url));
 		this.streamUrl = options.paths?.stream ?? `/threads/${this.threadId}/stream/events`;
+		this.maxReconnectAttempts = options.maxReconnectAttempts ?? 5;
+		this.onReconnect = options.onReconnect;
+		this.onReconnected = options.onReconnected;
+		this.reconnectDelayMs = options.reconnectDelayMs ?? webSocketReconnectDelayMs;
+	}
+	/**
+	* Register a callback invoked after each successful reconnect. Used
+	* by {@link ThreadStream} to re-send active `subscription.subscribe`
+	* commands.
+	*/
+	setOnReconnected(handler) {
+		this.onReconnected = handler;
 	}
 	async open() {
-		if (this.socket != null) return;
+		if (this.closed) throw new Error("Protocol WebSocket transport is closed.");
+		if (this.socket?.readyState === WEB_SOCKET_OPEN) return;
+		if (this.socket != null) {
+			this.#detachSocket(this.socket);
+			this.socket = null;
+		}
 		this.assertBrowserSafeTransportConfig();
 		const wsUrl = require_utils.toWebSocketUrl(require_utils.toAbsoluteUrl(this.apiUrl, this.streamUrl).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);
+		this.#attachSocket(socket);
 		await new Promise((resolve, reject) => {
 			const onOpen = () => {
 				cleanup();
@@ -80,8 +117,9 @@ var ProtocolWebSocketTransportAdapter = class {
 		const socket = this.socket;
 		this.socket = null;
 		if (!socket) return;
+		this.#detachSocket(socket);
 		await new Promise((resolve) => {
-			if (socket.readyState === WebSocket.CLOSED) {
+			if (socket.readyState === WEB_SOCKET_CLOSED) {
 				resolve();
 				return;
 			}
@@ -90,7 +128,7 @@ var ProtocolWebSocketTransportAdapter = class {
 				resolve();
 			};
 			socket.addEventListener("close", onClose, { once: true });
-			if (socket.readyState === WebSocket.OPEN || socket.readyState === WebSocket.CONNECTING) socket.close();
+			if (socket.readyState === WEB_SOCKET_OPEN || socket.readyState === WEB_SOCKET_CONNECTING) socket.close();
 			else resolve();
 		});
 	}
@@ -98,8 +136,12 @@ var ProtocolWebSocketTransportAdapter = class {
 		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.");
+		let socket = this.socket;
+		if (this.reconnectInFlight != null && (socket == null || socket.readyState !== WEB_SOCKET_OPEN)) {
+			await this.reconnectInFlight.catch(() => void 0);
+			socket = this.socket;
+		}
+		if (socket == null || socket.readyState !== WEB_SOCKET_OPEN) throw new Error("Protocol WebSocket is not open.");
 		return await new Promise((resolve, reject) => {
 			this.pending.set(command.id, {
 				resolve,
@@ -113,6 +155,16 @@ var ProtocolWebSocketTransportAdapter = class {
 			}
 		});
 	}
+	#attachSocket(socket) {
+		socket.addEventListener("message", this.handleMessage);
+		socket.addEventListener("close", this.handleClose);
+		socket.addEventListener("error", this.handleSocketError);
+	}
+	#detachSocket(socket) {
+		socket.removeEventListener("message", this.handleMessage);
+		socket.removeEventListener("close", this.handleClose);
+		socket.removeEventListener("error", this.handleSocketError);
+	}
 	handleMessage = (event) => {
 		let payload;
 		try {
@@ -131,25 +183,62 @@ var ProtocolWebSocketTransportAdapter = class {
 		if (require_utils.isRecord(payload) && payload.type === "event") this.queue.push(payload);
 	};
 	handleClose = () => {
+		const socket = this.socket;
+		if (socket != null) this.#detachSocket(socket);
 		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);
+		this.#handleUnexpectedDisconnect(/* @__PURE__ */ new Error("Protocol WebSocket closed unexpectedly."));
 	};
 	handleSocketError = () => {
 		if (this.closed || this.intentionalClose) return;
-		const error = /* @__PURE__ */ new Error("Protocol WebSocket encountered an error.");
+		this.#handleUnexpectedDisconnect(/* @__PURE__ */ new Error("Protocol WebSocket encountered an error."));
+	};
+	#handleUnexpectedDisconnect(cause) {
+		const error = require_utils.toError(cause);
 		for (const { reject } of this.pending.values()) reject(error);
 		this.pending.clear();
-		this.queue.close(error);
-	};
+		if (this.maxReconnectAttempts <= 0) {
+			this.queue.close(error);
+			return;
+		}
+		this.#scheduleReconnect(cause);
+	}
+	#scheduleReconnect(cause) {
+		if (this.closed || this.intentionalClose) return;
+		if (this.reconnectInFlight != null) return;
+		this.reconnectInFlight = this.#runReconnectLoop(cause).finally(() => {
+			this.reconnectInFlight = null;
+		});
+	}
+	async #runReconnectLoop(initialCause) {
+		let lastError = initialCause;
+		for (let attempt = 1; attempt <= this.maxReconnectAttempts; attempt += 1) {
+			if (this.closed || this.intentionalClose) return;
+			this.onReconnect?.({
+				attempt,
+				cause: lastError
+			});
+			const delay = this.reconnectDelayMs(attempt);
+			if (delay > 0) await new Promise((resolve) => {
+				setTimeout(resolve, delay);
+			});
+			if (this.closed || this.intentionalClose) return;
+			try {
+				await this.open();
+				if (this.onReconnected) await this.onReconnected();
+				return;
+			} catch (error) {
+				lastError = error;
+			}
+		}
+		this.queue.close(new require_error.MaxWebSocketReconnectAttemptsError(this.maxReconnectAttempts, lastError));
+	}
 };
 //#endregion
 exports.ProtocolWebSocketTransportAdapter = ProtocolWebSocketTransportAdapter;
+exports.webSocketReconnectDelayMs = webSocketReconnectDelayMs;
 
 //# sourceMappingURL=websocket.cjs.map