@langchain/langgraph-sdk 1.9.20 → 1.9.21

package/dist/client/index.cjs

@@ -8,8 +8,8 @@ require("./stream/handles/subgraphs.cjs");
 require("./stream/handles/subagents.cjs");
 require("./stream/error.cjs");
 require("./stream/index.cjs");
-require("./stream/transport/http.cjs");
 require("./stream/transport/websocket.cjs");
+require("./stream/transport/http.cjs");
 const require_index$2 = require("./threads/index.cjs");
 const require_index$3 = require("./runs/index.cjs");
 const require_index$4 = require("./crons/index.cjs");

package/dist/client/index.js

@@ -8,8 +8,8 @@ import "./stream/handles/subgraphs.js";
 import "./stream/handles/subagents.js";
 import "./stream/error.js";
 import "./stream/index.js";
-import "./stream/transport/http.js";
 import "./stream/transport/websocket.js";
+import "./stream/transport/http.js";
 import { ThreadsClient } from "./threads/index.js";
 import { RunsClient } from "./runs/index.js";
 import { CronsClient } from "./crons/index.js";

package/dist/client/stream/error.cjs

@@ -12,7 +12,28 @@ var ProtocolError = class extends Error {
 		this.response = response;
 	}
 };
+/**
+* Thrown when the v2 WebSocket transport exhausts its automatic reconnect
+* budget (`maxReconnectAttempts`) after an unexpected socket close or error.
+*
+* The transport closes its event queue with this error so consumers of
+* `events()` can treat the stream as terminally failed. Set
+* `maxReconnectAttempts` to `0` on `client.threads.stream({ transport:
+* "websocket" })` to disable reconnect and fail fast on the first drop
+* instead.
+*/
+var MaxWebSocketReconnectAttemptsError = class extends Error {
+	/** The configured `maxReconnectAttempts` value that was exceeded. */
+	maxAttempts;
+	constructor(maxAttempts, cause) {
+		super(`Exceeded maximum WebSocket reconnection attempts (${maxAttempts})`);
+		this.name = "MaxWebSocketReconnectAttemptsError";
+		this.maxAttempts = maxAttempts;
+		this.cause = cause;
+	}
+};
 //#endregion
+exports.MaxWebSocketReconnectAttemptsError = MaxWebSocketReconnectAttemptsError;
 exports.ProtocolError = ProtocolError;
 
 //# sourceMappingURL=error.cjs.map

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

