@langchain/langgraph-sdk 1.8.10 → 1.9.0

package/dist/client/store/index.js

@@ -0,0 +1,128 @@
+import { BaseClient } from "../base.js";
+//#region src/client/store/index.ts
+var StoreClient = class extends BaseClient {
+	/**
+	* Store or update an item.
+	*
+	* @param namespace A list of strings representing the namespace path.
+	* @param key The unique identifier for the item within the namespace.
+	* @param value A dictionary containing the item's data.
+	* @param options.index Controls search indexing - null (use defaults), false (disable), or list of field paths to index.
+	* @param options.ttl Optional time-to-live in minutes for the item, or null for no expiration.
+	* @returns Promise<void>
+	*/
+	async putItem(namespace, key, value, options) {
+		namespace.forEach((label) => {
+			if (label.includes(".")) throw new Error(`Invalid namespace label '${label}'. Namespace labels cannot contain periods ('.')`);
+		});
+		const payload = {
+			namespace,
+			key,
+			value,
+			index: options?.index,
+			ttl: options?.ttl
+		};
+		return this.fetch("/store/items", {
+			method: "PUT",
+			json: payload,
+			signal: options?.signal
+		});
+	}
+	/**
+	* Retrieve a single item.
+	*
+	* @param namespace A list of strings representing the namespace path.
+	* @param key The unique identifier for the item.
+	* @param options.refreshTtl Whether to refresh the TTL on this read operation.
+	* @returns Promise<Item>
+	*/
+	async getItem(namespace, key, options) {
+		namespace.forEach((label) => {
+			if (label.includes(".")) throw new Error(`Invalid namespace label '${label}'. Namespace labels cannot contain periods ('.')`);
+		});
+		const params = {
+			namespace: namespace.join("."),
+			key
+		};
+		if (options?.refreshTtl !== void 0) params.refresh_ttl = options.refreshTtl;
+		const response = await this.fetch("/store/items", {
+			params,
+			signal: options?.signal
+		});
+		return response ? {
+			...response,
+			createdAt: response.created_at,
+			updatedAt: response.updated_at
+		} : null;
+	}
+	/**
+	* Delete an item.
+	*
+	* @param namespace A list of strings representing the namespace path.
+	* @param key The unique identifier for the item.
+	* @returns Promise<void>
+	*/
+	async deleteItem(namespace, key, options) {
+		namespace.forEach((label) => {
+			if (label.includes(".")) throw new Error(`Invalid namespace label '${label}'. Namespace labels cannot contain periods ('.')`);
+		});
+		return this.fetch("/store/items", {
+			method: "DELETE",
+			json: {
+				namespace,
+				key
+			},
+			signal: options?.signal
+		});
+	}
+	/**
+	* Search for items within a namespace prefix.
+	*
+	* @param namespacePrefix List of strings representing the namespace prefix.
+	* @param options Search options including filter, pagination, and query.
+	* @returns Promise<SearchItemsResponse>
+	*/
+	async searchItems(namespacePrefix, options) {
+		const payload = {
+			namespace_prefix: namespacePrefix,
+			filter: options?.filter,
+			limit: options?.limit ?? 10,
+			offset: options?.offset ?? 0,
+			query: options?.query,
+			refresh_ttl: options?.refreshTtl
+		};
+		return { items: (await this.fetch("/store/items/search", {
+			method: "POST",
+			json: payload,
+			signal: options?.signal
+		})).items.map((item) => ({
+			...item,
+			createdAt: item.created_at,
+			updatedAt: item.updated_at
+		})) };
+	}
+	/**
+	* List namespaces with optional match conditions.
+	*
+	* @param options Filtering and pagination options for namespaces.
+	* @returns Promise<ListNamespaceResponse>
+	*/
+	async listNamespaces(options) {
+		const payload = {
+			prefix: options?.prefix,
+			suffix: options?.suffix,
+			max_depth: options?.maxDepth,
+			limit: options?.limit ?? 100,
+			offset: options?.offset ?? 0
+		};
+		return this.fetch("/store/namespaces", {
+			method: "POST",
+			json: payload,
+			signal: options?.signal
+		});
+	}
+};
+//#endregion
+export { StoreClient };
+
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/client/store/index.ts"],"sourcesContent":["import {\n  Item,\n  ListNamespaceResponse,\n  SearchItemsResponse,\n} from \"../../schema.js\";\nimport { BaseClient } from \"../base.js\";\n\ninterface APIItem {\n  namespace: string[];\n  key: string;\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  value: Record<string, any>;\n  created_at: string;\n  updated_at: string;\n}\ninterface APISearchItemsResponse {\n  items: APIItem[];\n}\n\nexport class StoreClient extends BaseClient {\n  /**\n   * Store or update an item.\n   *\n   * @param namespace A list of strings representing the namespace path.\n   * @param key The unique identifier for the item within the namespace.\n   * @param value A dictionary containing the item's data.\n   * @param options.index Controls search indexing - null (use defaults), false (disable), or list of field paths to index.\n   * @param options.ttl Optional time-to-live in minutes for the item, or null for no expiration.\n   * @returns Promise<void>\n   */\n  async putItem(\n    namespace: string[],\n    key: string,\n    value: Record<string, unknown>,\n    options?: {\n      index?: false | string[] | null;\n      ttl?: number | null;\n      signal?: AbortSignal;\n    }\n  ): Promise<void> {\n    namespace.forEach((label) => {\n      if (label.includes(\".\")) {\n        throw new Error(\n          `Invalid namespace label '${label}'. Namespace labels cannot contain periods ('.')`\n        );\n      }\n    });\n\n    const payload = {\n      namespace,\n      key,\n      value,\n      index: options?.index,\n      ttl: options?.ttl,\n    };\n\n    return this.fetch<void>(\"/store/items\", {\n      method: \"PUT\",\n      json: payload,\n      signal: options?.signal,\n    });\n  }\n\n  /**\n   * Retrieve a single item.\n   *\n   * @param namespace A list of strings representing the namespace path.\n   * @param key The unique identifier for the item.\n   * @param options.refreshTtl Whether to refresh the TTL on this read operation.\n   * @returns Promise<Item>\n   */\n  async getItem(\n    namespace: string[],\n    key: string,\n    options?: {\n      refreshTtl?: boolean | null;\n      signal?: AbortSignal;\n    }\n  ): Promise<Item | null> {\n    namespace.forEach((label) => {\n      if (label.includes(\".\")) {\n        throw new Error(\n          `Invalid namespace label '${label}'. Namespace labels cannot contain periods ('.')`\n        );\n      }\n    });\n\n    const params: Record<string, unknown> = {\n      namespace: namespace.join(\".\"),\n      key,\n    };\n\n    if (options?.refreshTtl !== undefined) {\n      params.refresh_ttl = options.refreshTtl;\n    }\n\n    const response = await this.fetch<APIItem>(\"/store/items\", {\n      params,\n      signal: options?.signal,\n    });\n\n    return response\n      ? {\n          ...response,\n          createdAt: response.created_at,\n          updatedAt: response.updated_at,\n        }\n      : null;\n  }\n\n  /**\n   * Delete an item.\n   *\n   * @param namespace A list of strings representing the namespace path.\n   * @param key The unique identifier for the item.\n   * @returns Promise<void>\n   */\n  async deleteItem(\n    namespace: string[],\n    key: string,\n    options?: { signal?: AbortSignal }\n  ): Promise<void> {\n    namespace.forEach((label) => {\n      if (label.includes(\".\")) {\n        throw new Error(\n          `Invalid namespace label '${label}'. Namespace labels cannot contain periods ('.')`\n        );\n      }\n    });\n\n    return this.fetch<void>(\"/store/items\", {\n      method: \"DELETE\",\n      json: { namespace, key },\n      signal: options?.signal,\n    });\n  }\n\n  /**\n   * Search for items within a namespace prefix.\n   *\n   * @param namespacePrefix List of strings representing the namespace prefix.\n   * @param options Search options including filter, pagination, and query.\n   * @returns Promise<SearchItemsResponse>\n   */\n  async searchItems(\n    namespacePrefix: string[],\n    options?: {\n      filter?: Record<string, unknown>;\n      limit?: number;\n      offset?: number;\n      query?: string;\n      refreshTtl?: boolean | null;\n      signal?: AbortSignal;\n    }\n  ): Promise<SearchItemsResponse> {\n    const payload = {\n      namespace_prefix: namespacePrefix,\n      filter: options?.filter,\n      limit: options?.limit ?? 10,\n      offset: options?.offset ?? 0,\n      query: options?.query,\n      refresh_ttl: options?.refreshTtl,\n    };\n\n    const response = await this.fetch<APISearchItemsResponse>(\n      \"/store/items/search\",\n      {\n        method: \"POST\",\n        json: payload,\n        signal: options?.signal,\n      }\n    );\n    return {\n      items: response.items.map((item) => ({\n        ...item,\n        createdAt: item.created_at,\n        updatedAt: item.updated_at,\n      })),\n    };\n  }\n\n  /**\n   * List namespaces with optional match conditions.\n   *\n   * @param options Filtering and pagination options for namespaces.\n   * @returns Promise<ListNamespaceResponse>\n   */\n  async listNamespaces(options?: {\n    prefix?: string[];\n    suffix?: string[];\n    maxDepth?: number;\n    limit?: number;\n    offset?: number;\n    signal?: AbortSignal;\n  }): Promise<ListNamespaceResponse> {\n    const payload = {\n      prefix: options?.prefix,\n      suffix: options?.suffix,\n      max_depth: options?.maxDepth,\n      limit: options?.limit ?? 100,\n      offset: options?.offset ?? 0,\n    };\n\n    return this.fetch<ListNamespaceResponse>(\"/store/namespaces\", {\n      method: \"POST\",\n      json: payload,\n      signal: options?.signal,\n    });\n  }\n}\n"],"mappings":";;AAmBA,IAAa,cAAb,cAAiC,WAAW;;;;;;;;;;;CAW1C,MAAM,QACJ,WACA,KACA,OACA,SAKe;AACf,YAAU,SAAS,UAAU;AAC3B,OAAI,MAAM,SAAS,IAAI,CACrB,OAAM,IAAI,MACR,4BAA4B,MAAM,kDACnC;IAEH;EAEF,MAAM,UAAU;GACd;GACA;GACA;GACA,OAAO,SAAS;GAChB,KAAK,SAAS;GACf;AAED,SAAO,KAAK,MAAY,gBAAgB;GACtC,QAAQ;GACR,MAAM;GACN,QAAQ,SAAS;GAClB,CAAC;;;;;;;;;;CAWJ,MAAM,QACJ,WACA,KACA,SAIsB;AACtB,YAAU,SAAS,UAAU;AAC3B,OAAI,MAAM,SAAS,IAAI,CACrB,OAAM,IAAI,MACR,4BAA4B,MAAM,kDACnC;IAEH;EAEF,MAAM,SAAkC;GACtC,WAAW,UAAU,KAAK,IAAI;GAC9B;GACD;AAED,MAAI,SAAS,eAAe,KAAA,EAC1B,QAAO,cAAc,QAAQ;EAG/B,MAAM,WAAW,MAAM,KAAK,MAAe,gBAAgB;GACzD;GACA,QAAQ,SAAS;GAClB,CAAC;AAEF,SAAO,WACH;GACE,GAAG;GACH,WAAW,SAAS;GACpB,WAAW,SAAS;GACrB,GACD;;;;;;;;;CAUN,MAAM,WACJ,WACA,KACA,SACe;AACf,YAAU,SAAS,UAAU;AAC3B,OAAI,MAAM,SAAS,IAAI,CACrB,OAAM,IAAI,MACR,4BAA4B,MAAM,kDACnC;IAEH;AAEF,SAAO,KAAK,MAAY,gBAAgB;GACtC,QAAQ;GACR,MAAM;IAAE;IAAW;IAAK;GACxB,QAAQ,SAAS;GAClB,CAAC;;;;;;;;;CAUJ,MAAM,YACJ,iBACA,SAQ8B;EAC9B,MAAM,UAAU;GACd,kBAAkB;GAClB,QAAQ,SAAS;GACjB,OAAO,SAAS,SAAS;GACzB,QAAQ,SAAS,UAAU;GAC3B,OAAO,SAAS;GAChB,aAAa,SAAS;GACvB;AAUD,SAAO,EACL,QATe,MAAM,KAAK,MAC1B,uBACA;GACE,QAAQ;GACR,MAAM;GACN,QAAQ,SAAS;GAClB,CACF,EAEiB,MAAM,KAAK,UAAU;GACnC,GAAG;GACH,WAAW,KAAK;GAChB,WAAW,KAAK;GACjB,EAAE,EACJ;;;;;;;;CASH,MAAM,eAAe,SAOc;EACjC,MAAM,UAAU;GACd,QAAQ,SAAS;GACjB,QAAQ,SAAS;GACjB,WAAW,SAAS;GACpB,OAAO,SAAS,SAAS;GACzB,QAAQ,SAAS,UAAU;GAC5B;AAED,SAAO,KAAK,MAA6B,qBAAqB;GAC5D,QAAQ;GACR,MAAM;GACN,QAAQ,SAAS;GAClB,CAAC"}

