@anvia/core 0.26.0 → 1.0.0-rc.1

package/dist/pipeline/index.js

@@ -1,12 +1,25 @@
+import {
+  cancelAgentApproval
+} from "../chunk-IL3ZSNJI.js";
+import "../chunk-YK4WAAS4.js";
+import "../chunk-6WGGTJE6.js";
+import "../chunk-R2LJSQUW.js";
+import "../chunk-5XKDW36Z.js";
 import {
   mapWithConcurrency
-} from "../chunk-OIMLU4SF.js";
+} from "../chunk-DZ3CKYTH.js";
+import "../chunk-I6G7BC42.js";
+import "../chunk-M3IOWB4Y.js";
+import "../chunk-RFDVKCIE.js";
+import "../chunk-ADH7NNCS.js";
+import "../chunk-A3UBYTJT.js";
+import "../chunk-FNQB2JEH.js";
 
-// src/pipeline/builder.ts
+// src/pipeline/pipeline.ts
 import { z } from "zod";
 
 // src/pipeline/graph.ts
-function initialBuilderState(metadata) {
+function initialPipelineState(metadata) {
   return {
     graph: initialGraph(metadata),
     terminalNodeId: "input",
@@ -16,7 +29,7 @@ function initialBuilderState(metadata) {
   };
 }
 function initialGraph(metadata) {
-  const id = normalizeId(metadata.id ?? "pipeline");
+  const id = metadata.id ?? "pipeline";
   const graph = {
     id,
     nodes: [{ id: "input", kind: "input", label: "Input" }],
@@ -151,35 +164,6 @@ function uniqueGraphNodeId(baseId, existingIds) {
   return id;
 }
 
-// src/pipeline/pipeline.ts
-var Pipeline = class {
-  constructor(executor, pipelineGraph = initialGraph({})) {
-    this.executor = executor;
-    this.pipelineGraph = pipelineGraph;
-    this.id = pipelineGraph.id;
-    this.name = pipelineGraph.name;
-    this.description = pipelineGraph.description;
-    this.metadata = pipelineGraph.metadata;
-  }
-  executor;
-  pipelineGraph;
-  id;
-  name;
-  description;
-  metadata;
-  /** Run one input through the built pipeline and return the final stage output. */
-  async run(input, options = {}) {
-    return await this.executor(input, { observer: options.observer });
-  }
-  /** Run many inputs through the same pipeline with bounded concurrency. */
-  async batch(inputs, options) {
-    return mapWithConcurrency([...inputs], options.concurrency, (input) => this.run(input));
-  }
-  graph() {
-    return cloneGraph(this.pipelineGraph);
-  }
-};
-
 // src/pipeline/runtime.ts
 async function runNode(context, node, fn) {
   const startedAt = Date.now();
@@ -203,31 +187,38 @@ async function runNode(context, node, fn) {
   }
 }
 
-// src/pipeline/builder.ts
-var PipelineBuilder = class _PipelineBuilder {
+// src/pipeline/pipeline.ts
+var internalPipelineOptions = /* @__PURE__ */ Symbol("internal-pipeline-options");
+var Pipeline = class _Pipeline {
+  id;
+  name;
+  description;
+  metadata;
   executor;
   state;
-  constructor(metadataOrExecutor, stateOrMetadata) {
-    if (stateOrMetadata !== void 0 && isBuilderState(stateOrMetadata)) {
-      this.executor = metadataOrExecutor;
-      this.state = stateOrMetadata;
-      return;
-    }
-    if (typeof metadataOrExecutor === "function") {
-      const executor = metadataOrExecutor;
-      this.executor = ((input) => executor(input));
-      this.state = initialBuilderState({});
-      return;
-    }
-    if (isZodSchema(metadataOrExecutor)) {
-      const schema = metadataOrExecutor;
-      const metadata = stateOrMetadata !== void 0 && isPipelineMetadata(stateOrMetadata) ? stateOrMetadata : {};
-      this.executor = ((input) => schema.parse(input));
-      this.state = initialBuilderState(metadata);
-      return;
+  constructor(options) {
+    if (isInternalPipelineOptions(options)) {
+      this.executor = options[internalPipelineOptions].executor;
+      this.state = options[internalPipelineOptions].state;
+    } else {
+      const id = normalizePipelineId(options.id);
+      if (!isZodSchema(options.inputSchema)) {
+        throw new TypeError("Pipeline inputSchema must be a Zod schema.");
+      }
+      const inputSchema = options.inputSchema;
+      this.executor = ((input) => inputSchema.parse(input));
+      this.state = initialPipelineState({
+        id,
+        name: options.name,
+        description: options.description,
+        metadata: options.metadata
+      });
     }
-    this.executor = identity;
-    this.state = initialBuilderState(metadataOrExecutor ?? {});
+    const graph = this.state.graph;
+    this.id = graph.id;
+    this.name = graph.name;
+    this.description = graph.description;
+    this.metadata = graph.metadata;
   }
   /** Add a synchronous or asynchronous transform stage. */
   step(fn, metadata) {
@@ -241,18 +232,15 @@ var PipelineBuilder = class _PipelineBuilder {
         preferredId: metadata?.id
       }
     );
-    return new _PipelineBuilder(
-      async (input, context) => {
-        const value = await this.runStep(input, context);
-        const result = await runNode(context, next.node, () => fn(value));
-        return result;
-      },
-      next.state
-    );
+    return this.derive(async (input, context) => {
+      const value = await this.runStep(input, context);
+      const result = await runNode(context, next.node, () => fn(value));
+      return result;
+    }, next.state);
   }
   /** Compose another pipeline operation after the current stage. */
   use(op, metadata) {
-    const nested = op instanceof Pipeline ? op : void 0;
+    const nested = op instanceof _Pipeline ? op : void 0;
     const next = appendNode(
       this.state,
       nested === void 0 ? "step" : "pipeline",
@@ -264,14 +252,11 @@ var PipelineBuilder = class _PipelineBuilder {
         pipelineId: nested?.id
       }
     );
-    return new _PipelineBuilder(
-      async (input, context) => {
-        const value = await this.runStep(input, context);
-        const result = await runNode(context, next.node, () => op.run(value));
-        return result;
-      },
-      next.state
-    );
+    return this.derive(async (input, context) => {
+      const value = await this.runStep(input, context);
+      const result = await runNode(context, next.node, () => op.run(value));
+      return result;
+    }, next.state);
   }
   /** Run named branch operations concurrently from the current value. */
   parallel(branches, metadata) {
@@ -298,7 +283,7 @@ var PipelineBuilder = class _PipelineBuilder {
       nextState,
       Object.values(branchNodes).map((node) => node.id)
     );
-    return new _PipelineBuilder(async (input, context) => {
+    return this.derive(async (input, context) => {
       const value = await this.runStep(input, context);
       const entries = await runNode(
         context,
@@ -315,7 +300,7 @@ var PipelineBuilder = class _PipelineBuilder {
     }, nextState);
   }
   /** Send the current value to an agent as text and continue with the agent output. */
-  prompt(agent, metadata) {
+  agent(agent, metadata) {
     const next = appendNode(this.state, "agent", metadata?.name ?? agent.name ?? agent.id, {
       description: metadata?.description ?? agent.description,
       metadata: metadata?.metadata,
@@ -323,10 +308,17 @@ var PipelineBuilder = class _PipelineBuilder {
       agentId: agent.id,
       agentName: agent.name
     });
-    return new _PipelineBuilder(async (input, context) => {
+    return this.derive(async (input, context) => {
       const value = await this.runStep(input, context);
       return runNode(context, next.node, async () => {
-        const response = await agent.prompt(String(value)).send();
+        const response = await agent.generate(String(value));
+        if (response.status === "approval_required") {
+          await cancelAgentApproval(
+            response,
+            "Pipeline agent stages cannot suspend for tool approval."
+          );
+          throw new Error("Pipeline agent stages cannot suspend for tool approval.");
+        }
         return response.output;
       });
     }, next.state);
@@ -343,45 +335,53 @@ var PipelineBuilder = class _PipelineBuilder {
         preferredId: metadata?.id
       }
     );
-    return new _PipelineBuilder(async (input, context) => {
+    return this.derive(async (input, context) => {
       const value = await this.runStep(input, context);
       return runNode(context, next.node, () => extractor.extract(String(value)));
     }, next.state);
   }
-  /** Finish the builder and return a runnable pipeline. */
-  build() {
-    const graph = withOutputNode(this.state);
-    return new Pipeline(
-      (input, context) => this.runStep(input, context),
-      graph
-    );
+  /** Run one input through the pipeline and return the final stage output. */
+  async run(input, options = {}) {
+    return this.runStep(input, { observer: options.observer });
+  }
+  /** Run many inputs through the same pipeline with bounded concurrency. */
+  async batch(inputs, options) {
+    return mapWithConcurrency([...inputs], options.concurrency, (input) => this.run(input));
+  }
+  /** Return an isolated graph snapshot for the current pipeline stages. */
+  graph() {
+    return cloneGraph(withOutputNode(this.state));
+  }
+  derive(executor, state) {
+    return createDerivedPipeline(executor, state);
   }
   async runStep(input, context) {
     return await this.executor(input, context);
   }
 };
-function identity(input) {
-  return input;
+function createDerivedPipeline(executor, state) {
+  const options = {
+    [internalPipelineOptions]: { executor, state }
+  };
+  return new Pipeline(options);
+}
+function isInternalPipelineOptions(options) {
+  return internalPipelineOptions in options;
 }
 function isZodSchema(value) {
   return value instanceof z.ZodType;
 }
-function isBuilderState(value) {
-  if (typeof value !== "object" || value === null || Array.isArray(value)) {
-    return false;
+function normalizePipelineId(id) {
+  if (typeof id !== "string") {
+    throw new TypeError("Pipeline id must be a string.");
   }
-  const candidate = value;
-  return "graph" in candidate && "terminalNodeId" in candidate && "terminalNodeIds" in candidate && "nextNodeIndex" in candidate && "nextEdgeIndex" in candidate;
-}
-function isPipelineMetadata(value) {
-  if (typeof value !== "object" || value === null || Array.isArray(value)) {
-    return false;
+  const normalized = id.trim();
+  if (normalized.length === 0) {
+    throw new TypeError("Pipeline id must be a non-empty string.");
   }
-  const candidate = value;
-  return "id" in candidate || "name" in candidate || "description" in candidate || "metadata" in candidate;
+  return normalized;
 }
 export {
-  Pipeline,
-  PipelineBuilder
+  Pipeline
 };
 //# sourceMappingURL=index.js.map

package/dist/pipeline/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/pipeline/builder.ts","../../src/pipeline/graph.ts","../../src/pipeline/pipeline.ts","../../src/pipeline/runtime.ts"],"sourcesContent":["import { z } from \"zod\";\nimport type { Agent } from \"../agent/agent\";\nimport type { CompletionModel } from \"../completion\";\nimport type { Extractor } from \"../extractor\";\nimport {\n  appendChildNode,\n  appendNode,\n  initialBuilderState,\n  nextStageLabel,\n  withOutputNode,\n  withTerminalNodes,\n} from \"./graph\";\nimport { Pipeline } from \"./pipeline\";\nimport { runNode } from \"./runtime\";\nimport type {\n  ParallelOutput,\n  PipelineBuilderState,\n  PipelineExecutor,\n  PipelineGraphNode,\n  PipelineMetadata,\n  PipelineOp,\n  PipelineRunContext,\n  PipelineStageMetadata,\n} from \"./types\";\n\n/** Builds a typed pipeline from an original input type to an inferred output type. */\nexport class PipelineBuilder<Input, Output = Input> {\n  private readonly executor: PipelineExecutor<Input, Output>;\n  private readonly state: PipelineBuilderState;\n\n  constructor(schema: z.ZodType<Output, Input>);\n  constructor(schema: z.ZodType<Output, Input>, metadata: PipelineMetadata);\n  constructor(executor: (input: Input) => Output | Promise<Output>);\n  constructor(executor: PipelineExecutor<Input, Output>, state: PipelineBuilderState);\n  constructor(\n    metadataOrExecutor?:\n      | PipelineMetadata\n      | z.ZodType\n      | ((input: Input) => Output | Promise<Output>)\n      | PipelineExecutor<Input, Output>,\n    stateOrMetadata?: PipelineBuilderState | PipelineMetadata,\n  ) {\n    if (stateOrMetadata !== undefined && isBuilderState(stateOrMetadata)) {\n      this.executor = metadataOrExecutor as PipelineExecutor<Input, Output>;\n      this.state = stateOrMetadata;\n      return;\n    }\n\n    if (typeof metadataOrExecutor === \"function\") {\n      const executor = metadataOrExecutor as (input: Input) => Output | Promise<Output>;\n      this.executor = ((input) => executor(input)) as PipelineExecutor<Input, Output>;\n      this.state = initialBuilderState({});\n      return;\n    }\n\n    if (isZodSchema(metadataOrExecutor)) {\n      const schema = metadataOrExecutor;\n      const metadata: PipelineMetadata =\n        stateOrMetadata !== undefined && isPipelineMetadata(stateOrMetadata) ? stateOrMetadata : {};\n      this.executor = ((input) => schema.parse(input)) as PipelineExecutor<Input, Output>;\n      this.state = initialBuilderState(metadata);\n      return;\n    }\n\n    this.executor = identity as PipelineExecutor<Input, Output>;\n    this.state = initialBuilderState((metadataOrExecutor as PipelineMetadata | undefined) ?? {});\n  }\n\n  /** Add a synchronous or asynchronous transform stage. */\n  step<Next>(\n    fn: (input: Awaited<Output>) => Next | Promise<Next>,\n    metadata?: PipelineStageMetadata,\n  ): PipelineBuilder<Input, Awaited<Next>> {\n    const next = appendNode(\n      this.state,\n      \"step\",\n      metadata?.name ?? nextStageLabel(this.state, \"Step\"),\n      {\n        description: metadata?.description,\n        metadata: metadata?.metadata,\n        preferredId: metadata?.id,\n      },\n    );\n    return new PipelineBuilder<Input, Awaited<Next>>(\n      async (input, context): Promise<Awaited<Next>> => {\n        const value = await this.runStep(input, context);\n        const result = await runNode(context, next.node, () => fn(value));\n        return result as Awaited<Next>;\n      },\n      next.state,\n    );\n  }\n\n  /** Compose another pipeline operation after the current stage. */\n  use<Next>(\n    op: PipelineOp<Awaited<Output>, Next>,\n    metadata?: PipelineStageMetadata,\n  ): PipelineBuilder<Input, Awaited<Next>> {\n    const nested = op instanceof Pipeline ? op : undefined;\n    const next = appendNode(\n      this.state,\n      nested === undefined ? \"step\" : \"pipeline\",\n      metadata?.name ??\n        nested?.name ??\n        nested?.id ??\n        nextStageLabel(this.state, nested === undefined ? \"Operation\" : \"Pipeline\"),\n      {\n        description: metadata?.description ?? nested?.description,\n        metadata: metadata?.metadata ?? nested?.metadata,\n        preferredId: metadata?.id,\n        pipelineId: nested?.id,\n      },\n    );\n    return new PipelineBuilder<Input, Awaited<Next>>(\n      async (input, context): Promise<Awaited<Next>> => {\n        const value = await this.runStep(input, context);\n        const result = await runNode(context, next.node, () => op.run(value));\n        return result as Awaited<Next>;\n      },\n      next.state,\n    );\n  }\n\n  /** Run named branch operations concurrently from the current value. */\n  parallel<Branches extends Record<string, PipelineOp<Awaited<Output>, unknown>>>(\n    branches: Branches,\n    metadata?: PipelineStageMetadata,\n  ): PipelineBuilder<Input, ParallelOutput<Branches>> {\n    const parallel = appendNode(\n      this.state,\n      \"parallel\",\n      metadata?.name ?? `${Object.keys(branches).length} parallel branches`,\n      {\n        description: metadata?.description,\n        metadata: metadata?.metadata,\n        preferredId: metadata?.id,\n      },\n    );\n    let nextState = parallel.state;\n    const branchNodes: Record<string, PipelineGraphNode> = {};\n    for (const key of Object.keys(branches)) {\n      const branch = appendChildNode(nextState, parallel.node.id, \"branch\", key, {\n        branchKey: key,\n      });\n      nextState = branch.state;\n      branchNodes[key] = branch.node;\n    }\n    nextState = withTerminalNodes(\n      nextState,\n      Object.values(branchNodes).map((node) => node.id),\n    );\n\n    return new PipelineBuilder<Input, ParallelOutput<Branches>>(async (input, context) => {\n      const value = await this.runStep(input, context);\n      const entries = await runNode(context, parallel.node, () =>\n        Promise.all(\n          Object.entries(branches).map(async ([key, op]) => {\n            const node = branchNodes[key] as PipelineGraphNode;\n            const output = await runNode(context, node, () => op.run(value));\n            return [key, output] as const;\n          }),\n        ),\n      );\n      return Object.fromEntries(entries) as ParallelOutput<Branches>;\n    }, nextState);\n  }\n\n  /** Send the current value to an agent as text and continue with the agent output. */\n  prompt(\n    agent: Agent<CompletionModel>,\n    metadata?: PipelineStageMetadata,\n  ): PipelineBuilder<Input, string> {\n    const next = appendNode(this.state, \"agent\", metadata?.name ?? agent.name ?? agent.id, {\n      description: metadata?.description ?? agent.description,\n      metadata: metadata?.metadata,\n      preferredId: metadata?.id,\n      agentId: agent.id,\n      agentName: agent.name,\n    });\n    return new PipelineBuilder<Input, string>(async (input, context) => {\n      const value = await this.runStep(input, context);\n      return runNode(context, next.node, async () => {\n        const response = await agent.prompt(String(value)).send();\n        return response.output;\n      });\n    }, next.state);\n  }\n\n  /** Send the current value to an extractor as text and continue with typed schema data. */\n  extract<T>(\n    extractor: Extractor<T, CompletionModel>,\n    metadata?: PipelineStageMetadata,\n  ): PipelineBuilder<Input, T> {\n    const next = appendNode(\n      this.state,\n      \"extractor\",\n      metadata?.name ?? nextStageLabel(this.state, \"Extractor\"),\n      {\n        description: metadata?.description,\n        metadata: metadata?.metadata,\n        preferredId: metadata?.id,\n      },\n    );\n    return new PipelineBuilder<Input, T>(async (input, context) => {\n      const value = await this.runStep(input, context);\n      return runNode(context, next.node, () => extractor.extract(String(value)));\n    }, next.state);\n  }\n\n  /** Finish the builder and return a runnable pipeline. */\n  build(): Pipeline<Input, Awaited<Output>> {\n    const graph = withOutputNode(this.state);\n    return new Pipeline<Input, Awaited<Output>>(\n      (input, context) => this.runStep(input, context) as Promise<Awaited<Output>>,\n      graph,\n    );\n  }\n\n  private async runStep(input: Input, context: PipelineRunContext): Promise<Awaited<Output>> {\n    return (await this.executor(input, context)) as Awaited<Output>;\n  }\n}\n\nfunction identity<T>(input: T): T {\n  return input;\n}\n\nfunction isZodSchema(value: unknown): value is z.ZodType {\n  return value instanceof z.ZodType;\n}\n\nfunction isBuilderState(value: unknown): value is PipelineBuilderState {\n  if (typeof value !== \"object\" || value === null || Array.isArray(value)) {\n    return false;\n  }\n  const candidate = value as Record<string, unknown>;\n  return (\n    \"graph\" in candidate &&\n    \"terminalNodeId\" in candidate &&\n    \"terminalNodeIds\" in candidate &&\n    \"nextNodeIndex\" in candidate &&\n    \"nextEdgeIndex\" in candidate\n  );\n}\n\nfunction isPipelineMetadata(value: unknown): value is PipelineMetadata {\n  if (typeof value !== \"object\" || value === null || Array.isArray(value)) {\n    return false;\n  }\n  const candidate = value as Record<string, unknown>;\n  return (\n    \"id\" in candidate ||\n    \"name\" in candidate ||\n    \"description\" in candidate ||\n    \"metadata\" in candidate\n  );\n}\n","import type { JsonObject } from \"../completion\";\nimport type {\n  PipelineBuilderState,\n  PipelineGraph,\n  PipelineGraphNode,\n  PipelineMetadata,\n  PipelineStageKind,\n} from \"./types\";\n\nexport function initialBuilderState(metadata: PipelineMetadata): PipelineBuilderState {\n  return {\n    graph: initialGraph(metadata),\n    terminalNodeId: \"input\",\n    terminalNodeIds: [\"input\"],\n    nextNodeIndex: 1,\n    nextEdgeIndex: 1,\n  };\n}\n\nexport function initialGraph(metadata: PipelineMetadata): PipelineGraph {\n  const id = normalizeId(metadata.id ?? \"pipeline\");\n  const graph: PipelineGraph = {\n    id,\n    nodes: [{ id: \"input\", kind: \"input\", label: \"Input\" }],\n    edges: [],\n  };\n  if (metadata.name !== undefined) {\n    graph.name = metadata.name;\n  }\n  if (metadata.description !== undefined) {\n    graph.description = metadata.description;\n  }\n  if (metadata.metadata !== undefined) {\n    graph.metadata = metadata.metadata;\n  }\n  return graph;\n}\n\nexport function appendNode(\n  state: PipelineBuilderState,\n  kind: PipelineStageKind,\n  label: string,\n  options: {\n    description?: string | undefined;\n    metadata?: JsonObject | undefined;\n    preferredId?: string | undefined;\n    agentId?: string | undefined;\n    agentName?: string | undefined;\n    pipelineId?: string | undefined;\n  } = {},\n): { state: PipelineBuilderState; node: PipelineGraphNode } {\n  const node = graphNode(kind, label, state.nextNodeIndex, {\n    ...options,\n    existingIds: new Set(state.graph.nodes.map((item) => item.id)),\n  });\n  return {\n    node,\n    state: appendGraphNode(state, node, activeTerminalNodeIds(state), [node.id]),\n  };\n}\n\nexport function appendChildNode(\n  state: PipelineBuilderState,\n  parentId: string,\n  kind: PipelineStageKind,\n  label: string,\n  options: {\n    branchKey?: string | undefined;\n  } = {},\n): { state: PipelineBuilderState; node: PipelineGraphNode } {\n  const node = graphNode(kind, label, state.nextNodeIndex, {\n    ...options,\n    existingIds: new Set(state.graph.nodes.map((item) => item.id)),\n  });\n  return {\n    node,\n    state: appendGraphNode(state, node, [parentId], activeTerminalNodeIds(state)),\n  };\n}\n\nexport function activeTerminalNodeIds(state: PipelineBuilderState): string[] {\n  return state.terminalNodeIds.length > 0 ? state.terminalNodeIds : [state.terminalNodeId];\n}\n\nexport function withTerminalNodes(\n  state: PipelineBuilderState,\n  terminalNodeIds: string[],\n): PipelineBuilderState {\n  return {\n    ...state,\n    terminalNodeId: terminalNodeIds.at(-1) ?? state.terminalNodeId,\n    terminalNodeIds,\n  };\n}\n\nexport function withOutputNode(state: PipelineBuilderState): PipelineGraph {\n  const graph = cloneGraph(state.graph);\n  if (graph.nodes.some((node) => node.id === \"output\")) {\n    return graph;\n  }\n  graph.nodes.push({ id: \"output\", kind: \"output\", label: \"Output\" });\n  graph.edges.push(\n    ...activeTerminalNodeIds(state).map((sourceId, index) => ({\n      id: `edge_${state.nextEdgeIndex + index}`,\n      source: sourceId,\n      target: \"output\",\n    })),\n  );\n  return graph;\n}\n\nexport function nextStageLabel(state: PipelineBuilderState, prefix: string): string {\n  return `${prefix} ${state.nextNodeIndex}`;\n}\n\nexport function cloneGraph(graph: PipelineGraph): PipelineGraph {\n  return {\n    ...graph,\n    nodes: graph.nodes.map((node) => ({ ...node })),\n    edges: graph.edges.map((edge) => ({ ...edge })),\n  };\n}\n\nfunction appendGraphNode(\n  state: PipelineBuilderState,\n  node: PipelineGraphNode,\n  sourceIds: string[],\n  terminalNodeIds: string[],\n): PipelineBuilderState {\n  const edges = sourceIds.map((sourceId, index) => ({\n    id: `edge_${state.nextEdgeIndex + index}`,\n    source: sourceId,\n    target: node.id,\n  }));\n  const terminalNodeId = terminalNodeIds.at(-1) ?? state.terminalNodeId;\n  return {\n    graph: {\n      ...state.graph,\n      nodes: [...state.graph.nodes, node],\n      edges: [...state.graph.edges, ...edges],\n    },\n    terminalNodeId,\n    terminalNodeIds,\n    nextNodeIndex: state.nextNodeIndex + 1,\n    nextEdgeIndex: state.nextEdgeIndex + edges.length,\n  };\n}\n\nfunction graphNode(\n  kind: PipelineStageKind,\n  label: string,\n  index: number,\n  options: {\n    description?: string | undefined;\n    metadata?: JsonObject | undefined;\n    preferredId?: string | undefined;\n    agentId?: string | undefined;\n    agentName?: string | undefined;\n    pipelineId?: string | undefined;\n    branchKey?: string | undefined;\n    existingIds?: Set<string> | undefined;\n  } = {},\n): PipelineGraphNode {\n  const id = uniqueGraphNodeId(\n    normalizeId(options.preferredId ?? `${kind}_${index}`),\n    options.existingIds ?? new Set(),\n  );\n  const node: PipelineGraphNode = {\n    id,\n    kind,\n    label,\n  };\n  if (options.description !== undefined) {\n    node.description = options.description;\n  }\n  if (options.metadata !== undefined) {\n    node.metadata = options.metadata;\n  }\n  if (options.agentId !== undefined) {\n    node.agentId = options.agentId;\n  }\n  if (options.agentName !== undefined) {\n    node.agentName = options.agentName;\n  }\n  if (options.pipelineId !== undefined) {\n    node.pipelineId = options.pipelineId;\n  }\n  if (options.branchKey !== undefined) {\n    node.branchKey = options.branchKey;\n  }\n  return node;\n}\n\nfunction normalizeId(value: string): string {\n  const normalized = value\n    .trim()\n    .toLowerCase()\n    .replace(/[^a-z0-9_-]+/g, \"_\")\n    .replace(/^_+|_+$/g, \"\");\n  return normalized.length === 0 ? \"pipeline\" : normalized;\n}\n\nfunction uniqueGraphNodeId(baseId: string, existingIds: Set<string>): string {\n  let id = baseId;\n  let suffix = 2;\n  while (existingIds.has(id)) {\n    id = `${baseId}_${suffix}`;\n    suffix += 1;\n  }\n  return id;\n}\n","import type { JsonObject } from \"../completion\";\nimport { mapWithConcurrency } from \"../internal/concurrency\";\nimport { cloneGraph, initialGraph } from \"./graph\";\nimport type {\n  PipelineBatchOptions,\n  PipelineExecutor,\n  PipelineGraph,\n  PipelineOp,\n  PipelineRunOptions,\n} from \"./types\";\n\n/** Runnable pipeline returned by `PipelineBuilder.build()`. */\nexport class Pipeline<Input, Output> implements PipelineOp<Input, Awaited<Output>> {\n  readonly id: string;\n  readonly name: string | undefined;\n  readonly description: string | undefined;\n  readonly metadata: JsonObject | undefined;\n\n  constructor(\n    private readonly executor: PipelineExecutor<Input, Output>,\n    private readonly pipelineGraph: PipelineGraph = initialGraph({}),\n  ) {\n    this.id = pipelineGraph.id;\n    this.name = pipelineGraph.name;\n    this.description = pipelineGraph.description;\n    this.metadata = pipelineGraph.metadata;\n  }\n\n  /** Run one input through the built pipeline and return the final stage output. */\n  async run(input: Input, options: PipelineRunOptions = {}): Promise<Awaited<Output>> {\n    return (await this.executor(input, { observer: options.observer })) as Awaited<Output>;\n  }\n\n  /** Run many inputs through the same pipeline with bounded concurrency. */\n  async batch<I extends Iterable<Input>>(\n    inputs: I,\n    options: PipelineBatchOptions,\n  ): Promise<Array<Awaited<Output>>> {\n    return mapWithConcurrency([...inputs], options.concurrency, (input) => this.run(input));\n  }\n\n  graph(): PipelineGraph {\n    return cloneGraph(this.pipelineGraph);\n  }\n}\n","import type { PipelineGraphNode, PipelineRunContext } from \"./types\";\n\nexport async function runNode<Output>(\n  context: PipelineRunContext,\n  node: PipelineGraphNode,\n  fn: () => Output | Promise<Output>,\n): Promise<Awaited<Output>> {\n  const startedAt = Date.now();\n  await context.observer?.onEvent({ type: \"stage_started\", node });\n  try {\n    const output = (await fn()) as Awaited<Output>;\n    await context.observer?.onEvent({\n      type: \"stage_completed\",\n      node,\n      durationMs: Date.now() - startedAt,\n    });\n    return output;\n  } catch (error) {\n    await context.observer?.onEvent({\n      type: \"stage_failed\",\n      node,\n      durationMs: Date.now() - startedAt,\n      error,\n    });\n    throw error;\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/pipeline/pipeline.ts","../../src/pipeline/graph.ts","../../src/pipeline/runtime.ts"],"sourcesContent":["import { z } from \"zod\";\nimport { type Agent, cancelAgentApproval } from \"../agent/agent\";\nimport type { CompletionModel, JsonObject } from \"../completion\";\nimport type { Extractor } from \"../extractor\";\nimport { mapWithConcurrency } from \"../internal/concurrency\";\nimport {\n  appendChildNode,\n  appendNode,\n  cloneGraph,\n  initialPipelineState,\n  nextStageLabel,\n  withOutputNode,\n  withTerminalNodes,\n} from \"./graph\";\nimport { runNode } from \"./runtime\";\nimport type {\n  ParallelOutput,\n  PipelineBatchOptions,\n  PipelineExecutor,\n  PipelineGraph,\n  PipelineGraphNode,\n  PipelineOp,\n  PipelineOptions,\n  PipelineRunContext,\n  PipelineRunOptions,\n  PipelineStageMetadata,\n  PipelineState,\n} from \"./types\";\n\nconst internalPipelineOptions = Symbol(\"internal-pipeline-options\");\n\ntype InternalPipelineOptions<Input, Output> = {\n  [internalPipelineOptions]: {\n    executor: PipelineExecutor<Input, Output>;\n    state: PipelineState;\n  };\n};\n\n/** Immutable, typed pipeline that can be composed and run directly. */\nexport class Pipeline<Input, Output = Input> implements PipelineOp<Input, Awaited<Output>> {\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 = ((input) => inputSchema.parse(input)) 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  /** Add a synchronous or asynchronous transform stage. */\n  step<Next>(\n    fn: (input: Awaited<Output>) => Next | Promise<Next>,\n    metadata?: PipelineStageMetadata,\n  ): Pipeline<Input, Awaited<Next>> {\n    const next = appendNode(\n      this.state,\n      \"step\",\n      metadata?.name ?? nextStageLabel(this.state, \"Step\"),\n      {\n        description: metadata?.description,\n        metadata: metadata?.metadata,\n        preferredId: metadata?.id,\n      },\n    );\n    return this.derive<Awaited<Next>>(async (input, context): Promise<Awaited<Next>> => {\n      const value = await this.runStep(input, context);\n      const result = await runNode(context, next.node, () => fn(value));\n      return result as Awaited<Next>;\n    }, next.state);\n  }\n\n  /** Compose another pipeline operation after the current stage. */\n  use<Next>(\n    op: PipelineOp<Awaited<Output>, Next>,\n    metadata?: PipelineStageMetadata,\n  ): Pipeline<Input, Awaited<Next>> {\n    const nested = op instanceof Pipeline ? op : undefined;\n    const next = appendNode(\n      this.state,\n      nested === undefined ? \"step\" : \"pipeline\",\n      metadata?.name ??\n        nested?.name ??\n        nested?.id ??\n        nextStageLabel(this.state, nested === undefined ? \"Operation\" : \"Pipeline\"),\n      {\n        description: metadata?.description ?? nested?.description,\n        metadata: metadata?.metadata ?? nested?.metadata,\n        preferredId: metadata?.id,\n        pipelineId: nested?.id,\n      },\n    );\n    return this.derive<Awaited<Next>>(async (input, context): Promise<Awaited<Next>> => {\n      const value = await this.runStep(input, context);\n      const result = await runNode(context, next.node, () => op.run(value));\n      return result as Awaited<Next>;\n    }, next.state);\n  }\n\n  /** Run named branch operations concurrently from the current value. */\n  parallel<Branches extends Record<string, PipelineOp<Awaited<Output>, unknown>>>(\n    branches: Branches,\n    metadata?: PipelineStageMetadata,\n  ): Pipeline<Input, ParallelOutput<Branches>> {\n    const parallel = appendNode(\n      this.state,\n      \"parallel\",\n      metadata?.name ?? `${Object.keys(branches).length} parallel branches`,\n      {\n        description: metadata?.description,\n        metadata: metadata?.metadata,\n        preferredId: metadata?.id,\n      },\n    );\n    let nextState = parallel.state;\n    const branchNodes: Record<string, PipelineGraphNode> = {};\n    for (const key of Object.keys(branches)) {\n      const branch = appendChildNode(nextState, parallel.node.id, \"branch\", key, {\n        branchKey: key,\n      });\n      nextState = branch.state;\n      branchNodes[key] = branch.node;\n    }\n    nextState = withTerminalNodes(\n      nextState,\n      Object.values(branchNodes).map((node) => node.id),\n    );\n\n    return this.derive<ParallelOutput<Branches>>(async (input, context) => {\n      const value = await this.runStep(input, context);\n      const entries = await runNode(context, parallel.node, () =>\n        Promise.all(\n          Object.entries(branches).map(async ([key, op]) => {\n            const node = branchNodes[key] as PipelineGraphNode;\n            const output = await runNode(context, node, () => op.run(value));\n            return [key, output] as const;\n          }),\n        ),\n      );\n      return Object.fromEntries(entries) as ParallelOutput<Branches>;\n    }, nextState);\n  }\n\n  /** Send the current value to an agent as text and continue with the agent output. */\n  agent(agent: Agent<CompletionModel>, metadata?: PipelineStageMetadata): Pipeline<Input, string> {\n    const next = appendNode(this.state, \"agent\", metadata?.name ?? agent.name ?? agent.id, {\n      description: metadata?.description ?? agent.description,\n      metadata: metadata?.metadata,\n      preferredId: metadata?.id,\n      agentId: agent.id,\n      agentName: agent.name,\n    });\n    return this.derive<string>(async (input, context) => {\n      const value = await this.runStep(input, context);\n      return runNode(context, next.node, async () => {\n        const response = await agent.generate(String(value));\n        if (response.status === \"approval_required\") {\n          await cancelAgentApproval(\n            response,\n            \"Pipeline agent stages cannot suspend for tool approval.\",\n          );\n          throw new Error(\"Pipeline agent stages cannot suspend for tool approval.\");\n        }\n        return response.output;\n      });\n    }, next.state);\n  }\n\n  /** Send the current value to an extractor as text and continue with typed schema data. */\n  extract<T>(\n    extractor: Extractor<T, CompletionModel>,\n    metadata?: PipelineStageMetadata,\n  ): Pipeline<Input, T> {\n    const next = appendNode(\n      this.state,\n      \"extractor\",\n      metadata?.name ?? nextStageLabel(this.state, \"Extractor\"),\n      {\n        description: metadata?.description,\n        metadata: metadata?.metadata,\n        preferredId: metadata?.id,\n      },\n    );\n    return this.derive<T>(async (input, context) => {\n      const value = await this.runStep(input, context);\n      return runNode(context, next.node, () => extractor.extract(String(value)));\n    }, next.state);\n  }\n\n  /** Run one input through the pipeline and return the final stage output. */\n  async run(input: Input, options: PipelineRunOptions = {}): Promise<Awaited<Output>> {\n    return this.runStep(input, { observer: options.observer });\n  }\n\n  /** Run many inputs through the same pipeline with bounded concurrency. */\n  async batch<I extends Iterable<Input>>(\n    inputs: I,\n    options: PipelineBatchOptions,\n  ): Promise<Array<Awaited<Output>>> {\n    return mapWithConcurrency([...inputs], options.concurrency, (input) => this.run(input));\n  }\n\n  /** Return an isolated graph snapshot for the current pipeline stages. */\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 runStep(input: Input, context: PipelineRunContext): Promise<Awaited<Output>> {\n    return (await this.executor(input, context)) 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","import type { JsonObject } from \"../completion\";\nimport type {\n  PipelineGraph,\n  PipelineGraphNode,\n  PipelineMetadata,\n  PipelineStageKind,\n  PipelineState,\n} from \"./types\";\n\nexport function initialPipelineState(metadata: PipelineMetadata): PipelineState {\n  return {\n    graph: initialGraph(metadata),\n    terminalNodeId: \"input\",\n    terminalNodeIds: [\"input\"],\n    nextNodeIndex: 1,\n    nextEdgeIndex: 1,\n  };\n}\n\nfunction initialGraph(metadata: PipelineMetadata): PipelineGraph {\n  const id = metadata.id ?? \"pipeline\";\n  const graph: PipelineGraph = {\n    id,\n    nodes: [{ id: \"input\", kind: \"input\", label: \"Input\" }],\n    edges: [],\n  };\n  if (metadata.name !== undefined) {\n    graph.name = metadata.name;\n  }\n  if (metadata.description !== undefined) {\n    graph.description = metadata.description;\n  }\n  if (metadata.metadata !== undefined) {\n    graph.metadata = metadata.metadata;\n  }\n  return graph;\n}\n\nexport function appendNode(\n  state: PipelineState,\n  kind: PipelineStageKind,\n  label: string,\n  options: {\n    description?: string | undefined;\n    metadata?: JsonObject | undefined;\n    preferredId?: string | undefined;\n    agentId?: string | undefined;\n    agentName?: string | undefined;\n    pipelineId?: string | undefined;\n  } = {},\n): { state: PipelineState; node: PipelineGraphNode } {\n  const node = graphNode(kind, label, state.nextNodeIndex, {\n    ...options,\n    existingIds: new Set(state.graph.nodes.map((item) => item.id)),\n  });\n  return {\n    node,\n    state: appendGraphNode(state, node, activeTerminalNodeIds(state), [node.id]),\n  };\n}\n\nexport function appendChildNode(\n  state: PipelineState,\n  parentId: string,\n  kind: PipelineStageKind,\n  label: string,\n  options: {\n    branchKey?: string | undefined;\n  } = {},\n): { state: PipelineState; node: PipelineGraphNode } {\n  const node = graphNode(kind, label, state.nextNodeIndex, {\n    ...options,\n    existingIds: new Set(state.graph.nodes.map((item) => item.id)),\n  });\n  return {\n    node,\n    state: appendGraphNode(state, node, [parentId], activeTerminalNodeIds(state)),\n  };\n}\n\nfunction activeTerminalNodeIds(state: PipelineState): string[] {\n  return state.terminalNodeIds.length > 0 ? state.terminalNodeIds : [state.terminalNodeId];\n}\n\nexport function withTerminalNodes(state: PipelineState, terminalNodeIds: string[]): PipelineState {\n  return {\n    ...state,\n    terminalNodeId: terminalNodeIds.at(-1) ?? state.terminalNodeId,\n    terminalNodeIds,\n  };\n}\n\nexport function withOutputNode(state: PipelineState): PipelineGraph {\n  const graph = cloneGraph(state.graph);\n  if (graph.nodes.some((node) => node.id === \"output\")) {\n    return graph;\n  }\n  graph.nodes.push({ id: \"output\", kind: \"output\", label: \"Output\" });\n  graph.edges.push(\n    ...activeTerminalNodeIds(state).map((sourceId, index) => ({\n      id: `edge_${state.nextEdgeIndex + index}`,\n      source: sourceId,\n      target: \"output\",\n    })),\n  );\n  return graph;\n}\n\nexport function nextStageLabel(state: PipelineState, prefix: string): string {\n  return `${prefix} ${state.nextNodeIndex}`;\n}\n\nexport function cloneGraph(graph: PipelineGraph): PipelineGraph {\n  return {\n    ...graph,\n    nodes: graph.nodes.map((node) => ({ ...node })),\n    edges: graph.edges.map((edge) => ({ ...edge })),\n  };\n}\n\nfunction appendGraphNode(\n  state: PipelineState,\n  node: PipelineGraphNode,\n  sourceIds: string[],\n  terminalNodeIds: string[],\n): PipelineState {\n  const edges = sourceIds.map((sourceId, index) => ({\n    id: `edge_${state.nextEdgeIndex + index}`,\n    source: sourceId,\n    target: node.id,\n  }));\n  const terminalNodeId = terminalNodeIds.at(-1) ?? state.terminalNodeId;\n  return {\n    graph: {\n      ...state.graph,\n      nodes: [...state.graph.nodes, node],\n      edges: [...state.graph.edges, ...edges],\n    },\n    terminalNodeId,\n    terminalNodeIds,\n    nextNodeIndex: state.nextNodeIndex + 1,\n    nextEdgeIndex: state.nextEdgeIndex + edges.length,\n  };\n}\n\nfunction graphNode(\n  kind: PipelineStageKind,\n  label: string,\n  index: number,\n  options: {\n    description?: string | undefined;\n    metadata?: JsonObject | undefined;\n    preferredId?: string | undefined;\n    agentId?: string | undefined;\n    agentName?: string | undefined;\n    pipelineId?: string | undefined;\n    branchKey?: string | undefined;\n    existingIds?: Set<string> | undefined;\n  } = {},\n): PipelineGraphNode {\n  const id = uniqueGraphNodeId(\n    normalizeId(options.preferredId ?? `${kind}_${index}`),\n    options.existingIds ?? new Set(),\n  );\n  const node: PipelineGraphNode = {\n    id,\n    kind,\n    label,\n  };\n  if (options.description !== undefined) {\n    node.description = options.description;\n  }\n  if (options.metadata !== undefined) {\n    node.metadata = options.metadata;\n  }\n  if (options.agentId !== undefined) {\n    node.agentId = options.agentId;\n  }\n  if (options.agentName !== undefined) {\n    node.agentName = options.agentName;\n  }\n  if (options.pipelineId !== undefined) {\n    node.pipelineId = options.pipelineId;\n  }\n  if (options.branchKey !== undefined) {\n    node.branchKey = options.branchKey;\n  }\n  return node;\n}\n\nfunction normalizeId(value: string): string {\n  const normalized = value\n    .trim()\n    .toLowerCase()\n    .replace(/[^a-z0-9_-]+/g, \"_\")\n    .replace(/^_+|_+$/g, \"\");\n  return normalized.length === 0 ? \"pipeline\" : normalized;\n}\n\nfunction uniqueGraphNodeId(baseId: string, existingIds: Set<string>): string {\n  let id = baseId;\n  let suffix = 2;\n  while (existingIds.has(id)) {\n    id = `${baseId}_${suffix}`;\n    suffix += 1;\n  }\n  return id;\n}\n","import type { PipelineGraphNode, PipelineRunContext } from \"./types\";\n\nexport async function runNode<Output>(\n  context: PipelineRunContext,\n  node: PipelineGraphNode,\n  fn: () => Output | Promise<Output>,\n): Promise<Awaited<Output>> {\n  const startedAt = Date.now();\n  await context.observer?.onEvent({ type: \"stage_started\", node });\n  try {\n    const output = (await fn()) as Awaited<Output>;\n    await context.observer?.onEvent({\n      type: \"stage_completed\",\n      node,\n      durationMs: Date.now() - startedAt,\n    });\n    return output;\n  } catch (error) {\n    await context.observer?.onEvent({\n      type: \"stage_failed\",\n      node,\n      durationMs: Date.now() - startedAt,\n      error,\n    });\n    throw error;\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/retry-D3Ruy-ba.d.ts

@@ -0,0 +1,15 @@
+type RetryContext = {
+    error: unknown;
+    attempt: number;
+    maxAttempts: number;
+    streaming: boolean;
+    turn?: number | undefined;
+};
+type RetryOptions = {
+    maxAttempts?: number | undefined;
+    initialDelayMs?: number | undefined;
+    maxDelayMs?: number | undefined;
+    shouldRetry?: ((context: RetryContext) => boolean) | undefined;
+};
+
+export type { RetryContext as R, RetryOptions as a };

package/dist/skills/index.d.ts

@@ -1,7 +1,7 @@
-import { b as SkillLoader, a as SkillSet } from '../types-04LqWrmy.js';
-export { c as Skill, S as SkillValidationError, d as SkillValidationIssue } from '../types-04LqWrmy.js';
-import '../tool-Cohdv5GC.js';
-import '../types-G12i56s2.js';
+import { b as SkillLoader, a as SkillSet } from '../types-DhQfwiZn.js';
+export { c as Skill, S as SkillValidationError, d as SkillValidationIssue } from '../types-DhQfwiZn.js';
+import '../tool-C_8GudXn.js';
+import '../types-B3A4YxaA.js';
 
 declare function loadSkills(loaders: SkillLoader | SkillLoader[]): Promise<SkillSet>;
 

package/dist/skills/index.js

@@ -2,15 +2,14 @@ import {
   SkillValidationError,
   loadSkills,
   skill
-} from "../chunk-NCPN4SJR.js";
+} from "../chunk-DMPUP4R3.js";
 import "../chunk-CQNNSZPG.js";
 import "../chunk-YK4WAAS4.js";
-import "../chunk-HYUYZEAJ.js";
-import "../chunk-MELYDKWQ.js";
-import "../chunk-MNWK2USR.js";
-import "../chunk-OIMLU4SF.js";
+import "../chunk-6WGGTJE6.js";
+import "../chunk-R2LJSQUW.js";
+import "../chunk-DZ3CKYTH.js";
+import "../chunk-RFDVKCIE.js";
 import "../chunk-ADH7NNCS.js";
-import "../chunk-WQKHFADH.js";
 export {
   SkillValidationError,
   loadSkills,

package/dist/streaming/index.js

@@ -1,6 +1,40 @@
-import {
-  toReadableStream
-} from "../chunk-XUUY2L2D.js";
+// src/streaming/readable-stream.ts
+function toReadableStream(events, _options = {}) {
+  const encoder = new TextEncoder();
+  const iterator = events[Symbol.asyncIterator]();
+  return new ReadableStream({
+    async pull(controller) {
+      try {
+        const next = await iterator.next();
+        if (next.done === true) {
+          controller.close();
+          return;
+        }
+        controller.enqueue(encoder.encode(`${JSON.stringify(next.value)}
+`));
+      } catch (error) {
+        controller.enqueue(
+          encoder.encode(`${JSON.stringify({ type: "error", error: serializeError(error) })}
+`)
+        );
+        controller.close();
+      }
+    },
+    async cancel() {
+      await iterator.return?.();
+    }
+  });
+}
+function serializeError(error) {
+  if (error instanceof Error) {
+    return {
+      name: error.name,
+      message: error.message,
+      stack: error.stack
+    };
+  }
+  return error;
+}
 export {
   toReadableStream
 };

package/dist/streaming/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}
+{"version":3,"sources":["../../src/streaming/readable-stream.ts"],"sourcesContent":["export type ReadableStreamOptions = {\n  format?: \"jsonl\";\n};\n\nexport function toReadableStream<T>(\n  events: AsyncIterable<T>,\n  _options: ReadableStreamOptions = {},\n): ReadableStream<Uint8Array> {\n  const encoder = new TextEncoder();\n  const iterator = events[Symbol.asyncIterator]();\n\n  return new ReadableStream<Uint8Array>({\n    async pull(controller) {\n      try {\n        const next = await iterator.next();\n        if (next.done === true) {\n          controller.close();\n          return;\n        }\n\n        controller.enqueue(encoder.encode(`${JSON.stringify(next.value)}\\n`));\n      } catch (error) {\n        controller.enqueue(\n          encoder.encode(`${JSON.stringify({ type: \"error\", error: serializeError(error) })}\\n`),\n        );\n        controller.close();\n      }\n    },\n    async cancel() {\n      await iterator.return?.();\n    },\n  });\n}\n\nfunction serializeError(error: unknown): unknown {\n  if (error instanceof Error) {\n    return {\n      name: error.name,\n      message: error.message,\n      stack: error.stack,\n    };\n  }\n\n  return error;\n}\n"],"mappings":";AAIO,SAAS,iBACd,QACA,WAAkC,CAAC,GACP;AAC5B,QAAM,UAAU,IAAI,YAAY;AAChC,QAAM,WAAW,OAAO,OAAO,aAAa,EAAE;AAE9C,SAAO,IAAI,eAA2B;AAAA,IACpC,MAAM,KAAK,YAAY;AACrB,UAAI;AACF,cAAM,OAAO,MAAM,SAAS,KAAK;AACjC,YAAI,KAAK,SAAS,MAAM;AACtB,qBAAW,MAAM;AACjB;AAAA,QACF;AAEA,mBAAW,QAAQ,QAAQ,OAAO,GAAG,KAAK,UAAU,KAAK,KAAK,CAAC;AAAA,CAAI,CAAC;AAAA,MACtE,SAAS,OAAO;AACd,mBAAW;AAAA,UACT,QAAQ,OAAO,GAAG,KAAK,UAAU,EAAE,MAAM,SAAS,OAAO,eAAe,KAAK,EAAE,CAAC,CAAC;AAAA,CAAI;AAAA,QACvF;AACA,mBAAW,MAAM;AAAA,MACnB;AAAA,IACF;AAAA,IACA,MAAM,SAAS;AACb,YAAM,SAAS,SAAS;AAAA,IAC1B;AAAA,EACF,CAAC;AACH;AAEA,SAAS,eAAe,OAAyB;AAC/C,MAAI,iBAAiB,OAAO;AAC1B,WAAO;AAAA,MACL,MAAM,MAAM;AAAA,MACZ,SAAS,MAAM;AAAA,MACf,OAAO,MAAM;AAAA,IACf;AAAA,EACF;AAEA,SAAO;AACT;","names":[]}

package/dist/{think-tool-DfCMuO8e.d.ts → think-tool-DZqZj2LV.d.ts}

@@ -1,17 +1,17 @@
 import { z } from 'zod';
 import { Z as ZodSchema } from './zod-schema-C7F4clpm.js';
-import { c as ToolApprovalPolicy, f as ToolCallContext, T as Tool } from './tool-Cohdv5GC.js';
+import { e as ToolRequiresApproval, c as ToolCallContext, T as Tool } from './tool-C_8GudXn.js';
 
 type CreateToolOptions<InputSchema extends ZodSchema, OutputSchema extends ZodSchema | undefined = undefined, Output = unknown> = {
     name: string;
     description: string;
-    input: InputSchema;
-    output?: OutputSchema;
-    approval?: ToolApprovalPolicy<z.output<InputSchema>>;
+    inputSchema: InputSchema;
+    outputSchema?: OutputSchema;
+    requiresApproval?: ToolRequiresApproval<z.output<InputSchema>>;
     execute(args: z.output<InputSchema>, context: ToolCallContext): OutputSchema extends ZodSchema ? z.input<OutputSchema> | Promise<z.input<OutputSchema>> : Output | Promise<Output>;
 };
 declare function createTool<InputSchema extends ZodSchema, Output = unknown>(options: CreateToolOptions<InputSchema, undefined, Output> & {
-    output?: undefined;
+    outputSchema?: undefined;
 }): Tool<z.output<InputSchema>, Output>;
 declare function createTool<InputSchema extends ZodSchema, OutputSchema extends ZodSchema>(options: CreateToolOptions<InputSchema, OutputSchema>): Tool<z.output<InputSchema>, z.output<OutputSchema>>;
 

package/dist/tool/index.d.ts

@@ -1,11 +1,13 @@
-export { b as CreateThinkToolOptions, C as CreateToolOptions, c as createThinkTool, a as createTool } from '../think-tool-DfCMuO8e.js';
-export { A as AgentMiddleware, C as CompletionRequestMiddlewareArgs, a as CompletionRequestMiddlewareResult, b as CompletionResponseMiddlewareArgs, c as CompletionResponseMiddlewareResult, D as DynamicToolIndex, E as EmbedToolsOptions, T as ToolInputMiddlewareArgs, d as ToolInputMiddlewareResult, e as ToolOutputMiddlewareArgs, f as ToolOutputMiddlewareResult, g as ToolResultMiddlewareArgs, i as ToolSearchDocument, j as ToolSet, h as createMiddleware, k as createToolIndex, l as embedTools, m as isDynamicToolIndex } from '../middleware-Dp3d_pxi.js';
-export { A as AnyTool, N as NormalizedToolOutput, T as Tool, a as ToolApprovalContext, b as ToolApprovalDecision, c as ToolApprovalPolicy, d as ToolApprovalRequest, h as ToolApprovalRunContext, e as ToolApprovalsOptions, f as ToolCallContext, g as ToolCallStreamEvent, i as ToolOutput, n as normalizeToolResultOutput, p as parseToolArgs, t as toolResultContentToText } from '../tool-Cohdv5GC.js';
-export { H as isToolResultContentArray, K as serializeToolOutput } from '../types-G12i56s2.js';
+export { b as CreateThinkToolOptions, C as CreateToolOptions, c as createThinkTool, a as createTool } from '../think-tool-DZqZj2LV.js';
+export { C as CreateToolIndexOptions, E as EmbedToolsOptions, T as ToolIndex, a as ToolSearchDocument, c as createToolIndex, e as embedTools, i as isToolIndex } from '../dynamic-tools-i9woysFa.js';
+export { A as AgentMiddleware, C as CompletionRequestMiddlewareArgs, a as CompletionRequestMiddlewareResult, b as CompletionResponseMiddlewareArgs, c as CompletionResponseMiddlewareResult, T as ToolInputMiddlewareArgs, d as ToolInputMiddlewareResult, e as ToolOutputMiddlewareArgs, f as ToolOutputMiddlewareResult, g as ToolResultMiddlewareArgs, h as createMiddleware } from '../middleware-KynLg_RW.js';
+export { A as AnyTool, N as NormalizedToolOutput, T as Tool, a as ToolApprovalContext, b as ToolApprovalRequirement, f as ToolApprovalRunContext, c as ToolCallContext, d as ToolCallStreamEvent, g as ToolOutput, e as ToolRequiresApproval, n as normalizeToolResultOutput, p as parseToolArgs, t as toolResultContentToText } from '../tool-C_8GudXn.js';
+export { a0 as isToolResultContentArray, a2 as serializeToolOutput } from '../types-B3A4YxaA.js';
 import 'zod';
 import '../zod-schema-C7F4clpm.js';
-import '../types-BCTRUGex.js';
-import '../types-O-abTIin.js';
+import '../types-p55Jc-sr.js';
+import '../types-DT3nEemY.js';
+import '../type-utils-CtHVDRn_.js';
 
 declare class ToolCallError extends Error {
     readonly cause?: unknown | undefined;

package/dist/tool/index.js

@@ -1,40 +1,37 @@
 import {
-  ToolCallError,
-  ToolJsonError,
-  ToolNotFoundError,
-  ToolOutput,
-  ToolSet,
   createMiddleware,
   createThinkTool,
   createToolIndex,
   embedTools,
-  isDynamicToolIndex,
+  isToolIndex
+} from "../chunk-6WGGTJE6.js";
+import {
+  ToolCallError,
+  ToolJsonError,
+  ToolNotFoundError,
+  ToolOutput,
+  createTool,
   normalizeToolResultOutput,
   parseToolArgs,
   toolResultContentToText
-} from "../chunk-HYUYZEAJ.js";
-import {
-  createTool
-} from "../chunk-MELYDKWQ.js";
-import "../chunk-MNWK2USR.js";
-import "../chunk-OIMLU4SF.js";
+} from "../chunk-R2LJSQUW.js";
+import "../chunk-DZ3CKYTH.js";
+import "../chunk-RFDVKCIE.js";
 import {
   isToolResultContentArray,
   serializeToolResultOutput
 } from "../chunk-ADH7NNCS.js";
-import "../chunk-WQKHFADH.js";
 export {
   ToolCallError,
   ToolJsonError,
   ToolNotFoundError,
   ToolOutput,
-  ToolSet,
   createMiddleware,
   createThinkTool,
   createTool,
   createToolIndex,
   embedTools,
-  isDynamicToolIndex,
+  isToolIndex,
   isToolResultContentArray,
   normalizeToolResultOutput,
   parseToolArgs,