@langchain/langgraph-sdk 1.9.4 → 1.9.6

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

@@ -1 +1 @@
-{"version":3,"file":"subgraphs.cjs","names":["#session","#messagesIterable","MultiCursorBuffer","StreamingMessageAssembler","#startProjection","#valuesProjection","#outputPromise","#toolCallsIterable","ToolCallAssembler","#subgraphsIterable","#subagentsIterable","#ensureMediaDispatcher","#audioBuffer","#imagesBuffer","#videoBuffer","#filesBuffer","#mediaDispatcherStarted","MediaAssembler","#source","#parentNamespace","#discovered","#pendingToolStarts","#pendingToolCallHandles","#queue","#waiters","#processToolEvent","#sourcePump","#processEvent","#emit","#closed","#start"],"sources":["../../../../src/client/stream/handles/subgraphs.ts"],"sourcesContent":["import type {\n  Channel,\n  Event,\n  LifecycleCause,\n  LifecycleEvent,\n  MessagesEvent,\n  SubscribeParams,\n  ToolsEvent,\n  ValuesEvent,\n} from \"@langchain/protocol\";\nimport type { SubscriptionHandle } from \"../index.js\";\nimport { MultiCursorBuffer } from \"../multi-cursor-buffer.js\";\nimport { StreamingMessageAssembler } from \"../messages.js\";\nimport type { StreamingMessage, StreamingMessageHandle } from \"../messages.js\";\nimport { ToolCallAssembler } from \"./tools.js\";\nimport type { AssembledToolCall } from \"./tools.js\";\nimport { MediaAssembler } from \"../media.js\";\nimport type {\n  AudioMedia,\n  FileMedia,\n  ImageMedia,\n  VideoMedia,\n} from \"../media.js\";\nimport type {\n  EventForChannel,\n  EventForChannels,\n  SubscribeOptions,\n  YieldForChannel,\n  YieldForChannels,\n} from \"../types.js\";\nimport type { SubagentHandle } from \"./subagents.js\";\n\n/**\n * Minimal subscription surface that {@link SubgraphHandle} and\n * {@link SubagentHandle} delegate to. Typed to match the\n * `Session.subscribe` raw-channel overloads without importing the\n * full `Session` class (avoids circular dependency).\n */\nexport interface Subscribable {\n  subscribe<TChannel extends Channel>(\n    channel: TChannel,\n    options?: SubscribeOptions\n  ): Promise<\n    SubscriptionHandle<EventForChannel<TChannel>, YieldForChannel<TChannel>>\n  >;\n  subscribe<const TChannels extends readonly Channel[]>(\n    channels: TChannels,\n    options?: SubscribeOptions\n  ): Promise<\n    SubscriptionHandle<EventForChannels<TChannels>, YieldForChannels<TChannels>>\n  >;\n  subscribe(params: SubscribeParams): Promise<SubscriptionHandle<Event>>;\n}\n\n/**\n * Discovered subgraph within a streaming session.\n *\n * Mirrors the in-process `SubgraphRunStream` pattern: each subgraph\n * has `name`, `index`, `namespace`, and lazy getters for projections\n * scoped to this subgraph's namespace.\n *\n * ```ts\n * for await (const sub of session.subgraphs) {\n *   for await (const msg of sub.messages) { ... }\n *   const state = await sub.output;\n * }\n * ```\n */\nexport class SubgraphHandle {\n  readonly name: string;\n  readonly index: number;\n  readonly namespace: string[];\n  /**\n   * Non-empty when upstream attached a `cause` to this subgraph's\n   * `lifecycle.started` event. Population is product-specific and\n   * performed by stream transformers on the runtime side (e.g.\n   * deepagents' `SubagentTransformer` emits\n   * `{ type: \"toolCall\", tool_call_id }`). Generic clients should\n   * treat `cause.type` as an open enum — the protocol allows future\n   * variants (`send`, `edge`, ...) to be forwarded verbatim without\n   * a SDK bump.\n   */\n  readonly cause?: LifecycleCause;\n  readonly graphName?: string;\n  /**\n   * Raw `tool-started` event that triggered this subgraph, when\n   * `cause.type === \"toolCall\"` and the matching event has been\n   * observed on the `tools` channel.\n   */\n  toolStartedEvent?: ToolsEvent;\n  readonly #session: Subscribable;\n\n  #messagesIterable?: AsyncIterable<StreamingMessage>;\n  #valuesProjection?: AsyncIterable<unknown> & PromiseLike<unknown>;\n  #toolCallsIterable?: AsyncIterable<AssembledToolCall>;\n  #subgraphsIterable?: AsyncIterable<SubgraphHandle>;\n  #subagentsIterable?: AsyncIterable<SubagentHandle>;\n  #outputPromise?: Promise<unknown>;\n\n  #mediaDispatcherStarted = false;\n  #audioBuffer?: MultiCursorBuffer<AudioMedia>;\n  #imagesBuffer?: MultiCursorBuffer<ImageMedia>;\n  #videoBuffer?: MultiCursorBuffer<VideoMedia>;\n  #filesBuffer?: MultiCursorBuffer<FileMedia>;\n\n  constructor(\n    name: string,\n    index: number,\n    namespace: string[],\n    session: Subscribable,\n    options?: {\n      cause?: LifecycleCause;\n      graphName?: string;\n      toolStartedEvent?: ToolsEvent;\n    }\n  ) {\n    this.name = name;\n    this.index = index;\n    this.namespace = namespace;\n    this.cause = options?.cause;\n    this.graphName = options?.graphName;\n    this.toolStartedEvent = options?.toolStartedEvent;\n    this.#session = session;\n  }\n\n  get messages(): AsyncIterable<StreamingMessageHandle> {\n    if (this.#messagesIterable) return this.#messagesIterable;\n    const buffer = new MultiCursorBuffer<StreamingMessage>();\n    this.#messagesIterable = buffer;\n    const assembler = new StreamingMessageAssembler();\n    void this.#startProjection(\n      [\"messages\"],\n      (event) => {\n        if (event.method !== \"messages\") return;\n        const msg = assembler.consume(event as MessagesEvent);\n        if (msg) buffer.push(msg);\n      },\n      () => buffer.close()\n    );\n    return buffer;\n  }\n\n  get values(): AsyncIterable<unknown> & PromiseLike<unknown> {\n    if (this.#valuesProjection) return this.#valuesProjection;\n    const buffer = new MultiCursorBuffer<unknown>();\n    let lastValue: unknown;\n    let resolveOutput!: (value: unknown) => void;\n    const outputPromise = new Promise<unknown>((resolve) => {\n      resolveOutput = resolve;\n    });\n    this.#outputPromise = outputPromise;\n    const projection = Object.assign(buffer, {\n      then: <TResult1 = unknown, TResult2 = never>(\n        onfulfilled?:\n          | ((value: unknown) => TResult1 | PromiseLike<TResult1>)\n          | null,\n        onrejected?:\n          | ((reason: unknown) => TResult2 | PromiseLike<TResult2>)\n          | null\n      ): Promise<TResult1 | TResult2> =>\n        outputPromise.then(onfulfilled, onrejected),\n    }) as AsyncIterable<unknown> & PromiseLike<unknown>;\n    this.#valuesProjection = projection;\n    void this.#startProjection(\n      [\"values\"],\n      (event) => {\n        if (event.method !== \"values\") return;\n        const data = (event as ValuesEvent).params.data;\n        lastValue = data;\n        buffer.push(data);\n      },\n      () => {\n        resolveOutput(lastValue);\n        buffer.close();\n      }\n    );\n    return projection;\n  }\n\n  get toolCalls(): AsyncIterable<AssembledToolCall> {\n    if (this.#toolCallsIterable) return this.#toolCallsIterable;\n    const buffer = new MultiCursorBuffer<AssembledToolCall>();\n    this.#toolCallsIterable = buffer;\n    const assembler = new ToolCallAssembler();\n    void this.#startProjection(\n      [\"tools\"],\n      (event) => {\n        if (event.method !== \"tools\") return;\n        const tc = assembler.consume(event as ToolsEvent);\n        if (tc) buffer.push(tc);\n      },\n      () => buffer.close()\n    );\n    return buffer;\n  }\n\n  get subgraphs(): AsyncIterable<SubgraphHandle> {\n    if (this.#subgraphsIterable) return this.#subgraphsIterable;\n    const buffer = new MultiCursorBuffer<SubgraphHandle>();\n    this.#subgraphsIterable = buffer;\n    void (async () => {\n      const rawHandle = await this.#session.subscribe({\n        channels: [\"lifecycle\", \"tools\"],\n        namespaces: [this.namespace],\n      });\n      const discovery = new SubgraphDiscoveryHandle(\n        rawHandle,\n        this.#session,\n        this.namespace\n      );\n      for await (const sub of discovery) {\n        buffer.push(sub);\n      }\n      buffer.close();\n    })();\n    return buffer;\n  }\n\n  get subagents(): AsyncIterable<SubagentHandle> {\n    if (this.#subagentsIterable) return this.#subagentsIterable;\n    const buffer = new MultiCursorBuffer<SubagentHandle>();\n    this.#subagentsIterable = buffer;\n    void (async () => {\n      const rawHandle = await this.#session.subscribe({\n        channels: [\"tools\", \"lifecycle\"],\n        namespaces: [this.namespace],\n      });\n      const { SubagentDiscoveryHandle: Discovery } =\n        await import(\"./subagents.js\");\n      const discovery = new Discovery(rawHandle, this.#session);\n      for await (const sub of discovery) {\n        buffer.push(sub);\n      }\n      buffer.close();\n    })();\n    return buffer;\n  }\n\n  get audio(): AsyncIterable<AudioMedia> {\n    this.#ensureMediaDispatcher();\n    return this.#audioBuffer!;\n  }\n\n  get images(): AsyncIterable<ImageMedia> {\n    this.#ensureMediaDispatcher();\n    return this.#imagesBuffer!;\n  }\n\n  get video(): AsyncIterable<VideoMedia> {\n    this.#ensureMediaDispatcher();\n    return this.#videoBuffer!;\n  }\n\n  get files(): AsyncIterable<FileMedia> {\n    this.#ensureMediaDispatcher();\n    return this.#filesBuffer!;\n  }\n\n  get output(): Promise<unknown> {\n    void this.values;\n    return this.#outputPromise!;\n  }\n\n  #ensureMediaDispatcher(): void {\n    if (this.#mediaDispatcherStarted) return;\n    this.#mediaDispatcherStarted = true;\n    const audio = new MultiCursorBuffer<AudioMedia>();\n    const images = new MultiCursorBuffer<ImageMedia>();\n    const video = new MultiCursorBuffer<VideoMedia>();\n    const files = new MultiCursorBuffer<FileMedia>();\n    this.#audioBuffer = audio;\n    this.#imagesBuffer = images;\n    this.#videoBuffer = video;\n    this.#filesBuffer = files;\n    const assembler = new MediaAssembler({\n      onAudio: (m: AudioMedia) => audio.push(m),\n      onImage: (m: ImageMedia) => images.push(m),\n      onVideo: (m: VideoMedia) => video.push(m),\n      onFile: (m: FileMedia) => files.push(m),\n    });\n    void this.#startProjection(\n      [\"messages\"],\n      (event) => {\n        if (event.method !== \"messages\") return;\n        assembler.consume(event as MessagesEvent);\n      },\n      () => {\n        assembler.close();\n        audio.close();\n        images.close();\n        video.close();\n        files.close();\n      }\n    );\n  }\n\n  /**\n   * Create a raw channel subscription scoped to this subgraph's namespace.\n   */\n  subscribe<TChannel extends Channel>(\n    channel: TChannel,\n    options?: SubscribeOptions\n  ): Promise<\n    SubscriptionHandle<EventForChannel<TChannel>, YieldForChannel<TChannel>>\n  >;\n  subscribe<const TChannels extends readonly Channel[]>(\n    channels: TChannels,\n    options?: SubscribeOptions\n  ): Promise<\n    SubscriptionHandle<EventForChannels<TChannels>, YieldForChannels<TChannels>>\n  >;\n  subscribe(params: SubscribeParams): Promise<SubscriptionHandle<Event>>;\n  subscribe(\n    paramsOrChannels: SubscribeParams | Channel | string | readonly Channel[],\n    options: SubscribeOptions = {}\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  ): Promise<any> {\n    if (\n      typeof paramsOrChannels === \"object\" &&\n      !Array.isArray(paramsOrChannels) &&\n      \"channels\" in paramsOrChannels\n    ) {\n      return this.#session.subscribe({\n        ...paramsOrChannels,\n        namespaces: paramsOrChannels.namespaces ?? [this.namespace],\n      });\n    }\n\n    return this.#session.subscribe(paramsOrChannels as Channel, {\n      ...options,\n      namespaces: options.namespaces ?? [this.namespace],\n    });\n  }\n\n  async #startProjection(\n    channels: Channel[],\n    onEvent: (event: Event) => void,\n    onDone: () => void\n  ): Promise<void> {\n    try {\n      const rawHandle = await this.#session.subscribe({\n        channels,\n        namespaces: [this.namespace],\n      });\n      for await (const event of rawHandle) {\n        onEvent(event);\n      }\n    } finally {\n      onDone();\n    }\n  }\n}\n\n/**\n * Async iterable that yields {@link SubgraphHandle} instances as new\n * subgraph namespaces are discovered from `lifecycle` events.\n *\n * Mirrors the in-process `run.subgraphs` pattern. A new subgraph is\n * discovered when a `lifecycle` event with `event: \"started\"` is\n * received at a namespace depth of exactly `parentDepth + 1`.\n */\nexport class SubgraphDiscoveryHandle implements AsyncIterable<SubgraphHandle> {\n  readonly #source: SubscriptionHandle<Event>;\n  readonly #session: Subscribable;\n  readonly #parentNamespace: string[];\n  readonly #discovered = new Set<string>();\n  readonly #pendingToolStarts = new Map<string, ToolsEvent>();\n  readonly #pendingToolCallHandles = new Map<string, SubgraphHandle>();\n  readonly #queue: SubgraphHandle[] = [];\n  readonly #waiters: Array<(value: IteratorResult<SubgraphHandle>) => void> =\n    [];\n  #sourcePump?: Promise<void>;\n  #closed = false;\n\n  constructor(\n    source: SubscriptionHandle<Event>,\n    session: Subscribable,\n    parentNamespace: string[] = []\n  ) {\n    this.#source = source;\n    this.#session = session;\n    this.#parentNamespace = parentNamespace;\n  }\n\n  #emit(handle: SubgraphHandle): void {\n    const waiter = this.#waiters.shift();\n    if (waiter) {\n      waiter({ done: false, value: handle });\n    } else {\n      this.#queue.push(handle);\n    }\n  }\n\n  #processToolEvent(event: Event): boolean {\n    if (event.method !== \"tools\") return false;\n    const tools = event as ToolsEvent;\n    const data = tools.params.data as Record<string, unknown>;\n    if (data.event !== \"tool-started\") return true;\n\n    const toolCallId = data.tool_call_id as string | undefined;\n    if (!toolCallId) return true;\n\n    const pendingHandle = this.#pendingToolCallHandles.get(toolCallId);\n    if (pendingHandle) {\n      pendingHandle.toolStartedEvent = tools;\n      this.#pendingToolCallHandles.delete(toolCallId);\n      return true;\n    }\n\n    this.#pendingToolStarts.set(toolCallId, tools);\n    return true;\n  }\n\n  #processEvent(event: Event): SubgraphHandle | undefined {\n    if (this.#processToolEvent(event)) return undefined;\n    if (event.method !== \"lifecycle\") return undefined;\n    const lifecycle = event as LifecycleEvent;\n    if (lifecycle.params.data.event !== \"started\") return undefined;\n\n    const ns = event.params.namespace;\n    if (ns.length !== this.#parentNamespace.length + 1) return undefined;\n\n    const isChild = this.#parentNamespace.every((seg, i) => ns[i] === seg);\n    if (!isChild) return undefined;\n\n    const nsKey = ns.join(\"/\");\n    if (this.#discovered.has(nsKey)) return undefined;\n    this.#discovered.add(nsKey);\n\n    const lastSegment = ns[ns.length - 1] ?? \"\";\n    const colonIdx = lastSegment.lastIndexOf(\":\");\n    let name: string;\n    let index: number;\n    if (colonIdx >= 0) {\n      name = lastSegment.slice(0, colonIdx);\n      const suffix = lastSegment.slice(colonIdx + 1);\n      index = /^\\d+$/.test(suffix) ? Number(suffix) : 0;\n    } else {\n      name = lastSegment;\n      index = 0;\n    }\n\n    const data = lifecycle.params.data as unknown as Record<string, unknown>;\n    const cause =\n      data.cause && typeof data.cause === \"object\"\n        ? (data.cause as LifecycleCause)\n        : undefined;\n    let toolStartedEvent: ToolsEvent | undefined;\n    if (cause?.type === \"toolCall\") {\n      const toolCallId = (cause as { tool_call_id?: string }).tool_call_id;\n      if (toolCallId) {\n        toolStartedEvent = this.#pendingToolStarts.get(toolCallId);\n        this.#pendingToolStarts.delete(toolCallId);\n      }\n    }\n\n    const handle = new SubgraphHandle(name, index, [...ns], this.#session, {\n      cause,\n      graphName: data.graph_name as string | undefined,\n      toolStartedEvent,\n    });\n    if (cause?.type === \"toolCall\" && toolStartedEvent == null) {\n      const toolCallId = (cause as { tool_call_id?: string }).tool_call_id;\n      if (toolCallId) this.#pendingToolCallHandles.set(toolCallId, handle);\n    }\n    return handle;\n  }\n\n  #start(): void {\n    if (this.#sourcePump) return;\n    this.#sourcePump = (async () => {\n      for await (const event of this.#source) {\n        const handle = this.#processEvent(event);\n        if (!handle) continue;\n        this.#emit(handle);\n      }\n      this.#pendingToolStarts.clear();\n      this.#pendingToolCallHandles.clear();\n      this.#closed = true;\n      while (this.#waiters.length > 0) {\n        this.#waiters.shift()?.({ done: true, value: undefined });\n      }\n    })();\n  }\n\n  async close(): Promise<void> {\n    this.#closed = true;\n    await this.#source.unsubscribe();\n  }\n\n  [Symbol.asyncIterator](): AsyncIterator<SubgraphHandle> {\n    this.#start();\n    return {\n      next: async () => {\n        if (this.#queue.length > 0) {\n          return { done: false, value: this.#queue.shift()! };\n        }\n        if (this.#closed) {\n          return { done: true, value: undefined };\n        }\n        return await new Promise<IteratorResult<SubgraphHandle>>((resolve) => {\n          this.#waiters.push(resolve);\n        });\n      },\n      return: async () => {\n        await this.close();\n        return { done: true, value: undefined };\n      },\n    };\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"subgraphs.cjs","names":["#session","#messagesIterable","MultiCursorBuffer","StreamingMessageAssembler","#startProjection","#valuesProjection","#outputPromise","#toolCallsIterable","ToolCallAssembler","toClientAssembledToolCall","#subgraphsIterable","#subagentsIterable","#ensureMediaDispatcher","#audioBuffer","#imagesBuffer","#videoBuffer","#filesBuffer","#mediaDispatcherStarted","MediaAssembler","#source","#parentNamespace","#discovered","#pendingToolStarts","#pendingToolCallHandles","#queue","#waiters","#processToolEvent","#sourcePump","#processEvent","#emit","#closed","#start"],"sources":["../../../../src/client/stream/handles/subgraphs.ts"],"sourcesContent":["import type {\n  Channel,\n  Event,\n  LifecycleCause,\n  LifecycleEvent,\n  MessagesEvent,\n  SubscribeParams,\n  ToolsEvent,\n  ValuesEvent,\n} from \"@langchain/protocol\";\nimport type { SubscriptionHandle } from \"../index.js\";\nimport { MultiCursorBuffer } from \"../multi-cursor-buffer.js\";\nimport { StreamingMessageAssembler } from \"../messages.js\";\nimport type { StreamingMessage, StreamingMessageHandle } from \"../messages.js\";\nimport { ToolCallAssembler, toClientAssembledToolCall } from \"./tools.js\";\nimport type { ClientAssembledToolCall } from \"./tools.js\";\nimport { MediaAssembler } from \"../media.js\";\nimport type {\n  AudioMedia,\n  FileMedia,\n  ImageMedia,\n  VideoMedia,\n} from \"../media.js\";\nimport type {\n  EventForChannel,\n  EventForChannels,\n  SubscribeOptions,\n  YieldForChannel,\n  YieldForChannels,\n} from \"../types.js\";\nimport type { SubagentHandle } from \"./subagents.js\";\n\n/**\n * Minimal subscription surface that {@link SubgraphHandle} and\n * {@link SubagentHandle} delegate to. Typed to match the\n * `Session.subscribe` raw-channel overloads without importing the\n * full `Session` class (avoids circular dependency).\n */\nexport interface Subscribable {\n  subscribe<TChannel extends Channel>(\n    channel: TChannel,\n    options?: SubscribeOptions\n  ): Promise<\n    SubscriptionHandle<EventForChannel<TChannel>, YieldForChannel<TChannel>>\n  >;\n  subscribe<const TChannels extends readonly Channel[]>(\n    channels: TChannels,\n    options?: SubscribeOptions\n  ): Promise<\n    SubscriptionHandle<EventForChannels<TChannels>, YieldForChannels<TChannels>>\n  >;\n  subscribe(params: SubscribeParams): Promise<SubscriptionHandle<Event>>;\n}\n\n/**\n * Discovered subgraph within a streaming session.\n *\n * Mirrors the in-process `SubgraphRunStream` pattern: each subgraph\n * has `name`, `index`, `namespace`, and lazy getters for projections\n * scoped to this subgraph's namespace.\n *\n * ```ts\n * for await (const sub of session.subgraphs) {\n *   for await (const msg of sub.messages) { ... }\n *   const state = await sub.output;\n * }\n * ```\n */\nexport class SubgraphHandle {\n  readonly name: string;\n  readonly index: number;\n  readonly namespace: string[];\n  /**\n   * Non-empty when upstream attached a `cause` to this subgraph's\n   * `lifecycle.started` event. Population is product-specific and\n   * performed by stream transformers on the runtime side (e.g.\n   * deepagents' `SubagentTransformer` emits\n   * `{ type: \"toolCall\", tool_call_id }`). Generic clients should\n   * treat `cause.type` as an open enum — the protocol allows future\n   * variants (`send`, `edge`, ...) to be forwarded verbatim without\n   * a SDK bump.\n   */\n  readonly cause?: LifecycleCause;\n  readonly graphName?: string;\n  /**\n   * Raw `tool-started` event that triggered this subgraph, when\n   * `cause.type === \"toolCall\"` and the matching event has been\n   * observed on the `tools` channel.\n   */\n  toolStartedEvent?: ToolsEvent;\n  readonly #session: Subscribable;\n\n  #messagesIterable?: AsyncIterable<StreamingMessage>;\n  #valuesProjection?: AsyncIterable<unknown> & PromiseLike<unknown>;\n  #toolCallsIterable?: AsyncIterable<ClientAssembledToolCall>;\n  #subgraphsIterable?: AsyncIterable<SubgraphHandle>;\n  #subagentsIterable?: AsyncIterable<SubagentHandle>;\n  #outputPromise?: Promise<unknown>;\n\n  #mediaDispatcherStarted = false;\n  #audioBuffer?: MultiCursorBuffer<AudioMedia>;\n  #imagesBuffer?: MultiCursorBuffer<ImageMedia>;\n  #videoBuffer?: MultiCursorBuffer<VideoMedia>;\n  #filesBuffer?: MultiCursorBuffer<FileMedia>;\n\n  constructor(\n    name: string,\n    index: number,\n    namespace: string[],\n    session: Subscribable,\n    options?: {\n      cause?: LifecycleCause;\n      graphName?: string;\n      toolStartedEvent?: ToolsEvent;\n    }\n  ) {\n    this.name = name;\n    this.index = index;\n    this.namespace = namespace;\n    this.cause = options?.cause;\n    this.graphName = options?.graphName;\n    this.toolStartedEvent = options?.toolStartedEvent;\n    this.#session = session;\n  }\n\n  get messages(): AsyncIterable<StreamingMessageHandle> {\n    if (this.#messagesIterable) return this.#messagesIterable;\n    const buffer = new MultiCursorBuffer<StreamingMessage>();\n    this.#messagesIterable = buffer;\n    const assembler = new StreamingMessageAssembler();\n    void this.#startProjection(\n      [\"messages\"],\n      (event) => {\n        if (event.method !== \"messages\") return;\n        const msg = assembler.consume(event as MessagesEvent);\n        if (msg) buffer.push(msg);\n      },\n      () => buffer.close()\n    );\n    return buffer;\n  }\n\n  get values(): AsyncIterable<unknown> & PromiseLike<unknown> {\n    if (this.#valuesProjection) return this.#valuesProjection;\n    const buffer = new MultiCursorBuffer<unknown>();\n    let lastValue: unknown;\n    let resolveOutput!: (value: unknown) => void;\n    const outputPromise = new Promise<unknown>((resolve) => {\n      resolveOutput = resolve;\n    });\n    this.#outputPromise = outputPromise;\n    const projection = Object.assign(buffer, {\n      then: <TResult1 = unknown, TResult2 = never>(\n        onfulfilled?:\n          | ((value: unknown) => TResult1 | PromiseLike<TResult1>)\n          | null,\n        onrejected?:\n          | ((reason: unknown) => TResult2 | PromiseLike<TResult2>)\n          | null\n      ): Promise<TResult1 | TResult2> =>\n        outputPromise.then(onfulfilled, onrejected),\n    }) as AsyncIterable<unknown> & PromiseLike<unknown>;\n    this.#valuesProjection = projection;\n    void this.#startProjection(\n      [\"values\"],\n      (event) => {\n        if (event.method !== \"values\") return;\n        const data = (event as ValuesEvent).params.data;\n        lastValue = data;\n        buffer.push(data);\n      },\n      () => {\n        resolveOutput(lastValue);\n        buffer.close();\n      }\n    );\n    return projection;\n  }\n\n  get toolCalls(): AsyncIterable<ClientAssembledToolCall> {\n    if (this.#toolCallsIterable) return this.#toolCallsIterable;\n    const buffer = new MultiCursorBuffer<ClientAssembledToolCall>();\n    this.#toolCallsIterable = buffer;\n    const assembler = new ToolCallAssembler();\n    void this.#startProjection(\n      [\"tools\"],\n      (event) => {\n        if (event.method !== \"tools\") return;\n        const tc = assembler.consume(event as ToolsEvent);\n        if (tc) buffer.push(toClientAssembledToolCall(tc));\n      },\n      () => buffer.close()\n    );\n    return buffer;\n  }\n\n  get subgraphs(): AsyncIterable<SubgraphHandle> {\n    if (this.#subgraphsIterable) return this.#subgraphsIterable;\n    const buffer = new MultiCursorBuffer<SubgraphHandle>();\n    this.#subgraphsIterable = buffer;\n    void (async () => {\n      const rawHandle = await this.#session.subscribe({\n        channels: [\"lifecycle\", \"tools\"],\n        namespaces: [this.namespace],\n      });\n      const discovery = new SubgraphDiscoveryHandle(\n        rawHandle,\n        this.#session,\n        this.namespace\n      );\n      for await (const sub of discovery) {\n        buffer.push(sub);\n      }\n      buffer.close();\n    })();\n    return buffer;\n  }\n\n  get subagents(): AsyncIterable<SubagentHandle> {\n    if (this.#subagentsIterable) return this.#subagentsIterable;\n    const buffer = new MultiCursorBuffer<SubagentHandle>();\n    this.#subagentsIterable = buffer;\n    void (async () => {\n      const rawHandle = await this.#session.subscribe({\n        channels: [\"tools\", \"lifecycle\"],\n        namespaces: [this.namespace],\n      });\n      const { SubagentDiscoveryHandle: Discovery } =\n        await import(\"./subagents.js\");\n      const discovery = new Discovery(rawHandle, this.#session);\n      for await (const sub of discovery) {\n        buffer.push(sub);\n      }\n      buffer.close();\n    })();\n    return buffer;\n  }\n\n  get audio(): AsyncIterable<AudioMedia> {\n    this.#ensureMediaDispatcher();\n    return this.#audioBuffer!;\n  }\n\n  get images(): AsyncIterable<ImageMedia> {\n    this.#ensureMediaDispatcher();\n    return this.#imagesBuffer!;\n  }\n\n  get video(): AsyncIterable<VideoMedia> {\n    this.#ensureMediaDispatcher();\n    return this.#videoBuffer!;\n  }\n\n  get files(): AsyncIterable<FileMedia> {\n    this.#ensureMediaDispatcher();\n    return this.#filesBuffer!;\n  }\n\n  get output(): Promise<unknown> {\n    void this.values;\n    return this.#outputPromise!;\n  }\n\n  #ensureMediaDispatcher(): void {\n    if (this.#mediaDispatcherStarted) return;\n    this.#mediaDispatcherStarted = true;\n    const audio = new MultiCursorBuffer<AudioMedia>();\n    const images = new MultiCursorBuffer<ImageMedia>();\n    const video = new MultiCursorBuffer<VideoMedia>();\n    const files = new MultiCursorBuffer<FileMedia>();\n    this.#audioBuffer = audio;\n    this.#imagesBuffer = images;\n    this.#videoBuffer = video;\n    this.#filesBuffer = files;\n    const assembler = new MediaAssembler({\n      onAudio: (m: AudioMedia) => audio.push(m),\n      onImage: (m: ImageMedia) => images.push(m),\n      onVideo: (m: VideoMedia) => video.push(m),\n      onFile: (m: FileMedia) => files.push(m),\n    });\n    void this.#startProjection(\n      [\"messages\"],\n      (event) => {\n        if (event.method !== \"messages\") return;\n        assembler.consume(event as MessagesEvent);\n      },\n      () => {\n        assembler.close();\n        audio.close();\n        images.close();\n        video.close();\n        files.close();\n      }\n    );\n  }\n\n  /**\n   * Create a raw channel subscription scoped to this subgraph's namespace.\n   */\n  subscribe<TChannel extends Channel>(\n    channel: TChannel,\n    options?: SubscribeOptions\n  ): Promise<\n    SubscriptionHandle<EventForChannel<TChannel>, YieldForChannel<TChannel>>\n  >;\n  subscribe<const TChannels extends readonly Channel[]>(\n    channels: TChannels,\n    options?: SubscribeOptions\n  ): Promise<\n    SubscriptionHandle<EventForChannels<TChannels>, YieldForChannels<TChannels>>\n  >;\n  subscribe(params: SubscribeParams): Promise<SubscriptionHandle<Event>>;\n  subscribe(\n    paramsOrChannels: SubscribeParams | Channel | string | readonly Channel[],\n    options: SubscribeOptions = {}\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  ): Promise<any> {\n    if (\n      typeof paramsOrChannels === \"object\" &&\n      !Array.isArray(paramsOrChannels) &&\n      \"channels\" in paramsOrChannels\n    ) {\n      return this.#session.subscribe({\n        ...paramsOrChannels,\n        namespaces: paramsOrChannels.namespaces ?? [this.namespace],\n      });\n    }\n\n    return this.#session.subscribe(paramsOrChannels as Channel, {\n      ...options,\n      namespaces: options.namespaces ?? [this.namespace],\n    });\n  }\n\n  async #startProjection(\n    channels: Channel[],\n    onEvent: (event: Event) => void,\n    onDone: () => void\n  ): Promise<void> {\n    try {\n      const rawHandle = await this.#session.subscribe({\n        channels,\n        namespaces: [this.namespace],\n      });\n      for await (const event of rawHandle) {\n        onEvent(event);\n      }\n    } finally {\n      onDone();\n    }\n  }\n}\n\n/**\n * Async iterable that yields {@link SubgraphHandle} instances as new\n * subgraph namespaces are discovered from `lifecycle` events.\n *\n * Mirrors the in-process `run.subgraphs` pattern. A new subgraph is\n * discovered when a `lifecycle` event with `event: \"started\"` is\n * received at a namespace depth of exactly `parentDepth + 1`.\n */\nexport class SubgraphDiscoveryHandle implements AsyncIterable<SubgraphHandle> {\n  readonly #source: SubscriptionHandle<Event>;\n  readonly #session: Subscribable;\n  readonly #parentNamespace: string[];\n  readonly #discovered = new Set<string>();\n  readonly #pendingToolStarts = new Map<string, ToolsEvent>();\n  readonly #pendingToolCallHandles = new Map<string, SubgraphHandle>();\n  readonly #queue: SubgraphHandle[] = [];\n  readonly #waiters: Array<(value: IteratorResult<SubgraphHandle>) => void> =\n    [];\n  #sourcePump?: Promise<void>;\n  #closed = false;\n\n  constructor(\n    source: SubscriptionHandle<Event>,\n    session: Subscribable,\n    parentNamespace: string[] = []\n  ) {\n    this.#source = source;\n    this.#session = session;\n    this.#parentNamespace = parentNamespace;\n  }\n\n  #emit(handle: SubgraphHandle): void {\n    const waiter = this.#waiters.shift();\n    if (waiter) {\n      waiter({ done: false, value: handle });\n    } else {\n      this.#queue.push(handle);\n    }\n  }\n\n  #processToolEvent(event: Event): boolean {\n    if (event.method !== \"tools\") return false;\n    const tools = event as ToolsEvent;\n    const data = tools.params.data as Record<string, unknown>;\n    if (data.event !== \"tool-started\") return true;\n\n    const toolCallId = data.tool_call_id as string | undefined;\n    if (!toolCallId) return true;\n\n    const pendingHandle = this.#pendingToolCallHandles.get(toolCallId);\n    if (pendingHandle) {\n      pendingHandle.toolStartedEvent = tools;\n      this.#pendingToolCallHandles.delete(toolCallId);\n      return true;\n    }\n\n    this.#pendingToolStarts.set(toolCallId, tools);\n    return true;\n  }\n\n  #processEvent(event: Event): SubgraphHandle | undefined {\n    if (this.#processToolEvent(event)) return undefined;\n    if (event.method !== \"lifecycle\") return undefined;\n    const lifecycle = event as LifecycleEvent;\n    if (lifecycle.params.data.event !== \"started\") return undefined;\n\n    const ns = event.params.namespace;\n    if (ns.length !== this.#parentNamespace.length + 1) return undefined;\n\n    const isChild = this.#parentNamespace.every((seg, i) => ns[i] === seg);\n    if (!isChild) return undefined;\n\n    const nsKey = ns.join(\"/\");\n    if (this.#discovered.has(nsKey)) return undefined;\n    this.#discovered.add(nsKey);\n\n    const lastSegment = ns[ns.length - 1] ?? \"\";\n    const colonIdx = lastSegment.lastIndexOf(\":\");\n    let name: string;\n    let index: number;\n    if (colonIdx >= 0) {\n      name = lastSegment.slice(0, colonIdx);\n      const suffix = lastSegment.slice(colonIdx + 1);\n      index = /^\\d+$/.test(suffix) ? Number(suffix) : 0;\n    } else {\n      name = lastSegment;\n      index = 0;\n    }\n\n    const data = lifecycle.params.data as unknown as Record<string, unknown>;\n    const cause =\n      data.cause && typeof data.cause === \"object\"\n        ? (data.cause as LifecycleCause)\n        : undefined;\n    let toolStartedEvent: ToolsEvent | undefined;\n    if (cause?.type === \"toolCall\") {\n      const toolCallId = (cause as { tool_call_id?: string }).tool_call_id;\n      if (toolCallId) {\n        toolStartedEvent = this.#pendingToolStarts.get(toolCallId);\n        this.#pendingToolStarts.delete(toolCallId);\n      }\n    }\n\n    const handle = new SubgraphHandle(name, index, [...ns], this.#session, {\n      cause,\n      graphName: data.graph_name as string | undefined,\n      toolStartedEvent,\n    });\n    if (cause?.type === \"toolCall\" && toolStartedEvent == null) {\n      const toolCallId = (cause as { tool_call_id?: string }).tool_call_id;\n      if (toolCallId) this.#pendingToolCallHandles.set(toolCallId, handle);\n    }\n    return handle;\n  }\n\n  #start(): void {\n    if (this.#sourcePump) return;\n    this.#sourcePump = (async () => {\n      for await (const event of this.#source) {\n        const handle = this.#processEvent(event);\n        if (!handle) continue;\n        this.#emit(handle);\n      }\n      this.#pendingToolStarts.clear();\n      this.#pendingToolCallHandles.clear();\n      this.#closed = true;\n      while (this.#waiters.length > 0) {\n        this.#waiters.shift()?.({ done: true, value: undefined });\n      }\n    })();\n  }\n\n  async close(): Promise<void> {\n    this.#closed = true;\n    await this.#source.unsubscribe();\n  }\n\n  [Symbol.asyncIterator](): AsyncIterator<SubgraphHandle> {\n    this.#start();\n    return {\n      next: async () => {\n        if (this.#queue.length > 0) {\n          return { done: false, value: this.#queue.shift()! };\n        }\n        if (this.#closed) {\n          return { done: true, value: undefined };\n        }\n        return await new Promise<IteratorResult<SubgraphHandle>>((resolve) => {\n          this.#waiters.push(resolve);\n        });\n      },\n      return: async () => {\n        await this.close();\n        return { done: true, value: undefined };\n      },\n    };\n  }\n}\n"],"mappings":"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"}

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

@@ -1,4 +1,4 @@
-import { AssembledToolCall } from "./tools.cjs";
+import { ClientAssembledToolCall } from "./tools.cjs";
 import { StreamingMessageHandle } from "../messages.cjs";
 import { AudioMedia, FileMedia, ImageMedia, VideoMedia } from "../media.cjs";
 import { EventForChannel, EventForChannels, SubscribeOptions, YieldForChannel, YieldForChannels } from "../types.cjs";
@@ -62,7 +62,7 @@ declare class SubgraphHandle {
   });
   get messages(): AsyncIterable<StreamingMessageHandle>;
   get values(): AsyncIterable<unknown> & PromiseLike<unknown>;
-  get toolCalls(): AsyncIterable<AssembledToolCall>;
+  get toolCalls(): AsyncIterable<ClientAssembledToolCall>;
   get subgraphs(): AsyncIterable<SubgraphHandle>;
   get subagents(): AsyncIterable<SubagentHandle>;
   get audio(): AsyncIterable<AudioMedia>;

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

@@ -1 +1 @@
-{"version":3,"file":"subgraphs.d.cts","names":[],"sources":["../../../../src/client/stream/handles/subgraphs.ts"],"mappings":";;;;;;;;;;;AAsCA;;;;UAAiB,YAAA;EACf,SAAA,kBAA2B,OAAA,EACzB,OAAA,EAAS,QAAA,EACT,OAAA,GAAU,gBAAA,GACT,OAAA,CACD,kBAAA,CAAmB,eAAA,CAAgB,QAAA,GAAW,eAAA,CAAgB,QAAA;EAEhE,SAAA,kCAA2C,OAAA,IACzC,QAAA,EAAU,SAAA,EACV,OAAA,GAAU,gBAAA,GACT,OAAA,CACD,kBAAA,CAAmB,gBAAA,CAAiB,SAAA,GAAY,gBAAA,CAAiB,SAAA;EAEnE,SAAA,CAAU,MAAA,EAAQ,eAAA,GAAkB,OAAA,CAAQ,kBAAA,CAAmB,KAAA;AAAA;;;;;;;;;;;;;;;cAiBpD,cAAA;EAAA;WACF,IAAA;EAAA,SACA,KAAA;EAAA,SACA,SAAA;EAhCC;;;;;;;;;;EAAA,SA2CD,KAAA,GAAQ,cAAA;EAAA,SACR,SAAA;EAtCT;;;;;EA4CA,gBAAA,GAAmB,UAAA;EAgBnB,WAAA,CACE,IAAA,UACA,KAAA,UACA,SAAA,YACA,OAAA,EAAS,YAAA,EACT,OAAA;IACE,KAAA,GAAQ,cAAA;IACR,SAAA;IACA,gBAAA,GAAmB,UAAA;EAAA;EAAA,IAYnB,QAAA,CAAA,GAAY,aAAA,CAAc,sBAAA;EAAA,IAiB1B,MAAA,CAAA,GAAU,aAAA,YAAyB,WAAA;EAAA,IAqCnC,SAAA,CAAA,GAAa,aAAA,CAAc,iBAAA;EAAA,IAiB3B,SAAA,CAAA,GAAa,aAAA,CAAc,cAAA;EAAA,IAsB3B,SAAA,CAAA,GAAa,aAAA,CAAc,cAAA;EAAA,IAoB3B,KAAA,CAAA,GAAS,aAAA,CAAc,UAAA;EAAA,IAKvB,MAAA,CAAA,GAAU,aAAA,CAAc,UAAA;EAAA,IAKxB,KAAA,CAAA,GAAS,aAAA,CAAc,UAAA;EAAA,IAKvB,KAAA,CAAA,GAAS,aAAA,CAAc,SAAA;EAAA,IAKvB,MAAA,CAAA,GAAU,OAAA;EA9LH;;;EAuOX,SAAA,kBAA2B,OAAA,CAAA,CACzB,OAAA,EAAS,QAAA,EACT,OAAA,GAAU,gBAAA,GACT,OAAA,CACD,kBAAA,CAAmB,eAAA,CAAgB,QAAA,GAAW,eAAA,CAAgB,QAAA;EAEhE,SAAA,kCAA2C,OAAA,GAAA,CACzC,QAAA,EAAU,SAAA,EACV,OAAA,GAAU,gBAAA,GACT,OAAA,CACD,kBAAA,CAAmB,gBAAA,CAAiB,SAAA,GAAY,gBAAA,CAAiB,SAAA;EAEnE,SAAA,CAAU,MAAA,EAAQ,eAAA,GAAkB,OAAA,CAAQ,kBAAA,CAAmB,KAAA;AAAA"}
+{"version":3,"file":"subgraphs.d.cts","names":[],"sources":["../../../../src/client/stream/handles/subgraphs.ts"],"mappings":";;;;;;;;;;;AAsCA;;;;UAAiB,YAAA;EACf,SAAA,kBAA2B,OAAA,EACzB,OAAA,EAAS,QAAA,EACT,OAAA,GAAU,gBAAA,GACT,OAAA,CACD,kBAAA,CAAmB,eAAA,CAAgB,QAAA,GAAW,eAAA,CAAgB,QAAA;EAEhE,SAAA,kCAA2C,OAAA,IACzC,QAAA,EAAU,SAAA,EACV,OAAA,GAAU,gBAAA,GACT,OAAA,CACD,kBAAA,CAAmB,gBAAA,CAAiB,SAAA,GAAY,gBAAA,CAAiB,SAAA;EAEnE,SAAA,CAAU,MAAA,EAAQ,eAAA,GAAkB,OAAA,CAAQ,kBAAA,CAAmB,KAAA;AAAA;;;;;;;;;;;;;;;cAiBpD,cAAA;EAAA;WACF,IAAA;EAAA,SACA,KAAA;EAAA,SACA,SAAA;EAhCC;;;;;;;;;;EAAA,SA2CD,KAAA,GAAQ,cAAA;EAAA,SACR,SAAA;EAtCT;;;;;EA4CA,gBAAA,GAAmB,UAAA;EAgBnB,WAAA,CACE,IAAA,UACA,KAAA,UACA,SAAA,YACA,OAAA,EAAS,YAAA,EACT,OAAA;IACE,KAAA,GAAQ,cAAA;IACR,SAAA;IACA,gBAAA,GAAmB,UAAA;EAAA;EAAA,IAYnB,QAAA,CAAA,GAAY,aAAA,CAAc,sBAAA;EAAA,IAiB1B,MAAA,CAAA,GAAU,aAAA,YAAyB,WAAA;EAAA,IAqCnC,SAAA,CAAA,GAAa,aAAA,CAAc,uBAAA;EAAA,IAiB3B,SAAA,CAAA,GAAa,aAAA,CAAc,cAAA;EAAA,IAsB3B,SAAA,CAAA,GAAa,aAAA,CAAc,cAAA;EAAA,IAoB3B,KAAA,CAAA,GAAS,aAAA,CAAc,UAAA;EAAA,IAKvB,MAAA,CAAA,GAAU,aAAA,CAAc,UAAA;EAAA,IAKxB,KAAA,CAAA,GAAS,aAAA,CAAc,UAAA;EAAA,IAKvB,KAAA,CAAA,GAAS,aAAA,CAAc,SAAA;EAAA,IAKvB,MAAA,CAAA,GAAU,OAAA;EA9LH;;;EAuOX,SAAA,kBAA2B,OAAA,CAAA,CACzB,OAAA,EAAS,QAAA,EACT,OAAA,GAAU,gBAAA,GACT,OAAA,CACD,kBAAA,CAAmB,eAAA,CAAgB,QAAA,GAAW,eAAA,CAAgB,QAAA;EAEhE,SAAA,kCAA2C,OAAA,GAAA,CACzC,QAAA,EAAU,SAAA,EACV,OAAA,GAAU,gBAAA,GACT,OAAA,CACD,kBAAA,CAAmB,gBAAA,CAAiB,SAAA,GAAY,gBAAA,CAAiB,SAAA;EAEnE,SAAA,CAAU,MAAA,EAAQ,eAAA,GAAkB,OAAA,CAAQ,kBAAA,CAAmB,KAAA;AAAA"}

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

@@ -1,4 +1,4 @@
-import { AssembledToolCall } from "./tools.js";
+import { ClientAssembledToolCall } from "./tools.js";
 import { StreamingMessageHandle } from "../messages.js";
 import { AudioMedia, FileMedia, ImageMedia, VideoMedia } from "../media.js";
 import { EventForChannel, EventForChannels, SubscribeOptions, YieldForChannel, YieldForChannels } from "../types.js";
@@ -62,7 +62,7 @@ declare class SubgraphHandle {
   });
   get messages(): AsyncIterable<StreamingMessageHandle>;
   get values(): AsyncIterable<unknown> & PromiseLike<unknown>;
