@langchain/langgraph-sdk 1.8.10 → 1.9.0

package/dist/client/assistants/index.d.ts

@@ -0,0 +1,155 @@
+import { Assistant, AssistantGraph, AssistantSelectField, AssistantSortBy, AssistantVersion, AssistantsSearchResponse, Config, GraphSchema, Metadata, SortOrder, Subgraphs } from "../../schema.js";
+import { OnConflictBehavior } from "../../types.js";
+import { BaseClient } from "../base.js";
+
+//#region src/client/assistants/index.d.ts
+declare class AssistantsClient extends BaseClient {
+  /**
+   * Get an assistant by ID.
+   *
+   * @param assistantId The ID of the assistant.
+   * @returns Assistant
+   */
+  get(assistantId: string, options?: {
+    signal?: AbortSignal;
+  }): Promise<Assistant>;
+  /**
+   * Get the JSON representation of the graph assigned to a runnable
+   * @param assistantId The ID of the assistant.
+   * @param options.xray Whether to include subgraphs in the serialized graph representation. If an integer value is provided, only subgraphs with a depth less than or equal to the value will be included.
+   * @returns Serialized graph
+   */
+  getGraph(assistantId: string, options?: {
+    xray?: boolean | number;
+    signal?: AbortSignal;
+  }): Promise<AssistantGraph>;
+  /**
+   * Get the state and config schema of the graph assigned to a runnable
+   * @param assistantId The ID of the assistant.
+   * @returns Graph schema
+   */
+  getSchemas(assistantId: string, options?: {
+    signal?: AbortSignal;
+  }): Promise<GraphSchema>;
+  /**
+   * Get the schemas of an assistant by ID.
+   *
+   * @param assistantId The ID of the assistant to get the schema of.
+   * @param options Additional options for getting subgraphs, such as namespace or recursion extraction.
+   * @returns The subgraphs of the assistant.
+   */
+  getSubgraphs(assistantId: string, options?: {
+    namespace?: string;
+    recurse?: boolean;
+    signal?: AbortSignal;
+  }): Promise<Subgraphs>;
+  /**
+   * Create a new assistant.
+   * @param payload Payload for creating an assistant.
+   * @returns The created assistant.
+   */
+  create(payload: {
+    graphId: string;
+    config?: Config;
+    context?: unknown;
+    metadata?: Metadata;
+    assistantId?: string;
+    ifExists?: OnConflictBehavior;
+    name?: string;
+    description?: string;
+    signal?: AbortSignal;
+  }): Promise<Assistant>;
+  /**
+   * Update an assistant.
+   * @param assistantId ID of the assistant.
+   * @param payload Payload for updating the assistant.
+   * @returns The updated assistant.
+   */
+  update(assistantId: string, payload: {
+    graphId?: string;
+    config?: Config;
+    context?: unknown;
+    metadata?: Metadata;
+    name?: string;
+    description?: string;
+    signal?: AbortSignal;
+  }): Promise<Assistant>;
+  /**
+   * Delete an assistant.
+   *
+   * @param assistantId ID of the assistant.
+   * @param deleteThreads If true, delete all threads with `metadata.assistant_id` equal to `assistantId`. Defaults to false.
+   */
+  delete(assistantId: string, options?: {
+    signal?: AbortSignal;
+    deleteThreads?: boolean;
+  }): Promise<void>;
+  /**
+   * List assistants.
+   * @param query Query options.
+   * @returns List of assistants or, when includePagination is true, a mapping with the assistants and next cursor.
+   */
+  search(query: {
+    graphId?: string;
+    name?: string;
+    metadata?: Metadata;
+    limit?: number;
+    offset?: number;
+    sortBy?: AssistantSortBy;
+    sortOrder?: SortOrder;
+    select?: AssistantSelectField[];
+    includePagination: true;
+    signal?: AbortSignal;
+  }): Promise<AssistantsSearchResponse>;
+  search(query?: {
+    graphId?: string;
+    name?: string;
+    metadata?: Metadata;
+    limit?: number;
+    offset?: number;
+    sortBy?: AssistantSortBy;
+    sortOrder?: SortOrder;
+    select?: AssistantSelectField[];
+    includePagination?: false;
+    signal?: AbortSignal;
+  }): Promise<Assistant[]>;
+  /**
+   * Count assistants matching filters.
+   *
+   * @param query.metadata Metadata to filter by. Exact match for each key/value.
+   * @param query.graphId Optional graph id to filter by.
+   * @param query.name Optional name to filter by.
+   * @returns Number of assistants matching the criteria.
+   */
+  count(query?: {
+    metadata?: Metadata;
+    graphId?: string;
+    name?: string;
+    signal?: AbortSignal;
+  }): Promise<number>;
+  /**
+   * List all versions of an assistant.
+   *
+   * @param assistantId ID of the assistant.
+   * @returns List of assistant versions.
+   */
+  getVersions(assistantId: string, payload?: {
+    metadata?: Metadata;
+    limit?: number;
+    offset?: number;
+    signal?: AbortSignal;
+  }): Promise<AssistantVersion[]>;
+  /**
+   * Change the version of an assistant.
+   *
+   * @param assistantId ID of the assistant.
+   * @param version The version to change to.
+   * @returns The updated assistant.
+   */
+  setLatest(assistantId: string, version: number, options?: {
+    signal?: AbortSignal;
+  }): Promise<Assistant>;
+}
+//#endregion
+export { AssistantsClient };
+//# sourceMappingURL=index.d.ts.map

