@langchain/langgraph-sdk 1.8.10 → 1.9.0

package/dist/stream/projections/channel.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel.cjs","names":["namespaceKey","isRootNamespace","openProjectionSubscription"],"sources":["../../../src/stream/projections/channel.ts"],"sourcesContent":["/**\n * Raw channel escape hatch.\n *\n * Subscribes to an arbitrary list of channels at an arbitrary\n * namespace and retains a bounded buffer of events. Consumers that\n * need assembly semantics should use `messagesProjection`,\n * `toolCallsProjection`, etc. instead; this one is for inspection,\n * custom reducers, or niche use-cases.\n */\nimport type { Channel, Event } from \"@langchain/protocol\";\nimport type { ProjectionSpec, ProjectionRuntime } from \"../types.js\";\nimport { isRootNamespace, namespaceKey } from \"../namespace.js\";\nimport { openProjectionSubscription } from \"./runtime.js\";\n\n/** Max events retained per raw subscription. Older events are dropped. */\nconst DEFAULT_BUFFER = 4096;\n\nexport interface ChannelProjectionOptions {\n  /**\n   * Maximum number of events retained in the projection snapshot.\n   * Defaults to 4096 so replay-backed discovery hooks can tolerate\n   * bursty token/media streams without dropping early lifecycle events.\n   */\n  bufferSize?: number;\n  /**\n   * Whether to open a real subscription and receive replayed history.\n   * Defaults to true. Set false for live-only root-bus inspection when\n   * replay is unnecessary.\n   */\n  replay?: boolean;\n}\n\nexport function channelProjection(\n  channels: readonly Channel[],\n  namespace: readonly string[],\n  options: ChannelProjectionOptions = {}\n): ProjectionSpec<Event[]> {\n  const chs = [...channels].sort();\n  const ns = [...namespace];\n  const bufferSize = options.bufferSize ?? DEFAULT_BUFFER;\n  const replay = options.replay ?? true;\n  const key = `channel|${bufferSize}|${replay ? \"replay\" : \"live\"}|${chs.join(\",\")}|${namespaceKey(ns)}`;\n\n  return {\n    key,\n    namespace: ns,\n    initial: [],\n    open({ thread, store, rootBus }): ProjectionRuntime {\n      // If this projection is scoped to the root namespace AND every\n      // requested channel is already covered by the controller's root\n      // pump, attach to the shared fan-out instead of opening a\n      // second server subscription. This is the common case for\n      // lightweight event-trace / debug panels.\n      const covered =\n        !replay &&\n        isRootNamespace(ns) &&\n        chs.every((c) => rootBus.channels.includes(c));\n\n      if (covered) {\n        const requestedSet = new Set(chs as Channel[]);\n        // Pre-compute `custom:<name>` sub-filters so incoming events\n        // can be matched in O(1). The server delivers named custom\n        // events as `{ method: \"custom\", params: { data: { name } } }`,\n        // so matching purely on `event.method` would miss them — we\n        // need to peek at `data.name` when the caller asked for a\n        // specific `custom:<name>` channel.\n        const namedCustom = new Set<string>();\n        for (const channel of chs) {\n          if (channel.startsWith(\"custom:\")) {\n            namedCustom.add(channel.slice(\"custom:\".length));\n          }\n        }\n        const matches = (event: Event): boolean => {\n          if (requestedSet.has(event.method as Channel)) return true;\n          if (event.method !== \"custom\" || namedCustom.size === 0) {\n            return false;\n          }\n          const data = (event.params as Record<string, unknown>).data as\n            | { name?: unknown }\n            | undefined;\n          return typeof data?.name === \"string\" && namedCustom.has(data.name);\n        };\n        const push = (event: Event): void => {\n          if (!matches(event)) return;\n          const current = store.getSnapshot();\n          const next =\n            current.length >= bufferSize\n              ? [...current.slice(current.length - bufferSize + 1), event]\n              : [...current, event];\n          store.setValue(next);\n        };\n        const unsubscribe = rootBus.subscribe(push);\n        return {\n          dispose() {\n            unsubscribe();\n          },\n        };\n      }\n\n      return openProjectionSubscription({\n        thread,\n        channels: chs as Channel[],\n        namespace: ns,\n        onEvent(event) {\n          const current = store.getSnapshot();\n          const next =\n            current.length >= bufferSize\n              ? [...current.slice(current.length - bufferSize + 1), event]\n              : [...current, event];\n          store.setValue(next);\n        },\n      });\n    },\n  };\n}\n"],"mappings":";;;;AAeA,MAAM,iBAAiB;AAiBvB,SAAgB,kBACd,UACA,WACA,UAAoC,EAAE,EACb;CACzB,MAAM,MAAM,CAAC,GAAG,SAAS,CAAC,MAAM;CAChC,MAAM,KAAK,CAAC,GAAG,UAAU;CACzB,MAAM,aAAa,QAAQ,cAAc;CACzC,MAAM,SAAS,QAAQ,UAAU;AAGjC,QAAO;EACL,KAHU,WAAW,WAAW,GAAG,SAAS,WAAW,OAAO,GAAG,IAAI,KAAK,IAAI,CAAC,GAAGA,kBAAAA,aAAa,GAAG;EAIlG,WAAW;EACX,SAAS,EAAE;EACX,KAAK,EAAE,QAAQ,OAAO,WAA8B;AAWlD,OAJE,CAAC,UACDC,kBAAAA,gBAAgB,GAAG,IACnB,IAAI,OAAO,MAAM,QAAQ,SAAS,SAAS,EAAE,CAAC,EAEnC;IACX,MAAM,eAAe,IAAI,IAAI,IAAiB;IAO9C,MAAM,8BAAc,IAAI,KAAa;AACrC,SAAK,MAAM,WAAW,IACpB,KAAI,QAAQ,WAAW,UAAU,CAC/B,aAAY,IAAI,QAAQ,MAAM,EAAiB,CAAC;IAGpD,MAAM,WAAW,UAA0B;AACzC,SAAI,aAAa,IAAI,MAAM,OAAkB,CAAE,QAAO;AACtD,SAAI,MAAM,WAAW,YAAY,YAAY,SAAS,EACpD,QAAO;KAET,MAAM,OAAQ,MAAM,OAAmC;AAGvD,YAAO,OAAO,MAAM,SAAS,YAAY,YAAY,IAAI,KAAK,KAAK;;IAErE,MAAM,QAAQ,UAAuB;AACnC,SAAI,CAAC,QAAQ,MAAM,CAAE;KACrB,MAAM,UAAU,MAAM,aAAa;KACnC,MAAM,OACJ,QAAQ,UAAU,aACd,CAAC,GAAG,QAAQ,MAAM,QAAQ,SAAS,aAAa,EAAE,EAAE,MAAM,GAC1D,CAAC,GAAG,SAAS,MAAM;AACzB,WAAM,SAAS,KAAK;;IAEtB,MAAM,cAAc,QAAQ,UAAU,KAAK;AAC3C,WAAO,EACL,UAAU;AACR,kBAAa;OAEhB;;AAGH,UAAOC,gBAAAA,2BAA2B;IAChC;IACA,UAAU;IACV,WAAW;IACX,QAAQ,OAAO;KACb,MAAM,UAAU,MAAM,aAAa;KACnC,MAAM,OACJ,QAAQ,UAAU,aACd,CAAC,GAAG,QAAQ,MAAM,QAAQ,SAAS,aAAa,EAAE,EAAE,MAAM,GAC1D,CAAC,GAAG,SAAS,MAAM;AACzB,WAAM,SAAS,KAAK;;IAEvB,CAAC;;EAEL"}

package/dist/stream/projections/channel.d.cts

