@elie-laloum/outpost 7.0.0 → 8.0.0

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.js

@@ -1,6 +1,8 @@
+import { validateInteraction } from "./input-validation.js";
 import { validateRetry } from "./retry.js";
 import { maxTimerMs } from "./retry.constants.js";
 import { positive } from "./validation.js";
+import { validateTaskCache } from "./task-cache.js";
 export function task(options) {
     if (!/^[A-Za-z0-9][A-Za-z0-9._-]*$/.test(options.key))
         throw new Error(`Invalid task key: ${options.key}`);
@@ -8,11 +10,30 @@ export function task(options) {
         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,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,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 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.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"]}

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"]}