package/dist/client/assistants/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/client/assistants/index.ts"],"mappings":";;;;;cAgBa,gBAAA,SAAyB,UAAA;;AAAtC;;;;;EAOQ,GAAA,CACJ,WAAA,UACA,OAAA;IAAY,MAAA,GAAS,WAAA;EAAA,IACpB,OAAA,CAAQ,SAAA;EAeR;;;;;;EAHG,QAAA,CACJ,WAAA,UACA,OAAA;IAAY,IAAA;IAAyB,MAAA,GAAS,WAAA;EAAA,IAC7C,OAAA,CAAQ,cAAA;EA8DA;;;;;EAlDL,UAAA,CACJ,WAAA,UACA,OAAA;IAAY,MAAA,GAAS,WAAA;EAAA,IACpB,OAAA,CAAQ,WAAA;EAyGY;;;;;;;EA5FjB,YAAA,CACJ,WAAA,UACA,OAAA;IACE,SAAA;IACA,OAAA;IACA,MAAA,GAAS,WAAA;EAAA,IAEV,OAAA,CAAQ,SAAA;EA4HA;;;;;EA1GL,MAAA,CAAO,OAAA;IACX,OAAA;IACA,MAAA,GAAS,MAAA;IACT,OAAA;IACA,QAAA,GAAW,QAAA;IACX,WAAA;IACA,QAAA,GAAW,kBAAA;IACX,IAAA;IACA,WAAA;IACA,MAAA,GAAS,WAAA;EAAA,IACP,OAAA,CAAQ,SAAA;EAxFkC;;;;;;EA+GxC,MAAA,CACJ,WAAA,UACA,OAAA;IACE,OAAA;IACA,MAAA,GAAS,MAAA;IACT,OAAA;IACA,QAAA,GAAW,QAAA;IACX,IAAA;IACA,WAAA;IACA,MAAA,GAAS,WAAA;EAAA,IAEV,OAAA,CAAQ,SAAA;EAjGR;;;;;;EAsHG,MAAA,CACJ,WAAA,UACA,OAAA;IAAY,MAAA,GAAS,WAAA;IAAa,aAAA;EAAA,IACjC,OAAA;EA5FD;;;;;EA6GI,MAAA,CAAO,KAAA;IACX,OAAA;IACA,IAAA;IACA,QAAA,GAAW,QAAA;IACX,KAAA;IACA,MAAA;IACA,MAAA,GAAS,eAAA;IACT,SAAA,GAAY,SAAA;IACZ,MAAA,GAAS,oBAAA;IACT,iBAAA;IACA,MAAA,GAAS,WAAA;EAAA,IACP,OAAA,CAAQ,wBAAA;EAEN,MAAA,CAAO,KAAA;IACX,OAAA;IACA,IAAA;IACA,QAAA,GAAW,QAAA;IACX,KAAA;IACA,MAAA;IACA,MAAA,GAAS,eAAA;IACT,SAAA,GAAY,SAAA;IACZ,MAAA,GAAS,oBAAA;IACT,iBAAA;IACA,MAAA,GAAS,WAAA;EAAA,IACP,OAAA,CAAQ,SAAA;EAxEC;;;;;;;;EA0HP,KAAA,CAAM,KAAA;IACV,QAAA,GAAW,QAAA;IACX,OAAA;IACA,IAAA;IACA,MAAA,GAAS,WAAA;EAAA,IACP,OAAA;EAjGmB;;;;;;EAmHjB,WAAA,CACJ,WAAA,UACA,OAAA;IACE,QAAA,GAAW,QAAA;IACX,KAAA;IACA,MAAA;IACA,MAAA,GAAS,WAAA;EAAA,IAEV,OAAA,CAAQ,gBAAA;EAnGA;;;;;;;EAyHL,SAAA,CACJ,WAAA,UACA,OAAA,UACA,OAAA;IAAY,MAAA,GAAS,WAAA;EAAA,IACpB,OAAA,CAAQ,SAAA;AAAA"}

package/dist/client/assistants/index.js

@@ -0,0 +1,180 @@
+import { BaseClient } from "../base.js";
+//#region src/client/assistants/index.ts
+var AssistantsClient = class extends BaseClient {
+	/**
+	* Get an assistant by ID.
+	*
+	* @param assistantId The ID of the assistant.
+	* @returns Assistant
+	*/
+	async get(assistantId, options) {
+		return this.fetch(`/assistants/${assistantId}`, { signal: options?.signal });
+	}
+	/**
+	* Get the JSON representation of the graph assigned to a runnable
+	* @param assistantId The ID of the assistant.
+	* @param options.xray Whether to include subgraphs in the serialized graph representation. If an integer value is provided, only subgraphs with a depth less than or equal to the value will be included.
+	* @returns Serialized graph
+	*/
+	async getGraph(assistantId, options) {
+		return this.fetch(`/assistants/${assistantId}/graph`, {
+			params: { xray: options?.xray },
+			signal: options?.signal
+		});
+	}
+	/**
+	* Get the state and config schema of the graph assigned to a runnable
+	* @param assistantId The ID of the assistant.
+	* @returns Graph schema
+	*/
+	async getSchemas(assistantId, options) {
+		return this.fetch(`/assistants/${assistantId}/schemas`, { signal: options?.signal });
+	}
+	/**
+	* Get the schemas of an assistant by ID.
+	*
+	* @param assistantId The ID of the assistant to get the schema of.
+	* @param options Additional options for getting subgraphs, such as namespace or recursion extraction.
+	* @returns The subgraphs of the assistant.
+	*/
+	async getSubgraphs(assistantId, options) {
+		if (options?.namespace) return this.fetch(`/assistants/${assistantId}/subgraphs/${options.namespace}`, {
+			params: { recurse: options?.recurse },
+			signal: options?.signal
+		});
+		return this.fetch(`/assistants/${assistantId}/subgraphs`, {
+			params: { recurse: options?.recurse },
+			signal: options?.signal
+		});
+	}
+	/**
+	* Create a new assistant.
+	* @param payload Payload for creating an assistant.
+	* @returns The created assistant.
+	*/
+	async create(payload) {
+		return this.fetch("/assistants", {
+			method: "POST",
+			json: {
+				graph_id: payload.graphId,
+				config: payload.config,
+				context: payload.context,
+				metadata: payload.metadata,
+				assistant_id: payload.assistantId,
+				if_exists: payload.ifExists,
+				name: payload.name,
+				description: payload.description
+			},
+			signal: payload.signal
+		});
+	}
+	/**
+	* Update an assistant.
+	* @param assistantId ID of the assistant.
+	* @param payload Payload for updating the assistant.
+	* @returns The updated assistant.
+	*/
+	async update(assistantId, payload) {
+		return this.fetch(`/assistants/${assistantId}`, {
+			method: "PATCH",
+			json: {
+				graph_id: payload.graphId,
+				config: payload.config,
+				context: payload.context,
+				metadata: payload.metadata,
+				name: payload.name,
+				description: payload.description
+			},
+			signal: payload.signal
+		});
+	}
+	/**
+	* Delete an assistant.
+	*
+	* @param assistantId ID of the assistant.
+	* @param deleteThreads If true, delete all threads with `metadata.assistant_id` equal to `assistantId`. Defaults to false.
+	*/
+	async delete(assistantId, options) {
+		return this.fetch(`/assistants/${assistantId}?delete_threads=${options?.deleteThreads ?? false}`, {
+			method: "DELETE",
+			signal: options?.signal
+		});
+	}
+	async search(query) {
+		const json = {
+			graph_id: query?.graphId ?? void 0,
+			name: query?.name ?? void 0,
+			metadata: query?.metadata ?? void 0,
+			limit: query?.limit ?? 10,
+			offset: query?.offset ?? 0,
+			sort_by: query?.sortBy ?? void 0,
+			sort_order: query?.sortOrder ?? void 0,
+			select: query?.select ?? void 0
+		};
+		const [assistants, response] = await this.fetch("/assistants/search", {
+			method: "POST",
+			json,
+			withResponse: true,
+			signal: query?.signal
+		});
+		if (query?.includePagination) return {
+			assistants,
+			next: response.headers.get("X-Pagination-Next")
+		};
+		return assistants;
+	}
+	/**
+	* Count assistants matching filters.
+	*
+	* @param query.metadata Metadata to filter by. Exact match for each key/value.
+	* @param query.graphId Optional graph id to filter by.
+	* @param query.name Optional name to filter by.
+	* @returns Number of assistants matching the criteria.
+	*/
+	async count(query) {
+		return this.fetch(`/assistants/count`, {
+			method: "POST",
+			json: {
+				metadata: query?.metadata ?? void 0,
+				graph_id: query?.graphId ?? void 0,
+				name: query?.name ?? void 0
+			},
+			signal: query?.signal
+		});
+	}
+	/**
+	* List all versions of an assistant.
+	*
+	* @param assistantId ID of the assistant.
+	* @returns List of assistant versions.
+	*/
+	async getVersions(assistantId, payload) {
+		return this.fetch(`/assistants/${assistantId}/versions`, {
+			method: "POST",
+			json: {
+				metadata: payload?.metadata ?? void 0,
+				limit: payload?.limit ?? 10,
+				offset: payload?.offset ?? 0
+			},
+			signal: payload?.signal
+		});
+	}
+	/**
+	* Change the version of an assistant.
+	*
+	* @param assistantId ID of the assistant.
+	* @param version The version to change to.
+	* @returns The updated assistant.
+	*/
+	async setLatest(assistantId, version, options) {
+		return this.fetch(`/assistants/${assistantId}/latest`, {
+			method: "POST",
+			json: { version },
+			signal: options?.signal
+		});
+	}
+};
+//#endregion
+export { AssistantsClient };
+
+//# sourceMappingURL=index.js.map

