@fluidgrids/workflows 2026.1029.1 → 2026.1030.1

package/dist/{chunk-ELL2RBML.cjs → chunk-ZCGKGDCL.cjs}

@@ -84,16 +84,36 @@ var ApplicationError = class extends WorkflowFailure {
   }
 };
 var ActivityFailure = class extends WorkflowFailure {
-  constructor(message, activityId, nodeType, operation, cause) {
+  constructor(message, activityId, nodeType, operation, cause, activityName) {
     super(message, cause instanceof WorkflowFailure ? cause.errorType : "UNKNOWN", { cause });
     this.activityId = activityId;
     this.nodeType = nodeType;
     this.operation = operation;
+    this.activityName = activityName;
     this.name = "ActivityFailure";
   }
   activityId;
   nodeType;
   operation;
+  activityName;
+};
+var ActivityPausedError = class extends ApplicationError {
+  constructor(message = "The activity was paused", details) {
+    super(message, {
+      type: "ActivityPausedError",
+      errorType: "TRANSIENT",
+      ...details !== void 0 ? { details } : {}
+    });
+    this.name = "ActivityPausedError";
+  }
+};
+var QueryHandlerSideEffect = class extends Error {
+  constructor(what) {
+    super(
+      `${what} is not allowed in a query handler or an update validator; they must not change the run`
+    );
+    this.name = "QueryHandlerSideEffect";
+  }
 };
 var ChildRunFailure = class extends WorkflowFailure {
   constructor(message, childId, childRunId, cause) {
@@ -233,12 +253,14 @@ function failureToError(failure, depth = 0) {
 }
 
 exports.ActivityFailure = ActivityFailure;
+exports.ActivityPausedError = ActivityPausedError;
 exports.ApplicationError = ApplicationError;
 exports.CancelledFailure = CancelledFailure;
 exports.ChildRunFailure = ChildRunFailure;
 exports.DeterminismViolation = DeterminismViolation;
 exports.HistoryLimitExceeded = HistoryLimitExceeded;
 exports.PhaseCFeatureError = PhaseCFeatureError;
+exports.QueryHandlerSideEffect = QueryHandlerSideEffect;
 exports.ServerFailure = ServerFailure;
 exports.TerminatedFailure = TerminatedFailure;
 exports.TimeoutFailure = TimeoutFailure;

package/dist/codegen/index.d.cts

@@ -1,5 +1,5 @@
-import { N as NodeManifest } from '../manifest-gRI2Q5Fj.cjs';
-import '../types-Bb2wRnJ5.cjs';
+import { N as NodeManifest } from '../manifest-DahBQVM8.cjs';
+import '../types-V7jEEUaL.cjs';
 
 interface GeneratedClients {
     path: string;

package/dist/codegen/index.d.ts

@@ -1,5 +1,5 @@
-import { N as NodeManifest } from '../manifest-BJjrQt77.js';
-import '../types-Bb2wRnJ5.js';
+import { N as NodeManifest } from '../manifest-D-I_twys.js';
+import '../types-V7jEEUaL.js';
 
 interface GeneratedClients {
     path: string;

package/dist/{collect-BTHjQaSp.d.ts → collect-6NIEufHd.d.ts}

@@ -1,5 +1,5 @@
-import { P as Position, a as JsonObject, d as ConnectionRef, i as WorkflowAuthoring, W as WorkflowDefinition, b as WorkflowInterface, k as WorkflowConfig } from './types-Bb2wRnJ5.js';
-import { T as Tier1Recording, x as Tier1Workflow } from './workflow-8uRU9rhL.js';
+import { P as Position, J as JsonObject, d as ConnectionRef, i as WorkflowAuthoring, W as WorkflowDefinition, b as WorkflowInterface, k as WorkflowConfig } from './types-V7jEEUaL.js';
+import { T as Tier1Recording, x as Tier1Workflow } from './workflow-B18OeF7g.js';
 
 declare const LAYOUT_FORMAT = "fluidgrids.layout";
 declare const LAYOUT_FORMAT_VERSION = 1;
@@ -71,14 +71,31 @@ interface CollectedDurableWorkflow {
     trigger?: CollectedTrigger;
     /** Run-level settings the declaration lowers into `config` (R2). */
     config?: WorkflowConfig;
-    /** Runtime features its options use (C-FEATURES): `autoUpgrade`, `runRetry`, `timeouts`. */
+    /** Runtime features its options use (C-FEATURES): `autoUpgrade`, `runRetry`, `timeouts`, `dynamic`. */
     features?: string[];
+    /** A dynamic workflow (Phase C): `lower()` writes it as `code.exports.workflows["*"]`. */
+    dynamic?: boolean;
+}
+/** An exported user-activity implementation found in the workflow bundle (Phase C). */
+interface CollectedActivityImplementation {
+    module: string;
+    exportName: string;
+    name: string;
 }
 interface Tier1Collection {
     format: typeof COLLECTION_FORMAT;
     workflows: CollectedWorkflow[];
     /** Tier-2 functions; absent when the bundle has none. */
     durable?: CollectedDurableWorkflow[];
+    /** User-activity implementations exported by bundle modules; they belong on a worker. */
+    activityImplementations?: CollectedActivityImplementation[];
+    /**
+     * Modules that export a binding named `interceptors`, whatever its value:
+     * the runtime registers those exports as workflow interceptors, so
+     * `lower()` reports the `interceptors` feature from the evaluated modules
+     * rather than from the source text (C-FEATURES).
+     */
+    interceptorModules?: string[];
 }
 /** Collect the workflows exported by each module, as JSON. */
 declare function collectWorkflowExports(modules: ReadonlyArray<readonly [string, Record<string, unknown>]>): string;

package/dist/{collect-CSyOg5XC.d.cts → collect-CcTCKqx6.d.cts}

@@ -1,5 +1,5 @@
-import { P as Position, a as JsonObject, d as ConnectionRef, i as WorkflowAuthoring, W as WorkflowDefinition, b as WorkflowInterface, k as WorkflowConfig } from './types-Bb2wRnJ5.cjs';
-import { T as Tier1Recording, x as Tier1Workflow } from './workflow-CZOXUlQ5.cjs';
+import { P as Position, J as JsonObject, d as ConnectionRef, i as WorkflowAuthoring, W as WorkflowDefinition, b as WorkflowInterface, k as WorkflowConfig } from './types-V7jEEUaL.cjs';
+import { T as Tier1Recording, x as Tier1Workflow } from './workflow-BJPFv3cp.cjs';
 
 declare const LAYOUT_FORMAT = "fluidgrids.layout";
 declare const LAYOUT_FORMAT_VERSION = 1;
@@ -71,14 +71,31 @@ interface CollectedDurableWorkflow {
     trigger?: CollectedTrigger;
     /** Run-level settings the declaration lowers into `config` (R2). */
     config?: WorkflowConfig;
-    /** Runtime features its options use (C-FEATURES): `autoUpgrade`, `runRetry`, `timeouts`. */
+    /** Runtime features its options use (C-FEATURES): `autoUpgrade`, `runRetry`, `timeouts`, `dynamic`. */
     features?: string[];
+    /** A dynamic workflow (Phase C): `lower()` writes it as `code.exports.workflows["*"]`. */
+    dynamic?: boolean;
+}
+/** An exported user-activity implementation found in the workflow bundle (Phase C). */
+interface CollectedActivityImplementation {
+    module: string;
+    exportName: string;
+    name: string;
 }
 interface Tier1Collection {
     format: typeof COLLECTION_FORMAT;
     workflows: CollectedWorkflow[];
     /** Tier-2 functions; absent when the bundle has none. */
     durable?: CollectedDurableWorkflow[];
+    /** User-activity implementations exported by bundle modules; they belong on a worker. */
+    activityImplementations?: CollectedActivityImplementation[];
+    /**
+     * Modules that export a binding named `interceptors`, whatever its value:
+     * the runtime registers those exports as workflow interceptors, so
+     * `lower()` reports the `interceptors` feature from the evaluated modules
+     * rather than from the source text (C-FEATURES).
+     */
+    interceptorModules?: string[];
 }
 /** Collect the workflows exported by each module, as JSON. */
 declare function collectWorkflowExports(modules: ReadonlyArray<readonly [string, Record<string, unknown>]>): string;

package/dist/{file-cgL9l9l8.d.cts → file-BxYpwjRQ.d.cts}

@@ -1,5 +1,5 @@
-import { E as ErrorType, J as Json, a as JsonObject } from './types-Bb2wRnJ5.cjs';
-import { e as BuiltInQueryName, W as WorkflowCommand, n as CommandType, F as Failure, P as ParentClosePolicy, Y as RunEventDraft, a as WorkflowTaskFailureCause, Z as RunEventRecord, w as HISTORY_PROTOCOL, ai as WorkflowInfoSnapshot, ak as WorkflowTaskResult } from './types-CQKOhPTa.cjs';
+import { E as ErrorType, a as Json, J as JsonObject } from './types-V7jEEUaL.cjs';
+import { W as WorkflowCommand, s as CommandType, F as Failure, P as ParentClosePolicy, ab as RunEventDraft, a as WorkflowTaskFailureCause, R as RunEventRecord, L as HISTORY_PROTOCOL, b as WorkflowInfoSnapshot, aA as WorkflowTaskResult } from './types-Bv2i4cBX.cjs';
 
 declare const RUN_EVENT_SCHEMA_ID = "https://docs.fluidgrids.ai/schemas/run-event.schema.json";
 declare const WORKFLOW_COMMAND_SCHEMA_ID = "https://docs.fluidgrids.ai/schemas/workflow-command.schema.json";
@@ -262,6 +262,18 @@ declare const RUN_EVENT_SCHEMA: {
                 readonly idConflictPolicy: {
                     readonly enum: readonly ["FAIL", "USE_EXISTING", "TERMINATE_EXISTING"];
                 };
+                readonly fairnessKey: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly maxLength: 255;
+                    readonly description: "Phase C: the fairness key of the task (11 §2.11); default the workspace id.";
+                };
+                readonly fairnessWeight: {
+                    readonly type: "number";
+                    readonly minimum: 0.1;
+                    readonly maximum: 10;
+                    readonly description: "Phase C: the weight of the fairness key, 0.1 to 10 (default 1).";
+                };
             };
         };
         readonly legacyCanRetryPolicy: {
@@ -330,6 +342,7 @@ declare const RUN_EVENT_SCHEMA: {
             readonly additionalProperties: {
                 readonly type: "string";
             };
+            readonly description: "Interceptor headers (11 §2.10): string values; a user activity carries at most 16 KiB of JSON (checked by validateCommands).";
         };
     };
     readonly type: "object";
@@ -633,6 +646,18 @@ declare const WORKFLOW_COMMAND_SCHEMA: {
                 readonly idConflictPolicy: {
                     readonly enum: readonly ["FAIL", "USE_EXISTING", "TERMINATE_EXISTING"];
                 };
+                readonly fairnessKey: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly maxLength: 255;
+                    readonly description: "Phase C: the fairness key of the task (11 §2.11); default the workspace id.";
+                };
+                readonly fairnessWeight: {
+                    readonly type: "number";
+                    readonly minimum: 0.1;
+                    readonly maximum: 10;
+                    readonly description: "Phase C: the weight of the fairness key, 0.1 to 10 (default 1).";
+                };
             };
         };
         readonly legacyCanRetryPolicy: {
@@ -701,6 +726,7 @@ declare const WORKFLOW_COMMAND_SCHEMA: {
             readonly additionalProperties: {
                 readonly type: "string";
             };
+            readonly description: "Interceptor headers (11 §2.10): string values; a user activity carries at most 16 KiB of JSON (checked by validateCommands).";
         };
     };
     readonly type: "object";
@@ -726,7 +752,7 @@ declare const WORKFLOW_COMMAND_SCHEMA: {
     readonly $schema: "https://json-schema.org/draft/2020-12/schema";
     readonly $id: "https://docs.fluidgrids.ai/schemas/workflow-command.schema.json";
     readonly title: "FluidGrids workflow-task command";
-    readonly description: "A flat object discriminated by an UPPER_SNAKE type. Commands travel as [JSON!]! (DB4). UPSERT_SEARCH_ATTRIBUTES, ACCEPT_UPDATE, REJECT_UPDATE and COMPLETE_UPDATE are defined but refused in Phase B.";
+    readonly description: "A flat object discriminated by an UPPER_SNAKE type. Commands travel as [JSON!]! (DB4). UPSERT_SEARCH_ATTRIBUTES, ACCEPT_UPDATE, REJECT_UPDATE, COMPLETE_UPDATE and SCHEDULE_ACTIVITY of kind user are Phase C: the service accepts them only for the C-GATE features its flags enable (c.searchAttributes, c.updates, c.userActivity).";
 };
 /** The workflow-task request and result of the runtime ABI. */
 declare const WORKFLOW_TASK_SCHEMA: {
@@ -912,7 +938,68 @@ declare const WORKFLOW_TASK_SCHEMA: {
                 readonly retry: {
                     readonly $ref: "#/$defs/runRetryPolicy";
                 };
+                readonly searchAttributes: {
+                    readonly type: "object";
+                };
+                readonly fairnessKey: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly maxLength: 255;
+                    readonly description: "Phase C: the fairness key of the task (11 §2.11); default the workspace id.";
+                };
+                readonly fairnessWeight: {
+                    readonly type: "number";
+                    readonly minimum: 0.1;
+                    readonly maximum: 10;
+                    readonly description: "Phase C: the weight of the fairness key, 0.1 to 10 (default 1).";
+                };
+            };
+        };
+        readonly updateRequest: {
+            readonly type: "object";
+            readonly required: readonly ["updateId", "name"];
+            readonly description: "Phase C (C-ABI-H): a pending update the lease delivers. admitted marks one history already holds as UPDATE_ADMITTED; the runtime delivers that one from the event.";
+            readonly properties: {
+                readonly updateId: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly maxLength: 256;
+                };
+                readonly name: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly maxLength: 256;
+                };
+                readonly args: {};
+                readonly admitted: {
+                    readonly type: "boolean";
+                };
+                readonly headers: {
+                    readonly $ref: "#/$defs/headers";
+                };
+            };
+            readonly additionalProperties: false;
+        };
+        readonly sinkCall: {
+            readonly type: "object";
+            readonly required: readonly ["sink", "fn", "args"];
+            readonly description: "Phase C: a call of ctx.sinks.<sink>.<fn>(...args), never made on replay.";
+            readonly properties: {
+                readonly sink: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly maxLength: 256;
+                };
+                readonly fn: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly maxLength: 256;
+                };
+                readonly args: {
+                    readonly type: "array";
+                };
             };
