agent-framework-js 0.1.1

package/dist/chunk-RZP2ZUUX.cjs

@@ -0,0 +1,252 @@
+'use strict';
+
+var chunkMQ2XTH3S_cjs = require('./chunk-MQ2XTH3S.cjs');
+
+// src/workflows/concurrency.ts
+async function runBounded(tasks, maxConcurrency, policy) {
+  const limit = maxConcurrency === -1 ? tasks.length : Math.max(1, maxConcurrency);
+  const results = new Array(tasks.length);
+  let next = 0;
+  let failed;
+  async function worker() {
+    for (; ; ) {
+      if (policy === "fail-fast" && failed) return;
+      const i = next++;
+      if (i >= tasks.length) return;
+      try {
+        results[i] = { index: i, value: await tasks[i]() };
+      } catch (e) {
+        const err = e;
+        results[i] = { index: i, error: err };
+        if (policy === "fail-fast") {
+          failed = err;
+          return;
+        }
+      }
+    }
+  }
+  const workers = Array.from({ length: Math.min(limit, tasks.length) }, () => worker());
+  await Promise.all(workers);
+  if (policy === "fail-fast" && failed) throw failed;
+  return results;
+}
+
+// src/workflows/patterns.ts
+async function invoke(agent, input, ctx) {
+  const res = await agent.run(input);
+  if (res.error || res.status === "failed") {
+    ctx.errors[agent.name] = res.error?.message ?? "failed";
+    throw res.error ?? new Error(`Agent ${agent.name} failed`);
+  }
+  ctx.outputs[agent.name] = res.output;
+  return res.output;
+}
+async function stepSequential(agents, ctx, input, hooks) {
+  const agent = agents[ctx.cursor];
+  if (!agent) return { complete: true };
+  const feed = ctx.cursor === 0 ? input : ctx.output;
+  ctx.output = await invoke(agent, feed, ctx);
+  ctx.cursor++;
+  const done = ctx.cursor >= agents.length || !!hooks.isComplete?.(ctx.output, ctx);
+  return { complete: done };
+}
+async function stepConcurrent(agents, ctx, input, hooks) {
+  const results = await runBounded(
+    agents.map((a) => () => invoke(a, input, ctx)),
+    hooks.maxConcurrency ?? 4,
+    hooks.failurePolicy ?? "fail-soft"
+  );
+  const outputs = results.filter((r) => r.value !== void 0).map((r) => r.value);
+  ctx.output = outputs.join("\n\n");
+  return { complete: true };
+}
+async function stepHandoff(agents, ctx, input, hooks) {
+  const agent = agents[ctx.cursor];
+  if (!agent) return { complete: true };
+  const feed = ctx.round === 0 ? input : ctx.output;
+  ctx.output = await invoke(agent, feed, ctx);
+  if (hooks.isComplete?.(ctx.output, ctx)) return { complete: true };
+  const nextName = hooks.selectNext?.(ctx.output, ctx) ?? null;
+  if (!nextName) return { complete: true };
+  const idx = agents.findIndex((a) => a.name === nextName);
+  if (idx < 0) return { complete: true };
+  ctx.cursor = idx;
+  return { complete: false };
+}
+async function stepGroup(agents, ctx, input, hooks) {
+  let combined = ctx.round === 0 ? input : ctx.output;
+  for (const agent of agents) {
+    combined = await invoke(agent, combined, ctx);
+    if (hooks.isComplete?.(combined, ctx)) {
+      ctx.output = combined;
+      return { complete: true };
+    }
+  }
+  ctx.output = combined;
+  return { complete: false };
+}
+
+// src/workflows/checkpoint.ts
+var CHECKPOINT_VERSION = "1";
+function createCheckpoint(id, state) {
+  return { version: CHECKPOINT_VERSION, id, state };
+}
+function serializeCheckpoint(cp) {
+  return JSON.stringify(cp);
+}
+function restoreCheckpoint(input) {
+  let cp;
+  if (typeof input === "string") {
+    try {
+      cp = JSON.parse(input);
+    } catch {
+      throw new chunkMQ2XTH3S_cjs.CheckpointError("Checkpoint data is not valid JSON", "corrupt");
+    }
+  } else {
+    cp = input;
+  }
+  if (!cp || typeof cp !== "object" || typeof cp.id !== "string" || typeof cp.state !== "object") {
+    throw new chunkMQ2XTH3S_cjs.CheckpointError("Checkpoint is missing required fields", "corrupt");
+  }
+  if (cp.version !== CHECKPOINT_VERSION) {
+    throw new chunkMQ2XTH3S_cjs.CheckpointError(
+      `Checkpoint version ${cp.version} does not match ${CHECKPOINT_VERSION}`,
+      "version-mismatch"
+    );
+  }
+  return cp;
+}
+
+// src/workflows/workflow.ts
+function freshContext(input) {
+  return { output: input, outputs: {}, round: 0, cursor: 0, errors: {} };
+}
+function contextFromCheckpoint(cp) {
+  const s = cp.state;
+  return {
+    output: s.output ?? "",
+    outputs: s.outputs ?? {},
+    round: s.round ?? 0,
+    cursor: s.cursor ?? 0,
+    errors: s.errors ?? {}
+  };
+}
+function createWorkflow(config) {
+  const maxRounds = config.maxRounds ?? 16;
+  const id = `wf-${Math.random().toString(36).slice(2)}`;
+  let currentStatus = "running";
+  const hooks = {
+    isComplete: config.isComplete,
+    selectNext: config.selectNext,
+    maxConcurrency: config.maxConcurrency,
+    failurePolicy: config.failurePolicy
+  };
+  async function stepOnce(ctx, input) {
+    switch (config.pattern) {
+      case "sequential":
+        return (await stepSequential(config.agents, ctx, input, hooks)).complete;
+      case "concurrent":
+        return (await stepConcurrent(config.agents, ctx, input, hooks)).complete;
+      case "handoff":
+        return (await stepHandoff(config.agents, ctx, input, hooks)).complete;
+      case "group":
+        return (await stepGroup(config.agents, ctx, input, hooks)).complete;
+    }
+  }
+  function snapshot(ctx) {
+    return createCheckpoint(id, { ...ctx });
+  }
+  async function drive(ctx, input) {
+    try {
+      for (; ; ) {
+        const prompt = config.humanInputGate?.(ctx);
+        if (prompt) {
+          currentStatus = "awaiting-input";
+          return { status: currentStatus, output: ctx.output, awaiting: { prompt }, checkpoint: snapshot(ctx) };
+        }
+        const complete = await stepOnce(ctx, input);
+        ctx.round++;
+        if (complete) {
+          currentStatus = "completed";
+          return { status: currentStatus, output: ctx.output, checkpoint: snapshot(ctx) };
+        }
+        if (maxRounds !== -1 && ctx.round >= maxRounds) {
+          currentStatus = "completed";
+          return { status: currentStatus, output: ctx.output, checkpoint: snapshot(ctx) };
+        }
+      }
+    } catch (e) {
+      currentStatus = "failed";
+      return {
+        status: currentStatus,
+        output: ctx.output,
+        error: e.message,
+        checkpoint: snapshot(ctx)
+      };
+    }
+  }
+  async function run(input) {
+    currentStatus = "running";
+    return drive(freshContext(input), input);
+  }
+  async function* runStream(input) {
+    currentStatus = "running";
+    const ctx = freshContext(input);
+    for (; ; ) {
+      const prompt = config.humanInputGate?.(ctx);
+      if (prompt) {
+        currentStatus = "awaiting-input";
+        const state = {
+          status: currentStatus,
+          output: ctx.output,
+          awaiting: { prompt },
+          checkpoint: snapshot(ctx)
+        };
+        yield { type: "awaiting-input", prompt, state };
+        return;
+      }
+      let complete;
+      try {
+        complete = await stepOnce(ctx, input);
+      } catch (e) {
+        currentStatus = "failed";
+        yield {
+          type: "done",
+          state: { status: "failed", output: ctx.output, error: e.message, checkpoint: snapshot(ctx) }
+        };
+        return;
+      }
+      ctx.round++;
+      yield { type: "round", round: ctx.round, output: ctx.output };
+      if (complete || maxRounds !== -1 && ctx.round >= maxRounds) {
+        currentStatus = "completed";
+        yield { type: "done", state: { status: "completed", output: ctx.output, checkpoint: snapshot(ctx) } };
+        return;
+      }
+    }
+  }
+  async function resume(state, humanInput) {
+    const cp = restoreCheckpoint(state.checkpoint);
+    const ctx = contextFromCheckpoint(cp);
+    if (humanInput !== void 0) {
+      ctx.output = humanInput;
+      ctx.outputs["__human__"] = humanInput;
+    }
+    currentStatus = "running";
+    return drive(ctx, ctx.output);
+  }
+  return { run, runStream, resume, status: () => currentStatus };
+}
+
+exports.CHECKPOINT_VERSION = CHECKPOINT_VERSION;
+exports.createCheckpoint = createCheckpoint;
+exports.createWorkflow = createWorkflow;
+exports.restoreCheckpoint = restoreCheckpoint;
+exports.runBounded = runBounded;
+exports.serializeCheckpoint = serializeCheckpoint;
+exports.stepConcurrent = stepConcurrent;
+exports.stepGroup = stepGroup;
+exports.stepHandoff = stepHandoff;
+exports.stepSequential = stepSequential;
+//# sourceMappingURL=chunk-RZP2ZUUX.cjs.map
+//# sourceMappingURL=chunk-RZP2ZUUX.cjs.map