package/dist/client/stream/error.cjs

@@ -0,0 +1,18 @@
+//#region src/client/stream/error.ts
+/**
+* Error wrapper for protocol-level error responses returned by the server.
+*/
+var ProtocolError = class extends Error {
+	code;
+	response;
+	constructor(response) {
+		super(response.message);
+		this.name = "ProtocolError";
+		this.code = response.error;
+		this.response = response;
+	}
+};
+//#endregion
+exports.ProtocolError = ProtocolError;
+
+//# sourceMappingURL=error.cjs.map

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

@@ -0,0 +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"}

package/dist/client/stream/error.d.cts

@@ -0,0 +1,14 @@
+import { ErrorResponse } from "@langchain/protocol";
+
+//#region src/client/stream/error.d.ts
+/**
+ * Error wrapper for protocol-level error responses returned by the server.
+ */
+declare class ProtocolError extends Error {
+  readonly code: ErrorResponse["error"];
+  readonly response: ErrorResponse;
+  constructor(response: ErrorResponse);
+}
+//#endregion
+export { ProtocolError };
+//# sourceMappingURL=error.d.cts.map

package/dist/client/stream/error.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.cts","names":[],"sources":["../../../src/client/stream/error.ts"],"mappings":";;;;;AAKA;cAAa,aAAA,SAAsB,KAAA;EAAA,SACxB,IAAA,EAAM,aAAA;EAAA,SACN,QAAA,EAAU,aAAA;EAEnB,WAAA,CAAY,QAAA,EAAU,aAAA;AAAA"}

