@fluidgrids/workflows 2026.1028.2 → 2026.1029.1

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

@@ -147,6 +147,12 @@ interface WorkflowInterface {
 interface CodeBundleWorkflowExport {
     interface?: WorkflowInterface;
     taskQueue?: string;
+    /**
+     * The run-level settings of the function's `workflow()` declaration (R2,
+     * C-FEATURES): what the service applies to a run of this `workflowFn`,
+     * including a same-bundle child that runs on its parent's definition.
+     */
+    config?: WorkflowConfig;
     [key: string]: unknown;
 }
 /** A user activity declared by a code bundle. */
@@ -173,6 +179,8 @@ interface WorkflowCode {
         };
     };
     determinism?: 'isolate' | 'worker';
+    /** Runtime features the bundle uses (C-FEATURES, SDK R2); absent before R2. */
+    features?: string[];
     [key: string]: unknown;
 }
 /** How a document was produced (spec 01 §6). Never affects execution. */
@@ -198,6 +206,17 @@ interface WorkflowConfig {
     /** Workflow-task budget in seconds or a duration string (v2). */
     workflowTaskTimeout?: number | string;
     versioningBehavior?: 'PINNED' | 'AUTO_UPGRADE';
+    /** Run-level retry of DURABLE_FN runs (v2); delays are seconds or duration strings. */
+    retry?: WorkflowRunRetryConfig;
+    [key: string]: unknown;
+}
+/** `config.retry` (11 §2.17). */
+interface WorkflowRunRetryConfig {
+    maxAttempts?: number;
+    initialDelay?: number | string;
+    backoffMultiplier?: number;
+    maxDelay?: number | string;
+    nonRetryableErrorTypes?: string[];
     [key: string]: unknown;
 }
 /** The canonical workflow definition (`definitionJson`). */
@@ -222,4 +241,4 @@ interface WorkflowDefinition {
     [key: string]: unknown;
 }
 
-export type { CodeBundleActivityExport as C, ErrorType as E, JsonObject as J, LegacyCredentialRef as L, NodeArgs as N, Position as P, RetryConfig as R, WorkflowInterface as W, Json as a, WorkflowDefinition 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 };
+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 };

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

@@ -147,6 +147,12 @@ interface WorkflowInterface {
 interface CodeBundleWorkflowExport {
     interface?: WorkflowInterface;
     taskQueue?: string;
+    /**
+     * The run-level settings of the function's `workflow()` declaration (R2,
+     * C-FEATURES): what the service applies to a run of this `workflowFn`,
+     * including a same-bundle child that runs on its parent's definition.
+     */
+    config?: WorkflowConfig;
     [key: string]: unknown;
 }
 /** A user activity declared by a code bundle. */
@@ -173,6 +179,8 @@ interface WorkflowCode {
         };
     };
     determinism?: 'isolate' | 'worker';
+    /** Runtime features the bundle uses (C-FEATURES, SDK R2); absent before R2. */
+    features?: string[];
     [key: string]: unknown;
 }
 /** How a document was produced (spec 01 §6). Never affects execution. */
@@ -198,6 +206,17 @@ interface WorkflowConfig {
     /** Workflow-task budget in seconds or a duration string (v2). */
     workflowTaskTimeout?: number | string;
     versioningBehavior?: 'PINNED' | 'AUTO_UPGRADE';
+    /** Run-level retry of DURABLE_FN runs (v2); delays are seconds or duration strings. */
+    retry?: WorkflowRunRetryConfig;
+    [key: string]: unknown;
+}
+/** `config.retry` (11 §2.17). */
+interface WorkflowRunRetryConfig {
+    maxAttempts?: number;
+    initialDelay?: number | string;
+    backoffMultiplier?: number;
+    maxDelay?: number | string;
+    nonRetryableErrorTypes?: string[];
     [key: string]: unknown;
 }
 /** The canonical workflow definition (`definitionJson`). */
@@ -222,4 +241,4 @@ interface WorkflowDefinition {
     [key: string]: unknown;
 }
 
-export type { CodeBundleActivityExport as C, ErrorType as E, JsonObject as J, LegacyCredentialRef as L, NodeArgs as N, Position as P, RetryConfig as R, WorkflowInterface as W, Json as a, WorkflowDefinition 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 };
+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 };

package/dist/{types-DV-HX_Gt.d.ts → types-CQKOhPTa.d.cts}