package/dist/client/assistants/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/client/assistants/index.ts"],"sourcesContent":["import {\n  Assistant,\n  AssistantGraph,\n  AssistantSortBy,\n  AssistantSelectField,\n  AssistantVersion,\n  AssistantsSearchResponse,\n  Config,\n  GraphSchema,\n  Metadata,\n  SortOrder,\n  Subgraphs,\n} from \"../../schema.js\";\nimport type { OnConflictBehavior } from \"../../types.js\";\nimport { BaseClient } from \"../base.js\";\n\nexport class AssistantsClient extends BaseClient {\n  /**\n   * Get an assistant by ID.\n   *\n   * @param assistantId The ID of the assistant.\n   * @returns Assistant\n   */\n  async get(\n    assistantId: string,\n    options?: { signal?: AbortSignal }\n  ): Promise<Assistant> {\n    return this.fetch<Assistant>(`/assistants/${assistantId}`, {\n      signal: options?.signal,\n    });\n  }\n\n  /**\n   * Get the JSON representation of the graph assigned to a runnable\n   * @param assistantId The ID of the assistant.\n   * @param options.xray Whether to include subgraphs in the serialized graph representation. If an integer value is provided, only subgraphs with a depth less than or equal to the value will be included.\n   * @returns Serialized graph\n   */\n  async getGraph(\n    assistantId: string,\n    options?: { xray?: boolean | number; signal?: AbortSignal }\n  ): Promise<AssistantGraph> {\n    return this.fetch<AssistantGraph>(`/assistants/${assistantId}/graph`, {\n      params: { xray: options?.xray },\n      signal: options?.signal,\n    });\n  }\n\n  /**\n   * Get the state and config schema of the graph assigned to a runnable\n   * @param assistantId The ID of the assistant.\n   * @returns Graph schema\n   */\n  async getSchemas(\n    assistantId: string,\n    options?: { signal?: AbortSignal }\n  ): Promise<GraphSchema> {\n    return this.fetch<GraphSchema>(`/assistants/${assistantId}/schemas`, {\n      signal: options?.signal,\n    });\n  }\n\n  /**\n   * Get the schemas of an assistant by ID.\n   *\n   * @param assistantId The ID of the assistant to get the schema of.\n   * @param options Additional options for getting subgraphs, such as namespace or recursion extraction.\n   * @returns The subgraphs of the assistant.\n   */\n  async getSubgraphs(\n    assistantId: string,\n    options?: {\n      namespace?: string;\n      recurse?: boolean;\n      signal?: AbortSignal;\n    }\n  ): Promise<Subgraphs> {\n    if (options?.namespace) {\n      return this.fetch<Subgraphs>(\n        `/assistants/${assistantId}/subgraphs/${options.namespace}`,\n        { params: { recurse: options?.recurse }, signal: options?.signal }\n      );\n    }\n    return this.fetch<Subgraphs>(`/assistants/${assistantId}/subgraphs`, {\n      params: { recurse: options?.recurse },\n      signal: options?.signal,\n    });\n  }\n\n  /**\n   * Create a new assistant.\n   * @param payload Payload for creating an assistant.\n   * @returns The created assistant.\n   */\n  async create(payload: {\n    graphId: string;\n    config?: Config;\n    context?: unknown;\n    metadata?: Metadata;\n    assistantId?: string;\n    ifExists?: OnConflictBehavior;\n    name?: string;\n    description?: string;\n    signal?: AbortSignal;\n  }): Promise<Assistant> {\n    return this.fetch<Assistant>(\"/assistants\", {\n      method: \"POST\",\n      json: {\n        graph_id: payload.graphId,\n        config: payload.config,\n        context: payload.context,\n        metadata: payload.metadata,\n        assistant_id: payload.assistantId,\n        if_exists: payload.ifExists,\n        name: payload.name,\n        description: payload.description,\n      },\n      signal: payload.signal,\n    });\n  }\n\n  /**\n   * Update an assistant.\n   * @param assistantId ID of the assistant.\n   * @param payload Payload for updating the assistant.\n   * @returns The updated assistant.\n   */\n  async update(\n    assistantId: string,\n    payload: {\n      graphId?: string;\n      config?: Config;\n      context?: unknown;\n      metadata?: Metadata;\n      name?: string;\n      description?: string;\n      signal?: AbortSignal;\n    }\n  ): Promise<Assistant> {\n    return this.fetch<Assistant>(`/assistants/${assistantId}`, {\n      method: \"PATCH\",\n      json: {\n        graph_id: payload.graphId,\n        config: payload.config,\n        context: payload.context,\n        metadata: payload.metadata,\n        name: payload.name,\n        description: payload.description,\n      },\n      signal: payload.signal,\n    });\n  }\n\n  /**\n   * Delete an assistant.\n   *\n   * @param assistantId ID of the assistant.\n   * @param deleteThreads If true, delete all threads with `metadata.assistant_id` equal to `assistantId`. Defaults to false.\n   */\n  async delete(\n    assistantId: string,\n    options?: { signal?: AbortSignal; deleteThreads?: boolean }\n  ): Promise<void> {\n    return this.fetch<void>(\n      `/assistants/${assistantId}?delete_threads=${\n        options?.deleteThreads ?? false\n      }`,\n      {\n        method: \"DELETE\",\n        signal: options?.signal,\n      }\n    );\n  }\n\n  /**\n   * List assistants.\n   * @param query Query options.\n   * @returns List of assistants or, when includePagination is true, a mapping with the assistants and next cursor.\n   */\n  async search(query: {\n    graphId?: string;\n    name?: string;\n    metadata?: Metadata;\n    limit?: number;\n    offset?: number;\n    sortBy?: AssistantSortBy;\n    sortOrder?: SortOrder;\n    select?: AssistantSelectField[];\n    includePagination: true;\n    signal?: AbortSignal;\n  }): Promise<AssistantsSearchResponse>;\n\n  async search(query?: {\n    graphId?: string;\n    name?: string;\n    metadata?: Metadata;\n    limit?: number;\n    offset?: number;\n    sortBy?: AssistantSortBy;\n    sortOrder?: SortOrder;\n    select?: AssistantSelectField[];\n    includePagination?: false;\n    signal?: AbortSignal;\n  }): Promise<Assistant[]>;\n\n  async search(query?: {\n    graphId?: string;\n    name?: string;\n    metadata?: Metadata;\n    limit?: number;\n    offset?: number;\n    sortBy?: AssistantSortBy;\n    sortOrder?: SortOrder;\n    select?: AssistantSelectField[];\n    includePagination?: boolean;\n    signal?: AbortSignal;\n  }): Promise<Assistant[] | AssistantsSearchResponse> {\n    const json = {\n      graph_id: query?.graphId ?? undefined,\n      name: query?.name ?? undefined,\n      metadata: query?.metadata ?? undefined,\n      limit: query?.limit ?? 10,\n      offset: query?.offset ?? 0,\n      sort_by: query?.sortBy ?? undefined,\n      sort_order: query?.sortOrder ?? undefined,\n      select: query?.select ?? undefined,\n    };\n    const [assistants, response] = await this.fetch<Assistant[]>(\n      \"/assistants/search\",\n      {\n        method: \"POST\",\n        json,\n        withResponse: true,\n        signal: query?.signal,\n      }\n    );\n\n    if (query?.includePagination) {\n      const next = response.headers.get(\"X-Pagination-Next\");\n      return { assistants, next };\n    }\n\n    return assistants;\n  }\n\n  /**\n   * Count assistants matching filters.\n   *\n   * @param query.metadata Metadata to filter by. Exact match for each key/value.\n   * @param query.graphId Optional graph id to filter by.\n   * @param query.name Optional name to filter by.\n   * @returns Number of assistants matching the criteria.\n   */\n  async count(query?: {\n    metadata?: Metadata;\n    graphId?: string;\n    name?: string;\n    signal?: AbortSignal;\n  }): Promise<number> {\n    return this.fetch<number>(`/assistants/count`, {\n      method: \"POST\",\n      json: {\n        metadata: query?.metadata ?? undefined,\n        graph_id: query?.graphId ?? undefined,\n        name: query?.name ?? undefined,\n      },\n      signal: query?.signal,\n    });\n  }\n\n  /**\n   * List all versions of an assistant.\n   *\n   * @param assistantId ID of the assistant.\n   * @returns List of assistant versions.\n   */\n  async getVersions(\n    assistantId: string,\n    payload?: {\n      metadata?: Metadata;\n      limit?: number;\n      offset?: number;\n      signal?: AbortSignal;\n    }\n  ): Promise<AssistantVersion[]> {\n    return this.fetch<AssistantVersion[]>(\n      `/assistants/${assistantId}/versions`,\n      {\n        method: \"POST\",\n        json: {\n          metadata: payload?.metadata ?? undefined,\n          limit: payload?.limit ?? 10,\n          offset: payload?.offset ?? 0,\n        },\n        signal: payload?.signal,\n      }\n    );\n  }\n\n  /**\n   * Change the version of an assistant.\n   *\n   * @param assistantId ID of the assistant.\n   * @param version The version to change to.\n   * @returns The updated assistant.\n   */\n  async setLatest(\n    assistantId: string,\n    version: number,\n    options?: { signal?: AbortSignal }\n  ): Promise<Assistant> {\n    return this.fetch<Assistant>(`/assistants/${assistantId}/latest`, {\n      method: \"POST\",\n      json: { version },\n      signal: options?.signal,\n    });\n  }\n}\n"],"mappings":"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"}

