@anvia/core 1.0.3 → 1.0.7

package/dist/pipeline/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/pipeline/errors.ts","../../src/pipeline/pipeline.ts","../../src/pipeline/graph.ts","../../src/pipeline/runtime.ts"],"sourcesContent":["import type { AgentInteractionOutcome } from \"../agent/run-types\";\n\nexport class PipelineAgentSuspensionError extends Error {\n  constructor(readonly result: AgentInteractionOutcome) {\n    super(\"Pipeline agent stage suspended for human interaction.\");\n    this.name = \"PipelineAgentSuspensionError\";\n  }\n}\n","import { z } from \"zod\";\nimport type { Agent } from \"../agent/agent\";\nimport { AgentRunBlockedError } from \"../agent/errors\";\nimport type { AgentInput, AgentRunOptions, AgentRunSettings } from \"../agent/run-types\";\nimport type { CompletionModel, JsonObject } from \"../completion\";\nimport { type ExtractOptions, extract as extractData } from \"../extractor\";\nimport { throwIfAborted } from \"../internal/abort\";\nimport { mapWithConcurrency } from \"../internal/concurrency\";\nimport { PipelineAgentSuspensionError } from \"./errors\";\nimport {\n  appendComposedGraph,\n  appendParallelBranch,\n  appendStageNode,\n  cloneGraph,\n  initialPipelineState,\n  withOutputNode,\n  withTerminalPaths,\n} from \"./graph\";\nimport {\n  childContext,\n  combineAbortSignals,\n  pipelineAbortError,\n  runNode,\n  stageContext,\n} from \"./runtime\";\nimport type {\n  ParallelOutput,\n  PipelineBatchItem,\n  PipelineBatchOptions,\n  PipelineExecutor,\n  PipelineGraph,\n  PipelineGraphNode,\n  PipelineNodePath,\n  PipelineOptions,\n  PipelineRunContext,\n  PipelineRunOptions,\n  PipelineRunResult,\n  PipelineStageContext,\n  PipelineStageMetadata,\n  PipelineState,\n} from \"./types\";\n\nconst internalPipelineOptions = Symbol(\"internal-pipeline-options\");\n\ntype RawResponseOf<Model> =\n  Model extends CompletionModel<infer RawResponse> ? RawResponse : unknown;\n\ntype PipelineAgentRequest<Output, Model extends CompletionModel> = AgentInput &\n  Omit<AgentRunSettings<Output, RawResponseOf<Model>>, \"abortSignal\">;\n\nexport type PipelineStepOptions<Input, Output> = PipelineStageMetadata & {\n  run(context: PipelineStageContext<Input>): Output | Promise<Output>;\n};\n\nexport type PipelineComposeOptions<Input, Output> = PipelineStageMetadata & {\n  pipeline: Pipeline<Input, Output>;\n};\n\nexport type PipelineParallelOptions<\n  Input,\n  Branches extends Record<string, Pipeline<Input, unknown>>,\n> = PipelineStageMetadata & {\n  branches: Branches;\n};\n\nexport type PipelineAgentOptions<\n  Input,\n  AgentOutput,\n  Model extends CompletionModel,\n> = PipelineStageMetadata & {\n  agent: Agent<AgentOutput, Model>;\n  request(\n    context: PipelineStageContext<Input>,\n  ): PipelineAgentRequest<AgentOutput, Model> | Promise<PipelineAgentRequest<AgentOutput, Model>>;\n  suspension: \"reject\";\n};\n\nexport type PipelineExtractOptions<\n  Input,\n  Extracted,\n  Model extends CompletionModel,\n> = PipelineStageMetadata &\n  Omit<ExtractOptions<Extracted, Model>, \"text\" | \"abortSignal\"> & {\n    text(context: PipelineStageContext<Input>): string | Promise<string>;\n  };\n\ntype InternalPipelineOptions<Input, Output> = {\n  [internalPipelineOptions]: {\n    executor: PipelineExecutor<Input, Output>;\n    state: PipelineState;\n  };\n};\n\n/** Immutable, typed Pipeline with explicit stage and execution boundaries. */\nexport class Pipeline<Input, Output = Input> {\n  readonly id: string;\n  readonly name: string | undefined;\n  readonly description: string | undefined;\n  readonly metadata: JsonObject | undefined;\n\n  private readonly executor: PipelineExecutor<Input, Output>;\n  private readonly state: PipelineState;\n\n  constructor(options: PipelineOptions<Input, Output>);\n  constructor(options: PipelineOptions<Input, Output> | InternalPipelineOptions<Input, Output>) {\n    if (isInternalPipelineOptions(options)) {\n      this.executor = options[internalPipelineOptions].executor;\n      this.state = options[internalPipelineOptions].state;\n    } else {\n      const id = normalizePipelineId(options.id);\n      if (!isZodSchema(options.inputSchema)) {\n        throw new TypeError(\"Pipeline inputSchema must be a Zod schema.\");\n      }\n      const inputSchema = options.inputSchema;\n      this.executor = (async (input, context) => {\n        throwIfAborted(context.abortSignal);\n        return inputSchema.parseAsync(input) as Promise<Output>;\n      }) as PipelineExecutor<Input, Output>;\n      this.state = initialPipelineState({\n        id,\n        name: options.name,\n        description: options.description,\n        metadata: options.metadata,\n      });\n    }\n\n    const graph = this.state.graph;\n    this.id = graph.id;\n    this.name = graph.name;\n    this.description = graph.description;\n    this.metadata = graph.metadata;\n  }\n\n  step<Next>(options: PipelineStepOptions<Awaited<Output>, Next>): Pipeline<Input, Awaited<Next>> {\n    const next = appendStageNode(this.state, \"step\", options);\n    const executor = (async (input, context, pathPrefix) => {\n      const value = await this.execute(input, context, pathPrefix);\n      const path = [...pathPrefix, next.node.id];\n      return (await runNode(context, next.node, path, () =>\n        options.run(stageContext(value, context)),\n      )) as Awaited<Next>;\n    }) as PipelineExecutor<Input, Awaited<Next>>;\n    return this.derive(executor, next.state);\n  }\n\n  compose<Next>(\n    options: PipelineComposeOptions<Awaited<Output>, Next>,\n  ): Pipeline<Input, Awaited<Next>> {\n    const boundary = appendStageNode(this.state, \"pipeline\", options, {\n      defaultLabel: options.pipeline.name ?? options.pipeline.id,\n      pipelineId: options.pipeline.id,\n    });\n    const state = appendComposedGraph(boundary.state, boundary.node, options.pipeline.graph());\n    const executor = (async (input, context, pathPrefix) => {\n      const value = await this.execute(input, context, pathPrefix);\n      const path = [...pathPrefix, boundary.node.id];\n      return (await runNode(context, boundary.node, path, () =>\n        options.pipeline.execute(value, context, path),\n      )) as Awaited<Next>;\n    }) as PipelineExecutor<Input, Awaited<Next>>;\n    return this.derive(executor, state);\n  }\n\n  parallel<Branches extends Record<string, Pipeline<Awaited<Output>, unknown>>>(\n    options: PipelineParallelOptions<Awaited<Output>, Branches>,\n  ): Pipeline<Input, ParallelOutput<Branches>> {\n    const branchEntries = normalizeParallelBranches(options.branches);\n    if (branchEntries.length === 0) {\n      throw new TypeError(\"Pipeline parallel branches must not be empty.\");\n    }\n    const parallel = appendStageNode(this.state, \"parallel\", options, {\n      defaultLabel: `${branchEntries.length} parallel branches`,\n    });\n    let nextState = parallel.state;\n    const branchNodes = new Map<string, PipelineGraphNode>();\n    const terminalPaths: PipelineNodePath[] = [];\n    for (const [key, branch] of branchEntries) {\n      const appended = appendParallelBranch(nextState, parallel.node, key, branch.graph());\n      nextState = appended.state;\n      branchNodes.set(key, appended.node);\n      terminalPaths.push(...appended.terminalPaths);\n    }\n    nextState = withTerminalPaths(nextState, terminalPaths);\n\n    return this.derive<ParallelOutput<Branches>>(async (input, context, pathPrefix) => {\n      const value = await this.execute(input, context, pathPrefix);\n      const parallelPath = [...pathPrefix, parallel.node.id];\n      return runNode(context, parallel.node, parallelPath, async () => {\n        const controller = new AbortController();\n        const combined = combineAbortSignals(context.abortSignal, controller.signal);\n        const branchContext = childContext(context, combined.signal);\n        let firstError: unknown;\n        const promises = branchEntries.map(async ([key, branch]) => {\n          const node = branchNodes.get(key) as PipelineGraphNode;\n          const path = [...parallelPath, node.id];\n          try {\n            const output = await runNode(branchContext, node, path, () =>\n              branch.execute(value, branchContext, path),\n            );\n            return [key, output] as const;\n          } catch (error) {\n            if (firstError === undefined) firstError = error;\n            if (!controller.signal.aborted) controller.abort(error);\n            throw error;\n          }\n        });\n\n        const settled = await Promise.allSettled(promises);\n        combined.dispose();\n        if (context.abortSignal?.aborted === true) {\n          throw pipelineAbortError(context.abortSignal);\n        }\n        if (firstError !== undefined) throw firstError;\n        return Object.fromEntries(\n          settled.map(\n            (result) => (result as PromiseFulfilledResult<readonly [string, unknown]>).value,\n          ),\n        ) as ParallelOutput<Branches>;\n      });\n    }, nextState);\n  }\n\n  agent<AgentOutput, Model extends CompletionModel>(\n    options: PipelineAgentOptions<Awaited<Output>, AgentOutput, Model>,\n  ): Pipeline<Input, AgentOutput> {\n    if (options.suspension !== \"reject\") {\n      throw new TypeError('Pipeline Agent stages require suspension: \"reject\".');\n    }\n    const next = appendStageNode(this.state, \"agent\", options, {\n      defaultLabel: options.agent.name ?? options.agent.id,\n      agentId: options.agent.id,\n      agentName: options.agent.name,\n    });\n    return this.derive<AgentOutput>(async (input, context, pathPrefix) => {\n      const value = await this.execute(input, context, pathPrefix);\n      const path = [...pathPrefix, next.node.id];\n      return runNode(context, next.node, path, async () => {\n        const request = await options.request(stageContext(value, context));\n        const response = await options.agent.generate({\n          ...request,\n          abortSignal: context.abortSignal,\n        } as AgentRunOptions<AgentOutput, RawResponseOf<Model>>);\n        if (response.type === \"interaction\") {\n          throw new PipelineAgentSuspensionError(response);\n        }\n        if (response.type === \"blocked\") {\n          throw new AgentRunBlockedError(response);\n        }\n        return response.output;\n      });\n    }, next.state);\n  }\n\n  extract<Extracted, Model extends CompletionModel>(\n    options: PipelineExtractOptions<Awaited<Output>, Extracted, Model>,\n  ): Pipeline<Input, Extracted> {\n    const next = appendStageNode(this.state, \"extractor\", options);\n    return this.derive<Extracted>(async (input, context, pathPrefix) => {\n      const value = await this.execute(input, context, pathPrefix);\n      const path = [...pathPrefix, next.node.id];\n      return runNode(context, next.node, path, async () => {\n        const text = await options.text(stageContext(value, context));\n        const result = await extractData({\n          model: options.model,\n          text,\n          outputSchema: options.outputSchema,\n          instructions: options.instructions,\n          retries: options.retries,\n          temperature: options.temperature,\n          maxTokens: options.maxTokens,\n          providerOptions: options.providerOptions,\n          abortSignal: context.abortSignal,\n        });\n        return result.output;\n      });\n    }, next.state);\n  }\n\n  async run(options: PipelineRunOptions<Input>): Promise<PipelineRunResult<Output>> {\n    const runId = normalizeRunId(options.runId ?? globalThis.crypto.randomUUID());\n    const context: PipelineRunContext = {\n      runId,\n      pipelineId: this.id,\n      runMetadata: options.metadata,\n      abortSignal: options.abortSignal,\n      observer: options.observer,\n      failOnObserverError: options.failOnObserverError === true,\n    };\n    throwIfAborted(context.abortSignal);\n    const output = await this.execute(options.input, context, []);\n    throwIfAborted(context.abortSignal);\n    return { runId, output };\n  }\n\n  async runBatch(options: PipelineBatchOptions<Input>): Promise<Array<PipelineBatchItem<Output>>> {\n    throwIfAborted(options.abortSignal);\n    return mapWithConcurrency([...options.inputs], options.concurrency, async (input) => {\n      const runId = globalThis.crypto.randomUUID();\n      try {\n        const result = await this.run({\n          input,\n          runId,\n          metadata: options.metadata,\n          abortSignal: options.abortSignal,\n          observer: options.observer,\n          failOnObserverError: options.failOnObserverError,\n        });\n        return { status: \"completed\", ...result } as const;\n      } catch (error) {\n        if (options.abortSignal?.aborted === true) {\n          throw pipelineAbortError(options.abortSignal);\n        }\n        return { status: \"failed\", runId, error } as const;\n      }\n    });\n  }\n\n  graph(): PipelineGraph {\n    return cloneGraph(withOutputNode(this.state));\n  }\n\n  private derive<DerivedOutput>(\n    executor: PipelineExecutor<Input, DerivedOutput>,\n    state: PipelineState,\n  ): Pipeline<Input, DerivedOutput> {\n    return createDerivedPipeline(executor, state);\n  }\n\n  private async execute(\n    input: Input,\n    context: PipelineRunContext,\n    pathPrefix: PipelineNodePath,\n  ): Promise<Awaited<Output>> {\n    throwIfAborted(context.abortSignal);\n    return (await this.executor(input, context, pathPrefix)) as Awaited<Output>;\n  }\n}\n\nfunction createDerivedPipeline<Input, Output>(\n  executor: PipelineExecutor<Input, Output>,\n  state: PipelineState,\n): Pipeline<Input, Output> {\n  const options: InternalPipelineOptions<Input, Output> = {\n    [internalPipelineOptions]: { executor, state },\n  };\n  return new Pipeline<Input, Output>(options as unknown as PipelineOptions<Input, Output>);\n}\n\nfunction isInternalPipelineOptions<Input, Output>(\n  options: PipelineOptions<Input, Output> | InternalPipelineOptions<Input, Output>,\n): options is InternalPipelineOptions<Input, Output> {\n  return internalPipelineOptions in options;\n}\n\nfunction isZodSchema(value: unknown): value is z.ZodType {\n  return value instanceof z.ZodType;\n}\n\nfunction normalizePipelineId(id: string): string {\n  if (typeof id !== \"string\") {\n    throw new TypeError(\"Pipeline id must be a string.\");\n  }\n  const normalized = id.trim();\n  if (normalized.length === 0) {\n    throw new TypeError(\"Pipeline id must be a non-empty string.\");\n  }\n  return normalized;\n}\n\nfunction normalizeRunId(runId: string): string {\n  if (typeof runId !== \"string\") {\n    throw new TypeError(\"Pipeline runId must be a string.\");\n  }\n  const normalized = runId.trim();\n  if (normalized.length === 0) {\n    throw new TypeError(\"Pipeline runId must be a non-empty string.\");\n  }\n  return normalized;\n}\n\nfunction normalizeParallelBranches<Branch>(\n  branches: Readonly<Record<string, Branch>>,\n): Array<readonly [string, Branch]> {\n  const entries: Array<readonly [string, Branch]> = [];\n  const ids = new Set<string>();\n  for (const key of Object.keys(branches)) {\n    const pipeline = branches[key] as Branch;\n    const id = key.trim();\n    if (id.length === 0) {\n      throw new TypeError(\"Pipeline parallel branch id must be a non-empty string.\");\n    }\n    if (ids.has(id)) {\n      throw new TypeError(`Pipeline parallel branch id \"${id}\" is already registered.`);\n    }\n    ids.add(id);\n    if (id !== key) {\n      throw new TypeError(\"Pipeline parallel branch ids must not contain surrounding whitespace.\");\n    }\n    entries.push([id, pipeline]);\n  }\n  return entries;\n}\n","import type { JsonObject } from \"../completion\";\nimport type {\n  PipelineGraph,\n  PipelineGraphEdge,\n  PipelineGraphNode,\n  PipelineNodePath,\n  PipelineStageKind,\n  PipelineStageMetadata,\n  PipelineState,\n} from \"./types\";\n\nconst INPUT_ID = \"$input\";\nconst OUTPUT_ID = \"$output\";\nconst RESERVED_STAGE_IDS = new Set([INPUT_ID, OUTPUT_ID]);\n\nexport function initialPipelineState(options: {\n  id: string;\n  name?: string | undefined;\n  description?: string | undefined;\n  metadata?: JsonObject | undefined;\n}): PipelineState {\n  const input = graphNode(INPUT_ID, [INPUT_ID], \"input\", \"Input\");\n  const graph: PipelineGraph = {\n    id: options.id,\n    nodes: [input],\n    edges: [],\n  };\n  if (options.name !== undefined) graph.name = options.name;\n  if (options.description !== undefined) graph.description = options.description;\n  if (options.metadata !== undefined) graph.metadata = options.metadata;\n  return {\n    graph,\n    terminalPaths: [input.path],\n    stageIds: new Set(),\n    nextEdgeIndex: 1,\n  };\n}\n\nexport function appendStageNode(\n  state: PipelineState,\n  kind: PipelineStageKind,\n  stage: PipelineStageMetadata,\n  options: {\n    defaultLabel?: string | undefined;\n    agentId?: string | undefined;\n    agentName?: string | undefined;\n    pipelineId?: string | undefined;\n  } = {},\n): { state: PipelineState; node: PipelineGraphNode } {\n  const id = validateStageId(stage.id);\n  if (state.stageIds.has(id)) {\n    throw new TypeError(`Pipeline stage id \"${id}\" is already registered.`);\n  }\n  const node = graphNode(id, [id], kind, stage.name ?? options.defaultLabel ?? id, {\n    description: stage.description,\n    metadata: stage.metadata,\n    agentId: options.agentId,\n    agentName: options.agentName,\n    pipelineId: options.pipelineId,\n  });\n  return {\n    node,\n    state: appendNode(state, node, state.terminalPaths, [node.path], id),\n  };\n}\n\nexport function appendComposedGraph(\n  state: PipelineState,\n  boundary: PipelineGraphNode,\n  child: PipelineGraph,\n): PipelineState {\n  return appendChildGraph(state, boundary.path, child);\n}\n\nexport function appendParallelBranch(\n  state: PipelineState,\n  parallel: PipelineGraphNode,\n  branchKey: string,\n  child: PipelineGraph,\n): { state: PipelineState; node: PipelineGraphNode; terminalPaths: PipelineNodePath[] } {\n  const id = validateStageId(branchKey);\n  const path = [...parallel.path, id];\n  const node = graphNode(id, path, \"branch\", id, { branchKey: id, pipelineId: child.id });\n  const withBranch = appendNode(state, node, [parallel.path], state.terminalPaths);\n  const withChild = appendChildGraph(withBranch, node.path, child);\n  return { state: withChild, node, terminalPaths: withChild.terminalPaths };\n}\n\nexport function withTerminalPaths(\n  state: PipelineState,\n  terminalPaths: PipelineNodePath[],\n): PipelineState {\n  return { ...state, terminalPaths };\n}\n\nexport function withOutputNode(state: PipelineState): PipelineGraph {\n  const graph = cloneGraph(state.graph);\n  const outputPath = [OUTPUT_ID];\n  if (graph.nodes.some((node) => pathEquals(node.path, outputPath))) {\n    return graph;\n  }\n  graph.nodes.push(graphNode(OUTPUT_ID, outputPath, \"output\", \"Output\"));\n  graph.edges.push(\n    ...state.terminalPaths.map((source, index) => ({\n      id: `edge_${state.nextEdgeIndex + index}`,\n      source: [...source],\n      target: outputPath,\n    })),\n  );\n  return graph;\n}\n\nexport function cloneGraph(graph: PipelineGraph): PipelineGraph {\n  return {\n    ...graph,\n    nodes: graph.nodes.map((node) => ({ ...node, path: [...node.path] })),\n    edges: graph.edges.map((edge) => ({\n      ...edge,\n      source: [...edge.source],\n      target: [...edge.target],\n    })),\n  };\n}\n\nexport function scopedNode(node: PipelineGraphNode, path: PipelineNodePath): PipelineGraphNode {\n  return { ...node, path: [...path] };\n}\n\nfunction appendChildGraph(\n  state: PipelineState,\n  parentPath: PipelineNodePath,\n  child: PipelineGraph,\n): PipelineState {\n  const childNodes = child.nodes\n    .filter((node) => !isBoundaryPath(node.path))\n    .map((node) => scopedNode(node, [...parentPath, ...node.path]));\n  const childEdges: PipelineState[\"graph\"][\"edges\"] = [];\n  const terminalPaths: PipelineNodePath[] = [];\n  let nextEdgeIndex = state.nextEdgeIndex;\n\n  for (const edge of child.edges) {\n    const sourceIsInput = isInputPath(edge.source);\n    const targetIsOutput = isOutputPath(edge.target);\n    const source = sourceIsInput ? [...parentPath] : [...parentPath, ...edge.source];\n    if (targetIsOutput) {\n      terminalPaths.push(source);\n      continue;\n    }\n    const target = [...parentPath, ...edge.target];\n    let childEdge: PipelineGraphEdge = {\n      id: `edge_${nextEdgeIndex}`,\n      source,\n      target,\n    };\n    if (edge.label !== undefined) childEdge = { ...childEdge, label: edge.label };\n    childEdges.push(childEdge);\n    nextEdgeIndex += 1;\n  }\n\n  return {\n    ...state,\n    graph: {\n      ...state.graph,\n      nodes: [...state.graph.nodes, ...childNodes],\n      edges: [...state.graph.edges, ...childEdges],\n    },\n    terminalPaths: terminalPaths.length === 0 ? [[...parentPath]] : terminalPaths,\n    nextEdgeIndex,\n  };\n}\n\nfunction appendNode(\n  state: PipelineState,\n  node: PipelineGraphNode,\n  sourcePaths: PipelineNodePath[],\n  terminalPaths: PipelineNodePath[],\n  stageId?: string,\n): PipelineState {\n  const edges = sourcePaths.map((source, index) => ({\n    id: `edge_${state.nextEdgeIndex + index}`,\n    source: [...source],\n    target: [...node.path],\n  }));\n  const stageIds = new Set(state.stageIds);\n  if (stageId !== undefined) stageIds.add(stageId);\n  return {\n    graph: {\n      ...state.graph,\n      nodes: [...state.graph.nodes, node],\n      edges: [...state.graph.edges, ...edges],\n    },\n    terminalPaths,\n    stageIds,\n    nextEdgeIndex: state.nextEdgeIndex + edges.length,\n  };\n}\n\nfunction graphNode(\n  id: string,\n  path: PipelineNodePath,\n  kind: PipelineStageKind,\n  label: string,\n  options: {\n    description?: string | undefined;\n    metadata?: JsonObject | undefined;\n    agentId?: string | undefined;\n    agentName?: string | undefined;\n    pipelineId?: string | undefined;\n    branchKey?: string | undefined;\n  } = {},\n): PipelineGraphNode {\n  const node: PipelineGraphNode = { id, path: [...path], kind, label };\n  if (options.description !== undefined) node.description = options.description;\n  if (options.metadata !== undefined) node.metadata = options.metadata;\n  if (options.agentId !== undefined) node.agentId = options.agentId;\n  if (options.agentName !== undefined) node.agentName = options.agentName;\n  if (options.pipelineId !== undefined) node.pipelineId = options.pipelineId;\n  if (options.branchKey !== undefined) node.branchKey = options.branchKey;\n  return node;\n}\n\nfunction validateStageId(value: string): string {\n  if (typeof value !== \"string\") {\n    throw new TypeError(\"Pipeline stage id must be a string.\");\n  }\n  const id = value.trim();\n  if (id.length === 0) {\n    throw new TypeError(\"Pipeline stage id must be a non-empty string.\");\n  }\n  if (RESERVED_STAGE_IDS.has(id)) {\n    throw new TypeError(`Pipeline stage id \"${id}\" is reserved.`);\n  }\n  return id;\n}\n\nfunction isBoundaryPath(path: PipelineNodePath): boolean {\n  return isInputPath(path) || isOutputPath(path);\n}\n\nfunction isInputPath(path: PipelineNodePath): boolean {\n  return path.length === 1 && path[0] === INPUT_ID;\n}\n\nfunction isOutputPath(path: PipelineNodePath): boolean {\n  return path.length === 1 && path[0] === OUTPUT_ID;\n}\n\nfunction pathEquals(left: PipelineNodePath, right: PipelineNodePath): boolean {\n  return left.length === right.length && left.every((segment, index) => segment === right[index]);\n}\n","import { abortError, throwIfAborted } from \"../internal/abort\";\nimport { scopedNode } from \"./graph\";\nimport type {\n  PipelineGraphNode,\n  PipelineNodePath,\n  PipelineRunContext,\n  PipelineRunEvent,\n  PipelineStageContext,\n} from \"./types\";\n\nexport async function runNode<Output>(\n  context: PipelineRunContext,\n  node: PipelineGraphNode,\n  path: PipelineNodePath,\n  fn: () => Output | Promise<Output>,\n): Promise<Awaited<Output>> {\n  throwIfAborted(context.abortSignal);\n  const eventNode = scopedNode(node, path);\n  const startedAt = Date.now();\n  await emitEvent(context, {\n    type: \"stage_started\",\n    runId: context.runId,\n    pipelineId: context.pipelineId,\n    path: [...path],\n    node: eventNode,\n  });\n\n  try {\n    const output = (await fn()) as Awaited<Output>;\n    throwIfAborted(context.abortSignal);\n    await emitEvent(context, {\n      type: \"stage_completed\",\n      runId: context.runId,\n      pipelineId: context.pipelineId,\n      path: [...path],\n      node: eventNode,\n      durationMs: Date.now() - startedAt,\n    });\n    return output;\n  } catch (error) {\n    const failureEvent: PipelineRunEvent = {\n      type: \"stage_failed\",\n      runId: context.runId,\n      pipelineId: context.pipelineId,\n      path: [...path],\n      node: eventNode,\n      durationMs: Date.now() - startedAt,\n      error,\n    };\n    try {\n      await emitEvent(context, failureEvent);\n    } catch (observerError) {\n      throw new AggregateError(\n        [error, observerError],\n        `Pipeline stage \"${node.id}\" and its observer both failed.`,\n      );\n    }\n    throw error;\n  }\n}\n\nexport function stageContext<Input>(\n  input: Input,\n  context: PipelineRunContext,\n): PipelineStageContext<Input> {\n  return {\n    input,\n    runId: context.runId,\n    pipelineId: context.pipelineId,\n    runMetadata: context.runMetadata,\n    abortSignal: context.abortSignal,\n  };\n}\n\nexport function childContext(\n  context: PipelineRunContext,\n  abortSignal: AbortSignal | undefined,\n): PipelineRunContext {\n  return { ...context, abortSignal };\n}\n\nexport function combineAbortSignals(\n  parent: AbortSignal | undefined,\n  local: AbortSignal,\n): { signal: AbortSignal; dispose(): void } {\n  const controller = new AbortController();\n  const abortFromParent = () => controller.abort(parent?.reason);\n  const abortFromLocal = () => controller.abort(local.reason);\n\n  if (parent?.aborted === true) {\n    controller.abort(parent.reason);\n  } else if (local.aborted) {\n    controller.abort(local.reason);\n  } else {\n    parent?.addEventListener(\"abort\", abortFromParent, { once: true });\n    local.addEventListener(\"abort\", abortFromLocal, { once: true });\n  }\n\n  return {\n    signal: controller.signal,\n    dispose() {\n      parent?.removeEventListener(\"abort\", abortFromParent);\n      local.removeEventListener(\"abort\", abortFromLocal);\n    },\n  };\n}\n\nexport function pipelineAbortError(signal: AbortSignal | undefined): Error {\n  return abortError(signal?.reason);\n}\n\nasync function emitEvent(context: PipelineRunContext, event: PipelineRunEvent): Promise<void> {\n  if (context.observer === undefined) return;\n  try {\n    await context.observer.onEvent(event);\n  } catch (error) {\n    if (context.failOnObserverError) throw error;\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/pipeline/errors.ts","../../src/pipeline/pipeline.ts","../../src/pipeline/graph.ts","../../src/pipeline/observability.ts","../../src/pipeline/runtime.ts"],"sourcesContent":["import type { AgentInteractionOutcome } from \"../agent/run-types\";\n\nexport class PipelineAgentSuspensionError extends Error {\n  constructor(readonly result: AgentInteractionOutcome) {\n    super(\"Pipeline agent stage suspended for human interaction.\");\n    this.name = \"PipelineAgentSuspensionError\";\n  }\n}\n\nexport type PipelineObserverFailure = {\n  readonly observer: string;\n  readonly error: unknown;\n};\n\nexport class PipelineObserverDispatchError extends AggregateError {\n  readonly phase: string;\n  readonly failures: readonly PipelineObserverFailure[];\n\n  constructor(phase: string, failures: readonly PipelineObserverFailure[]) {\n    super(\n      failures.map((failure) => failure.error),\n      `Pipeline observer ${phase} failed for ${failures\n        .map((failure) => failure.observer)\n        .join(\", \")}.`,\n    );\n    this.name = \"PipelineObserverDispatchError\";\n    this.phase = phase;\n    this.failures = Object.freeze([...failures]);\n  }\n}\n","import { z } from \"zod\";\nimport type { Agent } from \"../agent/agent\";\nimport { AgentRunBlockedError } from \"../agent/errors\";\nimport type { AgentInput, AgentRunOptions, AgentRunSettings } from \"../agent/run-types\";\nimport type { CompletionModel, JsonObject } from \"../completion\";\nimport { type ExtractOptions, extract as extractData } from \"../extractor\";\nimport { throwIfAborted } from \"../internal/abort\";\nimport { mapWithConcurrency } from \"../internal/concurrency\";\nimport type { AgentTraceOptions } from \"../observability\";\nimport { PipelineAgentSuspensionError } from \"./errors\";\nimport {\n  appendComposedGraph,\n  appendParallelBranch,\n  appendStageNode,\n  cloneGraph,\n  initialPipelineState,\n  withOutputNode,\n  withTerminalPaths,\n} from \"./graph\";\nimport { snapshotPipelineObservability, startPipelineRunObservers } from \"./observability\";\nimport {\n  childContext,\n  combineAbortSignals,\n  pipelineAbortError,\n  runNode,\n  stageContext,\n} from \"./runtime\";\nimport type {\n  ParallelOutput,\n  PipelineBatchItem,\n  PipelineBatchOptions,\n  PipelineExecutor,\n  PipelineGraph,\n  PipelineGraphNode,\n  PipelineNodePath,\n  PipelineOptions,\n  PipelineRunContext,\n  PipelineRunOptions,\n  PipelineRunResult,\n  PipelineStageContext,\n  PipelineStageMetadata,\n  PipelineState,\n  PipelineTraceInfo,\n} from \"./types\";\n\nconst internalPipelineOptions = Symbol(\"internal-pipeline-options\");\n\ntype RawResponseOf<Model> =\n  Model extends CompletionModel<infer RawResponse> ? RawResponse : unknown;\n\ntype PipelineAgentRequest<Output, Model extends CompletionModel> = AgentInput &\n  Omit<AgentRunSettings<Output, RawResponseOf<Model>>, \"abortSignal\">;\n\nexport type PipelineStepOptions<Input, Output> = PipelineStageMetadata & {\n  run(context: PipelineStageContext<Input>): Output | Promise<Output>;\n};\n\nexport type PipelineComposeOptions<Input, Output> = PipelineStageMetadata & {\n  pipeline: Pipeline<Input, Output>;\n};\n\nexport type PipelineParallelOptions<\n  Input,\n  Branches extends Record<string, Pipeline<Input, unknown>>,\n> = PipelineStageMetadata & {\n  branches: Branches;\n};\n\nexport type PipelineAgentOptions<\n  Input,\n  AgentOutput,\n  Model extends CompletionModel,\n> = PipelineStageMetadata & {\n  agent: Agent<AgentOutput, Model>;\n  request(\n    context: PipelineStageContext<Input>,\n  ): PipelineAgentRequest<AgentOutput, Model> | Promise<PipelineAgentRequest<AgentOutput, Model>>;\n  suspension: \"reject\";\n};\n\nexport type PipelineExtractOptions<\n  Input,\n  Extracted,\n  Model extends CompletionModel,\n> = PipelineStageMetadata &\n  Omit<ExtractOptions<Extracted, Model>, \"text\" | \"abortSignal\"> & {\n    text(context: PipelineStageContext<Input>): string | Promise<string>;\n  };\n\ntype InternalPipelineOptions<Input, Output> = {\n  [internalPipelineOptions]: {\n    executor: PipelineExecutor<Input, Output>;\n    state: PipelineState;\n    observability: PipelineOptions<Input>[\"observability\"];\n  };\n};\n\n/** Immutable, typed Pipeline with explicit stage and execution boundaries. */\nexport class Pipeline<Input, Output = Input> {\n  readonly id: string;\n  readonly name: string | undefined;\n  readonly description: string | undefined;\n  readonly metadata: JsonObject | undefined;\n  readonly observability: PipelineOptions<Input>[\"observability\"];\n\n  private readonly executor: PipelineExecutor<Input, Output>;\n  private readonly state: PipelineState;\n\n  constructor(options: PipelineOptions<Input, Output>);\n  constructor(options: PipelineOptions<Input, Output> | InternalPipelineOptions<Input, Output>) {\n    if (isInternalPipelineOptions(options)) {\n      this.executor = options[internalPipelineOptions].executor;\n      this.state = options[internalPipelineOptions].state;\n      this.observability = options[internalPipelineOptions].observability;\n    } else {\n      const id = normalizePipelineId(options.id);\n      if (!isZodSchema(options.inputSchema)) {\n        throw new TypeError(\"Pipeline inputSchema must be a Zod schema.\");\n      }\n      const inputSchema = options.inputSchema;\n      this.executor = (async (input, context) => {\n        throwIfAborted(context.abortSignal);\n        return inputSchema.parseAsync(input) as Promise<Output>;\n      }) as PipelineExecutor<Input, Output>;\n      this.state = initialPipelineState({\n        id,\n        name: options.name,\n        description: options.description,\n        metadata: options.metadata,\n      });\n      this.observability = snapshotPipelineObservability(options.observability);\n    }\n\n    const graph = this.state.graph;\n    this.id = graph.id;\n    this.name = graph.name;\n    this.description = graph.description;\n    this.metadata = graph.metadata;\n  }\n\n  step<Next>(options: PipelineStepOptions<Awaited<Output>, Next>): Pipeline<Input, Awaited<Next>> {\n    const next = appendStageNode(this.state, \"step\", options);\n    const executor = (async (input, context, pathPrefix) => {\n      const value = await this.execute(input, context, pathPrefix);\n      const path = [...pathPrefix, next.node.id];\n      return (await runNode(context, next.node, path, value, () =>\n        options.run(stageContext(value, context)),\n      )) as Awaited<Next>;\n    }) as PipelineExecutor<Input, Awaited<Next>>;\n    return this.derive(executor, next.state);\n  }\n\n  compose<Next>(\n    options: PipelineComposeOptions<Awaited<Output>, Next>,\n  ): Pipeline<Input, Awaited<Next>> {\n    const boundary = appendStageNode(this.state, \"pipeline\", options, {\n      defaultLabel: options.pipeline.name ?? options.pipeline.id,\n      pipelineId: options.pipeline.id,\n    });\n    const state = appendComposedGraph(boundary.state, boundary.node, options.pipeline.graph());\n    const executor = (async (input, context, pathPrefix) => {\n      const value = await this.execute(input, context, pathPrefix);\n      const path = [...pathPrefix, boundary.node.id];\n      return (await runNode(context, boundary.node, path, value, () =>\n        options.pipeline.execute(value, context, path),\n      )) as Awaited<Next>;\n    }) as PipelineExecutor<Input, Awaited<Next>>;\n    return this.derive(executor, state);\n  }\n\n  parallel<Branches extends Record<string, Pipeline<Awaited<Output>, unknown>>>(\n    options: PipelineParallelOptions<Awaited<Output>, Branches>,\n  ): Pipeline<Input, ParallelOutput<Branches>> {\n    const branchEntries = normalizeParallelBranches(options.branches);\n    if (branchEntries.length === 0) {\n      throw new TypeError(\"Pipeline parallel branches must not be empty.\");\n    }\n    const parallel = appendStageNode(this.state, \"parallel\", options, {\n      defaultLabel: `${branchEntries.length} parallel branches`,\n    });\n    let nextState = parallel.state;\n    const branchNodes = new Map<string, PipelineGraphNode>();\n    const terminalPaths: PipelineNodePath[] = [];\n    for (const [key, branch] of branchEntries) {\n      const appended = appendParallelBranch(nextState, parallel.node, key, branch.graph());\n      nextState = appended.state;\n      branchNodes.set(key, appended.node);\n      terminalPaths.push(...appended.terminalPaths);\n    }\n    nextState = withTerminalPaths(nextState, terminalPaths);\n\n    return this.derive<ParallelOutput<Branches>>(async (input, context, pathPrefix) => {\n      const value = await this.execute(input, context, pathPrefix);\n      const parallelPath = [...pathPrefix, parallel.node.id];\n      return runNode(context, parallel.node, parallelPath, value, async () => {\n        const controller = new AbortController();\n        const combined = combineAbortSignals(context.abortSignal, controller.signal);\n        const branchContext = childContext(context, combined.signal);\n        let firstError: unknown;\n        const promises = branchEntries.map(async ([key, branch]) => {\n          const node = branchNodes.get(key) as PipelineGraphNode;\n          const path = [...parallelPath, node.id];\n          try {\n            const output = await runNode(branchContext, node, path, value, () =>\n              branch.execute(value, branchContext, path),\n            );\n            return [key, output] as const;\n          } catch (error) {\n            if (firstError === undefined) firstError = error;\n            if (!controller.signal.aborted) controller.abort(error);\n            throw error;\n          }\n        });\n\n        const settled = await Promise.allSettled(promises);\n        combined.dispose();\n        if (context.abortSignal?.aborted === true) {\n          throw pipelineAbortError(context.abortSignal);\n        }\n        if (firstError !== undefined) throw firstError;\n        return Object.fromEntries(\n          settled.map(\n            (result) => (result as PromiseFulfilledResult<readonly [string, unknown]>).value,\n          ),\n        ) as ParallelOutput<Branches>;\n      });\n    }, nextState);\n  }\n\n  agent<AgentOutput, Model extends CompletionModel>(\n    options: PipelineAgentOptions<Awaited<Output>, AgentOutput, Model>,\n  ): Pipeline<Input, AgentOutput> {\n    if (options.suspension !== \"reject\") {\n      throw new TypeError('Pipeline Agent stages require suspension: \"reject\".');\n    }\n    const next = appendStageNode(this.state, \"agent\", options, {\n      defaultLabel: options.agent.name ?? options.agent.id,\n      agentId: options.agent.id,\n      agentName: options.agent.name,\n    });\n    return this.derive<AgentOutput>(async (input, context, pathPrefix) => {\n      const value = await this.execute(input, context, pathPrefix);\n      const path = [...pathPrefix, next.node.id];\n      return runNode(context, next.node, path, value, async (stageTrace) => {\n        const request = await options.request(stageContext(value, context));\n        const response = await options.agent.generate({\n          ...request,\n          trace: withPipelineParentTrace(\n            request.trace,\n            stageTrace,\n            options.agent.observability?.primaryTrace,\n          ),\n          abortSignal: context.abortSignal,\n        } as AgentRunOptions<AgentOutput, RawResponseOf<Model>>);\n        if (response.type === \"interaction\") {\n          throw new PipelineAgentSuspensionError(response);\n        }\n        if (response.type === \"blocked\") {\n          throw new AgentRunBlockedError(response);\n        }\n        return response.output;\n      });\n    }, next.state);\n  }\n\n  extract<Extracted, Model extends CompletionModel>(\n    options: PipelineExtractOptions<Awaited<Output>, Extracted, Model>,\n  ): Pipeline<Input, Extracted> {\n    const next = appendStageNode(this.state, \"extractor\", options);\n    return this.derive<Extracted>(async (input, context, pathPrefix) => {\n      const value = await this.execute(input, context, pathPrefix);\n      const path = [...pathPrefix, next.node.id];\n      return runNode(context, next.node, path, value, async () => {\n        const text = await options.text(stageContext(value, context));\n        const result = await extractData({\n          model: options.model,\n          text,\n          outputSchema: options.outputSchema,\n          instructions: options.instructions,\n          retries: options.retries,\n          temperature: options.temperature,\n          maxTokens: options.maxTokens,\n          providerOptions: options.providerOptions,\n          abortSignal: context.abortSignal,\n        });\n        return result.output;\n      });\n    }, next.state);\n  }\n\n  async run(options: PipelineRunOptions<Input>): Promise<PipelineRunResult<Output>> {\n    const runId = normalizeRunId(options.runId ?? globalThis.crypto.randomUUID());\n    const startedAt = Date.now();\n    const observability = await startPipelineRunObservers(\n      this.observability?.observers ?? {},\n      {\n        runId,\n        pipelineId: this.id,\n        pipelineName: this.name,\n        pipelineDescription: this.description,\n        pipelineMetadata: this.metadata,\n        runMetadata: options.metadata,\n        trace: options.trace,\n        input: options.input,\n      },\n      {\n        primaryTrace: this.observability?.primaryTrace,\n        errorPolicy: this.observability?.errorPolicy ?? \"ignore\",\n      },\n    );\n    const context: PipelineRunContext = {\n      runId,\n      pipelineId: this.id,\n      runMetadata: options.metadata,\n      abortSignal: options.abortSignal,\n      observer: options.observer,\n      failOnObserverError: options.failOnObserverError === true,\n      observability,\n    };\n    try {\n      throwIfAborted(context.abortSignal);\n      const output = await this.execute(options.input, context, []);\n      throwIfAborted(context.abortSignal);\n      await observability.end({\n        runId,\n        pipelineId: this.id,\n        output,\n        durationMs: Date.now() - startedAt,\n      });\n      return observability.trace === undefined\n        ? { runId, output }\n        : { runId, output, trace: observability.trace };\n    } catch (error) {\n      await observability.error({\n        runId,\n        pipelineId: this.id,\n        status: context.abortSignal?.aborted === true ? \"cancelled\" : \"failed\",\n        error,\n        durationMs: Date.now() - startedAt,\n      });\n      throw error;\n    }\n  }\n\n  async runBatch(options: PipelineBatchOptions<Input>): Promise<Array<PipelineBatchItem<Output>>> {\n    throwIfAborted(options.abortSignal);\n    return mapWithConcurrency([...options.inputs], options.concurrency, async (input) => {\n      const runId = globalThis.crypto.randomUUID();\n      try {\n        const result = await this.run({\n          input,\n          runId,\n          metadata: options.metadata,\n          trace: options.trace,\n          abortSignal: options.abortSignal,\n          observer: options.observer,\n          failOnObserverError: options.failOnObserverError,\n        });\n        return { status: \"completed\", ...result } as const;\n      } catch (error) {\n        if (options.abortSignal?.aborted === true) {\n          throw pipelineAbortError(options.abortSignal);\n        }\n        return { status: \"failed\", runId, error } as const;\n      }\n    });\n  }\n\n  graph(): PipelineGraph {\n    return cloneGraph(withOutputNode(this.state));\n  }\n\n  private derive<DerivedOutput>(\n    executor: PipelineExecutor<Input, DerivedOutput>,\n    state: PipelineState,\n  ): Pipeline<Input, DerivedOutput> {\n    return createDerivedPipeline(executor, state, this.observability);\n  }\n\n  private async execute(\n    input: Input,\n    context: PipelineRunContext,\n    pathPrefix: PipelineNodePath,\n  ): Promise<Awaited<Output>> {\n    throwIfAborted(context.abortSignal);\n    return (await this.executor(input, context, pathPrefix)) as Awaited<Output>;\n  }\n}\n\nfunction createDerivedPipeline<Input, Output>(\n  executor: PipelineExecutor<Input, Output>,\n  state: PipelineState,\n  observability: PipelineOptions<Input>[\"observability\"],\n): Pipeline<Input, Output> {\n  const options: InternalPipelineOptions<Input, Output> = {\n    [internalPipelineOptions]: { executor, state, observability },\n  };\n  return new Pipeline<Input, Output>(options as unknown as PipelineOptions<Input, Output>);\n}\n\nfunction withPipelineParentTrace(\n  trace: AgentTraceOptions | undefined,\n  parent: PipelineTraceInfo | undefined,\n  agentPrimaryTrace: string | undefined,\n): AgentTraceOptions | undefined {\n  if (parent?.traceId === undefined) return trace;\n  if (parent.observer !== agentPrimaryTrace) return trace;\n  if (trace?.traceId !== undefined && trace.traceId !== parent.traceId) return trace;\n  return {\n    ...trace,\n    traceId: parent.traceId,\n    ...(trace?.parentObservationId !== undefined || parent.observationId === undefined\n      ? {}\n      : { parentObservationId: parent.observationId }),\n  };\n}\n\nfunction isInternalPipelineOptions<Input, Output>(\n  options: PipelineOptions<Input, Output> | InternalPipelineOptions<Input, Output>,\n): options is InternalPipelineOptions<Input, Output> {\n  return internalPipelineOptions in options;\n}\n\nfunction isZodSchema(value: unknown): value is z.ZodType {\n  return value instanceof z.ZodType;\n}\n\nfunction normalizePipelineId(id: string): string {\n  if (typeof id !== \"string\") {\n    throw new TypeError(\"Pipeline id must be a string.\");\n  }\n  const normalized = id.trim();\n  if (normalized.length === 0) {\n    throw new TypeError(\"Pipeline id must be a non-empty string.\");\n  }\n  return normalized;\n}\n\nfunction normalizeRunId(runId: string): string {\n  if (typeof runId !== \"string\") {\n    throw new TypeError(\"Pipeline runId must be a string.\");\n  }\n  const normalized = runId.trim();\n  if (normalized.length === 0) {\n    throw new TypeError(\"Pipeline runId must be a non-empty string.\");\n  }\n  return normalized;\n}\n\nfunction normalizeParallelBranches<Branch>(\n  branches: Readonly<Record<string, Branch>>,\n): Array<readonly [string, Branch]> {\n  const entries: Array<readonly [string, Branch]> = [];\n  const ids = new Set<string>();\n  for (const key of Object.keys(branches)) {\n    const pipeline = branches[key] as Branch;\n    const id = key.trim();\n    if (id.length === 0) {\n      throw new TypeError(\"Pipeline parallel branch id must be a non-empty string.\");\n    }\n    if (ids.has(id)) {\n      throw new TypeError(`Pipeline parallel branch id \"${id}\" is already registered.`);\n    }\n    ids.add(id);\n    if (id !== key) {\n      throw new TypeError(\"Pipeline parallel branch ids must not contain surrounding whitespace.\");\n    }\n    entries.push([id, pipeline]);\n  }\n  return entries;\n}\n","import type { JsonObject } from \"../completion\";\nimport type {\n  PipelineGraph,\n  PipelineGraphEdge,\n  PipelineGraphNode,\n  PipelineNodePath,\n  PipelineStageKind,\n  PipelineStageMetadata,\n  PipelineState,\n} from \"./types\";\n\nconst INPUT_ID = \"$input\";\nconst OUTPUT_ID = \"$output\";\nconst RESERVED_STAGE_IDS = new Set([INPUT_ID, OUTPUT_ID]);\n\nexport function initialPipelineState(options: {\n  id: string;\n  name?: string | undefined;\n  description?: string | undefined;\n  metadata?: JsonObject | undefined;\n}): PipelineState {\n  const input = graphNode(INPUT_ID, [INPUT_ID], \"input\", \"Input\");\n  const graph: PipelineGraph = {\n    id: options.id,\n    nodes: [input],\n    edges: [],\n  };\n  if (options.name !== undefined) graph.name = options.name;\n  if (options.description !== undefined) graph.description = options.description;\n  if (options.metadata !== undefined) graph.metadata = options.metadata;\n  return {\n    graph,\n    terminalPaths: [input.path],\n    stageIds: new Set(),\n    nextEdgeIndex: 1,\n  };\n}\n\nexport function appendStageNode(\n  state: PipelineState,\n  kind: PipelineStageKind,\n  stage: PipelineStageMetadata,\n  options: {\n    defaultLabel?: string | undefined;\n    agentId?: string | undefined;\n    agentName?: string | undefined;\n    pipelineId?: string | undefined;\n  } = {},\n): { state: PipelineState; node: PipelineGraphNode } {\n  const id = validateStageId(stage.id);\n  if (state.stageIds.has(id)) {\n    throw new TypeError(`Pipeline stage id \"${id}\" is already registered.`);\n  }\n  const node = graphNode(id, [id], kind, stage.name ?? options.defaultLabel ?? id, {\n    description: stage.description,\n    metadata: stage.metadata,\n    agentId: options.agentId,\n    agentName: options.agentName,\n    pipelineId: options.pipelineId,\n  });\n  return {\n    node,\n    state: appendNode(state, node, state.terminalPaths, [node.path], id),\n  };\n}\n\nexport function appendComposedGraph(\n  state: PipelineState,\n  boundary: PipelineGraphNode,\n  child: PipelineGraph,\n): PipelineState {\n  return appendChildGraph(state, boundary.path, child);\n}\n\nexport function appendParallelBranch(\n  state: PipelineState,\n  parallel: PipelineGraphNode,\n  branchKey: string,\n  child: PipelineGraph,\n): { state: PipelineState; node: PipelineGraphNode; terminalPaths: PipelineNodePath[] } {\n  const id = validateStageId(branchKey);\n  const path = [...parallel.path, id];\n  const node = graphNode(id, path, \"branch\", id, { branchKey: id, pipelineId: child.id });\n  const withBranch = appendNode(state, node, [parallel.path], state.terminalPaths);\n  const withChild = appendChildGraph(withBranch, node.path, child);\n  return { state: withChild, node, terminalPaths: withChild.terminalPaths };\n}\n\nexport function withTerminalPaths(\n  state: PipelineState,\n  terminalPaths: PipelineNodePath[],\n): PipelineState {\n  return { ...state, terminalPaths };\n}\n\nexport function withOutputNode(state: PipelineState): PipelineGraph {\n  const graph = cloneGraph(state.graph);\n  const outputPath = [OUTPUT_ID];\n  if (graph.nodes.some((node) => pathEquals(node.path, outputPath))) {\n    return graph;\n  }\n  graph.nodes.push(graphNode(OUTPUT_ID, outputPath, \"output\", \"Output\"));\n  graph.edges.push(\n    ...state.terminalPaths.map((source, index) => ({\n      id: `edge_${state.nextEdgeIndex + index}`,\n      source: [...source],\n      target: outputPath,\n    })),\n  );\n  return graph;\n}\n\nexport function cloneGraph(graph: PipelineGraph): PipelineGraph {\n  return {\n    ...graph,\n    nodes: graph.nodes.map((node) => ({ ...node, path: [...node.path] })),\n    edges: graph.edges.map((edge) => ({\n      ...edge,\n      source: [...edge.source],\n      target: [...edge.target],\n    })),\n  };\n}\n\nexport function scopedNode(node: PipelineGraphNode, path: PipelineNodePath): PipelineGraphNode {\n  return { ...node, path: [...path] };\n}\n\nfunction appendChildGraph(\n  state: PipelineState,\n  parentPath: PipelineNodePath,\n  child: PipelineGraph,\n): PipelineState {\n  const childNodes = child.nodes\n    .filter((node) => !isBoundaryPath(node.path))\n    .map((node) => scopedNode(node, [...parentPath, ...node.path]));\n  const childEdges: PipelineState[\"graph\"][\"edges\"] = [];\n  const terminalPaths: PipelineNodePath[] = [];\n  let nextEdgeIndex = state.nextEdgeIndex;\n\n  for (const edge of child.edges) {\n    const sourceIsInput = isInputPath(edge.source);\n    const targetIsOutput = isOutputPath(edge.target);\n    const source = sourceIsInput ? [...parentPath] : [...parentPath, ...edge.source];\n    if (targetIsOutput) {\n      terminalPaths.push(source);\n      continue;\n    }\n    const target = [...parentPath, ...edge.target];\n    let childEdge: PipelineGraphEdge = {\n      id: `edge_${nextEdgeIndex}`,\n      source,\n      target,\n    };\n    if (edge.label !== undefined) childEdge = { ...childEdge, label: edge.label };\n    childEdges.push(childEdge);\n    nextEdgeIndex += 1;\n  }\n\n  return {\n    ...state,\n    graph: {\n      ...state.graph,\n      nodes: [...state.graph.nodes, ...childNodes],\n      edges: [...state.graph.edges, ...childEdges],\n    },\n    terminalPaths: terminalPaths.length === 0 ? [[...parentPath]] : terminalPaths,\n    nextEdgeIndex,\n  };\n}\n\nfunction appendNode(\n  state: PipelineState,\n  node: PipelineGraphNode,\n  sourcePaths: PipelineNodePath[],\n  terminalPaths: PipelineNodePath[],\n  stageId?: string,\n): PipelineState {\n  const edges = sourcePaths.map((source, index) => ({\n    id: `edge_${state.nextEdgeIndex + index}`,\n    source: [...source],\n    target: [...node.path],\n  }));\n  const stageIds = new Set(state.stageIds);\n  if (stageId !== undefined) stageIds.add(stageId);\n  return {\n    graph: {\n      ...state.graph,\n      nodes: [...state.graph.nodes, node],\n      edges: [...state.graph.edges, ...edges],\n    },\n    terminalPaths,\n    stageIds,\n    nextEdgeIndex: state.nextEdgeIndex + edges.length,\n  };\n}\n\nfunction graphNode(\n  id: string,\n  path: PipelineNodePath,\n  kind: PipelineStageKind,\n  label: string,\n  options: {\n    description?: string | undefined;\n    metadata?: JsonObject | undefined;\n    agentId?: string | undefined;\n    agentName?: string | undefined;\n    pipelineId?: string | undefined;\n    branchKey?: string | undefined;\n  } = {},\n): PipelineGraphNode {\n  const node: PipelineGraphNode = { id, path: [...path], kind, label };\n  if (options.description !== undefined) node.description = options.description;\n  if (options.metadata !== undefined) node.metadata = options.metadata;\n  if (options.agentId !== undefined) node.agentId = options.agentId;\n  if (options.agentName !== undefined) node.agentName = options.agentName;\n  if (options.pipelineId !== undefined) node.pipelineId = options.pipelineId;\n  if (options.branchKey !== undefined) node.branchKey = options.branchKey;\n  return node;\n}\n\nfunction validateStageId(value: string): string {\n  if (typeof value !== \"string\") {\n    throw new TypeError(\"Pipeline stage id must be a string.\");\n  }\n  const id = value.trim();\n  if (id.length === 0) {\n    throw new TypeError(\"Pipeline stage id must be a non-empty string.\");\n  }\n  if (RESERVED_STAGE_IDS.has(id)) {\n    throw new TypeError(`Pipeline stage id \"${id}\" is reserved.`);\n  }\n  return id;\n}\n\nfunction isBoundaryPath(path: PipelineNodePath): boolean {\n  return isInputPath(path) || isOutputPath(path);\n}\n\nfunction isInputPath(path: PipelineNodePath): boolean {\n  return path.length === 1 && path[0] === INPUT_ID;\n}\n\nfunction isOutputPath(path: PipelineNodePath): boolean {\n  return path.length === 1 && path[0] === OUTPUT_ID;\n}\n\nfunction pathEquals(left: PipelineNodePath, right: PipelineNodePath): boolean {\n  return left.length === right.length && left.every((segment, index) => segment === right[index]);\n}\n","import { observerSnapshot } from \"../observability/snapshot\";\nimport { PipelineObserverDispatchError, type PipelineObserverFailure } from \"./errors\";\nimport type {\n  PipelineObservabilityOptions,\n  PipelineObserverErrorPolicy,\n  PipelineObserverMap,\n  PipelineObserverTraceInfo,\n  PipelineRunEndArgs,\n  PipelineRunErrorArgs,\n  PipelineRunObservation,\n  PipelineRunStartArgs,\n  PipelineStageEndArgs,\n  PipelineStageErrorArgs,\n  PipelineStageObservation,\n  PipelineStageStartArgs,\n  PipelineTraceInfo,\n} from \"./types\";\n\ntype NamedObserver<T> = {\n  readonly name: string;\n  readonly observer: T;\n};\n\ntype ActiveNamedObserver<T> = NamedObserver<T> & {\n  terminal: boolean;\n};\n\nfunction resolvePrimaryTrace<T extends { readonly trace?: PipelineObserverTraceInfo | undefined }>(\n  observers: readonly ActiveNamedObserver<T>[],\n  primaryTrace: string | undefined,\n): PipelineTraceInfo | undefined {\n  if (primaryTrace === undefined) return undefined;\n  const primary = observers.find((entry) => entry.name === primaryTrace);\n  return primary?.observer.trace === undefined\n    ? undefined\n    : Object.freeze({ observer: primary.name, ...primary.observer.trace });\n}\n\nexport function snapshotPipelineObservability(\n  observability: PipelineObservabilityOptions | undefined,\n): PipelineObservabilityOptions | undefined {\n  if (observability === undefined) return undefined;\n  const observers: Record<string, PipelineObserverMap[string]> = {};\n  for (const [name, observer] of Object.entries(observability.observers)) {\n    if (name.trim().length === 0) {\n      throw new TypeError(\"Pipeline observer names must not be empty.\");\n    }\n    if (\n      typeof observer !== \"object\" ||\n      observer === null ||\n      typeof observer.startRun !== \"function\"\n    ) {\n      throw new TypeError(`Pipeline observer \"${name}\" must implement startRun().`);\n    }\n    observers[name] = observer;\n  }\n  if (observability.primaryTrace !== undefined && !(observability.primaryTrace in observers)) {\n    throw new TypeError(\n      `Pipeline primaryTrace \"${observability.primaryTrace}\" must name a configured observer.`,\n    );\n  }\n  const errorPolicy = observability.errorPolicy ?? \"ignore\";\n  if (errorPolicy !== \"ignore\" && errorPolicy !== \"throw\") {\n    throw new TypeError('Pipeline observability.errorPolicy must be \"ignore\" or \"throw\".');\n  }\n  const snapshot: PipelineObservabilityOptions = {\n    observers: Object.freeze(observers),\n    errorPolicy,\n    ...(observability.primaryTrace === undefined\n      ? {}\n      : { primaryTrace: observability.primaryTrace }),\n  };\n  return Object.freeze(snapshot);\n}\n\nexport async function startPipelineRunObservers(\n  observers: PipelineObserverMap,\n  args: PipelineRunStartArgs,\n  options: {\n    readonly primaryTrace?: string | undefined;\n    readonly errorPolicy: PipelineObserverErrorPolicy;\n  },\n): Promise<ActivePipelineRunObservers> {\n  const runObservers: ActiveNamedObserver<PipelineRunObservation>[] = [];\n  const failures: PipelineObserverFailure[] = [];\n  for (const [name, observer] of Object.entries(observers)) {\n    try {\n      const runObserver = await observer.startRun(observerSnapshot(args));\n      if (runObserver !== undefined) {\n        runObservers.push({ name, observer: runObserver, terminal: false });\n      }\n    } catch (error) {\n      failures.push({ observer: name, error });\n    }\n  }\n  if (options.errorPolicy === \"throw\" && failures.length > 0) {\n    const startupError = new PipelineObserverDispatchError(\"startRun\", failures);\n    const cleanupFailures = await terminateObservers(runObservers, (observer) =>\n      observer.error?.(\n        observerSnapshot({\n          runId: args.runId,\n          pipelineId: args.pipelineId,\n          status: \"failed\",\n          error: startupError,\n          durationMs: 0,\n        }),\n      ),\n    );\n    throw new PipelineObserverDispatchError(\"startRun\", [...failures, ...cleanupFailures]);\n  }\n  return new ActivePipelineRunObservers(runObservers, options);\n}\n\nexport class ActivePipelineRunObservers {\n  readonly trace: PipelineTraceInfo | undefined;\n\n  constructor(\n    private readonly observers: readonly ActiveNamedObserver<PipelineRunObservation>[],\n    private readonly options: {\n      readonly primaryTrace?: string | undefined;\n      readonly errorPolicy: PipelineObserverErrorPolicy;\n    },\n  ) {\n    this.trace = resolvePrimaryTrace(observers, options.primaryTrace);\n  }\n\n  async startStage(args: PipelineStageStartArgs): Promise<ActivePipelineStageObservers> {\n    const stageObservers: ActiveNamedObserver<PipelineStageObservation>[] = [];\n    const failures: PipelineObserverFailure[] = [];\n    for (const entry of this.observers) {\n      if (entry.observer.startStage === undefined) continue;\n      try {\n        const observer = await entry.observer.startStage(observerSnapshot(args));\n        if (observer !== undefined) {\n          stageObservers.push({ name: entry.name, observer, terminal: false });\n        }\n      } catch (error) {\n        failures.push({ observer: entry.name, error });\n      }\n    }\n    if (this.options.errorPolicy === \"throw\" && failures.length > 0) {\n      const startupError = new PipelineObserverDispatchError(\"startStage\", failures);\n      const cleanupFailures = await terminateObservers(stageObservers, (observer) =>\n        observer.error?.(observerSnapshot({ ...args, error: startupError, durationMs: 0 })),\n      );\n      throw new PipelineObserverDispatchError(\"startStage\", [...failures, ...cleanupFailures]);\n    }\n    return new ActivePipelineStageObservers(stageObservers, this.options);\n  }\n\n  async end(args: PipelineRunEndArgs): Promise<void> {\n    await dispatchTerminalObservers(\n      this.observers,\n      \"end\",\n      (observer) => observer.end(observerSnapshot(args)),\n      this.options.errorPolicy,\n    );\n  }\n\n  async error(args: PipelineRunErrorArgs): Promise<void> {\n    await dispatchTerminalObservers(\n      this.observers,\n      \"error\",\n      (observer) => observer.error?.(observerSnapshot(args)),\n      \"ignore\",\n    );\n  }\n}\n\nexport class ActivePipelineStageObservers {\n  readonly trace: PipelineTraceInfo | undefined;\n\n  constructor(\n    private readonly observers: readonly ActiveNamedObserver<PipelineStageObservation>[],\n    private readonly options: {\n      readonly primaryTrace?: string | undefined;\n      readonly errorPolicy: PipelineObserverErrorPolicy;\n    },\n  ) {\n    this.trace = resolvePrimaryTrace(observers, options.primaryTrace);\n  }\n\n  async end(args: PipelineStageEndArgs): Promise<void> {\n    await dispatchTerminalObservers(\n      this.observers,\n      \"stage.end\",\n      (observer) => observer.end(observerSnapshot(args)),\n      this.options.errorPolicy,\n    );\n  }\n\n  async error(args: PipelineStageErrorArgs): Promise<void> {\n    await dispatchTerminalObservers(\n      this.observers,\n      \"stage.error\",\n      (observer) => observer.error?.(observerSnapshot(args)),\n      \"ignore\",\n    );\n  }\n}\n\nasync function dispatchTerminalObservers<T>(\n  observers: readonly ActiveNamedObserver<T>[],\n  phase: string,\n  dispatch: (observer: T) => void | Promise<void> | undefined,\n  errorPolicy: PipelineObserverErrorPolicy,\n): Promise<void> {\n  const failures = await terminateObservers(observers, dispatch);\n  if (errorPolicy === \"throw\" && failures.length > 0) {\n    throw new PipelineObserverDispatchError(phase, failures);\n  }\n}\n\nasync function terminateObservers<T>(\n  observers: readonly ActiveNamedObserver<T>[],\n  dispatch: (observer: T) => void | Promise<void> | undefined,\n): Promise<PipelineObserverFailure[]> {\n  const failures: PipelineObserverFailure[] = [];\n  for (const entry of observers) {\n    if (entry.terminal) continue;\n    entry.terminal = true;\n    try {\n      await dispatch(entry.observer);\n    } catch (error) {\n      failures.push({ observer: entry.name, error });\n    }\n  }\n  return failures;\n}\n","import { abortError, throwIfAborted } from \"../internal/abort\";\nimport { scopedNode } from \"./graph\";\nimport type {\n  PipelineGraphNode,\n  PipelineNodePath,\n  PipelineRunContext,\n  PipelineRunEvent,\n  PipelineStageContext,\n  PipelineTraceInfo,\n} from \"./types\";\n\nexport async function runNode<Output>(\n  context: PipelineRunContext,\n  node: PipelineGraphNode,\n  path: PipelineNodePath,\n  input: unknown,\n  fn: (trace: PipelineTraceInfo | undefined) => Output | Promise<Output>,\n): Promise<Awaited<Output>> {\n  throwIfAborted(context.abortSignal);\n  const eventNode = scopedNode(node, path);\n  const startedAt = Date.now();\n  const eventBase = {\n    runId: context.runId,\n    pipelineId: context.pipelineId,\n    path: [...path],\n    node: eventNode,\n  };\n  const observers = await context.observability.startStage({ ...eventBase, input });\n  try {\n    await emitEvent(context, { type: \"stage_started\", ...eventBase });\n  } catch (error) {\n    await observers.error({ ...eventBase, error, durationMs: Date.now() - startedAt });\n    throw error;\n  }\n\n  try {\n    const output = (await fn(observers.trace)) as Awaited<Output>;\n    throwIfAborted(context.abortSignal);\n    const durationMs = Date.now() - startedAt;\n    await emitEvent(context, {\n      type: \"stage_completed\",\n      ...eventBase,\n      durationMs,\n    });\n    await observers.end({ ...eventBase, output, durationMs });\n    return output;\n  } catch (error) {\n    const durationMs = Date.now() - startedAt;\n    const failureEvent: PipelineRunEvent = {\n      type: \"stage_failed\",\n      ...eventBase,\n      durationMs,\n      error,\n    };\n    try {\n      await emitEvent(context, failureEvent);\n    } catch (observerError) {\n      await observers.error({ ...eventBase, error, durationMs });\n      throw new AggregateError(\n        [error, observerError],\n        `Pipeline stage \"${node.id}\" and its observer both failed.`,\n      );\n    }\n    await observers.error({ ...eventBase, error, durationMs });\n    throw error;\n  }\n}\n\nexport function stageContext<Input>(\n  input: Input,\n  context: PipelineRunContext,\n): PipelineStageContext<Input> {\n  return {\n    input,\n    runId: context.runId,\n    pipelineId: context.pipelineId,\n    runMetadata: context.runMetadata,\n    abortSignal: context.abortSignal,\n  };\n}\n\nexport function childContext(\n  context: PipelineRunContext,\n  abortSignal: AbortSignal | undefined,\n): PipelineRunContext {\n  return { ...context, abortSignal };\n}\n\nexport function combineAbortSignals(\n  parent: AbortSignal | undefined,\n  local: AbortSignal,\n): { signal: AbortSignal; dispose(): void } {\n  const controller = new AbortController();\n  const abortFromParent = () => controller.abort(parent?.reason);\n  const abortFromLocal = () => controller.abort(local.reason);\n\n  if (parent?.aborted === true) {\n    controller.abort(parent.reason);\n  } else if (local.aborted) {\n    controller.abort(local.reason);\n  } else {\n    parent?.addEventListener(\"abort\", abortFromParent, { once: true });\n    local.addEventListener(\"abort\", abortFromLocal, { once: true });\n  }\n\n  return {\n    signal: controller.signal,\n    dispose() {\n      parent?.removeEventListener(\"abort\", abortFromParent);\n      local.removeEventListener(\"abort\", abortFromLocal);\n    },\n  };\n}\n\nexport function pipelineAbortError(signal: AbortSignal | undefined): Error {\n  return abortError(signal?.reason);\n}\n\nasync function emitEvent(context: PipelineRunContext, event: PipelineRunEvent): Promise<void> {\n  if (context.observer === undefined) return;\n  try {\n    await context.observer.onEvent(event);\n  } catch (error) {\n    if (context.failOnObserverError) throw error;\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/skills/index.js

@@ -2,11 +2,11 @@ import {
   SkillValidationError,
   loadSkills,
   skill
-} from "../chunk-VSTJNHOZ.js";
+} from "../chunk-XSV5C4R5.js";
 import "../chunk-YK4WAAS4.js";