package/dist/client/stream/error.d.ts

@@ -0,0 +1,14 @@
+import { ErrorResponse } from "@langchain/protocol";
+
+//#region src/client/stream/error.d.ts
+/**
+ * Error wrapper for protocol-level error responses returned by the server.
+ */
+declare class ProtocolError extends Error {
+  readonly code: ErrorResponse["error"];
+  readonly response: ErrorResponse;
+  constructor(response: ErrorResponse);
+}
+//#endregion
+export { ProtocolError };
+//# sourceMappingURL=error.d.ts.map

package/dist/client/stream/error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.ts","names":[],"sources":["../../../src/client/stream/error.ts"],"mappings":";;;;;AAKA;cAAa,aAAA,SAAsB,KAAA;EAAA,SACxB,IAAA,EAAM,aAAA;EAAA,SACN,QAAA,EAAU,aAAA;EAEnB,WAAA,CAAY,QAAA,EAAU,aAAA;AAAA"}

package/dist/client/stream/error.js

@@ -0,0 +1,18 @@
+//#region src/client/stream/error.ts
+/**
+* Error wrapper for protocol-level error responses returned by the server.
+*/
+var ProtocolError = class extends Error {
+	code;
+	response;
+	constructor(response) {
+		super(response.message);
+		this.name = "ProtocolError";
+		this.code = response.error;
+		this.response = response;
+	}
+};
+//#endregion
+export { ProtocolError };
+
+//# sourceMappingURL=error.js.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,3 @@
+require("./tools.cjs");
+require("./subgraphs.cjs");
+require("./subagents.cjs");

package/dist/client/stream/handles/index.d.ts

@@ -0,0 +1,3 @@
+import { AssembledToolCall, ToolCallStatus } from "./tools.js";
+import { SubagentHandle } from "./subagents.js";
+import { SubgraphHandle, Subscribable } from "./subgraphs.js";

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

@@ -0,0 +1,4 @@
+import "./tools.js";
+import "./subgraphs.js";
+import "./subagents.js";
+export {};

package/dist/client/stream/handles/subagents.cjs