@@ -0,0 +1,22 @@
+import { ProjectionSpec } from "../types.cjs";
+import { Channel, Event } from "@langchain/protocol";
+
+//#region src/stream/projections/channel.d.ts
+interface ChannelProjectionOptions {
+  /**
+   * Maximum number of events retained in the projection snapshot.
+   * Defaults to 4096 so replay-backed discovery hooks can tolerate
+   * bursty token/media streams without dropping early lifecycle events.
+   */
+  bufferSize?: number;
+  /**
+   * Whether to open a real subscription and receive replayed history.
+   * Defaults to true. Set false for live-only root-bus inspection when
+   * replay is unnecessary.
+   */
+  replay?: boolean;
+}
+declare function channelProjection(channels: readonly Channel[], namespace: readonly string[], options?: ChannelProjectionOptions): ProjectionSpec<Event[]>;
+//#endregion
+export { ChannelProjectionOptions, channelProjection };
+//# sourceMappingURL=channel.d.cts.map

package/dist/stream/projections/channel.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel.d.cts","names":[],"sources":["../../../src/stream/projections/channel.ts"],"mappings":";;;;UAiBiB,wBAAA;EAgBI;;;;;EAVnB,UAAA;EAUmB;;;;;EAJnB,MAAA;AAAA;AAAA,iBAGc,iBAAA,CACd,QAAA,WAAmB,OAAA,IACnB,SAAA,qBACA,OAAA,GAAS,wBAAA,GACR,cAAA,CAAe,KAAA"}

package/dist/stream/projections/channel.d.ts

@@ -0,0 +1,22 @@
+import { ProjectionSpec } from "../types.js";
+import { Channel, Event } from "@langchain/protocol";
+
+//#region src/stream/projections/channel.d.ts
+interface ChannelProjectionOptions {
+  /**
+   * Maximum number of events retained in the projection snapshot.
+   * Defaults to 4096 so replay-backed discovery hooks can tolerate
+   * bursty token/media streams without dropping early lifecycle events.
+   */
+  bufferSize?: number;
+  /**
+   * Whether to open a real subscription and receive replayed history.
+   * Defaults to true. Set false for live-only root-bus inspection when
+   * replay is unnecessary.
+   */
+  replay?: boolean;
+}
+declare function channelProjection(channels: readonly Channel[], namespace: readonly string[], options?: ChannelProjectionOptions): ProjectionSpec<Event[]>;
+//#endregion
+export { ChannelProjectionOptions, channelProjection };
+//# sourceMappingURL=channel.d.ts.map

package/dist/stream/projections/channel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel.d.ts","names":[],"sources":["../../../src/stream/projections/channel.ts"],"mappings":";;;;UAiBiB,wBAAA;EAgBI;;;;;EAVnB,UAAA;EAUmB;;;;;EAJnB,MAAA;AAAA;AAAA,iBAGc,iBAAA,CACd,QAAA,WAAmB,OAAA,IACnB,SAAA,qBACA,OAAA,GAAS,wBAAA,GACR,cAAA,CAAe,KAAA"}

package/dist/stream/projections/channel.js

@@ -0,0 +1,53 @@
+import { isRootNamespace, namespaceKey } from "../namespace.js";
+import { openProjectionSubscription } from "./runtime.js";
+//#region src/stream/projections/channel.ts
+/** Max events retained per raw subscription. Older events are dropped. */
+const DEFAULT_BUFFER = 4096;
+function channelProjection(channels, namespace, options = {}) {
+	const chs = [...channels].sort();
+	const ns = [...namespace];
+	const bufferSize = options.bufferSize ?? DEFAULT_BUFFER;
+	const replay = options.replay ?? true;
+	return {
+		key: `channel|${bufferSize}|${replay ? "replay" : "live"}|${chs.join(",")}|${namespaceKey(ns)}`,
+		namespace: ns,
+		initial: [],
+		open({ thread, store, rootBus }) {
+			if (!replay && isRootNamespace(ns) && chs.every((c) => rootBus.channels.includes(c))) {
+				const requestedSet = new Set(chs);
+				const namedCustom = /* @__PURE__ */ new Set();
+				for (const channel of chs) if (channel.startsWith("custom:")) namedCustom.add(channel.slice(7));
+				const matches = (event) => {
+					if (requestedSet.has(event.method)) return true;
+					if (event.method !== "custom" || namedCustom.size === 0) return false;
+					const data = event.params.data;
+					return typeof data?.name === "string" && namedCustom.has(data.name);
+				};
+				const push = (event) => {
+					if (!matches(event)) return;
+					const current = store.getSnapshot();
+					const next = current.length >= bufferSize ? [...current.slice(current.length - bufferSize + 1), event] : [...current, event];
+					store.setValue(next);
+				};
+				const unsubscribe = rootBus.subscribe(push);
+				return { dispose() {
+					unsubscribe();
+				} };
+			}
+			return openProjectionSubscription({
+				thread,
+				channels: chs,
+				namespace: ns,
+				onEvent(event) {
+					const current = store.getSnapshot();
+					const next = current.length >= bufferSize ? [...current.slice(current.length - bufferSize + 1), event] : [...current, event];
+					store.setValue(next);
+				}
+			});
+		}
+	};
+}
+//#endregion
+export { channelProjection };
+
+//# sourceMappingURL=channel.js.map