package/dist/client/base.cjs

@@ -0,0 +1,190 @@
+const require_async_caller = require("../utils/async_caller.cjs");
+const require_env = require("../utils/env.cjs");
+const require_signals = require("../utils/signals.cjs");
+const require_sse = require("../utils/sse.cjs");
+const require_stream = require("../utils/stream.cjs");
+//#region src/client/base.ts
+function* iterateHeaders(headers) {
+	let iter;
+	let shouldClear = false;
+	if (headers instanceof Headers) {
+		const entries = [];
+		headers.forEach((value, name) => {
+			entries.push([name, value]);
+		});
+		iter = entries;
+	} else if (Array.isArray(headers)) iter = headers;
+	else {
+		shouldClear = true;
+		iter = Object.entries(headers ?? {});
+	}
+	for (const item of iter) {
+		const name = item[0];
+		if (typeof name !== "string") throw new TypeError(`Expected header name to be a string, got ${typeof name}`);
+		const values = Array.isArray(item[1]) ? item[1] : [item[1]];
+		let didClear = false;
+		for (const value of values) {
+			if (value === void 0) continue;
+			if (shouldClear && !didClear) {
+				didClear = true;
+				yield [name, null];
+			}
+			yield [name, value];
+		}
+	}
+}
+function mergeHeaders(...headerObjects) {
+	const outputHeaders = new Headers();
+	for (const headers of headerObjects) {
+		if (!headers) continue;
+		for (const [name, value] of iterateHeaders(headers)) if (value === null) outputHeaders.delete(name);
+		else outputHeaders.append(name, value);
+	}
+	const headerEntries = [];
+	outputHeaders.forEach((value, name) => {
+		headerEntries.push([name, value]);
+	});
+	return Object.fromEntries(headerEntries);
+}
+/**
+* Get the API key from the environment.
+* Precedence:
+*   1. explicit argument (if string)
+*   2. LANGGRAPH_API_KEY
+*   3. LANGSMITH_API_KEY
+*   4. LANGCHAIN_API_KEY
+*
+* @param apiKey - API key provided as an argument. If null, skips environment lookup. If undefined, tries environment.
+* @returns The API key if found, otherwise undefined
+*/
+function getApiKey(apiKey) {
+	if (apiKey === null) return;
+	if (apiKey) return apiKey;
+	for (const prefix of [
+		"LANGGRAPH",
+		"LANGSMITH",
+		"LANGCHAIN"
+	]) {
+		const envKey = require_env.getEnvironmentVariable(`${prefix}_API_KEY`);
+		if (envKey) return envKey.trim().replace(/^["']|["']$/g, "");
+	}
+}
+var BaseClient = class {
+	asyncCaller;
+	timeoutMs;
+	apiUrl;
+	defaultHeaders;
+	onRequest;
+	streamProtocol;
+	constructor(config) {
+		const callerOptions = {
+			maxRetries: 4,
+			maxConcurrency: 4,
+			...config?.callerOptions
+		};
+		let defaultApiUrl = "http://localhost:8123";
+		if (!config?.apiUrl && typeof globalThis === "object" && globalThis != null) {
+			const fetchSmb = Symbol.for("langgraph_api:fetch");
+			const urlSmb = Symbol.for("langgraph_api:url");
+			const global = globalThis;
+			if (global[fetchSmb]) callerOptions.fetch ??= global[fetchSmb];
+			if (global[urlSmb]) defaultApiUrl = global[urlSmb];
+		}
+		this.asyncCaller = new require_async_caller.AsyncCaller(callerOptions);
+		this.timeoutMs = config?.timeoutMs;
+		this.apiUrl = config?.apiUrl?.replace(/\/$/, "") || defaultApiUrl;
+		this.defaultHeaders = config?.defaultHeaders || {};
+		this.onRequest = config?.onRequest;
+		this.streamProtocol = config?.streamProtocol ?? "legacy";
+		const apiKey = getApiKey(config?.apiKey);
+		if (apiKey) this.defaultHeaders["x-api-key"] = apiKey;
+	}
+	prepareFetchOptions(path, options) {
+		const mutatedOptions = {
+			...options,
+			headers: mergeHeaders(this.defaultHeaders, options?.headers)
+		};
+		if (mutatedOptions.json) {
+			mutatedOptions.body = JSON.stringify(mutatedOptions.json);
+			mutatedOptions.headers = mergeHeaders(mutatedOptions.headers, { "content-type": "application/json" });
+			delete mutatedOptions.json;
+		}
+		if (mutatedOptions.withResponse) delete mutatedOptions.withResponse;
+		let timeoutSignal = null;
+		if (typeof options?.timeoutMs !== "undefined") {
+			if (options.timeoutMs != null) timeoutSignal = AbortSignal.timeout(options.timeoutMs);
+		} else if (this.timeoutMs != null) timeoutSignal = AbortSignal.timeout(this.timeoutMs);
+		mutatedOptions.signal = require_signals.mergeSignals(timeoutSignal, mutatedOptions.signal);
+		const targetUrl = new URL(`${this.apiUrl}${path}`);
+		if (mutatedOptions.params) {
+			for (const [key, value] of Object.entries(mutatedOptions.params)) {
+				if (value == null) continue;
+				const strValue = typeof value === "string" || typeof value === "number" ? value.toString() : JSON.stringify(value);
+				targetUrl.searchParams.append(key, strValue);
+			}
+			delete mutatedOptions.params;
+		}
+		return [targetUrl, mutatedOptions];
+	}
+	async fetch(path, options) {
+		const [url, init] = this.prepareFetchOptions(path, options);
+		let finalInit = init;
+		if (this.onRequest) finalInit = await this.onRequest(url, init);
+		const response = await this.asyncCaller.fetch(url.toString(), finalInit);
+		const body = (() => {
+			if (response.status === 202 || response.status === 204) return;
+			return response.json();
+		})();
+		if (options?.withResponse) return [await body, response];
+		return body;
+	}
+	async *streamWithRetry(config) {
+		const makeRequest = async (reconnectParams) => {
+			const requestEndpoint = reconnectParams?.reconnectPath || config.endpoint;
+			const isReconnect = !!reconnectParams?.reconnectPath;
+			const method = isReconnect ? "GET" : config.method || "GET";
+			const requestHeaders = isReconnect && reconnectParams?.lastEventId ? {
+				...config.headers,
+				"Last-Event-ID": reconnectParams.lastEventId
+			} : config.headers;
+			let [url, init] = this.prepareFetchOptions(requestEndpoint, {
+				method,
+				timeoutMs: null,
+				signal: config.signal,
+				headers: requestHeaders,
+				params: config.params,
+				json: isReconnect ? void 0 : config.json
+			});
+			if (this.onRequest != null) init = await this.onRequest(url, init);
+			const response = await this.asyncCaller.fetch(url.toString(), init);
+			if (!response.body) throw new Error("Expected response body from stream endpoint");
+			if (!isReconnect && config.onInitialResponse) await config.onInitialResponse(response);
+			return {
+				response,
+				stream: response.body.pipeThrough(require_sse.BytesLineDecoder()).pipeThrough(require_sse.SSEDecoder())
+			};
+		};
+		yield* require_stream.streamWithRetry(makeRequest, {
+			maxRetries: config.maxRetries ?? 5,
+			signal: config.signal,
+			onReconnect: config.onReconnect
+		});
+	}
+};
+const REGEX_RUN_METADATA = /(\/threads\/(?<thread_id>.+))?\/runs\/(?<run_id>.+)/;
+function getRunMetadataFromResponse(response) {
+	const contentLocation = response.headers.get("Content-Location");
+	if (!contentLocation) return void 0;
+	const match = REGEX_RUN_METADATA.exec(contentLocation);
+	if (!match?.groups?.run_id) return void 0;
+	return {
+		run_id: match.groups.run_id,
+		thread_id: match.groups.thread_id || void 0
+	};
+}
+//#endregion
+exports.BaseClient = BaseClient;
+exports.getApiKey = getApiKey;
+exports.getRunMetadataFromResponse = getRunMetadataFromResponse;
+
+//# sourceMappingURL=base.cjs.map

package/dist/client/base.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.cjs","names":["getEnvironmentVariable","AsyncCaller","mergeSignals","BytesLineDecoder","SSEDecoder","streamWithRetry"],"sources":["../../src/client/base.ts"],"sourcesContent":["import { AsyncCaller, AsyncCallerParams } from \"../utils/async_caller.js\";\nimport { getEnvironmentVariable } from \"../utils/env.js\";\nimport { mergeSignals } from \"../utils/signals.js\";\nimport { BytesLineDecoder, SSEDecoder } from \"../utils/sse.js\";\nimport { streamWithRetry, StreamRequestParams } from \"../utils/stream.js\";\nimport type { StreamProtocol } from \"../types.js\";\n\nexport type HeaderValue = string | undefined | null;\n\nexport function* iterateHeaders(\n  headers: HeadersInit | Record<string, HeaderValue>\n): IterableIterator<[string, string | null]> {\n  let iter: Iterable<(HeaderValue | HeaderValue | null[])[]>;\n  let shouldClear = false;\n\n  // eslint-disable-next-line no-instanceof/no-instanceof\n  if (headers instanceof Headers) {\n    const entries: [string, string][] = [];\n    headers.forEach((value, name) => {\n      entries.push([name, value]);\n    });\n    iter = entries;\n  } else if (Array.isArray(headers)) {\n    iter = headers;\n  } else {\n    shouldClear = true;\n    iter = Object.entries(headers ?? {});\n  }\n\n  for (const item of iter) {\n    const name = item[0];\n    if (typeof name !== \"string\")\n      throw new TypeError(\n        `Expected header name to be a string, got ${typeof name}`\n      );\n    const values = Array.isArray(item[1]) ? item[1] : [item[1]];\n    let didClear = false;\n\n    for (const value of values) {\n      if (value === undefined) continue;\n\n      if (shouldClear && !didClear) {\n        didClear = true;\n        yield [name, null];\n      }\n      yield [name, value];\n    }\n  }\n}\n\nexport function mergeHeaders(\n  ...headerObjects: (\n    | HeadersInit\n    | Record<string, HeaderValue>\n    | undefined\n    | null\n  )[]\n) {\n  const outputHeaders = new Headers();\n  for (const headers of headerObjects) {\n    if (!headers) continue;\n    for (const [name, value] of iterateHeaders(headers)) {\n      if (value === null) outputHeaders.delete(name);\n      else outputHeaders.append(name, value);\n    }\n  }\n  const headerEntries: [string, string][] = [];\n  outputHeaders.forEach((value, name) => {\n    headerEntries.push([name, value]);\n  });\n  return Object.fromEntries(headerEntries);\n}\n\n/**\n * Get the API key from the environment.\n * Precedence:\n *   1. explicit argument (if string)\n *   2. LANGGRAPH_API_KEY\n *   3. LANGSMITH_API_KEY\n *   4. LANGCHAIN_API_KEY\n *\n * @param apiKey - API key provided as an argument. If null, skips environment lookup. If undefined, tries environment.\n * @returns The API key if found, otherwise undefined\n */\nexport function getApiKey(apiKey?: string | null): string | undefined {\n  if (apiKey === null) {\n    return undefined;\n  }\n\n  if (apiKey) {\n    return apiKey;\n  }\n\n  const prefixes = [\"LANGGRAPH\", \"LANGSMITH\", \"LANGCHAIN\"];\n\n  for (const prefix of prefixes) {\n    const envKey = getEnvironmentVariable(`${prefix}_API_KEY`);\n    if (envKey) {\n      return envKey.trim().replace(/^[\"']|[\"']$/g, \"\");\n    }\n  }\n\n  return undefined;\n}\n\nexport type RequestHook = (\n  url: URL,\n  init: RequestInit\n) => Promise<RequestInit> | RequestInit;\n\nexport interface ClientConfig {\n  apiUrl?: string;\n  /**\n   * API key for authentication.\n   * - If a string is provided, that key will be used\n   * - If undefined (default), the key will be auto-loaded from environment variables (LANGGRAPH_API_KEY, LANGSMITH_API_KEY, or LANGCHAIN_API_KEY)\n   * - If null, no API key will be set (skips auto-loading)\n   */\n  apiKey?: string | null;\n  callerOptions?: AsyncCallerParams;\n  timeoutMs?: number;\n  defaultHeaders?: Record<string, HeaderValue>;\n  onRequest?: RequestHook;\n  streamProtocol?: StreamProtocol;\n}\n\nexport class BaseClient {\n  protected asyncCaller: AsyncCaller;\n\n  protected timeoutMs: number | undefined;\n\n  protected apiUrl: string;\n\n  protected defaultHeaders: Record<string, HeaderValue>;\n\n  protected onRequest?: RequestHook;\n\n  protected streamProtocol: StreamProtocol;\n\n  constructor(config?: ClientConfig) {\n    const callerOptions = {\n      maxRetries: 4,\n      maxConcurrency: 4,\n      ...config?.callerOptions,\n    };\n\n    let defaultApiUrl = \"http://localhost:8123\";\n    if (\n      !config?.apiUrl &&\n      typeof globalThis === \"object\" &&\n      globalThis != null\n    ) {\n      const fetchSmb = Symbol.for(\"langgraph_api:fetch\");\n      const urlSmb = Symbol.for(\"langgraph_api:url\");\n\n      const global = globalThis as unknown as {\n        [fetchSmb]?: typeof fetch;\n        [urlSmb]?: string;\n      };\n\n      if (global[fetchSmb]) callerOptions.fetch ??= global[fetchSmb];\n      if (global[urlSmb]) defaultApiUrl = global[urlSmb];\n    }\n\n    this.asyncCaller = new AsyncCaller(callerOptions);\n    this.timeoutMs = config?.timeoutMs;\n\n    this.apiUrl = config?.apiUrl?.replace(/\\/$/, \"\") || defaultApiUrl;\n    this.defaultHeaders = config?.defaultHeaders || {};\n    this.onRequest = config?.onRequest;\n    this.streamProtocol = config?.streamProtocol ?? \"legacy\";\n    const apiKey = getApiKey(config?.apiKey);\n    if (apiKey) {\n      this.defaultHeaders[\"x-api-key\"] = apiKey;\n    }\n  }\n\n  protected prepareFetchOptions(\n    path: string,\n    options?: RequestInit & {\n      json?: unknown;\n      params?: Record<string, unknown>;\n      timeoutMs?: number | null;\n      withResponse?: boolean;\n    }\n  ): [url: URL, init: RequestInit] {\n    const mutatedOptions = {\n      ...options,\n      headers: mergeHeaders(this.defaultHeaders, options?.headers),\n    };\n\n    if (mutatedOptions.json) {\n      mutatedOptions.body = JSON.stringify(mutatedOptions.json);\n      mutatedOptions.headers = mergeHeaders(mutatedOptions.headers, {\n        \"content-type\": \"application/json\",\n      });\n      delete mutatedOptions.json;\n    }\n\n    if (mutatedOptions.withResponse) {\n      delete mutatedOptions.withResponse;\n    }\n\n    let timeoutSignal: AbortSignal | null = null;\n    if (typeof options?.timeoutMs !== \"undefined\") {\n      if (options.timeoutMs != null) {\n        timeoutSignal = AbortSignal.timeout(options.timeoutMs);\n      }\n    } else if (this.timeoutMs != null) {\n      timeoutSignal = AbortSignal.timeout(this.timeoutMs);\n    }\n\n    mutatedOptions.signal = mergeSignals(timeoutSignal, mutatedOptions.signal);\n    const targetUrl = new URL(`${this.apiUrl}${path}`);\n\n    if (mutatedOptions.params) {\n      for (const [key, value] of Object.entries(mutatedOptions.params)) {\n        if (value == null) continue;\n\n        const strValue =\n          typeof value === \"string\" || typeof value === \"number\"\n            ? value.toString()\n            : JSON.stringify(value);\n\n        targetUrl.searchParams.append(key, strValue);\n      }\n      delete mutatedOptions.params;\n    }\n\n    return [targetUrl, mutatedOptions];\n  }\n\n  protected async fetch<T>(\n    path: string,\n    options: RequestInit & {\n      json?: unknown;\n      params?: Record<string, unknown>;\n      timeoutMs?: number | null;\n      signal: AbortSignal | undefined;\n      withResponse: true;\n    }\n  ): Promise<[T, Response]>;\n\n  protected async fetch<T>(\n    path: string,\n    options?: RequestInit & {\n      json?: unknown;\n      params?: Record<string, unknown>;\n      timeoutMs?: number | null;\n      signal: AbortSignal | undefined;\n      withResponse?: false;\n    }\n  ): Promise<T>;\n\n  protected async fetch<T>(\n    path: string,\n    options?: RequestInit & {\n      json?: unknown;\n      params?: Record<string, unknown>;\n      timeoutMs?: number | null;\n      signal: AbortSignal | undefined;\n      withResponse?: boolean;\n    }\n  ): Promise<T | [T, Response]> {\n    const [url, init] = this.prepareFetchOptions(path, options);\n\n    let finalInit = init;\n    if (this.onRequest) {\n      finalInit = await this.onRequest(url, init);\n    }\n\n    const response = await this.asyncCaller.fetch(url.toString(), finalInit);\n\n    const body = (() => {\n      if (response.status === 202 || response.status === 204) {\n        return undefined as T;\n      }\n      return response.json() as Promise<T>;\n    })();\n\n    if (options?.withResponse) {\n      return [await body, response];\n    }\n\n    return body;\n  }\n\n  protected async *streamWithRetry<\n    T extends { id?: string; event: string; data: unknown },\n  >(config: {\n    endpoint: string;\n    method?: string;\n    signal?: AbortSignal;\n    headers?: Record<string, string>;\n    params?: Record<string, unknown>;\n    json?: unknown;\n    maxRetries?: number;\n    onReconnect?: (options: {\n      attempt: number;\n      lastEventId?: string;\n      cause: unknown;\n    }) => void;\n    onInitialResponse?: (response: Response) => void | Promise<void>;\n  }): AsyncGenerator<T> {\n    const makeRequest = async (reconnectParams?: StreamRequestParams) => {\n      const requestEndpoint = reconnectParams?.reconnectPath || config.endpoint;\n\n      const isReconnect = !!reconnectParams?.reconnectPath;\n      const method = isReconnect ? \"GET\" : config.method || \"GET\";\n\n      const requestHeaders =\n        isReconnect && reconnectParams?.lastEventId\n          ? { ...config.headers, \"Last-Event-ID\": reconnectParams.lastEventId }\n          : config.headers;\n\n      // oxlint-disable-next-line prefer-const -- init is reassigned by onRequest hook\n      let [url, init] = this.prepareFetchOptions(requestEndpoint, {\n        method,\n        timeoutMs: null,\n        signal: config.signal,\n        headers: requestHeaders,\n        params: config.params,\n        json: isReconnect ? undefined : config.json,\n      });\n\n      if (this.onRequest != null) {\n        init = await this.onRequest(url, init);\n      }\n\n      const response = await this.asyncCaller.fetch(url.toString(), init);\n      if (!response.body) {\n        throw new Error(\"Expected response body from stream endpoint\");\n      }\n\n      if (!isReconnect && config.onInitialResponse) {\n        await config.onInitialResponse(response);\n      }\n\n      const stream: ReadableStream<T> = response.body\n        .pipeThrough(BytesLineDecoder())\n        .pipeThrough(SSEDecoder()) as ReadableStream<T>;\n\n      return { response, stream };\n    };\n\n    yield* streamWithRetry(makeRequest, {\n      maxRetries: config.maxRetries ?? 5,\n      signal: config.signal,\n      onReconnect: config.onReconnect,\n    });\n  }\n}\n\nexport const REGEX_RUN_METADATA =\n  /(\\/threads\\/(?<thread_id>.+))?\\/runs\\/(?<run_id>.+)/;\n\nexport function getRunMetadataFromResponse(\n  response: Response\n): { run_id: string; thread_id?: string } | undefined {\n  const contentLocation = response.headers.get(\"Content-Location\");\n  if (!contentLocation) return undefined;\n\n  const match = REGEX_RUN_METADATA.exec(contentLocation);\n\n  if (!match?.groups?.run_id) return undefined;\n  return {\n    run_id: match.groups.run_id,\n    thread_id: match.groups.thread_id || undefined,\n  };\n}\n\nexport const isRecord = (value: unknown): value is Record<string, unknown> =>\n  typeof value === \"object\" && value !== null;\n"],"mappings":"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"}