-import "../chunk-OIB3URVG.js";
-import "../chunk-LZD36ZAP.js";
-import "../chunk-4EWTDOLR.js";
+import "../chunk-2QZJTG2E.js";
+import "../chunk-XC3LVC4K.js";
+import "../chunk-XEVOC433.js";
 import "../chunk-K5L7R7XM.js";
 import "../chunk-IZNOP6JG.js";
 import "../chunk-QGX73TSQ.js";

package/dist/tool/index.js

@@ -6,7 +6,7 @@ import {
   embedTools,
   isQuestionTool,
   isToolIndex
-} from "../chunk-OIB3URVG.js";
+} from "../chunk-2QZJTG2E.js";
 import {
   ToolCallError,
   ToolJsonError,
@@ -17,8 +17,8 @@ import {
   normalizeToolResultOutput,
   parseToolArgs,
   toolResultContentToText
-} from "../chunk-LZD36ZAP.js";
-import "../chunk-4EWTDOLR.js";
+} from "../chunk-XC3LVC4K.js";
+import "../chunk-XEVOC433.js";
 import "../chunk-K5L7R7XM.js";
 import "../chunk-IZNOP6JG.js";
 import "../chunk-QGX73TSQ.js";

package/dist/{types-BUEZMBhO.d.ts → types-DL7wX6hJ.d.ts}