package/dist/stream/projections/channel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel.js","names":[],"sources":["../../../src/stream/projections/channel.ts"],"sourcesContent":["/**\n * Raw channel escape hatch.\n *\n * Subscribes to an arbitrary list of channels at an arbitrary\n * namespace and retains a bounded buffer of events. Consumers that\n * need assembly semantics should use `messagesProjection`,\n * `toolCallsProjection`, etc. instead; this one is for inspection,\n * custom reducers, or niche use-cases.\n */\nimport type { Channel, Event } from \"@langchain/protocol\";\nimport type { ProjectionSpec, ProjectionRuntime } from \"../types.js\";\nimport { isRootNamespace, namespaceKey } from \"../namespace.js\";\nimport { openProjectionSubscription } from \"./runtime.js\";\n\n/** Max events retained per raw subscription. Older events are dropped. */\nconst DEFAULT_BUFFER = 4096;\n\nexport interface ChannelProjectionOptions {\n  /**\n   * Maximum number of events retained in the projection snapshot.\n   * Defaults to 4096 so replay-backed discovery hooks can tolerate\n   * bursty token/media streams without dropping early lifecycle events.\n   */\n  bufferSize?: number;\n  /**\n   * Whether to open a real subscription and receive replayed history.\n   * Defaults to true. Set false for live-only root-bus inspection when\n   * replay is unnecessary.\n   */\n  replay?: boolean;\n}\n\nexport function channelProjection(\n  channels: readonly Channel[],\n  namespace: readonly string[],\n  options: ChannelProjectionOptions = {}\n): ProjectionSpec<Event[]> {\n  const chs = [...channels].sort();\n  const ns = [...namespace];\n  const bufferSize = options.bufferSize ?? DEFAULT_BUFFER;\n  const replay = options.replay ?? true;\n  const key = `channel|${bufferSize}|${replay ? \"replay\" : \"live\"}|${chs.join(\",\")}|${namespaceKey(ns)}`;\n\n  return {\n    key,\n    namespace: ns,\n    initial: [],\n    open({ thread, store, rootBus }): ProjectionRuntime {\n      // If this projection is scoped to the root namespace AND every\n      // requested channel is already covered by the controller's root\n      // pump, attach to the shared fan-out instead of opening a\n      // second server subscription. This is the common case for\n      // lightweight event-trace / debug panels.\n      const covered =\n        !replay &&\n        isRootNamespace(ns) &&\n        chs.every((c) => rootBus.channels.includes(c));\n\n      if (covered) {\n        const requestedSet = new Set(chs as Channel[]);\n        // Pre-compute `custom:<name>` sub-filters so incoming events\n        // can be matched in O(1). The server delivers named custom\n        // events as `{ method: \"custom\", params: { data: { name } } }`,\n        // so matching purely on `event.method` would miss them — we\n        // need to peek at `data.name` when the caller asked for a\n        // specific `custom:<name>` channel.\n        const namedCustom = new Set<string>();\n        for (const channel of chs) {\n          if (channel.startsWith(\"custom:\")) {\n            namedCustom.add(channel.slice(\"custom:\".length));\n          }\n        }\n        const matches = (event: Event): boolean => {\n          if (requestedSet.has(event.method as Channel)) return true;\n          if (event.method !== \"custom\" || namedCustom.size === 0) {\n            return false;\n          }\n          const data = (event.params as Record<string, unknown>).data as\n            | { name?: unknown }\n            | undefined;\n          return typeof data?.name === \"string\" && namedCustom.has(data.name);\n        };\n        const push = (event: Event): void => {\n          if (!matches(event)) return;\n          const current = store.getSnapshot();\n          const next =\n            current.length >= bufferSize\n              ? [...current.slice(current.length - bufferSize + 1), event]\n              : [...current, event];\n          store.setValue(next);\n        };\n        const unsubscribe = rootBus.subscribe(push);\n        return {\n          dispose() {\n            unsubscribe();\n          },\n        };\n      }\n\n      return openProjectionSubscription({\n        thread,\n        channels: chs as Channel[],\n        namespace: ns,\n        onEvent(event) {\n          const current = store.getSnapshot();\n          const next =\n            current.length >= bufferSize\n              ? [...current.slice(current.length - bufferSize + 1), event]\n              : [...current, event];\n          store.setValue(next);\n        },\n      });\n    },\n  };\n}\n"],"mappings":";;;;AAeA,MAAM,iBAAiB;AAiBvB,SAAgB,kBACd,UACA,WACA,UAAoC,EAAE,EACb;CACzB,MAAM,MAAM,CAAC,GAAG,SAAS,CAAC,MAAM;CAChC,MAAM,KAAK,CAAC,GAAG,UAAU;CACzB,MAAM,aAAa,QAAQ,cAAc;CACzC,MAAM,SAAS,QAAQ,UAAU;AAGjC,QAAO;EACL,KAHU,WAAW,WAAW,GAAG,SAAS,WAAW,OAAO,GAAG,IAAI,KAAK,IAAI,CAAC,GAAG,aAAa,GAAG;EAIlG,WAAW;EACX,SAAS,EAAE;EACX,KAAK,EAAE,QAAQ,OAAO,WAA8B;AAWlD,OAJE,CAAC,UACD,gBAAgB,GAAG,IACnB,IAAI,OAAO,MAAM,QAAQ,SAAS,SAAS,EAAE,CAAC,EAEnC;IACX,MAAM,eAAe,IAAI,IAAI,IAAiB;IAO9C,MAAM,8BAAc,IAAI,KAAa;AACrC,SAAK,MAAM,WAAW,IACpB,KAAI,QAAQ,WAAW,UAAU,CAC/B,aAAY,IAAI,QAAQ,MAAM,EAAiB,CAAC;IAGpD,MAAM,WAAW,UAA0B;AACzC,SAAI,aAAa,IAAI,MAAM,OAAkB,CAAE,QAAO;AACtD,SAAI,MAAM,WAAW,YAAY,YAAY,SAAS,EACpD,QAAO;KAET,MAAM,OAAQ,MAAM,OAAmC;AAGvD,YAAO,OAAO,MAAM,SAAS,YAAY,YAAY,IAAI,KAAK,KAAK;;IAErE,MAAM,QAAQ,UAAuB;AACnC,SAAI,CAAC,QAAQ,MAAM,CAAE;KACrB,MAAM,UAAU,MAAM,aAAa;KACnC,MAAM,OACJ,QAAQ,UAAU,aACd,CAAC,GAAG,QAAQ,MAAM,QAAQ,SAAS,aAAa,EAAE,EAAE,MAAM,GAC1D,CAAC,GAAG,SAAS,MAAM;AACzB,WAAM,SAAS,KAAK;;IAEtB,MAAM,cAAc,QAAQ,UAAU,KAAK;AAC3C,WAAO,EACL,UAAU;AACR,kBAAa;OAEhB;;AAGH,UAAO,2BAA2B;IAChC;IACA,UAAU;IACV,WAAW;IACX,QAAQ,OAAO;KACb,MAAM,UAAU,MAAM,aAAa;KACnC,MAAM,OACJ,QAAQ,UAAU,aACd,CAAC,GAAG,QAAQ,MAAM,QAAQ,SAAS,aAAa,EAAE,EAAE,MAAM,GAC1D,CAAC,GAAG,SAAS,MAAM;AACzB,WAAM,SAAS,KAAK;;IAEvB,CAAC;;EAEL"}

package/dist/stream/projections/extension.cjs

@@ -0,0 +1,29 @@
+const require_namespace = require("../namespace.cjs");
+const require_runtime = require("./runtime.cjs");
+//#region src/stream/projections/extension.ts
+function extensionProjection(name, namespace) {
+	const ns = [...namespace];
+	return {
+		key: `extension|${name}|${require_namespace.namespaceKey(ns)}`,
+		namespace: ns,
+		initial: void 0,
+		open({ thread, store }) {
+			return require_runtime.openProjectionSubscription({
+				thread,
+				channels: [`custom:${name}`],
+				namespace: ns,
+				resumeOnPause: true,
+				onEvent(event) {
+					const data = event.params.data;
+					const payload = data?.payload != null && typeof data.payload === "object" && "name" in data.payload ? data.payload : data;
+					if (payload?.name !== name) return;
+					store.setValue(payload.payload);
+				}
+			});
+		}
+	};
+}
+//#endregion
+exports.extensionProjection = extensionProjection;
+
+//# sourceMappingURL=extension.cjs.map

package/dist/stream/projections/extension.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension.cjs","names":["namespaceKey","openProjectionSubscription"],"sources":["../../../src/stream/projections/extension.ts"],"sourcesContent":["/**\n * Namespace-scoped `custom:<name>` projection (stream extension).\n *\n * Opens a `custom` subscription and filters named events client-side.\n * The store retains the most-recent payload for the requested\n * transformer. Consumers that want the entire event history should use\n * the raw channel projection instead.\n */\nimport type { ProjectionSpec, ProjectionRuntime } from \"../types.js\";\nimport type { Event } from \"@langchain/protocol\";\nimport { namespaceKey } from \"../namespace.js\";\nimport { openProjectionSubscription } from \"./runtime.js\";\n\nexport function extensionProjection<T = unknown>(\n  name: string,\n  namespace: readonly string[]\n): ProjectionSpec<T | undefined> {\n  const ns = [...namespace];\n  const key = `extension|${name}|${namespaceKey(ns)}`;\n\n  return {\n    key,\n    namespace: ns,\n    initial: undefined,\n    open({ thread, store }): ProjectionRuntime {\n      return openProjectionSubscription({\n        thread,\n        channels: [`custom:${name}`],\n        namespace: ns,\n        resumeOnPause: true,\n        onEvent(event: Event) {\n          const data = event.params.data as\n            | {\n                name?: unknown;\n                payload?: unknown;\n              }\n            | undefined;\n          const payload =\n            data?.payload != null &&\n            typeof data.payload === \"object\" &&\n            \"name\" in data.payload\n              ? (data.payload as { name?: unknown; payload?: unknown })\n              : data;\n          if (payload?.name !== name) return;\n          store.setValue(payload.payload as T);\n        },\n      });\n    },\n  };\n}\n"],"mappings":";;;AAaA,SAAgB,oBACd,MACA,WAC+B;CAC/B,MAAM,KAAK,CAAC,GAAG,UAAU;AAGzB,QAAO;EACL,KAHU,aAAa,KAAK,GAAGA,kBAAAA,aAAa,GAAG;EAI/C,WAAW;EACX,SAAS,KAAA;EACT,KAAK,EAAE,QAAQ,SAA4B;AACzC,UAAOC,gBAAAA,2BAA2B;IAChC;IACA,UAAU,CAAC,UAAU,OAAO;IAC5B,WAAW;IACX,eAAe;IACf,QAAQ,OAAc;KACpB,MAAM,OAAO,MAAM,OAAO;KAM1B,MAAM,UACJ,MAAM,WAAW,QACjB,OAAO,KAAK,YAAY,YACxB,UAAU,KAAK,UACV,KAAK,UACN;AACN,SAAI,SAAS,SAAS,KAAM;AAC5B,WAAM,SAAS,QAAQ,QAAa;;IAEvC,CAAC;;EAEL"}