+            readonly additionalProperties: false;
         };
         readonly localActivityRequest: {
             readonly type: "object";
@@ -1018,6 +1105,12 @@ declare const WORKFLOW_TASK_SCHEMA: {
                         };
                     };
                 };
+                readonly updates: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly $ref: "#/$defs/updateRequest";
+                    };
+                };
                 readonly queries: {
                     readonly type: "array";
                     readonly items: {
@@ -1030,12 +1123,24 @@ declare const WORKFLOW_TASK_SCHEMA: {
                                 readonly maxLength: 256;
                             };
                             readonly name: {
-                                readonly enum: readonly BuiltInQueryName[];
+                                readonly description: `A built-in query (${string}) or, from C-R1, the name of a custom query.`;
+                                readonly type: "string";
+                                readonly minLength: 1;
+                                readonly maxLength: 256;
                             };
                             readonly args: {};
                         };
                     };
                 };
+                readonly features: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                    };
+                    readonly uniqueItems: true;
+                    readonly description: "The bundle features (code.features names) the workspace enables for this task. From C-R1 the runtime reads `interceptors`: a task of a bundle that exports interceptors fails with UNSUPPORTED_COMMAND unless it is listed.";
+                };
             };
         };
         readonly result: {
@@ -1096,9 +1201,20 @@ declare const WORKFLOW_TASK_SCHEMA: {
                             readonly error: {
                                 readonly type: "string";
                             };
+                            readonly rejected: {
+                                readonly type: "boolean";
+                                readonly description: "Phase C: no handler took the query name (the service answers VALIDATION).";
+                            };
                         };
                     };
                 };