@@ -2,7 +2,7 @@ import { AgentInteractionRequest, AgentContinuation, AgentInteractionResponse }
 import { b as RetrySetting } from './retry-CjvSlKGW.js';
 import { M as Message, g as CompletionResponse, U as Usage, R as ReasoningContentType, u as ToolCallPart, i as CompletionSource, r as ProviderToolCall, G as UserMessage, C as CompletionFinishReason, l as ContextUsage, f as CompletionRequest, z as ToolResultOutput, y as ToolResultContentPart, _ as ToolInteractionResponsePart, Z as ToolCallArgumentsMode, J as JsonObject, V as CompletionModelCapabilities, w as ToolDefinition } from './types-DgvozfPc.js';
 import { d as GuardrailPolicyInput, a as GuardrailDecisionRecord } from './types-DhkodEft.js';
-import { e as MemoryCompactionInfo, A as MemoryScope } from './types-CSYt7-It.js';
+import { e as MemoryCompactionInfo, A as MemoryScope } from './types-DmzRCbU5.js';
 import { D as DeepReadonly, M as MaybePromise } from './type-utils-CtHVDRn_.js';
 import { d as ToolCallStreamEvent } from './tool-BpqpoRSE.js';
 import { A as AgentMiddleware } from './middleware-kcF8AusP.js';