@@ -1 +1 @@
-{"version":3,"file":"error.cjs","names":[],"sources":["../../../src/client/stream/error.ts"],"sourcesContent":["import type { ErrorResponse } from \"@langchain/protocol\";\n\n/**\n * Error wrapper for protocol-level error responses returned by the server.\n */\nexport class ProtocolError extends Error {\n  readonly code: ErrorResponse[\"error\"];\n  readonly response: ErrorResponse;\n\n  constructor(response: ErrorResponse) {\n    super(response.message);\n    this.name = \"ProtocolError\";\n    this.code = response.error;\n    this.response = response;\n  }\n}\n"],"mappings":";;;;AAKA,IAAa,gBAAb,cAAmC,MAAM;CACvC;CACA;CAEA,YAAY,UAAyB;AACnC,QAAM,SAAS,QAAQ;AACvB,OAAK,OAAO;AACZ,OAAK,OAAO,SAAS;AACrB,OAAK,WAAW"}
+{"version":3,"file":"error.cjs","names":[],"sources":["../../../src/client/stream/error.ts"],"sourcesContent":["import type { ErrorResponse } from \"@langchain/protocol\";\n\n/**\n * Error wrapper for protocol-level error responses returned by the server.\n */\nexport class ProtocolError extends Error {\n  readonly code: ErrorResponse[\"error\"];\n  readonly response: ErrorResponse;\n\n  constructor(response: ErrorResponse) {\n    super(response.message);\n    this.name = \"ProtocolError\";\n    this.code = response.error;\n    this.response = response;\n  }\n}\n\n/**\n * Thrown when the v2 WebSocket transport exhausts its automatic reconnect\n * budget (`maxReconnectAttempts`) after an unexpected socket close or error.\n *\n * The transport closes its event queue with this error so consumers of\n * `events()` can treat the stream as terminally failed. Set\n * `maxReconnectAttempts` to `0` on `client.threads.stream({ transport:\n * \"websocket\" })` to disable reconnect and fail fast on the first drop\n * instead.\n */\nexport class MaxWebSocketReconnectAttemptsError extends Error {\n  /** The configured `maxReconnectAttempts` value that was exceeded. */\n  readonly maxAttempts: number;\n\n  constructor(maxAttempts: number, cause: unknown) {\n    super(`Exceeded maximum WebSocket reconnection attempts (${maxAttempts})`);\n    this.name = \"MaxWebSocketReconnectAttemptsError\";\n    this.maxAttempts = maxAttempts;\n    this.cause = cause;\n  }\n}\n"],"mappings":";;;;AAKA,IAAa,gBAAb,cAAmC,MAAM;CACvC;CACA;CAEA,YAAY,UAAyB;AACnC,QAAM,SAAS,QAAQ;AACvB,OAAK,OAAO;AACZ,OAAK,OAAO,SAAS;AACrB,OAAK,WAAW;;;;;;;;;;;;;AAcpB,IAAa,qCAAb,cAAwD,MAAM;;CAE5D;CAEA,YAAY,aAAqB,OAAgB;AAC/C,QAAM,qDAAqD,YAAY,GAAG;AAC1E,OAAK,OAAO;AACZ,OAAK,cAAc;AACnB,OAAK,QAAQ"}

package/dist/client/stream/error.js

@@ -12,7 +12,27 @@ var ProtocolError = class extends Error {
 		this.response = response;
 	}
 };
+/**
+* Thrown when the v2 WebSocket transport exhausts its automatic reconnect
+* budget (`maxReconnectAttempts`) after an unexpected socket close or error.
+*
+* The transport closes its event queue with this error so consumers of
+* `events()` can treat the stream as terminally failed. Set
+* `maxReconnectAttempts` to `0` on `client.threads.stream({ transport:
+* "websocket" })` to disable reconnect and fail fast on the first drop
+* instead.
+*/
+var MaxWebSocketReconnectAttemptsError = class extends Error {
+	/** The configured `maxReconnectAttempts` value that was exceeded. */
+	maxAttempts;
+	constructor(maxAttempts, cause) {
+		super(`Exceeded maximum WebSocket reconnection attempts (${maxAttempts})`);
+		this.name = "MaxWebSocketReconnectAttemptsError";
+		this.maxAttempts = maxAttempts;
+		this.cause = cause;
+	}
+};
 //#endregion
-export { ProtocolError };
+export { MaxWebSocketReconnectAttemptsError, ProtocolError };
 
 //# sourceMappingURL=error.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"error.js","names":[],"sources":["../../../src/client/stream/error.ts"],"sourcesContent":["import type { ErrorResponse } from \"@langchain/protocol\";\n\n/**\n * Error wrapper for protocol-level error responses returned by the server.\n */\nexport class ProtocolError extends Error {\n  readonly code: ErrorResponse[\"error\"];\n  readonly response: ErrorResponse;\n\n  constructor(response: ErrorResponse) {\n    super(response.message);\n    this.name = \"ProtocolError\";\n    this.code = response.error;\n    this.response = response;\n  }\n}\n"],"mappings":";;;;AAKA,IAAa,gBAAb,cAAmC,MAAM;CACvC;CACA;CAEA,YAAY,UAAyB;AACnC,QAAM,SAAS,QAAQ;AACvB,OAAK,OAAO;AACZ,OAAK,OAAO,SAAS;AACrB,OAAK,WAAW"}
