@elie-laloum/outpost 7.0.0 → 9.0.0

package/dist/domain/workflow/task-cache.js

@@ -0,0 +1,92 @@
+import { checkpointValue } from "./checkpoint-value.js";
+import { taskCacheFormat, taskCacheModes } from "./task-cache.constants.js";
+import { taskCacheFingerprint, validateTaskCacheEntry, } from "./task-cache-entry.js";
+function message(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+function notify(item, runtime, cache, error) {
+    runtime.emit({
+        type: "cache",
+        key: item.key,
+        cache,
+        ...(error === undefined ? {} : { error: message(error) }),
+    });
+}
+export function validateTaskCache(options) {
+    if (!options ||
+        typeof options !== "object" ||
+        typeof options.store?.read !== "function" ||
+        typeof options.store.write !== "function" ||
+        typeof options.key !== "function")
+        throw new Error("Task cache requires a store and a key function");
+    if (typeof options.version !== "string" || !options.version.trim())
+        throw new Error("Task cache version must not be empty");
+    if (options.maxAgeMs !== undefined &&
+        (!Number.isSafeInteger(options.maxAgeMs) || options.maxAgeMs < 1))
+        throw new Error("cache.maxAgeMs must be a positive integer");
+    if (options.mode !== undefined && !taskCacheModes.includes(options.mode))
+        throw new Error("cache.mode must be reuse or refresh");
+}
+/** Key errors fail the task; store and entry errors only degrade to a miss. */
+export async function lookupTaskCache(item, cache, runtime) {
+    const { signal } = runtime;
+    const key = await cache.key(runtime.context(item, 0, signal));
+    signal.throwIfAborted();
+    const fingerprint = taskCacheFingerprint(runtime.workflow, item.key, cache.version, key);
+    if (cache.mode === "refresh") {
+        notify(item, runtime, "miss");
+        return { hit: false, fingerprint };
+    }
+    try {
+        const entry = await cache.store.read(fingerprint, { signal });
+        signal.throwIfAborted();
+        if (entry === undefined) {
+            notify(item, runtime, "miss");
+            return { hit: false, fingerprint };
+        }
+        validateTaskCacheEntry(entry, fingerprint);
+        if (cache.maxAgeMs !== undefined &&
+            Date.now() - Date.parse(entry.createdAt) > cache.maxAgeMs) {
+            notify(item, runtime, "miss");
+            return { hit: false, fingerprint };
+        }
+        notify(item, runtime, "hit");
+        return {
+            hit: true,
+            value: entry.value.kind === "json"
+                ? structuredClone(entry.value.value)
+                : undefined,
+        };
+    }
+    catch (error) {
+        signal.throwIfAborted();
+        notify(item, runtime, "failed", error);
+        return { hit: false, fingerprint };
+    }
+}
+export async function storeTaskCache(item, cache, runtime, fingerprint, value) {
+    let output;
+    try {
+        output = checkpointValue(value);
+    }
+    catch (error) {
+        throw new Error(`Cached task results must be lossless JSON values or undefined: ${message(error)}`);
+    }
+    try {
+        await cache.store.write(Object.freeze({
+            format: taskCacheFormat,
+            fingerprint,
+            workflow: runtime.workflow,
+            task: item.key,
+            version: cache.version,
+            createdAt: new Date().toISOString(),
+            value: output,
+        }), { signal: runtime.signal });
+        notify(item, runtime, "stored");
+    }
+    catch (error) {
+        runtime.signal.throwIfAborted();
+        notify(item, runtime, "failed", error);
+    }
+}
+//# sourceMappingURL=task-cache.js.map

package/dist/domain/workflow/task-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-cache.js","sourceRoot":"","sources":["../../../src/domain/workflow/task-cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC5E,OAAO,EACL,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,uBAAuB,CAAC;AAQ/B,SAAS,OAAO,CAAC,KAAc;IAC7B,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAChE,CAAC;AAED,SAAS,MAAM,CACb,IAAU,EACV,OAA+B,EAC/B,KAAuB,EACvB,KAAe;IAEf,OAAO,CAAC,IAAI,CAAC;QACX,IAAI,EAAE,OAAO;QACb,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,KAAK;QACL,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;KAC1D,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,OAAyB;IACzD,IACE,CAAC,OAAO;QACR,OAAO,OAAO,KAAK,QAAQ;QAC3B,OAAO,OAAO,CAAC,KAAK,EAAE,IAAI,KAAK,UAAU;QACzC,OAAO,OAAO,CAAC,KAAK,CAAC,KAAK,KAAK,UAAU;QACzC,OAAO,OAAO,CAAC,GAAG,KAAK,UAAU;QAEjC,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;IACpE,IAAI,OAAO,OAAO,CAAC,OAAO,KAAK,QAAQ,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE;QAChE,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;IAC1D,IACE,OAAO,CAAC,QAAQ,KAAK,SAAS;QAC9B,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QAEjE,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAC/D,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC;QACtE,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;AAC3D,CAAC;AAED,+EAA+E;AAC/E,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,IAAU,EACV,KAAuB,EACvB,OAA+B;IAE/B,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IAC3B,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;IAC9D,MAAM,CAAC,cAAc,EAAE,CAAC;IACxB,MAAM,WAAW,GAAG,oBAAoB,CACtC,OAAO,CAAC,QAAQ,EAChB,IAAI,CAAC,GAAG,EACR,KAAK,CAAC,OAAO,EACb,GAAG,CACJ,CAAC;IACF,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC7B,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QAC9B,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC;IACrC,CAAC;IACD,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;QAC9D,MAAM,CAAC,cAAc,EAAE,CAAC;QACxB,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;YAC9B,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC;QACrC,CAAC;QACD,sBAAsB,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;QAC3C,IACE,KAAK,CAAC,QAAQ,KAAK,SAAS;YAC5B,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,GAAG,KAAK,CAAC,QAAQ,EACzD,CAAC;YACD,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;YAC9B,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC;QACrC,CAAC;QACD,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;QAC7B,OAAO;YACL,GAAG,EAAE,IAAI;YACT,KAAK,EACH,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,MAAM;gBACzB,CAAC,CAAC,eAAe,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC;gBACpC,CAAC,CAAC,SAAS;SAChB,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,cAAc,EAAE,CAAC;QACxB,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;QACvC,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC;IACrC,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,IAAU,EACV,KAAuB,EACvB,OAA+B,EAC/B,WAAmB,EACnB,KAAc;IAEd,IAAI,MAAM,CAAC;IACX,IAAI,CAAC;QACH,MAAM,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,kEAAkE,OAAO,CAAC,KAAK,CAAC,EAAE,CACnF,CAAC;IACJ,CAAC;IACD,IAAI,CAAC;QACH,MAAM,KAAK,CAAC,KAAK,CAAC,KAAK,CACrB,MAAM,CAAC,MAAM,CAAC;YACZ,MAAM,EAAE,eAAe;YACvB,WAAW;YACX,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,IAAI,EAAE,IAAI,CAAC,GAAG;YACd,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,KAAK,EAAE,MAAM;SACd,CAAC,EACF,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAC3B,CAAC;QACF,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;IAClC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;QAChC,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;IACzC,CAAC;AACH,CAAC","sourcesContent":["import { checkpointValue } from \"./checkpoint-value.ts\";\nimport { taskCacheFormat, taskCacheModes } from \"./task-cache.constants.ts\";\nimport {\n  taskCacheFingerprint,\n  validateTaskCacheEntry,\n} from \"./task-cache-entry.ts\";\nimport type { Task, WorkflowExecutionState } from \"../workflow.types.ts\";\nimport type {\n  TaskCacheLookup,\n  TaskCacheOptions,\n  TaskCacheOutcome,\n} from \"./task-cache.types.ts\";\n\nfunction message(error: unknown): string {\n  return error instanceof Error ? error.message : String(error);\n}\n\nfunction notify(\n  item: Task,\n  runtime: WorkflowExecutionState,\n  cache: TaskCacheOutcome,\n  error?: unknown,\n): void {\n  runtime.emit({\n    type: \"cache\",\n    key: item.key,\n    cache,\n    ...(error === undefined ? {} : { error: message(error) }),\n  });\n}\n\nexport function validateTaskCache(options: TaskCacheOptions): void {\n  if (\n    !options ||\n    typeof options !== \"object\" ||\n    typeof options.store?.read !== \"function\" ||\n    typeof options.store.write !== \"function\" ||\n    typeof options.key !== \"function\"\n  )\n    throw new Error(\"Task cache requires a store and a key function\");\n  if (typeof options.version !== \"string\" || !options.version.trim())\n    throw new Error(\"Task cache version must not be empty\");\n  if (\n    options.maxAgeMs !== undefined &&\n    (!Number.isSafeInteger(options.maxAgeMs) || options.maxAgeMs < 1)\n  )\n    throw new Error(\"cache.maxAgeMs must be a positive integer\");\n  if (options.mode !== undefined && !taskCacheModes.includes(options.mode))\n    throw new Error(\"cache.mode must be reuse or refresh\");\n}\n\n/** Key errors fail the task; store and entry errors only degrade to a miss. */\nexport async function lookupTaskCache(\n  item: Task,\n  cache: TaskCacheOptions,\n  runtime: WorkflowExecutionState,\n): Promise<TaskCacheLookup> {\n  const { signal } = runtime;\n  const key = await cache.key(runtime.context(item, 0, signal));\n  signal.throwIfAborted();\n  const fingerprint = taskCacheFingerprint(\n    runtime.workflow,\n    item.key,\n    cache.version,\n    key,\n  );\n  if (cache.mode === \"refresh\") {\n    notify(item, runtime, \"miss\");\n    return { hit: false, fingerprint };\n  }\n  try {\n    const entry = await cache.store.read(fingerprint, { signal });\n    signal.throwIfAborted();\n    if (entry === undefined) {\n      notify(item, runtime, \"miss\");\n      return { hit: false, fingerprint };\n    }\n    validateTaskCacheEntry(entry, fingerprint);\n    if (\n      cache.maxAgeMs !== undefined &&\n      Date.now() - Date.parse(entry.createdAt) > cache.maxAgeMs\n    ) {\n      notify(item, runtime, \"miss\");\n      return { hit: false, fingerprint };\n    }\n    notify(item, runtime, \"hit\");\n    return {\n      hit: true,\n      value:\n        entry.value.kind === \"json\"\n          ? structuredClone(entry.value.value)\n          : undefined,\n    };\n  } catch (error) {\n    signal.throwIfAborted();\n    notify(item, runtime, \"failed\", error);\n    return { hit: false, fingerprint };\n  }\n}\n\nexport async function storeTaskCache(\n  item: Task,\n  cache: TaskCacheOptions,\n  runtime: WorkflowExecutionState,\n  fingerprint: string,\n  value: unknown,\n): Promise<void> {\n  let output;\n  try {\n    output = checkpointValue(value);\n  } catch (error) {\n    throw new Error(\n      `Cached task results must be lossless JSON values or undefined: ${message(error)}`,\n    );\n  }\n  try {\n    await cache.store.write(\n      Object.freeze({\n        format: taskCacheFormat,\n        fingerprint,\n        workflow: runtime.workflow,\n        task: item.key,\n        version: cache.version,\n        createdAt: new Date().toISOString(),\n        value: output,\n      }),\n      { signal: runtime.signal },\n    );\n    notify(item, runtime, \"stored\");\n  } catch (error) {\n    runtime.signal.throwIfAborted();\n    notify(item, runtime, \"failed\", error);\n  }\n}\n"]}