package/dist/client/base.d.cts

@@ -0,0 +1,84 @@
+import { AsyncCaller, AsyncCallerParams } from "../utils/async_caller.cjs";
+import { StreamProtocol } from "../types.cjs";
+
+//#region src/client/base.d.ts
+type HeaderValue = string | undefined | null;
+/**
+ * Get the API key from the environment.
+ * Precedence:
+ *   1. explicit argument (if string)
+ *   2. LANGGRAPH_API_KEY
+ *   3. LANGSMITH_API_KEY
+ *   4. LANGCHAIN_API_KEY
+ *
+ * @param apiKey - API key provided as an argument. If null, skips environment lookup. If undefined, tries environment.
+ * @returns The API key if found, otherwise undefined
+ */
+declare function getApiKey(apiKey?: string | null): string | undefined;
+type RequestHook = (url: URL, init: RequestInit) => Promise<RequestInit> | RequestInit;
+interface ClientConfig {
+  apiUrl?: string;
+  /**
+   * API key for authentication.
+   * - If a string is provided, that key will be used
+   * - If undefined (default), the key will be auto-loaded from environment variables (LANGGRAPH_API_KEY, LANGSMITH_API_KEY, or LANGCHAIN_API_KEY)
+   * - If null, no API key will be set (skips auto-loading)
+   */
+  apiKey?: string | null;
+  callerOptions?: AsyncCallerParams;
+  timeoutMs?: number;
+  defaultHeaders?: Record<string, HeaderValue>;
+  onRequest?: RequestHook;
+  streamProtocol?: StreamProtocol;
+}
+declare class BaseClient {
+  protected asyncCaller: AsyncCaller;
+  protected timeoutMs: number | undefined;
+  protected apiUrl: string;
+  protected defaultHeaders: Record<string, HeaderValue>;
+  protected onRequest?: RequestHook;
+  protected streamProtocol: StreamProtocol;
+  constructor(config?: ClientConfig);
+  protected prepareFetchOptions(path: string, options?: RequestInit & {
+    json?: unknown;
+    params?: Record<string, unknown>;
+    timeoutMs?: number | null;
+    withResponse?: boolean;
+  }): [url: URL, init: RequestInit];
+  protected fetch<T>(path: string, options: RequestInit & {
+    json?: unknown;
+    params?: Record<string, unknown>;
+    timeoutMs?: number | null;
+    signal: AbortSignal | undefined;
+    withResponse: true;
+  }): Promise<[T, Response]>;
+  protected fetch<T>(path: string, options?: RequestInit & {
+    json?: unknown;
+    params?: Record<string, unknown>;
+    timeoutMs?: number | null;
+    signal: AbortSignal | undefined;
+    withResponse?: false;
+  }): Promise<T>;
+  protected streamWithRetry<T extends {
+    id?: string;
+    event: string;
+    data: unknown;
+  }>(config: {
+    endpoint: string;
+    method?: string;
+    signal?: AbortSignal;
+    headers?: Record<string, string>;
+    params?: Record<string, unknown>;
+    json?: unknown;
+    maxRetries?: number;
+    onReconnect?: (options: {
+      attempt: number;
+      lastEventId?: string;
+      cause: unknown;
+    }) => void;
+    onInitialResponse?: (response: Response) => void | Promise<void>;
+  }): AsyncGenerator<T>;
+}
+//#endregion
+export { BaseClient, ClientConfig, HeaderValue, RequestHook, getApiKey };
+//# sourceMappingURL=base.d.cts.map