+{"version":3,"file":"error.js","names":[],"sources":["../../../src/client/stream/error.ts"],"sourcesContent":["import type { ErrorResponse } from \"@langchain/protocol\";\n\n/**\n * Error wrapper for protocol-level error responses returned by the server.\n */\nexport class ProtocolError extends Error {\n  readonly code: ErrorResponse[\"error\"];\n  readonly response: ErrorResponse;\n\n  constructor(response: ErrorResponse) {\n    super(response.message);\n    this.name = \"ProtocolError\";\n    this.code = response.error;\n    this.response = response;\n  }\n}\n\n/**\n * Thrown when the v2 WebSocket transport exhausts its automatic reconnect\n * budget (`maxReconnectAttempts`) after an unexpected socket close or error.\n *\n * The transport closes its event queue with this error so consumers of\n * `events()` can treat the stream as terminally failed. Set\n * `maxReconnectAttempts` to `0` on `client.threads.stream({ transport:\n * \"websocket\" })` to disable reconnect and fail fast on the first drop\n * instead.\n */\nexport class MaxWebSocketReconnectAttemptsError extends Error {\n  /** The configured `maxReconnectAttempts` value that was exceeded. */\n  readonly maxAttempts: number;\n\n  constructor(maxAttempts: number, cause: unknown) {\n    super(`Exceeded maximum WebSocket reconnection attempts (${maxAttempts})`);\n    this.name = \"MaxWebSocketReconnectAttemptsError\";\n    this.maxAttempts = maxAttempts;\n    this.cause = cause;\n  }\n}\n"],"mappings":";;;;AAKA,IAAa,gBAAb,cAAmC,MAAM;CACvC;CACA;CAEA,YAAY,UAAyB;AACnC,QAAM,SAAS,QAAQ;AACvB,OAAK,OAAO;AACZ,OAAK,OAAO,SAAS;AACrB,OAAK,WAAW;;;;;;;;;;;;;AAcpB,IAAa,qCAAb,cAAwD,MAAM;;CAE5D;CAEA,YAAY,aAAqB,OAAgB;AAC/C,QAAM,qDAAqD,YAAY,GAAG;AAC1E,OAAK,OAAO;AACZ,OAAK,cAAc;AACnB,OAAK,QAAQ"}

package/dist/client/stream/index.cjs

@@ -436,7 +436,10 @@ var ThreadStream = class {
 			listCheckpoints: async (params) => await this.#send("state.listCheckpoints", params),
 			fork: async (params) => await this.#send("state.fork", params)
 		};
-		if (this.#transportAdapter.openEventStream == null) this.#consumeEvents();
+		if (this.#transportAdapter.openEventStream == null) {
+			this.#transportAdapter.setOnReconnected?.(() => this.#resubscribeWebSocketSubscriptions());
+			this.#consumeEvents();
+		}
 	}
 	/**
 	* Ensure the underlying transport is connected.
@@ -1375,6 +1378,26 @@ var ThreadStream = class {
 		this.#subscriptions.set(resolvedId, subscription);
 		return handle;
 	}
+	/**
+	* Re-issue `subscription.subscribe` for every active WS subscription
+	* after the transport reconnects. The server replays buffered events on
+	* the new socket; client-side `event_id` dedup suppresses duplicates.
+	*/
+	async #resubscribeWebSocketSubscriptions() {
+		if (this.#transportAdapter.openEventStream != null || this.#closed) return;
+		const entries = [...this.#subscriptions.entries()];
+		await Promise.all(entries.map(async ([id, subscription]) => {
+			if (id.startsWith("pending:")) return;
+			try {
+				const nextId = (await this.#send("subscription.subscribe", subscription.filter)).subscription_id;
+				if (nextId === id) return;
+				this.#subscriptions.delete(id);
+				subscription.subscriptionId = nextId;
+				this.#subscriptions.set(nextId, subscription);
+				if (this.#lifecycleSubId === id) this.#lifecycleSubId = nextId;
+			} catch {}
+		}));
+	}
 	async #consumeEvents() {
 		try {
 			for await (const message of this.#transportAdapter.events()) this.#handleIncoming(message);