package/dist/domain/workflow/task-cache.types.d.ts

@@ -0,0 +1,35 @@
+import type { TaskContext } from "../workflow.types.ts";
+import type { WorkflowCheckpointValue, WorkflowJson } from "./checkpoint.types.ts";
+export type TaskCacheMode = "reuse" | "refresh";
+export type TaskCacheOutcome = "hit" | "miss" | "stored" | "failed";
+export interface TaskCacheEntry {
+    readonly format: 1;
+    readonly fingerprint: string;
+    readonly workflow: string;
+    readonly task: string;
+    readonly version: string;
+    readonly createdAt: string;
+    readonly value: WorkflowCheckpointValue;
+}
+export interface TaskCacheAccessOptions {
+    readonly signal?: AbortSignal;
+}
+export interface TaskCacheStore {
+    read(fingerprint: string, options?: TaskCacheAccessOptions): Promise<TaskCacheEntry | undefined>;
+    write(entry: TaskCacheEntry, options?: TaskCacheAccessOptions): Promise<void>;
+}
+export interface TaskCacheOptions {
+    readonly store: TaskCacheStore;
+    /** Change when the task implementation, agent or output contract changes. */
+    readonly version: string;
+    readonly key: (context: TaskContext) => WorkflowJson | Promise<WorkflowJson>;
+    readonly maxAgeMs?: number;
+    readonly mode?: TaskCacheMode;
+}
+export type TaskCacheLookup = {
+    readonly hit: true;
+    readonly value: unknown;
+} | {
+    readonly hit: false;
+    readonly fingerprint: string;
+};

package/dist/domain/workflow/task-cache.types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=task-cache.types.js.map

package/dist/domain/workflow/task-cache.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-cache.types.js","sourceRoot":"","sources":["../../../src/domain/workflow/task-cache.types.ts"],"names":[],"mappings":"","sourcesContent":["import type { TaskContext } from \"../workflow.types.ts\";\nimport type {\n  WorkflowCheckpointValue,\n  WorkflowJson,\n} from \"./checkpoint.types.ts\";\n\nexport type TaskCacheMode = \"reuse\" | \"refresh\";\n\nexport type TaskCacheOutcome = \"hit\" | \"miss\" | \"stored\" | \"failed\";\n\nexport interface TaskCacheEntry {\n  readonly format: 1;\n  readonly fingerprint: string;\n  readonly workflow: string;\n  readonly task: string;\n  readonly version: string;\n  readonly createdAt: string;\n  readonly value: WorkflowCheckpointValue;\n}\n\nexport interface TaskCacheAccessOptions {\n  readonly signal?: AbortSignal;\n}\n\nexport interface TaskCacheStore {\n  read(\n    fingerprint: string,\n    options?: TaskCacheAccessOptions,\n  ): Promise<TaskCacheEntry | undefined>;\n  write(entry: TaskCacheEntry, options?: TaskCacheAccessOptions): Promise<void>;\n}\n\nexport interface TaskCacheOptions {\n  readonly store: TaskCacheStore;\n  /** Change when the task implementation, agent or output contract changes. */\n  readonly version: string;\n  readonly key: (context: TaskContext) => WorkflowJson | Promise<WorkflowJson>;\n  readonly maxAgeMs?: number;\n  readonly mode?: TaskCacheMode;\n}\n\nexport type TaskCacheLookup =\n  | { readonly hit: true; readonly value: unknown }\n  | { readonly hit: false; readonly fingerprint: string };\n"]}

package/dist/domain/workflow/task-runner.js

@@ -1,12 +1,21 @@
+import { InputSuspension } from "./input.js";
+import { loopDefinition } from "./loop-task.js";
+import { runLoopTask } from "./loop-runner.js";
 import { checkpointValue } from "./checkpoint-value.js";
 import { WorkflowBudgetExceeded, WorkflowUsageUnavailable } from "./budget.js";
+import { awaitQuotaReset, pauseForQuota } from "./quota-pause.js";
 import { retryDelay, waitForRetry } from "./retry.js";