package/dist/chunk-RZP2ZUUX.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/workflows/concurrency.ts","../src/workflows/patterns.ts","../src/workflows/checkpoint.ts","../src/workflows/workflow.ts"],"names":["CheckpointError"],"mappings":"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","file":"chunk-RZP2ZUUX.cjs","sourcesContent":["/**\n * Bounded-concurrency execution with a configurable failure policy for concurrent\n * workflows. Fail-soft (default) aggregates partial results; fail-fast cancels\n * remaining work on the first failure. (FR-019b, FR-019c)\n *\n * @packageDocumentation\n */\n\n/** How concurrent branches react to a failure. */\nexport type FailurePolicy = \"fail-soft\" | \"fail-fast\";\n\n/** Per-branch outcome under fail-soft. */\nexport interface BranchResult<T> {\n\tindex: number;\n\tvalue?: T;\n\terror?: Error;\n}\n\n/**\n * Run `tasks` with at most `maxConcurrency` in flight (-1 = unlimited).\n *\n * - `fail-soft`: every branch runs; failures are captured per-branch.\n * - `fail-fast`: the first failure rejects and remaining branches are abandoned.\n *\n * @returns Per-branch results (always, including under fail-fast where the failing\n *   branch carries the error). Under fail-fast this throws on first failure.\n */\nexport async function runBounded<T>(\n\ttasks: Array<() => Promise<T>>,\n\tmaxConcurrency: number,\n\tpolicy: FailurePolicy,\n): Promise<Array<BranchResult<T>>> {\n\tconst limit = maxConcurrency === -1 ? tasks.length : Math.max(1, maxConcurrency);\n\tconst results: Array<BranchResult<T>> = new Array(tasks.length);\n\tlet next = 0;\n\tlet failed: Error | undefined;\n\n\tasync function worker(): Promise<void> {\n\t\tfor (; ;) {\n\t\t\tif (policy === \"fail-fast\" && failed) return;\n\t\t\tconst i = next++;\n\t\t\tif (i >= tasks.length) return;\n\t\t\ttry {\n\t\t\t\tresults[i] = { index: i, value: await tasks[i]!() };\n\t\t\t} catch (e) {\n\t\t\t\tconst err = e as Error;\n\t\t\t\tresults[i] = { index: i, error: err };\n\t\t\t\tif (policy === \"fail-fast\") {\n\t\t\t\t\tfailed = err;\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t}\n\n\tconst workers = Array.from({ length: Math.min(limit, tasks.length) }, () => worker());\n\tawait Promise.all(workers);\n\n\tif (policy === \"fail-fast\" && failed) throw failed;\n\treturn results;\n}\n","/**\n * Orchestration patterns: sequential, concurrent, handoff, and group collaboration.\n * Each pattern advances a {@link WorkflowContext} by one round and reports whether\n * the workflow is complete. (FR-019)\n *\n * @packageDocumentation\n */\n\nimport type { Agent } from \"../agents/agent.js\";\nimport { runBounded, type FailurePolicy } from \"./concurrency.js\";\n\n/** Supported orchestration patterns. */\nexport type WorkflowPattern = \"sequential\" | \"concurrent\" | \"handoff\" | \"group\";\n\n/** Mutable state threaded through pattern execution. */\nexport interface WorkflowContext {\n\t/** Latest combined output. */\n\toutput: string;\n\t/** Per-agent latest outputs (by agent name). */\n\toutputs: Record<string, string>;\n\t/** Current round (0-based). */\n\tround: number;\n\t/** Index of the next agent (handoff/sequential). */\n\tcursor: number;\n\t/** Names of agents that errored this run (fail-soft). */\n\terrors: Record<string, string>;\n}\n\n/** Hooks customizing pattern behavior. */\nexport interface PatternHooks {\n\t/** Returns true when an output signals the workflow is complete. (FR-019a) */\n\tisComplete?: (output: string, ctx: WorkflowContext) => boolean;\n\t/** For handoff: choose the next agent name from the latest output (or null to stop). */\n\tselectNext?: (output: string, ctx: WorkflowContext) => string | null;\n\tmaxConcurrency?: number;\n\tfailurePolicy?: FailurePolicy;\n}\n\n/** One step's result. */\nexport interface StepResult {\n\tcomplete: boolean;\n}\n\nasync function invoke(agent: Agent, input: string, ctx: WorkflowContext): Promise<string> {\n\tconst res = await agent.run(input);\n\tif (res.error || res.status === \"failed\") {\n\t\tctx.errors[agent.name] = res.error?.message ?? \"failed\";\n\t\tthrow res.error ?? new Error(`Agent ${agent.name} failed`);\n\t}\n\tctx.outputs[agent.name] = res.output;\n\treturn res.output;\n}\n\n/** Advance a sequential workflow by one agent. */\nexport async function stepSequential(\n\tagents: Agent[],\n\tctx: WorkflowContext,\n\tinput: string,\n\thooks: PatternHooks,\n): Promise<StepResult> {\n\tconst agent = agents[ctx.cursor];\n\tif (!agent) return { complete: true };\n\tconst feed = ctx.cursor === 0 ? input : ctx.output;\n\tctx.output = await invoke(agent, feed, ctx);\n\tctx.cursor++;\n\tconst done = ctx.cursor >= agents.length || !!hooks.isComplete?.(ctx.output, ctx);\n\treturn { complete: done };\n}\n\n/** Run all agents concurrently on the same input and aggregate outputs. */\nexport async function stepConcurrent(\n\tagents: Agent[],\n\tctx: WorkflowContext,\n\tinput: string,\n\thooks: PatternHooks,\n): Promise<StepResult> {\n\tconst results = await runBounded(\n\t\tagents.map((a) => () => invoke(a, input, ctx)),\n\t\thooks.maxConcurrency ?? 4,\n\t\thooks.failurePolicy ?? \"fail-soft\",\n\t);\n\tconst outputs = results.filter((r) => r.value !== undefined).map((r) => r.value as string);\n\tctx.output = outputs.join(\"\\n\\n\");\n\treturn { complete: true };\n}\n\n/** Advance a handoff workflow: the current agent may delegate to another. */\nexport async function stepHandoff(\n\tagents: Agent[],\n\tctx: WorkflowContext,\n\tinput: string,\n\thooks: PatternHooks,\n): Promise<StepResult> {\n\tconst agent = agents[ctx.cursor];\n\tif (!agent) return { complete: true };\n\tconst feed = ctx.round === 0 ? input : ctx.output;\n\tctx.output = await invoke(agent, feed, ctx);\n\n\tif (hooks.isComplete?.(ctx.output, ctx)) return { complete: true };\n\tconst nextName = hooks.selectNext?.(ctx.output, ctx) ?? null;\n\tif (!nextName) return { complete: true };\n\tconst idx = agents.findIndex((a) => a.name === nextName);\n\tif (idx < 0) return { complete: true };\n\tctx.cursor = idx;\n\treturn { complete: false };\n}\n\n/** Group collaboration: every agent contributes each round until complete. */\nexport async function stepGroup(\n\tagents: Agent[],\n\tctx: WorkflowContext,\n\tinput: string,\n\thooks: PatternHooks,\n): Promise<StepResult> {\n\tlet combined = ctx.round === 0 ? input : ctx.output;\n\tfor (const agent of agents) {\n\t\tcombined = await invoke(agent, combined, ctx);\n\t\tif (hooks.isComplete?.(combined, ctx)) {\n\t\t\tctx.output = combined;\n\t\t\treturn { complete: true };\n\t\t}\n\t}\n\tctx.output = combined;\n\treturn { complete: false };\n}\n","/**\n * Workflow checkpointing. A checkpoint is a serializable snapshot enabling resume.\n * Restore fails closed: corrupt or version-mismatched data yields a typed\n * {@link CheckpointError} with no partial restore. (FR-022, FR-022a)\n *\n * @packageDocumentation\n */\n\nimport { CheckpointError } from \"../core/errors.js\";\n\n/** Current checkpoint schema version. */\nexport const CHECKPOINT_VERSION = \"1\";\n\n/** A serializable workflow snapshot. */\nexport interface Checkpoint {\n\tversion: string;\n\tid: string;\n\t/** Opaque workflow state (round, messages, pending node, etc.). */\n\tstate: Record<string, unknown>;\n}\n\n/** Create a checkpoint with the current schema version. */\nexport function createCheckpoint(id: string, state: Record<string, unknown>): Checkpoint {\n\treturn { version: CHECKPOINT_VERSION, id, state };\n}\n\n/** Serialize a checkpoint to a string. */\nexport function serializeCheckpoint(cp: Checkpoint): string {\n\treturn JSON.stringify(cp);\n}\n\n/**\n * Restore a checkpoint from its serialized form or object. Fails closed.\n *\n * @throws {CheckpointError} `corrupt` if the data cannot be parsed/validated.\n * @throws {CheckpointError} `version-mismatch` if the schema version differs.\n */\nexport function restoreCheckpoint(input: string | Checkpoint): Checkpoint {\n\tlet cp: Checkpoint;\n\tif (typeof input === \"string\") {\n\t\ttry {\n\t\t\tcp = JSON.parse(input) as Checkpoint;\n\t\t} catch {\n\t\t\tthrow new CheckpointError(\"Checkpoint data is not valid JSON\", \"corrupt\");\n\t\t}\n\t} else {\n\t\tcp = input;\n\t}\n\n\tif (!cp || typeof cp !== \"object\" || typeof cp.id !== \"string\" || typeof cp.state !== \"object\") {\n\t\tthrow new CheckpointError(\"Checkpoint is missing required fields\", \"corrupt\");\n\t}\n\tif (cp.version !== CHECKPOINT_VERSION) {\n\t\tthrow new CheckpointError(\n\t\t\t`Checkpoint version ${cp.version} does not match ${CHECKPOINT_VERSION}`,\n\t\t\t\"version-mismatch\",\n\t\t);\n\t}\n\treturn cp;\n}\n","/**\n * The workflow engine: composes agents under an orchestration pattern with a\n * completion signal and a configurable max-rounds safety cap, bounded concurrency,\n * a failure policy, streaming, human-in-the-loop yield/resume, and checkpointing.\n * (FR-018, FR-019, FR-019a, FR-019b, FR-019c, FR-020, FR-021, FR-021a, FR-021b, FR-022)\n *\n * @packageDocumentation\n */\n\nimport type { Agent } from \"../agents/agent.js\";\nimport type { FailurePolicy } from \"./concurrency.js\";\nimport {\n\tstepSequential,\n\tstepConcurrent,\n\tstepHandoff,\n\tstepGroup,\n\ttype WorkflowPattern,\n\ttype WorkflowContext,\n\ttype PatternHooks,\n} from \"./patterns.js\";\nimport { createCheckpoint, restoreCheckpoint, type Checkpoint } from \"./checkpoint.js\";\n\n/** Lifecycle status of a workflow run, observable by the host. (FR-021b) */\nexport type WorkflowStatus = \"running\" | \"awaiting-input\" | \"completed\" | \"failed\";\n\n/** Configuration for {@link createWorkflow}. */\nexport interface WorkflowConfig {\n\tpattern: WorkflowPattern;\n\tagents: Agent[];\n\t/** Max rounds; -1 = unlimited. Default 16. (FR-019a) */\n\tmaxRounds?: number;\n\t/** Concurrent failure policy. Default fail-soft. (FR-019b) */\n\tfailurePolicy?: FailurePolicy;\n\t/** Max parallel agent calls; -1 = unlimited. Default 4. (FR-019c) */\n\tmaxConcurrency?: number;\n\t/** Completion signal: end the workflow when this returns true. (FR-019a) */\n\tisComplete?: (output: string, ctx: WorkflowContext) => boolean;\n\t/** Handoff target selector. */\n\tselectNext?: (output: string, ctx: WorkflowContext) => string | null;\n\t/** Human-in-the-loop gate: when it returns a prompt, the workflow yields. (FR-021) */\n\thumanInputGate?: (ctx: WorkflowContext) => string | null;\n}\n\n/** Serializable result/handle of a workflow run. (FR-021a, FR-022) */\nexport interface WorkflowState {\n\tstatus: WorkflowStatus;\n\toutput: string;\n\t/** Present when status is `awaiting-input`. */\n\tawaiting?: { prompt: string };\n\t/** Error message when status is `failed`. */\n\terror?: string;\n\t/** Snapshot enabling resume. */\n\tcheckpoint: Checkpoint;\n}\n\n/** Streamed workflow event. (FR-020) */\nexport type WorkflowEvent =\n\t| { type: \"round\"; round: number; output: string }\n\t| { type: \"awaiting-input\"; prompt: string; state: WorkflowState }\n\t| { type: \"done\"; state: WorkflowState };\n\n/** A runnable multi-agent workflow. */\nexport interface Workflow {\n\trun(input: string): Promise<WorkflowState>;\n\trunStream(input: string): AsyncIterable<WorkflowEvent>;\n\tresume(state: WorkflowState, humanInput?: string): Promise<WorkflowState>;\n\tstatus(): WorkflowStatus;\n}\n\nfunction freshContext(input: string): WorkflowContext {\n\treturn { output: input, outputs: {}, round: 0, cursor: 0, errors: {} };\n}\n\nfunction contextFromCheckpoint(cp: Checkpoint): WorkflowContext {\n\tconst s = cp.state as Partial<WorkflowContext>;\n\treturn {\n\t\toutput: s.output ?? \"\",\n\t\toutputs: s.outputs ?? {},\n\t\tround: s.round ?? 0,\n\t\tcursor: s.cursor ?? 0,\n\t\terrors: s.errors ?? {},\n\t};\n}\n\n/**\n * Create a workflow.\n *\n * @example\n * ```ts\n * const wf = createWorkflow({ pattern: \"sequential\", agents: [researcher, summarizer] });\n * let state = await wf.run(\"Summarize the notes.\");\n * if (state.status === \"awaiting-input\") state = await wf.resume(state, \"approved\");\n * ```\n */\nexport function createWorkflow(config: WorkflowConfig): Workflow {\n\tconst maxRounds = config.maxRounds ?? 16;\n\tconst id = `wf-${Math.random().toString(36).slice(2)}`;\n\tlet currentStatus: WorkflowStatus = \"running\";\n\n\tconst hooks: PatternHooks = {\n\t\tisComplete: config.isComplete,\n\t\tselectNext: config.selectNext,\n\t\tmaxConcurrency: config.maxConcurrency,\n\t\tfailurePolicy: config.failurePolicy,\n\t};\n\n\tasync function stepOnce(ctx: WorkflowContext, input: string): Promise<boolean> {\n\t\tswitch (config.pattern) {\n\t\t\tcase \"sequential\":\n\t\t\t\treturn (await stepSequential(config.agents, ctx, input, hooks)).complete;\n\t\t\tcase \"concurrent\":\n\t\t\t\treturn (await stepConcurrent(config.agents, ctx, input, hooks)).complete;\n\t\t\tcase \"handoff\":\n\t\t\t\treturn (await stepHandoff(config.agents, ctx, input, hooks)).complete;\n\t\t\tcase \"group\":\n\t\t\t\treturn (await stepGroup(config.agents, ctx, input, hooks)).complete;\n\t\t}\n\t}\n\n\tfunction snapshot(ctx: WorkflowContext): Checkpoint {\n\t\treturn createCheckpoint(id, { ...ctx });\n\t}\n\n\tasync function drive(ctx: WorkflowContext, input: string): Promise<WorkflowState> {\n\t\ttry {\n\t\t\tfor (; ;) {\n\t\t\t\t// Human-in-the-loop: yield a serializable awaiting-input state. (FR-021a)\n\t\t\t\tconst prompt = config.humanInputGate?.(ctx);\n\t\t\t\tif (prompt) {\n\t\t\t\t\tcurrentStatus = \"awaiting-input\";\n\t\t\t\t\treturn { status: currentStatus, output: ctx.output, awaiting: { prompt }, checkpoint: snapshot(ctx) };\n\t\t\t\t}\n\n\t\t\t\tconst complete = await stepOnce(ctx, input);\n\t\t\t\tctx.round++;\n\n\t\t\t\tif (complete) {\n\t\t\t\t\tcurrentStatus = \"completed\";\n\t\t\t\t\treturn { status: currentStatus, output: ctx.output, checkpoint: snapshot(ctx) };\n\t\t\t\t}\n\t\t\t\tif (maxRounds !== -1 && ctx.round >= maxRounds) {\n\t\t\t\t\tcurrentStatus = \"completed\";\n\t\t\t\t\treturn { status: currentStatus, output: ctx.output, checkpoint: snapshot(ctx) };\n\t\t\t\t}\n\t\t\t}\n\t\t} catch (e) {\n\t\t\tcurrentStatus = \"failed\";\n\t\t\treturn {\n\t\t\t\tstatus: currentStatus,\n\t\t\t\toutput: ctx.output,\n\t\t\t\terror: (e as Error).message,\n\t\t\t\tcheckpoint: snapshot(ctx),\n\t\t\t};\n\t\t}\n\t}\n\n\tasync function run(input: string): Promise<WorkflowState> {\n\t\tcurrentStatus = \"running\";\n\t\treturn drive(freshContext(input), input);\n\t}\n\n\tasync function* runStream(input: string): AsyncIterable<WorkflowEvent> {\n\t\tcurrentStatus = \"running\";\n\t\tconst ctx = freshContext(input);\n\t\tfor (; ;) {\n\t\t\tconst prompt = config.humanInputGate?.(ctx);\n\t\t\tif (prompt) {\n\t\t\t\tcurrentStatus = \"awaiting-input\";\n\t\t\t\tconst state: WorkflowState = {\n\t\t\t\t\tstatus: currentStatus,\n\t\t\t\t\toutput: ctx.output,\n\t\t\t\t\tawaiting: { prompt },\n\t\t\t\t\tcheckpoint: snapshot(ctx),\n\t\t\t\t};\n\t\t\t\tyield { type: \"awaiting-input\", prompt, state };\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tlet complete: boolean;\n\t\t\ttry {\n\t\t\t\tcomplete = await stepOnce(ctx, input);\n\t\t\t} catch (e) {\n\t\t\t\tcurrentStatus = \"failed\";\n\t\t\t\tyield {\n\t\t\t\t\ttype: \"done\",\n\t\t\t\t\tstate: { status: \"failed\", output: ctx.output, error: (e as Error).message, checkpoint: snapshot(ctx) },\n\t\t\t\t};\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tctx.round++;\n\t\t\tyield { type: \"round\", round: ctx.round, output: ctx.output };\n\t\t\tif (complete || (maxRounds !== -1 && ctx.round >= maxRounds)) {\n\t\t\t\tcurrentStatus = \"completed\";\n\t\t\t\tyield { type: \"done\", state: { status: \"completed\", output: ctx.output, checkpoint: snapshot(ctx) } };\n\t\t\t\treturn;\n\t\t\t}\n\t\t}\n\t}\n\n\tasync function resume(state: WorkflowState, humanInput?: string): Promise<WorkflowState> {\n\t\t// Fail-closed restore of the checkpoint. (FR-022a)\n\t\tconst cp = restoreCheckpoint(state.checkpoint);\n\t\tconst ctx = contextFromCheckpoint(cp);\n\t\tif (humanInput !== undefined) {\n\t\t\tctx.output = humanInput;\n\t\t\tctx.outputs[\"__human__\"] = humanInput;\n\t\t}\n\t\tcurrentStatus = \"running\";\n\t\treturn drive(ctx, ctx.output);\n\t}\n\n\treturn { run, runStream, resume, status: () => currentStatus };\n}\n"]}