@@ -0,0 +1,263 @@
+const require_multi_cursor_buffer = require("../multi-cursor-buffer.cjs");
+const require_tools = require("./tools.cjs");
+const require_messages = require("../messages.cjs");
+const require_media = require("../media.cjs");
+const require_subgraphs = require("./subgraphs.cjs");
+//#region src/client/stream/handles/subagents.ts
+/**
+* Discovered subagent within a streaming session. Mirrors the
+* in-process `SubagentRunStream` from DeepAgent.
+*
+* Each subagent is discovered when a `tool-started` event with
+* `tool_name === "task"` is observed. The `taskInput` and `output`
+* promises resolve from the task tool's lifecycle events.
+*
+* Use lazy getters (`sub.messages`, `sub.toolCalls`, etc.) for
+* namespace-scoped projections.
+*/
+var SubagentHandle = class {
+	name;
+	callId;
+	taskInput;
+	output;
+	namespace;
+	#session;
+	#messagesIterable;
+	#toolCallsIterable;
+	#subgraphsIterable;
+	#mediaDispatcherStarted = false;
+	#audioBuffer;
+	#imagesBuffer;
+	#videoBuffer;
+	#filesBuffer;
+	constructor(name, callId, namespace, taskInput, output, session) {
+		this.name = name;
+		this.callId = callId;
+		this.namespace = namespace;
+		this.taskInput = taskInput;
+		this.output = output;
+		this.#session = session;
+	}
+	get messages() {
+		if (this.#messagesIterable) return this.#messagesIterable;
+		const buffer = new require_multi_cursor_buffer.MultiCursorBuffer();
+		this.#messagesIterable = buffer;
+		const assembler = new require_messages.StreamingMessageAssembler();
+		this.#startProjection(["messages"], (event) => {
+			if (event.method !== "messages") return;
+			const msg = assembler.consume(event);
+			if (msg) buffer.push(msg);
+		}, () => buffer.close());
+		return buffer;
+	}
+	get toolCalls() {
+		if (this.#toolCallsIterable) return this.#toolCallsIterable;
+		const buffer = new require_multi_cursor_buffer.MultiCursorBuffer();
+		this.#toolCallsIterable = buffer;
+		const assembler = new require_tools.ToolCallAssembler();
+		this.#startProjection(["tools"], (event) => {
+			if (event.method !== "tools") return;
+			const tc = assembler.consume(event);
+			if (tc) buffer.push(tc);
+		}, () => buffer.close());
+		return buffer;
+	}
+	get audio() {
+		this.#ensureMediaDispatcher();
+		return this.#audioBuffer;
+	}
+	get images() {
+		this.#ensureMediaDispatcher();
+		return this.#imagesBuffer;
+	}
+	get video() {
+		this.#ensureMediaDispatcher();
+		return this.#videoBuffer;
+	}
+	get files() {
+		this.#ensureMediaDispatcher();
+		return this.#filesBuffer;
+	}
+	#ensureMediaDispatcher() {
+		if (this.#mediaDispatcherStarted) return;
+		this.#mediaDispatcherStarted = true;
+		const audio = new require_multi_cursor_buffer.MultiCursorBuffer();
+		const images = new require_multi_cursor_buffer.MultiCursorBuffer();
+		const video = new require_multi_cursor_buffer.MultiCursorBuffer();
+		const files = new require_multi_cursor_buffer.MultiCursorBuffer();
+		this.#audioBuffer = audio;
+		this.#imagesBuffer = images;
+		this.#videoBuffer = video;
+		this.#filesBuffer = files;
+		const assembler = new require_media.MediaAssembler({
+			onAudio: (m) => audio.push(m),
+			onImage: (m) => images.push(m),
+			onVideo: (m) => video.push(m),
+			onFile: (m) => files.push(m)
+		});
+		this.#startProjection(["messages"], (event) => {
+			if (event.method !== "messages") return;
+			assembler.consume(event);
+		}, () => {
+			assembler.close();
+			audio.close();
+			images.close();
+			video.close();
+			files.close();
+		});
+	}
+	get subgraphs() {
+		if (this.#subgraphsIterable) return this.#subgraphsIterable;
+		const buffer = new require_multi_cursor_buffer.MultiCursorBuffer();
+		this.#subgraphsIterable = buffer;
+		(async () => {
+			const discovery = new require_subgraphs.SubgraphDiscoveryHandle(await this.#session.subscribe({
+				channels: ["lifecycle"],
+				namespaces: [this.namespace]
+			}), this.#session, this.namespace);
+			for await (const sub of discovery) buffer.push(sub);
+			buffer.close();
+		})();
+		return buffer;
+	}
+	subscribe(paramsOrChannels, options = {}) {
+		if (typeof paramsOrChannels === "object" && !Array.isArray(paramsOrChannels) && "channels" in paramsOrChannels) return this.#session.subscribe({
+			...paramsOrChannels,
+			namespaces: paramsOrChannels.namespaces ?? [this.namespace]
+		});
+		return this.#session.subscribe(paramsOrChannels, {
+			...options,
+			namespaces: options.namespaces ?? [this.namespace]
+		});
+	}
+	async #startProjection(channels, onEvent, onDone) {
+		try {
+			const rawHandle = await this.#session.subscribe({
+				channels,
+				namespaces: [this.namespace]
+			});
+			for await (const event of rawHandle) onEvent(event);
+		} finally {
+			onDone();
+		}
+	}
+};
+/**
+* Async iterable that yields {@link SubagentHandle} instances as task
+* tool calls are discovered from the `tools` channel.
+*
+* Mirrors the in-process `createSubagentTransformer` from DeepAgent:
+* watches for `tool_name === "task"` with `tool-started`, extracts
+* `subagent_type` and `description` from the input, and resolves
+* `output` on `tool-finished`.
+*/
+var SubagentDiscoveryHandle = class {
+	#source;
+	#session;
+	#queue = [];
+	#waiters = [];
+	#pending = /* @__PURE__ */ new Map();
+	#sourcePump;
+	#closed = false;
+	constructor(source, session) {
+		this.#source = source;
+		this.#session = session;
+	}
+	#processEvent(event) {
+		if (event.method !== "tools") return void 0;
+		const tools = event;
+		const data = tools.params.data;
+		const toolCallId = data.tool_call_id;
+		if (data.tool_name === "task" && data.event === "tool-started") {
+			const rawInput = data.input;
+			const input = typeof rawInput === "string" ? JSON.parse(rawInput) : rawInput ?? {};
+			const name = input.subagent_type ?? "unknown";
+			const description = input.description ?? "";
+			let resolveTaskInput;
+			let resolveOutput;
+			let rejectOutput;
+			const taskInput = new Promise((r) => {
+				resolveTaskInput = r;
+			});
+			const output = new Promise((res, rej) => {
+				resolveOutput = res;
+				rejectOutput = rej;
+			});
+			resolveTaskInput(description);
+			this.#pending.set(toolCallId, {
+				resolveOutput,
+				rejectOutput
+			});
+			return new SubagentHandle(name, toolCallId, [...tools.params.namespace], taskInput, output, this.#session);
+		}
+		if (toolCallId) {
+			const pending = this.#pending.get(toolCallId);
+			if (pending) {
+				if (data.event === "tool-finished") {
+					pending.resolveOutput(data.output);
+					this.#pending.delete(toolCallId);
+				} else if (data.event === "tool-error") {
+					const message = data.message ?? "unknown error";
+					pending.rejectOutput(new Error(message));
+					this.#pending.delete(toolCallId);
+				}
+			}
+		}
+	}
+	#start() {
+		if (this.#sourcePump) return;
+		this.#sourcePump = (async () => {
+			for await (const event of this.#source) {
+				const handle = this.#processEvent(event);
+				if (!handle) continue;
+				const waiter = this.#waiters.shift();
+				if (waiter) waiter({
+					done: false,
+					value: handle
+				});
+				else this.#queue.push(handle);
+			}
+			this.#closed = true;
+			for (const pending of this.#pending.values()) pending.resolveOutput(void 0);
+			this.#pending.clear();
+			while (this.#waiters.length > 0) this.#waiters.shift()?.({
+				done: true,
+				value: void 0
+			});
+		})();
+	}
+	async close() {
+		this.#closed = true;
+		await this.#source.unsubscribe();
+	}
+	[Symbol.asyncIterator]() {
+		this.#start();
+		return {
+			next: async () => {
+				if (this.#queue.length > 0) return {
+					done: false,
+					value: this.#queue.shift()
+				};
+				if (this.#closed) return {
+					done: true,
+					value: void 0
+				};
+				return await new Promise((resolve) => {
+					this.#waiters.push(resolve);
+				});
+			},
+			return: async () => {
+				await this.close();
+				return {
+					done: true,
+					value: void 0
+				};
+			}
+		};
+	}
+};
+//#endregion
+exports.SubagentDiscoveryHandle = SubagentDiscoveryHandle;
+exports.SubagentHandle = SubagentHandle;
+
+//# sourceMappingURL=subagents.cjs.map