+import { lookupTaskCache, storeTaskCache } from "./task-cache.js";
+import { quotaFault } from "../quota.js";
 export async function runTask(item, runtime) {
-    const { record, signal, context, emit, finish, values, errors, options, stop, } = runtime;
+    const { record, signal, context, emit, finish, errors, options, stop, values, } = runtime;
     const state = record(item);
+    if (state.quota && !(await awaitQuotaReset(item, runtime, true)))
+        return;
     state.status = "active";
     delete state.error;
     delete state.finishedAt;
+    delete state.cacheHit;
     state.startedAt = new Date().toISOString();
     emit({ type: "task", key: item.key, status: "active", attempt: 0 });
     try {
@@ -17,45 +26,30 @@ export async function runTask(item, runtime) {
             finish(item, "skipped");
             return;
         }
-        const limit = item.retry?.attempts ?? 1;
-        const priorAttempts = state.attempts;
-        for (let cycle = 1; cycle <= limit; cycle++) {
-            const attempt = priorAttempts + cycle;
-            signal.throwIfAborted();
-            runtime.accounting.admit();
-            state.attempts = attempt;
-            emit({ type: "attempt", key: item.key, attempt });
-            await runtime.persist();
-            let delayMs = 0;
-            const deadline = new AbortController();
-            const timer = item.timeoutMs === undefined
-                ? undefined
-                : setTimeout(() => deadline.abort(new Error(`${item.key} timed out`)), item.timeoutMs);
-            const taskSignal = AbortSignal.any([signal, deadline.signal]);
+        const cache = item.cache
+            ? await lookupTaskCache(item, item.cache, runtime)
+            : undefined;
+        if (cache?.hit) {
+            values.set(item, cache.value);
+            state.cacheHit = true;
+            finish(item, "done");
+            return;
+        }
+        while (true) {
             try {
-                taskSignal.throwIfAborted();
-                const value = await item.perform(context(item, attempt, taskSignal));
-                taskSignal.throwIfAborted();
-                if (options.checkpoint)
-                    checkpointValue(value);
-                values.set(item, value);
-                finish(item, "done");
+                await perform(item, runtime, cache);
                 return;
             }
             catch (error) {
-                runtime.closeAttempt(item);
-                if (signal.aborted ||
-                    cycle === limit ||
-                    item.retry?.accepts?.(error, attempt) === false)
+                if (!(await pauseForQuota(item, runtime, error)))
                     throw error;
-                delayMs = retryDelay(item.retry, cycle, error);
-                emit({ type: "retry", key: item.key, attempt, delayMs });
+                if (!(await awaitQuotaReset(item, runtime, false)))
+                    return;
+                state.status = "active";
+                delete state.finishedAt;
+                emit({ type: "task", key: item.key, status: "active", attempt: 0 });
+                await runtime.persist();
             }
-            finally {
-                runtime.closeAttempt(item);
-                clearTimeout(timer);
-            }
-            await waitForRetry(delayMs, signal);
         }
     }
     catch (error) {
@@ -76,4 +70,76 @@ export async function runTask(item, runtime) {
         await runtime.persist();
     }
 }
+async function complete(item, runtime, cache, value) {
+    if (item.cache && cache && !cache.hit)
+        await storeTaskCache(item, item.cache, runtime, cache.fingerprint, value);
+    runtime.values.set(item, value);
+    runtime.finish(item, "done");
+}
+async function perform(item, runtime, cache) {
+    const { record, signal, context, emit, finish, options } = runtime;
+    const state = record(item);
+    const loop = loopDefinition(item);
+    if (loop) {
+        const value = await runLoopTask(item, loop, runtime);
+        signal.throwIfAborted();
+        await complete(item, runtime, cache, value);
+        return;
+    }
+    const limit = item.retry?.attempts ?? 1;
+    const priorAttempts = state.attempts;
+    for (let cycle = 1; cycle <= limit; cycle++) {
+        const attempt = priorAttempts + cycle;
+        signal.throwIfAborted();
+        runtime.accounting.admit();
+        state.attempts = attempt;
+        emit({ type: "attempt", key: item.key, attempt });
+        await runtime.persist();
+        let delayMs = 0;
+        let completed = false;
+        let value;
+        const deadline = new AbortController();
+        const timer = item.timeoutMs === undefined
+            ? undefined
+            : setTimeout(() => deadline.abort(new Error(`${item.key} timed out`)), item.timeoutMs);
+        const taskSignal = AbortSignal.any([signal, deadline.signal]);
+        try {
+            taskSignal.throwIfAborted();
+            value = await item.perform(context(item, attempt, taskSignal));
+            taskSignal.throwIfAborted();
+            if (options.checkpoint)
+                checkpointValue(value);
+            completed = true;
+        }
+        catch (error) {
+            runtime.closeAttempt(item);
+            if (error instanceof InputSuspension && item.interaction) {
+                state.interaction = error.interaction;
+                finish(item, "waiting-input");
+                emit({
+                    type: "input-request",
+                    key: item.key,
+                    status: "waiting-input",
+                });
+                return;
+            }
+            if (signal.aborted ||
+                cycle === limit ||
+                (options.onQuota && quotaFault(error)) ||
+                item.retry?.accepts?.(error, attempt) === false)
+                throw error;
+            delayMs = retryDelay(item.retry, cycle, error);
+            emit({ type: "retry", key: item.key, attempt, delayMs });
+        }
+        finally {
+            runtime.closeAttempt(item);
+            clearTimeout(timer);
+        }
+        if (completed) {
+            await complete(item, runtime, cache, value);
+            return;
+        }
+        await waitForRetry(delayMs, signal);
+    }
+}
 //# sourceMappingURL=task-runner.js.map

package/dist/domain/workflow/task-runner.js.map

@@ -1 +1 @@
-{"version":3,"file":"task-runner.js","sourceRoot":"","sources":["../../../src/domain/workflow/task-runner.ts"],"names":[],"mappings":"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","sourcesContent":["import { checkpointValue } from \"./checkpoint-value.ts\";\nimport { WorkflowBudgetExceeded, WorkflowUsageUnavailable } from \"./budget.ts\";\nimport { retryDelay, waitForRetry } from \"./retry.ts\";\nimport type { Task, WorkflowExecutionState } from \"../workflow.types.ts\";\n\nexport async function runTask(\n  item: Task,\n  runtime: WorkflowExecutionState,\n): Promise<void> {\n  const {\n    record,\n    signal,\n    context,\n    emit,\n    finish,\n    values,\n    errors,\n    options,\n    stop,\n  } = runtime;\n  const state = record(item);\n  state.status = \"active\";\n  delete state.error;\n  delete state.finishedAt;\n  state.startedAt = new Date().toISOString();\n  emit({ type: \"task\", key: item.key, status: \"active\", attempt: 0 });\n  try {\n    await runtime.persist();\n    signal.throwIfAborted();\n    if (item.condition && !(await item.condition(context(item, 0, signal)))) {\n      signal.throwIfAborted();\n      finish(item, \"skipped\");\n      return;\n    }\n    const limit = item.retry?.attempts ?? 1;\n    const priorAttempts = state.attempts;\n    for (let cycle = 1; cycle <= limit; cycle++) {\n      const attempt = priorAttempts + cycle;\n      signal.throwIfAborted();\n      runtime.accounting.admit();\n      state.attempts = attempt;\n      emit({ type: \"attempt\", key: item.key, attempt });\n      await runtime.persist();\n      let delayMs = 0;\n      const deadline = new AbortController();\n      const timer =\n        item.timeoutMs === undefined\n          ? undefined\n          : setTimeout(\n              () => deadline.abort(new Error(`${item.key} timed out`)),\n              item.timeoutMs,\n            );\n      const taskSignal = AbortSignal.any([signal, deadline.signal]);\n      try {\n        taskSignal.throwIfAborted();\n        const value = await item.perform(context(item, attempt, taskSignal));\n        taskSignal.throwIfAborted();\n        if (options.checkpoint) checkpointValue(value);\n        values.set(item, value);\n        finish(item, \"done\");\n        return;\n      } catch (error) {\n        runtime.closeAttempt(item);\n        if (\n          signal.aborted ||\n          cycle === limit ||\n          item.retry?.accepts?.(error, attempt) === false\n        )\n          throw error;\n        delayMs = retryDelay(item.retry, cycle, error);\n        emit({ type: \"retry\", key: item.key, attempt, delayMs });\n      } finally {\n        runtime.closeAttempt(item);\n        clearTimeout(timer);\n      }\n      await waitForRetry(delayMs, signal);\n    }\n  } catch (error) {\n    state.error = error instanceof Error ? error.message : String(error);\n    if (\n      signal.aborted ||\n      ((error instanceof WorkflowBudgetExceeded ||\n        error instanceof WorkflowUsageUnavailable) &&\n        runtime.accounting.exhausted)\n    )\n      finish(item, \"cancelled\");\n    else {\n      errors.push(error);\n      finish(item, \"failed\");\n      if (options.stopOnError !== false) stop.abort(error);\n    }\n  } finally {\n    await runtime.persist();\n  }\n}\n"]}
+{"version":3,"file":"task-runner.js","sourceRoot":"","sources":["../../../src/domain/workflow/task-runner.ts"],"names":[],"mappings":"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","sourcesContent":["import { InputSuspension } from \"./input.ts\";\nimport { loopDefinition } from \"./loop-task.ts\";\nimport { runLoopTask } from \"./loop-runner.ts\";\nimport { checkpointValue } from \"./checkpoint-value.ts\";\nimport { WorkflowBudgetExceeded, WorkflowUsageUnavailable } from \"./budget.ts\";\nimport { awaitQuotaReset, pauseForQuota } from \"./quota-pause.ts\";\nimport { retryDelay, waitForRetry } from \"./retry.ts\";\nimport { lookupTaskCache, storeTaskCache } from \"./task-cache.ts\";\nimport { quotaFault } from \"../quota.ts\";\nimport type { Task, WorkflowExecutionState } from \"../workflow.types.ts\";\nimport type { TaskCacheLookup } from \"./task-cache.types.ts\";\n\nexport async function runTask(\n  item: Task,\n  runtime: WorkflowExecutionState,\n): Promise<void> {\n  const {\n    record,\n    signal,\n    context,\n    emit,\n    finish,\n    errors,\n    options,\n    stop,\n    values,\n  } = runtime;\n  const state = record(item);\n  if (state.quota && !(await awaitQuotaReset(item, runtime, true))) return;\n  state.status = \"active\";\n  delete state.error;\n  delete state.finishedAt;\n  delete state.cacheHit;\n  state.startedAt = new Date().toISOString();\n  emit({ type: \"task\", key: item.key, status: \"active\", attempt: 0 });\n  try {\n    await runtime.persist();\n    signal.throwIfAborted();\n    if (item.condition && !(await item.condition(context(item, 0, signal)))) {\n      signal.throwIfAborted();\n      finish(item, \"skipped\");\n      return;\n    }\n    const cache = item.cache\n      ? await lookupTaskCache(item, item.cache, runtime)\n      : undefined;\n    if (cache?.hit) {\n      values.set(item, cache.value);\n      state.cacheHit = true;\n      finish(item, \"done\");\n      return;\n    }\n    while (true) {\n      try {\n        await perform(item, runtime, cache);\n        return;\n      } catch (error) {\n        if (!(await pauseForQuota(item, runtime, error))) throw error;\n        if (!(await awaitQuotaReset(item, runtime, false))) return;\n        state.status = \"active\";\n        delete state.finishedAt;\n        emit({ type: \"task\", key: item.key, status: \"active\", attempt: 0 });\n        await runtime.persist();\n      }\n    }\n  } catch (error) {\n    state.error = error instanceof Error ? error.message : String(error);\n    if (\n      signal.aborted ||\n      ((error instanceof WorkflowBudgetExceeded ||\n        error instanceof WorkflowUsageUnavailable) &&\n        runtime.accounting.exhausted)\n    )\n      finish(item, \"cancelled\");\n    else {\n      errors.push(error);\n      finish(item, \"failed\");\n      if (options.stopOnError !== false) stop.abort(error);\n    }\n  } finally {\n    await runtime.persist();\n  }\n}\n\nasync function complete(\n  item: Task,\n  runtime: WorkflowExecutionState,\n  cache: TaskCacheLookup | undefined,\n  value: unknown,\n): Promise<void> {\n  if (item.cache && cache && !cache.hit)\n    await storeTaskCache(item, item.cache, runtime, cache.fingerprint, value);\n  runtime.values.set(item, value);\n  runtime.finish(item, \"done\");\n}\n\nasync function perform(\n  item: Task,\n  runtime: WorkflowExecutionState,\n  cache: TaskCacheLookup | undefined,\n): Promise<void> {\n  const { record, signal, context, emit, finish, options } = runtime;\n  const state = record(item);\n  const loop = loopDefinition(item);\n  if (loop) {\n    const value = await runLoopTask(item, loop, runtime);\n    signal.throwIfAborted();\n    await complete(item, runtime, cache, value);\n    return;\n  }\n  const limit = item.retry?.attempts ?? 1;\n  const priorAttempts = state.attempts;\n  for (let cycle = 1; cycle <= limit; cycle++) {\n    const attempt = priorAttempts + cycle;\n    signal.throwIfAborted();\n    runtime.accounting.admit();\n    state.attempts = attempt;\n    emit({ type: \"attempt\", key: item.key, attempt });\n    await runtime.persist();\n    let delayMs = 0;\n    let completed = false;\n    let value: unknown;\n    const deadline = new AbortController();\n    const timer =\n      item.timeoutMs === undefined\n        ? undefined\n        : setTimeout(\n            () => deadline.abort(new Error(`${item.key} timed out`)),\n            item.timeoutMs,\n          );\n    const taskSignal = AbortSignal.any([signal, deadline.signal]);\n    try {\n      taskSignal.throwIfAborted();\n      value = await item.perform(context(item, attempt, taskSignal));\n      taskSignal.throwIfAborted();\n      if (options.checkpoint) checkpointValue(value);\n      completed = true;\n    } catch (error) {\n      runtime.closeAttempt(item);\n      if (error instanceof InputSuspension && item.interaction) {\n        state.interaction = error.interaction;\n        finish(item, \"waiting-input\");\n        emit({\n          type: \"input-request\",\n          key: item.key,\n          status: \"waiting-input\",\n        });\n        return;\n      }\n      if (\n        signal.aborted ||\n        cycle === limit ||\n        (options.onQuota && quotaFault(error)) ||\n        item.retry?.accepts?.(error, attempt) === false\n      )\n        throw error;\n      delayMs = retryDelay(item.retry, cycle, error);\n      emit({ type: \"retry\", key: item.key, attempt, delayMs });\n    } finally {\n      runtime.closeAttempt(item);\n      clearTimeout(timer);\n    }\n    if (completed) {\n      await complete(item, runtime, cache, value);\n      return;\n    }\n    await waitForRetry(delayMs, signal);\n  }\n}\n"]}

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

@@ -1,2 +1,2 @@
 import type { Task, TaskOptions } from "../workflow.types.ts";
-export declare function task<T>(options: TaskOptions<T>): Task<T>;
+export declare function defineTask<T>(options: TaskOptions<T>): Task<T>;

package/dist/domain/workflow/task.js

@@ -1,18 +1,39 @@
+import { validateInteraction } from "./input-validation.js";
 import { validateRetry } from "./retry.js";
 import { maxTimerMs } from "./retry.constants.js";
 import { positive } from "./validation.js";
-export function task(options) {
+import { validateTaskCache } from "./task-cache.js";
+export function defineTask(options) {
     if (!/^[A-Za-z0-9][A-Za-z0-9._-]*$/.test(options.key))
         throw new Error(`Invalid task key: ${options.key}`);
     if (options.timeoutMs !== undefined)
         positive(options.timeoutMs, "timeoutMs");
     if (options.timeoutMs !== undefined && options.timeoutMs > maxTimerMs)
         throw new Error("timeoutMs exceeds the supported timer range");
+    if (options.interaction) {
+        validateInteraction(options.interaction);
+        if (options.gate)
+            throw new Error("A task cannot be both an interaction and a gate");
+    }
     if (options.retry)
         validateRetry(options.retry);
+    if (options.cache !== undefined) {
+        validateTaskCache(options.cache);
+        if (options.interaction || options.gate)
+            throw new Error("Interactions and gates cannot use a task cache");
+    }
     return Object.freeze({
         ...options,
+        ...(options.interaction
+            ? {
+                interaction: Object.freeze({
+                    ...options.interaction,
+                    actors: Object.freeze([...options.interaction.actors]),
+                }),
+            }
+            : {}),
         ...(options.retry ? { retry: Object.freeze({ ...options.retry }) } : {}),
+        ...(options.cache ? { cache: Object.freeze({ ...options.cache }) } : {}),
         after: Object.freeze([...(options.after ?? [])]),
     });
 }

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

@@ -1 +1 @@
-{"version":3,"file":"task.js","sourceRoot":"","sources":["../../../src/domain/workflow/task.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAElD,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE3C,MAAM,UAAU,IAAI,CAAI,OAAuB;IAC7C,IAAI,CAAC,8BAA8B,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC;QACnD,MAAM,IAAI,KAAK,CAAC,qBAAqB,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IACtD,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS;QAAE,QAAQ,CAAC,OAAO,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IAC9E,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS,IAAI,OAAO,CAAC,SAAS,GAAG,UAAU;QACnE,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;IACjE,IAAI,OAAO,CAAC,KAAK;QAAE,aAAa,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAChD,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,GAAG,OAAO;QACV,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxE,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC;KACjD,CAAC,CAAC;AACL,CAAC","sourcesContent":["import { validateRetry } from \"./retry.ts\";\nimport { maxTimerMs } from \"./retry.constants.ts\";\nimport type { Task, TaskOptions } from \"../workflow.types.ts\";\nimport { positive } from \"./validation.ts\";\n\nexport function task<T>(options: TaskOptions<T>): Task<T> {\n  if (!/^[A-Za-z0-9][A-Za-z0-9._-]*$/.test(options.key))\n    throw new Error(`Invalid task key: ${options.key}`);\n  if (options.timeoutMs !== undefined) positive(options.timeoutMs, \"timeoutMs\");\n  if (options.timeoutMs !== undefined && options.timeoutMs > maxTimerMs)\n    throw new Error(\"timeoutMs exceeds the supported timer range\");\n  if (options.retry) validateRetry(options.retry);\n  return Object.freeze({\n    ...options,\n    ...(options.retry ? { retry: Object.freeze({ ...options.retry }) } : {}),\n    after: Object.freeze([...(options.after ?? [])]),\n  });\n}\n"]}
+{"version":3,"file":"task.js","sourceRoot":"","sources":["../../../src/domain/workflow/task.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAElD,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEpD,MAAM,UAAU,UAAU,CAAI,OAAuB;IACnD,IAAI,CAAC,8BAA8B,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC;QACnD,MAAM,IAAI,KAAK,CAAC,qBAAqB,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IACtD,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS;QAAE,QAAQ,CAAC,OAAO,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IAC9E,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS,IAAI,OAAO,CAAC,SAAS,GAAG,UAAU;QACnE,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;IACjE,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;QACxB,mBAAmB,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QACzC,IAAI,OAAO,CAAC,IAAI;YACd,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;IACvE,CAAC;IACD,IAAI,OAAO,CAAC,KAAK;QAAE,aAAa,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAChD,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAChC,iBAAiB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACjC,IAAI,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,IAAI;YACrC,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;IACtE,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,GAAG,OAAO;QACV,GAAG,CAAC,OAAO,CAAC,WAAW;YACrB,CAAC,CAAC;gBACE,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC;oBACzB,GAAG,OAAO,CAAC,WAAW;oBACtB,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;iBACvD,CAAC;aACH;YACH,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxE,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxE,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC;KACjD,CAAC,CAAC;AACL,CAAC","sourcesContent":["import { validateInteraction } from \"./input-validation.ts\";\nimport { validateRetry } from \"./retry.ts\";\nimport { maxTimerMs } from \"./retry.constants.ts\";\nimport type { Task, TaskOptions } from \"../workflow.types.ts\";\nimport { positive } from \"./validation.ts\";\nimport { validateTaskCache } from \"./task-cache.ts\";\n\nexport function defineTask<T>(options: TaskOptions<T>): Task<T> {\n  if (!/^[A-Za-z0-9][A-Za-z0-9._-]*$/.test(options.key))\n    throw new Error(`Invalid task key: ${options.key}`);\n  if (options.timeoutMs !== undefined) positive(options.timeoutMs, \"timeoutMs\");\n  if (options.timeoutMs !== undefined && options.timeoutMs > maxTimerMs)\n    throw new Error(\"timeoutMs exceeds the supported timer range\");\n  if (options.interaction) {\n    validateInteraction(options.interaction);\n    if (options.gate)\n      throw new Error(\"A task cannot be both an interaction and a gate\");\n  }\n  if (options.retry) validateRetry(options.retry);\n  if (options.cache !== undefined) {\n    validateTaskCache(options.cache);\n    if (options.interaction || options.gate)\n      throw new Error(\"Interactions and gates cannot use a task cache\");\n  }\n  return Object.freeze({\n    ...options,\n    ...(options.interaction\n      ? {\n          interaction: Object.freeze({\n            ...options.interaction,\n            actors: Object.freeze([...options.interaction.actors]),\n          }),\n        }\n      : {}),\n    ...(options.retry ? { retry: Object.freeze({ ...options.retry }) } : {}),\n    ...(options.cache ? { cache: Object.freeze({ ...options.cache }) } : {}),\n    after: Object.freeze([...(options.after ?? [])]),\n  });\n}\n"]}

package/dist/domain/workflow/validation.js

@@ -1,3 +1,4 @@
+import { validateInteraction } from "./input-validation.js";
 import { validateGate } from "./gate-validation.js";
 export function positive(value, label) {
     if (!Number.isSafeInteger(value) || value < 1)
@@ -9,10 +10,20 @@ export function validate(tasks) {
     const visiting = new Set();
     const visited = new Set();
     for (const item of tasks) {
+        if (item.interaction) {
+            validateInteraction(item.interaction);
+            if (item.cache)
+                throw new Error("Interactions and gates cannot use a task cache");
+            if (item.gate)
+                throw new Error("A task cannot be both an interaction and a gate");
+        }
         if (item.gate) {
             validateGate(item.gate);
-            if (item.condition || item.retry || item.timeoutMs !== undefined)
-                throw new Error("Workflow gates cannot have conditions, retries or timeouts");
+            if (item.condition ||
+                item.retry ||
+                item.timeoutMs !== undefined ||
+                item.cache)
+                throw new Error("Workflow gates cannot have conditions, retries, timeouts or caches");
         }
         if (keys.has(item.key))
             throw new Error(`Duplicate task: ${item.key}`);

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

@@ -1 +1 @@
-{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../../src/domain/workflow/validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAGpD,MAAM,UAAU,QAAQ,CAAC,KAAa,EAAE,KAAa;IACnD,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC;QAC3C,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,6BAA6B,CAAC,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,KAAsB;IAC7C,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;IAC/B,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAQ,CAAC;IACjC,MAAM,OAAO,GAAG,IAAI,GAAG,EAAQ,CAAC;IAChC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACxB,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS;gBAC9D,MAAM,IAAI,KAAK,CACb,4DAA4D,CAC7D,CAAC;QACN,CAAC;QACD,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;QACvE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACnB,KAAK,MAAM,UAAU,IAAI,IAAI,CAAC,KAAK;YACjC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC;gBAC1B,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,CAAC,GAAG,wBAAwB,UAAU,CAAC,GAAG,EAAE,CAAC,CAAC;IAC3E,CAAC;IACD,SAAS,KAAK,CAAC,IAAU;QACvB,IAAI,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;QAC3E,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,OAAO;QAC9B,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACnB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAC1B,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACtB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACpB,CAAC;IACD,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC","sourcesContent":["import { validateGate } from \"./gate-validation.ts\";\nimport type { Task } from \"../workflow.types.ts\";\n\nexport function positive(value: number, label: string): void {\n  if (!Number.isSafeInteger(value) || value < 1)\n    throw new Error(`${label} must be a positive integer`);\n}\n\nexport function validate(tasks: readonly Task[]): void {\n  const keys = new Set<string>();\n  const members = new Set(tasks);\n  const visiting = new Set<Task>();\n  const visited = new Set<Task>();\n  for (const item of tasks) {\n    if (item.gate) {\n      validateGate(item.gate);\n      if (item.condition || item.retry || item.timeoutMs !== undefined)\n        throw new Error(\n          \"Workflow gates cannot have conditions, retries or timeouts\",\n        );\n    }\n    if (keys.has(item.key)) throw new Error(`Duplicate task: ${item.key}`);\n    keys.add(item.key);\n    for (const dependency of item.after)\n      if (!members.has(dependency))\n        throw new Error(`${item.key}: missing dependency ${dependency.key}`);\n  }\n  function visit(item: Task): void {\n    if (visiting.has(item)) throw new Error(`Dependency cycle at ${item.key}`);\n    if (visited.has(item)) return;\n    visiting.add(item);\n    item.after.forEach(visit);\n    visiting.delete(item);\n    visited.add(item);\n  }\n  tasks.forEach(visit);\n}\n"]}
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../../src/domain/workflow/validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAGpD,MAAM,UAAU,QAAQ,CAAC,KAAa,EAAE,KAAa;IACnD,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC;QAC3C,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,6BAA6B,CAAC,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,KAAsB;IAC7C,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;IAC/B,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAQ,CAAC;IACjC,MAAM,OAAO,GAAG,IAAI,GAAG,EAAQ,CAAC;IAChC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,mBAAmB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YACtC,IAAI,IAAI,CAAC,KAAK;gBACZ,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;YACpE,IAAI,IAAI,CAAC,IAAI;gBACX,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;QACvE,CAAC;QACD,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACxB,IACE,IAAI,CAAC,SAAS;gBACd,IAAI,CAAC,KAAK;gBACV,IAAI,CAAC,SAAS,KAAK,SAAS;gBAC5B,IAAI,CAAC,KAAK;gBAEV,MAAM,IAAI,KAAK,CACb,oEAAoE,CACrE,CAAC;QACN,CAAC;QACD,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;QACvE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACnB,KAAK,MAAM,UAAU,IAAI,IAAI,CAAC,KAAK;YACjC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC;gBAC1B,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,CAAC,GAAG,wBAAwB,UAAU,CAAC,GAAG,EAAE,CAAC,CAAC;IAC3E,CAAC;IACD,SAAS,KAAK,CAAC,IAAU;QACvB,IAAI,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;QAC3E,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,OAAO;QAC9B,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACnB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAC1B,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACtB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACpB,CAAC;IACD,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC","sourcesContent":["import { validateInteraction } from \"./input-validation.ts\";\nimport { validateGate } from \"./gate-validation.ts\";\nimport type { Task } from \"../workflow.types.ts\";\n\nexport function positive(value: number, label: string): void {\n  if (!Number.isSafeInteger(value) || value < 1)\n    throw new Error(`${label} must be a positive integer`);\n}\n\nexport function validate(tasks: readonly Task[]): void {\n  const keys = new Set<string>();\n  const members = new Set(tasks);\n  const visiting = new Set<Task>();\n  const visited = new Set<Task>();\n  for (const item of tasks) {\n    if (item.interaction) {\n      validateInteraction(item.interaction);\n      if (item.cache)\n        throw new Error(\"Interactions and gates cannot use a task cache\");\n      if (item.gate)\n        throw new Error(\"A task cannot be both an interaction and a gate\");\n    }\n    if (item.gate) {\n      validateGate(item.gate);\n      if (\n        item.condition ||\n        item.retry ||\n        item.timeoutMs !== undefined ||\n        item.cache\n      )\n        throw new Error(\n          \"Workflow gates cannot have conditions, retries, timeouts or caches\",\n        );\n    }\n    if (keys.has(item.key)) throw new Error(`Duplicate task: ${item.key}`);\n    keys.add(item.key);\n    for (const dependency of item.after)\n      if (!members.has(dependency))\n        throw new Error(`${item.key}: missing dependency ${dependency.key}`);\n  }\n  function visit(item: Task): void {\n    if (visiting.has(item)) throw new Error(`Dependency cycle at ${item.key}`);\n    if (visited.has(item)) return;\n    visiting.add(item);\n    item.after.forEach(visit);\n    visiting.delete(item);\n    visited.add(item);\n  }\n  tasks.forEach(visit);\n}\n"]}

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

@@ -1,4 +1,6 @@
+import { prepareAnswers, applyAnswers } from "./input.js";
 import { OutpostError } from "../errors.js";
+import { quotaResumes, validateQuotaPolicy } from "./quota-pause.js";
 import { maxTimerMs } from "./retry.constants.js";
 import { applyDecisions, pauseGate, prepareDecisions } from "./gates.js";
 import { openCheckpoint } from "./checkpoint.js";
@@ -7,6 +9,16 @@ import { runTask } from "./task-runner.js";
 import { positive } from "./validation.js";
 import { workflowState } from "./workflow-state.js";
 export async function schedule(name, tasks, options) {
+    if (!options.checkpoint &&
+        (tasks.some((item) => item.interaction) || options.answers?.length))
+        throw new Error("Workflow interactions and answers require a checkpoint");
+    if (options.answers && !options.answers.length)
+        throw new Error("Workflow answers cannot be empty");
+    if (options.onQuota) {
+        if (!options.checkpoint)
+            throw new Error("Workflow quota pauses require a checkpoint");
+        validateQuotaPolicy(options.onQuota);
+    }
     if (!options.checkpoint &&
         (tasks.some((item) => item.gate) || options.decisions?.length))
         throw new Error("Workflow gates and decisions require a checkpoint");
@@ -46,20 +58,27 @@ async function scheduleRun(name, tasks, options, checkpoint, deadline) {
         const { executionId, signal, values, records, errors, observerErrors, record, emit, finish, } = state;
         const active = new Map();
         const started = Date.now();
+        const answers = prepareAnswers(state);
         const decisions = await prepareDecisions(state);
         emit({ type: "start" });
         if (checkpoint?.initial)
             emit({ type: "resume" });
-        if (!signal.aborted)
+        if (!signal.aborted) {
             applyDecisions(state, decisions);
+            applyAnswers(state, answers);
+        }
         await state.persist();
+        const resumes = quotaResumes(state);
         try {
             while (true) {
                 let changed = false;
                 for (const item of tasks) {
-                    if (record(item).status !== "waiting")
+                    const resumed = resumes.has(item);
+                    if (record(item).status !== "waiting" && !resumed)
                         continue;
                     if (signal.aborted || state.accounting.exhausted) {
+                        if (resumes.delete(item))
+                            continue;
                         finish(item, "cancelled");
                         changed = true;
                         continue;
@@ -74,6 +93,7 @@ async function scheduleRun(name, tasks, options, checkpoint, deadline) {
                         item.after.some((dependency) => active.has(dependency)) ||
                         !dependencies.every((status) => status === "done"))
                         continue;
+                    resumes.delete(item);
                     const running = (item.gate ? pauseGate(item, state) : runTask(item, state)).finally(() => {
                         active.delete(item);
                     });
@@ -100,6 +120,8 @@ async function scheduleRun(name, tasks, options, checkpoint, deadline) {
         let status = "done";
         if (paused)
             status = "paused";
+        if ([...records.values()].some((entry) => entry.status === "waiting-input"))
+            status = "waiting-input";
         if (errors.length)
             status = "failed";
         if (options.signal?.aborted)
@@ -110,6 +132,9 @@ async function scheduleRun(name, tasks, options, checkpoint, deadline) {
         const result = Object.freeze({
             executionId,
             name,
+            inputRequests: Object.freeze([...records.values()].flatMap((record) => record.status === "waiting-input" && record.interaction?.request
+                ? [record.interaction.request]
+                : [])),
             status,
             usage: state.accounting.snapshot(),
             tasks: Object.freeze([...records.values()].map((value) => Object.freeze({ ...value }))),

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

@@ -1 +1 @@
-{"version":3,"file":"workflow-scheduler.js","sourceRoot":"","sources":["../../../src/domain/workflow/workflow-scheduler.ts"],"names":[],"mappings":"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","sourcesContent":["import { OutpostError } from \"../errors.ts\";\nimport { maxTimerMs } from \"./retry.constants.ts\";\nimport { applyDecisions, pauseGate, prepareDecisions } from \"./gates.ts\";\nimport { openCheckpoint } from \"./checkpoint.ts\";\nimport type { WorkflowCheckpointSession } from \"./checkpoint.types.ts\";\nimport type {\n  Task,\n  WorkflowOptions,\n  WorkflowResult,\n} from \"../workflow.types.ts\";\nimport { WorkflowFailure } from \"./failure.ts\";\nimport { runTask } from \"./task-runner.ts\";\nimport { positive } from \"./validation.ts\";\nimport { workflowState } from \"./workflow-state.ts\";\n\nexport async function schedule(\n  name: string,\n  tasks: readonly Task[],\n  options: WorkflowOptions,\n): Promise<WorkflowResult> {\n  if (\n    !options.checkpoint &&\n    (tasks.some((item) => item.gate) || options.decisions?.length)\n  )\n    throw new Error(\"Workflow gates and decisions require a checkpoint\");\n  if (options.decisions && !options.decisions.length)\n    throw new Error(\"Workflow decisions cannot be empty\");\n  if (options.timeoutMs !== undefined) {\n    positive(options.timeoutMs, \"Workflow timeoutMs\");\n    if (options.timeoutMs > maxTimerMs)\n      throw new Error(\"Workflow timeoutMs exceeds the supported timer range\");\n  }\n  const deadline = new AbortController();\n  const timer =\n    options.timeoutMs === undefined\n      ? undefined\n      : setTimeout(\n          () =>\n            deadline.abort(\n              new OutpostError(\"timeout\", `Workflow ${name} timed out`, {\n                timeoutMs: options.timeoutMs,\n              }),\n            ),\n          options.timeoutMs,\n        );\n  const signal = options.signal\n    ? AbortSignal.any([options.signal, deadline.signal])\n    : deadline.signal;\n  let checkpoint: WorkflowCheckpointSession | undefined;\n  try {\n    checkpoint = options.checkpoint\n      ? await openCheckpoint(name, tasks, options.checkpoint)\n      : undefined;\n    return await scheduleRun(\n      name,\n      tasks,\n      { ...options, signal },\n      checkpoint,\n      deadline.signal,\n    );\n  } finally {\n    clearTimeout(timer);\n    await checkpoint?.release();\n  }\n}\n\nasync function scheduleRun(\n  name: string,\n  tasks: readonly Task[],\n  options: WorkflowOptions,\n  checkpoint: WorkflowCheckpointSession | undefined,\n  deadline: AbortSignal,\n): Promise<WorkflowResult> {\n  const concurrency = options.concurrency ?? 1;\n  positive(concurrency, \"concurrency\");\n  const state = workflowState(name, tasks, options, checkpoint);\n  try {\n    const {\n      executionId,\n      signal,\n      values,\n      records,\n      errors,\n      observerErrors,\n      record,\n      emit,\n      finish,\n    } = state;\n    const active = new Map<Task, Promise<void>>();\n    const started = Date.now();\n    const decisions = await prepareDecisions(state);\n    emit({ type: \"start\" });\n    if (checkpoint?.initial) emit({ type: \"resume\" });\n    if (!signal.aborted) applyDecisions(state, decisions);\n    await state.persist();\n    try {\n      while (true) {\n        let changed = false;\n        for (const item of tasks) {\n          if (record(item).status !== \"waiting\") continue;\n          if (signal.aborted || state.accounting.exhausted) {\n            finish(item, \"cancelled\");\n            changed = true;\n            continue;\n          }\n          const dependencies = item.after.map(\n            (dependency) => record(dependency).status,\n          );\n          if (\n            dependencies.some((status) =>\n              [\"failed\", \"skipped\", \"cancelled\", \"rejected\"].includes(status),\n            )\n          ) {\n            finish(item, \"skipped\");\n            changed = true;\n            continue;\n          }\n          if (\n            active.size >= concurrency ||\n            item.after.some((dependency) => active.has(dependency)) ||\n            !dependencies.every((status) => status === \"done\")\n          )\n            continue;\n          const running = (\n            item.gate ? pauseGate(item, state) : runTask(item, state)\n          ).finally(() => {\n            active.delete(item);\n          });\n          active.set(item, running);\n          changed = true;\n        }\n        if (active.size) {\n          await Promise.race(active.values());\n          continue;\n        }\n        if (!changed) break;\n      }\n    } catch (error) {\n      state.stop.abort(error);\n      await Promise.allSettled(active.values());\n      throw error;\n    }\n    await state.persist();\n    if (options.signal?.aborted) errors.push(options.signal.reason);\n    const paused = [...records.values()].some(\n      (entry) => entry.status === \"paused\",\n    );\n    let status: WorkflowResult[\"status\"] = \"done\";\n    if (paused) status = \"paused\";\n    if (errors.length) status = \"failed\";\n    if (options.signal?.aborted)\n      status = timedOut(options, deadline) ? \"failed\" : \"cancelled\";\n    emit({ type: \"finish\", status, durationMs: Date.now() - started });\n    await state.observation.close();\n    observerErrors.push(...state.observation.errors);\n    const result: WorkflowResult = Object.freeze({\n      executionId,\n      name,\n      status,\n      usage: state.accounting.snapshot(),\n      tasks: Object.freeze(\n        [...records.values()].map((value) => Object.freeze({ ...value })),\n      ),\n      errors: Object.freeze(errors),\n      observerErrors: Object.freeze(observerErrors),\n      value<T>(item: Task<T>): T {\n        if (!values.has(item))\n          throw new Error(\n            `${item.key} has no successful value in this execution`,\n          );\n        return values.get(item) as T;\n      },\n      unwrap() {\n        if (status !== \"done\") throw new WorkflowFailure(result);\n      },\n    });\n    return result;\n  } catch (error) {\n    state.emit({\n      type: \"finish\",\n      status:\n        options.signal?.aborted && !timedOut(options, deadline)\n          ? \"cancelled\"\n          : \"failed\",\n    });\n    await state.observation.close();\n    throw error;\n  }\n}\n\nfunction timedOut(options: WorkflowOptions, deadline: AbortSignal): boolean {\n  return deadline.aborted && options.signal?.reason === deadline.reason;\n}\n"]}
+{"version":3,"file":"workflow-scheduler.js","sourceRoot":"","sources":["../../../src/domain/workflow/workflow-scheduler.ts"],"names":[],"mappings":"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","sourcesContent":["import { prepareAnswers, applyAnswers } from \"./input.ts\";\nimport { OutpostError } from \"../errors.ts\";\nimport { quotaResumes, validateQuotaPolicy } from \"./quota-pause.ts\";\nimport { maxTimerMs } from \"./retry.constants.ts\";\nimport { applyDecisions, pauseGate, prepareDecisions } from \"./gates.ts\";\nimport { openCheckpoint } from \"./checkpoint.ts\";\nimport type { WorkflowCheckpointSession } from \"./checkpoint.types.ts\";\nimport type {\n  Task,\n  WorkflowOptions,\n  WorkflowResult,\n} from \"../workflow.types.ts\";\nimport { WorkflowFailure } from \"./failure.ts\";\nimport { runTask } from \"./task-runner.ts\";\nimport { positive } from \"./validation.ts\";\nimport { workflowState } from \"./workflow-state.ts\";\n\nexport async function schedule(\n  name: string,\n  tasks: readonly Task[],\n  options: WorkflowOptions,\n): Promise<WorkflowResult> {\n  if (\n    !options.checkpoint &&\n    (tasks.some((item) => item.interaction) || options.answers?.length)\n  )\n    throw new Error(\"Workflow interactions and answers require a checkpoint\");\n  if (options.answers && !options.answers.length)\n    throw new Error(\"Workflow answers cannot be empty\");\n  if (options.onQuota) {\n    if (!options.checkpoint)\n      throw new Error(\"Workflow quota pauses require a checkpoint\");\n    validateQuotaPolicy(options.onQuota);\n  }\n  if (\n    !options.checkpoint &&\n    (tasks.some((item) => item.gate) || options.decisions?.length)\n  )\n    throw new Error(\"Workflow gates and decisions require a checkpoint\");\n  if (options.decisions && !options.decisions.length)\n    throw new Error(\"Workflow decisions cannot be empty\");\n  if (options.timeoutMs !== undefined) {\n    positive(options.timeoutMs, \"Workflow timeoutMs\");\n    if (options.timeoutMs > maxTimerMs)\n      throw new Error(\"Workflow timeoutMs exceeds the supported timer range\");\n  }\n  const deadline = new AbortController();\n  const timer =\n    options.timeoutMs === undefined\n      ? undefined\n      : setTimeout(\n          () =>\n            deadline.abort(\n              new OutpostError(\"timeout\", `Workflow ${name} timed out`, {\n                timeoutMs: options.timeoutMs,\n              }),\n            ),\n          options.timeoutMs,\n        );\n  const signal = options.signal\n    ? AbortSignal.any([options.signal, deadline.signal])\n    : deadline.signal;\n  let checkpoint: WorkflowCheckpointSession | undefined;\n  try {\n    checkpoint = options.checkpoint\n      ? await openCheckpoint(name, tasks, options.checkpoint)\n      : undefined;\n    return await scheduleRun(\n      name,\n      tasks,\n      { ...options, signal },\n      checkpoint,\n      deadline.signal,\n    );\n  } finally {\n    clearTimeout(timer);\n    await checkpoint?.release();\n  }\n}\n\nasync function scheduleRun(\n  name: string,\n  tasks: readonly Task[],\n  options: WorkflowOptions,\n  checkpoint: WorkflowCheckpointSession | undefined,\n  deadline: AbortSignal,\n): Promise<WorkflowResult> {\n  const concurrency = options.concurrency ?? 1;\n  positive(concurrency, \"concurrency\");\n  const state = workflowState(name, tasks, options, checkpoint);\n  try {\n    const {\n      executionId,\n      signal,\n      values,\n      records,\n      errors,\n      observerErrors,\n      record,\n      emit,\n      finish,\n    } = state;\n    const active = new Map<Task, Promise<void>>();\n    const started = Date.now();\n    const answers = prepareAnswers(state);\n    const decisions = await prepareDecisions(state);\n    emit({ type: \"start\" });\n    if (checkpoint?.initial) emit({ type: \"resume\" });\n    if (!signal.aborted) {\n      applyDecisions(state, decisions);\n      applyAnswers(state, answers);\n    }\n    await state.persist();\n    const resumes = quotaResumes(state);\n    try {\n      while (true) {\n        let changed = false;\n        for (const item of tasks) {\n          const resumed = resumes.has(item);\n          if (record(item).status !== \"waiting\" && !resumed) continue;\n          if (signal.aborted || state.accounting.exhausted) {\n            if (resumes.delete(item)) continue;\n            finish(item, \"cancelled\");\n            changed = true;\n            continue;\n          }\n          const dependencies = item.after.map(\n            (dependency) => record(dependency).status,\n          );\n          if (\n            dependencies.some((status) =>\n              [\"failed\", \"skipped\", \"cancelled\", \"rejected\"].includes(status),\n            )\n          ) {\n            finish(item, \"skipped\");\n            changed = true;\n            continue;\n          }\n          if (\n            active.size >= concurrency ||\n            item.after.some((dependency) => active.has(dependency)) ||\n            !dependencies.every((status) => status === \"done\")\n          )\n            continue;\n          resumes.delete(item);\n          const running = (\n            item.gate ? pauseGate(item, state) : runTask(item, state)\n          ).finally(() => {\n            active.delete(item);\n          });\n          active.set(item, running);\n          changed = true;\n        }\n        if (active.size) {\n          await Promise.race(active.values());\n          continue;\n        }\n        if (!changed) break;\n      }\n    } catch (error) {\n      state.stop.abort(error);\n      await Promise.allSettled(active.values());\n      throw error;\n    }\n    await state.persist();\n    if (options.signal?.aborted) errors.push(options.signal.reason);\n    const paused = [...records.values()].some(\n      (entry) => entry.status === \"paused\",\n    );\n    let status: WorkflowResult[\"status\"] = \"done\";\n    if (paused) status = \"paused\";\n    if ([...records.values()].some((entry) => entry.status === \"waiting-input\"))\n      status = \"waiting-input\";\n    if (errors.length) status = \"failed\";\n    if (options.signal?.aborted)\n      status = timedOut(options, deadline) ? \"failed\" : \"cancelled\";\n    emit({ type: \"finish\", status, durationMs: Date.now() - started });\n    await state.observation.close();\n    observerErrors.push(...state.observation.errors);\n    const result: WorkflowResult = Object.freeze({\n      executionId,\n      name,\n      inputRequests: Object.freeze(\n        [...records.values()].flatMap((record) =>\n          record.status === \"waiting-input\" && record.interaction?.request\n            ? [record.interaction.request]\n            : [],\n        ),\n      ),\n      status,\n      usage: state.accounting.snapshot(),\n      tasks: Object.freeze(\n        [...records.values()].map((value) => Object.freeze({ ...value })),\n      ),\n      errors: Object.freeze(errors),\n      observerErrors: Object.freeze(observerErrors),\n      value<T>(item: Task<T>): T {\n        if (!values.has(item))\n          throw new Error(\n            `${item.key} has no successful value in this execution`,\n          );\n        return values.get(item) as T;\n      },\n      unwrap() {\n        if (status !== \"done\") throw new WorkflowFailure(result);\n      },\n    });\n    return result;\n  } catch (error) {\n    state.emit({\n      type: \"finish\",\n      status:\n        options.signal?.aborted && !timedOut(options, deadline)\n          ? \"cancelled\"\n          : \"failed\",\n    });\n    await state.observation.close();\n    throw error;\n  }\n}\n\nfunction timedOut(options: WorkflowOptions, deadline: AbortSignal): boolean {\n  return deadline.aborted && options.signal?.reason === deadline.reason;\n}\n"]}