package/dist/stream/projections/extension.d.cts

@@ -0,0 +1,7 @@
+import { ProjectionSpec } from "../types.cjs";
+
+//#region src/stream/projections/extension.d.ts
+declare function extensionProjection<T = unknown>(name: string, namespace: readonly string[]): ProjectionSpec<T | undefined>;
+//#endregion
+export { extensionProjection };
+//# sourceMappingURL=extension.d.cts.map

package/dist/stream/projections/extension.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension.d.cts","names":[],"sources":["../../../src/stream/projections/extension.ts"],"mappings":";;;iBAagB,mBAAA,aAAA,CACd,IAAA,UACA,SAAA,sBACC,cAAA,CAAe,CAAA"}

package/dist/stream/projections/extension.d.ts

@@ -0,0 +1,7 @@
+import { ProjectionSpec } from "../types.js";
+
+//#region src/stream/projections/extension.d.ts
+declare function extensionProjection<T = unknown>(name: string, namespace: readonly string[]): ProjectionSpec<T | undefined>;
+//#endregion
+export { extensionProjection };
+//# sourceMappingURL=extension.d.ts.map

package/dist/stream/projections/extension.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension.d.ts","names":[],"sources":["../../../src/stream/projections/extension.ts"],"mappings":";;;iBAagB,mBAAA,aAAA,CACd,IAAA,UACA,SAAA,sBACC,cAAA,CAAe,CAAA"}

package/dist/stream/projections/extension.js

@@ -0,0 +1,29 @@
+import { namespaceKey } from "../namespace.js";
+import { openProjectionSubscription } from "./runtime.js";
+//#region src/stream/projections/extension.ts
+function extensionProjection(name, namespace) {
+	const ns = [...namespace];
+	return {
+		key: `extension|${name}|${namespaceKey(ns)}`,
+		namespace: ns,
+		initial: void 0,
+		open({ thread, store }) {
+			return openProjectionSubscription({
+				thread,
+				channels: [`custom:${name}`],
+				namespace: ns,
+				resumeOnPause: true,
+				onEvent(event) {
+					const data = event.params.data;
+					const payload = data?.payload != null && typeof data.payload === "object" && "name" in data.payload ? data.payload : data;
+					if (payload?.name !== name) return;
+					store.setValue(payload.payload);
+				}
+			});
+		}
+	};
+}
+//#endregion
+export { extensionProjection };
+
+//# sourceMappingURL=extension.js.map

package/dist/stream/projections/extension.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension.js","names":[],"sources":["../../../src/stream/projections/extension.ts"],"sourcesContent":["/**\n * Namespace-scoped `custom:<name>` projection (stream extension).\n *\n * Opens a `custom` subscription and filters named events client-side.\n * The store retains the most-recent payload for the requested\n * transformer. Consumers that want the entire event history should use\n * the raw channel projection instead.\n */\nimport type { ProjectionSpec, ProjectionRuntime } from \"../types.js\";\nimport type { Event } from \"@langchain/protocol\";\nimport { namespaceKey } from \"../namespace.js\";\nimport { openProjectionSubscription } from \"./runtime.js\";\n\nexport function extensionProjection<T = unknown>(\n  name: string,\n  namespace: readonly string[]\n): ProjectionSpec<T | undefined> {\n  const ns = [...namespace];\n  const key = `extension|${name}|${namespaceKey(ns)}`;\n\n  return {\n    key,\n    namespace: ns,\n    initial: undefined,\n    open({ thread, store }): ProjectionRuntime {\n      return openProjectionSubscription({\n        thread,\n        channels: [`custom:${name}`],\n        namespace: ns,\n        resumeOnPause: true,\n        onEvent(event: Event) {\n          const data = event.params.data as\n            | {\n                name?: unknown;\n                payload?: unknown;\n              }\n            | undefined;\n          const payload =\n            data?.payload != null &&\n            typeof data.payload === \"object\" &&\n            \"name\" in data.payload\n              ? (data.payload as { name?: unknown; payload?: unknown })\n              : data;\n          if (payload?.name !== name) return;\n          store.setValue(payload.payload as T);\n        },\n      });\n    },\n  };\n}\n"],"mappings":";;;AAaA,SAAgB,oBACd,MACA,WAC+B;CAC/B,MAAM,KAAK,CAAC,GAAG,UAAU;AAGzB,QAAO;EACL,KAHU,aAAa,KAAK,GAAG,aAAa,GAAG;EAI/C,WAAW;EACX,SAAS,KAAA;EACT,KAAK,EAAE,QAAQ,SAA4B;AACzC,UAAO,2BAA2B;IAChC;IACA,UAAU,CAAC,UAAU,OAAO;IAC5B,WAAW;IACX,eAAe;IACf,QAAQ,OAAc;KACpB,MAAM,OAAO,MAAM,OAAO;KAM1B,MAAM,UACJ,MAAM,WAAW,QACjB,OAAO,KAAK,YAAY,YACxB,UAAU,KAAK,UACV,KAAK,UACN;AACN,SAAI,SAAS,SAAS,KAAM;AAC5B,WAAM,SAAS,QAAQ,QAAa;;IAEvC,CAAC;;EAEL"}

package/dist/stream/projections/index.cjs

@@ -0,0 +1,6 @@
+require("./messages.cjs");
+require("./tool-calls.cjs");
+require("./values.cjs");
+require("./extension.cjs");
+require("./channel.cjs");
+require("./media.cjs");

package/dist/stream/projections/index.d.ts

@@ -0,0 +1,6 @@
+import { messagesProjection } from "./messages.js";
+import { toolCallsProjection } from "./tool-calls.js";
+import { valuesProjection } from "./values.js";
+import { extensionProjection } from "./extension.js";
+import { ChannelProjectionOptions, channelProjection } from "./channel.js";
+import { MediaProjectionOptions, audioProjection, filesProjection, imagesProjection, videoProjection } from "./media.js";

package/dist/stream/projections/index.js

@@ -0,0 +1,7 @@
+import "./messages.js";
+import "./tool-calls.js";
+import "./values.js";
+import "./extension.js";
+import "./channel.js";
+import "./media.js";
+export {};

package/dist/stream/projections/media.cjs

@@ -0,0 +1,81 @@
+const require_media = require("../../client/stream/media.cjs");
+const require_namespace = require("../namespace.cjs");
+const require_runtime = require("./runtime.cjs");
+//#region src/stream/projections/media.ts
+function createMediaProjection(kind, namespace, buildAssembler, options) {
+	const ns = [...namespace];
+	return {
+		key: `${kind}|${require_namespace.namespaceKey(ns)}`,
+		namespace: ns,
+		initial: [],
+		open({ thread, store, rootBus }) {
+			const assembler = buildAssembler((media) => {
+				store.setValue([...store.getSnapshot(), media]);
+			}, options);
+			if (require_namespace.isRootNamespace(ns) && rootBus.channels.includes("messages")) {
+				const unsubscribe = rootBus.subscribe((event) => {
+					if (event.method !== "messages") return;
+					if (!require_namespace.isRootNamespace(event.params.namespace)) return;
+					assembler.consume(event);
+				});
+				return { async dispose() {
+					unsubscribe();
+					for (const media of store.getSnapshot()) try {
+						media.revoke();
+					} catch {}
+					assembler.close();
+				} };
+			}
+			const runtime = require_runtime.openProjectionSubscription({
+				thread,
+				channels: ["messages"],
+				namespace: ns,
+				onEvent(event) {
+					if (event.method !== "messages") return;
+					assembler.consume(event);
+				},
+				onFinally() {
+					assembler.close();
+				}
+			});
+			return { async dispose() {
+				for (const media of store.getSnapshot()) try {
+					media.revoke();
+				} catch {}
+				assembler.close();
+				await runtime.dispose();
+			} };
+		}
+	};
+}
+function audioProjection(namespace, options) {
+	return createMediaProjection("audio", namespace, (push, opts) => new require_media.MediaAssembler({
+		fetch: opts?.fetch,
+		onAudio: (m) => push(m)
+	}), options);
+}
+function imagesProjection(namespace, options) {
+	return createMediaProjection("images", namespace, (push, opts) => new require_media.MediaAssembler({
+		fetch: opts?.fetch,
+		onImage: (m) => push(m)
+	}), options);
+}
+function videoProjection(namespace, options) {
+	return createMediaProjection("video", namespace, (push, opts) => new require_media.MediaAssembler({
+		fetch: opts?.fetch,
+		onVideo: (m) => push(m)
+	}), options);
+}
+function filesProjection(namespace, options) {
+	return createMediaProjection("files", namespace, (push, opts) => new require_media.MediaAssembler({
+		fetch: opts?.fetch,
+		onFile: (m) => push(m)
+	}), options);
+}
+//#endregion
+exports.audioProjection = audioProjection;
+exports.filesProjection = filesProjection;
+exports.imagesProjection = imagesProjection;
+exports.videoProjection = videoProjection;
+
+//# sourceMappingURL=media.cjs.map