package/dist/client/stream/handles/subagents.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagents.cjs","names":["#session","#messagesIterable","MultiCursorBuffer","StreamingMessageAssembler","#startProjection","#toolCallsIterable","ToolCallAssembler","#ensureMediaDispatcher","#audioBuffer","#imagesBuffer","#videoBuffer","#filesBuffer","#mediaDispatcherStarted","MediaAssembler","#subgraphsIterable","SubgraphDiscoveryHandle","#source","#queue","#waiters","#pending","#sourcePump","#processEvent","#closed","#start"],"sources":["../../../../src/client/stream/handles/subagents.ts"],"sourcesContent":["import type {\n  Channel,\n  Event,\n  MessagesEvent,\n  SubscribeParams,\n  ToolsEvent,\n} from \"@langchain/protocol\";\nimport type { SubscriptionHandle } from \"../index.js\";\nimport { MultiCursorBuffer } from \"../multi-cursor-buffer.js\";\nimport { StreamingMessageAssembler } from \"../messages.js\";\nimport type { StreamingMessage, StreamingMessageHandle } from \"../messages.js\";\nimport { ToolCallAssembler } from \"./tools.js\";\nimport type { AssembledToolCall } from \"./tools.js\";\nimport { MediaAssembler } from \"../media.js\";\nimport type {\n  AudioMedia,\n  FileMedia,\n  ImageMedia,\n  VideoMedia,\n} from \"../media.js\";\nimport type {\n  EventForChannel,\n  EventForChannels,\n  SubscribeOptions,\n  YieldForChannel,\n  YieldForChannels,\n} from \"../types.js\";\nimport {\n  type Subscribable,\n  type SubgraphHandle,\n  SubgraphDiscoveryHandle,\n} from \"./subgraphs.js\";\n\n/**\n * Discovered subagent within a streaming session. Mirrors the\n * in-process `SubagentRunStream` from DeepAgent.\n *\n * Each subagent is discovered when a `tool-started` event with\n * `tool_name === \"task\"` is observed. The `taskInput` and `output`\n * promises resolve from the task tool's lifecycle events.\n *\n * Use lazy getters (`sub.messages`, `sub.toolCalls`, etc.) for\n * namespace-scoped projections.\n */\nexport class SubagentHandle {\n  readonly name: string;\n  readonly callId: string;\n  readonly taskInput: Promise<string>;\n  readonly output: Promise<unknown>;\n  readonly namespace: string[];\n  readonly #session: Subscribable;\n\n  #messagesIterable?: AsyncIterable<StreamingMessage>;\n  #toolCallsIterable?: AsyncIterable<AssembledToolCall>;\n  #subgraphsIterable?: AsyncIterable<SubgraphHandle>;\n\n  #mediaDispatcherStarted = false;\n  #audioBuffer?: MultiCursorBuffer<AudioMedia>;\n  #imagesBuffer?: MultiCursorBuffer<ImageMedia>;\n  #videoBuffer?: MultiCursorBuffer<VideoMedia>;\n  #filesBuffer?: MultiCursorBuffer<FileMedia>;\n\n  constructor(\n    name: string,\n    callId: string,\n    namespace: string[],\n    taskInput: Promise<string>,\n    output: Promise<unknown>,\n    session: Subscribable\n  ) {\n    this.name = name;\n    this.callId = callId;\n    this.namespace = namespace;\n    this.taskInput = taskInput;\n    this.output = output;\n    this.#session = session;\n  }\n\n  get messages(): AsyncIterable<StreamingMessageHandle> {\n    if (this.#messagesIterable) return this.#messagesIterable;\n    const buffer = new MultiCursorBuffer<StreamingMessage>();\n    this.#messagesIterable = buffer;\n    const assembler = new StreamingMessageAssembler();\n    void this.#startProjection(\n      [\"messages\"],\n      (event) => {\n        if (event.method !== \"messages\") return;\n        const msg = assembler.consume(event as MessagesEvent);\n        if (msg) buffer.push(msg);\n      },\n      () => buffer.close()\n    );\n    return buffer;\n  }\n\n  get toolCalls(): AsyncIterable<AssembledToolCall> {\n    if (this.#toolCallsIterable) return this.#toolCallsIterable;\n    const buffer = new MultiCursorBuffer<AssembledToolCall>();\n    this.#toolCallsIterable = buffer;\n    const assembler = new ToolCallAssembler();\n    void this.#startProjection(\n      [\"tools\"],\n      (event) => {\n        if (event.method !== \"tools\") return;\n        const tc = assembler.consume(event as ToolsEvent);\n        if (tc) buffer.push(tc);\n      },\n      () => buffer.close()\n    );\n    return buffer;\n  }\n\n  get audio(): AsyncIterable<AudioMedia> {\n    this.#ensureMediaDispatcher();\n    return this.#audioBuffer!;\n  }\n\n  get images(): AsyncIterable<ImageMedia> {\n    this.#ensureMediaDispatcher();\n    return this.#imagesBuffer!;\n  }\n\n  get video(): AsyncIterable<VideoMedia> {\n    this.#ensureMediaDispatcher();\n    return this.#videoBuffer!;\n  }\n\n  get files(): AsyncIterable<FileMedia> {\n    this.#ensureMediaDispatcher();\n    return this.#filesBuffer!;\n  }\n\n  #ensureMediaDispatcher(): void {\n    if (this.#mediaDispatcherStarted) return;\n    this.#mediaDispatcherStarted = true;\n    const audio = new MultiCursorBuffer<AudioMedia>();\n    const images = new MultiCursorBuffer<ImageMedia>();\n    const video = new MultiCursorBuffer<VideoMedia>();\n    const files = new MultiCursorBuffer<FileMedia>();\n    this.#audioBuffer = audio;\n    this.#imagesBuffer = images;\n    this.#videoBuffer = video;\n    this.#filesBuffer = files;\n    const assembler = new MediaAssembler({\n      onAudio: (m: AudioMedia) => audio.push(m),\n      onImage: (m: ImageMedia) => images.push(m),\n      onVideo: (m: VideoMedia) => video.push(m),\n      onFile: (m: FileMedia) => files.push(m),\n    });\n    void this.#startProjection(\n      [\"messages\"],\n      (event) => {\n        if (event.method !== \"messages\") return;\n        assembler.consume(event as MessagesEvent);\n      },\n      () => {\n        assembler.close();\n        audio.close();\n        images.close();\n        video.close();\n        files.close();\n      }\n    );\n  }\n\n  get subgraphs(): AsyncIterable<SubgraphHandle> {\n    if (this.#subgraphsIterable) return this.#subgraphsIterable;\n    const buffer = new MultiCursorBuffer<SubgraphHandle>();\n    this.#subgraphsIterable = buffer;\n    void (async () => {\n      const rawHandle = await this.#session.subscribe({\n        channels: [\"lifecycle\"],\n        namespaces: [this.namespace],\n      });\n      const discovery = new SubgraphDiscoveryHandle(\n        rawHandle,\n        this.#session,\n        this.namespace\n      );\n      for await (const sub of discovery) {\n        buffer.push(sub);\n      }\n      buffer.close();\n    })();\n    return buffer;\n  }\n\n  /**\n   * Create a raw channel subscription scoped to this subagent's namespace.\n   */\n  subscribe<TChannel extends Channel>(\n    channel: TChannel,\n    options?: SubscribeOptions\n  ): Promise<\n    SubscriptionHandle<EventForChannel<TChannel>, YieldForChannel<TChannel>>\n  >;\n  subscribe<const TChannels extends readonly Channel[]>(\n    channels: TChannels,\n    options?: SubscribeOptions\n  ): Promise<\n    SubscriptionHandle<EventForChannels<TChannels>, YieldForChannels<TChannels>>\n  >;\n  subscribe(params: SubscribeParams): Promise<SubscriptionHandle<Event>>;\n  subscribe(\n    paramsOrChannels: SubscribeParams | Channel | string | readonly Channel[],\n    options: SubscribeOptions = {}\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  ): Promise<any> {\n    if (\n      typeof paramsOrChannels === \"object\" &&\n      !Array.isArray(paramsOrChannels) &&\n      \"channels\" in paramsOrChannels\n    ) {\n      return this.#session.subscribe({\n        ...paramsOrChannels,\n        namespaces: paramsOrChannels.namespaces ?? [this.namespace],\n      });\n    }\n\n    return this.#session.subscribe(paramsOrChannels as Channel, {\n      ...options,\n      namespaces: options.namespaces ?? [this.namespace],\n    });\n  }\n\n  async #startProjection(\n    channels: Channel[],\n    onEvent: (event: Event) => void,\n    onDone: () => void\n  ): Promise<void> {\n    try {\n      const rawHandle = await this.#session.subscribe({\n        channels,\n        namespaces: [this.namespace],\n      });\n      for await (const event of rawHandle) {\n        onEvent(event);\n      }\n    } finally {\n      onDone();\n    }\n  }\n}\n\n/**\n * Async iterable that yields {@link SubagentHandle} instances as task\n * tool calls are discovered from the `tools` channel.\n *\n * Mirrors the in-process `createSubagentTransformer` from DeepAgent:\n * watches for `tool_name === \"task\"` with `tool-started`, extracts\n * `subagent_type` and `description` from the input, and resolves\n * `output` on `tool-finished`.\n */\nexport class SubagentDiscoveryHandle implements AsyncIterable<SubagentHandle> {\n  readonly #source: SubscriptionHandle<Event>;\n  readonly #session: Subscribable;\n  readonly #queue: SubagentHandle[] = [];\n  readonly #waiters: Array<(value: IteratorResult<SubagentHandle>) => void> =\n    [];\n  readonly #pending = new Map<\n    string,\n    {\n      resolveOutput: (v: unknown) => void;\n      rejectOutput: (e: unknown) => void;\n    }\n  >();\n  #sourcePump?: Promise<void>;\n  #closed = false;\n\n  constructor(source: SubscriptionHandle<Event>, session: Subscribable) {\n    this.#source = source;\n    this.#session = session;\n  }\n\n  #processEvent(event: Event): SubagentHandle | undefined {\n    if (event.method !== \"tools\") return undefined;\n    const tools = event as ToolsEvent;\n    const data = tools.params.data;\n    const toolCallId = (data as Record<string, unknown>).tool_call_id as string;\n    const toolName = (data as Record<string, unknown>).tool_name as string;\n\n    if (toolName === \"task\" && data.event === \"tool-started\") {\n      const rawInput = (data as Record<string, unknown>).input;\n      const input: { description?: string; subagent_type?: string } =\n        typeof rawInput === \"string\"\n          ? JSON.parse(rawInput)\n          : ((rawInput as Record<string, unknown>) ?? {});\n\n      const name = input.subagent_type ?? \"unknown\";\n      const description = input.description ?? \"\";\n\n      let resolveTaskInput!: (v: string) => void;\n      let resolveOutput!: (v: unknown) => void;\n      let rejectOutput!: (e: unknown) => void;\n\n      const taskInput = new Promise<string>((r) => {\n        resolveTaskInput = r;\n      });\n      const output = new Promise<unknown>((res, rej) => {\n        resolveOutput = res;\n        rejectOutput = rej;\n      });\n\n      resolveTaskInput(description);\n      this.#pending.set(toolCallId, { resolveOutput, rejectOutput });\n\n      const namespace = [...tools.params.namespace];\n\n      return new SubagentHandle(\n        name,\n        toolCallId,\n        namespace,\n        taskInput,\n        output,\n        this.#session\n      );\n    }\n\n    if (toolCallId) {\n      const pending = this.#pending.get(toolCallId);\n      if (pending) {\n        if (data.event === \"tool-finished\") {\n          pending.resolveOutput((data as Record<string, unknown>).output);\n          this.#pending.delete(toolCallId);\n        } else if (data.event === \"tool-error\") {\n          const message =\n            ((data as Record<string, unknown>).message as string) ??\n            \"unknown error\";\n          pending.rejectOutput(new Error(message));\n          this.#pending.delete(toolCallId);\n        }\n      }\n    }\n\n    return undefined;\n  }\n\n  #start(): void {\n    if (this.#sourcePump) return;\n    this.#sourcePump = (async () => {\n      for await (const event of this.#source) {\n        const handle = this.#processEvent(event);\n        if (!handle) continue;\n\n        const waiter = this.#waiters.shift();\n        if (waiter) {\n          waiter({ done: false, value: handle });\n        } else {\n          this.#queue.push(handle);\n        }\n      }\n      this.#closed = true;\n      for (const pending of this.#pending.values()) {\n        pending.resolveOutput(undefined);\n      }\n      this.#pending.clear();\n      while (this.#waiters.length > 0) {\n        this.#waiters.shift()?.({ done: true, value: undefined });\n      }\n    })();\n  }\n\n  async close(): Promise<void> {\n    this.#closed = true;\n    await this.#source.unsubscribe();\n  }\n\n  [Symbol.asyncIterator](): AsyncIterator<SubagentHandle> {\n    this.#start();\n    return {\n      next: async () => {\n        if (this.#queue.length > 0) {\n          return { done: false, value: this.#queue.shift()! };\n        }\n        if (this.#closed) {\n          return { done: true, value: undefined };\n        }\n        return await new Promise<IteratorResult<SubagentHandle>>((resolve) => {\n          this.#waiters.push(resolve);\n        });\n      },\n      return: async () => {\n        await this.close();\n        return { done: true, value: undefined };\n      },\n    };\n  }\n}\n"],"mappings":"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"}