+                readonly sinkCalls: {
+                    readonly type: "array";
+                    readonly maxItems: 256;
+                    readonly items: {
+                        readonly $ref: "#/$defs/sinkCall";
+                    };
+                };
                 readonly failure: {
                     readonly type: "object";
                     readonly required: readonly ["cause", "message"];
@@ -1393,6 +1509,18 @@ declare const WORKFLOW_TASK_SCHEMA: {
                 readonly idConflictPolicy: {
                     readonly enum: readonly ["FAIL", "USE_EXISTING", "TERMINATE_EXISTING"];
                 };
+                readonly fairnessKey: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly maxLength: 255;
+                    readonly description: "Phase C: the fairness key of the task (11 §2.11); default the workspace id.";
+                };
+                readonly fairnessWeight: {
+                    readonly type: "number";
+                    readonly minimum: 0.1;
+                    readonly maximum: 10;
+                    readonly description: "Phase C: the weight of the fairness key, 0.1 to 10 (default 1).";
+                };
             };
         };
         readonly legacyCanRetryPolicy: {
@@ -1461,6 +1589,7 @@ declare const WORKFLOW_TASK_SCHEMA: {
             readonly additionalProperties: {
                 readonly type: "string";
             };
+            readonly description: "Interceptor headers (11 §2.10): string values; a user activity carries at most 16 KiB of JSON (checked by validateCommands).";
         };
     };
 };