package/dist/stream/projections/media.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"media.cjs","names":["namespaceKey","isRootNamespace","openProjectionSubscription","MediaAssembler"],"sources":["../../../src/stream/projections/media.ts"],"sourcesContent":["/**\n * Namespace-scoped media projections.\n *\n * Each factory opens `thread.subscribe({ channels: [\"messages\"],\n * namespaces: [ns] })`, runs the events through a {@link MediaAssembler},\n * filters to one media block type, and surfaces an array of handles\n * that grows as messages with that type are observed.\n *\n * Behaviour mirrors the iterables on `ThreadStream` / `SubgraphHandle` /\n * `SubagentHandle`:\n *  - One handle per `(messageId, blockType)`.\n *  - Yielded on the first matching `content-block-start` — messages\n *    with no matching blocks never appear.\n *  - Errors propagate through `handle.error` / rejected `blob` /\n *    rejected `objectURL`, not through the projection itself.\n *\n * `objectURL`s minted from these handles are caller-owned. The\n * companion `useMediaURL` React hook revokes on unmount; non-React\n * consumers should call `media.revoke()` when done.\n */\nimport type { Event, MessagesEvent } from \"@langchain/protocol\";\nimport { MediaAssembler } from \"../../client/stream/media.js\";\nimport type {\n  AudioMedia,\n  FileMedia,\n  ImageMedia,\n  VideoMedia,\n} from \"../../client/stream/media.js\";\nimport type { ProjectionRuntime, ProjectionSpec } from \"../types.js\";\nimport { isRootNamespace, namespaceKey } from \"../namespace.js\";\nimport { openProjectionSubscription } from \"./runtime.js\";\n\ninterface MediaProjectionOptions {\n  /**\n   * Optional `fetch` for URL-sourced blocks. Forwarded into the\n   * underlying {@link MediaAssembler}.\n   */\n  fetch?: typeof fetch;\n}\n\nfunction createMediaProjection<\n  T extends AudioMedia | ImageMedia | VideoMedia | FileMedia,\n>(\n  kind: \"audio\" | \"images\" | \"video\" | \"files\",\n  namespace: readonly string[],\n  buildAssembler: (\n    push: (m: T) => void,\n    options?: MediaProjectionOptions\n  ) => MediaAssembler,\n  options?: MediaProjectionOptions\n): ProjectionSpec<T[]> {\n  const ns = [...namespace];\n  const key = `${kind}|${namespaceKey(ns)}`;\n\n  return {\n    key,\n    namespace: ns,\n    initial: [],\n    open({ thread, store, rootBus }): ProjectionRuntime {\n      const assembler = buildAssembler((media) => {\n        store.setValue([...store.getSnapshot(), media]);\n      }, options);\n\n      // The root pump is already subscribed to `messages` at root depth 1.\n      // Root-scoped projections attach to it instead of opening a second\n      // server subscription.\n      const rootShortCircuit =\n        isRootNamespace(ns) && rootBus.channels.includes(\"messages\");\n\n      if (rootShortCircuit) {\n        const unsubscribe = rootBus.subscribe((event) => {\n          if (event.method !== \"messages\") return;\n          const matches = isRootNamespace(event.params.namespace);\n          if (!matches) return;\n          assembler.consume(event as MessagesEvent);\n        });\n        return {\n          async dispose() {\n            unsubscribe();\n            for (const media of store.getSnapshot()) {\n              try {\n                media.revoke();\n              } catch {\n                // best-effort\n              }\n            }\n            assembler.close();\n          },\n        };\n      }\n\n      const runtime = openProjectionSubscription({\n        thread,\n        channels: [\"messages\"],\n        namespace: ns,\n        onEvent(event: Event) {\n          if (event.method !== \"messages\") return;\n          assembler.consume(event as MessagesEvent);\n        },\n        onFinally() {\n          assembler.close();\n        },\n      });\n\n      return {\n        async dispose() {\n          // Revoke object URLs minted by handles owned by this\n          // projection so unmount cleans up regardless of whether\n          // individual hooks called `revoke()` themselves.\n          for (const media of store.getSnapshot()) {\n            try {\n              media.revoke();\n            } catch {\n              // best-effort\n            }\n          }\n          assembler.close();\n          await runtime.dispose();\n        },\n      };\n    },\n  };\n}\n\nexport function audioProjection(\n  namespace: readonly string[],\n  options?: MediaProjectionOptions\n): ProjectionSpec<AudioMedia[]> {\n  return createMediaProjection<AudioMedia>(\n    \"audio\",\n    namespace,\n    (push, opts) =>\n      new MediaAssembler({ fetch: opts?.fetch, onAudio: (m) => push(m) }),\n    options\n  );\n}\n\nexport function imagesProjection(\n  namespace: readonly string[],\n  options?: MediaProjectionOptions\n): ProjectionSpec<ImageMedia[]> {\n  return createMediaProjection<ImageMedia>(\n    \"images\",\n    namespace,\n    (push, opts) =>\n      new MediaAssembler({ fetch: opts?.fetch, onImage: (m) => push(m) }),\n    options\n  );\n}\n\nexport function videoProjection(\n  namespace: readonly string[],\n  options?: MediaProjectionOptions\n): ProjectionSpec<VideoMedia[]> {\n  return createMediaProjection<VideoMedia>(\n    \"video\",\n    namespace,\n    (push, opts) =>\n      new MediaAssembler({ fetch: opts?.fetch, onVideo: (m) => push(m) }),\n    options\n  );\n}\n\nexport function filesProjection(\n  namespace: readonly string[],\n  options?: MediaProjectionOptions\n): ProjectionSpec<FileMedia[]> {\n  return createMediaProjection<FileMedia>(\n    \"files\",\n    namespace,\n    (push, opts) =>\n      new MediaAssembler({ fetch: opts?.fetch, onFile: (m) => push(m) }),\n    options\n  );\n}\n\nexport type { MediaProjectionOptions };\n"],"mappings":";;;;AAwCA,SAAS,sBAGP,MACA,WACA,gBAIA,SACqB;CACrB,MAAM,KAAK,CAAC,GAAG,UAAU;AAGzB,QAAO;EACL,KAHU,GAAG,KAAK,GAAGA,kBAAAA,aAAa,GAAG;EAIrC,WAAW;EACX,SAAS,EAAE;EACX,KAAK,EAAE,QAAQ,OAAO,WAA8B;GAClD,MAAM,YAAY,gBAAgB,UAAU;AAC1C,UAAM,SAAS,CAAC,GAAG,MAAM,aAAa,EAAE,MAAM,CAAC;MAC9C,QAAQ;AAQX,OAFEC,kBAAAA,gBAAgB,GAAG,IAAI,QAAQ,SAAS,SAAS,WAAW,EAExC;IACpB,MAAM,cAAc,QAAQ,WAAW,UAAU;AAC/C,SAAI,MAAM,WAAW,WAAY;AAEjC,SAAI,CADYA,kBAAAA,gBAAgB,MAAM,OAAO,UAAU,CACzC;AACd,eAAU,QAAQ,MAAuB;MACzC;AACF,WAAO,EACL,MAAM,UAAU;AACd,kBAAa;AACb,UAAK,MAAM,SAAS,MAAM,aAAa,CACrC,KAAI;AACF,YAAM,QAAQ;aACR;AAIV,eAAU,OAAO;OAEpB;;GAGH,MAAM,UAAUC,gBAAAA,2BAA2B;IACzC;IACA,UAAU,CAAC,WAAW;IACtB,WAAW;IACX,QAAQ,OAAc;AACpB,SAAI,MAAM,WAAW,WAAY;AACjC,eAAU,QAAQ,MAAuB;;IAE3C,YAAY;AACV,eAAU,OAAO;;IAEpB,CAAC;AAEF,UAAO,EACL,MAAM,UAAU;AAId,SAAK,MAAM,SAAS,MAAM,aAAa,CACrC,KAAI;AACF,WAAM,QAAQ;YACR;AAIV,cAAU,OAAO;AACjB,UAAM,QAAQ,SAAS;MAE1B;;EAEJ;;AAGH,SAAgB,gBACd,WACA,SAC8B;AAC9B,QAAO,sBACL,SACA,YACC,MAAM,SACL,IAAIC,cAAAA,eAAe;EAAE,OAAO,MAAM;EAAO,UAAU,MAAM,KAAK,EAAE;EAAE,CAAC,EACrE,QACD;;AAGH,SAAgB,iBACd,WACA,SAC8B;AAC9B,QAAO,sBACL,UACA,YACC,MAAM,SACL,IAAIA,cAAAA,eAAe;EAAE,OAAO,MAAM;EAAO,UAAU,MAAM,KAAK,EAAE;EAAE,CAAC,EACrE,QACD;;AAGH,SAAgB,gBACd,WACA,SAC8B;AAC9B,QAAO,sBACL,SACA,YACC,MAAM,SACL,IAAIA,cAAAA,eAAe;EAAE,OAAO,MAAM;EAAO,UAAU,MAAM,KAAK,EAAE;EAAE,CAAC,EACrE,QACD;;AAGH,SAAgB,gBACd,WACA,SAC6B;AAC7B,QAAO,sBACL,SACA,YACC,MAAM,SACL,IAAIA,cAAAA,eAAe;EAAE,OAAO,MAAM;EAAO,SAAS,MAAM,KAAK,EAAE;EAAE,CAAC,EACpE,QACD"}

