@fluidgrids/workflows 2026.1029.1 → 2026.1030.1

package/dist/testing/index.d.cts

@@ -1,12 +1,13 @@
-import { j as Duration, t as WorkflowRetryOptions, h as DurableWorkflow, O as Operation, n as SignalDefinition } from '../workflow-O6e64ZcG.cjs';
-import { C as CommandGate, o as HistoryFile, t as RunState } from '../file-cgL9l9l8.cjs';
-import { ai as WorkflowInfoSnapshot, ah as WorkflowIdReusePolicy, ag as WorkflowIdConflictPolicy, ac as VersioningBehavior, aj as WorkflowTaskRequest, ak as WorkflowTaskResult, Z as RunEventRecord, a8 as UnfinishedHandler, F as Failure, _ as RunEventType } from '../types-CQKOhPTa.cjs';
-import { J as Json, a as JsonObject, W as WorkflowDefinition, m as WorkflowNode } from '../types-Bb2wRnJ5.cjs';
-import { x as Tier1Workflow } from '../workflow-CZOXUlQ5.cjs';
+import { x as Duration, X as WorkflowRetryOptions, v as DurableWorkflow, h as ActivityImplementation, i as ActivityInboundInterceptor, e as ActivityDefinition, c as ActivityContext, O as Operation, U as UpdateDefinition, Q as QueryDefinition, G as SignalDefinition } from '../workflow-DS32Gtws.cjs';
+import { k as WorkflowInterceptorsFactory, M as MarkedInterceptorsFactory } from '../interceptors-CqkNZVfI.cjs';
+import { C as CommandGate, p as HistoryFile, x as RunState } from '../file-BxYpwjRQ.cjs';
+import { b as WorkflowInfoSnapshot, ay as WorkflowIdReusePolicy, ax as WorkflowIdConflictPolicy, at as VersioningBehavior, M as Headers, az as WorkflowTaskRequest, aA as WorkflowTaskResult, F as Failure, aj as SinkCall, R as RunEventRecord, U as UnfinishedHandler, ac as RunEventType } from '../types-Bv2i4cBX.cjs';
+import { a as Json, J as JsonObject, W as WorkflowDefinition, m as WorkflowNode } from '../types-V7jEEUaL.cjs';
+import { x as Tier1Workflow } from '../workflow-BJPFv3cp.cjs';
 import { E as EsbuildApi } from '../lower-types-DQNBfWQn.cjs';
 import { WorkflowRegistry } from '../runtime/index.cjs';
 import 'esbuild';
-import '../activation-CESehfYi.cjs';
+import '../activation-DqUfpHzk.cjs';
 
 /**
  * `TestWorkflowEnvironment` (spec 10 §1): an in-process engine for tier-2
@@ -24,6 +25,12 @@ import '../activation-CESehfYi.cjs';
  * for schedule-to-start timeouts, heartbeat details on retry, and the handler
  * drain check (`failOnUnfinishedHandlers`, default true).
  *
+ * C-R1 (Phase C) adds updates (`update`, update-with-start), custom queries
+ * (`query`), reset (`reset`, a forked run with signals and updates
+ * re-applied), user activities (`registerActivity`, `mockActivity`, async
+ * completion), search attributes and headers at the start, workflow
+ * interceptors, activity interceptors and sinks.
+ *
  * Divergences from the service (documented, accepted for Phase B):
  * - Workflow tasks run in this process without the determinism shims.
  * - A failed workflow task is not retried forever: the run stops, and
@@ -36,6 +43,9 @@ import '../activation-CESehfYi.cjs';
  *   is its start time, as in the worker, and the fake clock does not move.
  * - The workflow-task timeout is recorded, not enforced.
  * - Graph child runs are mocks (`mockChild`).
+ * - Task queues are not checked: a user activity runs on any queue (the
+ *   service refuses one on `managed`), and paused activities, pause rules
+ *   and activity options updates are service operations without a test form.
  */
 
 /** What a mock receives besides the activity's args. */
