@fluidgrids/workflows 2026.1029.1 → 2026.1030.1

package/dist/{types-CnIOinoz.d.ts → types-Bv2i4cBX.d.cts}

@@ -1,4 +1,4 @@
-import { a as JsonObject, E as ErrorType, J as Json } from './types-Bb2wRnJ5.js';
+import { J as JsonObject, E as ErrorType, a as Json } from './types-V7jEEUaL.cjs';
 
 /**
  * The durable-function history contract (PLAN-B C-HIST, C-CMD, C-ABI):
@@ -17,10 +17,21 @@ declare const HISTORY_PROTOCOL = 1;
  * The runtime compatibility release of this SDK (the runtime train of
  * PLAN-B19 critique 4.5). R1 is the Phase B core runtime; R2 adds local
  * activities, handler drain, run handles by workflow id and the R2 history
- * fields. A history recorded by release N replays under every release >= N;
- * the service and the workers pin the release whose histories they accept.
+ * fields. Release 3 (Phase C, C-R1) adds updates, custom and default queries,
+ * dynamic workflows, user activities, search attributes, interceptors with
+ * header propagation and sinks. A history recorded by release N replays under
+ * every release >= N; the service and the workers pin the release whose
+ * histories they accept.
  */
-declare const RUNTIME_RELEASE = 2;
+declare const RUNTIME_RELEASE = 3;
+/**
+ * What the runtime of this release can answer (C-ABI-H, reported as
+ * `FluidgridsRuntimeAbi.capabilities`). A bundle built before C-R1 reports no
+ * capabilities, and the service refuses updates and custom queries for it
+ * (DC4) instead of delivering requests the bundle would ignore.
+ */
+declare const RUNTIME_CAPABILITIES: readonly ["updates", "queries", "dynamic"];
+type RuntimeCapability = (typeof RUNTIME_CAPABILITIES)[number];
 /** Every value of the `type` column of `workflow_run_events`, UPPER_SNAKE (DB4). */
 declare const EVENT_TYPES: readonly ["WORKFLOW_STARTED", "WORKFLOW_TASK_SCHEDULED", "WORKFLOW_TASK_STARTED", "WORKFLOW_TASK_COMPLETED", "WORKFLOW_TASK_FAILED", "WORKFLOW_TASK_TIMED_OUT", "ACTIVITY_SCHEDULED", "ACTIVITY_STARTED", "ACTIVITY_HEARTBEAT", "ACTIVITY_COMPLETED", "ACTIVITY_FAILED", "ACTIVITY_TIMED_OUT", "ACTIVITY_CANCEL_REQUESTED", "ACTIVITY_CANCELLED", "ACTIVITY_PAUSED", "ACTIVITY_UNPAUSED", "ACTIVITY_RESET", "ACTIVITY_OPTIONS_UPDATED", "TIMER_STARTED", "TIMER_FIRED", "TIMER_CANCELLED", "SIGNAL_RECEIVED", "UPDATE_ADMITTED", "UPDATE_ACCEPTED", "UPDATE_COMPLETED", "CHILD_RUN_INITIATED", "CHILD_RUN_STARTED", "CHILD_RUN_COMPLETED", "CHILD_RUN_FAILED", "CHILD_RUN_CANCELLED", "CHILD_RUN_TERMINATED", "CHILD_RUN_TIMED_OUT", "EXTERNAL_RUN_CANCEL_REQUESTED", "EXTERNAL_RUN_CANCEL_RESOLVED", "EXTERNAL_RUN_SIGNALED", "SIDE_EFFECT_RECORDED", "LOCAL_ACTIVITY_COMPLETED", "LOCAL_ACTIVITY_FAILED", "SEARCH_ATTRIBUTES_UPSERTED", "CONTEXT_UPSERTED", "MARKER_RECORDED", "WORKFLOW_CANCEL_REQUESTED", "WORKFLOW_RESET", "VERSIONING_OVERRIDE_SET", "WORKFLOW_COMPLETED", "WORKFLOW_FAILED", "WORKFLOW_CANCELLED", "WORKFLOW_TERMINATED", "WORKFLOW_TIMED_OUT", "WORKFLOW_CONTINUED_AS_NEW"];
 type RunEventType = (typeof EVENT_TYPES)[number];
@@ -31,7 +42,11 @@ type CommandType = (typeof COMMAND_TYPES)[number];
 declare const PHASE_B_CORE_COMMANDS: ReadonlySet<CommandType>;
 /** Commands of the Phase B parity releases (defined now, enabled by the service per release). */
 declare const PHASE_B_PARITY_COMMANDS: ReadonlySet<CommandType>;
-/** Commands that are defined but refused in Phase B (`UNSUPPORTED_COMMAND`). */
+/**
+ * Commands of Phase C. They were refused throughout Phase B; from C-R1 the
+ * C-GATE feature set decides (`c.updates`, `c.searchAttributes`), and the
+ * deprecated release levels of `isCommandEnabled` still refuse them.
+ */
 declare const PHASE_C_COMMANDS: ReadonlySet<CommandType>;
 /** Commands that end the run; one may appear, and only last in a batch. */
 declare const TERMINAL_COMMANDS: ReadonlySet<CommandType>;
@@ -165,15 +180,26 @@ interface WorkflowTimeouts {
     runTimeout?: number;
     workflowTaskTimeout?: number;
 }