-  get toolCalls(): AsyncIterable<AssembledToolCall>;
+  get toolCalls(): AsyncIterable<ClientAssembledToolCall>;
   get subgraphs(): AsyncIterable<SubgraphHandle>;
   get subagents(): AsyncIterable<SubagentHandle>;
   get audio(): AsyncIterable<AudioMedia>;

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

@@ -1 +1 @@
-{"version":3,"file":"subgraphs.d.ts","names":[],"sources":["../../../../src/client/stream/handles/subgraphs.ts"],"mappings":";;;;;;;;;;;AAsCA;;;;UAAiB,YAAA;EACf,SAAA,kBAA2B,OAAA,EACzB,OAAA,EAAS,QAAA,EACT,OAAA,GAAU,gBAAA,GACT,OAAA,CACD,kBAAA,CAAmB,eAAA,CAAgB,QAAA,GAAW,eAAA,CAAgB,QAAA;EAEhE,SAAA,kCAA2C,OAAA,IACzC,QAAA,EAAU,SAAA,EACV,OAAA,GAAU,gBAAA,GACT,OAAA,CACD,kBAAA,CAAmB,gBAAA,CAAiB,SAAA,GAAY,gBAAA,CAAiB,SAAA;EAEnE,SAAA,CAAU,MAAA,EAAQ,eAAA,GAAkB,OAAA,CAAQ,kBAAA,CAAmB,KAAA;AAAA;;;;;;;;;;;;;;;cAiBpD,cAAA;EAAA;WACF,IAAA;EAAA,SACA,KAAA;EAAA,SACA,SAAA;EAhCC;;;;;;;;;;EAAA,SA2CD,KAAA,GAAQ,cAAA;EAAA,SACR,SAAA;EAtCT;;;;;EA4CA,gBAAA,GAAmB,UAAA;EAgBnB,WAAA,CACE,IAAA,UACA,KAAA,UACA,SAAA,YACA,OAAA,EAAS,YAAA,EACT,OAAA;IACE,KAAA,GAAQ,cAAA;IACR,SAAA;IACA,gBAAA,GAAmB,UAAA;EAAA;EAAA,IAYnB,QAAA,CAAA,GAAY,aAAA,CAAc,sBAAA;EAAA,IAiB1B,MAAA,CAAA,GAAU,aAAA,YAAyB,WAAA;EAAA,IAqCnC,SAAA,CAAA,GAAa,aAAA,CAAc,iBAAA;EAAA,IAiB3B,SAAA,CAAA,GAAa,aAAA,CAAc,cAAA;EAAA,IAsB3B,SAAA,CAAA,GAAa,aAAA,CAAc,cAAA;EAAA,IAoB3B,KAAA,CAAA,GAAS,aAAA,CAAc,UAAA;EAAA,IAKvB,MAAA,CAAA,GAAU,aAAA,CAAc,UAAA;EAAA,IAKxB,KAAA,CAAA,GAAS,aAAA,CAAc,UAAA;EAAA,IAKvB,KAAA,CAAA,GAAS,aAAA,CAAc,SAAA;EAAA,IAKvB,MAAA,CAAA,GAAU,OAAA;EA9LH;;;EAuOX,SAAA,kBAA2B,OAAA,CAAA,CACzB,OAAA,EAAS,QAAA,EACT,OAAA,GAAU,gBAAA,GACT,OAAA,CACD,kBAAA,CAAmB,eAAA,CAAgB,QAAA,GAAW,eAAA,CAAgB,QAAA;EAEhE,SAAA,kCAA2C,OAAA,GAAA,CACzC,QAAA,EAAU,SAAA,EACV,OAAA,GAAU,gBAAA,GACT,OAAA,CACD,kBAAA,CAAmB,gBAAA,CAAiB,SAAA,GAAY,gBAAA,CAAiB,SAAA;EAEnE,SAAA,CAAU,MAAA,EAAQ,eAAA,GAAkB,OAAA,CAAQ,kBAAA,CAAmB,KAAA;AAAA"}
+{"version":3,"file":"subgraphs.d.ts","names":[],"sources":["../../../../src/client/stream/handles/subgraphs.ts"],"mappings":";;;;;;;;;;;AAsCA;;;;UAAiB,YAAA;EACf,SAAA,kBAA2B,OAAA,EACzB,OAAA,EAAS,QAAA,EACT,OAAA,GAAU,gBAAA,GACT,OAAA,CACD,kBAAA,CAAmB,eAAA,CAAgB,QAAA,GAAW,eAAA,CAAgB,QAAA;EAEhE,SAAA,kCAA2C,OAAA,IACzC,QAAA,EAAU,SAAA,EACV,OAAA,GAAU,gBAAA,GACT,OAAA,CACD,kBAAA,CAAmB,gBAAA,CAAiB,SAAA,GAAY,gBAAA,CAAiB,SAAA;EAEnE,SAAA,CAAU,MAAA,EAAQ,eAAA,GAAkB,OAAA,CAAQ,kBAAA,CAAmB,KAAA;AAAA;;;;;;;;;;;;;;;cAiBpD,cAAA;EAAA;WACF,IAAA;EAAA,SACA,KAAA;EAAA,SACA,SAAA;EAhCC;;;;;;;;;;EAAA,SA2CD,KAAA,GAAQ,cAAA;EAAA,SACR,SAAA;EAtCT;;;;;EA4CA,gBAAA,GAAmB,UAAA;EAgBnB,WAAA,CACE,IAAA,UACA,KAAA,UACA,SAAA,YACA,OAAA,EAAS,YAAA,EACT,OAAA;IACE,KAAA,GAAQ,cAAA;IACR,SAAA;IACA,gBAAA,GAAmB,UAAA;EAAA;EAAA,IAYnB,QAAA,CAAA,GAAY,aAAA,CAAc,sBAAA;EAAA,IAiB1B,MAAA,CAAA,GAAU,aAAA,YAAyB,WAAA;EAAA,IAqCnC,SAAA,CAAA,GAAa,aAAA,CAAc,uBAAA;EAAA,IAiB3B,SAAA,CAAA,GAAa,aAAA,CAAc,cAAA;EAAA,IAsB3B,SAAA,CAAA,GAAa,aAAA,CAAc,cAAA;EAAA,IAoB3B,KAAA,CAAA,GAAS,aAAA,CAAc,UAAA;EAAA,IAKvB,MAAA,CAAA,GAAU,aAAA,CAAc,UAAA;EAAA,IAKxB,KAAA,CAAA,GAAS,aAAA,CAAc,UAAA;EAAA,IAKvB,KAAA,CAAA,GAAS,aAAA,CAAc,SAAA;EAAA,IAKvB,MAAA,CAAA,GAAU,OAAA;EA9LH;;;EAuOX,SAAA,kBAA2B,OAAA,CAAA,CACzB,OAAA,EAAS,QAAA,EACT,OAAA,GAAU,gBAAA,GACT,OAAA,CACD,kBAAA,CAAmB,eAAA,CAAgB,QAAA,GAAW,eAAA,CAAgB,QAAA;EAEhE,SAAA,kCAA2C,OAAA,GAAA,CACzC,QAAA,EAAU,SAAA,EACV,OAAA,GAAU,gBAAA,GACT,OAAA,CACD,kBAAA,CAAmB,gBAAA,CAAiB,SAAA,GAAY,gBAAA,CAAiB,SAAA;EAEnE,SAAA,CAAU,MAAA,EAAQ,eAAA,GAAkB,OAAA,CAAQ,kBAAA,CAAmB,KAAA;AAAA"}

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

