@langchain/angular 1.0.17 → 1.0.18

package/dist/selectors.cjs

@@ -107,6 +107,11 @@ function injectValues(stream, target, options) {
 /**
 * Subscribe to a `custom:<name>` stream extension — the most recent
 * payload emitted by the transformer, scoped to the target namespace.
+*
+* Returns only the latest value and resumes across serial runs, so it is
+* ideal for "current state" panels (progress, score, status). When you
+* need the full history of events rather than just the latest payload,
+* use {@link injectChannel} instead.
 */
 function injectExtension(stream, name, target) {
 	const { namespace, key } = normalizeTarget(target, `extension|${name}`);

package/dist/selectors.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"selectors.cjs","names":["STREAM_CONTROLLER","NAMESPACE_SEPARATOR","injectProjection","getRegistry"],"sources":["../src/selectors.ts"],"sourcesContent":["import { computed, effect, isSignal, type Signal } from \"@angular/core\";\nimport type { BaseMessage } from \"@langchain/core/messages\";\nimport {\n  NAMESPACE_SEPARATOR,\n  audioProjection,\n  channelProjection,\n  extensionProjection,\n  filesProjection,\n  imagesProjection,\n  messagesProjection,\n  toolCallsProjection,\n  valuesProjection,\n  videoProjection,\n  type AssembledToolCall,\n  type AudioMedia,\n  type Channel,\n  type ChannelProjectionOptions,\n  type Event,\n  type FileMedia,\n  type ImageMedia,\n  type InferToolCalls,\n  type InferStateType,\n  type SubagentDiscoverySnapshot,\n  type SubgraphDiscoverySnapshot,\n  type VideoMedia,\n} from \"@langchain/langgraph-sdk/stream\";\nimport {\n  getRegistry,\n  STREAM_CONTROLLER,\n  type AnyStream,\n  type UseStreamReturn,\n} from \"./use-stream.js\";\nimport { injectProjection } from \"./inject-projection.js\";\n\n/**\n * Selector primitives don't need to carry `InterruptType` /\n * `ConfigurableType`. Parameterising on `StateType` alone lets\n * callers with a full `injectStream<S, I, C>()` handle pass it in\n * without redeclaring those generics at every call site.\n */\ntype StreamHandle<StateType extends object> = UseStreamReturn<\n  StateType,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  any,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  any\n>;\n\n/**\n * What a selector primitive can be targeted at. Callers can pass:\n *  - `undefined` / `null` — root namespace (served by the always-on\n *    root store — no extra subscription);\n *  - a {@link SubagentDiscoverySnapshot} (`stream.subagents().get(...)`);\n *  - a {@link SubgraphDiscoverySnapshot} (`stream.subgraphs().get(...)`);\n *  - an explicit `{ namespace: string[] }`;\n *  - a raw `string[]` escape hatch.\n *\n * Selectors also accept a `Signal<SelectorTarget>` so callers can\n * feed a `computed(() => ...)` and have the projection rebind\n * automatically.\n */\nexport type SelectorTarget =\n  | undefined\n  | null\n  | readonly string[]\n  | { namespace: readonly string[] }\n  | SubagentDiscoverySnapshot\n  | SubgraphDiscoverySnapshot;\n\nconst EMPTY_NAMESPACE: readonly string[] = [];\n\nfunction resolveNamespace(target: SelectorTarget): readonly string[] {\n  if (target == null) return EMPTY_NAMESPACE;\n  if (Array.isArray(target)) return target as readonly string[];\n  const obj = target as { namespace?: readonly string[] };\n  return obj.namespace ?? EMPTY_NAMESPACE;\n}\n\nfunction isRoot(namespace: readonly string[]): boolean {\n  return namespace.length === 0;\n}\n\n/**\n * If `target` is a subagent snapshot still on its default\n * `tools:<toolCallId>` namespace, return that tool-call id. See the\n * React selectors for the rationale (deep-agent subagents execute under\n * a distinct `tools:<uuid>` namespace resolved lazily from history).\n */\nfunction subagentNeedingNamespace(target: SelectorTarget): string | null {\n  if (target == null || Array.isArray(target)) return null;\n  const obj = target as { id?: unknown; namespace?: readonly string[] };\n  if (typeof obj.id !== \"string\" || !Array.isArray(obj.namespace)) return null;\n  if (obj.namespace.length === 1 && obj.namespace[0] === `tools:${obj.id}`) {\n    return obj.id;\n  }\n  return null;\n}\n\n/**\n * Lazily resolve a subagent's execution namespace on first scoped use.\n * Must be called from an injection context (as the selector primitives\n * are). A `Signal` target re-evaluates via an `effect`; a static target\n * resolves once. The controller de-dupes and skips already-promoted\n * ids.\n */\nfunction resolveSubagentNamespaceFor(\n  stream: AnyStream,\n  target: SelectorTarget | Signal<SelectorTarget>\n): void {\n  const controller = stream[STREAM_CONTROLLER];\n  if (isSignal(target)) {\n    effect(() => {\n      const id = subagentNeedingNamespace((target as Signal<SelectorTarget>)());\n      if (id != null) void controller.resolveSubagentNamespace(id);\n    });\n    return;\n  }\n  const id = subagentNeedingNamespace(target as SelectorTarget);\n  if (id != null) void controller.resolveSubagentNamespace(id);\n}\n\nfunction namespaceKey(namespace: readonly string[]): string {\n  return namespace.join(NAMESPACE_SEPARATOR);\n}\n\n/**\n * Resolve a target or target-signal into a reactive\n * `[namespace, key]` pair. The helper returns plain signals so\n * `injectProjection` can track them via its internal effect.\n */\nfunction normalizeTarget(\n  target: SelectorTarget | Signal<SelectorTarget>,\n  prefix: string\n): {\n  namespace: Signal<readonly string[]>;\n  key: Signal<string>;\n  isRootSignal: Signal<boolean>;\n} {\n  if (isSignal(target)) {\n    const namespace = computed(() =>\n      resolveNamespace((target as Signal<SelectorTarget>)())\n    );\n    const key = computed(() => `${prefix}|${namespaceKey(namespace())}`);\n    const isRootSignal = computed(() => isRoot(namespace()));\n    return { namespace, key, isRootSignal };\n  }\n  const ns = resolveNamespace(target as SelectorTarget);\n  const staticKey = `${prefix}|${namespaceKey(ns)}`;\n  return {\n    namespace: computed(() => ns),\n    key: computed(() => staticKey),\n    isRootSignal: computed(() => isRoot(ns)),\n  };\n}\n\n/**\n * Subscribe to a scoped `messages` stream.\n *\n * Contract:\n *  - At the root (no `target`) this returns `stream.messages` — the\n *    always-on root projection; no extra subscription is opened.\n *  - For any non-root namespace, call-time triggers a ref-counted\n *    `messages` subscription scoped to that namespace. The\n *    subscription is released automatically when the calling\n *    component / service is destroyed (and the registry closes the\n *    underlying server subscription when the last consumer leaves).\n *\n * Messages are always `BaseMessage` class instances from\n * `@langchain/core/messages`.\n */\nexport function injectMessages(\n  stream: AnyStream,\n  target?: SelectorTarget | Signal<SelectorTarget>\n): Signal<BaseMessage[]> {\n  resolveSubagentNamespaceFor(\n    stream,\n    target as SelectorTarget | Signal<SelectorTarget>\n  );\n  const { namespace, key, isRootSignal } = normalizeTarget(\n    target as SelectorTarget | Signal<SelectorTarget>,\n    \"messages\"\n  );\n  const registry = computed(() =>\n    isRootSignal() ? null : getRegistry(stream)\n  );\n  const scoped = injectProjection<BaseMessage[]>(\n    registry,\n    () => messagesProjection(namespace()),\n    key,\n    EMPTY_MESSAGES\n  );\n  return computed(() => (isRootSignal() ? stream.messages() : scoped()));\n}\n\nconst EMPTY_MESSAGES: BaseMessage[] = [];\n\n/**\n * Subscribe to a scoped `tools` (tool-call) stream. Same target and\n * lifecycle rules as {@link injectMessages}; at the root this returns\n * `stream.toolCalls` directly.\n */\nexport function injectToolCalls(\n  stream: AnyStream,\n  target?: SelectorTarget | Signal<SelectorTarget>\n): Signal<AssembledToolCall[]>;\nexport function injectToolCalls<T>(\n  stream: AnyStream,\n  target?: SelectorTarget | Signal<SelectorTarget>\n): Signal<InferToolCalls<T>[]>;\nexport function injectToolCalls(\n  stream: AnyStream,\n  target?: SelectorTarget | Signal<SelectorTarget>\n): Signal<AssembledToolCall[]> {\n  resolveSubagentNamespaceFor(\n    stream,\n    target as SelectorTarget | Signal<SelectorTarget>\n  );\n  const { namespace, key, isRootSignal } = normalizeTarget(\n    target as SelectorTarget | Signal<SelectorTarget>,\n    \"toolCalls\"\n  );\n  const registry = computed(() =>\n    isRootSignal() ? null : getRegistry(stream)\n  );\n  const scoped = injectProjection<AssembledToolCall[]>(\n    registry,\n    () => toolCallsProjection(namespace()),\n    key,\n    EMPTY_TOOLCALLS\n  );\n  return computed(() => (isRootSignal() ? stream.toolCalls() : scoped()));\n}\n\nconst EMPTY_TOOLCALLS: AssembledToolCall[] = [];\n\n/**\n * Subscribe to a scoped `values` stream — the most recent state\n * payload for a namespace. At the root returns `stream.values`.\n *\n * Typing:\n *  - **Root** (`injectValues(stream)`): returns the `StateType`\n *    declared on `injectStream<State>()` — non-nullable (the root\n *    snapshot always has values, falling back to `initialValues ??\n *    {}`).\n *  - **Scoped** (`injectValues(stream, target)`): scoped payloads can\n *    differ from the root state; callers should annotate the expected\n *    shape explicitly (`injectValues<SubagentState>(stream, sub)`).\n *    Defaults to `unknown` when not annotated.\n */\nexport function injectValues<StateType extends object>(\n  stream: StreamHandle<StateType>\n): Signal<StateType>;\nexport function injectValues<T>(stream: AnyStream): Signal<InferStateType<T>>;\nexport function injectValues<T = unknown>(\n  stream: AnyStream,\n  target: SelectorTarget | Signal<SelectorTarget>,\n  options?: { messagesKey?: string }\n): Signal<T | undefined>;\nexport function injectValues(\n  stream: AnyStream,\n  target?: SelectorTarget | Signal<SelectorTarget>,\n  options?: { messagesKey?: string }\n): Signal<unknown> {\n  const messagesKey = options?.messagesKey ?? \"messages\";\n  const { namespace, key, isRootSignal } = normalizeTarget(\n    target as SelectorTarget | Signal<SelectorTarget>,\n    `values|${messagesKey}`\n  );\n  const registry = computed(() =>\n    isRootSignal() ? null : getRegistry(stream)\n  );\n  const scoped = injectProjection<unknown>(\n    registry,\n    () => valuesProjection<unknown>(namespace(), messagesKey),\n    key,\n    undefined\n  );\n  return computed(() => (isRootSignal() ? stream.values() : scoped()));\n}\n\n/**\n * Subscribe to a `custom:<name>` stream extension — the most recent\n * payload emitted by the transformer, scoped to the target namespace.\n */\nexport function injectExtension<T = unknown>(\n  stream: AnyStream,\n  name: string,\n  target?: SelectorTarget | Signal<SelectorTarget>\n): Signal<T | undefined> {\n  const { namespace, key } = normalizeTarget(\n    target as SelectorTarget | Signal<SelectorTarget>,\n    `extension|${name}`\n  );\n  return injectProjection<T | undefined>(\n    getRegistry(stream),\n    () => extensionProjection<T>(name, namespace()),\n    key,\n    undefined\n  );\n}\n\n/**\n * Raw-events escape hatch. Subscribes to one or more channels at a\n * namespace and returns a bounded buffer of raw protocol events.\n * Prefer {@link injectMessages} / {@link injectToolCalls} /\n * {@link injectValues} for the common cases.\n */\nexport type InjectChannelOptions = ChannelProjectionOptions;\n\nexport function injectChannel(\n  stream: AnyStream,\n  channels: readonly Channel[],\n  target?: SelectorTarget | Signal<SelectorTarget>,\n  options?: InjectChannelOptions\n): Signal<Event[]> {\n  const sortedChannels = [...channels].sort().join(\",\");\n  const prefix = `channel|${options?.bufferSize ?? \"default\"}|${(options?.replay ?? true) ? \"replay\" : \"live\"}|${sortedChannels}`;\n  const { namespace, key } = normalizeTarget(\n    target as SelectorTarget | Signal<SelectorTarget>,\n    prefix\n  );\n  return injectProjection<Event[]>(\n    getRegistry(stream),\n    () => channelProjection(channels, namespace(), options),\n    key,\n    EMPTY_EVENTS\n  );\n}\n\nconst EMPTY_EVENTS: Event[] = [];\n\n/**\n * Subscribe to a scoped audio-media stream. Each handle is yielded\n * on its first matching `content-block-start`, exposes\n * `.partialBytes` for live access, settles `.blob` / `.objectURL` /\n * `.transcript` on `message-finish`, and surfaces errors via\n * `.error`.\n *\n * Pair with `injectMediaUrl` to turn a handle into an `<audio src>`.\n */\nexport function injectAudio(\n  stream: AnyStream,\n  target?: SelectorTarget | Signal<SelectorTarget>\n): Signal<AudioMedia[]> {\n  const { namespace, key } = normalizeTarget(\n    target as SelectorTarget | Signal<SelectorTarget>,\n    \"audio\"\n  );\n  return injectProjection<AudioMedia[]>(\n    getRegistry(stream),\n    () => audioProjection(namespace()),\n    key,\n    EMPTY_AUDIO\n  );\n}\n\nconst EMPTY_AUDIO: AudioMedia[] = [];\n\n/**\n * Subscribe to a scoped image-media stream. Pair with\n * `injectMediaUrl` for `<img src>`.\n */\nexport function injectImages(\n  stream: AnyStream,\n  target?: SelectorTarget | Signal<SelectorTarget>\n): Signal<ImageMedia[]> {\n  const { namespace, key } = normalizeTarget(\n    target as SelectorTarget | Signal<SelectorTarget>,\n    \"images\"\n  );\n  return injectProjection<ImageMedia[]>(\n    getRegistry(stream),\n    () => imagesProjection(namespace()),\n    key,\n    EMPTY_IMAGES\n  );\n}\n\nconst EMPTY_IMAGES: ImageMedia[] = [];\n\n/**\n * Subscribe to a scoped video-media stream. Pair with\n * `injectMediaUrl` for `<video src>`.\n */\nexport function injectVideo(\n  stream: AnyStream,\n  target?: SelectorTarget | Signal<SelectorTarget>\n): Signal<VideoMedia[]> {\n  const { namespace, key } = normalizeTarget(\n    target as SelectorTarget | Signal<SelectorTarget>,\n    \"video\"\n  );\n  return injectProjection<VideoMedia[]>(\n    getRegistry(stream),\n    () => videoProjection(namespace()),\n    key,\n    EMPTY_VIDEO\n  );\n}\n\nconst EMPTY_VIDEO: VideoMedia[] = [];\n\n/**\n * Subscribe to a scoped file-media stream. Pair with\n * `injectMediaUrl` for an `<a download href>` target.\n */\nexport function injectFiles(\n  stream: AnyStream,\n  target?: SelectorTarget | Signal<SelectorTarget>\n): Signal<FileMedia[]> {\n  const { namespace, key } = normalizeTarget(\n    target as SelectorTarget | Signal<SelectorTarget>,\n    \"files\"\n  );\n  return injectProjection<FileMedia[]>(\n    getRegistry(stream),\n    () => filesProjection(namespace()),\n    key,\n    EMPTY_FILES\n  );\n}\n\nconst EMPTY_FILES: FileMedia[] = [];\n"],"mappings":"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"}
+{"version":3,"file":"selectors.cjs","names":["STREAM_CONTROLLER","NAMESPACE_SEPARATOR","injectProjection","getRegistry"],"sources":["../src/selectors.ts"],"sourcesContent":["import { computed, effect, isSignal, type Signal } from \"@angular/core\";\nimport type { BaseMessage } from \"@langchain/core/messages\";\nimport {\n  NAMESPACE_SEPARATOR,\n  audioProjection,\n  channelProjection,\n  extensionProjection,\n  filesProjection,\n  imagesProjection,\n  messagesProjection,\n  toolCallsProjection,\n  valuesProjection,\n  videoProjection,\n  type AssembledToolCall,\n  type AudioMedia,\n  type Channel,\n  type ChannelProjectionOptions,\n  type Event,\n  type FileMedia,\n  type ImageMedia,\n  type InferToolCalls,\n  type InferStateType,\n  type SubagentDiscoverySnapshot,\n  type SubgraphDiscoverySnapshot,\n  type VideoMedia,\n} from \"@langchain/langgraph-sdk/stream\";\nimport {\n  getRegistry,\n  STREAM_CONTROLLER,\n  type AnyStream,\n  type UseStreamReturn,\n} from \"./use-stream.js\";\nimport { injectProjection } from \"./inject-projection.js\";\n\n/**\n * Selector primitives don't need to carry `InterruptType` /\n * `ConfigurableType`. Parameterising on `StateType` alone lets\n * callers with a full `injectStream<S, I, C>()` handle pass it in\n * without redeclaring those generics at every call site.\n */\ntype StreamHandle<StateType extends object> = UseStreamReturn<\n  StateType,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  any,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  any\n>;\n\n/**\n * What a selector primitive can be targeted at. Callers can pass:\n *  - `undefined` / `null` — root namespace (served by the always-on\n *    root store — no extra subscription);\n *  - a {@link SubagentDiscoverySnapshot} (`stream.subagents().get(...)`);\n *  - a {@link SubgraphDiscoverySnapshot} (`stream.subgraphs().get(...)`);\n *  - an explicit `{ namespace: string[] }`;\n *  - a raw `string[]` escape hatch.\n *\n * Selectors also accept a `Signal<SelectorTarget>` so callers can\n * feed a `computed(() => ...)` and have the projection rebind\n * automatically.\n */\nexport type SelectorTarget =\n  | undefined\n  | null\n  | readonly string[]\n  | { namespace: readonly string[] }\n  | SubagentDiscoverySnapshot\n  | SubgraphDiscoverySnapshot;\n\nconst EMPTY_NAMESPACE: readonly string[] = [];\n\nfunction resolveNamespace(target: SelectorTarget): readonly string[] {\n  if (target == null) return EMPTY_NAMESPACE;\n  if (Array.isArray(target)) return target as readonly string[];\n  const obj = target as { namespace?: readonly string[] };\n  return obj.namespace ?? EMPTY_NAMESPACE;\n}\n\nfunction isRoot(namespace: readonly string[]): boolean {\n  return namespace.length === 0;\n}\n\n/**\n * If `target` is a subagent snapshot still on its default\n * `tools:<toolCallId>` namespace, return that tool-call id. See the\n * React selectors for the rationale (deep-agent subagents execute under\n * a distinct `tools:<uuid>` namespace resolved lazily from history).\n */\nfunction subagentNeedingNamespace(target: SelectorTarget): string | null {\n  if (target == null || Array.isArray(target)) return null;\n  const obj = target as { id?: unknown; namespace?: readonly string[] };\n  if (typeof obj.id !== \"string\" || !Array.isArray(obj.namespace)) return null;\n  if (obj.namespace.length === 1 && obj.namespace[0] === `tools:${obj.id}`) {\n    return obj.id;\n  }\n  return null;\n}\n\n/**\n * Lazily resolve a subagent's execution namespace on first scoped use.\n * Must be called from an injection context (as the selector primitives\n * are). A `Signal` target re-evaluates via an `effect`; a static target\n * resolves once. The controller de-dupes and skips already-promoted\n * ids.\n */\nfunction resolveSubagentNamespaceFor(\n  stream: AnyStream,\n  target: SelectorTarget | Signal<SelectorTarget>\n): void {\n  const controller = stream[STREAM_CONTROLLER];\n  if (isSignal(target)) {\n    effect(() => {\n      const id = subagentNeedingNamespace((target as Signal<SelectorTarget>)());\n      if (id != null) void controller.resolveSubagentNamespace(id);\n    });\n    return;\n  }\n  const id = subagentNeedingNamespace(target as SelectorTarget);\n  if (id != null) void controller.resolveSubagentNamespace(id);\n}\n\nfunction namespaceKey(namespace: readonly string[]): string {\n  return namespace.join(NAMESPACE_SEPARATOR);\n}\n\n/**\n * Resolve a target or target-signal into a reactive\n * `[namespace, key]` pair. The helper returns plain signals so\n * `injectProjection` can track them via its internal effect.\n */\nfunction normalizeTarget(\n  target: SelectorTarget | Signal<SelectorTarget>,\n  prefix: string\n): {\n  namespace: Signal<readonly string[]>;\n  key: Signal<string>;\n  isRootSignal: Signal<boolean>;\n} {\n  if (isSignal(target)) {\n    const namespace = computed(() =>\n      resolveNamespace((target as Signal<SelectorTarget>)())\n    );\n    const key = computed(() => `${prefix}|${namespaceKey(namespace())}`);\n    const isRootSignal = computed(() => isRoot(namespace()));\n    return { namespace, key, isRootSignal };\n  }\n  const ns = resolveNamespace(target as SelectorTarget);\n  const staticKey = `${prefix}|${namespaceKey(ns)}`;\n  return {\n    namespace: computed(() => ns),\n    key: computed(() => staticKey),\n    isRootSignal: computed(() => isRoot(ns)),\n  };\n}\n\n/**\n * Subscribe to a scoped `messages` stream.\n *\n * Contract:\n *  - At the root (no `target`) this returns `stream.messages` — the\n *    always-on root projection; no extra subscription is opened.\n *  - For any non-root namespace, call-time triggers a ref-counted\n *    `messages` subscription scoped to that namespace. The\n *    subscription is released automatically when the calling\n *    component / service is destroyed (and the registry closes the\n *    underlying server subscription when the last consumer leaves).\n *\n * Messages are always `BaseMessage` class instances from\n * `@langchain/core/messages`.\n */\nexport function injectMessages(\n  stream: AnyStream,\n  target?: SelectorTarget | Signal<SelectorTarget>\n): Signal<BaseMessage[]> {\n  resolveSubagentNamespaceFor(\n    stream,\n    target as SelectorTarget | Signal<SelectorTarget>\n  );\n  const { namespace, key, isRootSignal } = normalizeTarget(\n    target as SelectorTarget | Signal<SelectorTarget>,\n    \"messages\"\n  );\n  const registry = computed(() =>\n    isRootSignal() ? null : getRegistry(stream)\n  );\n  const scoped = injectProjection<BaseMessage[]>(\n    registry,\n    () => messagesProjection(namespace()),\n    key,\n    EMPTY_MESSAGES\n  );\n  return computed(() => (isRootSignal() ? stream.messages() : scoped()));\n}\n\nconst EMPTY_MESSAGES: BaseMessage[] = [];\n\n/**\n * Subscribe to a scoped `tools` (tool-call) stream. Same target and\n * lifecycle rules as {@link injectMessages}; at the root this returns\n * `stream.toolCalls` directly.\n */\nexport function injectToolCalls(\n  stream: AnyStream,\n  target?: SelectorTarget | Signal<SelectorTarget>\n): Signal<AssembledToolCall[]>;\nexport function injectToolCalls<T>(\n  stream: AnyStream,\n  target?: SelectorTarget | Signal<SelectorTarget>\n): Signal<InferToolCalls<T>[]>;\nexport function injectToolCalls(\n  stream: AnyStream,\n  target?: SelectorTarget | Signal<SelectorTarget>\n): Signal<AssembledToolCall[]> {\n  resolveSubagentNamespaceFor(\n    stream,\n    target as SelectorTarget | Signal<SelectorTarget>\n  );\n  const { namespace, key, isRootSignal } = normalizeTarget(\n    target as SelectorTarget | Signal<SelectorTarget>,\n    \"toolCalls\"\n  );\n  const registry = computed(() =>\n    isRootSignal() ? null : getRegistry(stream)\n  );\n  const scoped = injectProjection<AssembledToolCall[]>(\n    registry,\n    () => toolCallsProjection(namespace()),\n    key,\n    EMPTY_TOOLCALLS\n  );\n  return computed(() => (isRootSignal() ? stream.toolCalls() : scoped()));\n}\n\nconst EMPTY_TOOLCALLS: AssembledToolCall[] = [];\n\n/**\n * Subscribe to a scoped `values` stream — the most recent state\n * payload for a namespace. At the root returns `stream.values`.\n *\n * Typing:\n *  - **Root** (`injectValues(stream)`): returns the `StateType`\n *    declared on `injectStream<State>()` — non-nullable (the root\n *    snapshot always has values, falling back to `initialValues ??\n *    {}`).\n *  - **Scoped** (`injectValues(stream, target)`): scoped payloads can\n *    differ from the root state; callers should annotate the expected\n *    shape explicitly (`injectValues<SubagentState>(stream, sub)`).\n *    Defaults to `unknown` when not annotated.\n */\nexport function injectValues<StateType extends object>(\n  stream: StreamHandle<StateType>\n): Signal<StateType>;\nexport function injectValues<T>(stream: AnyStream): Signal<InferStateType<T>>;\nexport function injectValues<T = unknown>(\n  stream: AnyStream,\n  target: SelectorTarget | Signal<SelectorTarget>,\n  options?: { messagesKey?: string }\n): Signal<T | undefined>;\nexport function injectValues(\n  stream: AnyStream,\n  target?: SelectorTarget | Signal<SelectorTarget>,\n  options?: { messagesKey?: string }\n): Signal<unknown> {\n  const messagesKey = options?.messagesKey ?? \"messages\";\n  const { namespace, key, isRootSignal } = normalizeTarget(\n    target as SelectorTarget | Signal<SelectorTarget>,\n    `values|${messagesKey}`\n  );\n  const registry = computed(() =>\n    isRootSignal() ? null : getRegistry(stream)\n  );\n  const scoped = injectProjection<unknown>(\n    registry,\n    () => valuesProjection<unknown>(namespace(), messagesKey),\n    key,\n    undefined\n  );\n  return computed(() => (isRootSignal() ? stream.values() : scoped()));\n}\n\n/**\n * Subscribe to a `custom:<name>` stream extension — the most recent\n * payload emitted by the transformer, scoped to the target namespace.\n *\n * Returns only the latest value and resumes across serial runs, so it is\n * ideal for \"current state\" panels (progress, score, status). When you\n * need the full history of events rather than just the latest payload,\n * use {@link injectChannel} instead.\n */\nexport function injectExtension<T = unknown>(\n  stream: AnyStream,\n  name: string,\n  target?: SelectorTarget | Signal<SelectorTarget>\n): Signal<T | undefined> {\n  const { namespace, key } = normalizeTarget(\n    target as SelectorTarget | Signal<SelectorTarget>,\n    `extension|${name}`\n  );\n  return injectProjection<T | undefined>(\n    getRegistry(stream),\n    () => extensionProjection<T>(name, namespace()),\n    key,\n    undefined\n  );\n}\n\n/**\n * Raw-events escape hatch. Subscribes to one or more channels at a\n * namespace and returns a bounded buffer of raw protocol events.\n *\n * The buffer keeps accumulating across serial runs for the lifetime of\n * the thread, so this is the hook to use for an event log / stream of a\n * custom channel (e.g. `[\"custom:redaction-stats\"]`). When you only need\n * the latest payload of a single `custom:<name>` channel, prefer\n * {@link injectExtension}. For the common message/tool/value cases prefer\n * {@link injectMessages} / {@link injectToolCalls} / {@link injectValues}.\n */\nexport type InjectChannelOptions = ChannelProjectionOptions;\n\nexport function injectChannel(\n  stream: AnyStream,\n  channels: readonly Channel[],\n  target?: SelectorTarget | Signal<SelectorTarget>,\n  options?: InjectChannelOptions\n): Signal<Event[]> {\n  const sortedChannels = [...channels].sort().join(\",\");\n  const prefix = `channel|${options?.bufferSize ?? \"default\"}|${(options?.replay ?? true) ? \"replay\" : \"live\"}|${sortedChannels}`;\n  const { namespace, key } = normalizeTarget(\n    target as SelectorTarget | Signal<SelectorTarget>,\n    prefix\n  );\n  return injectProjection<Event[]>(\n    getRegistry(stream),\n    () => channelProjection(channels, namespace(), options),\n    key,\n    EMPTY_EVENTS\n  );\n}\n\nconst EMPTY_EVENTS: Event[] = [];\n\n/**\n * Subscribe to a scoped audio-media stream. Each handle is yielded\n * on its first matching `content-block-start`, exposes\n * `.partialBytes` for live access, settles `.blob` / `.objectURL` /\n * `.transcript` on `message-finish`, and surfaces errors via\n * `.error`.\n *\n * Pair with `injectMediaUrl` to turn a handle into an `<audio src>`.\n */\nexport function injectAudio(\n  stream: AnyStream,\n  target?: SelectorTarget | Signal<SelectorTarget>\n): Signal<AudioMedia[]> {\n  const { namespace, key } = normalizeTarget(\n    target as SelectorTarget | Signal<SelectorTarget>,\n    \"audio\"\n  );\n  return injectProjection<AudioMedia[]>(\n    getRegistry(stream),\n    () => audioProjection(namespace()),\n    key,\n    EMPTY_AUDIO\n  );\n}\n\nconst EMPTY_AUDIO: AudioMedia[] = [];\n\n/**\n * Subscribe to a scoped image-media stream. Pair with\n * `injectMediaUrl` for `<img src>`.\n */\nexport function injectImages(\n  stream: AnyStream,\n  target?: SelectorTarget | Signal<SelectorTarget>\n): Signal<ImageMedia[]> {\n  const { namespace, key } = normalizeTarget(\n    target as SelectorTarget | Signal<SelectorTarget>,\n    \"images\"\n  );\n  return injectProjection<ImageMedia[]>(\n    getRegistry(stream),\n    () => imagesProjection(namespace()),\n    key,\n    EMPTY_IMAGES\n  );\n}\n\nconst EMPTY_IMAGES: ImageMedia[] = [];\n\n/**\n * Subscribe to a scoped video-media stream. Pair with\n * `injectMediaUrl` for `<video src>`.\n */\nexport function injectVideo(\n  stream: AnyStream,\n  target?: SelectorTarget | Signal<SelectorTarget>\n): Signal<VideoMedia[]> {\n  const { namespace, key } = normalizeTarget(\n    target as SelectorTarget | Signal<SelectorTarget>,\n    \"video\"\n  );\n  return injectProjection<VideoMedia[]>(\n    getRegistry(stream),\n    () => videoProjection(namespace()),\n    key,\n    EMPTY_VIDEO\n  );\n}\n\nconst EMPTY_VIDEO: VideoMedia[] = [];\n\n/**\n * Subscribe to a scoped file-media stream. Pair with\n * `injectMediaUrl` for an `<a download href>` target.\n */\nexport function injectFiles(\n  stream: AnyStream,\n  target?: SelectorTarget | Signal<SelectorTarget>\n): Signal<FileMedia[]> {\n  const { namespace, key } = normalizeTarget(\n    target as SelectorTarget | Signal<SelectorTarget>,\n    \"files\"\n  );\n  return injectProjection<FileMedia[]>(\n    getRegistry(stream),\n    () => filesProjection(namespace()),\n    key,\n    EMPTY_FILES\n  );\n}\n\nconst EMPTY_FILES: FileMedia[] = [];\n"],"mappings":"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"}

package/dist/selectors.d.cts

@@ -72,13 +72,23 @@ declare function injectValues<T = unknown>(stream: AnyStream, target: SelectorTa
 /**
  * Subscribe to a `custom:<name>` stream extension — the most recent
  * payload emitted by the transformer, scoped to the target namespace.
+ *
+ * Returns only the latest value and resumes across serial runs, so it is
+ * ideal for "current state" panels (progress, score, status). When you
+ * need the full history of events rather than just the latest payload,
+ * use {@link injectChannel} instead.
  */
 declare function injectExtension<T = unknown>(stream: AnyStream, name: string, target?: SelectorTarget | Signal<SelectorTarget>): Signal<T | undefined>;
 /**
  * Raw-events escape hatch. Subscribes to one or more channels at a
  * namespace and returns a bounded buffer of raw protocol events.
- * Prefer {@link injectMessages} / {@link injectToolCalls} /
- * {@link injectValues} for the common cases.
+ *
+ * The buffer keeps accumulating across serial runs for the lifetime of
+ * the thread, so this is the hook to use for an event log / stream of a
+ * custom channel (e.g. `["custom:redaction-stats"]`). When you only need
+ * the latest payload of a single `custom:<name>` channel, prefer
+ * {@link injectExtension}. For the common message/tool/value cases prefer
+ * {@link injectMessages} / {@link injectToolCalls} / {@link injectValues}.
  */
 type InjectChannelOptions = ChannelProjectionOptions;
 declare function injectChannel(stream: AnyStream, channels: readonly Channel[], target?: SelectorTarget | Signal<SelectorTarget>, options?: InjectChannelOptions): Signal<Event[]>;

package/dist/selectors.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"selectors.d.cts","names":[],"sources":["../src/selectors.ts"],"mappings":";;;;;;;;AA+ByB;;;;KASpB,YAAA,6BAAyC,eAAA,CAC5C,SAAA;;;;;AAoBF;;;;;;;;;KAAY,cAAA;EAIN,SAAA;AAAA,IACF,yBAAA,GACA,yBAAA;;;;;;;;;;;;;;;;iBAuGY,cAAA,CACd,MAAA,EAAQ,SAAA,EACR,MAAA,GAAS,cAAA,GAAiB,MAAA,CAAO,cAAA,IAChC,MAAA,CAAO,WAAA;;;AA4BV;;;iBAAgB,eAAA,CACd,MAAA,EAAQ,SAAA,EACR,MAAA,GAAS,cAAA,GAAiB,MAAA,CAAO,cAAA,IAChC,MAAA,CAAO,iBAAA;AAAA,iBACM,eAAA,GAAA,CACd,MAAA,EAAQ,SAAA,EACR,MAAA,GAAS,cAAA,GAAiB,MAAA,CAAO,cAAA,IAChC,MAAA,CAAO,cAAA,CAAe,CAAA;;;;;;;;;;;;;;;iBAyCT,YAAA,0BAAA,CACd,MAAA,EAAQ,YAAA,CAAa,SAAA,IACpB,MAAA,CAAO,SAAA;AAAA,iBACM,YAAA,GAAA,CAAgB,MAAA,EAAQ,SAAA,GAAY,MAAA,CAAO,cAAA,CAAe,CAAA;AAAA,iBAC1D,YAAA,aAAA,CACd,MAAA,EAAQ,SAAA,EACR,MAAA,EAAQ,cAAA,GAAiB,MAAA,CAAO,cAAA,GAChC,OAAA;EAAY,WAAA;AAAA,IACX,MAAA,CAAO,CAAA;;;;;iBA2BM,eAAA,aAAA,CACd,MAAA,EAAQ,SAAA,EACR,IAAA,UACA,MAAA,GAAS,cAAA,GAAiB,MAAA,CAAO,cAAA,IAChC,MAAA,CAAO,CAAA;;;;;;;KAmBE,oBAAA,GAAuB,wBAAA;AAAA,iBAEnB,aAAA,CACd,MAAA,EAAQ,SAAA,EACR,QAAA,WAAmB,OAAA,IACnB,MAAA,GAAS,cAAA,GAAiB,MAAA,CAAO,cAAA,GACjC,OAAA,GAAU,oBAAA,GACT,MAAA,CAAO,KAAA;;;;;;;;;AAjEV;iBA2FgB,WAAA,CACd,MAAA,EAAQ,SAAA,EACR,MAAA,GAAS,cAAA,GAAiB,MAAA,CAAO,cAAA,IAChC,MAAA,CAAO,UAAA;;;;;iBAmBM,YAAA,CACd,MAAA,EAAQ,SAAA,EACR,MAAA,GAAS,cAAA,GAAiB,MAAA,CAAO,cAAA,IAChC,MAAA,CAAO,UAAA;;;;;iBAmBM,WAAA,CACd,MAAA,EAAQ,SAAA,EACR,MAAA,GAAS,cAAA,GAAiB,MAAA,CAAO,cAAA,IAChC,MAAA,CAAO,UAAA;;;;;iBAmBM,WAAA,CACd,MAAA,EAAQ,SAAA,EACR,MAAA,GAAS,cAAA,GAAiB,MAAA,CAAO,cAAA,IAChC,MAAA,CAAO,SAAA"}
+{"version":3,"file":"selectors.d.cts","names":[],"sources":["../src/selectors.ts"],"mappings":";;;;;;;;AA+ByB;;;;KASpB,YAAA,6BAAyC,eAAA,CAC5C,SAAA;;;;;AAoBF;;;;;;;;;KAAY,cAAA;EAIN,SAAA;AAAA,IACF,yBAAA,GACA,yBAAA;;;;;;;;;;;;;;;;iBAuGY,cAAA,CACd,MAAA,EAAQ,SAAA,EACR,MAAA,GAAS,cAAA,GAAiB,MAAA,CAAO,cAAA,IAChC,MAAA,CAAO,WAAA;;;AA4BV;;;iBAAgB,eAAA,CACd,MAAA,EAAQ,SAAA,EACR,MAAA,GAAS,cAAA,GAAiB,MAAA,CAAO,cAAA,IAChC,MAAA,CAAO,iBAAA;AAAA,iBACM,eAAA,GAAA,CACd,MAAA,EAAQ,SAAA,EACR,MAAA,GAAS,cAAA,GAAiB,MAAA,CAAO,cAAA,IAChC,MAAA,CAAO,cAAA,CAAe,CAAA;;;;;;;;;;;;;;;iBAyCT,YAAA,0BAAA,CACd,MAAA,EAAQ,YAAA,CAAa,SAAA,IACpB,MAAA,CAAO,SAAA;AAAA,iBACM,YAAA,GAAA,CAAgB,MAAA,EAAQ,SAAA,GAAY,MAAA,CAAO,cAAA,CAAe,CAAA;AAAA,iBAC1D,YAAA,aAAA,CACd,MAAA,EAAQ,SAAA,EACR,MAAA,EAAQ,cAAA,GAAiB,MAAA,CAAO,cAAA,GAChC,OAAA;EAAY,WAAA;AAAA,IACX,MAAA,CAAO,CAAA;;;;;;;;;;iBAgCM,eAAA,aAAA,CACd,MAAA,EAAQ,SAAA,EACR,IAAA,UACA,MAAA,GAAS,cAAA,GAAiB,MAAA,CAAO,cAAA,IAChC,MAAA,CAAO,CAAA;;;;;;;;;;;;KAwBE,oBAAA,GAAuB,wBAAA;AAAA,iBAEnB,aAAA,CACd,MAAA,EAAQ,SAAA,EACR,QAAA,WAAmB,OAAA,IACnB,MAAA,GAAS,cAAA,GAAiB,MAAA,CAAO,cAAA,GACjC,OAAA,GAAU,oBAAA,GACT,MAAA,CAAO,KAAA;;;;;;;;;;iBA0BM,WAAA,CACd,MAAA,EAAQ,SAAA,EACR,MAAA,GAAS,cAAA,GAAiB,MAAA,CAAO,cAAA,IAChC,MAAA,CAAO,UAAA;;;;;iBAmBM,YAAA,CACd,MAAA,EAAQ,SAAA,EACR,MAAA,GAAS,cAAA,GAAiB,MAAA,CAAO,cAAA,IAChC,MAAA,CAAO,UAAA;AA3HV;;;;AAAA,iBA8IgB,WAAA,CACd,MAAA,EAAQ,SAAA,EACR,MAAA,GAAS,cAAA,GAAiB,MAAA,CAAO,cAAA,IAChC,MAAA,CAAO,UAAA;;;;;iBAmBM,WAAA,CACd,MAAA,EAAQ,SAAA,EACR,MAAA,GAAS,cAAA,GAAiB,MAAA,CAAO,cAAA,IAChC,MAAA,CAAO,SAAA"}

package/dist/selectors.d.ts

@@ -72,13 +72,23 @@ declare function injectValues<T = unknown>(stream: AnyStream, target: SelectorTa
 /**
  * Subscribe to a `custom:<name>` stream extension — the most recent
  * payload emitted by the transformer, scoped to the target namespace.
+ *
+ * Returns only the latest value and resumes across serial runs, so it is
+ * ideal for "current state" panels (progress, score, status). When you
+ * need the full history of events rather than just the latest payload,
+ * use {@link injectChannel} instead.
  */
 declare function injectExtension<T = unknown>(stream: AnyStream, name: string, target?: SelectorTarget | Signal<SelectorTarget>): Signal<T | undefined>;
 /**
  * Raw-events escape hatch. Subscribes to one or more channels at a
  * namespace and returns a bounded buffer of raw protocol events.
- * Prefer {@link injectMessages} / {@link injectToolCalls} /
- * {@link injectValues} for the common cases.
+ *
+ * The buffer keeps accumulating across serial runs for the lifetime of
+ * the thread, so this is the hook to use for an event log / stream of a
+ * custom channel (e.g. `["custom:redaction-stats"]`). When you only need
+ * the latest payload of a single `custom:<name>` channel, prefer
+ * {@link injectExtension}. For the common message/tool/value cases prefer
+ * {@link injectMessages} / {@link injectToolCalls} / {@link injectValues}.
  */
 type InjectChannelOptions = ChannelProjectionOptions;
 declare function injectChannel(stream: AnyStream, channels: readonly Channel[], target?: SelectorTarget | Signal<SelectorTarget>, options?: InjectChannelOptions): Signal<Event[]>;

package/dist/selectors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"selectors.d.ts","names":[],"sources":["../src/selectors.ts"],"mappings":";;;;;;;;AA+ByB;;;;KASpB,YAAA,6BAAyC,eAAA,CAC5C,SAAA;;;;;AAoBF;;;;;;;;;KAAY,cAAA;EAIN,SAAA;AAAA,IACF,yBAAA,GACA,yBAAA;;;;;;;;;;;;;;;;iBAuGY,cAAA,CACd,MAAA,EAAQ,SAAA,EACR,MAAA,GAAS,cAAA,GAAiB,MAAA,CAAO,cAAA,IAChC,MAAA,CAAO,WAAA;;;AA4BV;;;iBAAgB,eAAA,CACd,MAAA,EAAQ,SAAA,EACR,MAAA,GAAS,cAAA,GAAiB,MAAA,CAAO,cAAA,IAChC,MAAA,CAAO,iBAAA;AAAA,iBACM,eAAA,GAAA,CACd,MAAA,EAAQ,SAAA,EACR,MAAA,GAAS,cAAA,GAAiB,MAAA,CAAO,cAAA,IAChC,MAAA,CAAO,cAAA,CAAe,CAAA;;;;;;;;;;;;;;;iBAyCT,YAAA,0BAAA,CACd,MAAA,EAAQ,YAAA,CAAa,SAAA,IACpB,MAAA,CAAO,SAAA;AAAA,iBACM,YAAA,GAAA,CAAgB,MAAA,EAAQ,SAAA,GAAY,MAAA,CAAO,cAAA,CAAe,CAAA;AAAA,iBAC1D,YAAA,aAAA,CACd,MAAA,EAAQ,SAAA,EACR,MAAA,EAAQ,cAAA,GAAiB,MAAA,CAAO,cAAA,GAChC,OAAA;EAAY,WAAA;AAAA,IACX,MAAA,CAAO,CAAA;;;;;iBA2BM,eAAA,aAAA,CACd,MAAA,EAAQ,SAAA,EACR,IAAA,UACA,MAAA,GAAS,cAAA,GAAiB,MAAA,CAAO,cAAA,IAChC,MAAA,CAAO,CAAA;;;;;;;KAmBE,oBAAA,GAAuB,wBAAA;AAAA,iBAEnB,aAAA,CACd,MAAA,EAAQ,SAAA,EACR,QAAA,WAAmB,OAAA,IACnB,MAAA,GAAS,cAAA,GAAiB,MAAA,CAAO,cAAA,GACjC,OAAA,GAAU,oBAAA,GACT,MAAA,CAAO,KAAA;;;;;;;;;AAjEV;iBA2FgB,WAAA,CACd,MAAA,EAAQ,SAAA,EACR,MAAA,GAAS,cAAA,GAAiB,MAAA,CAAO,cAAA,IAChC,MAAA,CAAO,UAAA;;;;;iBAmBM,YAAA,CACd,MAAA,EAAQ,SAAA,EACR,MAAA,GAAS,cAAA,GAAiB,MAAA,CAAO,cAAA,IAChC,MAAA,CAAO,UAAA;;;;;iBAmBM,WAAA,CACd,MAAA,EAAQ,SAAA,EACR,MAAA,GAAS,cAAA,GAAiB,MAAA,CAAO,cAAA,IAChC,MAAA,CAAO,UAAA;;;;;iBAmBM,WAAA,CACd,MAAA,EAAQ,SAAA,EACR,MAAA,GAAS,cAAA,GAAiB,MAAA,CAAO,cAAA,IAChC,MAAA,CAAO,SAAA"}
+{"version":3,"file":"selectors.d.ts","names":[],"sources":["../src/selectors.ts"],"mappings":";;;;;;;;AA+ByB;;;;KASpB,YAAA,6BAAyC,eAAA,CAC5C,SAAA;;;;;AAoBF;;;;;;;;;KAAY,cAAA;EAIN,SAAA;AAAA,IACF,yBAAA,GACA,yBAAA;;;;;;;;;;;;;;;;iBAuGY,cAAA,CACd,MAAA,EAAQ,SAAA,EACR,MAAA,GAAS,cAAA,GAAiB,MAAA,CAAO,cAAA,IAChC,MAAA,CAAO,WAAA;;;AA4BV;;;iBAAgB,eAAA,CACd,MAAA,EAAQ,SAAA,EACR,MAAA,GAAS,cAAA,GAAiB,MAAA,CAAO,cAAA,IAChC,MAAA,CAAO,iBAAA;AAAA,iBACM,eAAA,GAAA,CACd,MAAA,EAAQ,SAAA,EACR,MAAA,GAAS,cAAA,GAAiB,MAAA,CAAO,cAAA,IAChC,MAAA,CAAO,cAAA,CAAe,CAAA;;;;;;;;;;;;;;;iBAyCT,YAAA,0BAAA,CACd,MAAA,EAAQ,YAAA,CAAa,SAAA,IACpB,MAAA,CAAO,SAAA;AAAA,iBACM,YAAA,GAAA,CAAgB,MAAA,EAAQ,SAAA,GAAY,MAAA,CAAO,cAAA,CAAe,CAAA;AAAA,iBAC1D,YAAA,aAAA,CACd,MAAA,EAAQ,SAAA,EACR,MAAA,EAAQ,cAAA,GAAiB,MAAA,CAAO,cAAA,GAChC,OAAA;EAAY,WAAA;AAAA,IACX,MAAA,CAAO,CAAA;;;;;;;;;;iBAgCM,eAAA,aAAA,CACd,MAAA,EAAQ,SAAA,EACR,IAAA,UACA,MAAA,GAAS,cAAA,GAAiB,MAAA,CAAO,cAAA,IAChC,MAAA,CAAO,CAAA;;;;;;;;;;;;KAwBE,oBAAA,GAAuB,wBAAA;AAAA,iBAEnB,aAAA,CACd,MAAA,EAAQ,SAAA,EACR,QAAA,WAAmB,OAAA,IACnB,MAAA,GAAS,cAAA,GAAiB,MAAA,CAAO,cAAA,GACjC,OAAA,GAAU,oBAAA,GACT,MAAA,CAAO,KAAA;;;;;;;;;;iBA0BM,WAAA,CACd,MAAA,EAAQ,SAAA,EACR,MAAA,GAAS,cAAA,GAAiB,MAAA,CAAO,cAAA,IAChC,MAAA,CAAO,UAAA;;;;;iBAmBM,YAAA,CACd,MAAA,EAAQ,SAAA,EACR,MAAA,GAAS,cAAA,GAAiB,MAAA,CAAO,cAAA,IAChC,MAAA,CAAO,UAAA;AA3HV;;;;AAAA,iBA8IgB,WAAA,CACd,MAAA,EAAQ,SAAA,EACR,MAAA,GAAS,cAAA,GAAiB,MAAA,CAAO,cAAA,IAChC,MAAA,CAAO,UAAA;;;;;iBAmBM,WAAA,CACd,MAAA,EAAQ,SAAA,EACR,MAAA,GAAS,cAAA,GAAiB,MAAA,CAAO,cAAA,IAChC,MAAA,CAAO,SAAA"}

package/dist/selectors.js

@@ -107,6 +107,11 @@ function injectValues(stream, target, options) {
 /**
 * Subscribe to a `custom:<name>` stream extension — the most recent
 * payload emitted by the transformer, scoped to the target namespace.
+*
+* Returns only the latest value and resumes across serial runs, so it is
+* ideal for "current state" panels (progress, score, status). When you
+* need the full history of events rather than just the latest payload,
+* use {@link injectChannel} instead.
 */
 function injectExtension(stream, name, target) {
 	const { namespace, key } = normalizeTarget(target, `extension|${name}`);

package/dist/selectors.js.map

@@ -1 +1 @@
-{"version":3,"file":"selectors.js","names":[],"sources":["../src/selectors.ts"],"sourcesContent":["import { computed, effect, isSignal, type Signal } from \"@angular/core\";\nimport type { BaseMessage } from \"@langchain/core/messages\";\nimport {\n  NAMESPACE_SEPARATOR,\n  audioProjection,\n  channelProjection,\n  extensionProjection,\n  filesProjection,\n  imagesProjection,\n  messagesProjection,\n  toolCallsProjection,\n  valuesProjection,\n  videoProjection,\n  type AssembledToolCall,\n  type AudioMedia,\n  type Channel,\n  type ChannelProjectionOptions,\n  type Event,\n  type FileMedia,\n  type ImageMedia,\n  type InferToolCalls,\n  type InferStateType,\n  type SubagentDiscoverySnapshot,\n  type SubgraphDiscoverySnapshot,\n  type VideoMedia,\n} from \"@langchain/langgraph-sdk/stream\";\nimport {\n  getRegistry,\n  STREAM_CONTROLLER,\n  type AnyStream,\n  type UseStreamReturn,\n} from \"./use-stream.js\";\nimport { injectProjection } from \"./inject-projection.js\";\n\n/**\n * Selector primitives don't need to carry `InterruptType` /\n * `ConfigurableType`. Parameterising on `StateType` alone lets\n * callers with a full `injectStream<S, I, C>()` handle pass it in\n * without redeclaring those generics at every call site.\n */\ntype StreamHandle<StateType extends object> = UseStreamReturn<\n  StateType,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  any,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  any\n>;\n\n/**\n * What a selector primitive can be targeted at. Callers can pass:\n *  - `undefined` / `null` — root namespace (served by the always-on\n *    root store — no extra subscription);\n *  - a {@link SubagentDiscoverySnapshot} (`stream.subagents().get(...)`);\n *  - a {@link SubgraphDiscoverySnapshot} (`stream.subgraphs().get(...)`);\n *  - an explicit `{ namespace: string[] }`;\n *  - a raw `string[]` escape hatch.\n *\n * Selectors also accept a `Signal<SelectorTarget>` so callers can\n * feed a `computed(() => ...)` and have the projection rebind\n * automatically.\n */\nexport type SelectorTarget =\n  | undefined\n  | null\n  | readonly string[]\n  | { namespace: readonly string[] }\n  | SubagentDiscoverySnapshot\n  | SubgraphDiscoverySnapshot;\n\nconst EMPTY_NAMESPACE: readonly string[] = [];\n\nfunction resolveNamespace(target: SelectorTarget): readonly string[] {\n  if (target == null) return EMPTY_NAMESPACE;\n  if (Array.isArray(target)) return target as readonly string[];\n  const obj = target as { namespace?: readonly string[] };\n  return obj.namespace ?? EMPTY_NAMESPACE;\n}\n\nfunction isRoot(namespace: readonly string[]): boolean {\n  return namespace.length === 0;\n}\n\n/**\n * If `target` is a subagent snapshot still on its default\n * `tools:<toolCallId>` namespace, return that tool-call id. See the\n * React selectors for the rationale (deep-agent subagents execute under\n * a distinct `tools:<uuid>` namespace resolved lazily from history).\n */\nfunction subagentNeedingNamespace(target: SelectorTarget): string | null {\n  if (target == null || Array.isArray(target)) return null;\n  const obj = target as { id?: unknown; namespace?: readonly string[] };\n  if (typeof obj.id !== \"string\" || !Array.isArray(obj.namespace)) return null;\n  if (obj.namespace.length === 1 && obj.namespace[0] === `tools:${obj.id}`) {\n    return obj.id;\n  }\n  return null;\n}\n\n/**\n * Lazily resolve a subagent's execution namespace on first scoped use.\n * Must be called from an injection context (as the selector primitives\n * are). A `Signal` target re-evaluates via an `effect`; a static target\n * resolves once. The controller de-dupes and skips already-promoted\n * ids.\n */\nfunction resolveSubagentNamespaceFor(\n  stream: AnyStream,\n  target: SelectorTarget | Signal<SelectorTarget>\n): void {\n  const controller = stream[STREAM_CONTROLLER];\n  if (isSignal(target)) {\n    effect(() => {\n      const id = subagentNeedingNamespace((target as Signal<SelectorTarget>)());\n      if (id != null) void controller.resolveSubagentNamespace(id);\n    });\n    return;\n  }\n  const id = subagentNeedingNamespace(target as SelectorTarget);\n  if (id != null) void controller.resolveSubagentNamespace(id);\n}\n\nfunction namespaceKey(namespace: readonly string[]): string {\n  return namespace.join(NAMESPACE_SEPARATOR);\n}\n\n/**\n * Resolve a target or target-signal into a reactive\n * `[namespace, key]` pair. The helper returns plain signals so\n * `injectProjection` can track them via its internal effect.\n */\nfunction normalizeTarget(\n  target: SelectorTarget | Signal<SelectorTarget>,\n  prefix: string\n): {\n  namespace: Signal<readonly string[]>;\n  key: Signal<string>;\n  isRootSignal: Signal<boolean>;\n} {\n  if (isSignal(target)) {\n    const namespace = computed(() =>\n      resolveNamespace((target as Signal<SelectorTarget>)())\n    );\n    const key = computed(() => `${prefix}|${namespaceKey(namespace())}`);\n    const isRootSignal = computed(() => isRoot(namespace()));\n    return { namespace, key, isRootSignal };\n  }\n  const ns = resolveNamespace(target as SelectorTarget);\n  const staticKey = `${prefix}|${namespaceKey(ns)}`;\n  return {\n    namespace: computed(() => ns),\n    key: computed(() => staticKey),\n    isRootSignal: computed(() => isRoot(ns)),\n  };\n}\n\n/**\n * Subscribe to a scoped `messages` stream.\n *\n * Contract:\n *  - At the root (no `target`) this returns `stream.messages` — the\n *    always-on root projection; no extra subscription is opened.\n *  - For any non-root namespace, call-time triggers a ref-counted\n *    `messages` subscription scoped to that namespace. The\n *    subscription is released automatically when the calling\n *    component / service is destroyed (and the registry closes the\n *    underlying server subscription when the last consumer leaves).\n *\n * Messages are always `BaseMessage` class instances from\n * `@langchain/core/messages`.\n */\nexport function injectMessages(\n  stream: AnyStream,\n  target?: SelectorTarget | Signal<SelectorTarget>\n): Signal<BaseMessage[]> {\n  resolveSubagentNamespaceFor(\n    stream,\n    target as SelectorTarget | Signal<SelectorTarget>\n  );\n  const { namespace, key, isRootSignal } = normalizeTarget(\n    target as SelectorTarget | Signal<SelectorTarget>,\n    \"messages\"\n  );\n  const registry = computed(() =>\n    isRootSignal() ? null : getRegistry(stream)\n  );\n  const scoped = injectProjection<BaseMessage[]>(\n    registry,\n    () => messagesProjection(namespace()),\n    key,\n    EMPTY_MESSAGES\n  );\n  return computed(() => (isRootSignal() ? stream.messages() : scoped()));\n}\n\nconst EMPTY_MESSAGES: BaseMessage[] = [];\n\n/**\n * Subscribe to a scoped `tools` (tool-call) stream. Same target and\n * lifecycle rules as {@link injectMessages}; at the root this returns\n * `stream.toolCalls` directly.\n */\nexport function injectToolCalls(\n  stream: AnyStream,\n  target?: SelectorTarget | Signal<SelectorTarget>\n): Signal<AssembledToolCall[]>;\nexport function injectToolCalls<T>(\n  stream: AnyStream,\n  target?: SelectorTarget | Signal<SelectorTarget>\n): Signal<InferToolCalls<T>[]>;\nexport function injectToolCalls(\n  stream: AnyStream,\n  target?: SelectorTarget | Signal<SelectorTarget>\n): Signal<AssembledToolCall[]> {\n  resolveSubagentNamespaceFor(\n    stream,\n    target as SelectorTarget | Signal<SelectorTarget>\n  );\n  const { namespace, key, isRootSignal } = normalizeTarget(\n    target as SelectorTarget | Signal<SelectorTarget>,\n    \"toolCalls\"\n  );\n  const registry = computed(() =>\n    isRootSignal() ? null : getRegistry(stream)\n  );\n  const scoped = injectProjection<AssembledToolCall[]>(\n    registry,\n    () => toolCallsProjection(namespace()),\n    key,\n    EMPTY_TOOLCALLS\n  );\n  return computed(() => (isRootSignal() ? stream.toolCalls() : scoped()));\n}\n\nconst EMPTY_TOOLCALLS: AssembledToolCall[] = [];\n\n/**\n * Subscribe to a scoped `values` stream — the most recent state\n * payload for a namespace. At the root returns `stream.values`.\n *\n * Typing:\n *  - **Root** (`injectValues(stream)`): returns the `StateType`\n *    declared on `injectStream<State>()` — non-nullable (the root\n *    snapshot always has values, falling back to `initialValues ??\n *    {}`).\n *  - **Scoped** (`injectValues(stream, target)`): scoped payloads can\n *    differ from the root state; callers should annotate the expected\n *    shape explicitly (`injectValues<SubagentState>(stream, sub)`).\n *    Defaults to `unknown` when not annotated.\n */\nexport function injectValues<StateType extends object>(\n  stream: StreamHandle<StateType>\n): Signal<StateType>;\nexport function injectValues<T>(stream: AnyStream): Signal<InferStateType<T>>;\nexport function injectValues<T = unknown>(\n  stream: AnyStream,\n  target: SelectorTarget | Signal<SelectorTarget>,\n  options?: { messagesKey?: string }\n): Signal<T | undefined>;\nexport function injectValues(\n  stream: AnyStream,\n  target?: SelectorTarget | Signal<SelectorTarget>,\n  options?: { messagesKey?: string }\n): Signal<unknown> {\n  const messagesKey = options?.messagesKey ?? \"messages\";\n  const { namespace, key, isRootSignal } = normalizeTarget(\n    target as SelectorTarget | Signal<SelectorTarget>,\n    `values|${messagesKey}`\n  );\n  const registry = computed(() =>\n    isRootSignal() ? null : getRegistry(stream)\n  );\n  const scoped = injectProjection<unknown>(\n    registry,\n    () => valuesProjection<unknown>(namespace(), messagesKey),\n    key,\n    undefined\n  );\n  return computed(() => (isRootSignal() ? stream.values() : scoped()));\n}\n\n/**\n * Subscribe to a `custom:<name>` stream extension — the most recent\n * payload emitted by the transformer, scoped to the target namespace.\n */\nexport function injectExtension<T = unknown>(\n  stream: AnyStream,\n  name: string,\n  target?: SelectorTarget | Signal<SelectorTarget>\n): Signal<T | undefined> {\n  const { namespace, key } = normalizeTarget(\n    target as SelectorTarget | Signal<SelectorTarget>,\n    `extension|${name}`\n  );\n  return injectProjection<T | undefined>(\n    getRegistry(stream),\n    () => extensionProjection<T>(name, namespace()),\n    key,\n    undefined\n  );\n}\n\n/**\n * Raw-events escape hatch. Subscribes to one or more channels at a\n * namespace and returns a bounded buffer of raw protocol events.\n * Prefer {@link injectMessages} / {@link injectToolCalls} /\n * {@link injectValues} for the common cases.\n */\nexport type InjectChannelOptions = ChannelProjectionOptions;\n\nexport function injectChannel(\n  stream: AnyStream,\n  channels: readonly Channel[],\n  target?: SelectorTarget | Signal<SelectorTarget>,\n  options?: InjectChannelOptions\n): Signal<Event[]> {\n  const sortedChannels = [...channels].sort().join(\",\");\n  const prefix = `channel|${options?.bufferSize ?? \"default\"}|${(options?.replay ?? true) ? \"replay\" : \"live\"}|${sortedChannels}`;\n  const { namespace, key } = normalizeTarget(\n    target as SelectorTarget | Signal<SelectorTarget>,\n    prefix\n  );\n  return injectProjection<Event[]>(\n    getRegistry(stream),\n    () => channelProjection(channels, namespace(), options),\n    key,\n    EMPTY_EVENTS\n  );\n}\n\nconst EMPTY_EVENTS: Event[] = [];\n\n/**\n * Subscribe to a scoped audio-media stream. Each handle is yielded\n * on its first matching `content-block-start`, exposes\n * `.partialBytes` for live access, settles `.blob` / `.objectURL` /\n * `.transcript` on `message-finish`, and surfaces errors via\n * `.error`.\n *\n * Pair with `injectMediaUrl` to turn a handle into an `<audio src>`.\n */\nexport function injectAudio(\n  stream: AnyStream,\n  target?: SelectorTarget | Signal<SelectorTarget>\n): Signal<AudioMedia[]> {\n  const { namespace, key } = normalizeTarget(\n    target as SelectorTarget | Signal<SelectorTarget>,\n    \"audio\"\n  );\n  return injectProjection<AudioMedia[]>(\n    getRegistry(stream),\n    () => audioProjection(namespace()),\n    key,\n    EMPTY_AUDIO\n  );\n}\n\nconst EMPTY_AUDIO: AudioMedia[] = [];\n\n/**\n * Subscribe to a scoped image-media stream. Pair with\n * `injectMediaUrl` for `<img src>`.\n */\nexport function injectImages(\n  stream: AnyStream,\n  target?: SelectorTarget | Signal<SelectorTarget>\n): Signal<ImageMedia[]> {\n  const { namespace, key } = normalizeTarget(\n    target as SelectorTarget | Signal<SelectorTarget>,\n    \"images\"\n  );\n  return injectProjection<ImageMedia[]>(\n    getRegistry(stream),\n    () => imagesProjection(namespace()),\n    key,\n    EMPTY_IMAGES\n  );\n}\n\nconst EMPTY_IMAGES: ImageMedia[] = [];\n\n/**\n * Subscribe to a scoped video-media stream. Pair with\n * `injectMediaUrl` for `<video src>`.\n */\nexport function injectVideo(\n  stream: AnyStream,\n  target?: SelectorTarget | Signal<SelectorTarget>\n): Signal<VideoMedia[]> {\n  const { namespace, key } = normalizeTarget(\n    target as SelectorTarget | Signal<SelectorTarget>,\n    \"video\"\n  );\n  return injectProjection<VideoMedia[]>(\n    getRegistry(stream),\n    () => videoProjection(namespace()),\n    key,\n    EMPTY_VIDEO\n  );\n}\n\nconst EMPTY_VIDEO: VideoMedia[] = [];\n\n/**\n * Subscribe to a scoped file-media stream. Pair with\n * `injectMediaUrl` for an `<a download href>` target.\n */\nexport function injectFiles(\n  stream: AnyStream,\n  target?: SelectorTarget | Signal<SelectorTarget>\n): Signal<FileMedia[]> {\n  const { namespace, key } = normalizeTarget(\n    target as SelectorTarget | Signal<SelectorTarget>,\n    \"files\"\n  );\n  return injectProjection<FileMedia[]>(\n    getRegistry(stream),\n    () => filesProjection(namespace()),\n    key,\n    EMPTY_FILES\n  );\n}\n\nconst EMPTY_FILES: FileMedia[] = [];\n"],"mappings":";;;;;AAqEA,MAAM,kBAAqC,EAAE;AAE7C,SAAS,iBAAiB,QAA2C;AACnE,KAAI,UAAU,KAAM,QAAO;AAC3B,KAAI,MAAM,QAAQ,OAAO,CAAE,QAAO;AAElC,QADY,OACD,aAAa;;AAG1B,SAAS,OAAO,WAAuC;AACrD,QAAO,UAAU,WAAW;;;;;;;;AAS9B,SAAS,yBAAyB,QAAuC;AACvE,KAAI,UAAU,QAAQ,MAAM,QAAQ,OAAO,CAAE,QAAO;CACpD,MAAM,MAAM;AACZ,KAAI,OAAO,IAAI,OAAO,YAAY,CAAC,MAAM,QAAQ,IAAI,UAAU,CAAE,QAAO;AACxE,KAAI,IAAI,UAAU,WAAW,KAAK,IAAI,UAAU,OAAO,SAAS,IAAI,KAClE,QAAO,IAAI;AAEb,QAAO;;;;;;;;;AAUT,SAAS,4BACP,QACA,QACM;CACN,MAAM,aAAa,OAAO;AAC1B,KAAI,SAAS,OAAO,EAAE;AACpB,eAAa;GACX,MAAM,KAAK,yBAA0B,QAAmC,CAAC;AACzE,OAAI,MAAM,KAAW,YAAW,yBAAyB,GAAG;IAC5D;AACF;;CAEF,MAAM,KAAK,yBAAyB,OAAyB;AAC7D,KAAI,MAAM,KAAW,YAAW,yBAAyB,GAAG;;AAG9D,SAAS,aAAa,WAAsC;AAC1D,QAAO,UAAU,KAAK,oBAAoB;;;;;;;AAQ5C,SAAS,gBACP,QACA,QAKA;AACA,KAAI,SAAS,OAAO,EAAE;EACpB,MAAM,YAAY,eAChB,iBAAkB,QAAmC,CAAC,CACvD;AAGD,SAAO;GAAE;GAAW,KAFR,eAAe,GAAG,OAAO,GAAG,aAAa,WAAW,CAAC,GAAG;GAE3C,cADJ,eAAe,OAAO,WAAW,CAAC,CAAC;GACjB;;CAEzC,MAAM,KAAK,iBAAiB,OAAyB;CACrD,MAAM,YAAY,GAAG,OAAO,GAAG,aAAa,GAAG;AAC/C,QAAO;EACL,WAAW,eAAe,GAAG;EAC7B,KAAK,eAAe,UAAU;EAC9B,cAAc,eAAe,OAAO,GAAG,CAAC;EACzC;;;;;;;;;;;;;;;;;AAkBH,SAAgB,eACd,QACA,QACuB;AACvB,6BACE,QACA,OACD;CACD,MAAM,EAAE,WAAW,KAAK,iBAAiB,gBACvC,QACA,WACD;CAID,MAAM,SAAS,iBAHE,eACf,cAAc,GAAG,OAAO,YAAY,OAAO,CAC5C,QAGO,mBAAmB,WAAW,CAAC,EACrC,KACA,eACD;AACD,QAAO,eAAgB,cAAc,GAAG,OAAO,UAAU,GAAG,QAAQ,CAAE;;AAGxE,MAAM,iBAAgC,EAAE;AAexC,SAAgB,gBACd,QACA,QAC6B;AAC7B,6BACE,QACA,OACD;CACD,MAAM,EAAE,WAAW,KAAK,iBAAiB,gBACvC,QACA,YACD;CAID,MAAM,SAAS,iBAHE,eACf,cAAc,GAAG,OAAO,YAAY,OAAO,CAC5C,QAGO,oBAAoB,WAAW,CAAC,EACtC,KACA,gBACD;AACD,QAAO,eAAgB,cAAc,GAAG,OAAO,WAAW,GAAG,QAAQ,CAAE;;AAGzE,MAAM,kBAAuC,EAAE;AAyB/C,SAAgB,aACd,QACA,QACA,SACiB;CACjB,MAAM,cAAc,SAAS,eAAe;CAC5C,MAAM,EAAE,WAAW,KAAK,iBAAiB,gBACvC,QACA,UAAU,cACX;CAID,MAAM,SAAS,iBAHE,eACf,cAAc,GAAG,OAAO,YAAY,OAAO,CAC5C,QAGO,iBAA0B,WAAW,EAAE,YAAY,EACzD,KACA,KAAA,EACD;AACD,QAAO,eAAgB,cAAc,GAAG,OAAO,QAAQ,GAAG,QAAQ,CAAE;;;;;;AAOtE,SAAgB,gBACd,QACA,MACA,QACuB;CACvB,MAAM,EAAE,WAAW,QAAQ,gBACzB,QACA,aAAa,OACd;AACD,QAAO,iBACL,YAAY,OAAO,QACb,oBAAuB,MAAM,WAAW,CAAC,EAC/C,KACA,KAAA,EACD;;AAWH,SAAgB,cACd,QACA,UACA,QACA,SACiB;CACjB,MAAM,iBAAiB,CAAC,GAAG,SAAS,CAAC,MAAM,CAAC,KAAK,IAAI;CAErD,MAAM,EAAE,WAAW,QAAQ,gBACzB,QAFa,WAAW,SAAS,cAAc,UAAU,GAAI,SAAS,UAAU,OAAQ,WAAW,OAAO,GAAG,iBAI9G;AACD,QAAO,iBACL,YAAY,OAAO,QACb,kBAAkB,UAAU,WAAW,EAAE,QAAQ,EACvD,KACA,aACD;;AAGH,MAAM,eAAwB,EAAE;;;;;;;;;;AAWhC,SAAgB,YACd,QACA,QACsB;CACtB,MAAM,EAAE,WAAW,QAAQ,gBACzB,QACA,QACD;AACD,QAAO,iBACL,YAAY,OAAO,QACb,gBAAgB,WAAW,CAAC,EAClC,KACA,YACD;;AAGH,MAAM,cAA4B,EAAE;;;;;AAMpC,SAAgB,aACd,QACA,QACsB;CACtB,MAAM,EAAE,WAAW,QAAQ,gBACzB,QACA,SACD;AACD,QAAO,iBACL,YAAY,OAAO,QACb,iBAAiB,WAAW,CAAC,EACnC,KACA,aACD;;AAGH,MAAM,eAA6B,EAAE;;;;;AAMrC,SAAgB,YACd,QACA,QACsB;CACtB,MAAM,EAAE,WAAW,QAAQ,gBACzB,QACA,QACD;AACD,QAAO,iBACL,YAAY,OAAO,QACb,gBAAgB,WAAW,CAAC,EAClC,KACA,YACD;;AAGH,MAAM,cAA4B,EAAE;;;;;AAMpC,SAAgB,YACd,QACA,QACqB;CACrB,MAAM,EAAE,WAAW,QAAQ,gBACzB,QACA,QACD;AACD,QAAO,iBACL,YAAY,OAAO,QACb,gBAAgB,WAAW,CAAC,EAClC,KACA,YACD;;AAGH,MAAM,cAA2B,EAAE"}
+{"version":3,"file":"selectors.js","names":[],"sources":["../src/selectors.ts"],"sourcesContent":["import { computed, effect, isSignal, type Signal } from \"@angular/core\";\nimport type { BaseMessage } from \"@langchain/core/messages\";\nimport {\n  NAMESPACE_SEPARATOR,\n  audioProjection,\n  channelProjection,\n  extensionProjection,\n  filesProjection,\n  imagesProjection,\n  messagesProjection,\n  toolCallsProjection,\n  valuesProjection,\n  videoProjection,\n  type AssembledToolCall,\n  type AudioMedia,\n  type Channel,\n  type ChannelProjectionOptions,\n  type Event,\n  type FileMedia,\n  type ImageMedia,\n  type InferToolCalls,\n  type InferStateType,\n  type SubagentDiscoverySnapshot,\n  type SubgraphDiscoverySnapshot,\n  type VideoMedia,\n} from \"@langchain/langgraph-sdk/stream\";\nimport {\n  getRegistry,\n  STREAM_CONTROLLER,\n  type AnyStream,\n  type UseStreamReturn,\n} from \"./use-stream.js\";\nimport { injectProjection } from \"./inject-projection.js\";\n\n/**\n * Selector primitives don't need to carry `InterruptType` /\n * `ConfigurableType`. Parameterising on `StateType` alone lets\n * callers with a full `injectStream<S, I, C>()` handle pass it in\n * without redeclaring those generics at every call site.\n */\ntype StreamHandle<StateType extends object> = UseStreamReturn<\n  StateType,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  any,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  any\n>;\n\n/**\n * What a selector primitive can be targeted at. Callers can pass:\n *  - `undefined` / `null` — root namespace (served by the always-on\n *    root store — no extra subscription);\n *  - a {@link SubagentDiscoverySnapshot} (`stream.subagents().get(...)`);\n *  - a {@link SubgraphDiscoverySnapshot} (`stream.subgraphs().get(...)`);\n *  - an explicit `{ namespace: string[] }`;\n *  - a raw `string[]` escape hatch.\n *\n * Selectors also accept a `Signal<SelectorTarget>` so callers can\n * feed a `computed(() => ...)` and have the projection rebind\n * automatically.\n */\nexport type SelectorTarget =\n  | undefined\n  | null\n  | readonly string[]\n  | { namespace: readonly string[] }\n  | SubagentDiscoverySnapshot\n  | SubgraphDiscoverySnapshot;\n\nconst EMPTY_NAMESPACE: readonly string[] = [];\n\nfunction resolveNamespace(target: SelectorTarget): readonly string[] {\n  if (target == null) return EMPTY_NAMESPACE;\n  if (Array.isArray(target)) return target as readonly string[];\n  const obj = target as { namespace?: readonly string[] };\n  return obj.namespace ?? EMPTY_NAMESPACE;\n}\n\nfunction isRoot(namespace: readonly string[]): boolean {\n  return namespace.length === 0;\n}\n\n/**\n * If `target` is a subagent snapshot still on its default\n * `tools:<toolCallId>` namespace, return that tool-call id. See the\n * React selectors for the rationale (deep-agent subagents execute under\n * a distinct `tools:<uuid>` namespace resolved lazily from history).\n */\nfunction subagentNeedingNamespace(target: SelectorTarget): string | null {\n  if (target == null || Array.isArray(target)) return null;\n  const obj = target as { id?: unknown; namespace?: readonly string[] };\n  if (typeof obj.id !== \"string\" || !Array.isArray(obj.namespace)) return null;\n  if (obj.namespace.length === 1 && obj.namespace[0] === `tools:${obj.id}`) {\n    return obj.id;\n  }\n  return null;\n}\n\n/**\n * Lazily resolve a subagent's execution namespace on first scoped use.\n * Must be called from an injection context (as the selector primitives\n * are). A `Signal` target re-evaluates via an `effect`; a static target\n * resolves once. The controller de-dupes and skips already-promoted\n * ids.\n */\nfunction resolveSubagentNamespaceFor(\n  stream: AnyStream,\n  target: SelectorTarget | Signal<SelectorTarget>\n): void {\n  const controller = stream[STREAM_CONTROLLER];\n  if (isSignal(target)) {\n    effect(() => {\n      const id = subagentNeedingNamespace((target as Signal<SelectorTarget>)());\n      if (id != null) void controller.resolveSubagentNamespace(id);\n    });\n    return;\n  }\n  const id = subagentNeedingNamespace(target as SelectorTarget);\n  if (id != null) void controller.resolveSubagentNamespace(id);\n}\n\nfunction namespaceKey(namespace: readonly string[]): string {\n  return namespace.join(NAMESPACE_SEPARATOR);\n}\n\n/**\n * Resolve a target or target-signal into a reactive\n * `[namespace, key]` pair. The helper returns plain signals so\n * `injectProjection` can track them via its internal effect.\n */\nfunction normalizeTarget(\n  target: SelectorTarget | Signal<SelectorTarget>,\n  prefix: string\n): {\n  namespace: Signal<readonly string[]>;\n  key: Signal<string>;\n  isRootSignal: Signal<boolean>;\n} {\n  if (isSignal(target)) {\n    const namespace = computed(() =>\n      resolveNamespace((target as Signal<SelectorTarget>)())\n    );\n    const key = computed(() => `${prefix}|${namespaceKey(namespace())}`);\n    const isRootSignal = computed(() => isRoot(namespace()));\n    return { namespace, key, isRootSignal };\n  }\n  const ns = resolveNamespace(target as SelectorTarget);\n  const staticKey = `${prefix}|${namespaceKey(ns)}`;\n  return {\n    namespace: computed(() => ns),\n    key: computed(() => staticKey),\n    isRootSignal: computed(() => isRoot(ns)),\n  };\n}\n\n/**\n * Subscribe to a scoped `messages` stream.\n *\n * Contract:\n *  - At the root (no `target`) this returns `stream.messages` — the\n *    always-on root projection; no extra subscription is opened.\n *  - For any non-root namespace, call-time triggers a ref-counted\n *    `messages` subscription scoped to that namespace. The\n *    subscription is released automatically when the calling\n *    component / service is destroyed (and the registry closes the\n *    underlying server subscription when the last consumer leaves).\n *\n * Messages are always `BaseMessage` class instances from\n * `@langchain/core/messages`.\n */\nexport function injectMessages(\n  stream: AnyStream,\n  target?: SelectorTarget | Signal<SelectorTarget>\n): Signal<BaseMessage[]> {\n  resolveSubagentNamespaceFor(\n    stream,\n    target as SelectorTarget | Signal<SelectorTarget>\n  );\n  const { namespace, key, isRootSignal } = normalizeTarget(\n    target as SelectorTarget | Signal<SelectorTarget>,\n    \"messages\"\n  );\n  const registry = computed(() =>\n    isRootSignal() ? null : getRegistry(stream)\n  );\n  const scoped = injectProjection<BaseMessage[]>(\n    registry,\n    () => messagesProjection(namespace()),\n    key,\n    EMPTY_MESSAGES\n  );\n  return computed(() => (isRootSignal() ? stream.messages() : scoped()));\n}\n\nconst EMPTY_MESSAGES: BaseMessage[] = [];\n\n/**\n * Subscribe to a scoped `tools` (tool-call) stream. Same target and\n * lifecycle rules as {@link injectMessages}; at the root this returns\n * `stream.toolCalls` directly.\n */\nexport function injectToolCalls(\n  stream: AnyStream,\n  target?: SelectorTarget | Signal<SelectorTarget>\n): Signal<AssembledToolCall[]>;\nexport function injectToolCalls<T>(\n  stream: AnyStream,\n  target?: SelectorTarget | Signal<SelectorTarget>\n): Signal<InferToolCalls<T>[]>;\nexport function injectToolCalls(\n  stream: AnyStream,\n  target?: SelectorTarget | Signal<SelectorTarget>\n): Signal<AssembledToolCall[]> {\n  resolveSubagentNamespaceFor(\n    stream,\n    target as SelectorTarget | Signal<SelectorTarget>\n  );\n  const { namespace, key, isRootSignal } = normalizeTarget(\n    target as SelectorTarget | Signal<SelectorTarget>,\n    \"toolCalls\"\n  );\n  const registry = computed(() =>\n    isRootSignal() ? null : getRegistry(stream)\n  );\n  const scoped = injectProjection<AssembledToolCall[]>(\n    registry,\n    () => toolCallsProjection(namespace()),\n    key,\n    EMPTY_TOOLCALLS\n  );\n  return computed(() => (isRootSignal() ? stream.toolCalls() : scoped()));\n}\n\nconst EMPTY_TOOLCALLS: AssembledToolCall[] = [];\n\n/**\n * Subscribe to a scoped `values` stream — the most recent state\n * payload for a namespace. At the root returns `stream.values`.\n *\n * Typing:\n *  - **Root** (`injectValues(stream)`): returns the `StateType`\n *    declared on `injectStream<State>()` — non-nullable (the root\n *    snapshot always has values, falling back to `initialValues ??\n *    {}`).\n *  - **Scoped** (`injectValues(stream, target)`): scoped payloads can\n *    differ from the root state; callers should annotate the expected\n *    shape explicitly (`injectValues<SubagentState>(stream, sub)`).\n *    Defaults to `unknown` when not annotated.\n */\nexport function injectValues<StateType extends object>(\n  stream: StreamHandle<StateType>\n): Signal<StateType>;\nexport function injectValues<T>(stream: AnyStream): Signal<InferStateType<T>>;\nexport function injectValues<T = unknown>(\n  stream: AnyStream,\n  target: SelectorTarget | Signal<SelectorTarget>,\n  options?: { messagesKey?: string }\n): Signal<T | undefined>;\nexport function injectValues(\n  stream: AnyStream,\n  target?: SelectorTarget | Signal<SelectorTarget>,\n  options?: { messagesKey?: string }\n): Signal<unknown> {\n  const messagesKey = options?.messagesKey ?? \"messages\";\n  const { namespace, key, isRootSignal } = normalizeTarget(\n    target as SelectorTarget | Signal<SelectorTarget>,\n    `values|${messagesKey}`\n  );\n  const registry = computed(() =>\n    isRootSignal() ? null : getRegistry(stream)\n  );\n  const scoped = injectProjection<unknown>(\n    registry,\n    () => valuesProjection<unknown>(namespace(), messagesKey),\n    key,\n    undefined\n  );\n  return computed(() => (isRootSignal() ? stream.values() : scoped()));\n}\n\n/**\n * Subscribe to a `custom:<name>` stream extension — the most recent\n * payload emitted by the transformer, scoped to the target namespace.\n *\n * Returns only the latest value and resumes across serial runs, so it is\n * ideal for \"current state\" panels (progress, score, status). When you\n * need the full history of events rather than just the latest payload,\n * use {@link injectChannel} instead.\n */\nexport function injectExtension<T = unknown>(\n  stream: AnyStream,\n  name: string,\n  target?: SelectorTarget | Signal<SelectorTarget>\n): Signal<T | undefined> {\n  const { namespace, key } = normalizeTarget(\n    target as SelectorTarget | Signal<SelectorTarget>,\n    `extension|${name}`\n  );\n  return injectProjection<T | undefined>(\n    getRegistry(stream),\n    () => extensionProjection<T>(name, namespace()),\n    key,\n    undefined\n  );\n}\n\n/**\n * Raw-events escape hatch. Subscribes to one or more channels at a\n * namespace and returns a bounded buffer of raw protocol events.\n *\n * The buffer keeps accumulating across serial runs for the lifetime of\n * the thread, so this is the hook to use for an event log / stream of a\n * custom channel (e.g. `[\"custom:redaction-stats\"]`). When you only need\n * the latest payload of a single `custom:<name>` channel, prefer\n * {@link injectExtension}. For the common message/tool/value cases prefer\n * {@link injectMessages} / {@link injectToolCalls} / {@link injectValues}.\n */\nexport type InjectChannelOptions = ChannelProjectionOptions;\n\nexport function injectChannel(\n  stream: AnyStream,\n  channels: readonly Channel[],\n  target?: SelectorTarget | Signal<SelectorTarget>,\n  options?: InjectChannelOptions\n): Signal<Event[]> {\n  const sortedChannels = [...channels].sort().join(\",\");\n  const prefix = `channel|${options?.bufferSize ?? \"default\"}|${(options?.replay ?? true) ? \"replay\" : \"live\"}|${sortedChannels}`;\n  const { namespace, key } = normalizeTarget(\n    target as SelectorTarget | Signal<SelectorTarget>,\n    prefix\n  );\n  return injectProjection<Event[]>(\n    getRegistry(stream),\n    () => channelProjection(channels, namespace(), options),\n    key,\n    EMPTY_EVENTS\n  );\n}\n\nconst EMPTY_EVENTS: Event[] = [];\n\n/**\n * Subscribe to a scoped audio-media stream. Each handle is yielded\n * on its first matching `content-block-start`, exposes\n * `.partialBytes` for live access, settles `.blob` / `.objectURL` /\n * `.transcript` on `message-finish`, and surfaces errors via\n * `.error`.\n *\n * Pair with `injectMediaUrl` to turn a handle into an `<audio src>`.\n */\nexport function injectAudio(\n  stream: AnyStream,\n  target?: SelectorTarget | Signal<SelectorTarget>\n): Signal<AudioMedia[]> {\n  const { namespace, key } = normalizeTarget(\n    target as SelectorTarget | Signal<SelectorTarget>,\n    \"audio\"\n  );\n  return injectProjection<AudioMedia[]>(\n    getRegistry(stream),\n    () => audioProjection(namespace()),\n    key,\n    EMPTY_AUDIO\n  );\n}\n\nconst EMPTY_AUDIO: AudioMedia[] = [];\n\n/**\n * Subscribe to a scoped image-media stream. Pair with\n * `injectMediaUrl` for `<img src>`.\n */\nexport function injectImages(\n  stream: AnyStream,\n  target?: SelectorTarget | Signal<SelectorTarget>\n): Signal<ImageMedia[]> {\n  const { namespace, key } = normalizeTarget(\n    target as SelectorTarget | Signal<SelectorTarget>,\n    \"images\"\n  );\n  return injectProjection<ImageMedia[]>(\n    getRegistry(stream),\n    () => imagesProjection(namespace()),\n    key,\n    EMPTY_IMAGES\n  );\n}\n\nconst EMPTY_IMAGES: ImageMedia[] = [];\n\n/**\n * Subscribe to a scoped video-media stream. Pair with\n * `injectMediaUrl` for `<video src>`.\n */\nexport function injectVideo(\n  stream: AnyStream,\n  target?: SelectorTarget | Signal<SelectorTarget>\n): Signal<VideoMedia[]> {\n  const { namespace, key } = normalizeTarget(\n    target as SelectorTarget | Signal<SelectorTarget>,\n    \"video\"\n  );\n  return injectProjection<VideoMedia[]>(\n    getRegistry(stream),\n    () => videoProjection(namespace()),\n    key,\n    EMPTY_VIDEO\n  );\n}\n\nconst EMPTY_VIDEO: VideoMedia[] = [];\n\n/**\n * Subscribe to a scoped file-media stream. Pair with\n * `injectMediaUrl` for an `<a download href>` target.\n */\nexport function injectFiles(\n  stream: AnyStream,\n  target?: SelectorTarget | Signal<SelectorTarget>\n): Signal<FileMedia[]> {\n  const { namespace, key } = normalizeTarget(\n    target as SelectorTarget | Signal<SelectorTarget>,\n    \"files\"\n  );\n  return injectProjection<FileMedia[]>(\n    getRegistry(stream),\n    () => filesProjection(namespace()),\n    key,\n    EMPTY_FILES\n  );\n}\n\nconst EMPTY_FILES: FileMedia[] = [];\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@langchain/angular",
-  "version": "1.0.17",
+  "version": "1.0.18",
   "description": "Angular integration for LangGraph & LangChain",
   "type": "module",
   "license": "MIT",
@@ -10,7 +10,7 @@
     "directory": "libs/sdk-angular"
   },
   "dependencies": {
-    "@langchain/langgraph-sdk": "1.9.17"
+    "@langchain/langgraph-sdk": "1.9.18"
   },
   "devDependencies": {
     "@analogjs/vite-plugin-angular": "^2.6.0",