package/dist/client/stream/handles/subagents.d.cts

@@ -0,0 +1,45 @@
+import { AssembledToolCall } from "./tools.cjs";
+import { StreamingMessageHandle } from "../messages.cjs";
+import { AudioMedia, FileMedia, ImageMedia, VideoMedia } from "../media.cjs";
+import { EventForChannel, EventForChannels, SubscribeOptions, YieldForChannel, YieldForChannels } from "../types.cjs";
+import { SubgraphHandle, Subscribable } from "./subgraphs.cjs";
+import { SubscriptionHandle } from "../index.cjs";
+import { Channel, Event, SubscribeParams } from "@langchain/protocol";
+
+//#region src/client/stream/handles/subagents.d.ts
+/**
+ * Discovered subagent within a streaming session. Mirrors the
+ * in-process `SubagentRunStream` from DeepAgent.
+ *
+ * Each subagent is discovered when a `tool-started` event with
+ * `tool_name === "task"` is observed. The `taskInput` and `output`
+ * promises resolve from the task tool's lifecycle events.
+ *
+ * Use lazy getters (`sub.messages`, `sub.toolCalls`, etc.) for
+ * namespace-scoped projections.
+ */
+declare class SubagentHandle {
+  #private;
+  readonly name: string;
+  readonly callId: string;
+  readonly taskInput: Promise<string>;
+  readonly output: Promise<unknown>;
+  readonly namespace: string[];
+  constructor(name: string, callId: string, namespace: string[], taskInput: Promise<string>, output: Promise<unknown>, session: Subscribable);
+  get messages(): AsyncIterable<StreamingMessageHandle>;
+  get toolCalls(): AsyncIterable<AssembledToolCall>;
+  get audio(): AsyncIterable<AudioMedia>;
+  get images(): AsyncIterable<ImageMedia>;
+  get video(): AsyncIterable<VideoMedia>;
+  get files(): AsyncIterable<FileMedia>;
+  get subgraphs(): AsyncIterable<SubgraphHandle>;
+  /**
+   * Create a raw channel subscription scoped to this subagent's namespace.
+   */
+  subscribe<TChannel extends Channel>(channel: TChannel, options?: SubscribeOptions): Promise<SubscriptionHandle<EventForChannel<TChannel>, YieldForChannel<TChannel>>>;
+  subscribe<const TChannels extends readonly Channel[]>(channels: TChannels, options?: SubscribeOptions): Promise<SubscriptionHandle<EventForChannels<TChannels>, YieldForChannels<TChannels>>>;
+  subscribe(params: SubscribeParams): Promise<SubscriptionHandle<Event>>;
+}
+//#endregion
+export { SubagentHandle };
+//# sourceMappingURL=subagents.d.cts.map

