@fluidgrids/workflows 2026.1028.2 → 2026.1029.1

package/dist/{workflow-C2a05WUJ.d.ts → workflow-DWTPHFbt.d.ts}

@@ -1,5 +1,5 @@
-import { a as Json, J as JsonObject, W as WorkflowInterface } from './types-BGoPzgcl.js';
-import { a6 as WorkflowInfoSnapshot, R as RetryPolicy, c as ActivityCancellationType, w as Headers, P as ParentClosePolicy, C as ChildCancellationType } from './types-DV-HX_Gt.js';
+import { J as Json, a as JsonObject, b as WorkflowInterface } from './types-Bb2wRnJ5.js';
+import { ai as WorkflowInfoSnapshot, R as RetryPolicy, d as ActivityCancellationType, x as Headers, P as ParentClosePolicy, C as ChildCancellationType, ac as VersioningBehavior, ah as WorkflowIdReusePolicy, ag as WorkflowIdConflictPolicy, b as RunRetryPolicy } from './types-CnIOinoz.js';
 
 /**
  * Node operation descriptors: what a builder call needs to know about the node
@@ -205,6 +205,57 @@ interface RunOptions<In> {
     nodeVersion?: string;
     headers?: Headers;
 }
+/** Options of `ctx.localActivity` (11 §2.12). */
+interface LocalActivityOptions<In> {
+    args: In;
+    /** Connection name, resolved by the worker that runs the task. */
+    connection?: string;
+    /** Default: 1 s, x2, at most 100 s, unlimited attempts, bounded by the task's 30 s budget. */
+    retry?: Partial<RetryPolicy>;
+    /** At most 30 s (the default). */
+    startToCloseTimeout?: Duration;
+    /** Label in the History tab (at most 200 characters). */
+    summary?: string;
+    /** Overrides the operation name the descriptor carries. */
+    operation?: string;
+    /** Overrides the node version the descriptor carries. */
+    nodeVersion?: string;
+}
+/**
+ * Run-level retry of a workflow (11 §2.17): a run that fails with a retryable
+ * failure, or whose run timeout expires, starts again as a new run of the same
+ * chain with `ctx.info.attempt + 1` and `ctx.info.lastFailure`.
+ */
+interface WorkflowRetryOptions {
+    /** Attempts in total, the first one included; absent means unlimited (bounded by the execution timeout). */
+    maxAttempts?: number;
+    /** Delay before the second attempt; default 1 s. */
+    initialDelay?: Duration;
+    /** Default 2. */
+    backoffMultiplier?: number;
+    /** Largest delay; default 100 s, or 100 times `initialDelay` when that is given. */
+    maxDelay?: Duration;
+    /** Free-form failure types that are never retried. */
+    nonRetryableErrorTypes?: string[];
+}
+/** A run addressed by its workflow id (11 §2.1): the open run of the chain. */
+interface WorkflowIdTarget {
+    workflowKey: string;
+    workflowId: string;
+    /** Pins the chain whose first run this is. */
+    firstRunId?: string;
+}
+/** Another run of the workspace: a run id or a workflow id. */
+type ExternalRunTarget = string | {
+    runId: string;
+} | WorkflowIdTarget;
+/** What happens to a handler still running when the workflow finishes (11 §2.18). */
+type HandlerUnfinishedPolicy = 'WARN_AND_ABANDON' | 'ABANDON';
+/** Options of `ctx.onSignal`. */
+interface SignalHandlerOptions {
+    /** Default `WARN_AND_ABANDON`: a warning when the workflow finishes while this handler runs. */
+    unfinishedPolicy?: HandlerUnfinishedPolicy;
+}
 /** Options of `ctx.child` and `ctx.startChild` (11 §2.35). */
 interface ChildOptions {
     input?: unknown;
@@ -229,6 +280,11 @@ interface ChildOptions {
     executionTimeout?: Duration;
     runTimeout?: Duration;
     workflowTaskTimeout?: Duration;
+    /** Run-level retry of the child. */
+    retry?: WorkflowRetryOptions;
+    versioningBehavior?: VersioningBehavior;
+    idReusePolicy?: WorkflowIdReusePolicy;
+    idConflictPolicy?: WorkflowIdConflictPolicy;
     headers?: Headers;
 }
 /** A started child run. */
@@ -242,7 +298,11 @@ interface ChildHandle<Out = Json> {
 }
 /** A handle to another run of the workspace (11 §2.24). */
 interface ExternalRunHandle {
+    /** The run id of a run-id target; empty for a workflow-id target. */
     readonly runId: string;
+    /** The workflow key and id of a workflow-id target. */
+    readonly workflowKey?: string;
+    readonly workflowId?: string;
     signal<P>(signal: SignalDefinition<P> | string, payload?: P): Promise<void>;
     /** Resolves when the cancel request was delivered, not when the run ends. */
     cancel(): Promise<void>;
@@ -291,12 +351,26 @@ interface Saga {
     add(compensation: (ctx: WorkflowContext) => unknown): void;
     compensate(): Promise<void>;
 }
+/** Options of `ctx.continueAsNew`; each defaults to the current run's value (11 §2.20). */
+/**
+ * The R1 continue-as-new retry option: the activity retry shape. R1 wrote it
+ * into `CONTINUE_AS_NEW` unchanged and the Phase B service ignored it.
+ *
+ * @deprecated Since R2; give a run-level {@link WorkflowRetryOptions}.
+ */
+type LegacyContinueAsNewRetry = Partial<RetryPolicy>;
 interface ContinueAsNewOptions {
     taskQueue?: string;
-    retry?: Partial<RetryPolicy>;
+    /**
+     * The run-level retry policy of the new run. The R1 activity shape
+     * (`retryDelay`, `maxRetries`) is still accepted and written as R1 wrote it;
+     * it has no effect, as in Phase B.
+     */
+    retry?: WorkflowRetryOptions | LegacyContinueAsNewRetry;
     workflowTaskTimeout?: Duration;
+    /** The new run's memo. */
     context?: JsonObject;
-    versioningBehavior?: 'PINNED' | 'AUTO_UPGRADE';
+    versioningBehavior?: VersioningBehavior;
 }
 /** A child target: a workflow key (graph or durable) or a tier-2 function of the same bundle. */
 type ChildTarget<Out> = string | DurableWorkflow<never, Out> | DurableWorkflow<Json, Out>;
@@ -316,19 +390,20 @@ interface WorkflowContext {
     signalReceived<P>(signal: SignalDefinition<P> | string): Promise<P>;
     /** Handle every signal of this name, buffered ones first. */
     onSignal<P>(signal: SignalDefinition<P> | string, handler: (payload: P) => unknown): void;
+    onSignal<P>(signal: SignalDefinition<P> | string, options: SignalHandlerOptions, handler: (payload: P) => unknown): void;
     /** Handle signals no other handler or waiter takes. */
     setDefaultSignalHandler(handler: (name: string, payload: unknown) => unknown): void;
     /** Start a child run and wait for its result. */
     child<Out = Json>(target: ChildTarget<Out>, options?: ChildOptions): Promise<Out>;
     /** Start a child run; resolves once it has started. */
     startChild<Out = Json>(target: ChildTarget<Out>, options?: ChildOptions): Promise<ChildHandle<Out>>;
-    /** Signal another run of the workspace; resolves on delivery. */
-    signalRun<P>(runId: string, signal: SignalDefinition<P> | string, payload?: P): Promise<void>;
+    /** Signal another run of the workspace (by run id or workflow id); resolves on delivery. */
+    signalRun<P>(target: ExternalRunTarget, signal: SignalDefinition<P> | string, payload?: P): Promise<void>;
     /** Signal the parent run. */
     signalParent<P>(signal: SignalDefinition<P> | string, payload?: P): Promise<void>;
-    getRunHandle(runId: string): ExternalRunHandle;
-    /** Shorthand for `getRunHandle(runId).cancel()`. */
-    cancelRun(runId: string): Promise<void>;
+    getRunHandle(target: ExternalRunTarget): ExternalRunHandle;
+    /** Shorthand for `getRunHandle(target).cancel()`. */
+    cancelRun(target: ExternalRunTarget): Promise<void>;
     /** The workflow clock (the task's start time), in epoch milliseconds. */
     now(): number;
     /** A deterministic random number in [0, 1), seeded per run. */
@@ -366,8 +441,17 @@ interface WorkflowContext {
     allHandlersFinished(): Promise<void>;
     /** Phase C: user activities. Throws `PhaseCFeatureError`. */
     activity(...args: unknown[]): Promise<never>;
-    /** Phase B parity: local activities. Throws `PhaseCFeatureError` in this release. */
-    localActivity(...args: unknown[]): Promise<never>;
+    /**
+     * Run a short, idempotent node operation inside the workflow task (11
+     * §2.12): the worker that runs the task executes it and the task records one
+     * `LOCAL_ACTIVITY_COMPLETED` or `LOCAL_ACTIVITY_FAILED` marker
+     * (`RECORD_LOCAL_ACTIVITY`). Replays return the recorded outcome and never
+     * run it again. The activity allow-list of `ctx.run` applies; a user
+     * function instead of a node operation is Phase C and throws
+     * `PhaseCFeatureError`.
+     */
+    localActivity<In, Out>(operation: Operation<In, Out>, options: LocalActivityOptions<In>): Promise<Out>;
+    localActivity(fn: (...args: never[]) => unknown, options?: unknown): Promise<never>;
     /** Phase C: custom queries. Throws `PhaseCFeatureError`. */
     handleQuery(...args: unknown[]): void;
     /** Phase C: updates. Throws `PhaseCFeatureError`. */
@@ -422,7 +506,19 @@ interface DurableWorkflowOptions {
     standalone?: boolean;
     /** Error classes that fail the run instead of the workflow task (11 §2.25). */
     failureErrorTypes?: ReadonlyArray<abstract new (...args: never[]) => Error>;
+    /** `PINNED` (default) or `AUTO_UPGRADE` (11 §2.27); lowered to `config.versioningBehavior`. */
+    versioningBehavior?: VersioningBehavior;
+    /** Run-level retry (11 §2.17); lowered to `config.retry`. */
+    retry?: WorkflowRetryOptions;
+    /** Bounds the whole continue-as-new and retry chain (11 §2.20); `config.executionTimeout`. */
+    executionTimeout?: Duration;
+    /** Bounds one run; `config.timeout`. */
+    runTimeout?: Duration;
+    /** The replay budget of one workflow task, at most 120 s; `config.workflowTaskTimeout`. */
+    workflowTaskTimeout?: Duration;
 }
+/** The largest `workflowTaskTimeout` (11 §2.20). */
+declare const MAX_WORKFLOW_TASK_TIMEOUT_MS = 120000;
 /** A declared tier-2 workflow. */
 interface DurableWorkflow<In = Json, Out = Json> {
     readonly __fluidgrids: typeof DURABLE_MARKER;
@@ -440,5 +536,21 @@ declare function isDurableWorkflow(value: unknown): value is DurableWorkflow<nev
 declare function jsonSchemaOf(schema: SchemaLike | undefined): JsonObject | undefined;
 /** The workflow `interface` (spec 01 §4) a tier-2 declaration describes. */
 declare function interfaceOf(definition: DurableWorkflow<never, unknown>): WorkflowInterface;
+/** The history form (milliseconds, defaults filled in) of a run-level retry option. */
+declare function runRetryPolicyOf(retry: WorkflowRetryOptions): RunRetryPolicy;
+/**
+ * The `CONTINUE_AS_NEW` `options.retry` of a `ctx.continueAsNew` retry option
+ * (C-SCHEMA `canOptions`).
+ *
+ * - An option with an activity-only key (`retryDelay`, `maxRetries`,
+ *   `retryOnErrorTypes`) is the R1 shape. It is written exactly as R1 wrote it
+ *   (activity form, defaults filled in), so an R1 workflow issues the same
+ *   command and keeps its Phase B behaviour: the service ignores that shape.
+ * - Anything else is a run-level retry policy (R2), checked for unknown keys.
+ *   Keys both shapes share (`maxDelay`, `backoffMultiplier`,
+ *   `nonRetryableErrorTypes`) alone mean the R2 shape.
+ * - Mixing an activity-only key with `maxAttempts` or `initialDelay` throws.
+ */
+declare function continueAsNewRetryOf(retry: WorkflowRetryOptions | LegacyContinueAsNewRetry): RunRetryPolicy | RetryPolicy;
 
-export { trigger as A, triggers as B, type CancellationScope as C, DURABLE_MARKER as D, type ExternalRunHandle as E, type FileRef as F, workflow as G, type Operation as O, type QueryDefinition as Q, type RunOptions as R, type Saga as S, type TriggerOperation as T, type UpdateDefinition as U, type WorkflowContext as W, type CancellationScopeFunction as a, type CancellationScopeOptions as b, type ChildHandle as c, type ChildOptions as d, type ChildTarget as e, type ContinueAsNewOptions as f, type DefinitionOptions as g, type DurableWorkflow as h, type DurableWorkflowOptions as i, type Duration as j, type SchemaLike as k, type SignalDefinition as l, type TriggerSpec as m, type WorkflowInfo as n, type WorkflowLogger as o, defineQuery as p, defineSignal as q, defineUpdate as r, interfaceOf as s, internalNodes as t, isDurableWorkflow as u, isOperation as v, jsonSchemaOf as w, nodes as x, op as y, toMs as z };
+export { isDurableWorkflow as A, isOperation as B, type CancellationScope as C, DURABLE_MARKER as D, type ExternalRunHandle as E, type FileRef as F, jsonSchemaOf as G, type HandlerUnfinishedPolicy as H, nodes as I, op as J, runRetryPolicyOf as K, type LegacyContinueAsNewRetry as L, MAX_WORKFLOW_TASK_TIMEOUT_MS as M, toMs as N, type Operation as O, trigger as P, type QueryDefinition as Q, type RunOptions as R, type Saga as S, type TriggerOperation as T, type UpdateDefinition as U, triggers as V, type WorkflowContext as W, workflow as X, type CancellationScopeFunction as a, type CancellationScopeOptions as b, type ChildHandle as c, type ChildOptions as d, type ChildTarget as e, type ContinueAsNewOptions as f, type DefinitionOptions as g, type DurableWorkflow as h, type DurableWorkflowOptions as i, type Duration as j, type ExternalRunTarget as k, type LocalActivityOptions as l, type SchemaLike as m, type SignalDefinition as n, type SignalHandlerOptions as o, type TriggerSpec as p, type WorkflowIdTarget as q, type WorkflowInfo as r, type WorkflowLogger as s, type WorkflowRetryOptions as t, continueAsNewRetryOf as u, defineQuery as v, defineSignal as w, defineUpdate as x, interfaceOf as y, internalNodes as z };

package/dist/{workflow-J-yYixny.d.cts → workflow-O6e64ZcG.d.cts}

@@ -1,5 +1,5 @@
-import { a as Json, J as JsonObject, W as WorkflowInterface } from './types-BGoPzgcl.cjs';
-import { a6 as WorkflowInfoSnapshot, R as RetryPolicy, c as ActivityCancellationType, w as Headers, P as ParentClosePolicy, C as ChildCancellationType } from './types-CpBBjaGX.cjs';
+import { J as Json, a as JsonObject, b as WorkflowInterface } from './types-Bb2wRnJ5.cjs';
+import { ai as WorkflowInfoSnapshot, R as RetryPolicy, d as ActivityCancellationType, x as Headers, P as ParentClosePolicy, C as ChildCancellationType, ac as VersioningBehavior, ah as WorkflowIdReusePolicy, ag as WorkflowIdConflictPolicy, b as RunRetryPolicy } from './types-CQKOhPTa.cjs';
 
 /**
  * Node operation descriptors: what a builder call needs to know about the node
@@ -205,6 +205,57 @@ interface RunOptions<In> {
     nodeVersion?: string;
     headers?: Headers;
 }
+/** Options of `ctx.localActivity` (11 §2.12). */
+interface LocalActivityOptions<In> {
+    args: In;
+    /** Connection name, resolved by the worker that runs the task. */
+    connection?: string;
+    /** Default: 1 s, x2, at most 100 s, unlimited attempts, bounded by the task's 30 s budget. */
+    retry?: Partial<RetryPolicy>;
+    /** At most 30 s (the default). */
+    startToCloseTimeout?: Duration;
+    /** Label in the History tab (at most 200 characters). */
+    summary?: string;
+    /** Overrides the operation name the descriptor carries. */
+    operation?: string;
+    /** Overrides the node version the descriptor carries. */
+    nodeVersion?: string;
+}
+/**
+ * Run-level retry of a workflow (11 §2.17): a run that fails with a retryable
+ * failure, or whose run timeout expires, starts again as a new run of the same
+ * chain with `ctx.info.attempt + 1` and `ctx.info.lastFailure`.
+ */
+interface WorkflowRetryOptions {
+    /** Attempts in total, the first one included; absent means unlimited (bounded by the execution timeout). */
+    maxAttempts?: number;
+    /** Delay before the second attempt; default 1 s. */
+    initialDelay?: Duration;
+    /** Default 2. */
+    backoffMultiplier?: number;
+    /** Largest delay; default 100 s, or 100 times `initialDelay` when that is given. */
+    maxDelay?: Duration;
+    /** Free-form failure types that are never retried. */
+    nonRetryableErrorTypes?: string[];
+}
+/** A run addressed by its workflow id (11 §2.1): the open run of the chain. */
+interface WorkflowIdTarget {
+    workflowKey: string;
+    workflowId: string;
+    /** Pins the chain whose first run this is. */
+    firstRunId?: string;
+}
+/** Another run of the workspace: a run id or a workflow id. */
+type ExternalRunTarget = string | {
+    runId: string;
+} | WorkflowIdTarget;
+/** What happens to a handler still running when the workflow finishes (11 §2.18). */
+type HandlerUnfinishedPolicy = 'WARN_AND_ABANDON' | 'ABANDON';
+/** Options of `ctx.onSignal`. */
+interface SignalHandlerOptions {
+    /** Default `WARN_AND_ABANDON`: a warning when the workflow finishes while this handler runs. */
+    unfinishedPolicy?: HandlerUnfinishedPolicy;
+}
 /** Options of `ctx.child` and `ctx.startChild` (11 §2.35). */
 interface ChildOptions {
     input?: unknown;
@@ -229,6 +280,11 @@ interface ChildOptions {
     executionTimeout?: Duration;
     runTimeout?: Duration;
     workflowTaskTimeout?: Duration;
+    /** Run-level retry of the child. */
+    retry?: WorkflowRetryOptions;
+    versioningBehavior?: VersioningBehavior;
+    idReusePolicy?: WorkflowIdReusePolicy;
+    idConflictPolicy?: WorkflowIdConflictPolicy;
     headers?: Headers;
 }
 /** A started child run. */
@@ -242,7 +298,11 @@ interface ChildHandle<Out = Json> {
 }
 /** A handle to another run of the workspace (11 §2.24). */
 interface ExternalRunHandle {
+    /** The run id of a run-id target; empty for a workflow-id target. */
     readonly runId: string;
+    /** The workflow key and id of a workflow-id target. */
+    readonly workflowKey?: string;
+    readonly workflowId?: string;
     signal<P>(signal: SignalDefinition<P> | string, payload?: P): Promise<void>;
     /** Resolves when the cancel request was delivered, not when the run ends. */
     cancel(): Promise<void>;
@@ -291,12 +351,26 @@ interface Saga {
     add(compensation: (ctx: WorkflowContext) => unknown): void;
     compensate(): Promise<void>;
 }
+/** Options of `ctx.continueAsNew`; each defaults to the current run's value (11 §2.20). */
+/**
+ * The R1 continue-as-new retry option: the activity retry shape. R1 wrote it
+ * into `CONTINUE_AS_NEW` unchanged and the Phase B service ignored it.
+ *
+ * @deprecated Since R2; give a run-level {@link WorkflowRetryOptions}.
+ */
+type LegacyContinueAsNewRetry = Partial<RetryPolicy>;
 interface ContinueAsNewOptions {
     taskQueue?: string;
-    retry?: Partial<RetryPolicy>;
+    /**
+     * The run-level retry policy of the new run. The R1 activity shape
+     * (`retryDelay`, `maxRetries`) is still accepted and written as R1 wrote it;
+     * it has no effect, as in Phase B.
+     */
+    retry?: WorkflowRetryOptions | LegacyContinueAsNewRetry;
     workflowTaskTimeout?: Duration;
+    /** The new run's memo. */
     context?: JsonObject;
-    versioningBehavior?: 'PINNED' | 'AUTO_UPGRADE';
+    versioningBehavior?: VersioningBehavior;
 }
 /** A child target: a workflow key (graph or durable) or a tier-2 function of the same bundle. */
 type ChildTarget<Out> = string | DurableWorkflow<never, Out> | DurableWorkflow<Json, Out>;
@@ -316,19 +390,20 @@ interface WorkflowContext {
     signalReceived<P>(signal: SignalDefinition<P> | string): Promise<P>;
     /** Handle every signal of this name, buffered ones first. */
     onSignal<P>(signal: SignalDefinition<P> | string, handler: (payload: P) => unknown): void;
+    onSignal<P>(signal: SignalDefinition<P> | string, options: SignalHandlerOptions, handler: (payload: P) => unknown): void;
     /** Handle signals no other handler or waiter takes. */
     setDefaultSignalHandler(handler: (name: string, payload: unknown) => unknown): void;
     /** Start a child run and wait for its result. */
     child<Out = Json>(target: ChildTarget<Out>, options?: ChildOptions): Promise<Out>;
     /** Start a child run; resolves once it has started. */
     startChild<Out = Json>(target: ChildTarget<Out>, options?: ChildOptions): Promise<ChildHandle<Out>>;
-    /** Signal another run of the workspace; resolves on delivery. */
-    signalRun<P>(runId: string, signal: SignalDefinition<P> | string, payload?: P): Promise<void>;
+    /** Signal another run of the workspace (by run id or workflow id); resolves on delivery. */
+    signalRun<P>(target: ExternalRunTarget, signal: SignalDefinition<P> | string, payload?: P): Promise<void>;
     /** Signal the parent run. */
     signalParent<P>(signal: SignalDefinition<P> | string, payload?: P): Promise<void>;
-    getRunHandle(runId: string): ExternalRunHandle;
-    /** Shorthand for `getRunHandle(runId).cancel()`. */
-    cancelRun(runId: string): Promise<void>;
+    getRunHandle(target: ExternalRunTarget): ExternalRunHandle;
+    /** Shorthand for `getRunHandle(target).cancel()`. */
+    cancelRun(target: ExternalRunTarget): Promise<void>;
     /** The workflow clock (the task's start time), in epoch milliseconds. */
     now(): number;
     /** A deterministic random number in [0, 1), seeded per run. */
@@ -366,8 +441,17 @@ interface WorkflowContext {
     allHandlersFinished(): Promise<void>;
     /** Phase C: user activities. Throws `PhaseCFeatureError`. */
     activity(...args: unknown[]): Promise<never>;
-    /** Phase B parity: local activities. Throws `PhaseCFeatureError` in this release. */
-    localActivity(...args: unknown[]): Promise<never>;
+    /**
+     * Run a short, idempotent node operation inside the workflow task (11
+     * §2.12): the worker that runs the task executes it and the task records one
+     * `LOCAL_ACTIVITY_COMPLETED` or `LOCAL_ACTIVITY_FAILED` marker
+     * (`RECORD_LOCAL_ACTIVITY`). Replays return the recorded outcome and never
+     * run it again. The activity allow-list of `ctx.run` applies; a user
+     * function instead of a node operation is Phase C and throws
+     * `PhaseCFeatureError`.
+     */
+    localActivity<In, Out>(operation: Operation<In, Out>, options: LocalActivityOptions<In>): Promise<Out>;
+    localActivity(fn: (...args: never[]) => unknown, options?: unknown): Promise<never>;
     /** Phase C: custom queries. Throws `PhaseCFeatureError`. */
     handleQuery(...args: unknown[]): void;
     /** Phase C: updates. Throws `PhaseCFeatureError`. */
@@ -422,7 +506,19 @@ interface DurableWorkflowOptions {
     standalone?: boolean;
     /** Error classes that fail the run instead of the workflow task (11 §2.25). */
     failureErrorTypes?: ReadonlyArray<abstract new (...args: never[]) => Error>;
+    /** `PINNED` (default) or `AUTO_UPGRADE` (11 §2.27); lowered to `config.versioningBehavior`. */
+    versioningBehavior?: VersioningBehavior;
+    /** Run-level retry (11 §2.17); lowered to `config.retry`. */
+    retry?: WorkflowRetryOptions;
+    /** Bounds the whole continue-as-new and retry chain (11 §2.20); `config.executionTimeout`. */
+    executionTimeout?: Duration;
+    /** Bounds one run; `config.timeout`. */
+    runTimeout?: Duration;
+    /** The replay budget of one workflow task, at most 120 s; `config.workflowTaskTimeout`. */
+    workflowTaskTimeout?: Duration;
 }
+/** The largest `workflowTaskTimeout` (11 §2.20). */
+declare const MAX_WORKFLOW_TASK_TIMEOUT_MS = 120000;
 /** A declared tier-2 workflow. */
 interface DurableWorkflow<In = Json, Out = Json> {
     readonly __fluidgrids: typeof DURABLE_MARKER;
@@ -440,5 +536,21 @@ declare function isDurableWorkflow(value: unknown): value is DurableWorkflow<nev
 declare function jsonSchemaOf(schema: SchemaLike | undefined): JsonObject | undefined;
 /** The workflow `interface` (spec 01 §4) a tier-2 declaration describes. */
 declare function interfaceOf(definition: DurableWorkflow<never, unknown>): WorkflowInterface;
+/** The history form (milliseconds, defaults filled in) of a run-level retry option. */
+declare function runRetryPolicyOf(retry: WorkflowRetryOptions): RunRetryPolicy;
+/**
+ * The `CONTINUE_AS_NEW` `options.retry` of a `ctx.continueAsNew` retry option
+ * (C-SCHEMA `canOptions`).
+ *
+ * - An option with an activity-only key (`retryDelay`, `maxRetries`,
+ *   `retryOnErrorTypes`) is the R1 shape. It is written exactly as R1 wrote it
+ *   (activity form, defaults filled in), so an R1 workflow issues the same
+ *   command and keeps its Phase B behaviour: the service ignores that shape.
+ * - Anything else is a run-level retry policy (R2), checked for unknown keys.
+ *   Keys both shapes share (`maxDelay`, `backoffMultiplier`,
+ *   `nonRetryableErrorTypes`) alone mean the R2 shape.
+ * - Mixing an activity-only key with `maxAttempts` or `initialDelay` throws.
+ */
+declare function continueAsNewRetryOf(retry: WorkflowRetryOptions | LegacyContinueAsNewRetry): RunRetryPolicy | RetryPolicy;
 
-export { trigger as A, triggers as B, type CancellationScope as C, DURABLE_MARKER as D, type ExternalRunHandle as E, type FileRef as F, workflow as G, type Operation as O, type QueryDefinition as Q, type RunOptions as R, type Saga as S, type TriggerOperation as T, type UpdateDefinition as U, type WorkflowContext as W, type CancellationScopeFunction as a, type CancellationScopeOptions as b, type ChildHandle as c, type ChildOptions as d, type ChildTarget as e, type ContinueAsNewOptions as f, type DefinitionOptions as g, type DurableWorkflow as h, type DurableWorkflowOptions as i, type Duration as j, type SchemaLike as k, type SignalDefinition as l, type TriggerSpec as m, type WorkflowInfo as n, type WorkflowLogger as o, defineQuery as p, defineSignal as q, defineUpdate as r, interfaceOf as s, internalNodes as t, isDurableWorkflow as u, isOperation as v, jsonSchemaOf as w, nodes as x, op as y, toMs as z };
+export { isDurableWorkflow as A, isOperation as B, type CancellationScope as C, DURABLE_MARKER as D, type ExternalRunHandle as E, type FileRef as F, jsonSchemaOf as G, type HandlerUnfinishedPolicy as H, nodes as I, op as J, runRetryPolicyOf as K, type LegacyContinueAsNewRetry as L, MAX_WORKFLOW_TASK_TIMEOUT_MS as M, toMs as N, type Operation as O, trigger as P, type QueryDefinition as Q, type RunOptions as R, type Saga as S, type TriggerOperation as T, type UpdateDefinition as U, triggers as V, type WorkflowContext as W, workflow as X, type CancellationScopeFunction as a, type CancellationScopeOptions as b, type ChildHandle as c, type ChildOptions as d, type ChildTarget as e, type ContinueAsNewOptions as f, type DefinitionOptions as g, type DurableWorkflow as h, type DurableWorkflowOptions as i, type Duration as j, type ExternalRunTarget as k, type LocalActivityOptions as l, type SchemaLike as m, type SignalDefinition as n, type SignalHandlerOptions as o, type TriggerSpec as p, type WorkflowIdTarget as q, type WorkflowInfo as r, type WorkflowLogger as s, type WorkflowRetryOptions as t, continueAsNewRetryOf as u, defineQuery as v, defineSignal as w, defineUpdate as x, interfaceOf as y, internalNodes as z };