@@ -1499,7 +1628,7 @@ declare const HISTORY_FILE_SCHEMA: {
         };
         readonly replay: {
             readonly type: "boolean";
-            readonly description: "False for histories that use Phase C features (updates); they are parsed and projected but not replayed.";
+            readonly description: "False for histories that are parsed and projected but not replayed (written by hand for a feature the recording runtime did not have).";
         };
         readonly info: {
             readonly $ref: "#/$defs/info";
@@ -1670,6 +1799,21 @@ declare const HISTORY_FILE_SCHEMA: {
                 readonly retry: {
                     readonly $ref: "#/$defs/runRetryPolicy";
                 };
+                readonly searchAttributes: {
+                    readonly type: "object";
+                };
+                readonly fairnessKey: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly maxLength: 255;
+                    readonly description: "Phase C: the fairness key of the task (11 §2.11); default the workspace id.";
+                };
+                readonly fairnessWeight: {
+                    readonly type: "number";
+                    readonly minimum: 0.1;
+                    readonly maximum: 10;
+                    readonly description: "Phase C: the weight of the fairness key, 0.1 to 10 (default 1).";
+                };
             };
         };
         readonly json: {
@@ -1924,6 +2068,18 @@ declare const HISTORY_FILE_SCHEMA: {
                 readonly idConflictPolicy: {
                     readonly enum: readonly ["FAIL", "USE_EXISTING", "TERMINATE_EXISTING"];
                 };
+                readonly fairnessKey: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly maxLength: 255;
+                    readonly description: "Phase C: the fairness key of the task (11 §2.11); default the workspace id.";
+                };
+                readonly fairnessWeight: {
+                    readonly type: "number";
+                    readonly minimum: 0.1;
+                    readonly maximum: 10;
+                    readonly description: "Phase C: the weight of the fairness key, 0.1 to 10 (default 1).";
+                };
             };
         };
         readonly legacyCanRetryPolicy: {
@@ -1992,6 +2148,7 @@ declare const HISTORY_FILE_SCHEMA: {
             readonly additionalProperties: {
                 readonly type: "string";
             };
+            readonly description: "Interceptor headers (11 §2.10): string values; a user activity carries at most 16 KiB of JSON (checked by validateCommands).";
         };
     };
 };