package/dist/chunk-T2GHJ5R4.js

@@ -0,0 +1,241 @@
+import { CheckpointError } from './chunk-IXV4UIF5.js';
+
+// src/workflows/concurrency.ts
+async function runBounded(tasks, maxConcurrency, policy) {
+  const limit = maxConcurrency === -1 ? tasks.length : Math.max(1, maxConcurrency);
+  const results = new Array(tasks.length);
+  let next = 0;
+  let failed;
+  async function worker() {
+    for (; ; ) {
+      if (policy === "fail-fast" && failed) return;
+      const i = next++;
+      if (i >= tasks.length) return;
+      try {
+        results[i] = { index: i, value: await tasks[i]() };
+      } catch (e) {
+        const err = e;
+        results[i] = { index: i, error: err };
+        if (policy === "fail-fast") {
+          failed = err;
+          return;
+        }
+      }
+    }
+  }
+  const workers = Array.from({ length: Math.min(limit, tasks.length) }, () => worker());
+  await Promise.all(workers);
+  if (policy === "fail-fast" && failed) throw failed;
+  return results;
+}
+
+// src/workflows/patterns.ts
+async function invoke(agent, input, ctx) {
+  const res = await agent.run(input);
+  if (res.error || res.status === "failed") {
+    ctx.errors[agent.name] = res.error?.message ?? "failed";
+    throw res.error ?? new Error(`Agent ${agent.name} failed`);
+  }
+  ctx.outputs[agent.name] = res.output;
+  return res.output;
+}
+async function stepSequential(agents, ctx, input, hooks) {
+  const agent = agents[ctx.cursor];
+  if (!agent) return { complete: true };
+  const feed = ctx.cursor === 0 ? input : ctx.output;
+  ctx.output = await invoke(agent, feed, ctx);
+  ctx.cursor++;
+  const done = ctx.cursor >= agents.length || !!hooks.isComplete?.(ctx.output, ctx);
+  return { complete: done };
+}
+async function stepConcurrent(agents, ctx, input, hooks) {
+  const results = await runBounded(
+    agents.map((a) => () => invoke(a, input, ctx)),
+    hooks.maxConcurrency ?? 4,
+    hooks.failurePolicy ?? "fail-soft"
+  );
+  const outputs = results.filter((r) => r.value !== void 0).map((r) => r.value);
+  ctx.output = outputs.join("\n\n");
+  return { complete: true };
+}
+async function stepHandoff(agents, ctx, input, hooks) {
+  const agent = agents[ctx.cursor];
+  if (!agent) return { complete: true };
+  const feed = ctx.round === 0 ? input : ctx.output;
+  ctx.output = await invoke(agent, feed, ctx);
+  if (hooks.isComplete?.(ctx.output, ctx)) return { complete: true };
+  const nextName = hooks.selectNext?.(ctx.output, ctx) ?? null;
+  if (!nextName) return { complete: true };
+  const idx = agents.findIndex((a) => a.name === nextName);
+  if (idx < 0) return { complete: true };
+  ctx.cursor = idx;
+  return { complete: false };
+}
+async function stepGroup(agents, ctx, input, hooks) {
+  let combined = ctx.round === 0 ? input : ctx.output;
+  for (const agent of agents) {
+    combined = await invoke(agent, combined, ctx);
+    if (hooks.isComplete?.(combined, ctx)) {
+      ctx.output = combined;
+      return { complete: true };
+    }
+  }
+  ctx.output = combined;
+  return { complete: false };
+}
+
+// src/workflows/checkpoint.ts
+var CHECKPOINT_VERSION = "1";
+function createCheckpoint(id, state) {
+  return { version: CHECKPOINT_VERSION, id, state };
+}
+function serializeCheckpoint(cp) {
+  return JSON.stringify(cp);
+}
+function restoreCheckpoint(input) {
+  let cp;
+  if (typeof input === "string") {
+    try {
+      cp = JSON.parse(input);
+    } catch {
+      throw new CheckpointError("Checkpoint data is not valid JSON", "corrupt");
+    }
+  } else {
+    cp = input;
+  }
+  if (!cp || typeof cp !== "object" || typeof cp.id !== "string" || typeof cp.state !== "object") {
+    throw new CheckpointError("Checkpoint is missing required fields", "corrupt");
+  }
+  if (cp.version !== CHECKPOINT_VERSION) {
+    throw new CheckpointError(
+      `Checkpoint version ${cp.version} does not match ${CHECKPOINT_VERSION}`,
+      "version-mismatch"
+    );
+  }
+  return cp;
+}
+
+// src/workflows/workflow.ts
+function freshContext(input) {
+  return { output: input, outputs: {}, round: 0, cursor: 0, errors: {} };
+}
+function contextFromCheckpoint(cp) {
+  const s = cp.state;
+  return {
+    output: s.output ?? "",
+    outputs: s.outputs ?? {},
+    round: s.round ?? 0,
+    cursor: s.cursor ?? 0,
+    errors: s.errors ?? {}
+  };
+}
+function createWorkflow(config) {
+  const maxRounds = config.maxRounds ?? 16;
+  const id = `wf-${Math.random().toString(36).slice(2)}`;
+  let currentStatus = "running";
+  const hooks = {
+    isComplete: config.isComplete,
+    selectNext: config.selectNext,
+    maxConcurrency: config.maxConcurrency,
+    failurePolicy: config.failurePolicy
+  };
+  async function stepOnce(ctx, input) {
+    switch (config.pattern) {
+      case "sequential":
+        return (await stepSequential(config.agents, ctx, input, hooks)).complete;
+      case "concurrent":
+        return (await stepConcurrent(config.agents, ctx, input, hooks)).complete;
+      case "handoff":
+        return (await stepHandoff(config.agents, ctx, input, hooks)).complete;
+      case "group":
+        return (await stepGroup(config.agents, ctx, input, hooks)).complete;
+    }
+  }
+  function snapshot(ctx) {
+    return createCheckpoint(id, { ...ctx });
+  }
+  async function drive(ctx, input) {
+    try {
+      for (; ; ) {
+        const prompt = config.humanInputGate?.(ctx);
+        if (prompt) {
+          currentStatus = "awaiting-input";
+          return { status: currentStatus, output: ctx.output, awaiting: { prompt }, checkpoint: snapshot(ctx) };
+        }
+        const complete = await stepOnce(ctx, input);
+        ctx.round++;
+        if (complete) {
+          currentStatus = "completed";
+          return { status: currentStatus, output: ctx.output, checkpoint: snapshot(ctx) };
+        }
+        if (maxRounds !== -1 && ctx.round >= maxRounds) {
+          currentStatus = "completed";
+          return { status: currentStatus, output: ctx.output, checkpoint: snapshot(ctx) };
+        }
+      }
+    } catch (e) {
+      currentStatus = "failed";
+      return {
+        status: currentStatus,
+        output: ctx.output,
+        error: e.message,
+        checkpoint: snapshot(ctx)
+      };
+    }
+  }
+  async function run(input) {
+    currentStatus = "running";
+    return drive(freshContext(input), input);
+  }
+  async function* runStream(input) {
+    currentStatus = "running";
+    const ctx = freshContext(input);
+    for (; ; ) {
+      const prompt = config.humanInputGate?.(ctx);
+      if (prompt) {
+        currentStatus = "awaiting-input";
+        const state = {
+          status: currentStatus,
+          output: ctx.output,
+          awaiting: { prompt },
+          checkpoint: snapshot(ctx)
+        };
+        yield { type: "awaiting-input", prompt, state };
+        return;
+      }
+      let complete;
+      try {
+        complete = await stepOnce(ctx, input);
+      } catch (e) {
+        currentStatus = "failed";
+        yield {
+          type: "done",
+          state: { status: "failed", output: ctx.output, error: e.message, checkpoint: snapshot(ctx) }
+        };
+        return;
+      }
+      ctx.round++;
+      yield { type: "round", round: ctx.round, output: ctx.output };
+      if (complete || maxRounds !== -1 && ctx.round >= maxRounds) {
+        currentStatus = "completed";
+        yield { type: "done", state: { status: "completed", output: ctx.output, checkpoint: snapshot(ctx) } };
+        return;
+      }
+    }
+  }
+  async function resume(state, humanInput) {
+    const cp = restoreCheckpoint(state.checkpoint);
+    const ctx = contextFromCheckpoint(cp);
+    if (humanInput !== void 0) {
+      ctx.output = humanInput;
+      ctx.outputs["__human__"] = humanInput;
+    }
+    currentStatus = "running";
+    return drive(ctx, ctx.output);
+  }
+  return { run, runStream, resume, status: () => currentStatus };
+}
+
+export { CHECKPOINT_VERSION, createCheckpoint, createWorkflow, restoreCheckpoint, runBounded, serializeCheckpoint, stepConcurrent, stepGroup, stepHandoff, stepSequential };
+//# sourceMappingURL=chunk-T2GHJ5R4.js.map
+//# sourceMappingURL=chunk-T2GHJ5R4.js.map