package/dist/stream/projections/media.d.cts

@@ -0,0 +1,18 @@
+import { AudioMedia, FileMedia, ImageMedia, VideoMedia } from "../../client/stream/media.cjs";
+import { ProjectionSpec } from "../types.cjs";
+
+//#region src/stream/projections/media.d.ts
+interface MediaProjectionOptions {
+  /**
+   * Optional `fetch` for URL-sourced blocks. Forwarded into the
+   * underlying {@link MediaAssembler}.
+   */
+  fetch?: typeof fetch;
+}
+declare function audioProjection(namespace: readonly string[], options?: MediaProjectionOptions): ProjectionSpec<AudioMedia[]>;
+declare function imagesProjection(namespace: readonly string[], options?: MediaProjectionOptions): ProjectionSpec<ImageMedia[]>;
+declare function videoProjection(namespace: readonly string[], options?: MediaProjectionOptions): ProjectionSpec<VideoMedia[]>;
+declare function filesProjection(namespace: readonly string[], options?: MediaProjectionOptions): ProjectionSpec<FileMedia[]>;
+//#endregion
+export { type MediaProjectionOptions, audioProjection, filesProjection, imagesProjection, videoProjection };
+//# sourceMappingURL=media.d.cts.map

package/dist/stream/projections/media.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media.d.cts","names":[],"sources":["../../../src/stream/projections/media.ts"],"mappings":";;;;UAgCU,sBAAA;;AAJ2D;;;EASnE,KAAA,UAAe,KAAA;AAAA;AAAA,iBAuFD,eAAA,CACd,SAAA,qBACA,OAAA,GAAU,sBAAA,GACT,cAAA,CAAe,UAAA;AAAA,iBAUF,gBAAA,CACd,SAAA,qBACA,OAAA,GAAU,sBAAA,GACT,cAAA,CAAe,UAAA;AAAA,iBAUF,eAAA,CACd,SAAA,qBACA,OAAA,GAAU,sBAAA,GACT,cAAA,CAAe,UAAA;AAAA,iBAUF,eAAA,CACd,SAAA,qBACA,OAAA,GAAU,sBAAA,GACT,cAAA,CAAe,SAAA"}

package/dist/stream/projections/media.d.ts

@@ -0,0 +1,18 @@
+import { AudioMedia, FileMedia, ImageMedia, VideoMedia } from "../../client/stream/media.js";
+import { ProjectionSpec } from "../types.js";
+
+//#region src/stream/projections/media.d.ts
+interface MediaProjectionOptions {
+  /**
+   * Optional `fetch` for URL-sourced blocks. Forwarded into the
+   * underlying {@link MediaAssembler}.
+   */
+  fetch?: typeof fetch;
+}
+declare function audioProjection(namespace: readonly string[], options?: MediaProjectionOptions): ProjectionSpec<AudioMedia[]>;
+declare function imagesProjection(namespace: readonly string[], options?: MediaProjectionOptions): ProjectionSpec<ImageMedia[]>;
+declare function videoProjection(namespace: readonly string[], options?: MediaProjectionOptions): ProjectionSpec<VideoMedia[]>;
+declare function filesProjection(namespace: readonly string[], options?: MediaProjectionOptions): ProjectionSpec<FileMedia[]>;
+//#endregion
+export { type MediaProjectionOptions, audioProjection, filesProjection, imagesProjection, videoProjection };
+//# sourceMappingURL=media.d.ts.map

package/dist/stream/projections/media.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media.d.ts","names":[],"sources":["../../../src/stream/projections/media.ts"],"mappings":";;;;UAgCU,sBAAA;;AAJ2D;;;EASnE,KAAA,UAAe,KAAA;AAAA;AAAA,iBAuFD,eAAA,CACd,SAAA,qBACA,OAAA,GAAU,sBAAA,GACT,cAAA,CAAe,UAAA;AAAA,iBAUF,gBAAA,CACd,SAAA,qBACA,OAAA,GAAU,sBAAA,GACT,cAAA,CAAe,UAAA;AAAA,iBAUF,eAAA,CACd,SAAA,qBACA,OAAA,GAAU,sBAAA,GACT,cAAA,CAAe,UAAA;AAAA,iBAUF,eAAA,CACd,SAAA,qBACA,OAAA,GAAU,sBAAA,GACT,cAAA,CAAe,SAAA"}

package/dist/stream/projections/media.js

