@elie-laloum/outpost 7.0.0 → 9.0.0

package/dist/domain/workflow/workflow-state.js

@@ -1,3 +1,4 @@
+import { interactionContext, immutableInput } from "./input.js";
 import { taskIdempotencyKey } from "./idempotency.js";
 import { createObservationHub } from "../observation.js";
 import { maxUsageReceiptsPerTask } from "./usage-receipt.constants.js";
@@ -26,6 +27,7 @@ export function workflowState(name, tasks, options, checkpoint) {
         : stop.signal;
     const values = new Map();
     const activeAttempts = new Map();
+    const quotaResumes = new Map();
     const records = new Map(tasks.map((item) => [
         item,
         { key: item.key, status: "waiting", attempts: 0 },
@@ -33,13 +35,16 @@ export function workflowState(name, tasks, options, checkpoint) {
     const saved = checkpoint?.initial;
     if (saved) {
         const complete = saved.records.every((entry) => ["done", "skipped"].includes(entry.status));
-        const settledPause = saved.records.some((entry) => ["paused", "rejected"].includes(entry.status)) &&
-            saved.records.every((entry) => ["done", "skipped", "paused", "rejected"].includes(entry.status) ||
+        const settledPause = saved.records.some((entry) => ["paused", "rejected", "waiting-input"].includes(entry.status)) &&
+            saved.records.every((entry) => ["done", "skipped", "paused", "rejected", "waiting-input"].includes(entry.status) ||
                 (entry.status === "waiting" && entry.attempts === 0));
         for (const item of tasks) {
             const entry = saved.records.find((entry) => entry.key === item.key);
             records.set(item, {
                 ...entry,
+                ...(entry.interaction
+                    ? { interaction: immutableInput(entry.interaction) }
+                    : {}),
                 ...(entry.usageReceipts
                     ? { usageReceipts: Object.freeze([...entry.usageReceipts]) }
                     : {}),
@@ -54,7 +59,8 @@ export function workflowState(name, tasks, options, checkpoint) {
                 ...(entry.decision
                     ? { decision: Object.freeze({ ...entry.decision }) }
                     : {}),
-                status: ["done", "paused", "rejected"].includes(entry.status) ||
+                ...(entry.quota ? { quota: Object.freeze({ ...entry.quota }) } : {}),
+                status: ["done", "paused", "rejected", "waiting-input"].includes(entry.status) ||
                     complete ||
                     (settledPause && entry.status === "skipped")
                     ? entry.status
@@ -147,6 +153,14 @@ export function workflowState(name, tasks, options, checkpoint) {
             });
         }
         return {
+            ...(item.interaction
+                ? {
+                    interaction: interactionContext(item, runtime, attempt, taskSignal, () => activeAttempts.get(item) === attempt),
+                }
+                : {}),
+            ...(attempt > 0 && quotaResumes.has(item)
+                ? { quota: quotaResumes.get(item) }
+                : {}),
             observation: observation.child({ taskKey: item.key, attempt }),
             signal: taskSignal,
             attempt,
@@ -168,6 +182,7 @@ export function workflowState(name, tasks, options, checkpoint) {
         };
     }
     const runtime = {
+        workflow: name,
         observation,
         async persist() {
             await checkpoint?.save(runtime);
@@ -178,7 +193,9 @@ export function workflowState(name, tasks, options, checkpoint) {
         accounting,
         closeAttempt(item) {
             activeAttempts.delete(item);
+            quotaResumes.delete(item);
         },
+        quotaResumes,
         stop,
         signal,
         values,

package/dist/domain/workflow/workflow-state.js.map

@@ -1 +1 @@
-{"version":3,"file":"workflow-state.js","sourceRoot":"","sources":["../../../src/domain/workflow/workflow-state.ts"],"names":[],"mappings":"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","sourcesContent":["import { taskIdempotencyKey } from \"./idempotency.ts\";\nimport { createObservationHub } from \"../observation.ts\";\nimport { maxUsageReceiptsPerTask } from \"./usage-receipt.constants.ts\";\nimport { validateUsageReceipt } from \"./usage-receipt.ts\";\nimport type { Usage } from \"../agent.types.ts\";\nimport type { WorkflowCheckpointSession } from \"./checkpoint.types.ts\";\nimport { workflowAccounting } from \"./budget.ts\";\nimport { randomUUID } from \"node:crypto\";\nimport type {\n  Task,\n  TaskContext,\n  TaskRecord,\n  TaskStatus,\n  WorkflowEvent,\n  WorkflowExecutionState,\n  WorkflowOptions,\n} from \"../workflow.types.ts\";\n\nexport function workflowState(\n  name: string,\n  tasks: readonly Task[],\n  options: WorkflowOptions,\n  checkpoint?: WorkflowCheckpointSession,\n): WorkflowExecutionState {\n  const executionId = checkpoint?.initial?.executionId ?? randomUUID();\n  const observation = (options.observation ?? createObservationHub()).child(\n    { executionId },\n    [\n      {\n        observe(value) {\n          if (value.event.kind === \"workflow\")\n            return options.telemetry?.observe(value.event.event);\n        },\n      },\n      {\n        observe(value) {\n          if (value.event.kind === \"workflow\")\n            return options.observe?.(value.event.event);\n        },\n      },\n    ],\n  );\n  const stop = new AbortController();\n  const signal = options.signal\n    ? AbortSignal.any([options.signal, stop.signal])\n    : stop.signal;\n  const values = new Map<Task, unknown>();\n  const activeAttempts = new Map<Task, number>();\n  const records = new Map<Task, TaskRecord>(\n    tasks.map((item) => [\n      item,\n      { key: item.key, status: \"waiting\", attempts: 0 },\n    ]),\n  );\n  const saved = checkpoint?.initial;\n  if (saved) {\n    const complete = saved.records.every((entry) =>\n      [\"done\", \"skipped\"].includes(entry.status),\n    );\n    const settledPause =\n      saved.records.some((entry) =>\n        [\"paused\", \"rejected\"].includes(entry.status),\n      ) &&\n      saved.records.every(\n        (entry) =>\n          [\"done\", \"skipped\", \"paused\", \"rejected\"].includes(entry.status) ||\n          (entry.status === \"waiting\" && entry.attempts === 0),\n      );\n    for (const item of tasks) {\n      const entry = saved.records.find((entry) => entry.key === item.key)!;\n      records.set(item, {\n        ...entry,\n        ...(entry.usageReceipts\n          ? { usageReceipts: Object.freeze([...entry.usageReceipts]) }\n          : {}),\n        ...(entry.pause\n          ? {\n              pause: Object.freeze({\n                ...entry.pause,\n                actors: Object.freeze([...entry.pause.actors]),\n              }),\n            }\n          : {}),\n        ...(entry.decision\n          ? { decision: Object.freeze({ ...entry.decision }) }\n          : {}),\n        status:\n          [\"done\", \"paused\", \"rejected\"].includes(entry.status) ||\n          complete ||\n          (settledPause && entry.status === \"skipped\")\n            ? entry.status\n            : \"waiting\",\n      });\n      if (entry.status === \"done\") {\n        const output = saved.values[item.key]!;\n        values.set(item, output.kind === \"json\" ? output.value : undefined);\n      }\n    }\n  }\n  const errors: unknown[] = [],\n    observerErrors: unknown[] = [];\n  for (const entry of records.values())\n    if (entry.status === \"rejected\") errors.push(new Error(entry.error));\n  const accounting = workflowAccounting(\n    options.budget,\n    (error) => {\n      errors.push(error);\n      emit({ type: \"budget-exceeded\" });\n      if (error.dimension !== \"attempts\") stop.abort(error);\n    },\n    saved?.usage,\n  );\n  const record = (item: Task) => records.get(item)!;\n  function emit(\n    event: Omit<WorkflowEvent, \"executionId\" | \"workflow\" | \"timestamp\">,\n  ): void {\n    const notification: WorkflowEvent = {\n      ...event,\n      executionId,\n      workflow: name,\n      timestamp: new Date().toISOString(),\n    };\n    observation\n      .child({\n        ...(event.key ? { taskKey: event.key } : {}),\n        ...(event.attempt === undefined ? {} : { attempt: event.attempt }),\n      })\n      .emit(\"workflow\", { kind: \"workflow\", event: notification });\n  }\n  function finish(item: Task, status: TaskStatus): void {\n    Object.assign(record(item), {\n      status,\n      finishedAt: new Date().toISOString(),\n    });\n    emit({\n      type: \"task\",\n      key: item.key,\n      status,\n      attempt: record(item).attempts,\n      ...(record(item).startedAt\n        ? { durationMs: Date.now() - Date.parse(record(item).startedAt!) }\n        : {}),\n    });\n  }\n  function context(\n    item: Task,\n    attempt: number,\n    taskSignal: AbortSignal,\n  ): TaskContext {\n    if (attempt > 0) activeAttempts.set(item, attempt);\n    function report(usage: Usage, receipt?: string): void {\n      const current = record(item);\n      if (\n        attempt === 0 ||\n        current.status !== \"active\" ||\n        activeAttempts.get(item) !== attempt\n      )\n        throw new Error(\n          \"Usage must be reported during its active task attempt\",\n        );\n      if (receipt !== undefined) {\n        validateUsageReceipt(receipt);\n        if (current.usageReceipts?.includes(receipt)) return;\n        if ((current.usageReceipts?.length ?? 0) >= maxUsageReceiptsPerTask)\n          throw new Error(\"Workflow usage receipt limit exceeded\");\n      }\n      const previousReceipts = current.usageReceipts;\n      if (receipt !== undefined)\n        current.usageReceipts = Object.freeze([\n          ...(previousReceipts ?? []),\n          receipt,\n        ]);\n      try {\n        accounting.report(usage);\n      } catch (error) {\n        if (previousReceipts) current.usageReceipts = previousReceipts;\n        else delete current.usageReceipts;\n        throw error;\n      }\n      void runtime.persist().catch((error: unknown) => stop.abort(error));\n      emit({\n        type: \"usage\",\n        key: item.key,\n        attempt,\n        usage: Object.freeze({ ...usage }),\n      });\n    }\n\n    return {\n      observation: observation.child({ taskKey: item.key, attempt }),\n      signal: taskSignal,\n      attempt,\n      executionId,\n      idempotencyKey: taskIdempotencyKey(executionId, item.key),\n      checkpoint: () => runtime.persist(),\n      reportUsage: (usage) => report(usage),\n      reportUsageOnce: (receipt, usage) => {\n        validateUsageReceipt(receipt);\n        report(usage, receipt);\n      },\n      value<T>(dependency: Task<T>): T {\n        if (!item.after.includes(dependency))\n          throw new Error(\n            `${item.key}: undeclared dependency ${dependency.key}`,\n          );\n        if (!values.has(dependency))\n          throw new Error(`${dependency.key} has no successful value`);\n        return values.get(dependency) as T;\n      },\n    };\n  }\n\n  const runtime: WorkflowExecutionState = {\n    observation,\n    async persist() {\n      await checkpoint?.save(runtime);\n      if (checkpoint) emit({ type: \"checkpoint\" });\n    },\n    executionId,\n    accounting,\n    closeAttempt(item) {\n      activeAttempts.delete(item);\n    },\n    stop,\n    signal,\n    values,\n    records,\n    errors,\n    observerErrors,\n    record,\n    emit,\n    finish,\n    context,\n    options,\n  };\n  return runtime;\n}\n"]}
+{"version":3,"file":"workflow-state.js","sourceRoot":"","sources":["../../../src/domain/workflow/workflow-state.ts"],"names":[],"mappings":"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","sourcesContent":["import { interactionContext, immutableInput } from \"./input.ts\";\nimport { taskIdempotencyKey } from \"./idempotency.ts\";\nimport { createObservationHub } from \"../observation.ts\";\nimport { maxUsageReceiptsPerTask } from \"./usage-receipt.constants.ts\";\nimport { validateUsageReceipt } from \"./usage-receipt.ts\";\nimport type { Usage } from \"../agent.types.ts\";\nimport type { WorkflowCheckpointSession } from \"./checkpoint.types.ts\";\nimport type { WorkflowQuotaPause } from \"./quota-pause.types.ts\";\nimport { workflowAccounting } from \"./budget.ts\";\nimport { randomUUID } from \"node:crypto\";\nimport type {\n  Task,\n  TaskContext,\n  TaskRecord,\n  TaskStatus,\n  WorkflowEvent,\n  WorkflowExecutionState,\n  WorkflowOptions,\n} from \"../workflow.types.ts\";\n\nexport function workflowState(\n  name: string,\n  tasks: readonly Task[],\n  options: WorkflowOptions,\n  checkpoint?: WorkflowCheckpointSession,\n): WorkflowExecutionState {\n  const executionId = checkpoint?.initial?.executionId ?? randomUUID();\n  const observation = (options.observation ?? createObservationHub()).child(\n    { executionId },\n    [\n      {\n        observe(value) {\n          if (value.event.kind === \"workflow\")\n            return options.telemetry?.observe(value.event.event);\n        },\n      },\n      {\n        observe(value) {\n          if (value.event.kind === \"workflow\")\n            return options.observe?.(value.event.event);\n        },\n      },\n    ],\n  );\n  const stop = new AbortController();\n  const signal = options.signal\n    ? AbortSignal.any([options.signal, stop.signal])\n    : stop.signal;\n  const values = new Map<Task, unknown>();\n  const activeAttempts = new Map<Task, number>();\n  const quotaResumes = new Map<Task, WorkflowQuotaPause>();\n  const records = new Map<Task, TaskRecord>(\n    tasks.map((item) => [\n      item,\n      { key: item.key, status: \"waiting\", attempts: 0 },\n    ]),\n  );\n  const saved = checkpoint?.initial;\n  if (saved) {\n    const complete = saved.records.every((entry) =>\n      [\"done\", \"skipped\"].includes(entry.status),\n    );\n    const settledPause =\n      saved.records.some((entry) =>\n        [\"paused\", \"rejected\", \"waiting-input\"].includes(entry.status),\n      ) &&\n      saved.records.every(\n        (entry) =>\n          [\"done\", \"skipped\", \"paused\", \"rejected\", \"waiting-input\"].includes(\n            entry.status,\n          ) ||\n          (entry.status === \"waiting\" && entry.attempts === 0),\n      );\n    for (const item of tasks) {\n      const entry = saved.records.find((entry) => entry.key === item.key)!;\n      records.set(item, {\n        ...entry,\n        ...(entry.interaction\n          ? { interaction: immutableInput(entry.interaction) }\n          : {}),\n        ...(entry.usageReceipts\n          ? { usageReceipts: Object.freeze([...entry.usageReceipts]) }\n          : {}),\n        ...(entry.pause\n          ? {\n              pause: Object.freeze({\n                ...entry.pause,\n                actors: Object.freeze([...entry.pause.actors]),\n              }),\n            }\n          : {}),\n        ...(entry.decision\n          ? { decision: Object.freeze({ ...entry.decision }) }\n          : {}),\n        ...(entry.quota ? { quota: Object.freeze({ ...entry.quota }) } : {}),\n        status:\n          [\"done\", \"paused\", \"rejected\", \"waiting-input\"].includes(\n            entry.status,\n          ) ||\n          complete ||\n          (settledPause && entry.status === \"skipped\")\n            ? entry.status\n            : \"waiting\",\n      });\n      if (entry.status === \"done\") {\n        const output = saved.values[item.key]!;\n        values.set(item, output.kind === \"json\" ? output.value : undefined);\n      }\n    }\n  }\n  const errors: unknown[] = [],\n    observerErrors: unknown[] = [];\n  for (const entry of records.values())\n    if (entry.status === \"rejected\") errors.push(new Error(entry.error));\n  const accounting = workflowAccounting(\n    options.budget,\n    (error) => {\n      errors.push(error);\n      emit({ type: \"budget-exceeded\" });\n      if (error.dimension !== \"attempts\") stop.abort(error);\n    },\n    saved?.usage,\n  );\n  const record = (item: Task) => records.get(item)!;\n  function emit(\n    event: Omit<WorkflowEvent, \"executionId\" | \"workflow\" | \"timestamp\">,\n  ): void {\n    const notification: WorkflowEvent = {\n      ...event,\n      executionId,\n      workflow: name,\n      timestamp: new Date().toISOString(),\n    };\n    observation\n      .child({\n        ...(event.key ? { taskKey: event.key } : {}),\n        ...(event.attempt === undefined ? {} : { attempt: event.attempt }),\n      })\n      .emit(\"workflow\", { kind: \"workflow\", event: notification });\n  }\n  function finish(item: Task, status: TaskStatus): void {\n    Object.assign(record(item), {\n      status,\n      finishedAt: new Date().toISOString(),\n    });\n    emit({\n      type: \"task\",\n      key: item.key,\n      status,\n      attempt: record(item).attempts,\n      ...(record(item).startedAt\n        ? { durationMs: Date.now() - Date.parse(record(item).startedAt!) }\n        : {}),\n    });\n  }\n  function context(\n    item: Task,\n    attempt: number,\n    taskSignal: AbortSignal,\n  ): TaskContext {\n    if (attempt > 0) activeAttempts.set(item, attempt);\n    function report(usage: Usage, receipt?: string): void {\n      const current = record(item);\n      if (\n        attempt === 0 ||\n        current.status !== \"active\" ||\n        activeAttempts.get(item) !== attempt\n      )\n        throw new Error(\n          \"Usage must be reported during its active task attempt\",\n        );\n      if (receipt !== undefined) {\n        validateUsageReceipt(receipt);\n        if (current.usageReceipts?.includes(receipt)) return;\n        if ((current.usageReceipts?.length ?? 0) >= maxUsageReceiptsPerTask)\n          throw new Error(\"Workflow usage receipt limit exceeded\");\n      }\n      const previousReceipts = current.usageReceipts;\n      if (receipt !== undefined)\n        current.usageReceipts = Object.freeze([\n          ...(previousReceipts ?? []),\n          receipt,\n        ]);\n      try {\n        accounting.report(usage);\n      } catch (error) {\n        if (previousReceipts) current.usageReceipts = previousReceipts;\n        else delete current.usageReceipts;\n        throw error;\n      }\n      void runtime.persist().catch((error: unknown) => stop.abort(error));\n      emit({\n        type: \"usage\",\n        key: item.key,\n        attempt,\n        usage: Object.freeze({ ...usage }),\n      });\n    }\n\n    return {\n      ...(item.interaction\n        ? {\n            interaction: interactionContext(\n              item,\n              runtime,\n              attempt,\n              taskSignal,\n              () => activeAttempts.get(item) === attempt,\n            ),\n          }\n        : {}),\n      ...(attempt > 0 && quotaResumes.has(item)\n        ? { quota: quotaResumes.get(item)! }\n        : {}),\n      observation: observation.child({ taskKey: item.key, attempt }),\n      signal: taskSignal,\n      attempt,\n      executionId,\n      idempotencyKey: taskIdempotencyKey(executionId, item.key),\n      checkpoint: () => runtime.persist(),\n      reportUsage: (usage) => report(usage),\n      reportUsageOnce: (receipt, usage) => {\n        validateUsageReceipt(receipt);\n        report(usage, receipt);\n      },\n      value<T>(dependency: Task<T>): T {\n        if (!item.after.includes(dependency))\n          throw new Error(\n            `${item.key}: undeclared dependency ${dependency.key}`,\n          );\n        if (!values.has(dependency))\n          throw new Error(`${dependency.key} has no successful value`);\n        return values.get(dependency) as T;\n      },\n    };\n  }\n\n  const runtime: WorkflowExecutionState = {\n    workflow: name,\n    observation,\n    async persist() {\n      await checkpoint?.save(runtime);\n      if (checkpoint) emit({ type: \"checkpoint\" });\n    },\n    executionId,\n    accounting,\n    closeAttempt(item) {\n      activeAttempts.delete(item);\n      quotaResumes.delete(item);\n    },\n    quotaResumes,\n    stop,\n    signal,\n    values,\n    records,\n    errors,\n    observerErrors,\n    record,\n    emit,\n    finish,\n    context,\n    options,\n  };\n  return runtime;\n}\n"]}

package/dist/domain/workflow.d.ts

@@ -1,7 +1,7 @@
 import type { Task, Workflow } from "./workflow.types.ts";
 export type { Retry, Task, TaskContext, TaskOptions, TaskRecord, TaskStatus, Workflow, WorkflowEvent, WorkflowOptions, WorkflowResult, WorkflowTelemetry, } from "./workflow.types.ts";
 export { WorkflowFailure } from "./workflow/failure.ts";
-export { task } from "./workflow/task.ts";
-export declare function workflow(name: string, tasks: readonly Task[]): Workflow;
+export { defineTask } from "./workflow/task.ts";
+export declare function defineWorkflow(name: string, tasks: readonly Task[]): Workflow;
 export { WorkflowBudgetExceeded, WorkflowUsageUnavailable, } from "./workflow/budget.ts";
 export type { WorkflowBudget, WorkflowUsage } from "./workflow/budget.types.ts";

package/dist/domain/workflow.js

@@ -1,8 +1,8 @@
 import { validate } from "./workflow/validation.js";
 import { schedule } from "./workflow/workflow-scheduler.js";
 export { WorkflowFailure } from "./workflow/failure.js";
-export { task } from "./workflow/task.js";
-export function workflow(name, tasks) {
+export { defineTask } from "./workflow/task.js";
+export function defineWorkflow(name, tasks) {
     if (!name.trim())
         throw new Error("Workflow name cannot be empty");
     const graph = Object.freeze([...tasks]);

package/dist/domain/workflow.js.map

@@ -1 +1 @@
-{"version":3,"file":"workflow.js","sourceRoot":"","sources":["../../src/domain/workflow.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAe5D,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAE1C,MAAM,UAAU,QAAQ,CAAC,IAAY,EAAE,KAAsB;IAC3D,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;IACnE,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC;IACxC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAChB,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,IAAI;QACJ,KAAK,EAAE,KAAK;QACZ,KAAK,EAAE,CAAC,UAA2B,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC;QACxE,OAAO;YACL,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;YACrE,OAAO;gBACL,cAAc;gBACd,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;oBACzB,KAAK,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,GAAG,IAAI;oBACnC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CACf,CAAC,UAAU,EAAE,EAAE,CAAC,KAAK,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,QAAQ,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAChE;iBACF,CAAC;aACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACf,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AAED,OAAO,EACL,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,sBAAsB,CAAC","sourcesContent":["import type { Task, Workflow, WorkflowOptions } from \"./workflow.types.ts\";\nimport { validate } from \"./workflow/validation.ts\";\nimport { schedule } from \"./workflow/workflow-scheduler.ts\";\n\nexport type {\n  Retry,\n  Task,\n  TaskContext,\n  TaskOptions,\n  TaskRecord,\n  TaskStatus,\n  Workflow,\n  WorkflowEvent,\n  WorkflowOptions,\n  WorkflowResult,\n  WorkflowTelemetry,\n} from \"./workflow.types.ts\";\nexport { WorkflowFailure } from \"./workflow/failure.ts\";\nexport { task } from \"./workflow/task.ts\";\n\nexport function workflow(name: string, tasks: readonly Task[]): Workflow {\n  if (!name.trim()) throw new Error(\"Workflow name cannot be empty\");\n  const graph = Object.freeze([...tasks]);\n  validate(graph);\n  return Object.freeze({\n    name,\n    tasks: graph,\n    start: (options: WorkflowOptions = {}) => schedule(name, graph, options),\n    diagram() {\n      const ids = new Map(graph.map((item, index) => [item, `n${index}`]));\n      return [\n        \"flowchart LR\",\n        ...graph.flatMap((item) => [\n          `  ${ids.get(item)}[\"${item.key}\"]`,\n          ...item.after.map(\n            (dependency) => `  ${ids.get(dependency)} --> ${ids.get(item)}`,\n          ),\n        ]),\n      ].join(\"\\n\");\n    },\n  });\n}\n\nexport {\n  WorkflowBudgetExceeded,\n  WorkflowUsageUnavailable,\n} from \"./workflow/budget.ts\";\nexport type { WorkflowBudget, WorkflowUsage } from \"./workflow/budget.types.ts\";\n"]}
+{"version":3,"file":"workflow.js","sourceRoot":"","sources":["../../src/domain/workflow.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAe5D,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEhD,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,KAAsB;IACjE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;IACnE,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC;IACxC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAChB,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,IAAI;QACJ,KAAK,EAAE,KAAK;QACZ,KAAK,EAAE,CAAC,UAA2B,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC;QACxE,OAAO;YACL,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;YACrE,OAAO;gBACL,cAAc;gBACd,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;oBACzB,KAAK,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,GAAG,IAAI;oBACnC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CACf,CAAC,UAAU,EAAE,EAAE,CAAC,KAAK,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,QAAQ,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAChE;iBACF,CAAC;aACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACf,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AAED,OAAO,EACL,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,sBAAsB,CAAC","sourcesContent":["import type { Task, Workflow, WorkflowOptions } from \"./workflow.types.ts\";\nimport { validate } from \"./workflow/validation.ts\";\nimport { schedule } from \"./workflow/workflow-scheduler.ts\";\n\nexport type {\n  Retry,\n  Task,\n  TaskContext,\n  TaskOptions,\n  TaskRecord,\n  TaskStatus,\n  Workflow,\n  WorkflowEvent,\n  WorkflowOptions,\n  WorkflowResult,\n  WorkflowTelemetry,\n} from \"./workflow.types.ts\";\nexport { WorkflowFailure } from \"./workflow/failure.ts\";\nexport { defineTask } from \"./workflow/task.ts\";\n\nexport function defineWorkflow(name: string, tasks: readonly Task[]): Workflow {\n  if (!name.trim()) throw new Error(\"Workflow name cannot be empty\");\n  const graph = Object.freeze([...tasks]);\n  validate(graph);\n  return Object.freeze({\n    name,\n    tasks: graph,\n    start: (options: WorkflowOptions = {}) => schedule(name, graph, options),\n    diagram() {\n      const ids = new Map(graph.map((item, index) => [item, `n${index}`]));\n      return [\n        \"flowchart LR\",\n        ...graph.flatMap((item) => [\n          `  ${ids.get(item)}[\"${item.key}\"]`,\n          ...item.after.map(\n            (dependency) => `  ${ids.get(dependency)} --> ${ids.get(item)}`,\n          ),\n        ]),\n      ].join(\"\\n\");\n    },\n  });\n}\n\nexport {\n  WorkflowBudgetExceeded,\n  WorkflowUsageUnavailable,\n} from \"./workflow/budget.ts\";\nexport type { WorkflowBudget, WorkflowUsage } from \"./workflow/budget.types.ts\";\n"]}

package/dist/domain/workflow.types.d.ts

@@ -1,9 +1,16 @@
+import type { TaskInteraction, TaskInteractionContext, TaskInteractionRecord, WorkflowAnswer, WorkflowInputRequest } from "./workflow/input.types.ts";
+import type { LoopRoundRecord } from "./workflow/loop-task.types.ts";
+import type { WorkflowQuotaPause, WorkflowQuotaPolicy } from "./workflow/quota-pause.types.ts";
 import type { ObservationHub } from "./observation.types.ts";
 import type { WorkflowDecision, WorkflowDecisionVerifier, WorkflowDecisionRecord, WorkflowGate, WorkflowPauseRequest } from "./workflow/gates.types.ts";
 import type { WorkflowCheckpointOptions } from "./workflow/checkpoint.types.ts";
+import type { TaskCacheOptions, TaskCacheOutcome } from "./workflow/task-cache.types.ts";
 import type { Usage } from "./agent.types.ts";
 import type { WorkflowAccounting, WorkflowBudget, WorkflowUsage } from "./workflow/budget.types.ts";
 export interface TaskContext {
+    /** Quota pause resumed by this attempt; present only on the first attempt after it. */
+    readonly quota?: WorkflowQuotaPause;
+    readonly interaction?: TaskInteractionContext;
     readonly idempotencyKey: string;
     readonly observation?: ObservationHub;
     readonly signal: AbortSignal;
@@ -23,6 +30,7 @@ export interface Retry {
     readonly accepts?: (error: unknown, attempt: number) => boolean;
 }
 export interface Task<T = unknown> {
+    readonly interaction?: TaskInteraction;
     readonly key: string;
     readonly gate?: WorkflowGate;
     readonly after: readonly Task[];
@@ -30,12 +38,17 @@ export interface Task<T = unknown> {
     readonly condition?: (context: TaskContext) => boolean | Promise<boolean>;
     readonly retry?: Retry;
     readonly timeoutMs?: number;
+    readonly cache?: TaskCacheOptions;
 }
 export type TaskOptions<T> = Omit<Task<T>, "after"> & {
     readonly after?: readonly Task[];
 };
-export type TaskStatus = "waiting" | "active" | "done" | "failed" | "skipped" | "cancelled" | "paused" | "rejected";
+export type TaskStatus = "waiting-input" | "waiting" | "active" | "done" | "failed" | "skipped" | "cancelled" | "paused" | "rejected";
 export interface TaskRecord {
+    cacheHit?: true;
+    quota?: WorkflowQuotaPause;
+    interaction?: TaskInteractionRecord;
+    rounds?: readonly LoopRoundRecord[];
     usageReceipts?: readonly string[];
     pause?: WorkflowPauseRequest;
     decision?: WorkflowDecisionRecord;
@@ -50,7 +63,12 @@ export interface WorkflowEvent {
     readonly executionId: string;
     readonly workflow: string;
     readonly timestamp: string;
-    readonly type: "start" | "task" | "attempt" | "retry" | "usage" | "finish" | "gate" | "decision" | "checkpoint" | "resume" | "budget-exceeded";
+    readonly type: "cache" | "quota" | "input-request" | "input-answer" | "loop" | "start" | "task" | "attempt" | "retry" | "usage" | "finish" | "gate" | "decision" | "checkpoint" | "resume" | "budget-exceeded";
+    readonly cache?: TaskCacheOutcome;
+    readonly error?: string;
+    readonly resetAt?: string;
+    readonly round?: number;
+    readonly phase?: "attempt" | "check" | "complete";
     readonly key?: string;
     readonly status?: TaskStatus;
     readonly attempt?: number;
@@ -62,6 +80,8 @@ export interface WorkflowTelemetry {
     observe(event: WorkflowEvent): void;
 }
 export interface WorkflowOptions {
+    readonly onQuota?: WorkflowQuotaPolicy;
+    readonly answers?: readonly WorkflowAnswer[];
     readonly timeoutMs?: number;
     readonly observation?: ObservationHub;
     readonly decisionVerifier?: WorkflowDecisionVerifier;
@@ -75,9 +95,10 @@ export interface WorkflowOptions {
     readonly observe?: (event: WorkflowEvent) => void;
 }
 export interface WorkflowResult {
+    readonly inputRequests: readonly WorkflowInputRequest[];
     readonly executionId: string;
     readonly name: string;
-    readonly status: "done" | "failed" | "cancelled" | "paused";
+    readonly status: "done" | "failed" | "cancelled" | "paused" | "waiting-input";
     readonly tasks: readonly Readonly<TaskRecord>[];
     readonly errors: readonly unknown[];
     readonly observerErrors: readonly unknown[];
@@ -93,6 +114,7 @@ export interface Workflow {
 }
 export type WorkflowNotification = Omit<WorkflowEvent, "executionId" | "workflow" | "timestamp">;
 export interface WorkflowExecutionState {
+    readonly workflow: string;
     readonly observation: ObservationHub;
     readonly executionId: string;
     readonly stop: AbortController;
@@ -103,6 +125,7 @@ export interface WorkflowExecutionState {
     readonly observerErrors: unknown[];
     readonly options: WorkflowOptions;
     readonly accounting: WorkflowAccounting;
+    readonly quotaResumes: Map<Task, WorkflowQuotaPause>;
     persist(): Promise<void>;
     closeAttempt(task: Task): void;
     record(task: Task): TaskRecord;

package/dist/domain/workflow.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"workflow.types.js","sourceRoot":"","sources":["../../src/domain/workflow.types.ts"],"names":[],"mappings":"","sourcesContent":["import type { ObservationHub } from \"./observation.types.ts\";\nimport type {\n  WorkflowDecision,\n  WorkflowDecisionVerifier,\n  WorkflowDecisionRecord,\n  WorkflowGate,\n  WorkflowPauseRequest,\n} from \"./workflow/gates.types.ts\";\nimport type { WorkflowCheckpointOptions } from \"./workflow/checkpoint.types.ts\";\nimport type { Usage } from \"./agent.types.ts\";\nimport type {\n  WorkflowAccounting,\n  WorkflowBudget,\n  WorkflowUsage,\n} from \"./workflow/budget.types.ts\";\n\nexport interface TaskContext {\n  readonly idempotencyKey: string;\n  readonly observation?: ObservationHub;\n  readonly signal: AbortSignal;\n  readonly attempt: number;\n  readonly executionId: string;\n  reportUsage(usage: Usage): void;\n  reportUsageOnce?(receipt: string, usage: Usage): void;\n  checkpoint?(): Promise<void>;\n  value<T>(dependency: Task<T>): T;\n}\n\nexport interface Retry {\n  readonly attempts: number;\n  readonly delayMs?: number;\n  readonly backoff?: \"fixed\" | \"exponential\";\n  readonly maxDelayMs?: number;\n  readonly jitter?: \"none\" | \"full\";\n  readonly accepts?: (error: unknown, attempt: number) => boolean;\n}\n\nexport interface Task<T = unknown> {\n  readonly key: string;\n  readonly gate?: WorkflowGate;\n  readonly after: readonly Task[];\n  readonly perform: (context: TaskContext) => T | Promise<T>;\n  readonly condition?: (context: TaskContext) => boolean | Promise<boolean>;\n  readonly retry?: Retry;\n  readonly timeoutMs?: number;\n}\n\nexport type TaskOptions<T> = Omit<Task<T>, \"after\"> & {\n  readonly after?: readonly Task[];\n};\n\nexport type TaskStatus =\n  | \"waiting\"\n  | \"active\"\n  | \"done\"\n  | \"failed\"\n  | \"skipped\"\n  | \"cancelled\"\n  | \"paused\"\n  | \"rejected\";\n\nexport interface TaskRecord {\n  usageReceipts?: readonly string[];\n  pause?: WorkflowPauseRequest;\n  decision?: WorkflowDecisionRecord;\n  readonly key: string;\n  status: TaskStatus;\n  attempts: number;\n  startedAt?: string;\n  finishedAt?: string;\n  error?: string;\n}\n\nexport interface WorkflowEvent {\n  readonly executionId: string;\n  readonly workflow: string;\n  readonly timestamp: string;\n  readonly type:\n    | \"start\"\n    | \"task\"\n    | \"attempt\"\n    | \"retry\"\n    | \"usage\"\n    | \"finish\"\n    | \"gate\"\n    | \"decision\"\n    | \"checkpoint\"\n    | \"resume\"\n    | \"budget-exceeded\";\n  readonly key?: string;\n  readonly status?: TaskStatus;\n  readonly attempt?: number;\n  readonly usage?: Usage;\n  readonly durationMs?: number;\n  readonly delayMs?: number;\n}\n\nexport interface WorkflowTelemetry {\n  observe(event: WorkflowEvent): void;\n}\n\nexport interface WorkflowOptions {\n  readonly timeoutMs?: number;\n  readonly observation?: ObservationHub;\n  readonly decisionVerifier?: WorkflowDecisionVerifier;\n  readonly decisions?: readonly WorkflowDecision[];\n  readonly checkpoint?: WorkflowCheckpointOptions;\n  readonly signal?: AbortSignal;\n  readonly concurrency?: number;\n  readonly budget?: WorkflowBudget;\n  readonly stopOnError?: boolean;\n  readonly telemetry?: WorkflowTelemetry;\n  readonly observe?: (event: WorkflowEvent) => void;\n}\n\nexport interface WorkflowResult {\n  readonly executionId: string;\n  readonly name: string;\n  readonly status: \"done\" | \"failed\" | \"cancelled\" | \"paused\";\n  readonly tasks: readonly Readonly<TaskRecord>[];\n  readonly errors: readonly unknown[];\n  readonly observerErrors: readonly unknown[];\n  readonly usage: WorkflowUsage;\n  value<T>(task: Task<T>): T;\n  unwrap(): void;\n}\n\nexport interface Workflow {\n  readonly name: string;\n  readonly tasks: readonly Task[];\n  start(options?: WorkflowOptions): Promise<WorkflowResult>;\n  diagram(): string;\n}\n\nexport type WorkflowNotification = Omit<\n  WorkflowEvent,\n  \"executionId\" | \"workflow\" | \"timestamp\"\n>;\nexport interface WorkflowExecutionState {\n  readonly observation: ObservationHub;\n  readonly executionId: string;\n  readonly stop: AbortController;\n  readonly signal: AbortSignal;\n  readonly values: Map<Task, unknown>;\n  readonly records: Map<Task, TaskRecord>;\n  readonly errors: unknown[];\n  readonly observerErrors: unknown[];\n  readonly options: WorkflowOptions;\n  readonly accounting: WorkflowAccounting;\n  persist(): Promise<void>;\n  closeAttempt(task: Task): void;\n  record(task: Task): TaskRecord;\n  emit(event: WorkflowNotification): void;\n  finish(task: Task, status: TaskStatus): void;\n  context(task: Task, attempt: number, signal: AbortSignal): TaskContext;\n}\n"]}
+{"version":3,"file":"workflow.types.js","sourceRoot":"","sources":["../../src/domain/workflow.types.ts"],"names":[],"mappings":"","sourcesContent":["import type {\n  TaskInteraction,\n  TaskInteractionContext,\n  TaskInteractionRecord,\n  WorkflowAnswer,\n  WorkflowInputRequest,\n} from \"./workflow/input.types.ts\";\nimport type { LoopRoundRecord } from \"./workflow/loop-task.types.ts\";\nimport type {\n  WorkflowQuotaPause,\n  WorkflowQuotaPolicy,\n} from \"./workflow/quota-pause.types.ts\";\nimport type { ObservationHub } from \"./observation.types.ts\";\nimport type {\n  WorkflowDecision,\n  WorkflowDecisionVerifier,\n  WorkflowDecisionRecord,\n  WorkflowGate,\n  WorkflowPauseRequest,\n} from \"./workflow/gates.types.ts\";\nimport type { WorkflowCheckpointOptions } from \"./workflow/checkpoint.types.ts\";\nimport type {\n  TaskCacheOptions,\n  TaskCacheOutcome,\n} from \"./workflow/task-cache.types.ts\";\nimport type { Usage } from \"./agent.types.ts\";\nimport type {\n  WorkflowAccounting,\n  WorkflowBudget,\n  WorkflowUsage,\n} from \"./workflow/budget.types.ts\";\n\nexport interface TaskContext {\n  /** Quota pause resumed by this attempt; present only on the first attempt after it. */\n  readonly quota?: WorkflowQuotaPause;\n  readonly interaction?: TaskInteractionContext;\n  readonly idempotencyKey: string;\n  readonly observation?: ObservationHub;\n  readonly signal: AbortSignal;\n  readonly attempt: number;\n  readonly executionId: string;\n  reportUsage(usage: Usage): void;\n  reportUsageOnce?(receipt: string, usage: Usage): void;\n  checkpoint?(): Promise<void>;\n  value<T>(dependency: Task<T>): T;\n}\n\nexport interface Retry {\n  readonly attempts: number;\n  readonly delayMs?: number;\n  readonly backoff?: \"fixed\" | \"exponential\";\n  readonly maxDelayMs?: number;\n  readonly jitter?: \"none\" | \"full\";\n  readonly accepts?: (error: unknown, attempt: number) => boolean;\n}\n\nexport interface Task<T = unknown> {\n  readonly interaction?: TaskInteraction;\n  readonly key: string;\n  readonly gate?: WorkflowGate;\n  readonly after: readonly Task[];\n  readonly perform: (context: TaskContext) => T | Promise<T>;\n  readonly condition?: (context: TaskContext) => boolean | Promise<boolean>;\n  readonly retry?: Retry;\n  readonly timeoutMs?: number;\n  readonly cache?: TaskCacheOptions;\n}\n\nexport type TaskOptions<T> = Omit<Task<T>, \"after\"> & {\n  readonly after?: readonly Task[];\n};\n\nexport type TaskStatus =\n  | \"waiting-input\"\n  | \"waiting\"\n  | \"active\"\n  | \"done\"\n  | \"failed\"\n  | \"skipped\"\n  | \"cancelled\"\n  | \"paused\"\n  | \"rejected\";\n\nexport interface TaskRecord {\n  cacheHit?: true;\n  quota?: WorkflowQuotaPause;\n  interaction?: TaskInteractionRecord;\n  rounds?: readonly LoopRoundRecord[];\n  usageReceipts?: readonly string[];\n  pause?: WorkflowPauseRequest;\n  decision?: WorkflowDecisionRecord;\n  readonly key: string;\n  status: TaskStatus;\n  attempts: number;\n  startedAt?: string;\n  finishedAt?: string;\n  error?: string;\n}\n\nexport interface WorkflowEvent {\n  readonly executionId: string;\n  readonly workflow: string;\n  readonly timestamp: string;\n  readonly type:\n    | \"cache\"\n    | \"quota\"\n    | \"input-request\"\n    | \"input-answer\"\n    | \"loop\"\n    | \"start\"\n    | \"task\"\n    | \"attempt\"\n    | \"retry\"\n    | \"usage\"\n    | \"finish\"\n    | \"gate\"\n    | \"decision\"\n    | \"checkpoint\"\n    | \"resume\"\n    | \"budget-exceeded\";\n  readonly cache?: TaskCacheOutcome;\n  readonly error?: string;\n  readonly resetAt?: string;\n  readonly round?: number;\n  readonly phase?: \"attempt\" | \"check\" | \"complete\";\n  readonly key?: string;\n  readonly status?: TaskStatus;\n  readonly attempt?: number;\n  readonly usage?: Usage;\n  readonly durationMs?: number;\n  readonly delayMs?: number;\n}\n\nexport interface WorkflowTelemetry {\n  observe(event: WorkflowEvent): void;\n}\n\nexport interface WorkflowOptions {\n  readonly onQuota?: WorkflowQuotaPolicy;\n  readonly answers?: readonly WorkflowAnswer[];\n  readonly timeoutMs?: number;\n  readonly observation?: ObservationHub;\n  readonly decisionVerifier?: WorkflowDecisionVerifier;\n  readonly decisions?: readonly WorkflowDecision[];\n  readonly checkpoint?: WorkflowCheckpointOptions;\n  readonly signal?: AbortSignal;\n  readonly concurrency?: number;\n  readonly budget?: WorkflowBudget;\n  readonly stopOnError?: boolean;\n  readonly telemetry?: WorkflowTelemetry;\n  readonly observe?: (event: WorkflowEvent) => void;\n}\n\nexport interface WorkflowResult {\n  readonly inputRequests: readonly WorkflowInputRequest[];\n  readonly executionId: string;\n  readonly name: string;\n  readonly status: \"done\" | \"failed\" | \"cancelled\" | \"paused\" | \"waiting-input\";\n  readonly tasks: readonly Readonly<TaskRecord>[];\n  readonly errors: readonly unknown[];\n  readonly observerErrors: readonly unknown[];\n  readonly usage: WorkflowUsage;\n  value<T>(task: Task<T>): T;\n  unwrap(): void;\n}\n\nexport interface Workflow {\n  readonly name: string;\n  readonly tasks: readonly Task[];\n  start(options?: WorkflowOptions): Promise<WorkflowResult>;\n  diagram(): string;\n}\n\nexport type WorkflowNotification = Omit<\n  WorkflowEvent,\n  \"executionId\" | \"workflow\" | \"timestamp\"\n>;\nexport interface WorkflowExecutionState {\n  readonly workflow: string;\n  readonly observation: ObservationHub;\n  readonly executionId: string;\n  readonly stop: AbortController;\n  readonly signal: AbortSignal;\n  readonly values: Map<Task, unknown>;\n  readonly records: Map<Task, TaskRecord>;\n  readonly errors: unknown[];\n  readonly observerErrors: unknown[];\n  readonly options: WorkflowOptions;\n  readonly accounting: WorkflowAccounting;\n  readonly quotaResumes: Map<Task, WorkflowQuotaPause>;\n  persist(): Promise<void>;\n  closeAttempt(task: Task): void;\n  record(task: Task): TaskRecord;\n  emit(event: WorkflowNotification): void;\n  finish(task: Task, status: TaskStatus): void;\n  context(task: Task, attempt: number, signal: AbortSignal): TaskContext;\n}\n"]}

package/dist/index.d.ts

@@ -1,7 +1,8 @@
-export { agent } from "./domain/agent.ts";
+export { createAgent } from "./domain/agent.ts";
 export { defineHarnessSubagent } from "./domain/subagent.ts";
 export type { HarnessSubagent, HarnessSubagentInput, HarnessSubagentOptions, } from "./domain/subagent.types.ts";
-export { harness } from "./domain/harness.ts";
+export { createHarness } from "./domain/harness.ts";
+export { defineMcpPrompt } from "./domain/mcp-prompt.ts";
 export { defineHarnessContextStrategy, summarizeHistory, truncateToolResults, } from "./domain/context.ts";
 export type { HarnessContextInput, HarnessContextResult, HarnessContextStrategy, HarnessContextStrategyOptions, SummarizeHistoryOptions, TruncateToolResultsOptions, } from "./domain/context.types.ts";
 export { defineHarnessHook } from "./domain/hook.ts";
@@ -12,52 +13,74 @@ export { defineHarnessPermissions } from "./domain/permissions.ts";
 export type { HarnessHook, HarnessHookContext, HarnessHookDecisions, HarnessHookEvents, HarnessHookInput, HarnessHookOptions, HarnessHookPhase, HarnessHookResult, HarnessToolResultView, } from "./domain/hook.types.ts";
 export type { HarnessPermissionRule, HarnessPermissions, HarnessPermissionsOptions, PermissionDecision, PermissionEffect, ToolResources, } from "./domain/permissions.types.ts";
 export { defineHarnessTool, defineHarnessToolset } from "./domain/tool.ts";
-export { harnessEditTools } from "./adapters/tools/edit-tools.ts";
-export { harnessFileTools } from "./adapters/tools/file-tools.ts";
-export { harnessGitTools } from "./adapters/tools/git-tools.ts";
-export { harnessSearchTools } from "./adapters/tools/search-tools.ts";
-export { harnessShellTools } from "./adapters/tools/shell-tools.ts";
+export { createHarnessEditTools } from "./adapters/tools/edit-tools.ts";
+export { createHarnessFileTools } from "./adapters/tools/file-tools.ts";
+export { createHarnessGitTools } from "./adapters/tools/git-tools.ts";
+export { createHarnessSearchTools } from "./adapters/tools/search-tools.ts";
+export { createHarnessShellTools } from "./adapters/tools/shell-tools.ts";
 export type { ShellToolsOptions } from "./adapters/tools/tools.types.ts";
 export type { AccountCredential, AgentAuthentication, Agent, AgentOptions, AgentHarness, CliHarness, CliAgent, CustomAgent, UsageCredential, } from "./domain/agent.types.ts";
-export type { Harness, HarnessOptions, HarnessInstructionContext, HarnessInstructions, HarnessInstructionSource, HarnessInstructionsOption, HarnessLimits, HarnessToolExecution, } from "./domain/harness.types.ts";
+export type { Harness, HarnessOptions, HarnessInstructionContext, HarnessMcpContext, HarnessInstructions, HarnessInstructionSource, HarnessInstructionsOption, HarnessLimits, HarnessToolExecution, } from "./domain/harness.types.ts";
+export type { McpClientCredentials, McpHttpServer, McpServer, McpServers, McpStdioServer, McpToolFilter, } from "./domain/mcp-server.types.ts";
+export type { McpPromptOptions } from "./domain/mcp-prompt.types.ts";
 export type { HarnessTool, HarnessToolContext, HarnessToolEvent, HarnessToolOptions, HarnessToolset, HarnessToolsetOptions, JsonSchema, StandardJsonSchema, ToolOutput, ToolValidation, } from "./domain/tool.types.ts";
 export { TransportConflict } from "./domain/transport.ts";
 export type { Transport, TransportEntry, TransportObject, TransportReadOptions, TransportWriteOptions, TransportReference, TransportStoreOptions, } from "./domain/transport.types.ts";
-export { localTransport } from "./infrastructure/local-transport.ts";
+export { createLocalTransport } from "./infrastructure/local-transport.ts";
 export type { LocalTransportOptions } from "./infrastructure/local-transport.types.ts";
-export { artifactStore } from "./infrastructure/transport-artifact-store.ts";
+export { createArtifactStore } from "./infrastructure/transport-artifact-store.ts";
 export type { ArtifactStoreOptions } from "./infrastructure/transport-artifact-store.types.ts";
-export { workflowCheckpointStore, recoverWorkflowCheckpoint, } from "./infrastructure/transport-checkpoint.ts";
+export { createWorkflowCheckpointStore, recoverWorkflowCheckpoint, } from "./infrastructure/transport-checkpoint.ts";
 export type { CheckpointRecoveryOptions } from "./infrastructure/transport-checkpoint.types.ts";
+export { createTaskCacheStore } from "./infrastructure/transport-task-cache.ts";
+export { repositoryFingerprint } from "./application/repository-fingerprint.ts";
+export type { TaskCacheStoreOptions } from "./infrastructure/transport-task-cache.types.ts";
 export { readJournal } from "./infrastructure/transport-journal.ts";
 export type { ReadJournalOptions } from "./infrastructure/transport-journal.types.ts";
-export { transportConversations } from "./infrastructure/transport-conversations.ts";
+export { createReplayAgent, ReplayDivergence } from "./domain/replay.ts";
+export type { RecordedCommit, RecordedIdentity, RecordedRevision, ReplayAgent, ReplayAgentOptions, ReplayDivergenceDetails, ReplayDivergenceKind, ReplayDivergencePolicy, ReplayFailure, ReplayTurn, WorkspaceCommitsEvent, } from "./domain/replay.types.ts";
+export { conversations, createTransportConversations, } from "./application/conversation-stores.ts";
 export type { TransportConversationOptions } from "./infrastructure/transport-conversations.types.ts";
 export { archiveRecovery, materializeRecoveryArchive, } from "./application/recovery-archive.ts";
 export type { RecoveryArchiveOptions, RecoveryArchiveRestoreOptions, } from "./application/recovery-archive.types.ts";
 export { attach, createSandbox, dispatch, openWorkspace, } from "./application/outpost.ts";
 export type { AttachOptions, AttachResult, ContinuationOptions, DispatchResult, Sandbox, SandboxOptions, WarmDispatchResult, Workspace, WorkspaceOptions, } from "./application/outpost.ts";
 export type { DispatchOptions, Execution, Turn, } from "./application/execution.ts";
-export { WorkflowFailure, WorkflowBudgetExceeded, WorkflowUsageUnavailable, task, workflow, } from "./domain/workflow.ts";
+export { WorkflowFailure, WorkflowBudgetExceeded, WorkflowUsageUnavailable, defineTask, defineWorkflow, } from "./domain/workflow.ts";
 export type { Retry, Task, TaskContext, TaskOptions, TaskRecord, TaskStatus, Workflow, WorkflowEvent, WorkflowOptions, WorkflowBudget, WorkflowUsage, WorkflowResult, WorkflowTelemetry, } from "./domain/workflow.ts";
-export { agentTask, commandTask, isolatedTask } from "./application/tasks.ts";
-export { antigravityHarness, claudeHarness, codexHarness, copilotHarness, kimiHarness, } from "./providers/agents.ts";
+export { defineAgentTask, defineCommandTask, defineIsolatedTask, } from "./application/tasks.ts";
+export type { QuotaResumePolicy } from "./application/quota-resume.types.ts";
+export { createAntigravityHarness, createClaudeHarness, createCodexHarness, createCopilotHarness, createKimiHarness, } from "./providers/agents.ts";
 export { agentVersions } from "./providers/versions.ts";
-export { conversations, harnessConversations, } from "./infrastructure/conversations.ts";
-export type { ConversationFormat, ConversationLocation, StoredConversationFormat, } from "./infrastructure/conversations.ts";
+export { createHarnessConversations, createSessionBundleConversations, createTranscriptConversations, } from "./infrastructure/conversations.ts";
+export { createClaudeConversations } from "./adapters/agents/claude/claude-conversations.ts";
+export { createCodexConversations } from "./adapters/agents/codex/codex-conversations.ts";
+export { createCopilotConversations } from "./adapters/agents/copilot/copilot-conversations.ts";
+export { createKimiConversations } from "./adapters/agents/kimi/kimi-conversations.ts";
+export type { TranscriptConversationLayout } from "./infrastructure/conversations/layout.types.ts";
+export type { SessionBundleFiles, SessionBundleHelpers, SessionBundleProfile, SessionBundleRelocation, } from "./infrastructure/conversations/session-bundle.types.ts";
+export type { ConversationFormat, ConversationLocation, } from "./infrastructure/conversations.ts";
 export type { AntigravitySettings, ClaudeSettings, CodexSettings, CodexModelProvider, CopilotSettings, KimiSettings, } from "./providers/agents.ts";
-export { mountedSandboxProvider, remoteSandboxProvider, } from "./providers/factories.ts";
-export { ResponseError, response } from "./domain/response.ts";
+export { createMountedSandboxProvider, createRemoteSandboxProvider, } from "./providers/factories.ts";
+export { ResponseError, defineJsonResponse, defineTextResponse, } from "./domain/response.ts";
 export type { ResponseSpec, StandardValidator } from "./domain/response.ts";
 export { OutpostError, recoveryDetails } from "./domain/errors.ts";
 export type { FaultCode } from "./domain/errors.ts";
-export type { AgentAdapter, AgentEvent, AgentInput, AgentObservation, BranchPolicy, Channel, Command, CommandResult, Commit, ConversationContext, ConversationRecord, ConversationStore, Disposal, LifecycleHooks, FileManifestEntry, FileTransfers, SandboxContext, SandboxLease, SandboxProvider, StageLimits, TransferOptions, Usage, Variables, Volume, WorkspaceRecord, } from "./domain/ports.ts";
+export { quotaFault } from "./domain/quota.ts";
+export type { QuotaFault } from "./domain/quota.types.ts";
+export { unavailableFault } from "./domain/unavailable.ts";
+export { createFallbackAgent } from "./domain/fallback-agent.ts";
+export type { DispatchAgent, FallbackAgent, FallbackAgentOptions, FallbackAttempt, FallbackCandidate, FallbackRecord, FallbackTrigger, } from "./domain/fallback-agent.types.ts";
+export type { UnavailableFault } from "./domain/unavailable.types.ts";
+export { createSteering } from "./domain/steering.ts";
+export type { Steering, SteeringDelivery, SteeringMode, SteeringSendOptions, SteeringState, } from "./domain/steering.types.ts";
+export type { AgentAdapter, AgentConfiguration, ConfigurationFile, HostConfiguration, AgentEvent, AgentInput, AgentLiveInput, AgentLiveRead, AgentLiveSession, AgentObservation, BranchPolicy, Channel, Command, CommandResult, Commit, ConversationContext, ConversationRecord, ConversationStore, NativeConversationStore, Disposal, LifecycleHooks, FileManifestEntry, FileTransfers, SandboxContext, SandboxLease, SandboxProvider, StageLimits, TransferOptions, Usage, Variables, Volume, WorkspaceRecord, } from "./domain/ports.ts";
 export type { Brief, PromptVariables } from "./domain/prompts.ts";
 export type { Logging } from "./infrastructure/journal.ts";
-export { createReporter } from "./infrastructure/custom-reporter.ts";
+export { createCustomReporter } from "./infrastructure/custom-reporter.ts";
 export type { CustomReporter, CustomReporterOptions, ReporterHandlers, } from "./infrastructure/custom-reporter.types.ts";
 export type { DispatchTelemetry, DispatchTelemetrySession, DispatchTelemetryOutcome, } from "./domain/dispatch-telemetry.types.ts";
-export { reporter } from "./infrastructure/reporter.ts";
+export { createReporter } from "./infrastructure/reporter.ts";
 export type { ReporterOptions } from "./infrastructure/reporter.ts";
 export type { VariableQuestion } from "./application/interactive-brief.ts";
 export { planRecoveryRetention, pruneRecoveryRetention, assertRecoveryQuota, } from "./application/recovery-retention.ts";
@@ -75,35 +98,58 @@ export type { StorageReservation, StorageReservationOptions, } from "./infrastru
 export { planRecoveryRestore, restoreRecoveryTransfer, } from "./application/recovery-restore.ts";
 export type { RecoveryRestoreOptions, RecoveryRestorePlan, RecoveryRestoreResult, } from "./application/recovery-restore.types.ts";
 export type { WorkflowCheckpoint, WorkflowCheckpointOptions, WorkflowCheckpointStore, WorkflowCheckpointLease, WorkflowCheckpointValue, WorkflowJson, } from "./domain/workflow/checkpoint.types.ts";
-export { approvalTask, pauseTask } from "./domain/workflow/gates.ts";
+export { defineApprovalTask, definePauseTask, } from "./domain/workflow/gates.ts";
 export type { WorkflowGate, WorkflowGateOptions, WorkflowPauseRequest, WorkflowDecision, WorkflowDecisionRecord, WorkflowDecisionProof, WorkflowDecisionVerification, WorkflowDecisionVerifier, } from "./domain/workflow/gates.types.ts";
+export type { WorkflowQuotaPause, WorkflowQuotaPolicy, } from "./domain/workflow/quota-pause.types.ts";
 export { inspectRecovery } from "./application/recovery-inspection.ts";
 export type { RecoveryInspection, RecoveryInspectionOptions, } from "./application/recovery-inspection.types.ts";
 export type { ResourceActivityRecord, ResourceInspection, ResourceInspectionEntry, ResourceOperation, ResourceOperationKind, ResourceOperationResult, ResourcePhase, } from "./infrastructure/resource-activity.types.ts";
-export { artifact, publishArtifact, readStoredArtifact, } from "./domain/artifact.ts";
-export { artifactTask, readArtifact } from "./application/artifact-tasks.ts";
+export { defineBinaryArtifact, defineJsonArtifact, publishArtifact, readStoredArtifact, } from "./domain/artifact.ts";
+export { defineArtifactTask, readArtifact, } from "./application/artifact-tasks.ts";
 export type { ArtifactContract, ArtifactContractOptions, ArtifactIdentity, ArtifactProducer, ArtifactReference, ArtifactStore, JsonArtifactOptions, PublishArtifactOptions, ReadArtifactOptions, } from "./domain/artifact.types.ts";
 export type { ArtifactTaskOptions } from "./application/artifact-tasks.types.ts";
-export { sqliteTaskQueue } from "./infrastructure/task-queue.ts";
-export { serveTaskQueue, httpTaskQueue, } from "./infrastructure/task-queue-http.ts";
+export { createSqliteTaskQueue } from "./infrastructure/task-queue.ts";
+export { serveTaskQueue, createHttpTaskQueue, } from "./infrastructure/task-queue-http.ts";
 export { runQueueWorker } from "./application/queue-worker.ts";
-export { queuedTask } from "./application/queued-task.ts";
-export type { QueueRequest, QueueResult, QueueJob, QueueClaim, QueueLease, TaskQueue, DurableTaskQueue, } from "./domain/task-queue.types.ts";
+export { defineQueuedTask } from "./application/queued-task.ts";
+export type { QueueRequest, QueueResult, QueueQuota, QueueJob, QueueClaim, QueueLease, TaskQueue, DurableTaskQueue, } from "./domain/task-queue.types.ts";
 export type { QueueServerOptions, QueueServer, QueueClientOptions, } from "./infrastructure/task-queue-http.types.ts";
 export type { QueueHandlerContext, QueueHandler, QueueWorkerOptions, } from "./application/queue-worker.types.ts";
 export type { QueuedTaskOptions } from "./application/queued-task.types.ts";
+export { createCronSchedule } from "./domain/cron.ts";
+export type { CronOptions, CronSchedule } from "./domain/cron.types.ts";
+export type { TriggerJob, TriggerJobInput, } from "./domain/trigger-job.types.ts";
+export { runSchedules } from "./application/schedules.ts";
+export { serveTriggers } from "./infrastructure/trigger-server.ts";
+export type { TriggerFailure, TriggerRoute, TriggerServer, TriggerServerOptions, } from "./infrastructure/trigger-server.types.ts";
+export type { TriggerEvent, TriggerHttpRequest, TriggerOutcome, TriggerReply, TriggerSecret, TriggerSource, } from "./domain/trigger.types.ts";
+export { createGithubWebhook } from "./adapters/triggers/github-webhook.ts";
+export { createGitlabWebhook } from "./adapters/triggers/gitlab-webhook.ts";
+export { createSlackSource } from "./adapters/triggers/slack-request.ts";
+export { createStandardWebhook } from "./adapters/triggers/standard-webhook.ts";
+export { commandIssued, labelAdded, } from "./adapters/triggers/trigger-events.ts";
+export type { GithubWebhookOptions, GitlabSigningOptions, GitlabTokenOptions, GitlabWebhookOptions, SlackRequestOptions, StandardWebhookOptions, TriggerCommand, TriggerLabel, } from "./adapters/triggers/triggers.types.ts";
+export { defineWorkflowJob } from "./application/workflow-job.ts";
+export type { WorkflowJobCheckpoint, WorkflowJobContext, WorkflowJobOptions, WorkflowJobStartOptions, } from "./application/workflow-job.types.ts";
+export type { RunSchedulesOptions, ScheduleFailure, TriggerSchedule, } from "./application/schedules.types.ts";
 export type { EgressPolicy } from "./domain/egress.types.ts";
 export { recoverSpeculation } from "./infrastructure/speculation-store.ts";
 export type { SpeculationRecoveryOptions } from "./infrastructure/speculation-store.types.ts";
 export { checkSpeculationIntegration } from "./application/speculation-integration.ts";
 export { speculate } from "./application/speculation.ts";
 export type { SpeculationDurability, SpeculationIntegration, SpeculationOptions, SpeculationResult, SpeculativeCandidate, SpeculativeCandidateResult, SpeculativeOutput, SpeculativeHostSnapshot, SpeculativeValidation, } from "./application/speculation.types.ts";
-export { openaiModelProvider } from "./adapters/models/openai-model-provider.ts";
+export { createOpenAIModelProvider } from "./adapters/models/openai-model-provider.ts";
 export type { OpenAIModelProviderOptions } from "./adapters/models/openai-model-provider.types.ts";
 export type { AgentModel, ModelContentBlock, ModelMessage, ModelProvider, ModelReasoning, ModelReasoningBlock, ModelRequest, ModelResult, ModelSpec, ModelStopReason, ModelStreamEvent, ModelTextBlock, ModelToolCallBlock, ModelToolResultBlock, ModelToolSpec, } from "./domain/model.types.ts";
-export { anthropicModelProvider } from "./adapters/models/anthropic-model-provider.ts";
+export { createAnthropicModelProvider } from "./adapters/models/anthropic-model-provider.ts";
 export type { AnthropicModelProviderOptions } from "./adapters/models/anthropic-model-provider.types.ts";
 export { createObservationHub } from "./domain/observation.ts";
 export type { Observation, ObservationScope, ObservationSource, ObservationEvent, OperationEvent, ObservationHub, ObservationHubOptions, ObservationSink, } from "./domain/observation.types.ts";
-export { signWorkflowDecision, ed25519DecisionVerifier, } from "./infrastructure/workflow-decision-signature.ts";
+export { signWorkflowDecision, createEd25519DecisionVerifier, } from "./infrastructure/workflow-decision-signature.ts";
 export type { WorkflowDecisionSigningOptions, WorkflowApproverKey, WorkflowDecisionVerifierOptions, } from "./infrastructure/workflow-decision-signature.types.ts";
+export { defineInteractiveAgentTask } from "./application/interactive-task.ts";
+export type { InteractiveAgentTaskOptions, InteractiveAgentResult, } from "./application/interactive-task.types.ts";
+export type { WorkflowInputQuestion, WorkflowInputRequest, WorkflowAnswer, WorkflowAnswerRecord, TaskInteraction, TaskInteractionRecord, TaskInteractionContext, } from "./domain/workflow/input.types.ts";
+export { defineLoopTask, LoopTaskExhausted, } from "./domain/workflow/loop-task.ts";
+export type { TaskCacheAccessOptions, TaskCacheEntry, TaskCacheMode, TaskCacheOptions, TaskCacheOutcome, TaskCacheStore, } from "./domain/workflow/task-cache.types.ts";
+export type { LoopCheckResult, LoopTaskContext, LoopTaskOptions, LoopRoundRecord, } from "./domain/workflow/loop-task.types.ts";