package/dist/chunk-T2GHJ5R4.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/workflows/concurrency.ts","../src/workflows/patterns.ts","../src/workflows/checkpoint.ts","../src/workflows/workflow.ts"],"names":[],"mappings":"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","file":"chunk-T2GHJ5R4.js","sourcesContent":["/**\n * Bounded-concurrency execution with a configurable failure policy for concurrent\n * workflows. Fail-soft (default) aggregates partial results; fail-fast cancels\n * remaining work on the first failure. (FR-019b, FR-019c)\n *\n * @packageDocumentation\n */\n\n/** How concurrent branches react to a failure. */\nexport type FailurePolicy = \"fail-soft\" | \"fail-fast\";\n\n/** Per-branch outcome under fail-soft. */\nexport interface BranchResult<T> {\n\tindex: number;\n\tvalue?: T;\n\terror?: Error;\n}\n\n/**\n * Run `tasks` with at most `maxConcurrency` in flight (-1 = unlimited).\n *\n * - `fail-soft`: every branch runs; failures are captured per-branch.\n * - `fail-fast`: the first failure rejects and remaining branches are abandoned.\n *\n * @returns Per-branch results (always, including under fail-fast where the failing\n *   branch carries the error). Under fail-fast this throws on first failure.\n */\nexport async function runBounded<T>(\n\ttasks: Array<() => Promise<T>>,\n\tmaxConcurrency: number,\n\tpolicy: FailurePolicy,\n): Promise<Array<BranchResult<T>>> {\n\tconst limit = maxConcurrency === -1 ? tasks.length : Math.max(1, maxConcurrency);\n\tconst results: Array<BranchResult<T>> = new Array(tasks.length);\n\tlet next = 0;\n\tlet failed: Error | undefined;\n\n\tasync function worker(): Promise<void> {\n\t\tfor (; ;) {\n\t\t\tif (policy === \"fail-fast\" && failed) return;\n\t\t\tconst i = next++;\n\t\t\tif (i >= tasks.length) return;\n\t\t\ttry {\n\t\t\t\tresults[i] = { index: i, value: await tasks[i]!() };\n\t\t\t} catch (e) {\n\t\t\t\tconst err = e as Error;\n\t\t\t\tresults[i] = { index: i, error: err };\n\t\t\t\tif (policy === \"fail-fast\") {\n\t\t\t\t\tfailed = err;\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t}\n\n\tconst workers = Array.from({ length: Math.min(limit, tasks.length) }, () => worker());\n\tawait Promise.all(workers);\n\n\tif (policy === \"fail-fast\" && failed) throw failed;\n\treturn results;\n}\n","/**\n * Orchestration patterns: sequential, concurrent, handoff, and group collaboration.\n * Each pattern advances a {@link WorkflowContext} by one round and reports whether\n * the workflow is complete. (FR-019)\n *\n * @packageDocumentation\n */\n\nimport type { Agent } from \"../agents/agent.js\";\nimport { runBounded, type FailurePolicy } from \"./concurrency.js\";\n\n/** Supported orchestration patterns. */\nexport type WorkflowPattern = \"sequential\" | \"concurrent\" | \"handoff\" | \"group\";\n\n/** Mutable state threaded through pattern execution. */\nexport interface WorkflowContext {\n\t/** Latest combined output. */\n\toutput: string;\n\t/** Per-agent latest outputs (by agent name). */\n\toutputs: Record<string, string>;\n\t/** Current round (0-based). */\n\tround: number;\n\t/** Index of the next agent (handoff/sequential). */\n\tcursor: number;\n\t/** Names of agents that errored this run (fail-soft). */\n\terrors: Record<string, string>;\n}\n\n/** Hooks customizing pattern behavior. */\nexport interface PatternHooks {\n\t/** Returns true when an output signals the workflow is complete. (FR-019a) */\n\tisComplete?: (output: string, ctx: WorkflowContext) => boolean;\n\t/** For handoff: choose the next agent name from the latest output (or null to stop). */\n\tselectNext?: (output: string, ctx: WorkflowContext) => string | null;\n\tmaxConcurrency?: number;\n\tfailurePolicy?: FailurePolicy;\n}\n\n/** One step's result. */\nexport interface StepResult {\n\tcomplete: boolean;\n}\n\nasync function invoke(agent: Agent, input: string, ctx: WorkflowContext): Promise<string> {\n\tconst res = await agent.run(input);\n\tif (res.error || res.status === \"failed\") {\n\t\tctx.errors[agent.name] = res.error?.message ?? \"failed\";\n\t\tthrow res.error ?? new Error(`Agent ${agent.name} failed`);\n\t}\n\tctx.outputs[agent.name] = res.output;\n\treturn res.output;\n}\n\n/** Advance a sequential workflow by one agent. */\nexport async function stepSequential(\n\tagents: Agent[],\n\tctx: WorkflowContext,\n\tinput: string,\n\thooks: PatternHooks,\n): Promise<StepResult> {\n\tconst agent = agents[ctx.cursor];\n\tif (!agent) return { complete: true };\n\tconst feed = ctx.cursor === 0 ? input : ctx.output;\n\tctx.output = await invoke(agent, feed, ctx);\n\tctx.cursor++;\n\tconst done = ctx.cursor >= agents.length || !!hooks.isComplete?.(ctx.output, ctx);\n\treturn { complete: done };\n}\n\n/** Run all agents concurrently on the same input and aggregate outputs. */\nexport async function stepConcurrent(\n\tagents: Agent[],\n\tctx: WorkflowContext,\n\tinput: string,\n\thooks: PatternHooks,\n): Promise<StepResult> {\n\tconst results = await runBounded(\n\t\tagents.map((a) => () => invoke(a, input, ctx)),\n\t\thooks.maxConcurrency ?? 4,\n\t\thooks.failurePolicy ?? \"fail-soft\",\n\t);\n\tconst outputs = results.filter((r) => r.value !== undefined).map((r) => r.value as string);\n\tctx.output = outputs.join(\"\\n\\n\");\n\treturn { complete: true };\n}\n\n/** Advance a handoff workflow: the current agent may delegate to another. */\nexport async function stepHandoff(\n\tagents: Agent[],\n\tctx: WorkflowContext,\n\tinput: string,\n\thooks: PatternHooks,\n): Promise<StepResult> {\n\tconst agent = agents[ctx.cursor];\n\tif (!agent) return { complete: true };\n\tconst feed = ctx.round === 0 ? input : ctx.output;\n\tctx.output = await invoke(agent, feed, ctx);\n\n\tif (hooks.isComplete?.(ctx.output, ctx)) return { complete: true };\n\tconst nextName = hooks.selectNext?.(ctx.output, ctx) ?? null;\n\tif (!nextName) return { complete: true };\n\tconst idx = agents.findIndex((a) => a.name === nextName);\n\tif (idx < 0) return { complete: true };\n\tctx.cursor = idx;\n\treturn { complete: false };\n}\n\n/** Group collaboration: every agent contributes each round until complete. */\nexport async function stepGroup(\n\tagents: Agent[],\n\tctx: WorkflowContext,\n\tinput: string,\n\thooks: PatternHooks,\n): Promise<StepResult> {\n\tlet combined = ctx.round === 0 ? input : ctx.output;\n\tfor (const agent of agents) {\n\t\tcombined = await invoke(agent, combined, ctx);\n\t\tif (hooks.isComplete?.(combined, ctx)) {\n\t\t\tctx.output = combined;\n\t\t\treturn { complete: true };\n\t\t}\n\t}\n\tctx.output = combined;\n\treturn { complete: false };\n}\n","/**\n * Workflow checkpointing. A checkpoint is a serializable snapshot enabling resume.\n * Restore fails closed: corrupt or version-mismatched data yields a typed\n * {@link CheckpointError} with no partial restore. (FR-022, FR-022a)\n *\n * @packageDocumentation\n */\n\nimport { CheckpointError } from \"../core/errors.js\";\n\n/** Current checkpoint schema version. */\nexport const CHECKPOINT_VERSION = \"1\";\n\n/** A serializable workflow snapshot. */\nexport interface Checkpoint {\n\tversion: string;\n\tid: string;\n\t/** Opaque workflow state (round, messages, pending node, etc.). */\n\tstate: Record<string, unknown>;\n}\n\n/** Create a checkpoint with the current schema version. */\nexport function createCheckpoint(id: string, state: Record<string, unknown>): Checkpoint {\n\treturn { version: CHECKPOINT_VERSION, id, state };\n}\n\n/** Serialize a checkpoint to a string. */\nexport function serializeCheckpoint(cp: Checkpoint): string {\n\treturn JSON.stringify(cp);\n}\n\n/**\n * Restore a checkpoint from its serialized form or object. Fails closed.\n *\n * @throws {CheckpointError} `corrupt` if the data cannot be parsed/validated.\n * @throws {CheckpointError} `version-mismatch` if the schema version differs.\n */\nexport function restoreCheckpoint(input: string | Checkpoint): Checkpoint {\n\tlet cp: Checkpoint;\n\tif (typeof input === \"string\") {\n\t\ttry {\n\t\t\tcp = JSON.parse(input) as Checkpoint;\n\t\t} catch {\n\t\t\tthrow new CheckpointError(\"Checkpoint data is not valid JSON\", \"corrupt\");\n\t\t}\n\t} else {\n\t\tcp = input;\n\t}\n\n\tif (!cp || typeof cp !== \"object\" || typeof cp.id !== \"string\" || typeof cp.state !== \"object\") {\n\t\tthrow new CheckpointError(\"Checkpoint is missing required fields\", \"corrupt\");\n\t}\n\tif (cp.version !== CHECKPOINT_VERSION) {\n\t\tthrow new CheckpointError(\n\t\t\t`Checkpoint version ${cp.version} does not match ${CHECKPOINT_VERSION}`,\n\t\t\t\"version-mismatch\",\n\t\t);\n\t}\n\treturn cp;\n}\n","/**\n * The workflow engine: composes agents under an orchestration pattern with a\n * completion signal and a configurable max-rounds safety cap, bounded concurrency,\n * a failure policy, streaming, human-in-the-loop yield/resume, and checkpointing.\n * (FR-018, FR-019, FR-019a, FR-019b, FR-019c, FR-020, FR-021, FR-021a, FR-021b, FR-022)\n *\n * @packageDocumentation\n */\n\nimport type { Agent } from \"../agents/agent.js\";\nimport type { FailurePolicy } from \"./concurrency.js\";\nimport {\n\tstepSequential,\n\tstepConcurrent,\n\tstepHandoff,\n\tstepGroup,\n\ttype WorkflowPattern,\n\ttype WorkflowContext,\n\ttype PatternHooks,\n} from \"./patterns.js\";\nimport { createCheckpoint, restoreCheckpoint, type Checkpoint } from \"./checkpoint.js\";\n\n/** Lifecycle status of a workflow run, observable by the host. (FR-021b) */\nexport type WorkflowStatus = \"running\" | \"awaiting-input\" | \"completed\" | \"failed\";\n\n/** Configuration for {@link createWorkflow}. */\nexport interface WorkflowConfig {\n\tpattern: WorkflowPattern;\n\tagents: Agent[];\n\t/** Max rounds; -1 = unlimited. Default 16. (FR-019a) */\n\tmaxRounds?: number;\n\t/** Concurrent failure policy. Default fail-soft. (FR-019b) */\n\tfailurePolicy?: FailurePolicy;\n\t/** Max parallel agent calls; -1 = unlimited. Default 4. (FR-019c) */\n\tmaxConcurrency?: number;\n\t/** Completion signal: end the workflow when this returns true. (FR-019a) */\n\tisComplete?: (output: string, ctx: WorkflowContext) => boolean;\n\t/** Handoff target selector. */\n\tselectNext?: (output: string, ctx: WorkflowContext) => string | null;\n\t/** Human-in-the-loop gate: when it returns a prompt, the workflow yields. (FR-021) */\n\thumanInputGate?: (ctx: WorkflowContext) => string | null;\n}\n\n/** Serializable result/handle of a workflow run. (FR-021a, FR-022) */\nexport interface WorkflowState {\n\tstatus: WorkflowStatus;\n\toutput: string;\n\t/** Present when status is `awaiting-input`. */\n\tawaiting?: { prompt: string };\n\t/** Error message when status is `failed`. */\n\terror?: string;\n\t/** Snapshot enabling resume. */\n\tcheckpoint: Checkpoint;\n}\n\n/** Streamed workflow event. (FR-020) */\nexport type WorkflowEvent =\n\t| { type: \"round\"; round: number; output: string }\n\t| { type: \"awaiting-input\"; prompt: string; state: WorkflowState }\n\t| { type: \"done\"; state: WorkflowState };\n\n/** A runnable multi-agent workflow. */\nexport interface Workflow {\n\trun(input: string): Promise<WorkflowState>;\n\trunStream(input: string): AsyncIterable<WorkflowEvent>;\n\tresume(state: WorkflowState, humanInput?: string): Promise<WorkflowState>;\n\tstatus(): WorkflowStatus;\n}\n\nfunction freshContext(input: string): WorkflowContext {\n\treturn { output: input, outputs: {}, round: 0, cursor: 0, errors: {} };\n}\n\nfunction contextFromCheckpoint(cp: Checkpoint): WorkflowContext {\n\tconst s = cp.state as Partial<WorkflowContext>;\n\treturn {\n\t\toutput: s.output ?? \"\",\n\t\toutputs: s.outputs ?? {},\n\t\tround: s.round ?? 0,\n\t\tcursor: s.cursor ?? 0,\n\t\terrors: s.errors ?? {},\n\t};\n}\n\n/**\n * Create a workflow.\n *\n * @example\n * ```ts\n * const wf = createWorkflow({ pattern: \"sequential\", agents: [researcher, summarizer] });\n * let state = await wf.run(\"Summarize the notes.\");\n * if (state.status === \"awaiting-input\") state = await wf.resume(state, \"approved\");\n * ```\n */\nexport function createWorkflow(config: WorkflowConfig): Workflow {\n\tconst maxRounds = config.maxRounds ?? 16;\n\tconst id = `wf-${Math.random().toString(36).slice(2)}`;\n\tlet currentStatus: WorkflowStatus = \"running\";\n\n\tconst hooks: PatternHooks = {\n\t\tisComplete: config.isComplete,\n\t\tselectNext: config.selectNext,\n\t\tmaxConcurrency: config.maxConcurrency,\n\t\tfailurePolicy: config.failurePolicy,\n\t};\n\n\tasync function stepOnce(ctx: WorkflowContext, input: string): Promise<boolean> {\n\t\tswitch (config.pattern) {\n\t\t\tcase \"sequential\":\n\t\t\t\treturn (await stepSequential(config.agents, ctx, input, hooks)).complete;\n\t\t\tcase \"concurrent\":\n\t\t\t\treturn (await stepConcurrent(config.agents, ctx, input, hooks)).complete;\n\t\t\tcase \"handoff\":\n\t\t\t\treturn (await stepHandoff(config.agents, ctx, input, hooks)).complete;\n\t\t\tcase \"group\":\n\t\t\t\treturn (await stepGroup(config.agents, ctx, input, hooks)).complete;\n\t\t}\n\t}\n\n\tfunction snapshot(ctx: WorkflowContext): Checkpoint {\n\t\treturn createCheckpoint(id, { ...ctx });\n\t}\n\n\tasync function drive(ctx: WorkflowContext, input: string): Promise<WorkflowState> {\n\t\ttry {\n\t\t\tfor (; ;) {\n\t\t\t\t// Human-in-the-loop: yield a serializable awaiting-input state. (FR-021a)\n\t\t\t\tconst prompt = config.humanInputGate?.(ctx);\n\t\t\t\tif (prompt) {\n\t\t\t\t\tcurrentStatus = \"awaiting-input\";\n\t\t\t\t\treturn { status: currentStatus, output: ctx.output, awaiting: { prompt }, checkpoint: snapshot(ctx) };\n\t\t\t\t}\n\n\t\t\t\tconst complete = await stepOnce(ctx, input);\n\t\t\t\tctx.round++;\n\n\t\t\t\tif (complete) {\n\t\t\t\t\tcurrentStatus = \"completed\";\n\t\t\t\t\treturn { status: currentStatus, output: ctx.output, checkpoint: snapshot(ctx) };\n\t\t\t\t}\n\t\t\t\tif (maxRounds !== -1 && ctx.round >= maxRounds) {\n\t\t\t\t\tcurrentStatus = \"completed\";\n\t\t\t\t\treturn { status: currentStatus, output: ctx.output, checkpoint: snapshot(ctx) };\n\t\t\t\t}\n\t\t\t}\n\t\t} catch (e) {\n\t\t\tcurrentStatus = \"failed\";\n\t\t\treturn {\n\t\t\t\tstatus: currentStatus,\n\t\t\t\toutput: ctx.output,\n\t\t\t\terror: (e as Error).message,\n\t\t\t\tcheckpoint: snapshot(ctx),\n\t\t\t};\n\t\t}\n\t}\n\n\tasync function run(input: string): Promise<WorkflowState> {\n\t\tcurrentStatus = \"running\";\n\t\treturn drive(freshContext(input), input);\n\t}\n\n\tasync function* runStream(input: string): AsyncIterable<WorkflowEvent> {\n\t\tcurrentStatus = \"running\";\n\t\tconst ctx = freshContext(input);\n\t\tfor (; ;) {\n\t\t\tconst prompt = config.humanInputGate?.(ctx);\n\t\t\tif (prompt) {\n\t\t\t\tcurrentStatus = \"awaiting-input\";\n\t\t\t\tconst state: WorkflowState = {\n\t\t\t\t\tstatus: currentStatus,\n\t\t\t\t\toutput: ctx.output,\n\t\t\t\t\tawaiting: { prompt },\n\t\t\t\t\tcheckpoint: snapshot(ctx),\n\t\t\t\t};\n\t\t\t\tyield { type: \"awaiting-input\", prompt, state };\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tlet complete: boolean;\n\t\t\ttry {\n\t\t\t\tcomplete = await stepOnce(ctx, input);\n\t\t\t} catch (e) {\n\t\t\t\tcurrentStatus = \"failed\";\n\t\t\t\tyield {\n\t\t\t\t\ttype: \"done\",\n\t\t\t\t\tstate: { status: \"failed\", output: ctx.output, error: (e as Error).message, checkpoint: snapshot(ctx) },\n\t\t\t\t};\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tctx.round++;\n\t\t\tyield { type: \"round\", round: ctx.round, output: ctx.output };\n\t\t\tif (complete || (maxRounds !== -1 && ctx.round >= maxRounds)) {\n\t\t\t\tcurrentStatus = \"completed\";\n\t\t\t\tyield { type: \"done\", state: { status: \"completed\", output: ctx.output, checkpoint: snapshot(ctx) } };\n\t\t\t\treturn;\n\t\t\t}\n\t\t}\n\t}\n\n\tasync function resume(state: WorkflowState, humanInput?: string): Promise<WorkflowState> {\n\t\t// Fail-closed restore of the checkpoint. (FR-022a)\n\t\tconst cp = restoreCheckpoint(state.checkpoint);\n\t\tconst ctx = contextFromCheckpoint(cp);\n\t\tif (humanInput !== undefined) {\n\t\t\tctx.output = humanInput;\n\t\t\tctx.outputs[\"__human__\"] = humanInput;\n\t\t}\n\t\tcurrentStatus = \"running\";\n\t\treturn drive(ctx, ctx.output);\n\t}\n\n\treturn { run, runStream, resume, status: () => currentStatus };\n}\n"]}