@@ -0,0 +1,78 @@
+import { MediaAssembler } from "../../client/stream/media.js";
+import { isRootNamespace, namespaceKey } from "../namespace.js";
+import { openProjectionSubscription } from "./runtime.js";
+//#region src/stream/projections/media.ts
+function createMediaProjection(kind, namespace, buildAssembler, options) {
+	const ns = [...namespace];
+	return {
+		key: `${kind}|${namespaceKey(ns)}`,
+		namespace: ns,
+		initial: [],
+		open({ thread, store, rootBus }) {
+			const assembler = buildAssembler((media) => {
+				store.setValue([...store.getSnapshot(), media]);
+			}, options);
+			if (isRootNamespace(ns) && rootBus.channels.includes("messages")) {
+				const unsubscribe = rootBus.subscribe((event) => {
+					if (event.method !== "messages") return;
+					if (!isRootNamespace(event.params.namespace)) return;
+					assembler.consume(event);
+				});
+				return { async dispose() {
+					unsubscribe();
+					for (const media of store.getSnapshot()) try {
+						media.revoke();
+					} catch {}
+					assembler.close();
+				} };
+			}
+			const runtime = openProjectionSubscription({
+				thread,
+				channels: ["messages"],
+				namespace: ns,
+				onEvent(event) {
+					if (event.method !== "messages") return;
+					assembler.consume(event);
+				},
+				onFinally() {
+					assembler.close();
+				}
+			});
+			return { async dispose() {
+				for (const media of store.getSnapshot()) try {
+					media.revoke();
+				} catch {}
+				assembler.close();
+				await runtime.dispose();
+			} };
+		}
+	};
+}
+function audioProjection(namespace, options) {
+	return createMediaProjection("audio", namespace, (push, opts) => new MediaAssembler({
+		fetch: opts?.fetch,
+		onAudio: (m) => push(m)
+	}), options);
+}
+function imagesProjection(namespace, options) {
+	return createMediaProjection("images", namespace, (push, opts) => new MediaAssembler({
+		fetch: opts?.fetch,
+		onImage: (m) => push(m)
+	}), options);
+}
+function videoProjection(namespace, options) {
+	return createMediaProjection("video", namespace, (push, opts) => new MediaAssembler({
+		fetch: opts?.fetch,
+		onVideo: (m) => push(m)
+	}), options);
+}
+function filesProjection(namespace, options) {
+	return createMediaProjection("files", namespace, (push, opts) => new MediaAssembler({
+		fetch: opts?.fetch,
+		onFile: (m) => push(m)
+	}), options);
+}
+//#endregion
+export { audioProjection, filesProjection, imagesProjection, videoProjection };
+
+//# sourceMappingURL=media.js.map

package/dist/stream/projections/media.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media.js","names":[],"sources":["../../../src/stream/projections/media.ts"],"sourcesContent":["/**\n * Namespace-scoped media projections.\n *\n * Each factory opens `thread.subscribe({ channels: [\"messages\"],\n * namespaces: [ns] })`, runs the events through a {@link MediaAssembler},\n * filters to one media block type, and surfaces an array of handles\n * that grows as messages with that type are observed.\n *\n * Behaviour mirrors the iterables on `ThreadStream` / `SubgraphHandle` /\n * `SubagentHandle`:\n *  - One handle per `(messageId, blockType)`.\n *  - Yielded on the first matching `content-block-start` — messages\n *    with no matching blocks never appear.\n *  - Errors propagate through `handle.error` / rejected `blob` /\n *    rejected `objectURL`, not through the projection itself.\n *\n * `objectURL`s minted from these handles are caller-owned. The\n * companion `useMediaURL` React hook revokes on unmount; non-React\n * consumers should call `media.revoke()` when done.\n */\nimport type { Event, MessagesEvent } from \"@langchain/protocol\";\nimport { MediaAssembler } from \"../../client/stream/media.js\";\nimport type {\n  AudioMedia,\n  FileMedia,\n  ImageMedia,\n  VideoMedia,\n} from \"../../client/stream/media.js\";\nimport type { ProjectionRuntime, ProjectionSpec } from \"../types.js\";\nimport { isRootNamespace, namespaceKey } from \"../namespace.js\";\nimport { openProjectionSubscription } from \"./runtime.js\";\n\ninterface MediaProjectionOptions {\n  /**\n   * Optional `fetch` for URL-sourced blocks. Forwarded into the\n   * underlying {@link MediaAssembler}.\n   */\n  fetch?: typeof fetch;\n}\n\nfunction createMediaProjection<\n  T extends AudioMedia | ImageMedia | VideoMedia | FileMedia,\n>(\n  kind: \"audio\" | \"images\" | \"video\" | \"files\",\n  namespace: readonly string[],\n  buildAssembler: (\n    push: (m: T) => void,\n    options?: MediaProjectionOptions\n  ) => MediaAssembler,\n  options?: MediaProjectionOptions\n): ProjectionSpec<T[]> {\n  const ns = [...namespace];\n  const key = `${kind}|${namespaceKey(ns)}`;\n\n  return {\n    key,\n    namespace: ns,\n    initial: [],\n    open({ thread, store, rootBus }): ProjectionRuntime {\n      const assembler = buildAssembler((media) => {\n        store.setValue([...store.getSnapshot(), media]);\n      }, options);\n\n      // The root pump is already subscribed to `messages` at root depth 1.\n      // Root-scoped projections attach to it instead of opening a second\n      // server subscription.\n      const rootShortCircuit =\n        isRootNamespace(ns) && rootBus.channels.includes(\"messages\");\n\n      if (rootShortCircuit) {\n        const unsubscribe = rootBus.subscribe((event) => {\n          if (event.method !== \"messages\") return;\n          const matches = isRootNamespace(event.params.namespace);\n          if (!matches) return;\n          assembler.consume(event as MessagesEvent);\n        });\n        return {\n          async dispose() {\n            unsubscribe();\n            for (const media of store.getSnapshot()) {\n              try {\n                media.revoke();\n              } catch {\n                // best-effort\n              }\n            }\n            assembler.close();\n          },\n        };\n      }\n\n      const runtime = openProjectionSubscription({\n        thread,\n        channels: [\"messages\"],\n        namespace: ns,\n        onEvent(event: Event) {\n          if (event.method !== \"messages\") return;\n          assembler.consume(event as MessagesEvent);\n        },\n        onFinally() {\n          assembler.close();\n        },\n      });\n\n      return {\n        async dispose() {\n          // Revoke object URLs minted by handles owned by this\n          // projection so unmount cleans up regardless of whether\n          // individual hooks called `revoke()` themselves.\n          for (const media of store.getSnapshot()) {\n            try {\n              media.revoke();\n            } catch {\n              // best-effort\n            }\n          }\n          assembler.close();\n          await runtime.dispose();\n        },\n      };\n    },\n  };\n}\n\nexport function audioProjection(\n  namespace: readonly string[],\n  options?: MediaProjectionOptions\n): ProjectionSpec<AudioMedia[]> {\n  return createMediaProjection<AudioMedia>(\n    \"audio\",\n    namespace,\n    (push, opts) =>\n      new MediaAssembler({ fetch: opts?.fetch, onAudio: (m) => push(m) }),\n    options\n  );\n}\n\nexport function imagesProjection(\n  namespace: readonly string[],\n  options?: MediaProjectionOptions\n): ProjectionSpec<ImageMedia[]> {\n  return createMediaProjection<ImageMedia>(\n    \"images\",\n    namespace,\n    (push, opts) =>\n      new MediaAssembler({ fetch: opts?.fetch, onImage: (m) => push(m) }),\n    options\n  );\n}\n\nexport function videoProjection(\n  namespace: readonly string[],\n  options?: MediaProjectionOptions\n): ProjectionSpec<VideoMedia[]> {\n  return createMediaProjection<VideoMedia>(\n    \"video\",\n    namespace,\n    (push, opts) =>\n      new MediaAssembler({ fetch: opts?.fetch, onVideo: (m) => push(m) }),\n    options\n  );\n}\n\nexport function filesProjection(\n  namespace: readonly string[],\n  options?: MediaProjectionOptions\n): ProjectionSpec<FileMedia[]> {\n  return createMediaProjection<FileMedia>(\n    \"files\",\n    namespace,\n    (push, opts) =>\n      new MediaAssembler({ fetch: opts?.fetch, onFile: (m) => push(m) }),\n    options\n  );\n}\n\nexport type { MediaProjectionOptions };\n"],"mappings":";;;;AAwCA,SAAS,sBAGP,MACA,WACA,gBAIA,SACqB;CACrB,MAAM,KAAK,CAAC,GAAG,UAAU;AAGzB,QAAO;EACL,KAHU,GAAG,KAAK,GAAG,aAAa,GAAG;EAIrC,WAAW;EACX,SAAS,EAAE;EACX,KAAK,EAAE,QAAQ,OAAO,WAA8B;GAClD,MAAM,YAAY,gBAAgB,UAAU;AAC1C,UAAM,SAAS,CAAC,GAAG,MAAM,aAAa,EAAE,MAAM,CAAC;MAC9C,QAAQ;AAQX,OAFE,gBAAgB,GAAG,IAAI,QAAQ,SAAS,SAAS,WAAW,EAExC;IACpB,MAAM,cAAc,QAAQ,WAAW,UAAU;AAC/C,SAAI,MAAM,WAAW,WAAY;AAEjC,SAAI,CADY,gBAAgB,MAAM,OAAO,UAAU,CACzC;AACd,eAAU,QAAQ,MAAuB;MACzC;AACF,WAAO,EACL,MAAM,UAAU;AACd,kBAAa;AACb,UAAK,MAAM,SAAS,MAAM,aAAa,CACrC,KAAI;AACF,YAAM,QAAQ;aACR;AAIV,eAAU,OAAO;OAEpB;;GAGH,MAAM,UAAU,2BAA2B;IACzC;IACA,UAAU,CAAC,WAAW;IACtB,WAAW;IACX,QAAQ,OAAc;AACpB,SAAI,MAAM,WAAW,WAAY;AACjC,eAAU,QAAQ,MAAuB;;IAE3C,YAAY;AACV,eAAU,OAAO;;IAEpB,CAAC;AAEF,UAAO,EACL,MAAM,UAAU;AAId,SAAK,MAAM,SAAS,MAAM,aAAa,CACrC,KAAI;AACF,WAAM,QAAQ;YACR;AAIV,cAAU,OAAO;AACjB,UAAM,QAAQ,SAAS;MAE1B;;EAEJ;;AAGH,SAAgB,gBACd,WACA,SAC8B;AAC9B,QAAO,sBACL,SACA,YACC,MAAM,SACL,IAAI,eAAe;EAAE,OAAO,MAAM;EAAO,UAAU,MAAM,KAAK,EAAE;EAAE,CAAC,EACrE,QACD;;AAGH,SAAgB,iBACd,WACA,SAC8B;AAC9B,QAAO,sBACL,UACA,YACC,MAAM,SACL,IAAI,eAAe;EAAE,OAAO,MAAM;EAAO,UAAU,MAAM,KAAK,EAAE;EAAE,CAAC,EACrE,QACD;;AAGH,SAAgB,gBACd,WACA,SAC8B;AAC9B,QAAO,sBACL,SACA,YACC,MAAM,SACL,IAAI,eAAe;EAAE,OAAO,MAAM;EAAO,UAAU,MAAM,KAAK,EAAE;EAAE,CAAC,EACrE,QACD;;AAGH,SAAgB,gBACd,WACA,SAC6B;AAC7B,QAAO,sBACL,SACA,YACC,MAAM,SACL,IAAI,eAAe;EAAE,OAAO,MAAM;EAAO,SAAS,MAAM,KAAK,EAAE;EAAE,CAAC,EACpE,QACD"}