-interface ScheduleActivityCommand extends CommandBase {
+/** The longest fairness key (11 §2.11). */
+declare const FAIRNESS_KEY_MAX_LENGTH = 255;
+/** The range of a fairness weight (11 §2.11); the default is 1. */
+declare const FAIRNESS_WEIGHT_MIN = 0.1;
+declare const FAIRNESS_WEIGHT_MAX = 10;
+/** The name of a user activity (C-CMD-C). */
+declare const ACTIVITY_NAME_PATTERN = "^[A-Za-z_][A-Za-z0-9_.-]{0,127}$";
+/** The name of a task queue (C-CMD-C); `managed` is the platform's queue. */
+declare const TASK_QUEUE_NAME_PATTERN = "^[a-z0-9][a-z0-9-]{0,62}$";
+/** At most this many connections a user activity may name. */
+declare const MAX_ACTIVITY_CONNECTIONS = 16;
+/** UTF-8 bytes of the JSON of a command's `headers` map, at most. */
+declare const MAX_HEADERS_BYTES: number;
+/** At most this many sink calls one workflow task reports. */
+declare const MAX_SINK_CALLS = 256;
+/** What both kinds of `SCHEDULE_ACTIVITY` carry. */
+interface ScheduleActivityBase extends CommandBase {
     type: 'SCHEDULE_ACTIVITY';
     activityId: string;
-    kind: 'node';
-    nodeType: string;
-    nodeVersion?: string;
-    operation: string;
     args: Json;
-    connection?: string;
     retry: RetryPolicy;
     startToCloseTimeout?: number;
     scheduleToCloseTimeout?: number;
@@ -182,8 +208,34 @@ interface ScheduleActivityCommand extends CommandBase {
     cancellationType?: ActivityCancellationType;
     priority?: number;
     summary?: string;
+    /** Fairness within the queue (11 §2.11, Phase C); default the workspace id. */
+    fairnessKey?: string;
+    /** 0.1 to 10; default 1. */
+    fairnessWeight?: number;
+}
+/** A canvas node operation run as an activity (`ctx.run`). */
+interface ScheduleNodeActivityCommand extends ScheduleActivityBase {
+    kind: 'node';
+    nodeType: string;
+    nodeVersion?: string;
+    operation: string;
+    connection?: string;
     runOn?: string;
 }
+/**
+ * A user activity (`ctx.activity`, Phase C, C-CMD-C): a function a
+ * self-hosted worker polling `taskQueue` implements. It has no node type,
+ * operation or `runOn`.
+ */
+interface ScheduleUserActivityCommand extends ScheduleActivityBase {
+    kind: 'user';
+    activityName: string;
+    taskQueue: string;
+    /** Connection names the worker may resolve per attempt (H2), at most 16. */
+    connections?: string[];
+}
+/** `SCHEDULE_ACTIVITY`, a `oneOf` on `kind` (C-CMD-C). */
+type ScheduleActivityCommand = ScheduleNodeActivityCommand | ScheduleUserActivityCommand;
 interface RequestCancelActivityCommand extends CommandBase {
     type: 'REQUEST_CANCEL_ACTIVITY';
     activityId: string;
@@ -217,6 +269,9 @@ interface ChildRunOptions {
     versioningBehavior?: VersioningBehavior;
     idReusePolicy?: WorkflowIdReusePolicy;
     idConflictPolicy?: WorkflowIdConflictPolicy;
+    /** Fairness of the child's tasks (11 §2.11, Phase C); inherited by default. */
+    fairnessKey?: string;
+    fairnessWeight?: number;
     [key: string]: Json | RunRetryPolicy | undefined;
 }
 interface StartChildRunCommand extends CommandBase {
@@ -362,10 +417,52 @@ interface WorkflowInfoSnapshot {
     versioningBehavior?: VersioningBehavior;
     /** The run-level retry policy of the chain. */
     retry?: RunRetryPolicy;
+    /** The run's search attributes at the start (11 §2.8, Phase C). */
+    searchAttributes?: JsonObject;
+    /** Fairness of the run's tasks (11 §2.11, Phase C). */
+    fairnessKey?: string;
+    fairnessWeight?: number;
 }
-/** A built-in query (11 §2.21). Custom queries are Phase C. */
+/** A built-in query (11 §2.21); any other name is a custom query (Phase C). */
 type BuiltInQueryName = '__stack_trace' | '__enhanced_stack_trace' | '__metadata';
 declare const BUILT_IN_QUERIES: readonly BuiltInQueryName[];
+/**
+ * A pending update the lease delivers to a workflow task (C-ABI-H). The
+ * request is not in history until the task accepts it (`UPDATE_ACCEPTED`);
+ * `admitted` marks one that history already holds as `UPDATE_ADMITTED`
+ * (update-with-start, reset re-application), which the runtime delivers from
+ * that event instead.
+ */
+interface UpdateRequest {
+    updateId: string;
+    name: string;
+    args?: Json;
+    admitted?: boolean;
+    headers?: Headers;
+}
+/** A query a task answers (11 §2.21). Built-in names need no handler. */
+interface QueryRequest {
+    queryId: string;
+    name: string;
+    args?: Json;
+}
+/**
+ * The answer to one query. `rejected` means no handler took the name (the
+ * service answers `VALIDATION`); `error` without `rejected` means the handler
+ * threw or the replay failed.
+ */
+interface QueryResult {
+    queryId: string;
+    value?: Json;
+    error?: string;
+    rejected?: boolean;
+}
+/** One call workflow code made to a worker-side sink (11 §2.31); never on replay. */
+interface SinkCall {
+    sink: string;
+    fn: string;
+    args: Json[];
+}
 /** The input of one workflow task (C-ABI). */
 interface WorkflowTaskRequest {
     protocol: number;
@@ -376,11 +473,19 @@ interface WorkflowTaskRequest {
     /** The task's start time; the clock for new side effects only. */
     nowMs: number;
     localActivityResults?: LocalActivityResult[];
-    queries?: Array<{
-        queryId: string;
-        name: BuiltInQueryName;
-        args?: Json;
-    }>;
+    /** Pending updates the lease delivers (C-ABI-H, Phase C). */
+    updates?: UpdateRequest[];
+    /** Queries to answer once the history is replayed. */
+    queries?: QueryRequest[];
+    /**
+     * The bundle features (C-FEATURES, the names of `code.features`) the
+     * workspace enables for this task, from its flags (Phase C). From C-R1 the
+     * runtime reads `interceptors`: a `task` of a bundle that exports
+     * interceptors fails with `UNSUPPORTED_COMMAND` unless it is listed, so
+     * turning `fluidgrids.run-control` off stops interceptors from running even
+     * for a bundle pushed while it was on. Absent means none.
+     */
+    features?: string[];
 }
 /** The result of one local activity, as the worker passes it back into the task (C-ABI). */
 interface LocalActivityResult {
@@ -436,11 +541,9 @@ interface WorkflowTaskResult {
     outcome: 'commands' | 'failed' | 'localActivityRequested';
     commands: WorkflowCommand[];
     localActivityRequests?: LocalActivityRequest[];
-    queryResults?: Array<{
-        queryId: string;
-        value?: Json;
-        error?: string;
-    }>;
+    queryResults?: QueryResult[];
+    /** Sink calls of the open activation, at most {@link MAX_SINK_CALLS} (Phase C). */
+    sinkCalls?: SinkCall[];
     failure?: {
         cause: WorkflowTaskFailureCause;
         message: string;
@@ -485,4 +588,4 @@ declare function isCommandEvent(event: {
     payload: JsonObject;
 }): boolean;
 
-export { type RunTarget as $, ACTIVITY_CANCELLATION_TYPES as A, BUILT_IN_QUERIES as B, type ChildCancellationType as C, DEFAULT_HISTORY_LIMIT as D, ERROR_TYPES as E, type Failure as F, type LocalActivityResult as G, HISTORY_LIMIT_EXCEEDED_RATIO as H, INPUT_EVENTS as I, PARENT_CLOSE_POLICIES as J, PHASE_B_CORE_COMMANDS as K, LOCAL_ACTIVITY_MAX_TIMEOUT_MS as L, PHASE_B_PARITY_COMMANDS as M, PHASE_C_COMMANDS as N, RUNTIME_RELEASE as O, type ParentClosePolicy as P, type RecordLocalActivityCommand as Q, type RetryPolicy as R, type RecordMarkerCommand as S, type RecordSideEffectCommand as T, type RejectUpdateCommand as U, type RequestCancelActivityCommand as V, type WorkflowCommand as W, type RequestCancelExternalRunCommand as X, type RunEventDraft as Y, type RunEventRecord as Z, type RunEventType as _, type WorkflowTaskFailureCause as a, type ScheduleActivityCommand as a0, type SignalRunCommand as a1, type StartChildRunCommand as a2, type StartTimerCommand as a3, TASK_FAILURE_CAUSES as a4, TERMINAL_COMMANDS as a5, TERMINAL_EVENTS as a6, type TaskLogLine as a7, type UnfinishedHandler as a8, type UpsertContextCommand as a9, type UpsertSearchAttributesCommand as aa, VERSIONING_BEHAVIORS as ab, type VersioningBehavior as ac, WORKFLOW_ID_CONFLICT_POLICIES as ad, WORKFLOW_ID_REUSE_POLICIES as ae, WORKFLOW_TIMEOUT_TYPES as af, type WorkflowIdConflictPolicy as ag, type WorkflowIdReusePolicy as ah, type WorkflowInfoSnapshot as ai, type WorkflowTaskRequest as aj, type WorkflowTaskResult as ak, type WorkflowTimeoutType as al, type WorkflowTimeouts as am, isCommandEvent as an, isInputEvent as ao, type RunRetryPolicy as b, type AcceptUpdateCommand as c, type ActivityCancellationType as d, type BuiltInQueryName as e, CHILD_CANCELLATION_TYPES as f, COMMAND_EVENTS as g, COMMAND_EVENT_TYPES as h, COMMAND_TYPES as i, CONTINUE_AS_NEW_SUGGESTED_RATIO as j, type CancelTimerCommand as k, type CancelWorkflowCommand as l, type ChildRunOptions as m, type CommandType as n, type CompleteUpdateCommand as o, type CompleteWorkflowCommand as p, type ContinueAsNewCommand as q, EVENT_TYPES as r, EXECUTION_KINDS as s, type ExecutionKind as t, type FailWorkflowCommand as u, type FailureSource as v, HISTORY_PROTOCOL as w, type Headers as x, type HistoryLimit as y, type LocalActivityRequest as z };
+export { PARENT_CLOSE_POLICIES as $, ACTIVITY_CANCELLATION_TYPES as A, BUILT_IN_QUERIES as B, type ChildCancellationType as C, DEFAULT_HISTORY_LIMIT as D, ERROR_TYPES as E, type Failure as F, FAIRNESS_WEIGHT_MAX as G, FAIRNESS_WEIGHT_MIN as H, type FailWorkflowCommand as I, type FailureSource as J, HISTORY_LIMIT_EXCEEDED_RATIO as K, HISTORY_PROTOCOL as L, type Headers as M, type HistoryLimit as N, INPUT_EVENTS as O, type ParentClosePolicy as P, type QueryResult as Q, type RunEventRecord as R, LOCAL_ACTIVITY_MAX_TIMEOUT_MS as S, type TaskLogLine as T, type UnfinishedHandler as U, type LocalActivityRequest as V, type WorkflowCommand as W, type LocalActivityResult as X, MAX_ACTIVITY_CONNECTIONS as Y, MAX_HEADERS_BYTES as Z, MAX_SINK_CALLS as _, type WorkflowTaskFailureCause as a, PHASE_B_CORE_COMMANDS as a0, PHASE_B_PARITY_COMMANDS as a1, PHASE_C_COMMANDS as a2, RUNTIME_CAPABILITIES as a3, RUNTIME_RELEASE as a4, type RecordLocalActivityCommand as a5, type RecordMarkerCommand as a6, type RecordSideEffectCommand as a7, type RejectUpdateCommand as a8, type RequestCancelActivityCommand as a9, type WorkflowTaskResult as aA, type WorkflowTimeoutType as aB, type WorkflowTimeouts as aC, isCommandEvent as aD, isInputEvent as aE, type RequestCancelExternalRunCommand as aa, type RunEventDraft as ab, type RunEventType as ac, type RunTarget as ad, type RuntimeCapability as ae, type ScheduleActivityCommand as af, type ScheduleNodeActivityCommand as ag, type ScheduleUserActivityCommand as ah, type SignalRunCommand as ai, type SinkCall as aj, type StartChildRunCommand as ak, type StartTimerCommand as al, TASK_FAILURE_CAUSES as am, TASK_QUEUE_NAME_PATTERN as an, TERMINAL_COMMANDS as ao, TERMINAL_EVENTS as ap, type UpsertContextCommand as aq, type UpsertSearchAttributesCommand as ar, VERSIONING_BEHAVIORS as as, type VersioningBehavior as at, WORKFLOW_ID_CONFLICT_POLICIES as au, WORKFLOW_ID_REUSE_POLICIES as av, WORKFLOW_TIMEOUT_TYPES as aw, type WorkflowIdConflictPolicy as ax, type WorkflowIdReusePolicy as ay, type WorkflowTaskRequest as az, type WorkflowInfoSnapshot as b, type UpdateRequest as c, type QueryRequest as d, type RetryPolicy as e, type RunRetryPolicy as f, ACTIVITY_NAME_PATTERN as g, type AcceptUpdateCommand as h, type ActivityCancellationType as i, type BuiltInQueryName as j, CHILD_CANCELLATION_TYPES as k, COMMAND_EVENTS as l, COMMAND_EVENT_TYPES as m, COMMAND_TYPES as n, CONTINUE_AS_NEW_SUGGESTED_RATIO as o, type CancelTimerCommand as p, type CancelWorkflowCommand as q, type ChildRunOptions as r, type CommandType as s, type CompleteUpdateCommand as t, type CompleteWorkflowCommand as u, type ContinueAsNewCommand as v, EVENT_TYPES as w, EXECUTION_KINDS as x, type ExecutionKind as y, FAIRNESS_KEY_MAX_LENGTH as z };

package/dist/{types-CQKOhPTa.d.cts → types-DGx-b9eq.d.ts}

@@ -1,4 +1,4 @@
-import { a as JsonObject, E as ErrorType, J as Json } from './types-Bb2wRnJ5.cjs';
+import { J as JsonObject, E as ErrorType, a as Json } from './types-V7jEEUaL.js';
 
 /**
  * The durable-function history contract (PLAN-B C-HIST, C-CMD, C-ABI):
@@ -17,10 +17,21 @@ declare const HISTORY_PROTOCOL = 1;
  * The runtime compatibility release of this SDK (the runtime train of
  * PLAN-B19 critique 4.5). R1 is the Phase B core runtime; R2 adds local
  * activities, handler drain, run handles by workflow id and the R2 history
- * fields. A history recorded by release N replays under every release >= N;
- * the service and the workers pin the release whose histories they accept.
+ * fields. Release 3 (Phase C, C-R1) adds updates, custom and default queries,
+ * dynamic workflows, user activities, search attributes, interceptors with
+ * header propagation and sinks. A history recorded by release N replays under
+ * every release >= N; the service and the workers pin the release whose
+ * histories they accept.
  */
-declare const RUNTIME_RELEASE = 2;
+declare const RUNTIME_RELEASE = 3;
+/**
+ * What the runtime of this release can answer (C-ABI-H, reported as
+ * `FluidgridsRuntimeAbi.capabilities`). A bundle built before C-R1 reports no
+ * capabilities, and the service refuses updates and custom queries for it
+ * (DC4) instead of delivering requests the bundle would ignore.
+ */
+declare const RUNTIME_CAPABILITIES: readonly ["updates", "queries", "dynamic"];
+type RuntimeCapability = (typeof RUNTIME_CAPABILITIES)[number];
 /** Every value of the `type` column of `workflow_run_events`, UPPER_SNAKE (DB4). */
 declare const EVENT_TYPES: readonly ["WORKFLOW_STARTED", "WORKFLOW_TASK_SCHEDULED", "WORKFLOW_TASK_STARTED", "WORKFLOW_TASK_COMPLETED", "WORKFLOW_TASK_FAILED", "WORKFLOW_TASK_TIMED_OUT", "ACTIVITY_SCHEDULED", "ACTIVITY_STARTED", "ACTIVITY_HEARTBEAT", "ACTIVITY_COMPLETED", "ACTIVITY_FAILED", "ACTIVITY_TIMED_OUT", "ACTIVITY_CANCEL_REQUESTED", "ACTIVITY_CANCELLED", "ACTIVITY_PAUSED", "ACTIVITY_UNPAUSED", "ACTIVITY_RESET", "ACTIVITY_OPTIONS_UPDATED", "TIMER_STARTED", "TIMER_FIRED", "TIMER_CANCELLED", "SIGNAL_RECEIVED", "UPDATE_ADMITTED", "UPDATE_ACCEPTED", "UPDATE_COMPLETED", "CHILD_RUN_INITIATED", "CHILD_RUN_STARTED", "CHILD_RUN_COMPLETED", "CHILD_RUN_FAILED", "CHILD_RUN_CANCELLED", "CHILD_RUN_TERMINATED", "CHILD_RUN_TIMED_OUT", "EXTERNAL_RUN_CANCEL_REQUESTED", "EXTERNAL_RUN_CANCEL_RESOLVED", "EXTERNAL_RUN_SIGNALED", "SIDE_EFFECT_RECORDED", "LOCAL_ACTIVITY_COMPLETED", "LOCAL_ACTIVITY_FAILED", "SEARCH_ATTRIBUTES_UPSERTED", "CONTEXT_UPSERTED", "MARKER_RECORDED", "WORKFLOW_CANCEL_REQUESTED", "WORKFLOW_RESET", "VERSIONING_OVERRIDE_SET", "WORKFLOW_COMPLETED", "WORKFLOW_FAILED", "WORKFLOW_CANCELLED", "WORKFLOW_TERMINATED", "WORKFLOW_TIMED_OUT", "WORKFLOW_CONTINUED_AS_NEW"];
 type RunEventType = (typeof EVENT_TYPES)[number];
@@ -31,7 +42,11 @@ type CommandType = (typeof COMMAND_TYPES)[number];
 declare const PHASE_B_CORE_COMMANDS: ReadonlySet<CommandType>;
 /** Commands of the Phase B parity releases (defined now, enabled by the service per release). */
 declare const PHASE_B_PARITY_COMMANDS: ReadonlySet<CommandType>;
-/** Commands that are defined but refused in Phase B (`UNSUPPORTED_COMMAND`). */
+/**
+ * Commands of Phase C. They were refused throughout Phase B; from C-R1 the
+ * C-GATE feature set decides (`c.updates`, `c.searchAttributes`), and the
+ * deprecated release levels of `isCommandEnabled` still refuse them.
+ */
 declare const PHASE_C_COMMANDS: ReadonlySet<CommandType>;
 /** Commands that end the run; one may appear, and only last in a batch. */
 declare const TERMINAL_COMMANDS: ReadonlySet<CommandType>;
@@ -165,15 +180,26 @@ interface WorkflowTimeouts {
     runTimeout?: number;
     workflowTaskTimeout?: number;
 }
-interface ScheduleActivityCommand extends CommandBase {
+/** The longest fairness key (11 §2.11). */
+declare const FAIRNESS_KEY_MAX_LENGTH = 255;
+/** The range of a fairness weight (11 §2.11); the default is 1. */
+declare const FAIRNESS_WEIGHT_MIN = 0.1;
+declare const FAIRNESS_WEIGHT_MAX = 10;
+/** The name of a user activity (C-CMD-C). */
+declare const ACTIVITY_NAME_PATTERN = "^[A-Za-z_][A-Za-z0-9_.-]{0,127}$";
+/** The name of a task queue (C-CMD-C); `managed` is the platform's queue. */
+declare const TASK_QUEUE_NAME_PATTERN = "^[a-z0-9][a-z0-9-]{0,62}$";
+/** At most this many connections a user activity may name. */
+declare const MAX_ACTIVITY_CONNECTIONS = 16;
+/** UTF-8 bytes of the JSON of a command's `headers` map, at most. */
+declare const MAX_HEADERS_BYTES: number;
+/** At most this many sink calls one workflow task reports. */
+declare const MAX_SINK_CALLS = 256;
+/** What both kinds of `SCHEDULE_ACTIVITY` carry. */
+interface ScheduleActivityBase extends CommandBase {
     type: 'SCHEDULE_ACTIVITY';
     activityId: string;
-    kind: 'node';
-    nodeType: string;
-    nodeVersion?: string;
-    operation: string;
     args: Json;
-    connection?: string;
     retry: RetryPolicy;
     startToCloseTimeout?: number;
     scheduleToCloseTimeout?: number;
@@ -182,8 +208,34 @@ interface ScheduleActivityCommand extends CommandBase {
     cancellationType?: ActivityCancellationType;
     priority?: number;
     summary?: string;
+    /** Fairness within the queue (11 §2.11, Phase C); default the workspace id. */
+    fairnessKey?: string;
+    /** 0.1 to 10; default 1. */
+    fairnessWeight?: number;
+}
+/** A canvas node operation run as an activity (`ctx.run`). */
+interface ScheduleNodeActivityCommand extends ScheduleActivityBase {
+    kind: 'node';
+    nodeType: string;
+    nodeVersion?: string;
+    operation: string;
+    connection?: string;
     runOn?: string;
 }
+/**
+ * A user activity (`ctx.activity`, Phase C, C-CMD-C): a function a
+ * self-hosted worker polling `taskQueue` implements. It has no node type,
+ * operation or `runOn`.
+ */
+interface ScheduleUserActivityCommand extends ScheduleActivityBase {
+    kind: 'user';
+    activityName: string;
+    taskQueue: string;
+    /** Connection names the worker may resolve per attempt (H2), at most 16. */
+    connections?: string[];
+}
+/** `SCHEDULE_ACTIVITY`, a `oneOf` on `kind` (C-CMD-C). */
+type ScheduleActivityCommand = ScheduleNodeActivityCommand | ScheduleUserActivityCommand;
 interface RequestCancelActivityCommand extends CommandBase {
     type: 'REQUEST_CANCEL_ACTIVITY';
     activityId: string;
@@ -217,6 +269,9 @@ interface ChildRunOptions {
     versioningBehavior?: VersioningBehavior;
     idReusePolicy?: WorkflowIdReusePolicy;
     idConflictPolicy?: WorkflowIdConflictPolicy;
+    /** Fairness of the child's tasks (11 §2.11, Phase C); inherited by default. */
+    fairnessKey?: string;
+    fairnessWeight?: number;
     [key: string]: Json | RunRetryPolicy | undefined;
 }
 interface StartChildRunCommand extends CommandBase {
@@ -362,10 +417,52 @@ interface WorkflowInfoSnapshot {
     versioningBehavior?: VersioningBehavior;
     /** The run-level retry policy of the chain. */
     retry?: RunRetryPolicy;
+    /** The run's search attributes at the start (11 §2.8, Phase C). */
+    searchAttributes?: JsonObject;
+    /** Fairness of the run's tasks (11 §2.11, Phase C). */
+    fairnessKey?: string;
+    fairnessWeight?: number;
 }
-/** A built-in query (11 §2.21). Custom queries are Phase C. */
+/** A built-in query (11 §2.21); any other name is a custom query (Phase C). */
 type BuiltInQueryName = '__stack_trace' | '__enhanced_stack_trace' | '__metadata';
 declare const BUILT_IN_QUERIES: readonly BuiltInQueryName[];
+/**
+ * A pending update the lease delivers to a workflow task (C-ABI-H). The
+ * request is not in history until the task accepts it (`UPDATE_ACCEPTED`);
+ * `admitted` marks one that history already holds as `UPDATE_ADMITTED`
+ * (update-with-start, reset re-application), which the runtime delivers from
+ * that event instead.
+ */
+interface UpdateRequest {
+    updateId: string;
+    name: string;
+    args?: Json;
+    admitted?: boolean;
+    headers?: Headers;
+}
+/** A query a task answers (11 §2.21). Built-in names need no handler. */
+interface QueryRequest {
+    queryId: string;
+    name: string;
+    args?: Json;
+}
+/**
+ * The answer to one query. `rejected` means no handler took the name (the
+ * service answers `VALIDATION`); `error` without `rejected` means the handler
+ * threw or the replay failed.
+ */
+interface QueryResult {
+    queryId: string;
+    value?: Json;
+    error?: string;
+    rejected?: boolean;
+}
+/** One call workflow code made to a worker-side sink (11 §2.31); never on replay. */
+interface SinkCall {
+    sink: string;
+    fn: string;
+    args: Json[];
+}
 /** The input of one workflow task (C-ABI). */
 interface WorkflowTaskRequest {
     protocol: number;
@@ -376,11 +473,19 @@ interface WorkflowTaskRequest {
     /** The task's start time; the clock for new side effects only. */
     nowMs: number;
     localActivityResults?: LocalActivityResult[];
-    queries?: Array<{
-        queryId: string;
-        name: BuiltInQueryName;
-        args?: Json;
-    }>;
+    /** Pending updates the lease delivers (C-ABI-H, Phase C). */
+    updates?: UpdateRequest[];
+    /** Queries to answer once the history is replayed. */
+    queries?: QueryRequest[];
+    /**
+     * The bundle features (C-FEATURES, the names of `code.features`) the
+     * workspace enables for this task, from its flags (Phase C). From C-R1 the
+     * runtime reads `interceptors`: a `task` of a bundle that exports
+     * interceptors fails with `UNSUPPORTED_COMMAND` unless it is listed, so
+     * turning `fluidgrids.run-control` off stops interceptors from running even
+     * for a bundle pushed while it was on. Absent means none.
+     */
+    features?: string[];
 }
 /** The result of one local activity, as the worker passes it back into the task (C-ABI). */
 interface LocalActivityResult {
@@ -436,11 +541,9 @@ interface WorkflowTaskResult {
     outcome: 'commands' | 'failed' | 'localActivityRequested';
     commands: WorkflowCommand[];
     localActivityRequests?: LocalActivityRequest[];
-    queryResults?: Array<{
-        queryId: string;
-        value?: Json;
-        error?: string;
-    }>;
+    queryResults?: QueryResult[];
+    /** Sink calls of the open activation, at most {@link MAX_SINK_CALLS} (Phase C). */
+    sinkCalls?: SinkCall[];
     failure?: {
         cause: WorkflowTaskFailureCause;
         message: string;
@@ -485,4 +588,4 @@ declare function isCommandEvent(event: {
     payload: JsonObject;
 }): boolean;
 
-export { type RunTarget as $, ACTIVITY_CANCELLATION_TYPES as A, BUILT_IN_QUERIES as B, type ChildCancellationType as C, DEFAULT_HISTORY_LIMIT as D, ERROR_TYPES as E, type Failure as F, type LocalActivityResult as G, HISTORY_LIMIT_EXCEEDED_RATIO as H, INPUT_EVENTS as I, PARENT_CLOSE_POLICIES as J, PHASE_B_CORE_COMMANDS as K, LOCAL_ACTIVITY_MAX_TIMEOUT_MS as L, PHASE_B_PARITY_COMMANDS as M, PHASE_C_COMMANDS as N, RUNTIME_RELEASE as O, type ParentClosePolicy as P, type RecordLocalActivityCommand as Q, type RetryPolicy as R, type RecordMarkerCommand as S, type RecordSideEffectCommand as T, type RejectUpdateCommand as U, type RequestCancelActivityCommand as V, type WorkflowCommand as W, type RequestCancelExternalRunCommand as X, type RunEventDraft as Y, type RunEventRecord as Z, type RunEventType as _, type WorkflowTaskFailureCause as a, type ScheduleActivityCommand as a0, type SignalRunCommand as a1, type StartChildRunCommand as a2, type StartTimerCommand as a3, TASK_FAILURE_CAUSES as a4, TERMINAL_COMMANDS as a5, TERMINAL_EVENTS as a6, type TaskLogLine as a7, type UnfinishedHandler as a8, type UpsertContextCommand as a9, type UpsertSearchAttributesCommand as aa, VERSIONING_BEHAVIORS as ab, type VersioningBehavior as ac, WORKFLOW_ID_CONFLICT_POLICIES as ad, WORKFLOW_ID_REUSE_POLICIES as ae, WORKFLOW_TIMEOUT_TYPES as af, type WorkflowIdConflictPolicy as ag, type WorkflowIdReusePolicy as ah, type WorkflowInfoSnapshot as ai, type WorkflowTaskRequest as aj, type WorkflowTaskResult as ak, type WorkflowTimeoutType as al, type WorkflowTimeouts as am, isCommandEvent as an, isInputEvent as ao, type RunRetryPolicy as b, type AcceptUpdateCommand as c, type ActivityCancellationType as d, type BuiltInQueryName as e, CHILD_CANCELLATION_TYPES as f, COMMAND_EVENTS as g, COMMAND_EVENT_TYPES as h, COMMAND_TYPES as i, CONTINUE_AS_NEW_SUGGESTED_RATIO as j, type CancelTimerCommand as k, type CancelWorkflowCommand as l, type ChildRunOptions as m, type CommandType as n, type CompleteUpdateCommand as o, type CompleteWorkflowCommand as p, type ContinueAsNewCommand as q, EVENT_TYPES as r, EXECUTION_KINDS as s, type ExecutionKind as t, type FailWorkflowCommand as u, type FailureSource as v, HISTORY_PROTOCOL as w, type Headers as x, type HistoryLimit as y, type LocalActivityRequest as z };
+export { PARENT_CLOSE_POLICIES as $, ACTIVITY_CANCELLATION_TYPES as A, BUILT_IN_QUERIES as B, type ChildCancellationType as C, DEFAULT_HISTORY_LIMIT as D, ERROR_TYPES as E, type Failure as F, FAIRNESS_WEIGHT_MAX as G, FAIRNESS_WEIGHT_MIN as H, type FailWorkflowCommand as I, type FailureSource as J, HISTORY_LIMIT_EXCEEDED_RATIO as K, HISTORY_PROTOCOL as L, type Headers as M, type HistoryLimit as N, INPUT_EVENTS as O, type ParentClosePolicy as P, type QueryResult as Q, type RunEventRecord as R, LOCAL_ACTIVITY_MAX_TIMEOUT_MS as S, type TaskLogLine as T, type UnfinishedHandler as U, type LocalActivityRequest as V, type WorkflowCommand as W, type LocalActivityResult as X, MAX_ACTIVITY_CONNECTIONS as Y, MAX_HEADERS_BYTES as Z, MAX_SINK_CALLS as _, type WorkflowTaskFailureCause as a, PHASE_B_CORE_COMMANDS as a0, PHASE_B_PARITY_COMMANDS as a1, PHASE_C_COMMANDS as a2, RUNTIME_CAPABILITIES as a3, RUNTIME_RELEASE as a4, type RecordLocalActivityCommand as a5, type RecordMarkerCommand as a6, type RecordSideEffectCommand as a7, type RejectUpdateCommand as a8, type RequestCancelActivityCommand as a9, type WorkflowTaskResult as aA, type WorkflowTimeoutType as aB, type WorkflowTimeouts as aC, isCommandEvent as aD, isInputEvent as aE, type RequestCancelExternalRunCommand as aa, type RunEventDraft as ab, type RunEventType as ac, type RunTarget as ad, type RuntimeCapability as ae, type ScheduleActivityCommand as af, type ScheduleNodeActivityCommand as ag, type ScheduleUserActivityCommand as ah, type SignalRunCommand as ai, type SinkCall as aj, type StartChildRunCommand as ak, type StartTimerCommand as al, TASK_FAILURE_CAUSES as am, TASK_QUEUE_NAME_PATTERN as an, TERMINAL_COMMANDS as ao, TERMINAL_EVENTS as ap, type UpsertContextCommand as aq, type UpsertSearchAttributesCommand as ar, VERSIONING_BEHAVIORS as as, type VersioningBehavior as at, WORKFLOW_ID_CONFLICT_POLICIES as au, WORKFLOW_ID_REUSE_POLICIES as av, WORKFLOW_TIMEOUT_TYPES as aw, type WorkflowIdConflictPolicy as ax, type WorkflowIdReusePolicy as ay, type WorkflowTaskRequest as az, type WorkflowInfoSnapshot as b, type UpdateRequest as c, type QueryRequest as d, type RetryPolicy as e, type RunRetryPolicy as f, ACTIVITY_NAME_PATTERN as g, type AcceptUpdateCommand as h, type ActivityCancellationType as i, type BuiltInQueryName as j, CHILD_CANCELLATION_TYPES as k, COMMAND_EVENTS as l, COMMAND_EVENT_TYPES as m, COMMAND_TYPES as n, CONTINUE_AS_NEW_SUGGESTED_RATIO as o, type CancelTimerCommand as p, type CancelWorkflowCommand as q, type ChildRunOptions as r, type CommandType as s, type CompleteUpdateCommand as t, type CompleteWorkflowCommand as u, type ContinueAsNewCommand as v, EVENT_TYPES as w, EXECUTION_KINDS as x, type ExecutionKind as y, FAIRNESS_KEY_MAX_LENGTH as z };

package/dist/{types-Bb2wRnJ5.d.cts → types-V7jEEUaL.d.cts}

@@ -241,4 +241,4 @@ interface WorkflowDefinition {
     [key: string]: unknown;
 }
 
-export type { CodeBundleActivityExport as C, ErrorType as E, Json as J, LegacyCredentialRef as L, NodeArgs as N, Position as P, RetryConfig as R, WorkflowDefinition as W, JsonObject as a, WorkflowInterface as b, CodeBundleWorkflowExport as c, ConnectionRef as d, ExecutionSettings as e, NodeErrorConfig as f, NodeTimeout as g, RunOnSetting as h, WorkflowAuthoring as i, WorkflowCode as j, WorkflowConfig as k, WorkflowEdge as l, WorkflowNode as m, WorkflowRunRetryConfig as n };
+export type { CodeBundleActivityExport as C, ErrorType as E, JsonObject as J, LegacyCredentialRef as L, NodeArgs as N, Position as P, RetryConfig as R, WorkflowDefinition as W, Json as a, WorkflowInterface as b, CodeBundleWorkflowExport as c, ConnectionRef as d, ExecutionSettings as e, NodeErrorConfig as f, NodeTimeout as g, RunOnSetting as h, WorkflowAuthoring as i, WorkflowCode as j, WorkflowConfig as k, WorkflowEdge as l, WorkflowNode as m, WorkflowRunRetryConfig as n };

package/dist/{types-Bb2wRnJ5.d.ts → types-V7jEEUaL.d.ts}

@@ -241,4 +241,4 @@ interface WorkflowDefinition {
     [key: string]: unknown;
 }
 
-export type { CodeBundleActivityExport as C, ErrorType as E, Json as J, LegacyCredentialRef as L, NodeArgs as N, Position as P, RetryConfig as R, WorkflowDefinition as W, JsonObject as a, WorkflowInterface as b, CodeBundleWorkflowExport as c, ConnectionRef as d, ExecutionSettings as e, NodeErrorConfig as f, NodeTimeout as g, RunOnSetting as h, WorkflowAuthoring as i, WorkflowCode as j, WorkflowConfig as k, WorkflowEdge as l, WorkflowNode as m, WorkflowRunRetryConfig as n };
+export type { CodeBundleActivityExport as C, ErrorType as E, JsonObject as J, LegacyCredentialRef as L, NodeArgs as N, Position as P, RetryConfig as R, WorkflowDefinition as W, Json as a, WorkflowInterface as b, CodeBundleWorkflowExport as c, ConnectionRef as d, ExecutionSettings as e, NodeErrorConfig as f, NodeTimeout as g, RunOnSetting as h, WorkflowAuthoring as i, WorkflowCode as j, WorkflowConfig as k, WorkflowEdge as l, WorkflowNode as m, WorkflowRunRetryConfig as n };

package/dist/{workflow-8uRU9rhL.d.ts → workflow-B18OeF7g.d.ts}

@@ -1,5 +1,5 @@
-import { J as Json, a as JsonObject, d as ConnectionRef, L as LegacyCredentialRef, R as RetryConfig, g as NodeTimeout, f as NodeErrorConfig, e as ExecutionSettings, m as WorkflowNode, l as WorkflowEdge, k as WorkflowConfig, b as WorkflowInterface, j as WorkflowCode } from './types-Bb2wRnJ5.js';
-import { h as DurableWorkflow, O as Operation } from './workflow-DWTPHFbt.js';
+import { a as Json, J as JsonObject, d as ConnectionRef, L as LegacyCredentialRef, R as RetryConfig, g as NodeTimeout, f as NodeErrorConfig, e as ExecutionSettings, m as WorkflowNode, l as WorkflowEdge, k as WorkflowConfig, b as WorkflowInterface, j as WorkflowCode } from './types-V7jEEUaL.js';
+import { v as DurableWorkflow, O as Operation } from './workflow-BGnv8SS6.js';
 
 /**
  * Typed references and predicates for the tier-1 builder (spec 02 §3).