package/dist/client/stream/handles/subagents.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagents.d.cts","names":[],"sources":["../../../../src/client/stream/handles/subagents.ts"],"mappings":";;;;;;;;;;;AA4CA;;;;;;;;;cAAa,cAAA;EAAA;WACF,IAAA;EAAA,SACA,MAAA;EAAA,SACA,SAAA,EAAW,OAAA;EAAA,SACX,MAAA,EAAQ,OAAA;EAAA,SACR,SAAA;EAaT,WAAA,CACE,IAAA,UACA,MAAA,UACA,SAAA,YACA,SAAA,EAAW,OAAA,UACX,MAAA,EAAQ,OAAA,WACR,OAAA,EAAS,YAAA;EAAA,IAUP,QAAA,CAAA,GAAY,aAAA,CAAc,sBAAA;EAAA,IAiB1B,SAAA,CAAA,GAAa,aAAA,CAAc,iBAAA;EAAA,IAiB3B,KAAA,CAAA,GAAS,aAAA,CAAc,UAAA;EAAA,IAKvB,MAAA,CAAA,GAAU,aAAA,CAAc,UAAA;EAAA,IAKxB,KAAA,CAAA,GAAS,aAAA,CAAc,UAAA;EAAA,IAKvB,KAAA,CAAA,GAAS,aAAA,CAAc,SAAA;EAAA,IAsCvB,SAAA,CAAA,GAAa,aAAA,CAAc,cAAA;EA2BnB;;;EAFZ,SAAA,kBAA2B,OAAA,CAAA,CACzB,OAAA,EAAS,QAAA,EACT,OAAA,GAAU,gBAAA,GACT,OAAA,CACD,kBAAA,CAAmB,eAAA,CAAgB,QAAA,GAAW,eAAA,CAAgB,QAAA;EAEhE,SAAA,kCAA2C,OAAA,GAAA,CACzC,QAAA,EAAU,SAAA,EACV,OAAA,GAAU,gBAAA,GACT,OAAA,CACD,kBAAA,CAAmB,gBAAA,CAAiB,SAAA,GAAY,gBAAA,CAAiB,SAAA;EAEnE,SAAA,CAAU,MAAA,EAAQ,eAAA,GAAkB,OAAA,CAAQ,kBAAA,CAAmB,KAAA;AAAA"}