package/dist/stream/projections/messages.cjs

@@ -0,0 +1,121 @@
+const require_messages = require("../../ui/messages.cjs");
+const require_messages$1 = require("../../client/stream/messages.cjs");
+const require_namespace = require("../namespace.cjs");
+const require_assembled_to_message = require("../assembled-to-message.cjs");
+const require_message_reconciliation = require("../message-reconciliation.cjs");
+const require_runtime = require("./runtime.cjs");
+//#region src/stream/projections/messages.ts
+function messagesProjection(namespace) {
+	const ns = [...namespace];
+	return {
+		key: `messages|${require_namespace.namespaceKey(ns)}`,
+		namespace: ns,
+		initial: [],
+		open({ thread, store, rootBus }) {
+			const assembler = new require_messages$1.MessageAssembler();
+			const roleByKey = /* @__PURE__ */ new Map();
+			const indexById = /* @__PURE__ */ new Map();
+			const streamMessageIds = /* @__PURE__ */ new Set();
+			let valuesMessageIds = /* @__PURE__ */ new Set();
+			if (require_namespace.isRootNamespace(ns) && rootBus.channels.includes("messages")) {
+				const unsubscribe = rootBus.subscribe((event) => {
+					if (event.method !== "messages") return;
+					if (!require_namespace.isRootNamespace(event.params.namespace)) return;
+					applyEvent(event);
+				});
+				return { dispose() {
+					unsubscribe();
+				} };
+			}
+			let disposed = false;
+			const pendingMessages = [];
+			let dirty = false;
+			let flushScheduled = false;
+			const flushChannel = typeof MessageChannel !== "undefined" ? new MessageChannel() : null;
+			const flush = () => {
+				flushScheduled = false;
+				if (!dirty || disposed) return;
+				dirty = false;
+				store.setValue(pendingMessages.slice());
+			};
+			if (flushChannel != null) flushChannel.port1.onmessage = flush;
+			const scheduleFlush = () => {
+				dirty = true;
+				if (flushScheduled) return;
+				flushScheduled = true;
+				if (flushChannel != null) flushChannel.port2.postMessage(null);
+				else setTimeout(flush, 0);
+			};
+			const applyValuesEvent = (event) => {
+				const data = event.params.data;
+				if (data == null || typeof data !== "object" || Array.isArray(data)) return;
+				const rawMessages = data.messages;
+				if (!Array.isArray(rawMessages) || rawMessages.length === 0) return;
+				const reconciliation = require_message_reconciliation.reconcileMessagesFromValues({
+					valueMessages: require_messages.ensureMessageInstances(rawMessages),
+					currentMessages: pendingMessages,
+					currentIndexById: indexById,
+					previousValueMessageIds: valuesMessageIds,
+					streamedMessageIds: streamMessageIds,
+					preferValuesMessage: require_message_reconciliation.shouldPreferValuesMessageForToolCalls
+				});
+				valuesMessageIds = reconciliation.valueMessageIds;
+				const reconciledMessages = [...reconciliation.messages];
+				pendingMessages.length = 0;
+				for (const message of reconciledMessages) pendingMessages.push(message);
+				indexById.clear();
+				for (const [id, idx] of require_message_reconciliation.buildMessageIndex(pendingMessages)) indexById.set(id, idx);
+				scheduleFlush();
+			};
+			const applyEvent = (event) => {
+				const data = event.params.data;
+				if (data.event === "message-start") {
+					const startData = data;
+					const role = startData.role ?? "ai";
+					const extendedRole = startData.role ?? role;
+					const maybeToolCallId = startData.tool_call_id;
+					if (startData.id != null) roleByKey.set(startData.id, {
+						role: extendedRole,
+						toolCallId: maybeToolCallId
+					});
+				}
+				const update = assembler.consume(event);
+				if (update == null) return;
+				const msg = update.message;
+				const id = msg.id;
+				if (id == null) return;
+				const captured = roleByKey.get(id) ?? { role: "ai" };
+				const base = require_assembled_to_message.assembledMessageToBaseMessage(msg, captured.role, { toolCallId: captured.toolCallId });
+				streamMessageIds.add(id);
+				const existingIdx = indexById.get(id);
+				if (existingIdx == null) {
+					indexById.set(id, pendingMessages.length);
+					pendingMessages.push(base);
+				} else pendingMessages[existingIdx] = base;
+				scheduleFlush();
+			};
+			const runtime = require_runtime.openProjectionSubscription({
+				thread,
+				channels: ["messages", "values"],
+				namespace: ns,
+				onEvent(event) {
+					if (event.method === "messages") applyEvent(event);
+					else if (event.method === "values") applyValuesEvent(event);
+				}
+			});
+			return { async dispose() {
+				disposed = true;
+				if (flushChannel != null) {
+					flushChannel.port1.onmessage = null;
+					flushChannel.port1.close();
+					flushChannel.port2.close();
+				}
+				await runtime.dispose();
+			} };
+		}
+	};
+}
+//#endregion
+exports.messagesProjection = messagesProjection;
+
+//# sourceMappingURL=messages.cjs.map