@langchain/langgraph-sdk 1.3.1 → 1.4.4

package/dist/utils/stream.js

@@ -1,175 +0,0 @@
-import { isNetworkError } from "./error.js";
-
-//#region src/utils/stream.ts
-/**
-* Error thrown when maximum reconnection attempts are exceeded.
-*/
-var MaxReconnectAttemptsError = class extends Error {
-	constructor(maxAttempts, cause) {
-		super(`Exceeded maximum SSE reconnection attempts (${maxAttempts})`);
-		this.name = "MaxReconnectAttemptsError";
-		this.cause = cause;
-	}
-};
-/**
-* Stream with automatic retry logic for SSE connections.
-* Implements reconnection behavior similar to the Python SDK.
-*
-* @param makeRequest Function to make requests. When `params` is undefined/empty, it's the initial request.
-*                    When `params.lastEventId` is provided, it's a reconnection request.
-* @param options Configuration options
-* @returns AsyncGenerator yielding stream events
-*/
-async function* streamWithRetry(makeRequest, options = {}) {
-	const maxRetries = options.maxRetries ?? 5;
-	let attempt = 0;
-	let lastEventId;
-	let reconnectPath;
-	while (true) {
-		let shouldRetry = false;
-		let lastError;
-		let reader;
-		try {
-			if (options.signal?.aborted) return;
-			const { response, stream } = await makeRequest(lastEventId ? {
-				lastEventId,
-				reconnectPath
-			} : void 0);
-			const locationHeader = response.headers.get("location");
-			if (locationHeader) reconnectPath = locationHeader;
-			const contentType = response.headers.get("content-type")?.split(";")[0];
-			if (contentType && !contentType.includes("text/event-stream")) throw new Error(`Expected response header Content-Type to contain 'text/event-stream', got '${contentType}'`);
-			reader = stream.getReader();
-			try {
-				while (true) {
-					if (options.signal?.aborted) {
-						await reader.cancel();
-						return;
-					}
-					const { done, value } = await reader.read();
-					if (done) break;
-					if (value.id) lastEventId = value.id;
-					yield value;
-				}
-				break;
-			} catch (error) {
-				if (lastEventId && reconnectPath && !options.signal?.aborted) shouldRetry = true;
-				else throw error;
-			} finally {
-				if (reader) try {
-					reader.releaseLock();
-				} catch {}
-			}
-		} catch (error) {
-			lastError = error;
-			if (isNetworkError(error) && lastEventId && reconnectPath && !options.signal?.aborted) shouldRetry = true;
-			else throw error;
-		}
-		if (shouldRetry) {
-			attempt += 1;
-			if (attempt > maxRetries) throw new MaxReconnectAttemptsError(maxRetries, lastError);
-			options.onReconnect?.({
-				attempt,
-				lastEventId,
-				cause: lastError
-			});
-			const baseDelay = Math.min(1e3 * 2 ** (attempt - 1), 5e3);
-			const jitter = Math.random() * 1e3;
-			const delay = baseDelay + jitter;
-			await new Promise((resolve) => {
-				setTimeout(resolve, delay);
-			});
-			continue;
-		}
-		break;
-	}
-}
-var IterableReadableStream = class IterableReadableStream extends ReadableStream {
-	reader;
-	ensureReader() {
-		if (!this.reader) this.reader = this.getReader();
-	}
-	async next() {
-		this.ensureReader();
-		try {
-			const result = await this.reader.read();
-			if (result.done) {
-				this.reader.releaseLock();
-				return {
-					done: true,
-					value: void 0
-				};
-			} else return {
-				done: false,
-				value: result.value
-			};
-		} catch (e) {
-			this.reader.releaseLock();
-			throw e;
-		}
-	}
-	async return() {
-		this.ensureReader();
-		if (this.locked) {
-			const cancelPromise = this.reader.cancel();
-			this.reader.releaseLock();
-			await cancelPromise;
-		}
-		return {
-			done: true,
-			value: void 0
-		};
-	}
-	async throw(e) {
-		this.ensureReader();
-		if (this.locked) {
-			const cancelPromise = this.reader.cancel();
-			this.reader.releaseLock();
-			await cancelPromise;
-		}
-		throw e;
-	}
-	async [Symbol.asyncDispose]() {
-		await this.return();
-	}
-	[Symbol.asyncIterator]() {
-		return this;
-	}
-	static fromReadableStream(stream) {
-		const reader = stream.getReader();
-		return new IterableReadableStream({
-			start(controller) {
-				return pump();
-				function pump() {
-					return reader.read().then(({ done, value }) => {
-						if (done) {
-							controller.close();
-							return;
-						}
-						controller.enqueue(value);
-						return pump();
-					});
-				}
-			},
-			cancel() {
-				reader.releaseLock();
-			}
-		});
-	}
-	static fromAsyncGenerator(generator) {
-		return new IterableReadableStream({
-			async pull(controller) {
-				const { value, done } = await generator.next();
-				if (done) controller.close();
-				controller.enqueue(value);
-			},
-			async cancel(reason) {
-				await generator.return(reason);
-			}
-		});
-	}
-};
-
-//#endregion
-export { IterableReadableStream, streamWithRetry };
-//# sourceMappingURL=stream.js.map