@@ -283,6 +283,7 @@ type AgentTraceOptions = {
     readonly tags?: readonly string[] | undefined;
     readonly version?: string | undefined;
     readonly traceId?: string | undefined;
+    readonly parentObservationId?: string | undefined;
     readonly promptRef?: AgentRunPromptRef | undefined;
 };
 type AgentRunPromptRef = {

package/dist/{types-CSYt7-It.d.ts → types-DmzRCbU5.d.ts}

@@ -70,6 +70,7 @@ interface MemoryInspector {
 interface MemoryStore {
     readonly inspector?: MemoryInspector | undefined;
     readonly compaction?: MemoryCompactionCapability | undefined;
+    /** Loads the canonical, replayable conversation history. */
     load(options: MemoryLoadOptions): Promise<Message[]>;
     append(options: MemoryAppendOptions): Promise<void>;
     clear(options: MemoryClearOptions): Promise<void>;
@@ -89,6 +90,7 @@ type MemoryCompactionMessage = Omit<SystemMessage, "metadata"> & {
 type MemoryCompactionSnapshot = {
     /** Opaque store revision used to reject stale compaction replacements. */
     revision: string;
+    /** Current model-context projection: the latest summary checkpoint plus unsummarized messages. */
     messages: Message[];
 };
 type MemoryCompactionSnapshotOptions = {
@@ -97,6 +99,7 @@ type MemoryCompactionSnapshotOptions = {
 type MemoryCompactionReplacePrefixOptions = {
     scope: MemoryScope;
     revision: string;
+    /** Number of projected messages covered by `replacement`, including any prior summary message. */
     messageCount: number;
     replacement: MemoryCompactionMessage;
     runId: string;
@@ -104,7 +107,12 @@ type MemoryCompactionReplacePrefixOptions = {
 type MemoryCompactionReplacePrefixResult = {
     status: "committed" | "conflict";
 };
-/** Optional atomic prefix-replacement capability used by automatic memory compaction. */
+/**
+ * Optional atomic context-projection capability used by memory compaction.
+ *
+ * Implementations must preserve canonical messages. `snapshot()` returns the current model-context
+ * projection, while `replacePrefix()` replaces only that projection's prefix with a summary.
+ */
 interface MemoryCompactionCapability {
     snapshot(options: MemoryCompactionSnapshotOptions): Promise<MemoryCompactionSnapshot>;
     replacePrefix(options: MemoryCompactionReplacePrefixOptions): Promise<MemoryCompactionReplacePrefixResult>;

package/dist/vector-store/index.js

@@ -6,8 +6,8 @@ import {
   matchesVectorFilter,
   retrieveDocuments,
   vectorFilter
-} from "../chunk-LZD36ZAP.js";
-import "../chunk-4EWTDOLR.js";
+} from "../chunk-XC3LVC4K.js";
+import "../chunk-XEVOC433.js";
 import "../chunk-K5L7R7XM.js";
 import "../chunk-IZNOP6JG.js";
 import "../chunk-QGX73TSQ.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anvia/core",
-  "version": "1.0.3",
+  "version": "1.0.7",
   "description": "Core runtime primitives for context-aware Anvia agents.",
   "author": "anvia",
   "maintainer": "Indra Zulfi",
@@ -116,19 +116,10 @@
   },
   "devDependencies": {
     "@types/node": "^24.9.1",
-    "pdfjs-dist": "^6.2.108",
     "tsup": "^8.5.0",
     "typescript": "^5.9.3",
     "vitest": "^4.0.8"
   },
-  "peerDependencies": {
-    "pdfjs-dist": "^6.2.108"
-  },
-  "peerDependenciesMeta": {
-    "pdfjs-dist": {
-      "optional": true
-    }
-  },
   "scripts": {
     "build": "tsup src/index.ts src/agent/index.ts src/agent/interactions/index.ts src/internal/agent.ts src/speech-generation/index.ts src/completion/index.ts src/embeddings/index.ts src/evals/index.ts src/image-generation/index.ts src/documents/index.ts src/extractor/index.ts src/guardrails/index.ts src/mcp/index.ts src/memory/index.ts src/model-listing/index.ts src/observability/index.ts src/pipeline/index.ts src/skills/index.ts src/streaming/index.ts src/tool/index.ts src/transcription/index.ts src/vector-store/index.ts --format esm --dts --sourcemap --clean",
     "test": "vitest run",

package/dist/chunk-4EWTDOLR.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/documents/chunk-text.ts","../src/documents/pdf.ts","../src/documents/text-document.ts"],"sourcesContent":["export type TextChunk = Readonly<{\n  index: number;\n  text: string;\n  start: number;\n  end: number;\n}>;\n\nexport type ChunkTextOptions =\n  | Readonly<{\n      text: string;\n      strategy: \"fixed\";\n      maxSize: number;\n      overlap?: number;\n    }>\n  | Readonly<{\n      text: string;\n      strategy: \"recursive\";\n      maxSize: number;\n      overlap?: number;\n      separators: readonly string[];\n    }>;\n\ntype TextRange = Readonly<{\n  start: number;\n  end: number;\n}>;\n\nexport function chunkText(options: ChunkTextOptions): readonly TextChunk[] {\n  const validated = validateOptions(options);\n  if (validated.text.length === 0) {\n    return [];\n  }\n\n  if (validated.strategy === \"fixed\") {\n    return chunkFixed(validated.text, validated.maxSize, validated.overlap);\n  }\n\n  const ranges = resolveRecursiveRanges(\n    validated.text,\n    { start: 0, end: validated.text.length },\n    validated.maxSize,\n    validated.separators,\n  );\n  return applyRecursiveOverlap(validated.text, ranges, validated.maxSize, validated.overlap);\n}\n\nfunction validateOptions(options: ChunkTextOptions):\n  | Readonly<{\n      text: string;\n      strategy: \"fixed\";\n      maxSize: number;\n      overlap: number;\n    }>\n  | Readonly<{\n      text: string;\n      strategy: \"recursive\";\n      maxSize: number;\n      overlap: number;\n      separators: readonly string[];\n    }> {\n  if (typeof options !== \"object\" || options === null) {\n    throw new TypeError(\"chunkText options must be an object\");\n  }\n\n  const value = options as unknown as Record<string, unknown>;\n  if (typeof value.text !== \"string\") {\n    throw new TypeError(\"chunkText text must be a string\");\n  }\n  if (!Number.isSafeInteger(value.maxSize) || (value.maxSize as number) <= 0) {\n    throw new RangeError(\"chunkText maxSize must be a positive safe integer\");\n  }\n\n  const maxSize = value.maxSize as number;\n  const overlap = value.overlap === undefined ? 0 : value.overlap;\n  if (!Number.isSafeInteger(overlap) || (overlap as number) < 0 || (overlap as number) >= maxSize) {\n    throw new RangeError(\n      \"chunkText overlap must be a non-negative safe integer smaller than maxSize\",\n    );\n  }\n\n  if (value.strategy === \"fixed\") {\n    if (\"separators\" in value) {\n      throw new TypeError(\"chunkText fixed strategy does not accept separators\");\n    }\n    return {\n      text: value.text,\n      strategy: \"fixed\",\n      maxSize,\n      overlap: overlap as number,\n    };\n  }\n\n  if (value.strategy !== \"recursive\") {\n    throw new TypeError('chunkText strategy must be either \"fixed\" or \"recursive\"');\n  }\n  if (!Array.isArray(value.separators) || value.separators.length === 0) {\n    throw new TypeError(\"chunkText recursive separators must be a non-empty array\");\n  }\n\n  const separators = value.separators as unknown[];\n  const seen = new Set<string>();\n  for (const separator of separators) {\n    if (typeof separator !== \"string\" || separator.length === 0) {\n      throw new TypeError(\"chunkText recursive separators must contain non-empty strings\");\n    }\n    if (seen.has(separator)) {\n      throw new TypeError(\"chunkText recursive separators must not contain duplicates\");\n    }\n    seen.add(separator);\n  }\n\n  return {\n    text: value.text,\n    strategy: \"recursive\",\n    maxSize,\n    overlap: overlap as number,\n    separators: separators as string[],\n  };\n}\n\nfunction chunkFixed(text: string, maxSize: number, overlap: number): readonly TextChunk[] {\n  const chunks: TextChunk[] = [];\n  let start = 0;\n\n  while (start < text.length) {\n    const end = Math.min(start + maxSize, text.length);\n    chunks.push(createChunk(text, chunks.length, start, end));\n    if (end === text.length) {\n      break;\n    }\n    start = end - overlap;\n  }\n\n  return chunks;\n}\n\nfunction resolveRecursiveRanges(\n  text: string,\n  initialRange: TextRange,\n  maxSize: number,\n  separators: readonly string[],\n): readonly TextRange[] {\n  const resolved: TextRange[] = [];\n  const pending: Array<Readonly<{ range: TextRange; separatorIndex: number }>> = [\n    { range: initialRange, separatorIndex: 0 },\n  ];\n\n  while (pending.length > 0) {\n    const current = pending.pop();\n    if (current === undefined) {\n      break;\n    }\n    if (current.range.end - current.range.start <= maxSize) {\n      resolved.push(current.range);\n      continue;\n    }\n\n    let pieces: readonly TextRange[] | undefined;\n    let nextSeparatorIndex = separators.length;\n    for (let index = current.separatorIndex; index < separators.length; index += 1) {\n      const candidate = splitAfterSeparator(text, current.range, separators[index] as string);\n      if (candidate.length > 1) {\n        pieces = candidate;\n        nextSeparatorIndex = index + 1;\n        break;\n      }\n    }\n\n    if (pieces === undefined) {\n      resolved.push(...hardSplit(current.range, maxSize));\n      continue;\n    }\n\n    for (let index = pieces.length - 1; index >= 0; index -= 1) {\n      pending.push({ range: pieces[index] as TextRange, separatorIndex: nextSeparatorIndex });\n    }\n  }\n\n  return resolved;\n}\n\nfunction splitAfterSeparator(text: string, range: TextRange, separator: string): TextRange[] {\n  const ranges: TextRange[] = [];\n  let start = range.start;\n  let searchFrom = range.start;\n\n  while (searchFrom < range.end) {\n    const separatorStart = text.indexOf(separator, searchFrom);\n    if (separatorStart < 0 || separatorStart + separator.length > range.end) {\n      break;\n    }\n    const end = separatorStart + separator.length;\n    if (end > start) {\n      ranges.push({ start, end });\n    }\n    start = end;\n    searchFrom = end;\n  }\n\n  if (start < range.end) {\n    ranges.push({ start, end: range.end });\n  }\n  return ranges;\n}\n\nfunction hardSplit(range: TextRange, maxSize: number): readonly TextRange[] {\n  const ranges: TextRange[] = [];\n  for (let start = range.start; start < range.end; start += maxSize) {\n    ranges.push({ start, end: Math.min(start + maxSize, range.end) });\n  }\n  return ranges;\n}\n\nfunction applyRecursiveOverlap(\n  text: string,\n  ranges: readonly TextRange[],\n  maxSize: number,\n  overlap: number,\n): readonly TextChunk[] {\n  const boundaries = ranges.map((range) => range.end);\n  const chunks: TextChunk[] = [];\n  let start = 0;\n  let previousEnd = 0;\n\n  while (start < text.length) {\n    const limit = Math.min(start + maxSize, text.length);\n    const boundary = findLastBoundaryAtMost(boundaries, limit);\n    const end = boundary !== undefined && boundary > previousEnd ? boundary : limit;\n\n    chunks.push(createChunk(text, chunks.length, start, end));\n    if (end === text.length) {\n      break;\n    }\n    previousEnd = end;\n    start = Math.max(0, end - overlap);\n  }\n\n  return chunks;\n}\n\nfunction findLastBoundaryAtMost(boundaries: readonly number[], limit: number): number | undefined {\n  let low = 0;\n  let high = boundaries.length;\n  while (low < high) {\n    const middle = low + Math.floor((high - low) / 2);\n    if ((boundaries[middle] as number) <= limit) {\n      low = middle + 1;\n    } else {\n      high = middle;\n    }\n  }\n  return boundaries[low - 1];\n}\n\nfunction createChunk(text: string, index: number, start: number, end: number): TextChunk {\n  return { index, text: text.slice(start, end), start, end };\n}\n","export type PdfTextPage = Readonly<{\n  pageNumber: number;\n  text: string;\n}>;\n\nexport type ExtractPdfTextOptions = Readonly<{\n  data: Uint8Array;\n  abortSignal?: AbortSignal;\n}>;\n\nexport type ExtractPdfTextResult = Readonly<{\n  pages: readonly PdfTextPage[];\n}>;\n\nexport async function extractPdfText(\n  options: ExtractPdfTextOptions,\n): Promise<ExtractPdfTextResult> {\n  if (typeof options !== \"object\" || options === null) {\n    throw new TypeError(\"extractPdfText options must be an object\");\n  }\n  if (!(options.data instanceof Uint8Array)) {\n    throw new TypeError(\"extractPdfText data must be a Uint8Array\");\n  }\n  if (options.abortSignal !== undefined && !isAbortSignal(options.abortSignal)) {\n    throw new TypeError(\"extractPdfText abortSignal must be an AbortSignal\");\n  }\n\n  const { abortSignal } = options;\n  abortSignal?.throwIfAborted();\n  const data = new Uint8Array(options.data);\n  const pdfjs = await loadPdfjs();\n  abortSignal?.throwIfAborted();\n\n  const loadingTask = pdfjs.getDocument({ data });\n  let destroyPromise: Promise<void> | undefined;\n  const destroy = (): Promise<void> => {\n    destroyPromise ??= loadingTask.destroy();\n    return destroyPromise;\n  };\n  const abort = createAbortPromise(abortSignal, destroy);\n\n  return runWithCleanup(\n    async () => {\n      const document = await abort.wait(loadingTask.promise);\n      const pages: PdfTextPage[] = [];\n      for (let pageNumber = 1; pageNumber <= document.numPages; pageNumber += 1) {\n        abortSignal?.throwIfAborted();\n        const page = await abort.wait(document.getPage(pageNumber));\n        const content = await abort.wait(page.getTextContent());\n        pages.push({ pageNumber, text: extractPageText(content.items) });\n      }\n      return { pages };\n    },\n    async () => {\n      abort.dispose();\n      await destroy();\n    },\n  );\n}\n\nasync function loadPdfjs(): Promise<typeof import(\"pdfjs-dist/legacy/build/pdf.mjs\")> {\n  try {\n    return await import(\"pdfjs-dist/legacy/build/pdf.mjs\");\n  } catch (cause) {\n    if (!isMissingPdfjsDependency(cause)) {\n      throw cause;\n    }\n    throw new Error(\n      'PDF extraction requires the optional \"pdfjs-dist\" package. Install it in your application to use extractPdfText().',\n      { cause },\n    );\n  }\n}\n\nfunction isMissingPdfjsDependency(error: unknown): boolean {\n  const seen = new Set<unknown>();\n  let current = error;\n  while (current instanceof Error && !seen.has(current)) {\n    seen.add(current);\n    if (\n      current.message.includes(\"pdfjs-dist\") &&\n      \"code\" in current &&\n      current.code === \"ERR_MODULE_NOT_FOUND\"\n    ) {\n      return true;\n    }\n    current = \"cause\" in current ? current.cause : undefined;\n  }\n  return false;\n}\n\nasync function runWithCleanup<Result>(\n  operation: () => Promise<Result>,\n  cleanup: () => Promise<void>,\n): Promise<Result> {\n  let outcome: { ok: true; value: Result } | { ok: false; error: unknown };\n  try {\n    outcome = { ok: true, value: await operation() };\n  } catch (error) {\n    outcome = { ok: false, error };\n  }\n\n  let cleanupError: unknown;\n  let cleanupFailed = false;\n  try {\n    await cleanup();\n  } catch (error) {\n    cleanupFailed = true;\n    cleanupError = error;\n  }\n\n  if (!outcome.ok) {\n    if (cleanupFailed) {\n      throw new AggregateError(\n        [outcome.error, cleanupError],\n        \"PDF extraction and cleanup both failed\",\n        { cause: outcome.error },\n      );\n    }\n    throw outcome.error;\n  }\n  if (cleanupFailed) {\n    throw cleanupError;\n  }\n  return outcome.value;\n}\n\nfunction isAbortSignal(value: unknown): value is AbortSignal {\n  if (typeof value !== \"object\" || value === null) {\n    return false;\n  }\n  const candidate = value as Partial<AbortSignal>;\n  return (\n    typeof candidate.aborted === \"boolean\" &&\n    typeof candidate.addEventListener === \"function\" &&\n    typeof candidate.removeEventListener === \"function\" &&\n    typeof candidate.throwIfAborted === \"function\"\n  );\n}\n\nfunction extractPageText(items: readonly unknown[]): string {\n  let text = \"\";\n  for (const item of items) {\n    if (typeof item !== \"object\" || item === null) {\n      throw new TypeError(\"PDF text content contains a malformed item\");\n    }\n    if (!(\"str\" in item)) {\n      if (\n        \"type\" in item &&\n        (item.type === \"beginMarkedContent\" ||\n          item.type === \"beginMarkedContentProps\" ||\n          item.type === \"endMarkedContent\")\n      ) {\n        continue;\n      }\n      throw new TypeError(\"PDF text content contains an unknown non-text item\");\n    }\n    if (typeof item.str !== \"string\") {\n      throw new TypeError(\"PDF text content item str must be a string\");\n    }\n    if (!(\"hasEOL\" in item) || typeof item.hasEOL !== \"boolean\") {\n      throw new TypeError(\"PDF text content item hasEOL must be a boolean\");\n    }\n    text += item.str;\n    if (item.hasEOL) {\n      text += \"\\n\";\n    }\n  }\n  return text;\n}\n\nfunction createAbortPromise(\n  abortSignal: AbortSignal | undefined,\n  destroy: () => Promise<void>,\n): {\n  wait<T>(promise: Promise<T>): Promise<T>;\n  dispose(): void;\n} {\n  if (abortSignal === undefined) {\n    return {\n      wait: (promise) => promise,\n      dispose: () => undefined,\n    };\n  }\n\n  let rejectAbort: ((reason?: unknown) => void) | undefined;\n  const aborted = new Promise<never>((_resolve, reject) => {\n    rejectAbort = reject;\n  });\n  const onAbort = () => {\n    void destroy();\n    rejectAbort?.(\n      abortSignal.reason ?? new DOMException(\"The operation was aborted\", \"AbortError\"),\n    );\n  };\n  abortSignal.addEventListener(\"abort\", onAbort, { once: true });\n  if (abortSignal.aborted) {\n    onAbort();\n  }\n\n  return {\n    wait: (promise) => Promise.race([promise, aborted]),\n    dispose: () => abortSignal.removeEventListener(\"abort\", onAbort),\n  };\n}\n","import { chunkText } from \"./chunk-text\";\n\nexport type TextDocumentMetadata = Record<string, string | number | boolean>;\n\nexport type TextDocument<Metadata = TextDocumentMetadata> = Readonly<{\n  id: string;\n  text: string;\n  metadata?: Metadata | undefined;\n}>;\n\nexport type TextDocumentChunk<Metadata = TextDocumentMetadata> = Readonly<{\n  id: string;\n  documentId: string;\n  index: number;\n  text: string;\n  metadata?: Metadata | undefined;\n}>;\n\nexport type TextDocumentChunkingOptions =\n  | Readonly<{ strategy: \"none\" }>\n  | Readonly<{\n      strategy: \"fixed\";\n      maxSize: number;\n      overlap?: number | undefined;\n    }>\n  | Readonly<{\n      strategy: \"recursive\";\n      maxSize: number;\n      overlap?: number | undefined;\n      separators: readonly string[];\n    }>;\n\nexport type ChunkTextDocumentsOptions<Metadata = TextDocumentMetadata> = Readonly<{\n  documents: readonly TextDocument<Metadata>[];\n  chunking?: TextDocumentChunkingOptions | undefined;\n}>;\n\nexport function chunkTextDocuments<Metadata>(\n  options: ChunkTextDocumentsOptions<Metadata>,\n): readonly TextDocumentChunk<Metadata>[] {\n  if (typeof options !== \"object\" || options === null) {\n    throw new TypeError(\"chunkTextDocuments options must contain a documents array\");\n  }\n  const documents = options.documents;\n  if (!Array.isArray(documents)) {\n    throw new TypeError(\"chunkTextDocuments options must contain a documents array\");\n  }\n\n  const ids = new Set<string>();\n  const chunks: TextDocumentChunk<Metadata>[] = [];\n  for (const document of documents as readonly TextDocument<Metadata>[]) {\n    validateDocument(document, ids);\n    chunks.push(...chunkDocument(document, options.chunking));\n  }\n  return chunks;\n}\n\nfunction validateDocument<Metadata>(document: TextDocument<Metadata>, ids: Set<string>): void {\n  if (typeof document !== \"object\" || document === null) {\n    throw new TypeError(\"Text documents must be objects\");\n  }\n  if (typeof document.id !== \"string\" || document.id.length === 0) {\n    throw new TypeError(\"Text document ids must be non-empty strings\");\n  }\n  if (ids.has(document.id)) {\n    throw new TypeError(`Duplicate text document id: ${document.id}`);\n  }\n  if (typeof document.text !== \"string\" || document.text.length === 0) {\n    throw new TypeError(`Text document ${document.id} must contain non-empty text`);\n  }\n  ids.add(document.id);\n}\n\nfunction chunkDocument<Metadata>(\n  document: TextDocument<Metadata>,\n  chunking: TextDocumentChunkingOptions | undefined,\n): readonly TextDocumentChunk<Metadata>[] {\n  if (chunking === undefined || chunking.strategy === \"none\") {\n    return [createDocumentChunk(document, 0, document.text)];\n  }\n\n  const textChunks = chunkDocumentText(document.text, chunking);\n  return textChunks.map((chunk) => createDocumentChunk(document, chunk.index, chunk.text));\n}\n\nfunction chunkDocumentText(\n  text: string,\n  chunking: Exclude<TextDocumentChunkingOptions, Readonly<{ strategy: \"none\" }>>,\n) {\n  const overlap = chunking.overlap ?? 0;\n  if (chunking.strategy === \"fixed\") {\n    return chunkText({\n      text,\n      strategy: \"fixed\",\n      maxSize: chunking.maxSize,\n      overlap,\n    });\n  }\n  return chunkText({\n    text,\n    strategy: \"recursive\",\n    maxSize: chunking.maxSize,\n    overlap,\n    separators: chunking.separators,\n  });\n}\n\nfunction createDocumentChunk<Metadata>(\n  document: TextDocument<Metadata>,\n  index: number,\n  text: string,\n): TextDocumentChunk<Metadata> {\n  const chunk = {\n    id: `${document.id}:chunk:${index}`,\n    documentId: document.id,\n    index,\n    text,\n  };\n  if (document.metadata === undefined) {\n    return chunk;\n  }\n  return { ...chunk, metadata: document.metadata };\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-AR2K73CJ.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/observability/snapshot.ts","../src/observability/group.ts"],"sourcesContent":["export function observerSnapshot<T>(value: T): T {\n  if (containsError(value, new WeakSet<object>())) {\n    return cloneObserverFallback(value, new WeakMap<object, object>());\n  }\n  try {\n    return globalThis.structuredClone(value);\n  } catch {\n    return cloneObserverFallback(value, new WeakMap<object, object>());\n  }\n}\n\nfunction cloneObserverFallback<T>(value: T, seen: WeakMap<object, object>): T {\n  if (typeof value !== \"object\" || value === null) {\n    return value;\n  }\n  const existing = seen.get(value);\n  if (existing !== undefined) {\n    return existing as T;\n  }\n  if (Array.isArray(value)) {\n    const clone: unknown[] = [];\n    seen.set(value, clone);\n    clone.push(...value.map((item) => cloneObserverFallback(item, seen)));\n    return clone as T;\n  }\n  if (value instanceof Date) {\n    return new Date(value.getTime()) as T;\n  }\n  if (value instanceof Error) {\n    const clone = Object.create(Object.getPrototypeOf(value)) as Error;\n    seen.set(value, clone);\n    Object.defineProperties(clone, {\n      name: { configurable: true, writable: true, value: value.name },\n      message: { configurable: true, writable: true, value: value.message },\n    });\n    if (value.stack !== undefined) {\n      Object.defineProperty(clone, \"stack\", {\n        configurable: true,\n        writable: true,\n        value: value.stack,\n      });\n    }\n    if (value.cause !== undefined) {\n      Object.defineProperty(clone, \"cause\", {\n        configurable: true,\n        writable: true,\n        value: cloneObserverFallback(value.cause, seen),\n      });\n    }\n    for (const key of Object.getOwnPropertyNames(value)) {\n      if (key === \"name\" || key === \"message\" || key === \"stack\" || key === \"cause\") continue;\n      const descriptor = Object.getOwnPropertyDescriptor(value, key);\n      if (descriptor === undefined) continue;\n      if (\"value\" in descriptor) {\n        descriptor.value = cloneObserverFallback(descriptor.value, seen);\n      }\n      Object.defineProperty(clone, key, descriptor);\n    }\n    return clone as T;\n  }\n  if (Object.getPrototypeOf(value) !== Object.prototype) {\n    return value;\n  }\n  const clone: Record<string, unknown> = {};\n  seen.set(value, clone);\n  for (const [key, item] of Object.entries(value)) {\n    clone[key] = cloneObserverFallback(item, seen);\n  }\n  return clone as T;\n}\n\nfunction containsError(value: unknown, seen: WeakSet<object>): boolean {\n  if (typeof value !== \"object\" || value === null) return false;\n  if (value instanceof Error) return true;\n  if (seen.has(value)) return false;\n  seen.add(value);\n  if (Array.isArray(value)) {\n    return value.some((item) => containsError(item, seen));\n  }\n  if (Object.getPrototypeOf(value) !== Object.prototype) return false;\n  return Object.values(value).some((item) => containsError(item, seen));\n}\n","import { Usage } from \"../completion\";\nimport { observerSnapshot } from \"./snapshot\";\nimport type {\n  AgentGenerationEndArgs,\n  AgentGenerationErrorArgs,\n  AgentGenerationObserver,\n  AgentGenerationStartArgs,\n  AgentGenerationUpdateArgs,\n  AgentObserverErrorPolicy,\n  AgentObserverMap,\n  AgentRunEndArgs,\n  AgentRunErrorArgs,\n  AgentRunEventArgs,\n  AgentRunObserver,\n  AgentRunStartArgs,\n  AgentToolEndArgs,\n  AgentToolErrorArgs,\n  AgentToolObserver,\n  AgentToolStartArgs,\n  AgentToolStreamEventArgs,\n  AgentToolSuspendedArgs,\n  AgentTraceInfo,\n} from \"./types\";\n\nexport type AgentObserverFailure = {\n  readonly observer: string;\n  readonly error: unknown;\n};\n\nexport class AgentObserverDispatchError extends AggregateError {\n  readonly phase: string;\n  readonly failures: readonly AgentObserverFailure[];\n\n  constructor(phase: string, failures: readonly AgentObserverFailure[]) {\n    super(\n      failures.map((failure) => failure.error),\n      `Agent observer ${phase} failed for ${failures.map((failure) => failure.observer).join(\", \")}.`,\n    );\n    this.name = \"AgentObserverDispatchError\";\n    this.phase = phase;\n    this.failures = Object.freeze([...failures]);\n  }\n}\n\ntype NamedObserver<T> = {\n  readonly name: string;\n  readonly observer: T;\n};\n\ntype ActiveNamedObserver<T> = NamedObserver<T> & {\n  terminal: boolean;\n};\n\nexport async function startAgentRunObservers(\n  observers: AgentObserverMap,\n  args: AgentRunStartArgs,\n  options: {\n    readonly primaryTrace?: string | undefined;\n    readonly errorPolicy: AgentObserverErrorPolicy;\n  },\n): Promise<ActiveAgentRunObservers> {\n  const runObservers: ActiveNamedObserver<AgentRunObserver>[] = [];\n  const failures: AgentObserverFailure[] = [];\n  for (const [name, observer] of Object.entries(observers)) {\n    try {\n      const runObserver = await observer.startRun(observerSnapshot(args));\n      if (runObserver !== undefined) {\n        runObservers.push({ name, observer: runObserver, terminal: false });\n      }\n    } catch (error) {\n      failures.push({ observer: name, error });\n    }\n  }\n  if (options.errorPolicy === \"throw\" && failures.length > 0) {\n    const startupError = new AgentObserverDispatchError(\"startRun\", failures);\n    const cleanupFailures = await terminateObservers(runObservers, (observer) =>\n      observer.error?.(\n        observerSnapshot({\n          status: \"failed\",\n          error: startupError,\n          usage: Usage.empty(),\n          messages: [...args.history, args.prompt],\n        }),\n      ),\n    );\n    throw new AgentObserverDispatchError(\"startRun\", [...failures, ...cleanupFailures]);\n  }\n  return new ActiveAgentRunObservers(runObservers, options);\n}\n\nexport class ActiveAgentRunObservers {\n  readonly trace: AgentTraceInfo | undefined;\n\n  constructor(\n    private readonly runObservers: readonly ActiveNamedObserver<AgentRunObserver>[],\n    private readonly options: {\n      readonly primaryTrace?: string | undefined;\n      readonly errorPolicy: AgentObserverErrorPolicy;\n    },\n  ) {\n    const primary =\n      options.primaryTrace === undefined\n        ? undefined\n        : runObservers.find((entry) => entry.name === options.primaryTrace);\n    this.trace =\n      primary?.observer.trace === undefined\n        ? undefined\n        : Object.freeze({ observer: primary.name, ...primary.observer.trace });\n  }\n\n  async startGeneration(args: AgentGenerationStartArgs): Promise<ActiveGenerationObservers> {\n    const generationObservers: ActiveNamedObserver<AgentGenerationObserver>[] = [];\n    const failures: AgentObserverFailure[] = [];\n    for (const entry of this.runObservers) {\n      if (entry.observer.startGeneration === undefined) continue;\n      try {\n        const observer = await entry.observer.startGeneration(observerSnapshot(args));\n        if (observer !== undefined) {\n          generationObservers.push({ name: entry.name, observer, terminal: false });\n        }\n      } catch (error) {\n        failures.push({ observer: entry.name, error });\n      }\n    }\n    if (this.options.errorPolicy === \"throw\" && failures.length > 0) {\n      const startupError = new AgentObserverDispatchError(\"startGeneration\", failures);\n      const cleanupFailures = await terminateObservers(generationObservers, (observer) =>\n        observer.error?.(observerSnapshot({ turn: args.turn, error: startupError })),\n      );\n      throw new AgentObserverDispatchError(\"startGeneration\", [...failures, ...cleanupFailures]);\n    }\n    return new ActiveGenerationObservers(generationObservers, this.options.errorPolicy);\n  }\n\n  async startTool(args: AgentToolStartArgs): Promise<ActiveToolObservers> {\n    const toolObservers: ActiveNamedObserver<AgentToolObserver>[] = [];\n    const failures: AgentObserverFailure[] = [];\n    for (const entry of this.runObservers) {\n      if (entry.observer.startTool === undefined) continue;\n      try {\n        const observer = await entry.observer.startTool(observerSnapshot(args));\n        if (observer !== undefined) {\n          toolObservers.push({ name: entry.name, observer, terminal: false });\n        }\n      } catch (error) {\n        failures.push({ observer: entry.name, error });\n      }\n    }\n    if (this.options.errorPolicy === \"throw\" && failures.length > 0) {\n      const startupError = new AgentObserverDispatchError(\"startTool\", failures);\n      const cleanupFailures = await terminateObservers(toolObservers, (observer) =>\n        observer.error?.(observerSnapshot({ ...args, error: startupError })),\n      );\n      throw new AgentObserverDispatchError(\"startTool\", [...failures, ...cleanupFailures]);\n    }\n    return new ActiveToolObservers(toolObservers, this.options.errorPolicy);\n  }\n\n  async end(args: AgentRunEndArgs): Promise<void> {\n    await dispatchTerminalObservers(\n      this.runObservers,\n      \"end\",\n      (observer) => observer.end(observerSnapshot(args)),\n      this.options.errorPolicy,\n    );\n  }\n\n  async error(args: AgentRunErrorArgs): Promise<void> {\n    await dispatchTerminalObservers(\n      this.runObservers,\n      \"error\",\n      (observer) => observer.error?.(observerSnapshot(args)),\n      \"ignore\",\n    );\n  }\n\n  async event(args: AgentRunEventArgs): Promise<void> {\n    await dispatchObservers(\n      this.runObservers,\n      \"event\",\n      (observer) => observer.event?.(observerSnapshot(args)),\n      this.options.errorPolicy,\n    );\n  }\n}\n\nexport class ActiveGenerationObservers {\n  constructor(\n    private readonly observers: readonly ActiveNamedObserver<AgentGenerationObserver>[],\n    private readonly errorPolicy: AgentObserverErrorPolicy,\n  ) {}\n\n  async end(args: AgentGenerationEndArgs): Promise<void> {\n    await dispatchTerminalObservers(\n      this.observers,\n      \"generation.end\",\n      (observer) => observer.end(observerSnapshot(args)),\n      this.errorPolicy,\n    );\n  }\n\n  async error(args: AgentGenerationErrorArgs): Promise<void> {\n    await dispatchTerminalObservers(\n      this.observers,\n      \"generation.error\",\n      (observer) => observer.error?.(observerSnapshot(args)),\n      \"ignore\",\n    );\n  }\n\n  async update(args: AgentGenerationUpdateArgs): Promise<void> {\n    await dispatchObservers(\n      this.observers,\n      \"generation.update\",\n      (observer) => observer.update?.(observerSnapshot(args)),\n      this.errorPolicy,\n    );\n  }\n}\n\nexport class ActiveToolObservers {\n  constructor(\n    private readonly observers: readonly ActiveNamedObserver<AgentToolObserver>[],\n    private readonly errorPolicy: AgentObserverErrorPolicy,\n  ) {}\n\n  async streamEvent(args: AgentToolStreamEventArgs): Promise<void> {\n    await dispatchObservers(\n      this.observers,\n      \"tool.streamEvent\",\n      (observer) => observer.streamEvent?.(observerSnapshot(args)),\n      this.errorPolicy,\n    );\n  }\n\n  async end(args: AgentToolEndArgs): Promise<void> {\n    await dispatchTerminalObservers(\n      this.observers,\n      \"tool.end\",\n      (observer) => observer.end(observerSnapshot(args)),\n      this.errorPolicy,\n    );\n  }\n\n  async suspend(args: AgentToolSuspendedArgs): Promise<void> {\n    await dispatchTerminalObservers(\n      this.observers,\n      \"tool.suspend\",\n      (observer) => observer.suspend?.(observerSnapshot(args)),\n      this.errorPolicy,\n    );\n  }\n\n  async error(args: AgentToolErrorArgs): Promise<void> {\n    await dispatchTerminalObservers(\n      this.observers,\n      \"tool.error\",\n      (observer) => observer.error?.(observerSnapshot(args)),\n      \"ignore\",\n    );\n  }\n}\n\nasync function dispatchObservers<T>(\n  observers: readonly NamedObserver<T>[],\n  phase: string,\n  dispatch: (observer: T) => void | Promise<void> | undefined,\n  errorPolicy: AgentObserverErrorPolicy,\n): Promise<void> {\n  const failures: AgentObserverFailure[] = [];\n  for (const entry of observers) {\n    try {\n      await dispatch(entry.observer);\n    } catch (error) {\n      failures.push({ observer: entry.name, error });\n    }\n  }\n  throwObserverFailures(phase, failures, errorPolicy);\n}\n\nasync function dispatchTerminalObservers<T>(\n  observers: readonly ActiveNamedObserver<T>[],\n  phase: string,\n  dispatch: (observer: T) => void | Promise<void> | undefined,\n  errorPolicy: AgentObserverErrorPolicy,\n): Promise<void> {\n  const failures = await terminateObservers(observers, dispatch);\n  throwObserverFailures(phase, failures, errorPolicy);\n}\n\nasync function terminateObservers<T>(\n  observers: readonly ActiveNamedObserver<T>[],\n  dispatch: (observer: T) => void | Promise<void> | undefined,\n): Promise<AgentObserverFailure[]> {\n  const failures: AgentObserverFailure[] = [];\n  for (const entry of observers) {\n    if (entry.terminal) continue;\n    entry.terminal = true;\n    try {\n      await dispatch(entry.observer);\n    } catch (error) {\n      failures.push({ observer: entry.name, error });\n    }\n  }\n  return failures;\n}\n\nfunction throwObserverFailures(\n  phase: string,\n  failures: readonly AgentObserverFailure[],\n  errorPolicy: AgentObserverErrorPolicy,\n): void {\n  if (errorPolicy === \"throw\" && failures.length > 0) {\n    throw new AgentObserverDispatchError(phase, failures);\n  }\n}\n"],"mappings":";;;;;AAAO,SAAS,iBAAoB,OAAa;AAC/C,MAAI,cAAc,OAAO,oBAAI,QAAgB,CAAC,GAAG;AAC/C,WAAO,sBAAsB,OAAO,oBAAI,QAAwB,CAAC;AAAA,EACnE;AACA,MAAI;AACF,WAAO,WAAW,gBAAgB,KAAK;AAAA,EACzC,QAAQ;AACN,WAAO,sBAAsB,OAAO,oBAAI,QAAwB,CAAC;AAAA,EACnE;AACF;AAEA,SAAS,sBAAyB,OAAU,MAAkC;AAC5E,MAAI,OAAO,UAAU,YAAY,UAAU,MAAM;AAC/C,WAAO;AAAA,EACT;AACA,QAAM,WAAW,KAAK,IAAI,KAAK;AAC/B,MAAI,aAAa,QAAW;AAC1B,WAAO;AAAA,EACT;AACA,MAAI,MAAM,QAAQ,KAAK,GAAG;AACxB,UAAMA,SAAmB,CAAC;AAC1B,SAAK,IAAI,OAAOA,MAAK;AACrB,IAAAA,OAAM,KAAK,GAAG,MAAM,IAAI,CAAC,SAAS,sBAAsB,MAAM,IAAI,CAAC,CAAC;AACpE,WAAOA;AAAA,EACT;AACA,MAAI,iBAAiB,MAAM;AACzB,WAAO,IAAI,KAAK,MAAM,QAAQ,CAAC;AAAA,EACjC;AACA,MAAI,iBAAiB,OAAO;AAC1B,UAAMA,SAAQ,OAAO,OAAO,OAAO,eAAe,KAAK,CAAC;AACxD,SAAK,IAAI,OAAOA,MAAK;AACrB,WAAO,iBAAiBA,QAAO;AAAA,MAC7B,MAAM,EAAE,cAAc,MAAM,UAAU,MAAM,OAAO,MAAM,KAAK;AAAA,MAC9D,SAAS,EAAE,cAAc,MAAM,UAAU,MAAM,OAAO,MAAM,QAAQ;AAAA,IACtE,CAAC;AACD,QAAI,MAAM,UAAU,QAAW;AAC7B,aAAO,eAAeA,QAAO,SAAS;AAAA,QACpC,cAAc;AAAA,QACd,UAAU;AAAA,QACV,OAAO,MAAM;AAAA,MACf,CAAC;AAAA,IACH;AACA,QAAI,MAAM,UAAU,QAAW;AAC7B,aAAO,eAAeA,QAAO,SAAS;AAAA,QACpC,cAAc;AAAA,QACd,UAAU;AAAA,QACV,OAAO,sBAAsB,MAAM,OAAO,IAAI;AAAA,MAChD,CAAC;AAAA,IACH;AACA,eAAW,OAAO,OAAO,oBAAoB,KAAK,GAAG;AACnD,UAAI,QAAQ,UAAU,QAAQ,aAAa,QAAQ,WAAW,QAAQ,QAAS;AAC/E,YAAM,aAAa,OAAO,yBAAyB,OAAO,GAAG;AAC7D,UAAI,eAAe,OAAW;AAC9B,UAAI,WAAW,YAAY;AACzB,mBAAW,QAAQ,sBAAsB,WAAW,OAAO,IAAI;AAAA,MACjE;AACA,aAAO,eAAeA,QAAO,KAAK,UAAU;AAAA,IAC9C;AACA,WAAOA;AAAA,EACT;AACA,MAAI,OAAO,eAAe,KAAK,MAAM,OAAO,WAAW;AACrD,WAAO;AAAA,EACT;AACA,QAAM,QAAiC,CAAC;AACxC,OAAK,IAAI,OAAO,KAAK;AACrB,aAAW,CAAC,KAAK,IAAI,KAAK,OAAO,QAAQ,KAAK,GAAG;AAC/C,UAAM,GAAG,IAAI,sBAAsB,MAAM,IAAI;AAAA,EAC/C;AACA,SAAO;AACT;AAEA,SAAS,cAAc,OAAgB,MAAgC;AACrE,MAAI,OAAO,UAAU,YAAY,UAAU,KAAM,QAAO;AACxD,MAAI,iBAAiB,MAAO,QAAO;AACnC,MAAI,KAAK,IAAI,KAAK,EAAG,QAAO;AAC5B,OAAK,IAAI,KAAK;AACd,MAAI,MAAM,QAAQ,KAAK,GAAG;AACxB,WAAO,MAAM,KAAK,CAAC,SAAS,cAAc,MAAM,IAAI,CAAC;AAAA,EACvD;AACA,MAAI,OAAO,eAAe,KAAK,MAAM,OAAO,UAAW,QAAO;AAC9D,SAAO,OAAO,OAAO,KAAK,EAAE,KAAK,CAAC,SAAS,cAAc,MAAM,IAAI,CAAC;AACtE;;;ACpDO,IAAM,6BAAN,cAAyC,eAAe;AAAA,EACpD;AAAA,EACA;AAAA,EAET,YAAY,OAAe,UAA2C;AACpE;AAAA,MACE,SAAS,IAAI,CAAC,YAAY,QAAQ,KAAK;AAAA,MACvC,kBAAkB,KAAK,eAAe,SAAS,IAAI,CAAC,YAAY,QAAQ,QAAQ,EAAE,KAAK,IAAI,CAAC;AAAA,IAC9F;AACA,SAAK,OAAO;AACZ,SAAK,QAAQ;AACb,SAAK,WAAW,OAAO,OAAO,CAAC,GAAG,QAAQ,CAAC;AAAA,EAC7C;AACF;AAWA,eAAsB,uBACpB,WACA,MACA,SAIkC;AAClC,QAAM,eAAwD,CAAC;AAC/D,QAAM,WAAmC,CAAC;AAC1C,aAAW,CAAC,MAAM,QAAQ,KAAK,OAAO,QAAQ,SAAS,GAAG;AACxD,QAAI;AACF,YAAM,cAAc,MAAM,SAAS,SAAS,iBAAiB,IAAI,CAAC;AAClE,UAAI,gBAAgB,QAAW;AAC7B,qBAAa,KAAK,EAAE,MAAM,UAAU,aAAa,UAAU,MAAM,CAAC;AAAA,MACpE;AAAA,IACF,SAAS,OAAO;AACd,eAAS,KAAK,EAAE,UAAU,MAAM,MAAM,CAAC;AAAA,IACzC;AAAA,EACF;AACA,MAAI,QAAQ,gBAAgB,WAAW,SAAS,SAAS,GAAG;AAC1D,UAAM,eAAe,IAAI,2BAA2B,YAAY,QAAQ;AACxE,UAAM,kBAAkB,MAAM;AAAA,MAAmB;AAAA,MAAc,CAAC,aAC9D,SAAS;AAAA,QACP,iBAAiB;AAAA,UACf,QAAQ;AAAA,UACR,OAAO;AAAA,UACP,OAAO,MAAM,MAAM;AAAA,UACnB,UAAU,CAAC,GAAG,KAAK,SAAS,KAAK,MAAM;AAAA,QACzC,CAAC;AAAA,MACH;AAAA,IACF;AACA,UAAM,IAAI,2BAA2B,YAAY,CAAC,GAAG,UAAU,GAAG,eAAe,CAAC;AAAA,EACpF;AACA,SAAO,IAAI,wBAAwB,cAAc,OAAO;AAC1D;AAEO,IAAM,0BAAN,MAA8B;AAAA,EAGnC,YACmB,cACA,SAIjB;AALiB;AACA;AAKjB,UAAM,UACJ,QAAQ,iBAAiB,SACrB,SACA,aAAa,KAAK,CAAC,UAAU,MAAM,SAAS,QAAQ,YAAY;AACtE,SAAK,QACH,SAAS,SAAS,UAAU,SACxB,SACA,OAAO,OAAO,EAAE,UAAU,QAAQ,MAAM,GAAG,QAAQ,SAAS,MAAM,CAAC;AAAA,EAC3E;AAAA,EAdmB;AAAA,EACA;AAAA,EAJV;AAAA,EAmBT,MAAM,gBAAgB,MAAoE;AACxF,UAAM,sBAAsE,CAAC;AAC7E,UAAM,WAAmC,CAAC;AAC1C,eAAW,SAAS,KAAK,cAAc;AACrC,UAAI,MAAM,SAAS,oBAAoB,OAAW;AAClD,UAAI;AACF,cAAM,WAAW,MAAM,MAAM,SAAS,gBAAgB,iBAAiB,IAAI,CAAC;AAC5E,YAAI,aAAa,QAAW;AAC1B,8BAAoB,KAAK,EAAE,MAAM,MAAM,MAAM,UAAU,UAAU,MAAM,CAAC;AAAA,QAC1E;AAAA,MACF,SAAS,OAAO;AACd,iBAAS,KAAK,EAAE,UAAU,MAAM,MAAM,MAAM,CAAC;AAAA,MAC/C;AAAA,IACF;AACA,QAAI,KAAK,QAAQ,gBAAgB,WAAW,SAAS,SAAS,GAAG;AAC/D,YAAM,eAAe,IAAI,2BAA2B,mBAAmB,QAAQ;AAC/E,YAAM,kBAAkB,MAAM;AAAA,QAAmB;AAAA,QAAqB,CAAC,aACrE,SAAS,QAAQ,iBAAiB,EAAE,MAAM,KAAK,MAAM,OAAO,aAAa,CAAC,CAAC;AAAA,MAC7E;AACA,YAAM,IAAI,2BAA2B,mBAAmB,CAAC,GAAG,UAAU,GAAG,eAAe,CAAC;AAAA,IAC3F;AACA,WAAO,IAAI,0BAA0B,qBAAqB,KAAK,QAAQ,WAAW;AAAA,EACpF;AAAA,EAEA,MAAM,UAAU,MAAwD;AACtE,UAAM,gBAA0D,CAAC;AACjE,UAAM,WAAmC,CAAC;AAC1C,eAAW,SAAS,KAAK,cAAc;AACrC,UAAI,MAAM,SAAS,cAAc,OAAW;AAC5C,UAAI;AACF,cAAM,WAAW,MAAM,MAAM,SAAS,UAAU,iBAAiB,IAAI,CAAC;AACtE,YAAI,aAAa,QAAW;AAC1B,wBAAc,KAAK,EAAE,MAAM,MAAM,MAAM,UAAU,UAAU,MAAM,CAAC;AAAA,QACpE;AAAA,MACF,SAAS,OAAO;AACd,iBAAS,KAAK,EAAE,UAAU,MAAM,MAAM,MAAM,CAAC;AAAA,MAC/C;AAAA,IACF;AACA,QAAI,KAAK,QAAQ,gBAAgB,WAAW,SAAS,SAAS,GAAG;AAC/D,YAAM,eAAe,IAAI,2BAA2B,aAAa,QAAQ;AACzE,YAAM,kBAAkB,MAAM;AAAA,QAAmB;AAAA,QAAe,CAAC,aAC/D,SAAS,QAAQ,iBAAiB,EAAE,GAAG,MAAM,OAAO,aAAa,CAAC,CAAC;AAAA,MACrE;AACA,YAAM,IAAI,2BAA2B,aAAa,CAAC,GAAG,UAAU,GAAG,eAAe,CAAC;AAAA,IACrF;AACA,WAAO,IAAI,oBAAoB,eAAe,KAAK,QAAQ,WAAW;AAAA,EACxE;AAAA,EAEA,MAAM,IAAI,MAAsC;AAC9C,UAAM;AAAA,MACJ,KAAK;AAAA,MACL;AAAA,MACA,CAAC,aAAa,SAAS,IAAI,iBAAiB,IAAI,CAAC;AAAA,MACjD,KAAK,QAAQ;AAAA,IACf;AAAA,EACF;AAAA,EAEA,MAAM,MAAM,MAAwC;AAClD,UAAM;AAAA,MACJ,KAAK;AAAA,MACL;AAAA,MACA,CAAC,aAAa,SAAS,QAAQ,iBAAiB,IAAI,CAAC;AAAA,MACrD;AAAA,IACF;AAAA,EACF;AAAA,EAEA,MAAM,MAAM,MAAwC;AAClD,UAAM;AAAA,MACJ,KAAK;AAAA,MACL;AAAA,MACA,CAAC,aAAa,SAAS,QAAQ,iBAAiB,IAAI,CAAC;AAAA,MACrD,KAAK,QAAQ;AAAA,IACf;AAAA,EACF;AACF;AAEO,IAAM,4BAAN,MAAgC;AAAA,EACrC,YACmB,WACA,aACjB;AAFiB;AACA;AAAA,EAChB;AAAA,EAFgB;AAAA,EACA;AAAA,EAGnB,MAAM,IAAI,MAA6C;AACrD,UAAM;AAAA,MACJ,KAAK;AAAA,MACL;AAAA,MACA,CAAC,aAAa,SAAS,IAAI,iBAAiB,IAAI,CAAC;AAAA,MACjD,KAAK;AAAA,IACP;AAAA,EACF;AAAA,EAEA,MAAM,MAAM,MAA+C;AACzD,UAAM;AAAA,MACJ,KAAK;AAAA,MACL;AAAA,MACA,CAAC,aAAa,SAAS,QAAQ,iBAAiB,IAAI,CAAC;AAAA,MACrD;AAAA,IACF;AAAA,EACF;AAAA,EAEA,MAAM,OAAO,MAAgD;AAC3D,UAAM;AAAA,MACJ,KAAK;AAAA,MACL;AAAA,MACA,CAAC,aAAa,SAAS,SAAS,iBAAiB,IAAI,CAAC;AAAA,MACtD,KAAK;AAAA,IACP;AAAA,EACF;AACF;AAEO,IAAM,sBAAN,MAA0B;AAAA,EAC/B,YACmB,WACA,aACjB;AAFiB;AACA;AAAA,EAChB;AAAA,EAFgB;AAAA,EACA;AAAA,EAGnB,MAAM,YAAY,MAA+C;AAC/D,UAAM;AAAA,MACJ,KAAK;AAAA,MACL;AAAA,MACA,CAAC,aAAa,SAAS,cAAc,iBAAiB,IAAI,CAAC;AAAA,MAC3D,KAAK;AAAA,IACP;AAAA,EACF;AAAA,EAEA,MAAM,IAAI,MAAuC;AAC/C,UAAM;AAAA,MACJ,KAAK;AAAA,MACL;AAAA,MACA,CAAC,aAAa,SAAS,IAAI,iBAAiB,IAAI,CAAC;AAAA,MACjD,KAAK;AAAA,IACP;AAAA,EACF;AAAA,EAEA,MAAM,QAAQ,MAA6C;AACzD,UAAM;AAAA,MACJ,KAAK;AAAA,MACL;AAAA,MACA,CAAC,aAAa,SAAS,UAAU,iBAAiB,IAAI,CAAC;AAAA,MACvD,KAAK;AAAA,IACP;AAAA,EACF;AAAA,EAEA,MAAM,MAAM,MAAyC;AACnD,UAAM;AAAA,MACJ,KAAK;AAAA,MACL;AAAA,MACA,CAAC,aAAa,SAAS,QAAQ,iBAAiB,IAAI,CAAC;AAAA,MACrD;AAAA,IACF;AAAA,EACF;AACF;AAEA,eAAe,kBACb,WACA,OACA,UACA,aACe;AACf,QAAM,WAAmC,CAAC;AAC1C,aAAW,SAAS,WAAW;AAC7B,QAAI;AACF,YAAM,SAAS,MAAM,QAAQ;AAAA,IAC/B,SAAS,OAAO;AACd,eAAS,KAAK,EAAE,UAAU,MAAM,MAAM,MAAM,CAAC;AAAA,IAC/C;AAAA,EACF;AACA,wBAAsB,OAAO,UAAU,WAAW;AACpD;AAEA,eAAe,0BACb,WACA,OACA,UACA,aACe;AACf,QAAM,WAAW,MAAM,mBAAmB,WAAW,QAAQ;AAC7D,wBAAsB,OAAO,UAAU,WAAW;AACpD;AAEA,eAAe,mBACb,WACA,UACiC;AACjC,QAAM,WAAmC,CAAC;AAC1C,aAAW,SAAS,WAAW;AAC7B,QAAI,MAAM,SAAU;AACpB,UAAM,WAAW;AACjB,QAAI;AACF,YAAM,SAAS,MAAM,QAAQ;AAAA,IAC/B,SAAS,OAAO;AACd,eAAS,KAAK,EAAE,UAAU,MAAM,MAAM,MAAM,CAAC;AAAA,IAC/C;AAAA,EACF;AACA,SAAO;AACT;AAEA,SAAS,sBACP,OACA,UACA,aACM;AACN,MAAI,gBAAgB,WAAW,SAAS,SAAS,GAAG;AAClD,UAAM,IAAI,2BAA2B,OAAO,QAAQ;AAAA,EACtD;AACF;","names":["clone"]}