package/dist/client/base.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.cts","names":[],"sources":["../../src/client/base.ts"],"mappings":";;;;KAOY,WAAA;;;AA6EZ;;;;;AAqBA;;;;iBArBgB,SAAA,CAAU,MAAA;AAAA,KAqBd,WAAA,IACV,GAAA,EAAK,GAAA,EACL,IAAA,EAAM,WAAA,KACH,OAAA,CAAQ,WAAA,IAAe,WAAA;AAAA,UAEX,YAAA;EACf,MAAA;EAHqC;;;;;;EAUrC,MAAA;EACA,aAAA,GAAgB,iBAAA;EAChB,SAAA;EACA,cAAA,GAAiB,MAAA,SAAe,WAAA;EAChC,SAAA,GAAY,WAAA;EACZ,cAAA,GAAiB,cAAA;AAAA;AAAA,cAGN,UAAA;EAAA,UACD,WAAA,EAAa,WAAA;EAAA,UAEb,SAAA;EAAA,UAEA,MAAA;EAAA,UAEA,cAAA,EAAgB,MAAA,SAAe,WAAA;EAAA,UAE/B,SAAA,GAAY,WAAA;EAAA,UAEZ,cAAA,EAAgB,cAAA;EAE1B,WAAA,CAAY,MAAA,GAAS,YAAA;EAAA,UAsCX,mBAAA,CACR,IAAA,UACA,OAAA,GAAU,WAAA;IACR,IAAA;IACA,MAAA,GAAS,MAAA;IACT,SAAA;IACA,YAAA;EAAA,KAEA,GAAA,EAAK,GAAA,EAAK,IAAA,EAAM,WAAA;EAAA,UA+CJ,KAAA,GAAA,CACd,IAAA,UACA,OAAA,EAAS,WAAA;IACP,IAAA;IACA,MAAA,GAAS,MAAA;IACT,SAAA;IACA,MAAA,EAAQ,WAAA;IACR,YAAA;EAAA,IAED,OAAA,EAAS,CAAA,EAAG,QAAA;EAAA,UAEC,KAAA,GAAA,CACd,IAAA,UACA,OAAA,GAAU,WAAA;IACR,IAAA;IACA,MAAA,GAAS,MAAA;IACT,SAAA;IACA,MAAA,EAAQ,WAAA;IACR,YAAA;EAAA,IAED,OAAA,CAAQ,CAAA;EAAA,UAmCM,eAAA;IACH,EAAA;IAAa,KAAA;IAAe,IAAA;EAAA,EAAA,CACxC,MAAA;IACA,QAAA;IACA,MAAA;IACA,MAAA,GAAS,WAAA;IACT,OAAA,GAAU,MAAA;IACV,MAAA,GAAS,MAAA;IACT,IAAA;IACA,UAAA;IACA,WAAA,IAAe,OAAA;MACb,OAAA;MACA,WAAA;MACA,KAAA;IAAA;IAEF,iBAAA,IAAqB,QAAA,EAAU,QAAA,YAAoB,OAAA;EAAA,IACjD,cAAA,CAAe,CAAA;AAAA"}