@@ -91,6 +101,61 @@ interface TestEnvironmentOptions {
     taskExecutor?: (request: WorkflowTaskRequest) => Promise<WorkflowTaskResult> | WorkflowTaskResult;
     /** Workflow keys of tier-2 functions (key -> export name), for `ctx.child('<key>')` with a task executor. */
     workflowKeys?: Readonly<Record<string, string>>;
+    /** Workflow interceptors, as a bundle would export them as `interceptors` (in-process tasks only). */
+    interceptors?: WorkflowInterceptorsFactory | MarkedInterceptorsFactory;
+    /** User-activity implementations (`implementActivity`, `defineActivity`, `dynamicActivity`). */
+    activities?: ReadonlyArray<ActivityImplementation<never, unknown>>;
+    /** Activity inbound interceptors around every user activity, first outermost. */
+    activityInterceptors?: readonly ActivityInboundInterceptor[];
+    /** Connections `ActivityContext.connection(name)` returns. */
+    connections?: Readonly<Record<string, Record<string, Json>>>;
+    /** Sink implementations called with each task's sink calls after the task completes. */
+    sinks?: Readonly<Record<string, Readonly<Record<string, (...args: Json[]) => void>>>>;
+}
+/** The state of an update (Phase C, 05 §6). */
+type UpdateStatus = 'PENDING' | 'ACCEPTED' | 'REJECTED' | 'COMPLETED';
+/** What `update` returns (`UpdateResult` of `updateWorkflowRun`). */
+interface UpdateResult {
+    updateId: string;
+    status: UpdateStatus;
+    result?: Json;
+    failure?: Failure;
+}
+/** Options of `update`. */
+interface UpdateOptions {
+    /** Idempotency: a repeat with the same id returns the first result. Default `u<n>`. */
+    updateId?: string;
+    /** `COMPLETED` (default) runs until idle, `ACCEPTED` returns once the update is accepted. */
+    waitFor?: 'ACCEPTED' | 'COMPLETED';
+    headers?: Headers;
+}
+/** Options of `reset` (11 §2.7). */
+interface ResetOptions {
+    /** The last `WORKFLOW_TASK_COMPLETED` at or before this seq is the reset point. */
+    toSeq?: number;
+    /** `FIRST_TASK` or `LAST_TASK` (default) instead of a seq. */
+    to?: 'FIRST_TASK' | 'LAST_TASK';
+    reason?: string;
+    /** Re-append signals received after the reset point (default true). */
+    reapplySignals?: boolean;
+    /** Re-append updates accepted after the reset point as `UPDATE_ADMITTED` (default true). */
+    reapplyUpdates?: boolean;
+}
+/** A query found no handler (`rejected`, `VALIDATION`). */
+declare class QueryRejectedError extends Error {
+    readonly runId: string;
+    readonly queryName: string;
+    constructor(runId: string, queryName: string, message: string);
+}
+/** A query handler threw, or the replay failed. */
+declare class QueryFailedError extends Error {
+    readonly runId: string;
+    readonly queryName: string;
+    constructor(runId: string, queryName: string, message: string);
+}
+/** An update to a run that is not open, or an update-with-start on a delayed start. */
+declare class UpdateRefusedError extends Error {
+    constructor(message: string);
 }
 interface StartOptions {
     input?: unknown;
@@ -125,6 +190,20 @@ interface StartOptions {
     memo?: JsonObject;
     /** Default the declaration's `versioningBehavior`. */
     versioningBehavior?: VersioningBehavior;
+    /** Headers of the start (`WORKFLOW_STARTED.headers`, interceptors). */
+    headers?: Headers;
+    /** Search attributes at the start (Phase C). */
+    searchAttributes?: JsonObject;
+    /** Fairness of the run's tasks (Phase C). */
+    fairnessKey?: string;
+    fairnessWeight?: number;
+    /** Update-with-start (11 §2.6): admitted right after `WORKFLOW_STARTED`. */
+    update?: {
+        name: string;
+        args?: unknown;
+        updateId?: string;
+        headers?: Headers;
+    };
 }
 /** A start found an open run with the same workflow id (`idConflictPolicy: FAIL`) or a refused closed one. */
 declare class WorkflowAlreadyStartedError extends Error {
@@ -171,6 +250,14 @@ declare class TestRunHandle<Out = Json> {
     cancel(reason?: string): Promise<void>;
     /** Terminate the run without running code. */
     terminate(reason?: string): Promise<void>;
+    /** Send an update and run until idle (Phase C). */
+    update<Args, Result>(update: UpdateDefinition<Args, Result> | string, args?: Args, options?: UpdateOptions): Promise<UpdateResult>;
+    /** Answer a query from the run's history (Phase C custom queries and the built-ins). */
+    query<Result, Args>(query: QueryDefinition<Result, Args> | string, args?: Args): Promise<Result>;
+    /** Reset the run (11 §2.7): a new run forked at a completed task; this one is terminated. */
+    reset(options?: ResetOptions): Promise<TestRunHandle<Out>>;
+    /** Sink calls the run's tasks made (Phase C). */
+    sinkCalls(): SinkCall[];
     /** Run until this run (or the last run of its continue-as-new chain) ends; its output. */
     result(): Promise<Out>;
     /** The projected state of the run. */
@@ -181,6 +268,8 @@ declare class TestWorkflowEnvironment {
     private clock;
     private readonly timeSkipping;
     private readonly enabled;
+    /** The bundle features the gate's flags enable, sent with every task (`request.features`). */
+    private readonly codeFeatures;
     private readonly failOnUnfinishedHandlers;
     private readonly historyRelease;
     private dues;
@@ -196,9 +285,21 @@ declare class TestWorkflowEnvironment {
     private timers;
     private mockedChildren;
     private runCounter;
+    private updateCounter;
     private readonly executor;
     private readonly workflowKeys;
+    private readonly interceptors;
+    private readonly activityImpls;
+    private readonly activityInterceptors;
+    private readonly connections;
+    private readonly sinks;
+    /** Attempts that handed their completion to an outside system (`completeAsync`), by token. */
+    private readonly asyncAttempts;
     private constructor();
+    /** Register a user-activity implementation (Phase C). A later one replaces an earlier of the same name. */
+    registerActivity(implementation: ActivityImplementation<never, unknown>): void;
+    /** Mock a user activity by name or declaration (Phase C). */
+    mockActivity<In, Out>(activity: ActivityDefinition<In, Out> | string, fn: (args: In, ctx: ActivityContext) => Out | Promise<Out>): void;
     /** Create an environment. */
     static create(options?: TestEnvironmentOptions): Promise<TestWorkflowEnvironment>;
     /** The fake clock, in epoch milliseconds. */
@@ -213,11 +314,53 @@ declare class TestWorkflowEnvironment {
     holdActivities(nodeType?: string): void;
     /** Release held activity queues (all when no node type is given). */
     releaseActivities(nodeType?: string): void;
+    /** The hold key of an attempt: its node type, or the task queue of a user activity. */
+    private holdKeyOf;
     private isHeld;
     /** Mock a child workflow started by key (graph or durable). */
     mockChild(workflowKey: string, impl: ChildMock): void;
     /** Start a run of a tier-2 function (by declaration, or by export name with a task executor). */
     start<In, Out>(definition: DurableWorkflow<In, Out> | string, options?: StartOptions): Promise<TestRunHandle<Out>>;
+    /**
+     * Update-with-start (11 §2.6): start the run (or, with
+     * `idConflictPolicy: USE_EXISTING`, reach the open one) and deliver the
+     * update before any other task runs.
+     */
+    startWithUpdate<In, Out>(definition: DurableWorkflow<In, Out> | string, options: StartOptions & {
+        update: NonNullable<StartOptions['update']>;
+    }): Promise<{
+        handle: TestRunHandle<Out>;
+        update: UpdateResult;
+    }>;
+    private nextUpdateId;
+    /** A new update row (not attached to a run yet). */
+    private newUpdate;
+    /** Record an update on a run: pending (delivered by the next task) or admitted into history. */
+    private addUpdate;
+    /** Schedule a workflow task for a run that has none (an update needs no input event). */
+    private scheduleTask;
+    /**
+     * Send an update to a run and run until idle (Phase C, 05 §6). The result
+     * is `REJECTED` (the validator refused it or no handler took it; nothing is
+     * written to history), `COMPLETED`, or `ACCEPTED` while its handler still
+     * waits (for a timer without time skipping, or with `waitFor: ACCEPTED`).
+     */
+    update<Args, Result>(runId: string, update: UpdateDefinition<Args, Result> | string, args?: Args, options?: UpdateOptions): Promise<UpdateResult>;
+    /** The current result of an update. */
+    updateResultOf(runId: string, updateId: string): UpdateResult;
+    /** Answer a query from the run's history (a replay-only `query` task). */
+    query(runId: string, query: QueryDefinition<unknown, unknown> | string, args?: unknown): Promise<Json>;
+    /** Sink calls the run's tasks made. */
+    sinkCallsOf(runId: string): SinkCall[];
+    /**
+     * Reset a run (11 §2.7): a new run whose history is the original's up to
+     * and including the chosen completed workflow task (with its commands),
+     * then `WORKFLOW_RESET`, then the signals (and, as `UPDATE_ADMITTED`, the
+     * accepted updates) received after that point. The original is terminated
+     * with reason `RESET`; children it started before the point follow the new
+     * run, the others get their parent-close policy. Returns the new run id.
+     */
+    reset(runId: string, options?: ResetOptions): Promise<string>;
     private durationConfig;
     /**
      * The workflow-id policies of a start (11 §2.1): the open run to use, or
@@ -242,7 +385,7 @@ declare class TestWorkflowEnvironment {
     private append;
     /** End a start delay: the first workflow task is scheduled now. */
     private endDelay;
-    deliverSignal(runId: string, name: string, payload: unknown): boolean;
+    deliverSignal(runId: string, name: string, payload: unknown, headers?: Headers): boolean;
     requestCancel(runId: string, reason?: string): boolean;
     terminate(runId: string, reason: string): void;
     /** Run every runnable task and activity; skip time when allowed and idle. */
@@ -256,6 +399,10 @@ declare class TestWorkflowEnvironment {
     private fireRunDues;
     private fireDue;
     private runTask;
+    /** What a task's update replies mean for the run's update rows. */
+    private recordUpdateReplies;
+    /** Keep a task's sink calls and call the configured sinks with them. */
+    private runSinks;
     private execute;
     /**
      * Run a workflow task as the worker does (11 §2.12): while it asks for
@@ -275,12 +422,26 @@ declare class TestWorkflowEnvironment {
     private startChild;
     private runMockedChild;
     private runAttempt;
+    /** The `ActivityContext` of one user-activity attempt. */
+    private activityContext;
+    /** Complete an activity that called `completeAsync()` (`completeActivityAsync`). */
+    completeActivityAsync(token: string, result?: unknown): Promise<void>;
+    /** Fail an activity that called `completeAsync()` (`failActivityAsync`); the retry policy applies. */
+    failActivityAsync(token: string, error: unknown): Promise<void>;
+    private takeAsync;
+    /** Record an attempt's outcome: completion, a final failure or timeout, or the next attempt. */
+    private finishAttempt;
     /**
      * Run-level retry (11 §2.17): a failed or run-timed-out run whose policy
      * allows another attempt is followed by a new run of the chain after the
      * backoff, with `runAttempt + 1` and the failure as `lastFailure`.
      */
     private retryRun;
+    /**
+     * A run closed: drop its pending work, retry it, apply the parent-close
+     * policy to its children (except `keptChildren`, which follow a reset
+     * fork), settle its open updates and notify its parent.
+     */
     private onClosed;
     resultOf(runId: string): Promise<Json>;
     /** Every tier-2 function registered, by export name. */
@@ -414,9 +575,12 @@ declare function runWorkflowTaskInVm(script: string, request: WorkflowTaskReques
 
 /** Let every queued promise job run. */
 declare function drainJobs(): Promise<void>;
-/** A registry from export names to workflow functions. */
-declare function registryOf(workflows: Readonly<Record<string, DurableWorkflow<never, unknown>>>): WorkflowRegistry;
+/**
+ * A registry from export names to workflow functions, with the workflow
+ * interceptors a bundle would export as `interceptors`.
+ */
+declare function registryOf(workflows: Readonly<Record<string, DurableWorkflow<never, unknown>>>, interceptors?: WorkflowInterceptorsFactory | MarkedInterceptorsFactory): WorkflowRegistry;
 /** Run one workflow task in process. */
 declare function runWorkflowTaskInProcess(registry: WorkflowRegistry, request: WorkflowTaskRequest): Promise<WorkflowTaskResult>;
 
-export { type ActivityMock, type ActivityMockInfo, type ChildMock, type ExpectedEvent, HistoryAssertionError, type IRSnapshot, type NodeMock, type NodeMockResult, ReplayError, type ReplayInput, RunBlockedError, type SimulateOptions, type SimulatedStep, type SimulationResult, type StartOptions, type TestEnvironmentOptions, TestRunHandle, TestWorkflowEnvironment, UnfinishedHandlersError, WorkflowAlreadyStartedError, WorkflowFailedError, WorkflowTaskFailedError, assertHistory, bundleToScript, drainJobs, expectIR, jsonCopy, registryOf, replay, replayRequest, runWorkflowTaskInProcess, runWorkflowTaskInVm, simulate };
+export { type ActivityMock, type ActivityMockInfo, type ChildMock, type ExpectedEvent, HistoryAssertionError, type IRSnapshot, type NodeMock, type NodeMockResult, QueryFailedError, QueryRejectedError, ReplayError, type ReplayInput, type ResetOptions, RunBlockedError, type SimulateOptions, type SimulatedStep, type SimulationResult, type StartOptions, type TestEnvironmentOptions, TestRunHandle, TestWorkflowEnvironment, UnfinishedHandlersError, type UpdateOptions, UpdateRefusedError, type UpdateResult, type UpdateStatus, WorkflowAlreadyStartedError, WorkflowFailedError, WorkflowTaskFailedError, assertHistory, bundleToScript, drainJobs, expectIR, jsonCopy, registryOf, replay, replayRequest, runWorkflowTaskInProcess, runWorkflowTaskInVm, simulate };

package/dist/testing/index.d.ts

@@ -1,12 +1,13 @@
-import { j as Duration, t as WorkflowRetryOptions, h as DurableWorkflow, O as Operation, n as SignalDefinition } from '../workflow-DWTPHFbt.js';
-import { C as CommandGate, o as HistoryFile, t as RunState } from '../file-olQudcx5.js';
-import { ai as WorkflowInfoSnapshot, ah as WorkflowIdReusePolicy, ag as WorkflowIdConflictPolicy, ac as VersioningBehavior, aj as WorkflowTaskRequest, ak as WorkflowTaskResult, Z as RunEventRecord, a8 as UnfinishedHandler, F as Failure, _ as RunEventType } from '../types-CnIOinoz.js';
-import { J as Json, a as JsonObject, W as WorkflowDefinition, m as WorkflowNode } from '../types-Bb2wRnJ5.js';
-import { x as Tier1Workflow } from '../workflow-8uRU9rhL.js';
+import { x as Duration, X as WorkflowRetryOptions, v as DurableWorkflow, h as ActivityImplementation, i as ActivityInboundInterceptor, e as ActivityDefinition, c as ActivityContext, O as Operation, U as UpdateDefinition, Q as QueryDefinition, G as SignalDefinition } from '../workflow-BGnv8SS6.js';
+import { k as WorkflowInterceptorsFactory, M as MarkedInterceptorsFactory } from '../interceptors-CNcr2dlk.js';
+import { C as CommandGate, p as HistoryFile, x as RunState } from '../file-CFdPQJI9.js';
+import { b as WorkflowInfoSnapshot, ay as WorkflowIdReusePolicy, ax as WorkflowIdConflictPolicy, at as VersioningBehavior, M as Headers, az as WorkflowTaskRequest, aA as WorkflowTaskResult, F as Failure, aj as SinkCall, R as RunEventRecord, U as UnfinishedHandler, ac as RunEventType } from '../types-DGx-b9eq.js';
+import { a as Json, J as JsonObject, W as WorkflowDefinition, m as WorkflowNode } from '../types-V7jEEUaL.js';
+import { x as Tier1Workflow } from '../workflow-B18OeF7g.js';
 import { E as EsbuildApi } from '../lower-types-DQNBfWQn.js';
 import { WorkflowRegistry } from '../runtime/index.js';
 import 'esbuild';
-import '../activation-BnVQMv9y.js';
+import '../activation-xpx1oWuo.js';
 
 /**
  * `TestWorkflowEnvironment` (spec 10 §1): an in-process engine for tier-2
@@ -24,6 +25,12 @@ import '../activation-BnVQMv9y.js';
  * for schedule-to-start timeouts, heartbeat details on retry, and the handler
  * drain check (`failOnUnfinishedHandlers`, default true).
  *
+ * C-R1 (Phase C) adds updates (`update`, update-with-start), custom queries
+ * (`query`), reset (`reset`, a forked run with signals and updates
+ * re-applied), user activities (`registerActivity`, `mockActivity`, async
+ * completion), search attributes and headers at the start, workflow
+ * interceptors, activity interceptors and sinks.
+ *
  * Divergences from the service (documented, accepted for Phase B):
  * - Workflow tasks run in this process without the determinism shims.
  * - A failed workflow task is not retried forever: the run stops, and
@@ -36,6 +43,9 @@ import '../activation-BnVQMv9y.js';
  *   is its start time, as in the worker, and the fake clock does not move.
  * - The workflow-task timeout is recorded, not enforced.
  * - Graph child runs are mocks (`mockChild`).
+ * - Task queues are not checked: a user activity runs on any queue (the
+ *   service refuses one on `managed`), and paused activities, pause rules
+ *   and activity options updates are service operations without a test form.
  */
 
 /** What a mock receives besides the activity's args. */
@@ -91,6 +101,61 @@ interface TestEnvironmentOptions {
     taskExecutor?: (request: WorkflowTaskRequest) => Promise<WorkflowTaskResult> | WorkflowTaskResult;
     /** Workflow keys of tier-2 functions (key -> export name), for `ctx.child('<key>')` with a task executor. */
     workflowKeys?: Readonly<Record<string, string>>;
+    /** Workflow interceptors, as a bundle would export them as `interceptors` (in-process tasks only). */
+    interceptors?: WorkflowInterceptorsFactory | MarkedInterceptorsFactory;
+    /** User-activity implementations (`implementActivity`, `defineActivity`, `dynamicActivity`). */
+    activities?: ReadonlyArray<ActivityImplementation<never, unknown>>;
+    /** Activity inbound interceptors around every user activity, first outermost. */
+    activityInterceptors?: readonly ActivityInboundInterceptor[];
+    /** Connections `ActivityContext.connection(name)` returns. */
+    connections?: Readonly<Record<string, Record<string, Json>>>;
+    /** Sink implementations called with each task's sink calls after the task completes. */
+    sinks?: Readonly<Record<string, Readonly<Record<string, (...args: Json[]) => void>>>>;
+}
+/** The state of an update (Phase C, 05 §6). */
+type UpdateStatus = 'PENDING' | 'ACCEPTED' | 'REJECTED' | 'COMPLETED';
+/** What `update` returns (`UpdateResult` of `updateWorkflowRun`). */
+interface UpdateResult {
+    updateId: string;
+    status: UpdateStatus;
+    result?: Json;
+    failure?: Failure;
+}
+/** Options of `update`. */
+interface UpdateOptions {
+    /** Idempotency: a repeat with the same id returns the first result. Default `u<n>`. */
+    updateId?: string;
+    /** `COMPLETED` (default) runs until idle, `ACCEPTED` returns once the update is accepted. */
+    waitFor?: 'ACCEPTED' | 'COMPLETED';
+    headers?: Headers;
+}
+/** Options of `reset` (11 §2.7). */
+interface ResetOptions {
+    /** The last `WORKFLOW_TASK_COMPLETED` at or before this seq is the reset point. */
+    toSeq?: number;
+    /** `FIRST_TASK` or `LAST_TASK` (default) instead of a seq. */
+    to?: 'FIRST_TASK' | 'LAST_TASK';
+    reason?: string;
+    /** Re-append signals received after the reset point (default true). */
+    reapplySignals?: boolean;
+    /** Re-append updates accepted after the reset point as `UPDATE_ADMITTED` (default true). */
+    reapplyUpdates?: boolean;
+}
+/** A query found no handler (`rejected`, `VALIDATION`). */
+declare class QueryRejectedError extends Error {
+    readonly runId: string;
+    readonly queryName: string;
+    constructor(runId: string, queryName: string, message: string);
+}
+/** A query handler threw, or the replay failed. */
+declare class QueryFailedError extends Error {
+    readonly runId: string;
+    readonly queryName: string;
+    constructor(runId: string, queryName: string, message: string);
+}
+/** An update to a run that is not open, or an update-with-start on a delayed start. */
+declare class UpdateRefusedError extends Error {
+    constructor(message: string);
 }
 interface StartOptions {
     input?: unknown;
@@ -125,6 +190,20 @@ interface StartOptions {
     memo?: JsonObject;
     /** Default the declaration's `versioningBehavior`. */
     versioningBehavior?: VersioningBehavior;
+    /** Headers of the start (`WORKFLOW_STARTED.headers`, interceptors). */
+    headers?: Headers;
+    /** Search attributes at the start (Phase C). */
+    searchAttributes?: JsonObject;
+    /** Fairness of the run's tasks (Phase C). */
+    fairnessKey?: string;
+    fairnessWeight?: number;
+    /** Update-with-start (11 §2.6): admitted right after `WORKFLOW_STARTED`. */
+    update?: {
+        name: string;
+        args?: unknown;
+        updateId?: string;
+        headers?: Headers;
+    };
 }
 /** A start found an open run with the same workflow id (`idConflictPolicy: FAIL`) or a refused closed one. */
 declare class WorkflowAlreadyStartedError extends Error {
@@ -171,6 +250,14 @@ declare class TestRunHandle<Out = Json> {
     cancel(reason?: string): Promise<void>;
     /** Terminate the run without running code. */
     terminate(reason?: string): Promise<void>;
+    /** Send an update and run until idle (Phase C). */
+    update<Args, Result>(update: UpdateDefinition<Args, Result> | string, args?: Args, options?: UpdateOptions): Promise<UpdateResult>;
+    /** Answer a query from the run's history (Phase C custom queries and the built-ins). */
+    query<Result, Args>(query: QueryDefinition<Result, Args> | string, args?: Args): Promise<Result>;
+    /** Reset the run (11 §2.7): a new run forked at a completed task; this one is terminated. */
+    reset(options?: ResetOptions): Promise<TestRunHandle<Out>>;
+    /** Sink calls the run's tasks made (Phase C). */
+    sinkCalls(): SinkCall[];
     /** Run until this run (or the last run of its continue-as-new chain) ends; its output. */
     result(): Promise<Out>;
     /** The projected state of the run. */
@@ -181,6 +268,8 @@ declare class TestWorkflowEnvironment {
     private clock;
     private readonly timeSkipping;
     private readonly enabled;
+    /** The bundle features the gate's flags enable, sent with every task (`request.features`). */
+    private readonly codeFeatures;
     private readonly failOnUnfinishedHandlers;
     private readonly historyRelease;
     private dues;
@@ -196,9 +285,21 @@ declare class TestWorkflowEnvironment {
     private timers;
     private mockedChildren;
     private runCounter;
+    private updateCounter;
     private readonly executor;
     private readonly workflowKeys;
+    private readonly interceptors;
+    private readonly activityImpls;
+    private readonly activityInterceptors;
+    private readonly connections;
+    private readonly sinks;
+    /** Attempts that handed their completion to an outside system (`completeAsync`), by token. */
+    private readonly asyncAttempts;
     private constructor();
+    /** Register a user-activity implementation (Phase C). A later one replaces an earlier of the same name. */
+    registerActivity(implementation: ActivityImplementation<never, unknown>): void;
+    /** Mock a user activity by name or declaration (Phase C). */
+    mockActivity<In, Out>(activity: ActivityDefinition<In, Out> | string, fn: (args: In, ctx: ActivityContext) => Out | Promise<Out>): void;
     /** Create an environment. */
     static create(options?: TestEnvironmentOptions): Promise<TestWorkflowEnvironment>;
     /** The fake clock, in epoch milliseconds. */
@@ -213,11 +314,53 @@ declare class TestWorkflowEnvironment {
     holdActivities(nodeType?: string): void;
     /** Release held activity queues (all when no node type is given). */
     releaseActivities(nodeType?: string): void;
+    /** The hold key of an attempt: its node type, or the task queue of a user activity. */
+    private holdKeyOf;
     private isHeld;
     /** Mock a child workflow started by key (graph or durable). */
     mockChild(workflowKey: string, impl: ChildMock): void;
     /** Start a run of a tier-2 function (by declaration, or by export name with a task executor). */
     start<In, Out>(definition: DurableWorkflow<In, Out> | string, options?: StartOptions): Promise<TestRunHandle<Out>>;
+    /**
+     * Update-with-start (11 §2.6): start the run (or, with
+     * `idConflictPolicy: USE_EXISTING`, reach the open one) and deliver the
+     * update before any other task runs.
+     */
+    startWithUpdate<In, Out>(definition: DurableWorkflow<In, Out> | string, options: StartOptions & {
+        update: NonNullable<StartOptions['update']>;
+    }): Promise<{
+        handle: TestRunHandle<Out>;
+        update: UpdateResult;
+    }>;
+    private nextUpdateId;
+    /** A new update row (not attached to a run yet). */
+    private newUpdate;
+    /** Record an update on a run: pending (delivered by the next task) or admitted into history. */
+    private addUpdate;
+    /** Schedule a workflow task for a run that has none (an update needs no input event). */
+    private scheduleTask;
+    /**
+     * Send an update to a run and run until idle (Phase C, 05 §6). The result
+     * is `REJECTED` (the validator refused it or no handler took it; nothing is
+     * written to history), `COMPLETED`, or `ACCEPTED` while its handler still
+     * waits (for a timer without time skipping, or with `waitFor: ACCEPTED`).
+     */
+    update<Args, Result>(runId: string, update: UpdateDefinition<Args, Result> | string, args?: Args, options?: UpdateOptions): Promise<UpdateResult>;
+    /** The current result of an update. */
+    updateResultOf(runId: string, updateId: string): UpdateResult;
+    /** Answer a query from the run's history (a replay-only `query` task). */
+    query(runId: string, query: QueryDefinition<unknown, unknown> | string, args?: unknown): Promise<Json>;
+    /** Sink calls the run's tasks made. */
+    sinkCallsOf(runId: string): SinkCall[];
+    /**
+     * Reset a run (11 §2.7): a new run whose history is the original's up to
+     * and including the chosen completed workflow task (with its commands),
+     * then `WORKFLOW_RESET`, then the signals (and, as `UPDATE_ADMITTED`, the
+     * accepted updates) received after that point. The original is terminated
+     * with reason `RESET`; children it started before the point follow the new
+     * run, the others get their parent-close policy. Returns the new run id.
+     */
+    reset(runId: string, options?: ResetOptions): Promise<string>;
     private durationConfig;
     /**
      * The workflow-id policies of a start (11 §2.1): the open run to use, or
@@ -242,7 +385,7 @@ declare class TestWorkflowEnvironment {
     private append;
     /** End a start delay: the first workflow task is scheduled now. */
     private endDelay;
-    deliverSignal(runId: string, name: string, payload: unknown): boolean;
+    deliverSignal(runId: string, name: string, payload: unknown, headers?: Headers): boolean;
     requestCancel(runId: string, reason?: string): boolean;
     terminate(runId: string, reason: string): void;
     /** Run every runnable task and activity; skip time when allowed and idle. */
@@ -256,6 +399,10 @@ declare class TestWorkflowEnvironment {
     private fireRunDues;
     private fireDue;
     private runTask;
+    /** What a task's update replies mean for the run's update rows. */
+    private recordUpdateReplies;
+    /** Keep a task's sink calls and call the configured sinks with them. */
+    private runSinks;
     private execute;
     /**
      * Run a workflow task as the worker does (11 §2.12): while it asks for
@@ -275,12 +422,26 @@ declare class TestWorkflowEnvironment {
     private startChild;
     private runMockedChild;
     private runAttempt;
+    /** The `ActivityContext` of one user-activity attempt. */
+    private activityContext;
+    /** Complete an activity that called `completeAsync()` (`completeActivityAsync`). */
+    completeActivityAsync(token: string, result?: unknown): Promise<void>;
+    /** Fail an activity that called `completeAsync()` (`failActivityAsync`); the retry policy applies. */
+    failActivityAsync(token: string, error: unknown): Promise<void>;
+    private takeAsync;
+    /** Record an attempt's outcome: completion, a final failure or timeout, or the next attempt. */
+    private finishAttempt;
     /**
      * Run-level retry (11 §2.17): a failed or run-timed-out run whose policy
      * allows another attempt is followed by a new run of the chain after the
      * backoff, with `runAttempt + 1` and the failure as `lastFailure`.
      */
     private retryRun;
+    /**
+     * A run closed: drop its pending work, retry it, apply the parent-close
+     * policy to its children (except `keptChildren`, which follow a reset
+     * fork), settle its open updates and notify its parent.
+     */
     private onClosed;
     resultOf(runId: string): Promise<Json>;
     /** Every tier-2 function registered, by export name. */
@@ -414,9 +575,12 @@ declare function runWorkflowTaskInVm(script: string, request: WorkflowTaskReques
 
 /** Let every queued promise job run. */
 declare function drainJobs(): Promise<void>;
-/** A registry from export names to workflow functions. */
-declare function registryOf(workflows: Readonly<Record<string, DurableWorkflow<never, unknown>>>): WorkflowRegistry;
+/**
+ * A registry from export names to workflow functions, with the workflow
+ * interceptors a bundle would export as `interceptors`.
+ */
+declare function registryOf(workflows: Readonly<Record<string, DurableWorkflow<never, unknown>>>, interceptors?: WorkflowInterceptorsFactory | MarkedInterceptorsFactory): WorkflowRegistry;
 /** Run one workflow task in process. */
 declare function runWorkflowTaskInProcess(registry: WorkflowRegistry, request: WorkflowTaskRequest): Promise<WorkflowTaskResult>;
 
-export { type ActivityMock, type ActivityMockInfo, type ChildMock, type ExpectedEvent, HistoryAssertionError, type IRSnapshot, type NodeMock, type NodeMockResult, ReplayError, type ReplayInput, RunBlockedError, type SimulateOptions, type SimulatedStep, type SimulationResult, type StartOptions, type TestEnvironmentOptions, TestRunHandle, TestWorkflowEnvironment, UnfinishedHandlersError, WorkflowAlreadyStartedError, WorkflowFailedError, WorkflowTaskFailedError, assertHistory, bundleToScript, drainJobs, expectIR, jsonCopy, registryOf, replay, replayRequest, runWorkflowTaskInProcess, runWorkflowTaskInVm, simulate };
+export { type ActivityMock, type ActivityMockInfo, type ChildMock, type ExpectedEvent, HistoryAssertionError, type IRSnapshot, type NodeMock, type NodeMockResult, QueryFailedError, QueryRejectedError, ReplayError, type ReplayInput, type ResetOptions, RunBlockedError, type SimulateOptions, type SimulatedStep, type SimulationResult, type StartOptions, type TestEnvironmentOptions, TestRunHandle, TestWorkflowEnvironment, UnfinishedHandlersError, type UpdateOptions, UpdateRefusedError, type UpdateResult, type UpdateStatus, WorkflowAlreadyStartedError, WorkflowFailedError, WorkflowTaskFailedError, assertHistory, bundleToScript, drainJobs, expectIR, jsonCopy, registryOf, replay, replayRequest, runWorkflowTaskInProcess, runWorkflowTaskInVm, simulate };