@@ -2036,7 +2193,15 @@ interface HistoryIssue {
  *   `retry` and anything outside {@link CORE_CAN_OPTIONS}.
  * - `parity.workflowIdTarget`: a `SIGNAL_RUN` or `REQUEST_CANCEL_EXTERNAL_RUN`
  *   target given as `{ workflowKey, workflowId }`.
- * - `c.*`: reserved for Phase C, never enabled in Phase B.
+ * - `c.updates` (Phase C, `fluidgrids.run-control`): `ACCEPT_UPDATE`,
+ *   `REJECT_UPDATE` and `COMPLETE_UPDATE`.
+ * - `c.searchAttributes` (Phase C, `fluidgrids.search-attributes`):
+ *   `UPSERT_SEARCH_ATTRIBUTES`.
+ * - `c.userActivity` (Phase C, `fluidgrids.self-hosted-workers`): a
+ *   `SCHEDULE_ACTIVITY` of `kind: 'user'`.
+ *
+ * Phase B never enables a `c.*` feature, so a workspace without the Phase C
+ * flags gets exactly the B19 command set (CX1).
  */
 type CommandFeature = 'core' | 'parity.can' | 'parity.context' | 'parity.localActivity' | 'parity.externalCancel' | 'parity.childOptions' | 'parity.canOptions' | 'parity.workflowIdTarget' | 'c.updates' | 'c.searchAttributes' | 'c.userActivity';
 /** Every feature, in a stable order. */
@@ -2045,13 +2210,32 @@ declare const COMMAND_FEATURES: readonly CommandFeature[];
 declare const PHASE_B_CORE_FEATURES: ReadonlySet<CommandFeature>;
 /** Every Phase B feature: the core set plus what `fluidgrids.durable-parity` enables. */
 declare const PHASE_B_PARITY_FEATURES: ReadonlySet<CommandFeature>;
+/** The Phase C features (C-GATE extension, C-R1). */
+declare const PHASE_C_FEATURES: readonly CommandFeature[];
+/**
+ * The platform flag that enables each Phase C feature (PLAN-C §2.1). Each one
+ * also needs `fluidgrids.code-first` and `fluidgrids.durable-functions`.
+ */
+declare const PHASE_C_FEATURE_FLAGS: Readonly<Record<string, string>>;
+/**
+ * The platform flag that each bundle feature (C-FEATURES, `code.features`)
+ * needs. The service refuses a push that declares a feature whose flag is off
+ * (`durableRuntimeIssues`). Features without an entry need no flag beyond
+ * `fluidgrids.durable-functions`. `interceptors` is gated with run control so
+ * that a Phase C bundle fails closed until its owner turns the flag on.
+ */
+declare const CODE_FEATURE_FLAGS: Readonly<Record<string, string>>;
+/** The bundle features added in Phase C (C-FEATURES, C-R1), in a stable order. */
+declare const PHASE_C_CODE_FEATURES: readonly string[];
 /**
  * Child options a Phase B core child may carry: every option the R1 runtime
  * already wrote into `START_CHILD_RUN` and the Phase B service accepted (it
  * stored or ignored them). Only the options new in R2 (`retry`,
  * `versioningBehavior`, `idReusePolicy`, `idConflictPolicy`) need
  * `parity.childOptions`, so a Phase B workflow behaves the same with the
- * parity flag off.
+ * parity flag off. The fairness options (C-R1) need only
+ * `fluidgrids.durable-functions` (CWD2): a service without the dispatcher
+ * stores and ignores them.
  */
 declare const CORE_CHILD_OPTIONS: ReadonlySet<string>;
 /**
@@ -2096,24 +2280,38 @@ declare function isCommandEnabled(type: CommandType, enabled?: 'core' | 'parity'
  * True when every feature `command` needs is enabled. With a release level
  * (`core`, `parity`) it answers as R1 did: the command type decides, and
  * `REQUEST_CANCEL_EXTERNAL_RUN` aimed at one of the run's own children is
- * core.
+ * core. A command that needs a Phase C feature (`c.*`, for example a
+ * `SCHEDULE_ACTIVITY` of kind `user`, whose type is core) is refused by every
+ * release level, so the default gate fails closed.
  */
 declare function isWorkflowCommandEnabled(command: WorkflowCommand, enabled?: CommandGate): boolean;
+/**
+ * The bundle features (C-FEATURES, `code.features` names) a command gate's
+ * flags enable, sorted: a feature is enabled when its flag
+ * ({@link CODE_FEATURE_FLAGS}) is on, and a flag is on when the gate holds a
+ * command feature it enables (`fluidgrids.run-control` for `c.updates`,
+ * `fluidgrids.durable-parity` for a parity feature outside the Phase B core
+ * set). Release levels enable none.
+ * It is what a lease sends as `WorkflowTaskRequest.features`.
+ */
+declare function codeFeaturesEnabledBy(enabled: CommandGate): string[];
 /** Why a command is refused by the gate, naming the missing features. */
 declare function unsupportedMessage(command: WorkflowCommand, enabled?: CommandGate): string;
 /** What the lease of the current workflow task already granted (C-LEASE). */
 interface CommandRelief {
     /** Local activities the lease asked the worker to run (`localActivityRequested`). */
     grantedLocalActivityIds: readonly string[];
-    /** Updates the lease delivered to the task (Phase C). */
+    /** Updates the lease delivered to the task (stamped with its `deliveredTaskId`, Phase C). */
     deliveredUpdateIds: readonly string[];
 }
 /**
- * True for a command that answers work the lease already granted: a
- * `RECORD_LOCAL_ACTIVITY` of a granted local activity, or an update reply to
- * a delivered update. Such commands are accepted even when the flag that
- * enables new requests of their kind is off (BP7), so turning a flag off never
- * strands work that was already started.
+ * True for a command that answers work the service already granted (BP7,
+ * CX2): a `RECORD_LOCAL_ACTIVITY` of a granted local activity,
+ * `ACCEPT_UPDATE` or `REJECT_UPDATE` of an update the lease delivered, and
+ * every `COMPLETE_UPDATE` (it can only finish an update the run accepted,
+ * which `eventsForCommands` checks against the history). Such commands are
+ * accepted even when the flag that enables new requests of their kind is off,
+ * so turning a flag off never strands work that was already started.
  */
 declare function isReliefCommand(command: WorkflowCommand, lease: CommandRelief): boolean;
 
@@ -2133,8 +2331,16 @@ type ActivityStatus = 'SCHEDULED' | 'STARTED' | 'COMPLETED' | 'FAILED' | 'TIMED_
 interface ActivityState {
     status: ActivityStatus;
     attempt: number;
+    /** `node` (a canvas node operation) or `user` (a user activity, Phase C). */
+    kind: 'node' | 'user';
+    /** The node type; empty for a user activity. */
     nodeType: string;
+    /** The node operation; empty for a user activity. */
     operation: string;
+    /** The user activity's name (Phase C). */
+    activityName?: string;
+    /** The user activity's task queue (Phase C). */
+    taskQueue?: string;
     scheduledSeq: number;
     cancellationType?: string;
     summary?: string;
@@ -2170,6 +2376,18 @@ interface ExternalState {
     status: 'PENDING' | 'RESOLVED';
     ok?: boolean;
 }
+/**
+ * An update as history knows it (Phase C, 11 §2.39): `ADMITTED` (update-with-
+ * start or a reset re-application, before the task accepted it), `ACCEPTED`
+ * and `COMPLETED`. A rejected update leaves no event and is not here.
+ */
+interface UpdateState {
+    status: 'ADMITTED' | 'ACCEPTED' | 'COMPLETED';
+    name: string;
+    /** Seq of `UPDATE_ADMITTED` or `UPDATE_ACCEPTED`, whichever came first. */
+    seq: number;
+    failed?: boolean;
+}
 /** A run as its history describes it. */
 interface RunState {
     status: RunStatus;
@@ -2200,6 +2418,10 @@ interface RunState {
     markers: Record<string, Json>;
     signalsReceived: number;
     context: JsonObject;
+    /** Updates by id (Phase C). */
+    updates: Record<string, UpdateState>;
+    /** Search attributes: the start's, merged with every upsert; null removes a key (Phase C). */
+    searchAttributes: JsonObject;
     lastEventAt?: string;
 }
 /** A history that breaks the state machine (an event that cannot follow the ones before it). */
@@ -2209,6 +2431,8 @@ declare class HistoryStateError extends Error {
 }
 /** The state before any event. */
 declare function initialRunState(): RunState;
+/** Merge search attributes: a null value removes the attribute (11 §2.8). */
+declare function mergeSearchAttributes(current: JsonObject, entries: JsonObject): JsonObject;
 /** UTF-8 length of a string (the history byte caps count UTF-8). */
 declare function utf8Bytes(text: string): number;
 /** True while an activity may still produce a result. */
@@ -2237,6 +2461,17 @@ interface EventsForCommandsContext {
     enabled?: CommandGate;
     /** What the lease already granted; relief commands pass the gate (see `isReliefCommand`). */
     relief?: CommandRelief;
+    /**
+     * The pending updates the lease delivered, by id (C-ABI-H): `UPDATE_ACCEPTED`
+     * carries the request from here. An update history already admitted
+     * (`UPDATE_ADMITTED`) is found in the run state instead. An update reply
+     * for an id in neither is `INVALID_REQUEST`.
+     */
+    updates?: Readonly<Record<string, {
+        name: string;
+        args?: Json;
+        headers?: Record<string, string>;
+    }>>;
 }
 type EventsForCommandsResult = {
     ok: true;
@@ -2305,4 +2540,4 @@ declare function createHistoryFile(workflowFn: string, events: RunEventRecord[],
 /** Serialise a history file the way the CLI and the fixtures write it. */
 declare function serializeHistoryFile(file: HistoryFile): string;
 
-export { type ActivityState as A, continueAsNewRetryShape as B, type CommandGate as C, createHistoryFile as D, type EventsForCommandsContext as E, eventsForCommands as F, hasUnprocessedInput as G, type HistoryIssue as H, initialRunState as I, isActivityOpen as J, isChildOpen as K, type LocalActivityState as L, isCommandEnabled as M, isReliefCommand as N, isWorkflowCommandEnabled as O, PHASE_B_CORE_FEATURES as P, parseHistoryFile as Q, RUN_EVENT_SCHEMA as R, pendingCounts as S, type TimerState as T, projectRunState as U, serializeHistoryFile as V, WORKFLOW_COMMAND_SCHEMA as W, taskCompletedEvents as X, unsupportedMessage as Y, utf8Bytes as Z, type CommandRelief as a, type ActivityStatus as b, COMMAND_FEATURES as c, CORE_CAN_OPTIONS as d, CORE_CHILD_OPTIONS as e, type ChildState as f, type ChildStatus as g, type CommandFeature as h, type EventsForCommandsResult as i, type ExternalState as j, HISTORY_FILE_FORMAT as k, HISTORY_FILE_SCHEMA as l, HISTORY_FILE_SCHEMA_ID as m, HISTORY_SCHEMA_FILES as n, type HistoryFile as o, HistoryFileError as p, HistoryStateError as q, PHASE_B_PARITY_FEATURES as r, RUN_EVENT_SCHEMA_ID as s, type RunState as t, type RunStatus as u, WORKFLOW_COMMAND_SCHEMA_ID as v, WORKFLOW_TASK_SCHEMA as w, WORKFLOW_TASK_SCHEMA_ID as x, applyEvent as y, commandFeatures as z };
+export { pendingCounts as $, type ActivityState as A, WORKFLOW_TASK_SCHEMA as B, type CommandGate as C, WORKFLOW_TASK_SCHEMA_ID as D, type EventsForCommandsContext as E, applyEvent as F, codeFeaturesEnabledBy as G, type HistoryIssue as H, commandFeatures as I, continueAsNewRetryShape as J, createHistoryFile as K, type LocalActivityState as L, eventsForCommands as M, hasUnprocessedInput as N, initialRunState as O, PHASE_B_CORE_FEATURES as P, isActivityOpen as Q, RUN_EVENT_SCHEMA as R, isChildOpen as S, type TimerState as T, type UpdateState as U, isCommandEnabled as V, WORKFLOW_COMMAND_SCHEMA as W, isReliefCommand as X, isWorkflowCommandEnabled as Y, mergeSearchAttributes as Z, parseHistoryFile as _, type CommandRelief as a, projectRunState as a0, serializeHistoryFile as a1, taskCompletedEvents as a2, unsupportedMessage as a3, utf8Bytes as a4, type ActivityStatus as b, CODE_FEATURE_FLAGS as c, COMMAND_FEATURES as d, CORE_CAN_OPTIONS as e, CORE_CHILD_OPTIONS as f, type ChildState as g, type ChildStatus as h, type CommandFeature as i, type EventsForCommandsResult as j, type ExternalState as k, HISTORY_FILE_FORMAT as l, HISTORY_FILE_SCHEMA as m, HISTORY_FILE_SCHEMA_ID as n, HISTORY_SCHEMA_FILES as o, type HistoryFile as p, HistoryFileError as q, HistoryStateError as r, PHASE_B_PARITY_FEATURES as s, PHASE_C_CODE_FEATURES as t, PHASE_C_FEATURES as u, PHASE_C_FEATURE_FLAGS as v, RUN_EVENT_SCHEMA_ID as w, type RunState as x, type RunStatus as y, WORKFLOW_COMMAND_SCHEMA_ID as z };