@@ -1,4 +1,4 @@
-import { J as JsonObject, E as ErrorType, a as Json } from './types-BGoPzgcl.js';
+import { a as JsonObject, E as ErrorType, J as Json } from './types-Bb2wRnJ5.cjs';
 
 /**
  * The durable-function history contract (PLAN-B C-HIST, C-CMD, C-ABI):
@@ -13,6 +13,14 @@ import { J as JsonObject, E as ErrorType, a as Json } from './types-BGoPzgcl.js'
 
 /** Version of the runtime ABI and of the history file format. */
 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.
+ */
+declare const RUNTIME_RELEASE = 2;
 /** 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];
@@ -106,7 +114,11 @@ type Headers = Record<string, string>;
 interface CommandBase {
     headers?: Headers;
 }
-/** Signal and cancel targets. `workflowKey`/`workflowId` addressing is parity (11 §2.1). */
+/**
+ * Signal and cancel targets. `workflowKey`/`workflowId` addressing is parity
+ * (11 §2.1): it reaches the open run of that business id, following the
+ * continue-as-new chain; `firstRunId` pins the chain whose first run it names.
+ */
 type RunTarget = {
     runId: string;
 } | {
@@ -116,7 +128,43 @@ type RunTarget = {
 } | {
     workflowKey: string;
     workflowId: string;
+    firstRunId?: string;
 };
+/** `idReusePolicy` of a start (11 §2.1): what a closed run with the same workflow id allows. */
+declare const WORKFLOW_ID_REUSE_POLICIES: readonly ["ALLOW_DUPLICATE", "ALLOW_DUPLICATE_FAILED_ONLY", "REJECT_DUPLICATE"];
+type WorkflowIdReusePolicy = (typeof WORKFLOW_ID_REUSE_POLICIES)[number];
+/** `idConflictPolicy` of a start (11 §2.1): what an open run with the same workflow id does. */
+declare const WORKFLOW_ID_CONFLICT_POLICIES: readonly ["FAIL", "USE_EXISTING", "TERMINATE_EXISTING"];
+type WorkflowIdConflictPolicy = (typeof WORKFLOW_ID_CONFLICT_POLICIES)[number];
+/** `versioningBehavior` of a version or a run (11 §2.27). */
+declare const VERSIONING_BEHAVIORS: readonly ["PINNED", "AUTO_UPGRADE"];
+type VersioningBehavior = (typeof VERSIONING_BEHAVIORS)[number];
+/** `timeoutType` of `WORKFLOW_TIMED_OUT` and `CHILD_RUN_TIMED_OUT` (11 §2.20). */
+declare const WORKFLOW_TIMEOUT_TYPES: readonly ["WORKFLOW_RUN", "WORKFLOW_EXECUTION"];
+type WorkflowTimeoutType = (typeof WORKFLOW_TIMEOUT_TYPES)[number];
+/**
+ * The run-level retry policy of a DURABLE_FN run (11 §2.17), in milliseconds.
+ * A run that fails with a retryable failure, or whose run timeout expires,
+ * is started again as a new run of the same chain, up to `maxAttempts`
+ * attempts in total (absent: unlimited, bounded by the execution timeout).
+ */
+interface RunRetryPolicy {
+    maxAttempts?: number;
+    /** Delay before the second attempt. */
+    initialDelayMs: number;
+    backoffMultiplier?: number;
+    maxDelayMs?: number;
+    /** Allow-list on `errorType`. */
+    retryOnErrorTypes?: ErrorType[];
+    /** Deny-list on the free-form `Failure.type`; wins over the allow-list. */
+    nonRetryableErrorTypes?: string[];
+}
+/** The three workflow timeouts of a run (11 §2.20), in milliseconds. */
+interface WorkflowTimeouts {
+    executionTimeout?: number;
+    runTimeout?: number;
+    workflowTaskTimeout?: number;
+}
 interface ScheduleActivityCommand extends CommandBase {
     type: 'SCHEDULE_ACTIVITY';
     activityId: string;
@@ -164,7 +212,12 @@ interface ChildRunOptions {
     runTimeout?: number;
     workflowTaskTimeout?: number;
     startDelay?: number;
-    [key: string]: Json | undefined;
+    /** Run-level retry of the child (11 §2.17). */
+    retry?: RunRetryPolicy;
+    versioningBehavior?: VersioningBehavior;
+    idReusePolicy?: WorkflowIdReusePolicy;
+    idConflictPolicy?: WorkflowIdConflictPolicy;
+    [key: string]: Json | RunRetryPolicy | undefined;
 }
 interface StartChildRunCommand extends CommandBase {
     type: 'START_CHILD_RUN';
@@ -216,6 +269,10 @@ interface RecordLocalActivityCommand extends CommandBase {
     result?: Json;
     failure?: Failure;
     attempts: number;
+    /** The node operation that ran (R2), for the History tab and replay matching. */
+    nodeType?: string;
+    operation?: string;
+    summary?: string;
 }
 interface ContinueAsNewCommand extends CommandBase {
     type: 'CONTINUE_AS_NEW';
@@ -258,15 +315,28 @@ declare const DEFAULT_HISTORY_LIMIT: HistoryLimit;
 declare const CONTINUE_AS_NEW_SUGGESTED_RATIO = 0.8;
 /** Fraction of the cap at which the next command throws `HistoryLimitExceeded`. */
 declare const HISTORY_LIMIT_EXCEEDED_RATIO = 0.95;
-/** What a task knows about its run (C-ABI `WorkflowInfoSnapshot`). */
+/**
+ * What a task knows about its run (C-ABI `WorkflowInfoSnapshot`). From SDK R2
+ * the runtime reads `workflowId`, `runAttempt`, `lastResult`, `lastFailure`,
+ * `summary`, `details`, the memo (`context`), the timeouts, `retry`,
+ * `priority` and `versioningBehavior` from `WORKFLOW_STARTED` when the event
+ * carries them, so a replay sees what the first execution saw; the lease
+ * values here are the fallback for histories written before R2.
+ */
 interface WorkflowInfoSnapshot {
     runId: string;
     workspaceId: string;
     workflowKey?: string;
     version?: number | string;
     buildId?: string;
+    /** The column name of the workflow id (11 §2.1). */
     businessId?: string;
+    /** The caller-chosen workflow id (`businessId`), else the first run's id. */
+    workflowId?: string;
+    /** Run-level retry attempt, 1-based (same value as `runAttempt`). */
     attempt?: number;
+    /** Run-level retry attempt, 1-based (11 §2.17). */
+    runAttempt?: number;
     taskQueue?: string;
     parentRunId?: string | null;
     rootRunId?: string | null;
@@ -286,7 +356,12 @@ interface WorkflowInfoSnapshot {
     priority?: number;
     summary?: string;
     details?: string;
+    /** The run's memo (11 §2.22); `memo` is the same value under its Temporal name. */
     context?: JsonObject;
+    memo?: JsonObject;
+    versioningBehavior?: VersioningBehavior;
+    /** The run-level retry policy of the chain. */
+    retry?: RunRetryPolicy;
 }
 /** A built-in query (11 §2.21). Custom queries are Phase C. */
 type BuiltInQueryName = '__stack_trace' | '__enhanced_stack_trace' | '__metadata';
@@ -300,27 +375,55 @@ interface WorkflowTaskRequest {
     history: RunEventRecord[];
     /** The task's start time; the clock for new side effects only. */
     nowMs: number;
-    localActivityResults?: Array<{
-        localActivityId: string;
-        result?: Json;
-        failure?: Failure;
-        attempts: number;
-    }>;
+    localActivityResults?: LocalActivityResult[];
     queries?: Array<{
         queryId: string;
         name: BuiltInQueryName;
         args?: Json;
     }>;
 }
-/** A local activity the task wants run before it can continue (parity). */
+/** The result of one local activity, as the worker passes it back into the task (C-ABI). */
+interface LocalActivityResult {
+    localActivityId: string;
+    result?: Json;
+    failure?: Failure;
+    /** Attempts run so far, the last one included. */
+    attempts: number;
+}
+/** The largest `startToCloseTimeout` of a local activity, and its default (11 §2.12). */
+declare const LOCAL_ACTIVITY_MAX_TIMEOUT_MS = 30000;
+/**
+ * A local activity the task wants run before it can continue (parity, 11
+ * §2.12). The worker runs attempt `attempt` (after waiting `backoffMs` when
+ * it is a retry) inside the task's budget, then runs the same task again with
+ * the outcome in `localActivityResults`. The runtime decides with
+ * `computeRetryDelay` whether a failure is final; a retryable one is
+ * requested again with the next attempt. A worker that cannot fit the wait
+ * and the attempt into the remaining budget answers with a non-retryable
+ * `TIMEOUT` failure of type `LocalActivityBudgetExceeded` instead.
+ */
 interface LocalActivityRequest {
     localActivityId: string;
+    kind: 'node';
     nodeType: string;
+    nodeVersion?: string;
     operation: string;
     args: Json;
     connection?: string;
-    retry?: RetryPolicy;
-    startToCloseTimeout?: number;
+    retry: RetryPolicy;
+    /** Milliseconds; at most {@link LOCAL_ACTIVITY_MAX_TIMEOUT_MS}. */
+    startToCloseTimeout: number;
+    /** The attempt to run, 1-based. */
+    attempt: number;
+    /** Milliseconds to wait before this attempt (0 for the first). */
+    backoffMs: number;
+    summary?: string;
+}
+/** Signal or update handlers still running when the workflow finished (11 §2.18). */
+interface UnfinishedHandler {
+    kind: 'signal' | 'update';
+    name: string;
+    count: number;
 }
 interface TaskLogLine {
     level: 'debug' | 'info' | 'warn' | 'error';
@@ -347,6 +450,11 @@ interface WorkflowTaskResult {
     };
     logs: TaskLogLine[];
     stackTrace?: string;
+    /**
+     * Handlers still running when this task's terminal command was issued, with
+     * policy `WARN_AND_ABANDON` (R2). Never set on replay.
+     */
+    unfinishedHandlers?: UnfinishedHandler[];
 }
 /**
  * The event each command appends (C-CMD). `REJECT_UPDATE` appends nothing: a
@@ -377,4 +485,4 @@ declare function isCommandEvent(event: {
     payload: JsonObject;
 }): boolean;
 
-export { type StartTimerCommand 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, PHASE_B_PARITY_COMMANDS as G, HISTORY_LIMIT_EXCEEDED_RATIO as H, INPUT_EVENTS as I, PHASE_C_COMMANDS as J, type RecordLocalActivityCommand as K, type LocalActivityRequest as L, type RecordMarkerCommand as M, type RecordSideEffectCommand as N, type RejectUpdateCommand as O, type ParentClosePolicy as P, type RequestCancelActivityCommand as Q, type RetryPolicy as R, type RequestCancelExternalRunCommand as S, type RunEventDraft as T, type RunEventRecord as U, type RunEventType as V, type WorkflowCommand as W, type RunTarget as X, type ScheduleActivityCommand as Y, type SignalRunCommand as Z, type StartChildRunCommand as _, type WorkflowTaskFailureCause as a, TASK_FAILURE_CAUSES as a0, TERMINAL_COMMANDS as a1, TERMINAL_EVENTS as a2, type TaskLogLine as a3, type UpsertContextCommand as a4, type UpsertSearchAttributesCommand as a5, type WorkflowInfoSnapshot as a6, type WorkflowTaskRequest as a7, type WorkflowTaskResult as a8, isCommandEvent as a9, isInputEvent as aa, type AcceptUpdateCommand as b, type ActivityCancellationType as c, type BuiltInQueryName as d, CHILD_CANCELLATION_TYPES as e, COMMAND_EVENTS as f, COMMAND_EVENT_TYPES as g, COMMAND_TYPES as h, CONTINUE_AS_NEW_SUGGESTED_RATIO as i, type CancelTimerCommand as j, type CancelWorkflowCommand as k, type ChildRunOptions as l, type CommandType as m, type CompleteUpdateCommand as n, type CompleteWorkflowCommand as o, type ContinueAsNewCommand as p, EVENT_TYPES as q, EXECUTION_KINDS as r, type ExecutionKind as s, type FailWorkflowCommand as t, type FailureSource as u, HISTORY_PROTOCOL as v, type Headers as w, type HistoryLimit as x, PARENT_CLOSE_POLICIES as y, PHASE_B_CORE_COMMANDS as z };
+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 };

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

@@ -1,4 +1,4 @@
-import { J as JsonObject, E as ErrorType, a as Json } from './types-BGoPzgcl.cjs';
+import { a as JsonObject, E as ErrorType, J as Json } from './types-Bb2wRnJ5.js';
 
 /**
  * The durable-function history contract (PLAN-B C-HIST, C-CMD, C-ABI):
@@ -13,6 +13,14 @@ import { J as JsonObject, E as ErrorType, a as Json } from './types-BGoPzgcl.cjs
 
 /** Version of the runtime ABI and of the history file format. */
 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.
+ */
+declare const RUNTIME_RELEASE = 2;
 /** 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];
@@ -106,7 +114,11 @@ type Headers = Record<string, string>;
 interface CommandBase {
     headers?: Headers;
 }
-/** Signal and cancel targets. `workflowKey`/`workflowId` addressing is parity (11 §2.1). */
+/**
+ * Signal and cancel targets. `workflowKey`/`workflowId` addressing is parity
+ * (11 §2.1): it reaches the open run of that business id, following the
+ * continue-as-new chain; `firstRunId` pins the chain whose first run it names.
+ */
 type RunTarget = {
     runId: string;
 } | {
@@ -116,7 +128,43 @@ type RunTarget = {
 } | {
     workflowKey: string;
     workflowId: string;
+    firstRunId?: string;
 };
+/** `idReusePolicy` of a start (11 §2.1): what a closed run with the same workflow id allows. */
+declare const WORKFLOW_ID_REUSE_POLICIES: readonly ["ALLOW_DUPLICATE", "ALLOW_DUPLICATE_FAILED_ONLY", "REJECT_DUPLICATE"];
+type WorkflowIdReusePolicy = (typeof WORKFLOW_ID_REUSE_POLICIES)[number];
+/** `idConflictPolicy` of a start (11 §2.1): what an open run with the same workflow id does. */
+declare const WORKFLOW_ID_CONFLICT_POLICIES: readonly ["FAIL", "USE_EXISTING", "TERMINATE_EXISTING"];
+type WorkflowIdConflictPolicy = (typeof WORKFLOW_ID_CONFLICT_POLICIES)[number];
+/** `versioningBehavior` of a version or a run (11 §2.27). */
+declare const VERSIONING_BEHAVIORS: readonly ["PINNED", "AUTO_UPGRADE"];
+type VersioningBehavior = (typeof VERSIONING_BEHAVIORS)[number];
+/** `timeoutType` of `WORKFLOW_TIMED_OUT` and `CHILD_RUN_TIMED_OUT` (11 §2.20). */
+declare const WORKFLOW_TIMEOUT_TYPES: readonly ["WORKFLOW_RUN", "WORKFLOW_EXECUTION"];
+type WorkflowTimeoutType = (typeof WORKFLOW_TIMEOUT_TYPES)[number];
+/**
+ * The run-level retry policy of a DURABLE_FN run (11 §2.17), in milliseconds.
+ * A run that fails with a retryable failure, or whose run timeout expires,
+ * is started again as a new run of the same chain, up to `maxAttempts`
+ * attempts in total (absent: unlimited, bounded by the execution timeout).
+ */
+interface RunRetryPolicy {
+    maxAttempts?: number;
+    /** Delay before the second attempt. */
+    initialDelayMs: number;
+    backoffMultiplier?: number;
+    maxDelayMs?: number;
+    /** Allow-list on `errorType`. */
+    retryOnErrorTypes?: ErrorType[];
+    /** Deny-list on the free-form `Failure.type`; wins over the allow-list. */
+    nonRetryableErrorTypes?: string[];
+}
+/** The three workflow timeouts of a run (11 §2.20), in milliseconds. */
+interface WorkflowTimeouts {
+    executionTimeout?: number;
+    runTimeout?: number;
+    workflowTaskTimeout?: number;
+}
 interface ScheduleActivityCommand extends CommandBase {
     type: 'SCHEDULE_ACTIVITY';
     activityId: string;
@@ -164,7 +212,12 @@ interface ChildRunOptions {
     runTimeout?: number;
     workflowTaskTimeout?: number;
     startDelay?: number;
-    [key: string]: Json | undefined;
+    /** Run-level retry of the child (11 §2.17). */
+    retry?: RunRetryPolicy;
+    versioningBehavior?: VersioningBehavior;
+    idReusePolicy?: WorkflowIdReusePolicy;
+    idConflictPolicy?: WorkflowIdConflictPolicy;
+    [key: string]: Json | RunRetryPolicy | undefined;
 }
 interface StartChildRunCommand extends CommandBase {
     type: 'START_CHILD_RUN';
@@ -216,6 +269,10 @@ interface RecordLocalActivityCommand extends CommandBase {
     result?: Json;
     failure?: Failure;
     attempts: number;
+    /** The node operation that ran (R2), for the History tab and replay matching. */
+    nodeType?: string;
+    operation?: string;
+    summary?: string;
 }
 interface ContinueAsNewCommand extends CommandBase {
     type: 'CONTINUE_AS_NEW';
@@ -258,15 +315,28 @@ declare const DEFAULT_HISTORY_LIMIT: HistoryLimit;
 declare const CONTINUE_AS_NEW_SUGGESTED_RATIO = 0.8;
 /** Fraction of the cap at which the next command throws `HistoryLimitExceeded`. */
 declare const HISTORY_LIMIT_EXCEEDED_RATIO = 0.95;
-/** What a task knows about its run (C-ABI `WorkflowInfoSnapshot`). */
+/**
+ * What a task knows about its run (C-ABI `WorkflowInfoSnapshot`). From SDK R2
+ * the runtime reads `workflowId`, `runAttempt`, `lastResult`, `lastFailure`,
+ * `summary`, `details`, the memo (`context`), the timeouts, `retry`,
+ * `priority` and `versioningBehavior` from `WORKFLOW_STARTED` when the event
+ * carries them, so a replay sees what the first execution saw; the lease
+ * values here are the fallback for histories written before R2.
+ */
 interface WorkflowInfoSnapshot {
     runId: string;
     workspaceId: string;
     workflowKey?: string;
     version?: number | string;
     buildId?: string;
+    /** The column name of the workflow id (11 §2.1). */
     businessId?: string;
+    /** The caller-chosen workflow id (`businessId`), else the first run's id. */
+    workflowId?: string;
+    /** Run-level retry attempt, 1-based (same value as `runAttempt`). */
     attempt?: number;
+    /** Run-level retry attempt, 1-based (11 §2.17). */
+    runAttempt?: number;
     taskQueue?: string;
     parentRunId?: string | null;
     rootRunId?: string | null;
@@ -286,7 +356,12 @@ interface WorkflowInfoSnapshot {
     priority?: number;
     summary?: string;
     details?: string;
+    /** The run's memo (11 §2.22); `memo` is the same value under its Temporal name. */
     context?: JsonObject;
+    memo?: JsonObject;
+    versioningBehavior?: VersioningBehavior;
+    /** The run-level retry policy of the chain. */
+    retry?: RunRetryPolicy;
 }
 /** A built-in query (11 §2.21). Custom queries are Phase C. */
 type BuiltInQueryName = '__stack_trace' | '__enhanced_stack_trace' | '__metadata';
@@ -300,27 +375,55 @@ interface WorkflowTaskRequest {
     history: RunEventRecord[];
     /** The task's start time; the clock for new side effects only. */
     nowMs: number;
-    localActivityResults?: Array<{
-        localActivityId: string;
-        result?: Json;
-        failure?: Failure;
-        attempts: number;
-    }>;
+    localActivityResults?: LocalActivityResult[];
     queries?: Array<{
         queryId: string;
         name: BuiltInQueryName;
         args?: Json;
     }>;
 }
-/** A local activity the task wants run before it can continue (parity). */
+/** The result of one local activity, as the worker passes it back into the task (C-ABI). */
+interface LocalActivityResult {
+    localActivityId: string;
+    result?: Json;
+    failure?: Failure;
+    /** Attempts run so far, the last one included. */
+    attempts: number;
+}
+/** The largest `startToCloseTimeout` of a local activity, and its default (11 §2.12). */
+declare const LOCAL_ACTIVITY_MAX_TIMEOUT_MS = 30000;
+/**
+ * A local activity the task wants run before it can continue (parity, 11
+ * §2.12). The worker runs attempt `attempt` (after waiting `backoffMs` when
+ * it is a retry) inside the task's budget, then runs the same task again with
+ * the outcome in `localActivityResults`. The runtime decides with
+ * `computeRetryDelay` whether a failure is final; a retryable one is
+ * requested again with the next attempt. A worker that cannot fit the wait
+ * and the attempt into the remaining budget answers with a non-retryable
+ * `TIMEOUT` failure of type `LocalActivityBudgetExceeded` instead.
+ */
 interface LocalActivityRequest {
     localActivityId: string;
+    kind: 'node';
     nodeType: string;
+    nodeVersion?: string;
     operation: string;
     args: Json;
     connection?: string;
-    retry?: RetryPolicy;
-    startToCloseTimeout?: number;
+    retry: RetryPolicy;
+    /** Milliseconds; at most {@link LOCAL_ACTIVITY_MAX_TIMEOUT_MS}. */
+    startToCloseTimeout: number;
+    /** The attempt to run, 1-based. */
+    attempt: number;
+    /** Milliseconds to wait before this attempt (0 for the first). */
+    backoffMs: number;
+    summary?: string;
+}
+/** Signal or update handlers still running when the workflow finished (11 §2.18). */
+interface UnfinishedHandler {
+    kind: 'signal' | 'update';
+    name: string;
+    count: number;
 }
 interface TaskLogLine {
     level: 'debug' | 'info' | 'warn' | 'error';
@@ -347,6 +450,11 @@ interface WorkflowTaskResult {
     };
     logs: TaskLogLine[];
     stackTrace?: string;
+    /**
+     * Handlers still running when this task's terminal command was issued, with
+     * policy `WARN_AND_ABANDON` (R2). Never set on replay.
+     */
+    unfinishedHandlers?: UnfinishedHandler[];
 }
 /**
  * The event each command appends (C-CMD). `REJECT_UPDATE` appends nothing: a
@@ -377,4 +485,4 @@ declare function isCommandEvent(event: {
     payload: JsonObject;
 }): boolean;
 
-export { type StartTimerCommand 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, PHASE_B_PARITY_COMMANDS as G, HISTORY_LIMIT_EXCEEDED_RATIO as H, INPUT_EVENTS as I, PHASE_C_COMMANDS as J, type RecordLocalActivityCommand as K, type LocalActivityRequest as L, type RecordMarkerCommand as M, type RecordSideEffectCommand as N, type RejectUpdateCommand as O, type ParentClosePolicy as P, type RequestCancelActivityCommand as Q, type RetryPolicy as R, type RequestCancelExternalRunCommand as S, type RunEventDraft as T, type RunEventRecord as U, type RunEventType as V, type WorkflowCommand as W, type RunTarget as X, type ScheduleActivityCommand as Y, type SignalRunCommand as Z, type StartChildRunCommand as _, type WorkflowTaskFailureCause as a, TASK_FAILURE_CAUSES as a0, TERMINAL_COMMANDS as a1, TERMINAL_EVENTS as a2, type TaskLogLine as a3, type UpsertContextCommand as a4, type UpsertSearchAttributesCommand as a5, type WorkflowInfoSnapshot as a6, type WorkflowTaskRequest as a7, type WorkflowTaskResult as a8, isCommandEvent as a9, isInputEvent as aa, type AcceptUpdateCommand as b, type ActivityCancellationType as c, type BuiltInQueryName as d, CHILD_CANCELLATION_TYPES as e, COMMAND_EVENTS as f, COMMAND_EVENT_TYPES as g, COMMAND_TYPES as h, CONTINUE_AS_NEW_SUGGESTED_RATIO as i, type CancelTimerCommand as j, type CancelWorkflowCommand as k, type ChildRunOptions as l, type CommandType as m, type CompleteUpdateCommand as n, type CompleteWorkflowCommand as o, type ContinueAsNewCommand as p, EVENT_TYPES as q, EXECUTION_KINDS as r, type ExecutionKind as s, type FailWorkflowCommand as t, type FailureSource as u, HISTORY_PROTOCOL as v, type Headers as w, type HistoryLimit as x, PARENT_CLOSE_POLICIES as y, PHASE_B_CORE_COMMANDS as z };
+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 };

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

@@ -1,5 +1,5 @@
-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, W as WorkflowInterface, j as WorkflowCode } from './types-BGoPzgcl.js';
-import { h as DurableWorkflow, O as Operation } from './workflow-C2a05WUJ.js';
+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';
 
 /**
  * Typed references and predicates for the tier-1 builder (spec 02 §3).

package/dist/{workflow-FXUkpIBc.d.cts → workflow-CZOXUlQ5.d.cts}

@@ -1,5 +1,5 @@
-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, W as WorkflowInterface, j as WorkflowCode } from './types-BGoPzgcl.cjs';
-import { h as DurableWorkflow, O as Operation } from './workflow-J-yYixny.cjs';
+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.cjs';
+import { h as DurableWorkflow, O as Operation } from './workflow-O6e64ZcG.cjs';
 
 /**
  * Typed references and predicates for the tier-1 builder (spec 02 §3).