package/dist/client/stream/handles/subagents.d.ts

@@ -0,0 +1,45 @@
+import { AssembledToolCall } from "./tools.js";
+import { StreamingMessageHandle } from "../messages.js";
+import { AudioMedia, FileMedia, ImageMedia, VideoMedia } from "../media.js";
+import { EventForChannel, EventForChannels, SubscribeOptions, YieldForChannel, YieldForChannels } from "../types.js";
+import { SubgraphHandle, Subscribable } from "./subgraphs.js";
+import { SubscriptionHandle } from "../index.js";
+import { Channel, Event, SubscribeParams } from "@langchain/protocol";
+
+//#region src/client/stream/handles/subagents.d.ts
+/**
+ * Discovered subagent within a streaming session. Mirrors the
+ * in-process `SubagentRunStream` from DeepAgent.
+ *
+ * Each subagent is discovered when a `tool-started` event with
+ * `tool_name === "task"` is observed. The `taskInput` and `output`
+ * promises resolve from the task tool's lifecycle events.
+ *
+ * Use lazy getters (`sub.messages`, `sub.toolCalls`, etc.) for
+ * namespace-scoped projections.
+ */
+declare class SubagentHandle {
+  #private;
+  readonly name: string;
+  readonly callId: string;
+  readonly taskInput: Promise<string>;
+  readonly output: Promise<unknown>;
+  readonly namespace: string[];
+  constructor(name: string, callId: string, namespace: string[], taskInput: Promise<string>, output: Promise<unknown>, session: Subscribable);
+  get messages(): AsyncIterable<StreamingMessageHandle>;
+  get toolCalls(): AsyncIterable<AssembledToolCall>;
+  get audio(): AsyncIterable<AudioMedia>;
+  get images(): AsyncIterable<ImageMedia>;
+  get video(): AsyncIterable<VideoMedia>;
+  get files(): AsyncIterable<FileMedia>;
+  get subgraphs(): AsyncIterable<SubgraphHandle>;
+  /**
+   * Create a raw channel subscription scoped to this subagent's namespace.
+   */
+  subscribe<TChannel extends Channel>(channel: TChannel, options?: SubscribeOptions): Promise<SubscriptionHandle<EventForChannel<TChannel>, YieldForChannel<TChannel>>>;
+  subscribe<const TChannels extends readonly Channel[]>(channels: TChannels, options?: SubscribeOptions): Promise<SubscriptionHandle<EventForChannels<TChannels>, YieldForChannels<TChannels>>>;
+  subscribe(params: SubscribeParams): Promise<SubscriptionHandle<Event>>;
+}
+//#endregion
+export { SubagentHandle };
+//# sourceMappingURL=subagents.d.ts.map

package/dist/client/stream/handles/subagents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagents.d.ts","names":[],"sources":["../../../../src/client/stream/handles/subagents.ts"],"mappings":";;;;;;;;;;;AA4CA;;;;;;;;;cAAa,cAAA;EAAA;WACF,IAAA;EAAA,SACA,MAAA;EAAA,SACA,SAAA,EAAW,OAAA;EAAA,SACX,MAAA,EAAQ,OAAA;EAAA,SACR,SAAA;EAaT,WAAA,CACE,IAAA,UACA,MAAA,UACA,SAAA,YACA,SAAA,EAAW,OAAA,UACX,MAAA,EAAQ,OAAA,WACR,OAAA,EAAS,YAAA;EAAA,IAUP,QAAA,CAAA,GAAY,aAAA,CAAc,sBAAA;EAAA,IAiB1B,SAAA,CAAA,GAAa,aAAA,CAAc,iBAAA;EAAA,IAiB3B,KAAA,CAAA,GAAS,aAAA,CAAc,UAAA;EAAA,IAKvB,MAAA,CAAA,GAAU,aAAA,CAAc,UAAA;EAAA,IAKxB,KAAA,CAAA,GAAS,aAAA,CAAc,UAAA;EAAA,IAKvB,KAAA,CAAA,GAAS,aAAA,CAAc,SAAA;EAAA,IAsCvB,SAAA,CAAA,GAAa,aAAA,CAAc,cAAA;EA2BnB;;;EAFZ,SAAA,kBAA2B,OAAA,CAAA,CACzB,OAAA,EAAS,QAAA,EACT,OAAA,GAAU,gBAAA,GACT,OAAA,CACD,kBAAA,CAAmB,eAAA,CAAgB,QAAA,GAAW,eAAA,CAAgB,QAAA;EAEhE,SAAA,kCAA2C,OAAA,GAAA,CACzC,QAAA,EAAU,SAAA,EACV,OAAA,GAAU,gBAAA,GACT,OAAA,CACD,kBAAA,CAAmB,gBAAA,CAAiB,SAAA,GAAY,gBAAA,CAAiB,SAAA;EAEnE,SAAA,CAAU,MAAA,EAAQ,eAAA,GAAkB,OAAA,CAAQ,kBAAA,CAAmB,KAAA;AAAA"}