package/dist/utils/stream.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"stream.js","names":["lastEventId: string | undefined","reconnectPath: string | undefined","lastError: unknown","reader: ReadableStreamDefaultReader<T> | undefined"],"sources":["../../src/utils/stream.ts"],"sourcesContent":["import { isNetworkError } from \"./error.js\";\n\n// in this case don't quite match.\ntype IterableReadableStreamInterface<T> = ReadableStream<T> & AsyncIterable<T>;\n\n/**\n * Options for streaming with automatic retry logic.\n */\nexport interface StreamWithRetryOptions {\n  /**\n   * Maximum number of reconnection attempts. Default is 5.\n   */\n  maxRetries?: number;\n\n  /**\n   * AbortSignal to cancel the stream.\n   */\n  signal?: AbortSignal;\n\n  /**\n   * Callback invoked when a reconnection attempt is made.\n   */\n  onReconnect?: (options: {\n    attempt: number;\n    lastEventId?: string;\n    cause: unknown;\n  }) => void;\n}\n\n/**\n * Parameters for making a stream request\n */\nexport interface StreamRequestParams {\n  /**\n   * If provided, this is a reconnection request with the last event ID\n   */\n  lastEventId?: string;\n\n  /**\n   * Optional reconnection path from the Location header\n   */\n  reconnectPath?: string;\n}\n\n/**\n * Error thrown when maximum reconnection attempts are exceeded.\n */\nexport class MaxReconnectAttemptsError extends Error {\n  constructor(maxAttempts: number, cause: unknown) {\n    super(`Exceeded maximum SSE reconnection attempts (${maxAttempts})`);\n    this.name = \"MaxReconnectAttemptsError\";\n    this.cause = cause;\n  }\n}\n\n/**\n * Stream with automatic retry logic for SSE connections.\n * Implements reconnection behavior similar to the Python SDK.\n *\n * @param makeRequest Function to make requests. When `params` is undefined/empty, it's the initial request.\n *                    When `params.lastEventId` is provided, it's a reconnection request.\n * @param options Configuration options\n * @returns AsyncGenerator yielding stream events\n */\nexport async function* streamWithRetry<T extends { id?: string }>(\n  makeRequest: (params?: StreamRequestParams) => Promise<{\n    response: Response;\n    stream: ReadableStream<T>;\n  }>,\n  options: StreamWithRetryOptions = {}\n): AsyncGenerator<T> {\n  const maxRetries = options.maxRetries ?? 5;\n  let attempt = 0;\n  let lastEventId: string | undefined;\n  let reconnectPath: string | undefined;\n\n  while (true) {\n    let shouldRetry = false;\n    let lastError: unknown;\n    let reader: ReadableStreamDefaultReader<T> | undefined;\n\n    try {\n      // Check if aborted before making request\n      if (options.signal?.aborted) return;\n\n      // Make request - initial if no lastEventId, reconnect otherwise\n      const { response, stream } = await makeRequest(\n        lastEventId ? { lastEventId, reconnectPath } : undefined\n      );\n\n      // Check for Location header (server-provided reconnection path)\n      const locationHeader = response.headers.get(\"location\");\n      if (locationHeader) {\n        reconnectPath = locationHeader;\n      }\n\n      // Verify content type\n      const contentType = response.headers.get(\"content-type\")?.split(\";\")[0];\n      if (contentType && !contentType.includes(\"text/event-stream\")) {\n        throw new Error(\n          `Expected response header Content-Type to contain 'text/event-stream', got '${contentType}'`\n        );\n      }\n\n      reader = stream.getReader();\n\n      try {\n        while (true) {\n          // Check abort signal before each read\n          if (options.signal?.aborted) {\n            await reader.cancel();\n            return;\n          }\n\n          const { done, value } = await reader.read();\n\n          if (done) {\n            // Stream completed successfully\n            break;\n          }\n\n          // Track last event ID for reconnection\n          if (value.id) {\n            lastEventId = value.id;\n          }\n\n          yield value;\n        }\n\n        // Stream completed successfully, exit retry loop\n        break;\n      } catch (error) {\n        // Error during streaming - attempt reconnect if we have lastEventId and a location header\n        if (lastEventId && reconnectPath && !options.signal?.aborted) {\n          shouldRetry = true;\n        } else {\n          throw error;\n        }\n      } finally {\n        if (reader) {\n          try {\n            reader.releaseLock();\n          } catch {\n            // Ignore errors when releasing lock\n          }\n        }\n      }\n    } catch (error) {\n      lastError = error;\n\n      // Only retry if we have reconnection capability and it's a network error\n      if (\n        isNetworkError(error) &&\n        lastEventId &&\n        reconnectPath &&\n        !options.signal?.aborted\n      ) {\n        shouldRetry = true;\n      } else {\n        throw error;\n      }\n    }\n\n    if (shouldRetry) {\n      attempt += 1;\n      if (attempt > maxRetries) {\n        throw new MaxReconnectAttemptsError(maxRetries, lastError);\n      }\n\n      // Notify about reconnection attempt\n      options.onReconnect?.({ attempt, lastEventId, cause: lastError });\n\n      // Exponential backoff with jitter: min(1000 * 2^attempt, 5000) + random jitter\n      const baseDelay = Math.min(1000 * 2 ** (attempt - 1), 5000);\n      const jitter = Math.random() * 1000;\n      const delay = baseDelay + jitter;\n\n      await new Promise((resolve) => {\n        setTimeout(resolve, delay);\n      });\n\n      continue;\n    }\n\n    // Successfully completed\n    break;\n  }\n}\n\n/*\n * Support async iterator syntax for ReadableStreams in all environments.\n * Source: https://github.com/MattiasBuelens/web-streams-polyfill/pull/122#issuecomment-1627354490\n */\nexport class IterableReadableStream<T>\n  extends ReadableStream<T>\n  implements IterableReadableStreamInterface<T>\n{\n  public reader: ReadableStreamDefaultReader<T>;\n\n  ensureReader() {\n    if (!this.reader) {\n      this.reader = this.getReader();\n    }\n  }\n\n  async next(): Promise<IteratorResult<T>> {\n    this.ensureReader();\n    try {\n      const result = await this.reader.read();\n      if (result.done) {\n        this.reader.releaseLock(); // release lock when stream becomes closed\n        return {\n          done: true,\n          value: undefined,\n        };\n      } else {\n        return {\n          done: false,\n          value: result.value,\n        };\n      }\n    } catch (e) {\n      this.reader.releaseLock(); // release lock when stream becomes errored\n      throw e;\n    }\n  }\n\n  async return(): Promise<IteratorResult<T>> {\n    this.ensureReader();\n    // If wrapped in a Node stream, cancel is already called.\n    if (this.locked) {\n      const cancelPromise = this.reader.cancel(); // cancel first, but don't await yet\n      this.reader.releaseLock(); // release lock first\n      await cancelPromise; // now await it\n    }\n    return { done: true, value: undefined };\n  }\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  async throw(e: any): Promise<IteratorResult<T>> {\n    this.ensureReader();\n    if (this.locked) {\n      const cancelPromise = this.reader.cancel(); // cancel first, but don't await yet\n      this.reader.releaseLock(); // release lock first\n      await cancelPromise; // now await it\n    }\n    throw e;\n  }\n\n  // eslint-disable-next-line @typescript-eslint/ban-ts-comment\n  // @ts-ignore Not present in Node 18 types, required in latest Node 22\n  async [Symbol.asyncDispose]() {\n    await this.return();\n  }\n\n  [Symbol.asyncIterator]() {\n    return this;\n  }\n\n  static fromReadableStream<T>(stream: ReadableStream<T>) {\n    // From https://developer.mozilla.org/en-US/docs/Web/API/Streams_API/Using_readable_streams#reading_the_stream\n    const reader = stream.getReader();\n    return new IterableReadableStream<T>({\n      start(controller) {\n        return pump();\n        function pump(): Promise<T | undefined> {\n          return reader.read().then(({ done, value }) => {\n            // When no more data needs to be consumed, close the stream\n            if (done) {\n              controller.close();\n              return;\n            }\n            // Enqueue the next data chunk into our target stream\n            controller.enqueue(value);\n            return pump();\n          });\n        }\n      },\n      cancel() {\n        reader.releaseLock();\n      },\n    });\n  }\n\n  static fromAsyncGenerator<T>(generator: AsyncGenerator<T>) {\n    return new IterableReadableStream<T>({\n      async pull(controller) {\n        const { value, done } = await generator.next();\n        // When no more data needs to be consumed, close the stream\n        if (done) {\n          controller.close();\n        }\n        // Fix: `else if (value)` will hang the streaming when nullish value (e.g. empty string) is pulled\n        controller.enqueue(value);\n      },\n      async cancel(reason) {\n        await generator.return(reason);\n      },\n    });\n  }\n}\n"],"mappings":"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"}