@@ -1,5 +1,5 @@
 import { MultiCursorBuffer } from "../multi-cursor-buffer.js";
-import { ToolCallAssembler } from "./tools.js";
+import { ToolCallAssembler, toClientAssembledToolCall } from "./tools.js";
 import { StreamingMessageAssembler } from "../messages.js";
 import { MediaAssembler } from "../media.js";
 //#region src/client/stream/handles/subgraphs.ts
@@ -102,7 +102,7 @@ var SubgraphHandle = class {
 		this.#startProjection(["tools"], (event) => {
 			if (event.method !== "tools") return;
 			const tc = assembler.consume(event);
-			if (tc) buffer.push(tc);
+			if (tc) buffer.push(toClientAssembledToolCall(tc));
 		}, () => buffer.close());
 		return buffer;
 	}

package/dist/client/stream/handles/subgraphs.js.map

@@ -1 +1 @@
-{"version":3,"file":"subgraphs.js","names":["#session","#messagesIterable","#startProjection","#valuesProjection","#outputPromise","#toolCallsIterable","#subgraphsIterable","#subagentsIterable","#ensureMediaDispatcher","#audioBuffer","#imagesBuffer","#videoBuffer","#filesBuffer","#mediaDispatcherStarted","#source","#parentNamespace","#discovered","#pendingToolStarts","#pendingToolCallHandles","#queue","#waiters","#processToolEvent","#sourcePump","#processEvent","#emit","#closed","#start"],"sources":["../../../../src/client/stream/handles/subgraphs.ts"],"sourcesContent":["import type {\n  Channel,\n  Event,\n  LifecycleCause,\n  LifecycleEvent,\n  MessagesEvent,\n  SubscribeParams,\n  ToolsEvent,\n  ValuesEvent,\n} from \"@langchain/protocol\";\nimport type { SubscriptionHandle } from \"../index.js\";\nimport { MultiCursorBuffer } from \"../multi-cursor-buffer.js\";\nimport { StreamingMessageAssembler } from \"../messages.js\";\nimport type { StreamingMessage, StreamingMessageHandle } from \"../messages.js\";\nimport { ToolCallAssembler } from \"./tools.js\";\nimport type { AssembledToolCall } from \"./tools.js\";\nimport { MediaAssembler } from \"../media.js\";\nimport type {\n  AudioMedia,\n  FileMedia,\n  ImageMedia,\n  VideoMedia,\n} from \"../media.js\";\nimport type {\n  EventForChannel,\n  EventForChannels,\n  SubscribeOptions,\n  YieldForChannel,\n  YieldForChannels,\n} from \"../types.js\";\nimport type { SubagentHandle } from \"./subagents.js\";\n\n/**\n * Minimal subscription surface that {@link SubgraphHandle} and\n * {@link SubagentHandle} delegate to. Typed to match the\n * `Session.subscribe` raw-channel overloads without importing the\n * full `Session` class (avoids circular dependency).\n */\nexport interface Subscribable {\n  subscribe<TChannel extends Channel>(\n    channel: TChannel,\n    options?: SubscribeOptions\n  ): Promise<\n    SubscriptionHandle<EventForChannel<TChannel>, YieldForChannel<TChannel>>\n  >;\n  subscribe<const TChannels extends readonly Channel[]>(\n    channels: TChannels,\n    options?: SubscribeOptions\n  ): Promise<\n    SubscriptionHandle<EventForChannels<TChannels>, YieldForChannels<TChannels>>\n  >;\n  subscribe(params: SubscribeParams): Promise<SubscriptionHandle<Event>>;\n}\n\n/**\n * Discovered subgraph within a streaming session.\n *\n * Mirrors the in-process `SubgraphRunStream` pattern: each subgraph\n * has `name`, `index`, `namespace`, and lazy getters for projections\n * scoped to this subgraph's namespace.\n *\n * ```ts\n * for await (const sub of session.subgraphs) {\n *   for await (const msg of sub.messages) { ... }\n *   const state = await sub.output;\n * }\n * ```\n */\nexport class SubgraphHandle {\n  readonly name: string;\n  readonly index: number;\n  readonly namespace: string[];\n  /**\n   * Non-empty when upstream attached a `cause` to this subgraph's\n   * `lifecycle.started` event. Population is product-specific and\n   * performed by stream transformers on the runtime side (e.g.\n   * deepagents' `SubagentTransformer` emits\n   * `{ type: \"toolCall\", tool_call_id }`). Generic clients should\n   * treat `cause.type` as an open enum — the protocol allows future\n   * variants (`send`, `edge`, ...) to be forwarded verbatim without\n   * a SDK bump.\n   */\n  readonly cause?: LifecycleCause;\n  readonly graphName?: string;\n  /**\n   * Raw `tool-started` event that triggered this subgraph, when\n   * `cause.type === \"toolCall\"` and the matching event has been\n   * observed on the `tools` channel.\n   */\n  toolStartedEvent?: ToolsEvent;\n  readonly #session: Subscribable;\n\n  #messagesIterable?: AsyncIterable<StreamingMessage>;\n  #valuesProjection?: AsyncIterable<unknown> & PromiseLike<unknown>;\n  #toolCallsIterable?: AsyncIterable<AssembledToolCall>;\n  #subgraphsIterable?: AsyncIterable<SubgraphHandle>;\n  #subagentsIterable?: AsyncIterable<SubagentHandle>;\n  #outputPromise?: Promise<unknown>;\n\n  #mediaDispatcherStarted = false;\n  #audioBuffer?: MultiCursorBuffer<AudioMedia>;\n  #imagesBuffer?: MultiCursorBuffer<ImageMedia>;\n  #videoBuffer?: MultiCursorBuffer<VideoMedia>;\n  #filesBuffer?: MultiCursorBuffer<FileMedia>;\n\n  constructor(\n    name: string,\n    index: number,\n    namespace: string[],\n    session: Subscribable,\n    options?: {\n      cause?: LifecycleCause;\n      graphName?: string;\n      toolStartedEvent?: ToolsEvent;\n    }\n  ) {\n    this.name = name;\n    this.index = index;\n    this.namespace = namespace;\n    this.cause = options?.cause;\n    this.graphName = options?.graphName;\n    this.toolStartedEvent = options?.toolStartedEvent;\n    this.#session = session;\n  }\n\n  get messages(): AsyncIterable<StreamingMessageHandle> {\n    if (this.#messagesIterable) return this.#messagesIterable;\n    const buffer = new MultiCursorBuffer<StreamingMessage>();\n    this.#messagesIterable = buffer;\n    const assembler = new StreamingMessageAssembler();\n    void this.#startProjection(\n      [\"messages\"],\n      (event) => {\n        if (event.method !== \"messages\") return;\n        const msg = assembler.consume(event as MessagesEvent);\n        if (msg) buffer.push(msg);\n      },\n      () => buffer.close()\n    );\n    return buffer;\n  }\n\n  get values(): AsyncIterable<unknown> & PromiseLike<unknown> {\n    if (this.#valuesProjection) return this.#valuesProjection;\n    const buffer = new MultiCursorBuffer<unknown>();\n    let lastValue: unknown;\n    let resolveOutput!: (value: unknown) => void;\n    const outputPromise = new Promise<unknown>((resolve) => {\n      resolveOutput = resolve;\n    });\n    this.#outputPromise = outputPromise;\n    const projection = Object.assign(buffer, {\n      then: <TResult1 = unknown, TResult2 = never>(\n        onfulfilled?:\n          | ((value: unknown) => TResult1 | PromiseLike<TResult1>)\n          | null,\n        onrejected?:\n          | ((reason: unknown) => TResult2 | PromiseLike<TResult2>)\n          | null\n      ): Promise<TResult1 | TResult2> =>\n        outputPromise.then(onfulfilled, onrejected),\n    }) as AsyncIterable<unknown> & PromiseLike<unknown>;\n    this.#valuesProjection = projection;\n    void this.#startProjection(\n      [\"values\"],\n      (event) => {\n        if (event.method !== \"values\") return;\n        const data = (event as ValuesEvent).params.data;\n        lastValue = data;\n        buffer.push(data);\n      },\n      () => {\n        resolveOutput(lastValue);\n        buffer.close();\n      }\n    );\n    return projection;\n  }\n\n  get toolCalls(): AsyncIterable<AssembledToolCall> {\n    if (this.#toolCallsIterable) return this.#toolCallsIterable;\n    const buffer = new MultiCursorBuffer<AssembledToolCall>();\n    this.#toolCallsIterable = buffer;\n    const assembler = new ToolCallAssembler();\n    void this.#startProjection(\n      [\"tools\"],\n      (event) => {\n        if (event.method !== \"tools\") return;\n        const tc = assembler.consume(event as ToolsEvent);\n        if (tc) buffer.push(tc);\n      },\n      () => buffer.close()\n    );\n    return buffer;\n  }\n\n  get subgraphs(): AsyncIterable<SubgraphHandle> {\n    if (this.#subgraphsIterable) return this.#subgraphsIterable;\n    const buffer = new MultiCursorBuffer<SubgraphHandle>();\n    this.#subgraphsIterable = buffer;\n    void (async () => {\n      const rawHandle = await this.#session.subscribe({\n        channels: [\"lifecycle\", \"tools\"],\n        namespaces: [this.namespace],\n      });\n      const discovery = new SubgraphDiscoveryHandle(\n        rawHandle,\n        this.#session,\n        this.namespace\n      );\n      for await (const sub of discovery) {\n        buffer.push(sub);\n      }\n      buffer.close();\n    })();\n    return buffer;\n  }\n\n  get subagents(): AsyncIterable<SubagentHandle> {\n    if (this.#subagentsIterable) return this.#subagentsIterable;\n    const buffer = new MultiCursorBuffer<SubagentHandle>();\n    this.#subagentsIterable = buffer;\n    void (async () => {\n      const rawHandle = await this.#session.subscribe({\n        channels: [\"tools\", \"lifecycle\"],\n        namespaces: [this.namespace],\n      });\n      const { SubagentDiscoveryHandle: Discovery } =\n        await import(\"./subagents.js\");\n      const discovery = new Discovery(rawHandle, this.#session);\n      for await (const sub of discovery) {\n        buffer.push(sub);\n      }\n      buffer.close();\n    })();\n    return buffer;\n  }\n\n  get audio(): AsyncIterable<AudioMedia> {\n    this.#ensureMediaDispatcher();\n    return this.#audioBuffer!;\n  }\n\n  get images(): AsyncIterable<ImageMedia> {\n    this.#ensureMediaDispatcher();\n    return this.#imagesBuffer!;\n  }\n\n  get video(): AsyncIterable<VideoMedia> {\n    this.#ensureMediaDispatcher();\n    return this.#videoBuffer!;\n  }\n\n  get files(): AsyncIterable<FileMedia> {\n    this.#ensureMediaDispatcher();\n    return this.#filesBuffer!;\n  }\n\n  get output(): Promise<unknown> {\n    void this.values;\n    return this.#outputPromise!;\n  }\n\n  #ensureMediaDispatcher(): void {\n    if (this.#mediaDispatcherStarted) return;\n    this.#mediaDispatcherStarted = true;\n    const audio = new MultiCursorBuffer<AudioMedia>();\n    const images = new MultiCursorBuffer<ImageMedia>();\n    const video = new MultiCursorBuffer<VideoMedia>();\n    const files = new MultiCursorBuffer<FileMedia>();\n    this.#audioBuffer = audio;\n    this.#imagesBuffer = images;\n    this.#videoBuffer = video;\n    this.#filesBuffer = files;\n    const assembler = new MediaAssembler({\n      onAudio: (m: AudioMedia) => audio.push(m),\n      onImage: (m: ImageMedia) => images.push(m),\n      onVideo: (m: VideoMedia) => video.push(m),\n      onFile: (m: FileMedia) => files.push(m),\n    });\n    void this.#startProjection(\n      [\"messages\"],\n      (event) => {\n        if (event.method !== \"messages\") return;\n        assembler.consume(event as MessagesEvent);\n      },\n      () => {\n        assembler.close();\n        audio.close();\n        images.close();\n        video.close();\n        files.close();\n      }\n    );\n  }\n\n  /**\n   * Create a raw channel subscription scoped to this subgraph's namespace.\n   */\n  subscribe<TChannel extends Channel>(\n    channel: TChannel,\n    options?: SubscribeOptions\n  ): Promise<\n    SubscriptionHandle<EventForChannel<TChannel>, YieldForChannel<TChannel>>\n  >;\n  subscribe<const TChannels extends readonly Channel[]>(\n    channels: TChannels,\n    options?: SubscribeOptions\n  ): Promise<\n    SubscriptionHandle<EventForChannels<TChannels>, YieldForChannels<TChannels>>\n  >;\n  subscribe(params: SubscribeParams): Promise<SubscriptionHandle<Event>>;\n  subscribe(\n    paramsOrChannels: SubscribeParams | Channel | string | readonly Channel[],\n    options: SubscribeOptions = {}\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  ): Promise<any> {\n    if (\n      typeof paramsOrChannels === \"object\" &&\n      !Array.isArray(paramsOrChannels) &&\n      \"channels\" in paramsOrChannels\n    ) {\n      return this.#session.subscribe({\n        ...paramsOrChannels,\n        namespaces: paramsOrChannels.namespaces ?? [this.namespace],\n      });\n    }\n\n    return this.#session.subscribe(paramsOrChannels as Channel, {\n      ...options,\n      namespaces: options.namespaces ?? [this.namespace],\n    });\n  }\n\n  async #startProjection(\n    channels: Channel[],\n    onEvent: (event: Event) => void,\n    onDone: () => void\n  ): Promise<void> {\n    try {\n      const rawHandle = await this.#session.subscribe({\n        channels,\n        namespaces: [this.namespace],\n      });\n      for await (const event of rawHandle) {\n        onEvent(event);\n      }\n    } finally {\n      onDone();\n    }\n  }\n}\n\n/**\n * Async iterable that yields {@link SubgraphHandle} instances as new\n * subgraph namespaces are discovered from `lifecycle` events.\n *\n * Mirrors the in-process `run.subgraphs` pattern. A new subgraph is\n * discovered when a `lifecycle` event with `event: \"started\"` is\n * received at a namespace depth of exactly `parentDepth + 1`.\n */\nexport class SubgraphDiscoveryHandle implements AsyncIterable<SubgraphHandle> {\n  readonly #source: SubscriptionHandle<Event>;\n  readonly #session: Subscribable;\n  readonly #parentNamespace: string[];\n  readonly #discovered = new Set<string>();\n  readonly #pendingToolStarts = new Map<string, ToolsEvent>();\n  readonly #pendingToolCallHandles = new Map<string, SubgraphHandle>();\n  readonly #queue: SubgraphHandle[] = [];\n  readonly #waiters: Array<(value: IteratorResult<SubgraphHandle>) => void> =\n    [];\n  #sourcePump?: Promise<void>;\n  #closed = false;\n\n  constructor(\n    source: SubscriptionHandle<Event>,\n    session: Subscribable,\n    parentNamespace: string[] = []\n  ) {\n    this.#source = source;\n    this.#session = session;\n    this.#parentNamespace = parentNamespace;\n  }\n\n  #emit(handle: SubgraphHandle): void {\n    const waiter = this.#waiters.shift();\n    if (waiter) {\n      waiter({ done: false, value: handle });\n    } else {\n      this.#queue.push(handle);\n    }\n  }\n\n  #processToolEvent(event: Event): boolean {\n    if (event.method !== \"tools\") return false;\n    const tools = event as ToolsEvent;\n    const data = tools.params.data as Record<string, unknown>;\n    if (data.event !== \"tool-started\") return true;\n\n    const toolCallId = data.tool_call_id as string | undefined;\n    if (!toolCallId) return true;\n\n    const pendingHandle = this.#pendingToolCallHandles.get(toolCallId);\n    if (pendingHandle) {\n      pendingHandle.toolStartedEvent = tools;\n      this.#pendingToolCallHandles.delete(toolCallId);\n      return true;\n    }\n\n    this.#pendingToolStarts.set(toolCallId, tools);\n    return true;\n  }\n\n  #processEvent(event: Event): SubgraphHandle | undefined {\n    if (this.#processToolEvent(event)) return undefined;\n    if (event.method !== \"lifecycle\") return undefined;\n    const lifecycle = event as LifecycleEvent;\n    if (lifecycle.params.data.event !== \"started\") return undefined;\n\n    const ns = event.params.namespace;\n    if (ns.length !== this.#parentNamespace.length + 1) return undefined;\n\n    const isChild = this.#parentNamespace.every((seg, i) => ns[i] === seg);\n    if (!isChild) return undefined;\n\n    const nsKey = ns.join(\"/\");\n    if (this.#discovered.has(nsKey)) return undefined;\n    this.#discovered.add(nsKey);\n\n    const lastSegment = ns[ns.length - 1] ?? \"\";\n    const colonIdx = lastSegment.lastIndexOf(\":\");\n    let name: string;\n    let index: number;\n    if (colonIdx >= 0) {\n      name = lastSegment.slice(0, colonIdx);\n      const suffix = lastSegment.slice(colonIdx + 1);\n      index = /^\\d+$/.test(suffix) ? Number(suffix) : 0;\n    } else {\n      name = lastSegment;\n      index = 0;\n    }\n\n    const data = lifecycle.params.data as unknown as Record<string, unknown>;\n    const cause =\n      data.cause && typeof data.cause === \"object\"\n        ? (data.cause as LifecycleCause)\n        : undefined;\n    let toolStartedEvent: ToolsEvent | undefined;\n    if (cause?.type === \"toolCall\") {\n      const toolCallId = (cause as { tool_call_id?: string }).tool_call_id;\n      if (toolCallId) {\n        toolStartedEvent = this.#pendingToolStarts.get(toolCallId);\n        this.#pendingToolStarts.delete(toolCallId);\n      }\n    }\n\n    const handle = new SubgraphHandle(name, index, [...ns], this.#session, {\n      cause,\n      graphName: data.graph_name as string | undefined,\n      toolStartedEvent,\n    });\n    if (cause?.type === \"toolCall\" && toolStartedEvent == null) {\n      const toolCallId = (cause as { tool_call_id?: string }).tool_call_id;\n      if (toolCallId) this.#pendingToolCallHandles.set(toolCallId, handle);\n    }\n    return handle;\n  }\n\n  #start(): void {\n    if (this.#sourcePump) return;\n    this.#sourcePump = (async () => {\n      for await (const event of this.#source) {\n        const handle = this.#processEvent(event);\n        if (!handle) continue;\n        this.#emit(handle);\n      }\n      this.#pendingToolStarts.clear();\n      this.#pendingToolCallHandles.clear();\n      this.#closed = true;\n      while (this.#waiters.length > 0) {\n        this.#waiters.shift()?.({ done: true, value: undefined });\n      }\n    })();\n  }\n\n  async close(): Promise<void> {\n    this.#closed = true;\n    await this.#source.unsubscribe();\n  }\n\n  [Symbol.asyncIterator](): AsyncIterator<SubgraphHandle> {\n    this.#start();\n    return {\n      next: async () => {\n        if (this.#queue.length > 0) {\n          return { done: false, value: this.#queue.shift()! };\n        }\n        if (this.#closed) {\n          return { done: true, value: undefined };\n        }\n        return await new Promise<IteratorResult<SubgraphHandle>>((resolve) => {\n          this.#waiters.push(resolve);\n        });\n      },\n      return: async () => {\n        await this.close();\n        return { done: true, value: undefined };\n      },\n    };\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"subgraphs.js","names":["#session","#messagesIterable","#startProjection","#valuesProjection","#outputPromise","#toolCallsIterable","#subgraphsIterable","#subagentsIterable","#ensureMediaDispatcher","#audioBuffer","#imagesBuffer","#videoBuffer","#filesBuffer","#mediaDispatcherStarted","#source","#parentNamespace","#discovered","#pendingToolStarts","#pendingToolCallHandles","#queue","#waiters","#processToolEvent","#sourcePump","#processEvent","#emit","#closed","#start"],"sources":["../../../../src/client/stream/handles/subgraphs.ts"],"sourcesContent":["import type {\n  Channel,\n  Event,\n  LifecycleCause,\n  LifecycleEvent,\n  MessagesEvent,\n  SubscribeParams,\n  ToolsEvent,\n  ValuesEvent,\n} from \"@langchain/protocol\";\nimport type { SubscriptionHandle } from \"../index.js\";\nimport { MultiCursorBuffer } from \"../multi-cursor-buffer.js\";\nimport { StreamingMessageAssembler } from \"../messages.js\";\nimport type { StreamingMessage, StreamingMessageHandle } from \"../messages.js\";\nimport { ToolCallAssembler, toClientAssembledToolCall } from \"./tools.js\";\nimport type { ClientAssembledToolCall } from \"./tools.js\";\nimport { MediaAssembler } from \"../media.js\";\nimport type {\n  AudioMedia,\n  FileMedia,\n  ImageMedia,\n  VideoMedia,\n} from \"../media.js\";\nimport type {\n  EventForChannel,\n  EventForChannels,\n  SubscribeOptions,\n  YieldForChannel,\n  YieldForChannels,\n} from \"../types.js\";\nimport type { SubagentHandle } from \"./subagents.js\";\n\n/**\n * Minimal subscription surface that {@link SubgraphHandle} and\n * {@link SubagentHandle} delegate to. Typed to match the\n * `Session.subscribe` raw-channel overloads without importing the\n * full `Session` class (avoids circular dependency).\n */\nexport interface Subscribable {\n  subscribe<TChannel extends Channel>(\n    channel: TChannel,\n    options?: SubscribeOptions\n  ): Promise<\n    SubscriptionHandle<EventForChannel<TChannel>, YieldForChannel<TChannel>>\n  >;\n  subscribe<const TChannels extends readonly Channel[]>(\n    channels: TChannels,\n    options?: SubscribeOptions\n  ): Promise<\n    SubscriptionHandle<EventForChannels<TChannels>, YieldForChannels<TChannels>>\n  >;\n  subscribe(params: SubscribeParams): Promise<SubscriptionHandle<Event>>;\n}\n\n/**\n * Discovered subgraph within a streaming session.\n *\n * Mirrors the in-process `SubgraphRunStream` pattern: each subgraph\n * has `name`, `index`, `namespace`, and lazy getters for projections\n * scoped to this subgraph's namespace.\n *\n * ```ts\n * for await (const sub of session.subgraphs) {\n *   for await (const msg of sub.messages) { ... }\n *   const state = await sub.output;\n * }\n * ```\n */\nexport class SubgraphHandle {\n  readonly name: string;\n  readonly index: number;\n  readonly namespace: string[];\n  /**\n   * Non-empty when upstream attached a `cause` to this subgraph's\n   * `lifecycle.started` event. Population is product-specific and\n   * performed by stream transformers on the runtime side (e.g.\n   * deepagents' `SubagentTransformer` emits\n   * `{ type: \"toolCall\", tool_call_id }`). Generic clients should\n   * treat `cause.type` as an open enum — the protocol allows future\n   * variants (`send`, `edge`, ...) to be forwarded verbatim without\n   * a SDK bump.\n   */\n  readonly cause?: LifecycleCause;\n  readonly graphName?: string;\n  /**\n   * Raw `tool-started` event that triggered this subgraph, when\n   * `cause.type === \"toolCall\"` and the matching event has been\n   * observed on the `tools` channel.\n   */\n  toolStartedEvent?: ToolsEvent;\n  readonly #session: Subscribable;\n\n  #messagesIterable?: AsyncIterable<StreamingMessage>;\n  #valuesProjection?: AsyncIterable<unknown> & PromiseLike<unknown>;\n  #toolCallsIterable?: AsyncIterable<ClientAssembledToolCall>;\n  #subgraphsIterable?: AsyncIterable<SubgraphHandle>;\n  #subagentsIterable?: AsyncIterable<SubagentHandle>;\n  #outputPromise?: Promise<unknown>;\n\n  #mediaDispatcherStarted = false;\n  #audioBuffer?: MultiCursorBuffer<AudioMedia>;\n  #imagesBuffer?: MultiCursorBuffer<ImageMedia>;\n  #videoBuffer?: MultiCursorBuffer<VideoMedia>;\n  #filesBuffer?: MultiCursorBuffer<FileMedia>;\n\n  constructor(\n    name: string,\n    index: number,\n    namespace: string[],\n    session: Subscribable,\n    options?: {\n      cause?: LifecycleCause;\n      graphName?: string;\n      toolStartedEvent?: ToolsEvent;\n    }\n  ) {\n    this.name = name;\n    this.index = index;\n    this.namespace = namespace;\n    this.cause = options?.cause;\n    this.graphName = options?.graphName;\n    this.toolStartedEvent = options?.toolStartedEvent;\n    this.#session = session;\n  }\n\n  get messages(): AsyncIterable<StreamingMessageHandle> {\n    if (this.#messagesIterable) return this.#messagesIterable;\n    const buffer = new MultiCursorBuffer<StreamingMessage>();\n    this.#messagesIterable = buffer;\n    const assembler = new StreamingMessageAssembler();\n    void this.#startProjection(\n      [\"messages\"],\n      (event) => {\n        if (event.method !== \"messages\") return;\n        const msg = assembler.consume(event as MessagesEvent);\n        if (msg) buffer.push(msg);\n      },\n      () => buffer.close()\n    );\n    return buffer;\n  }\n\n  get values(): AsyncIterable<unknown> & PromiseLike<unknown> {\n    if (this.#valuesProjection) return this.#valuesProjection;\n    const buffer = new MultiCursorBuffer<unknown>();\n    let lastValue: unknown;\n    let resolveOutput!: (value: unknown) => void;\n    const outputPromise = new Promise<unknown>((resolve) => {\n      resolveOutput = resolve;\n    });\n    this.#outputPromise = outputPromise;\n    const projection = Object.assign(buffer, {\n      then: <TResult1 = unknown, TResult2 = never>(\n        onfulfilled?:\n          | ((value: unknown) => TResult1 | PromiseLike<TResult1>)\n          | null,\n        onrejected?:\n          | ((reason: unknown) => TResult2 | PromiseLike<TResult2>)\n          | null\n      ): Promise<TResult1 | TResult2> =>\n        outputPromise.then(onfulfilled, onrejected),\n    }) as AsyncIterable<unknown> & PromiseLike<unknown>;\n    this.#valuesProjection = projection;\n    void this.#startProjection(\n      [\"values\"],\n      (event) => {\n        if (event.method !== \"values\") return;\n        const data = (event as ValuesEvent).params.data;\n        lastValue = data;\n        buffer.push(data);\n      },\n      () => {\n        resolveOutput(lastValue);\n        buffer.close();\n      }\n    );\n    return projection;\n  }\n\n  get toolCalls(): AsyncIterable<ClientAssembledToolCall> {\n    if (this.#toolCallsIterable) return this.#toolCallsIterable;\n    const buffer = new MultiCursorBuffer<ClientAssembledToolCall>();\n    this.#toolCallsIterable = buffer;\n    const assembler = new ToolCallAssembler();\n    void this.#startProjection(\n      [\"tools\"],\n      (event) => {\n        if (event.method !== \"tools\") return;\n        const tc = assembler.consume(event as ToolsEvent);\n        if (tc) buffer.push(toClientAssembledToolCall(tc));\n      },\n      () => buffer.close()\n    );\n    return buffer;\n  }\n\n  get subgraphs(): AsyncIterable<SubgraphHandle> {\n    if (this.#subgraphsIterable) return this.#subgraphsIterable;\n    const buffer = new MultiCursorBuffer<SubgraphHandle>();\n    this.#subgraphsIterable = buffer;\n    void (async () => {\n      const rawHandle = await this.#session.subscribe({\n        channels: [\"lifecycle\", \"tools\"],\n        namespaces: [this.namespace],\n      });\n      const discovery = new SubgraphDiscoveryHandle(\n        rawHandle,\n        this.#session,\n        this.namespace\n      );\n      for await (const sub of discovery) {\n        buffer.push(sub);\n      }\n      buffer.close();\n    })();\n    return buffer;\n  }\n\n  get subagents(): AsyncIterable<SubagentHandle> {\n    if (this.#subagentsIterable) return this.#subagentsIterable;\n    const buffer = new MultiCursorBuffer<SubagentHandle>();\n    this.#subagentsIterable = buffer;\n    void (async () => {\n      const rawHandle = await this.#session.subscribe({\n        channels: [\"tools\", \"lifecycle\"],\n        namespaces: [this.namespace],\n      });\n      const { SubagentDiscoveryHandle: Discovery } =\n        await import(\"./subagents.js\");\n      const discovery = new Discovery(rawHandle, this.#session);\n      for await (const sub of discovery) {\n        buffer.push(sub);\n      }\n      buffer.close();\n    })();\n    return buffer;\n  }\n\n  get audio(): AsyncIterable<AudioMedia> {\n    this.#ensureMediaDispatcher();\n    return this.#audioBuffer!;\n  }\n\n  get images(): AsyncIterable<ImageMedia> {\n    this.#ensureMediaDispatcher();\n    return this.#imagesBuffer!;\n  }\n\n  get video(): AsyncIterable<VideoMedia> {\n    this.#ensureMediaDispatcher();\n    return this.#videoBuffer!;\n  }\n\n  get files(): AsyncIterable<FileMedia> {\n    this.#ensureMediaDispatcher();\n    return this.#filesBuffer!;\n  }\n\n  get output(): Promise<unknown> {\n    void this.values;\n    return this.#outputPromise!;\n  }\n\n  #ensureMediaDispatcher(): void {\n    if (this.#mediaDispatcherStarted) return;\n    this.#mediaDispatcherStarted = true;\n    const audio = new MultiCursorBuffer<AudioMedia>();\n    const images = new MultiCursorBuffer<ImageMedia>();\n    const video = new MultiCursorBuffer<VideoMedia>();\n    const files = new MultiCursorBuffer<FileMedia>();\n    this.#audioBuffer = audio;\n    this.#imagesBuffer = images;\n    this.#videoBuffer = video;\n    this.#filesBuffer = files;\n    const assembler = new MediaAssembler({\n      onAudio: (m: AudioMedia) => audio.push(m),\n      onImage: (m: ImageMedia) => images.push(m),\n      onVideo: (m: VideoMedia) => video.push(m),\n      onFile: (m: FileMedia) => files.push(m),\n    });\n    void this.#startProjection(\n      [\"messages\"],\n      (event) => {\n        if (event.method !== \"messages\") return;\n        assembler.consume(event as MessagesEvent);\n      },\n      () => {\n        assembler.close();\n        audio.close();\n        images.close();\n        video.close();\n        files.close();\n      }\n    );\n  }\n\n  /**\n   * Create a raw channel subscription scoped to this subgraph's namespace.\n   */\n  subscribe<TChannel extends Channel>(\n    channel: TChannel,\n    options?: SubscribeOptions\n  ): Promise<\n    SubscriptionHandle<EventForChannel<TChannel>, YieldForChannel<TChannel>>\n  >;\n  subscribe<const TChannels extends readonly Channel[]>(\n    channels: TChannels,\n    options?: SubscribeOptions\n  ): Promise<\n    SubscriptionHandle<EventForChannels<TChannels>, YieldForChannels<TChannels>>\n  >;\n  subscribe(params: SubscribeParams): Promise<SubscriptionHandle<Event>>;\n  subscribe(\n    paramsOrChannels: SubscribeParams | Channel | string | readonly Channel[],\n    options: SubscribeOptions = {}\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  ): Promise<any> {\n    if (\n      typeof paramsOrChannels === \"object\" &&\n      !Array.isArray(paramsOrChannels) &&\n      \"channels\" in paramsOrChannels\n    ) {\n      return this.#session.subscribe({\n        ...paramsOrChannels,\n        namespaces: paramsOrChannels.namespaces ?? [this.namespace],\n      });\n    }\n\n    return this.#session.subscribe(paramsOrChannels as Channel, {\n      ...options,\n      namespaces: options.namespaces ?? [this.namespace],\n    });\n  }\n\n  async #startProjection(\n    channels: Channel[],\n    onEvent: (event: Event) => void,\n    onDone: () => void\n  ): Promise<void> {\n    try {\n      const rawHandle = await this.#session.subscribe({\n        channels,\n        namespaces: [this.namespace],\n      });\n      for await (const event of rawHandle) {\n        onEvent(event);\n      }\n    } finally {\n      onDone();\n    }\n  }\n}\n\n/**\n * Async iterable that yields {@link SubgraphHandle} instances as new\n * subgraph namespaces are discovered from `lifecycle` events.\n *\n * Mirrors the in-process `run.subgraphs` pattern. A new subgraph is\n * discovered when a `lifecycle` event with `event: \"started\"` is\n * received at a namespace depth of exactly `parentDepth + 1`.\n */\nexport class SubgraphDiscoveryHandle implements AsyncIterable<SubgraphHandle> {\n  readonly #source: SubscriptionHandle<Event>;\n  readonly #session: Subscribable;\n  readonly #parentNamespace: string[];\n  readonly #discovered = new Set<string>();\n  readonly #pendingToolStarts = new Map<string, ToolsEvent>();\n  readonly #pendingToolCallHandles = new Map<string, SubgraphHandle>();\n  readonly #queue: SubgraphHandle[] = [];\n  readonly #waiters: Array<(value: IteratorResult<SubgraphHandle>) => void> =\n    [];\n  #sourcePump?: Promise<void>;\n  #closed = false;\n\n  constructor(\n    source: SubscriptionHandle<Event>,\n    session: Subscribable,\n    parentNamespace: string[] = []\n  ) {\n    this.#source = source;\n    this.#session = session;\n    this.#parentNamespace = parentNamespace;\n  }\n\n  #emit(handle: SubgraphHandle): void {\n    const waiter = this.#waiters.shift();\n    if (waiter) {\n      waiter({ done: false, value: handle });\n    } else {\n      this.#queue.push(handle);\n    }\n  }\n\n  #processToolEvent(event: Event): boolean {\n    if (event.method !== \"tools\") return false;\n    const tools = event as ToolsEvent;\n    const data = tools.params.data as Record<string, unknown>;\n    if (data.event !== \"tool-started\") return true;\n\n    const toolCallId = data.tool_call_id as string | undefined;\n    if (!toolCallId) return true;\n\n    const pendingHandle = this.#pendingToolCallHandles.get(toolCallId);\n    if (pendingHandle) {\n      pendingHandle.toolStartedEvent = tools;\n      this.#pendingToolCallHandles.delete(toolCallId);\n      return true;\n    }\n\n    this.#pendingToolStarts.set(toolCallId, tools);\n    return true;\n  }\n\n  #processEvent(event: Event): SubgraphHandle | undefined {\n    if (this.#processToolEvent(event)) return undefined;\n    if (event.method !== \"lifecycle\") return undefined;\n    const lifecycle = event as LifecycleEvent;\n    if (lifecycle.params.data.event !== \"started\") return undefined;\n\n    const ns = event.params.namespace;\n    if (ns.length !== this.#parentNamespace.length + 1) return undefined;\n\n    const isChild = this.#parentNamespace.every((seg, i) => ns[i] === seg);\n    if (!isChild) return undefined;\n\n    const nsKey = ns.join(\"/\");\n    if (this.#discovered.has(nsKey)) return undefined;\n    this.#discovered.add(nsKey);\n\n    const lastSegment = ns[ns.length - 1] ?? \"\";\n    const colonIdx = lastSegment.lastIndexOf(\":\");\n    let name: string;\n    let index: number;\n    if (colonIdx >= 0) {\n      name = lastSegment.slice(0, colonIdx);\n      const suffix = lastSegment.slice(colonIdx + 1);\n      index = /^\\d+$/.test(suffix) ? Number(suffix) : 0;\n    } else {\n      name = lastSegment;\n      index = 0;\n    }\n\n    const data = lifecycle.params.data as unknown as Record<string, unknown>;\n    const cause =\n      data.cause && typeof data.cause === \"object\"\n        ? (data.cause as LifecycleCause)\n        : undefined;\n    let toolStartedEvent: ToolsEvent | undefined;\n    if (cause?.type === \"toolCall\") {\n      const toolCallId = (cause as { tool_call_id?: string }).tool_call_id;\n      if (toolCallId) {\n        toolStartedEvent = this.#pendingToolStarts.get(toolCallId);\n        this.#pendingToolStarts.delete(toolCallId);\n      }\n    }\n\n    const handle = new SubgraphHandle(name, index, [...ns], this.#session, {\n      cause,\n      graphName: data.graph_name as string | undefined,\n      toolStartedEvent,\n    });\n    if (cause?.type === \"toolCall\" && toolStartedEvent == null) {\n      const toolCallId = (cause as { tool_call_id?: string }).tool_call_id;\n      if (toolCallId) this.#pendingToolCallHandles.set(toolCallId, handle);\n    }\n    return handle;\n  }\n\n  #start(): void {\n    if (this.#sourcePump) return;\n    this.#sourcePump = (async () => {\n      for await (const event of this.#source) {\n        const handle = this.#processEvent(event);\n        if (!handle) continue;\n        this.#emit(handle);\n      }\n      this.#pendingToolStarts.clear();\n      this.#pendingToolCallHandles.clear();\n      this.#closed = true;\n      while (this.#waiters.length > 0) {\n        this.#waiters.shift()?.({ done: true, value: undefined });\n      }\n    })();\n  }\n\n  async close(): Promise<void> {\n    this.#closed = true;\n    await this.#source.unsubscribe();\n  }\n\n  [Symbol.asyncIterator](): AsyncIterator<SubgraphHandle> {\n    this.#start();\n    return {\n      next: async () => {\n        if (this.#queue.length > 0) {\n          return { done: false, value: this.#queue.shift()! };\n        }\n        if (this.#closed) {\n          return { done: true, value: undefined };\n        }\n        return await new Promise<IteratorResult<SubgraphHandle>>((resolve) => {\n          this.#waiters.push(resolve);\n        });\n      },\n      return: async () => {\n        await this.close();\n        return { done: true, value: undefined };\n      },\n    };\n  }\n}\n"],"mappings":"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"}

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

@@ -1,92 +1,164 @@
 //#region src/client/stream/handles/tools.ts
 /**
-* Incrementally assembles `tools` events into complete
-* {@link AssembledToolCall} objects with promise-based output/status/error.
+* Project a runtime handle to the client SDK surface (promise-only
+* {@link output}, no {@link status} / {@link error} fields).
+*/
+function toClientAssembledToolCall(handle) {
+	return {
+		name: handle.name,
+		callId: handle.callId,
+		id: handle.id,
+		namespace: handle.namespace,
+		input: handle.input,
+		args: handle.args,
+		output: handle.outputPromise
+	};
+}
+/**
+* Parse wire-format tool payloads into structured values.
+*
+* Tool events may carry JSON-encoded object strings on the wire; this
+* helper normalises them to plain objects for consumers. Non-JSON strings
+* are returned unchanged.
+*/
+function parseToolPayload(value) {
+	if (typeof value !== "string") return value;
+	const trimmed = value.trim();
+	if (!trimmed.startsWith("{") && !trimmed.startsWith("[")) return value;
+	try {
+		return JSON.parse(trimmed);
+	} catch {
+		return value;
+	}
+}
+function isToolMessageLike(value) {
+	if (!value || typeof value !== "object") return false;
+	const record = value;
+	if (record.type === "tool") return true;
+	return typeof record.tool_call_id === "string" && "content" in record;
+}
+function textFromContentBlocks(content) {
+	let out = "";
+	for (const block of content) {
+		if (!block || typeof block !== "object") continue;
+		const record = block;
+		if (record.type === "text" && typeof record.text === "string") out += record.text;
+	}
+	return out;
+}
+/**
+* Normalise tool-result `content` from a wire ToolMessage into the value
+* a tool implementation returned (object, string, etc.).
+*/
+function parseToolResultContent(content) {
+	if (content == null) return null;
+	if (typeof content === "string") {
+		if (content.trim().length === 0) return null;
+		return parseToolPayload(content);
+	}
+	if (Array.isArray(content)) {
+		const text = textFromContentBlocks(content);
+		if (text.length === 0) return null;
+		return parseToolPayload(text);
+	}
+	if (typeof content === "object") return content;
+	return null;
+}
+/**
+* Parse a `tool-finished` output payload into the tool's return value.
 *
-* Each `tool-started` event produces an {@link AssembledToolCall} whose
-* `output`, `status`, and `error` promises resolve when `tool-finished`
-* or `tool-error` arrives for the same `tool_call_id`.
+* Wire events often wrap structured tool results in a ToolMessage-shaped
+* object (`{ type: "tool", content: "..." }`). This unwraps that envelope,
+* JSON-decodes string content when possible, and leaves plain strings as-is.
+* Returns `null` when a ToolMessage envelope is present but its content
+* cannot be normalised.
+*/
+function parseToolOutput(value) {
+	const parsed = parseToolPayload(value);
+	if (isToolMessageLike(parsed)) return parseToolResultContent(parsed.content);
+	return parsed ?? null;
+}
+/**
+* Incrementally assembles `tools` events into mutable tool-call handles.
+*
+* Framework consumers store the handle directly; client SDK consumers
+* should map with {@link toClientAssembledToolCall} before yielding.
 */
 var ToolCallAssembler = class {
 	active = /* @__PURE__ */ new Map();
 	consume(event) {
 		const data = event.params.data;
 		if (data.event === "tool-started") return this.handleStarted(event, data);
-		if (data.event === "tool-finished") {
-			this.handleFinished(data);
-			return;
-		}
-		if (data.event === "tool-error") {
-			this.handleError(data);
-			return;
-		}
+		if (data.event === "tool-finished") return this.handleFinished(data);
+		if (data.event === "tool-error") return this.handleError(data);
 	}
 	/**
 	* Reject any in-flight tool calls (e.g. on session close).
 	*/
 	failAll(reason) {
-		for (const tc of this.active.values()) {
-			tc.rejectOutput(reason);
-			tc.resolveStatus("error");
-			tc.resolveError(reason.message);
+		for (const entry of this.active.values()) {
+			entry.rejectOutput(reason);
+			entry.handle.status = "error";
+			entry.handle.error = reason.message;
 		}
 		this.active.clear();
 	}
 	handleStarted(event, data) {
 		let resolveOutput;
 		let rejectOutput;
-		let resolveStatus;
-		let resolveError;
-		const output = new Promise((resolve, reject) => {
+		const outputPromise = new Promise((resolve, reject) => {
 			resolveOutput = resolve;
 			rejectOutput = reject;
 		});
-		output.catch(() => void 0);
-		const status = new Promise((resolve) => {
-			resolveStatus = resolve;
-		});
-		const error = new Promise((resolve) => {
-			resolveError = resolve;
-		});
-		const entry = {
-			name: data.tool_name,
-			callId: data.tool_call_id,
+		outputPromise.catch(() => void 0);
+		const input = parseToolPayload(data.input);
+		const name = data.tool_name;
+		const callId = data.tool_call_id;
+		const handle = {
+			name,
+			callId,
+			id: callId,
 			namespace: [...event.params.namespace],
-			input: data.input,
-			resolveOutput,
-			rejectOutput,
-			resolveStatus,
-			resolveError
-		};
-		this.active.set(data.tool_call_id, entry);
-		return {
-			name: entry.name,
-			callId: entry.callId,
-			namespace: entry.namespace,
-			input: entry.input,
-			output,
-			status,
-			error
+			input,
+			args: input,
+			output: null,
+			status: "running",
+			error: void 0,
+			outputPromise
 		};
+		this.active.set(callId, {
+			handle,
+			resolveOutput,
+			rejectOutput
+		});
+		return handle;
 	}
 	handleFinished(data) {
 		const entry = this.active.get(data.tool_call_id);
-		if (!entry) return;
+		if (!entry) return void 0;
 		this.active.delete(data.tool_call_id);
-		entry.resolveOutput(data.output);
-		entry.resolveStatus("finished");
-		entry.resolveError(void 0);
+		const value = parseToolOutput(data.output);
+		entry.resolveOutput(value);
+		entry.handle.output = value;
+		entry.handle.status = "finished";
+		entry.handle.error = void 0;
+		return entry.handle;
 	}
 	handleError(data) {
 		const entry = this.active.get(data.tool_call_id);
-		if (!entry) return;
+		if (!entry) return void 0;
 		this.active.delete(data.tool_call_id);
 		entry.rejectOutput(new Error(data.message));
-		entry.resolveStatus("error");
-		entry.resolveError(data.message);
+		entry.handle.output = null;
+		entry.handle.status = "error";
+		entry.handle.error = data.message;
+		return entry.handle;
 	}
 };
 //#endregion
 exports.ToolCallAssembler = ToolCallAssembler;
+exports.parseToolOutput = parseToolOutput;
+exports.parseToolPayload = parseToolPayload;
+exports.toClientAssembledToolCall = toClientAssembledToolCall;
 
 //# sourceMappingURL=tools.cjs.map

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

@@ -1 +1 @@
-{"version":3,"file":"tools.cjs","names":[],"sources":["../../../../src/client/stream/handles/tools.ts"],"sourcesContent":["import type {\n  ToolsEvent,\n  ToolStartedData,\n  ToolFinishedData,\n  ToolErrorData,\n} from \"@langchain/protocol\";\n\n/**\n * High-level outcome of a single tool call.\n */\nexport type ToolCallStatus = \"running\" | \"finished\" | \"error\";\n\n/**\n * Assembled view of a single tool call lifecycle (`tool-started` →\n * optional `tool-output-delta` → `tool-finished` | `tool-error`).\n *\n * Mirrors the in-process `ToolCallStream` interface so that remote\n * consumers get the same ergonomics.\n */\nexport interface AssembledToolCall {\n  readonly name: string;\n  readonly callId: string;\n  readonly namespace: string[];\n  readonly input: unknown;\n  readonly output: Promise<unknown>;\n  readonly status: Promise<ToolCallStatus>;\n  readonly error: Promise<string | undefined>;\n}\n\ntype ActiveToolCall = {\n  name: string;\n  callId: string;\n  namespace: string[];\n  input: unknown;\n  resolveOutput: (value: unknown) => void;\n  rejectOutput: (err: Error) => void;\n  resolveStatus: (value: ToolCallStatus) => void;\n  resolveError: (value: string | undefined) => void;\n};\n\n/**\n * Incrementally assembles `tools` events into complete\n * {@link AssembledToolCall} objects with promise-based output/status/error.\n *\n * Each `tool-started` event produces an {@link AssembledToolCall} whose\n * `output`, `status`, and `error` promises resolve when `tool-finished`\n * or `tool-error` arrives for the same `tool_call_id`.\n */\nexport class ToolCallAssembler {\n  private readonly active = new Map<string, ActiveToolCall>();\n\n  consume(event: ToolsEvent): AssembledToolCall | undefined {\n    const data = event.params.data;\n\n    if (data.event === \"tool-started\") {\n      return this.handleStarted(event, data);\n    }\n\n    if (data.event === \"tool-finished\") {\n      this.handleFinished(data);\n      return undefined;\n    }\n\n    if (data.event === \"tool-error\") {\n      this.handleError(data);\n      return undefined;\n    }\n\n    // tool-output-delta: no action needed at assembly level\n    return undefined;\n  }\n\n  /**\n   * Reject any in-flight tool calls (e.g. on session close).\n   */\n  failAll(reason: Error): void {\n    for (const tc of this.active.values()) {\n      tc.rejectOutput(reason);\n      tc.resolveStatus(\"error\");\n      tc.resolveError(reason.message);\n    }\n    this.active.clear();\n  }\n\n  private handleStarted(\n    event: ToolsEvent,\n    data: ToolStartedData\n  ): AssembledToolCall {\n    let resolveOutput!: (value: unknown) => void;\n    let rejectOutput!: (err: Error) => void;\n    let resolveStatus!: (value: ToolCallStatus) => void;\n    let resolveError!: (value: string | undefined) => void;\n\n    const output = new Promise<unknown>((resolve, reject) => {\n      resolveOutput = resolve;\n      rejectOutput = reject;\n    });\n    // Attach a default no-op catch so if no consumer awaits\n    // `output` the eventual rejection on `tool-error` / `failAll`\n    // doesn't surface as an unhandled Promise rejection.\n    output.catch(() => undefined);\n    const status = new Promise<ToolCallStatus>((resolve) => {\n      resolveStatus = resolve;\n    });\n    const error = new Promise<string | undefined>((resolve) => {\n      resolveError = resolve;\n    });\n\n    const entry: ActiveToolCall = {\n      name: data.tool_name,\n      callId: data.tool_call_id,\n      namespace: [...event.params.namespace],\n      input: data.input,\n      resolveOutput,\n      rejectOutput,\n      resolveStatus,\n      resolveError,\n    };\n    this.active.set(data.tool_call_id, entry);\n\n    return {\n      name: entry.name,\n      callId: entry.callId,\n      namespace: entry.namespace,\n      input: entry.input,\n      output,\n      status,\n      error,\n    };\n  }\n\n  private handleFinished(data: ToolFinishedData): void {\n    const entry = this.active.get(data.tool_call_id);\n    if (!entry) return;\n    this.active.delete(data.tool_call_id);\n    entry.resolveOutput(data.output);\n    entry.resolveStatus(\"finished\");\n    entry.resolveError(undefined);\n  }\n\n  private handleError(data: ToolErrorData): void {\n    const entry = this.active.get(data.tool_call_id);\n    if (!entry) return;\n    this.active.delete(data.tool_call_id);\n    entry.rejectOutput(new Error(data.message));\n    entry.resolveStatus(\"error\");\n    entry.resolveError(data.message);\n  }\n}\n"],"mappings":";;;;;;;;;AAgDA,IAAa,oBAAb,MAA+B;CAC7B,yBAA0B,IAAI,KAA6B;CAE3D,QAAQ,OAAkD;EACxD,MAAM,OAAO,MAAM,OAAO;AAE1B,MAAI,KAAK,UAAU,eACjB,QAAO,KAAK,cAAc,OAAO,KAAK;AAGxC,MAAI,KAAK,UAAU,iBAAiB;AAClC,QAAK,eAAe,KAAK;AACzB;;AAGF,MAAI,KAAK,UAAU,cAAc;AAC/B,QAAK,YAAY,KAAK;AACtB;;;;;;CAUJ,QAAQ,QAAqB;AAC3B,OAAK,MAAM,MAAM,KAAK,OAAO,QAAQ,EAAE;AACrC,MAAG,aAAa,OAAO;AACvB,MAAG,cAAc,QAAQ;AACzB,MAAG,aAAa,OAAO,QAAQ;;AAEjC,OAAK,OAAO,OAAO;;CAGrB,cACE,OACA,MACmB;EACnB,IAAI;EACJ,IAAI;EACJ,IAAI;EACJ,IAAI;EAEJ,MAAM,SAAS,IAAI,SAAkB,SAAS,WAAW;AACvD,mBAAgB;AAChB,kBAAe;IACf;AAIF,SAAO,YAAY,KAAA,EAAU;EAC7B,MAAM,SAAS,IAAI,SAAyB,YAAY;AACtD,mBAAgB;IAChB;EACF,MAAM,QAAQ,IAAI,SAA6B,YAAY;AACzD,kBAAe;IACf;EAEF,MAAM,QAAwB;GAC5B,MAAM,KAAK;GACX,QAAQ,KAAK;GACb,WAAW,CAAC,GAAG,MAAM,OAAO,UAAU;GACtC,OAAO,KAAK;GACZ;GACA;GACA;GACA;GACD;AACD,OAAK,OAAO,IAAI,KAAK,cAAc,MAAM;AAEzC,SAAO;GACL,MAAM,MAAM;GACZ,QAAQ,MAAM;GACd,WAAW,MAAM;GACjB,OAAO,MAAM;GACb;GACA;GACA;GACD;;CAGH,eAAuB,MAA8B;EACnD,MAAM,QAAQ,KAAK,OAAO,IAAI,KAAK,aAAa;AAChD,MAAI,CAAC,MAAO;AACZ,OAAK,OAAO,OAAO,KAAK,aAAa;AACrC,QAAM,cAAc,KAAK,OAAO;AAChC,QAAM,cAAc,WAAW;AAC/B,QAAM,aAAa,KAAA,EAAU;;CAG/B,YAAoB,MAA2B;EAC7C,MAAM,QAAQ,KAAK,OAAO,IAAI,KAAK,aAAa;AAChD,MAAI,CAAC,MAAO;AACZ,OAAK,OAAO,OAAO,KAAK,aAAa;AACrC,QAAM,aAAa,IAAI,MAAM,KAAK,QAAQ,CAAC;AAC3C,QAAM,cAAc,QAAQ;AAC5B,QAAM,aAAa,KAAK,QAAQ"}
+{"version":3,"file":"tools.cjs","names":[],"sources":["../../../../src/client/stream/handles/tools.ts"],"sourcesContent":["import type {\n  ToolsEvent,\n  ToolStartedData,\n  ToolFinishedData,\n  ToolErrorData,\n} from \"@langchain/protocol\";\n\n/**\n * High-level outcome of a single tool call.\n */\nexport type ToolCallStatus = \"running\" | \"finished\" | \"error\";\n\n/** Shared metadata for assembled tool-call handles. */\ninterface ToolCallBase<TName extends string = string, TInput = unknown> {\n  readonly name: TName;\n  readonly callId: string;\n  /**\n   * Pre-v1 alias for {@link callId}. Matches `ToolCallWithResult.id` and\n   * `ToolCall.id` on message-level tool calls.\n   */\n  readonly id: string;\n  readonly namespace: string[];\n  readonly input: TInput;\n  /**\n   * Pre-v1 alias for {@link input}. Matches `ToolCallFromTool` `args`.\n   */\n  readonly args: TInput;\n}\n\n/**\n * Script-oriented tool handle from the client SDK (`ThreadStream.toolCalls`,\n * subagent/subgraph projections). Completion and errors are surfaced only\n * through {@link output}.\n */\nexport interface ClientAssembledToolCall<\n  TName extends string = string,\n  TInput = unknown,\n  TOutput = unknown,\n> extends ToolCallBase<TName, TInput> {\n  readonly output: Promise<TOutput>;\n}\n\n/**\n * Reactive tool handle for framework bindings (`stream.toolCalls`,\n * `useToolCalls`, `injectToolCalls`).\n *\n * {@link status}, {@link error}, and {@link output} are plain values that\n * the assembler updates in place as tool events arrive. That lets React,\n * Vue, Svelte, and Angular re-render from a snapshot on each store tick\n * without `await`, effects, or Suspense boundaries around a promise.\n * {@link ClientAssembledToolCall} keeps a promise-based {@link output}\n * instead for script consumers that read tool results sequentially.\n *\n * {@link output} is `null` while the call is running or after it fails;\n * successful completion sets it to the parsed tool return value (objects\n * and strings are unwrapped from ToolMessage wire envelopes when needed).\n */\nexport interface AssembledToolCall<\n  TName extends string = string,\n  TInput = unknown,\n  TOutput = unknown,\n> extends ToolCallBase<TName, TInput> {\n  readonly output: TOutput | null;\n  readonly status: ToolCallStatus;\n  readonly error: string | undefined;\n}\n\n/** @internal Mutable runtime handle shared by client and framework views. */\ntype MutableToolCallHandle = {\n  name: string;\n  callId: string;\n  id: string;\n  namespace: string[];\n  input: unknown;\n  args: unknown;\n  output: unknown | null;\n  status: ToolCallStatus;\n  error: string | undefined;\n  outputPromise: Promise<unknown>;\n};\n\n/**\n * Project a runtime handle to the client SDK surface (promise-only\n * {@link output}, no {@link status} / {@link error} fields).\n */\nexport function toClientAssembledToolCall(\n  handle: MutableToolCallHandle\n): ClientAssembledToolCall {\n  return {\n    name: handle.name,\n    callId: handle.callId,\n    id: handle.id,\n    namespace: handle.namespace,\n    input: handle.input,\n    args: handle.args,\n    output: handle.outputPromise as Promise<unknown>,\n  };\n}\n\n/**\n * Parse wire-format tool payloads into structured values.\n *\n * Tool events may carry JSON-encoded object strings on the wire; this\n * helper normalises them to plain objects for consumers. Non-JSON strings\n * are returned unchanged.\n */\nexport function parseToolPayload(value: unknown): unknown {\n  if (typeof value !== \"string\") return value;\n  const trimmed = value.trim();\n  if (!trimmed.startsWith(\"{\") && !trimmed.startsWith(\"[\")) {\n    return value;\n  }\n\n  try {\n    return JSON.parse(trimmed) as unknown;\n  } catch {\n    return value;\n  }\n}\n\nfunction isToolMessageLike(\n  value: unknown\n): value is Record<string, unknown> & { content: unknown } {\n  if (!value || typeof value !== \"object\") return false;\n  const record = value as Record<string, unknown>;\n  if (record.type === \"tool\") return true;\n  return typeof record.tool_call_id === \"string\" && \"content\" in record;\n}\n\nfunction textFromContentBlocks(content: unknown[]): string {\n  let out = \"\";\n  for (const block of content) {\n    if (!block || typeof block !== \"object\") continue;\n    const record = block as Record<string, unknown>;\n    if (record.type === \"text\" && typeof record.text === \"string\") {\n      out += record.text;\n    }\n  }\n  return out;\n}\n\n/**\n * Normalise tool-result `content` from a wire ToolMessage into the value\n * a tool implementation returned (object, string, etc.).\n */\nfunction parseToolResultContent(content: unknown): unknown | null {\n  if (content == null) return null;\n\n  if (typeof content === \"string\") {\n    const trimmed = content.trim();\n    if (trimmed.length === 0) return null;\n    return parseToolPayload(content);\n  }\n\n  if (Array.isArray(content)) {\n    const text = textFromContentBlocks(content);\n    if (text.length === 0) return null;\n    return parseToolPayload(text);\n  }\n\n  if (typeof content === \"object\") {\n    return content;\n  }\n\n  return null;\n}\n\n/**\n * Parse a `tool-finished` output payload into the tool's return value.\n *\n * Wire events often wrap structured tool results in a ToolMessage-shaped\n * object (`{ type: \"tool\", content: \"...\" }`). This unwraps that envelope,\n * JSON-decodes string content when possible, and leaves plain strings as-is.\n * Returns `null` when a ToolMessage envelope is present but its content\n * cannot be normalised.\n */\nexport function parseToolOutput(value: unknown): unknown | null {\n  const parsed = parseToolPayload(value);\n  if (isToolMessageLike(parsed)) {\n    return parseToolResultContent(parsed.content);\n  }\n  return parsed ?? null;\n}\n\ntype ActiveToolCall = {\n  handle: MutableToolCallHandle;\n  resolveOutput: (value: unknown) => void;\n  rejectOutput: (err: Error) => void;\n};\n\n/**\n * Incrementally assembles `tools` events into mutable tool-call handles.\n *\n * Framework consumers store the handle directly; client SDK consumers\n * should map with {@link toClientAssembledToolCall} before yielding.\n */\nexport class ToolCallAssembler {\n  private readonly active = new Map<string, ActiveToolCall>();\n\n  consume(event: ToolsEvent): MutableToolCallHandle | undefined {\n    const data = event.params.data;\n\n    if (data.event === \"tool-started\") {\n      return this.handleStarted(event, data);\n    }\n\n    if (data.event === \"tool-finished\") {\n      return this.handleFinished(data);\n    }\n\n    if (data.event === \"tool-error\") {\n      return this.handleError(data);\n    }\n\n    // tool-output-delta: no action needed at assembly level\n    return undefined;\n  }\n\n  /**\n   * Reject any in-flight tool calls (e.g. on session close).\n   */\n  failAll(reason: Error): void {\n    for (const entry of this.active.values()) {\n      entry.rejectOutput(reason);\n      entry.handle.status = \"error\";\n      entry.handle.error = reason.message;\n    }\n    this.active.clear();\n  }\n\n  private handleStarted(\n    event: ToolsEvent,\n    data: ToolStartedData\n  ): MutableToolCallHandle {\n    let resolveOutput!: (value: unknown) => void;\n    let rejectOutput!: (err: Error) => void;\n\n    const outputPromise = new Promise<unknown>((resolve, reject) => {\n      resolveOutput = resolve;\n      rejectOutput = reject;\n    });\n    // Attach a default no-op catch so if no consumer awaits\n    // `output` the eventual rejection on `tool-error` / `failAll`\n    // doesn't surface as an unhandled Promise rejection.\n    outputPromise.catch(() => undefined);\n\n    const input = parseToolPayload(data.input);\n    const name = data.tool_name;\n    const callId = data.tool_call_id;\n    const namespace = [...event.params.namespace];\n\n    const handle: MutableToolCallHandle = {\n      name,\n      callId,\n      id: callId,\n      namespace,\n      input,\n      args: input,\n      output: null,\n      status: \"running\",\n      error: undefined,\n      outputPromise,\n    };\n\n    this.active.set(callId, {\n      handle,\n      resolveOutput,\n      rejectOutput,\n    });\n\n    return handle;\n  }\n\n  private handleFinished(\n    data: ToolFinishedData\n  ): MutableToolCallHandle | undefined {\n    const entry = this.active.get(data.tool_call_id);\n    if (!entry) return undefined;\n    this.active.delete(data.tool_call_id);\n    const value = parseToolOutput(data.output);\n    entry.resolveOutput(value);\n    entry.handle.output = value;\n    entry.handle.status = \"finished\";\n    entry.handle.error = undefined;\n    return entry.handle;\n  }\n\n  private handleError(data: ToolErrorData): MutableToolCallHandle | undefined {\n    const entry = this.active.get(data.tool_call_id);\n    if (!entry) return undefined;\n    this.active.delete(data.tool_call_id);\n    entry.rejectOutput(new Error(data.message));\n    entry.handle.output = null;\n    entry.handle.status = \"error\";\n    entry.handle.error = data.message;\n    return entry.handle;\n  }\n}\n"],"mappings":"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"}