@fluidgrids/workflows 2026.1028.2 → 2026.1029.1

package/dist/runtime/index.d.cts

@@ -1,7 +1,7 @@
-import { W as WorkflowContext, h as DurableWorkflow, C as CancellationScope, O as Operation, R as RunOptions, j as Duration, l as SignalDefinition, e as ChildTarget, d as ChildOptions, c as ChildHandle, f as ContinueAsNewOptions, b as CancellationScopeOptions } from '../workflow-J-yYixny.cjs';
-export { A as Activation, s as splitActivations } from '../activation-BBh1p82z.cjs';
-import { W as WorkflowCommand, U as RunEventRecord, a7 as WorkflowTaskRequest, a8 as WorkflowTaskResult, a as WorkflowTaskFailureCause, X as RunTarget } from '../types-CpBBjaGX.cjs';
-import { a as Json, J as JsonObject } from '../types-BGoPzgcl.cjs';
+import { W as WorkflowContext, h as DurableWorkflow, C as CancellationScope, O as Operation, R as RunOptions, l as LocalActivityOptions, j as Duration, n as SignalDefinition, o as SignalHandlerOptions, k as ExternalRunTarget, E as ExternalRunHandle, e as ChildTarget, d as ChildOptions, c as ChildHandle, f as ContinueAsNewOptions, b as CancellationScopeOptions } from '../workflow-O6e64ZcG.cjs';
+export { A as Activation, s as splitActivations } from '../activation-CESehfYi.cjs';
+import { W as WorkflowCommand, Z as RunEventRecord, aj as WorkflowTaskRequest, ak as WorkflowTaskResult, a as WorkflowTaskFailureCause, $ as RunTarget } from '../types-CQKOhPTa.cjs';
+import { J as Json, a as JsonObject } from '../types-Bb2wRnJ5.cjs';
 
 /**
  * Determinism shims for workflow tasks (C-ABI, spec 04 §4).
@@ -71,9 +71,10 @@ declare function matchActivation(commands: readonly WorkflowCommand[], recorded:
 /**
  * Command ids (C-HIST): one counter per kind, in issue order, so a replay that
  * issues the same commands in the same order derives the same ids, and a
- * reordered await is caught as a mismatch. Patch markers use `patch:<id>`.
+ * reordered await is caught as a mismatch. Patch markers use `patch:<id>`;
+ * local activities (R2) use `l<n>`.
  */
-type CommandIdKind = 'a' | 't' | 'c' | 's' | 'x' | 'm';
+type CommandIdKind = 'a' | 't' | 'c' | 's' | 'x' | 'm' | 'l';
 declare class CommandIds {
     private readonly counters;
     /** The next id of a kind: `a1`, `a2`, ... */
@@ -183,7 +184,16 @@ declare class WorkflowExecution {
     private readonly signalHandlers;
     private readonly signalWaiters;
     private defaultSignalHandler;
+    private defaultSignalPolicy;
+    private readonly signalPolicies;
     private runningHandlers;
+    /** Running asynchronous handlers by name, for the drain warning (11 §2.18). */
+    private readonly running;
+    private unfinished;
+    private readonly recordedLocalActivities;
+    private readonly localActivityResults;
+    private readonly localActivities;
+    private memo;
     private conditions;
     private currentDetails;
     readonly context: WorkflowContext;
@@ -198,10 +208,24 @@ declare class WorkflowExecution {
     step(): 'more' | 'done';
     /** The task's result. Call after `step()` returned `done` and jobs were drained. */
     complete(): WorkflowTaskResult;
+    /**
+     * The local activities the open activation waits for, when the task is a
+     * workflow task that has not failed or closed the run (a run that ends
+     * abandons a local activity it did not await).
+     */
+    private pendingLocalActivityRequests;
     /** Fail the task (the runtime's own failures and code errors). */
     failTask(cause: WorkflowTaskFailureCause, message: string, stackTrace?: string, seq?: number, errorType?: string): void;
     private beginActivation;
     private finishActivation;
+    /**
+     * A local activity issued on a replayed activation without a recorded
+     * outcome is fine only when the first execution dropped it in that same
+     * activation: its scope was cancelled (the entry is gone) or the run closed.
+     * One still waiting means the first execution would have requested and
+     * recorded it, so the code diverged from the history.
+     */
+    private checkReplayedLocalActivities;
     private deliver;
     private expectIssued;
     private settleActivity;
@@ -209,6 +233,12 @@ declare class WorkflowExecution {
     private dispatchSignal;
     private takeBuffered;
     private runHandler;
+    /**
+     * The drain check of 11 §2.18 when the workflow finishes: handlers still
+     * running with policy `WARN_AND_ABANDON` give one warning line and
+     * `unfinishedHandlers` in the result. A replay never reports them.
+     */
+    private checkUnfinishedHandlers;
     private startFunction;
     private onReturn;
     private isFailureType;
@@ -227,6 +257,15 @@ declare class WorkflowExecution {
     private stack;
     private never;
     scheduleActivity<In, Out>(scope: Scope, operation: Operation<In, Out>, options: RunOptions<In>): Promise<Out>;
+    /**
+     * `ctx.localActivity` (11 §2.12). A replayed activation returns the outcome
+     * its history recorded; the open activation takes the outcome the worker
+     * passed in `localActivityResults`, or asks for the local activity
+     * (`localActivityRequested`) and waits for the same task to run again.
+     * Either way the outcome is recorded with `RECORD_LOCAL_ACTIVITY` at the
+     * call, so a replay issues the same command at the same position.
+     */
+    localActivity<In, Out>(scope: Scope, operation: unknown, options: LocalActivityOptions<In> | undefined): Promise<Out>;
     startTimer(scope: Scope, durationMs: number, summary: string | undefined): Promise<void>;
     /** Start a durable timer; `timerId` is undefined when no timer was needed or issued. */
     private timer;
@@ -236,8 +275,11 @@ declare class WorkflowExecution {
     /** Resolve conditions whose predicate now holds; true when any did. */
     private checkConditions;
     signalReceived<P>(scope: Scope, signal: SignalDefinition<P> | string): Promise<P>;
-    onSignal(signal: SignalDefinition<unknown> | string, handler: (payload: unknown) => unknown): void;
+    onSignal(signal: SignalDefinition<unknown> | string, handler: (payload: unknown) => unknown, options?: SignalHandlerOptions): void;
     setDefaultSignalHandler(handler: (name: string, payload: unknown) => unknown): void;
+    /** The command target of a run handle (11 §2.1, §2.24). */
+    externalTarget(target: ExternalRunTarget): RunTarget;
+    runHandle(target: ExternalRunTarget): ExternalRunHandle;
     private childTarget;
     private childCommand;
     private startChildRun;

package/dist/runtime/index.d.ts

@@ -1,7 +1,7 @@
-import { W as WorkflowContext, h as DurableWorkflow, C as CancellationScope, O as Operation, R as RunOptions, j as Duration, l as SignalDefinition, e as ChildTarget, d as ChildOptions, c as ChildHandle, f as ContinueAsNewOptions, b as CancellationScopeOptions } from '../workflow-C2a05WUJ.js';
-export { A as Activation, s as splitActivations } from '../activation-DnhG7SmF.js';
-import { W as WorkflowCommand, U as RunEventRecord, a7 as WorkflowTaskRequest, a8 as WorkflowTaskResult, a as WorkflowTaskFailureCause, X as RunTarget } from '../types-DV-HX_Gt.js';
-import { a as Json, J as JsonObject } from '../types-BGoPzgcl.js';
+import { W as WorkflowContext, h as DurableWorkflow, C as CancellationScope, O as Operation, R as RunOptions, l as LocalActivityOptions, j as Duration, n as SignalDefinition, o as SignalHandlerOptions, k as ExternalRunTarget, E as ExternalRunHandle, e as ChildTarget, d as ChildOptions, c as ChildHandle, f as ContinueAsNewOptions, b as CancellationScopeOptions } from '../workflow-DWTPHFbt.js';
+export { A as Activation, s as splitActivations } from '../activation-BnVQMv9y.js';
+import { W as WorkflowCommand, Z as RunEventRecord, aj as WorkflowTaskRequest, ak as WorkflowTaskResult, a as WorkflowTaskFailureCause, $ as RunTarget } from '../types-CnIOinoz.js';
+import { J as Json, a as JsonObject } from '../types-Bb2wRnJ5.js';
 
 /**
  * Determinism shims for workflow tasks (C-ABI, spec 04 §4).
@@ -71,9 +71,10 @@ declare function matchActivation(commands: readonly WorkflowCommand[], recorded:
 /**
  * Command ids (C-HIST): one counter per kind, in issue order, so a replay that
  * issues the same commands in the same order derives the same ids, and a
- * reordered await is caught as a mismatch. Patch markers use `patch:<id>`.
+ * reordered await is caught as a mismatch. Patch markers use `patch:<id>`;
+ * local activities (R2) use `l<n>`.
  */
-type CommandIdKind = 'a' | 't' | 'c' | 's' | 'x' | 'm';
+type CommandIdKind = 'a' | 't' | 'c' | 's' | 'x' | 'm' | 'l';
 declare class CommandIds {
     private readonly counters;
     /** The next id of a kind: `a1`, `a2`, ... */
@@ -183,7 +184,16 @@ declare class WorkflowExecution {
     private readonly signalHandlers;
     private readonly signalWaiters;
     private defaultSignalHandler;
+    private defaultSignalPolicy;
+    private readonly signalPolicies;
     private runningHandlers;
+    /** Running asynchronous handlers by name, for the drain warning (11 §2.18). */
+    private readonly running;
+    private unfinished;
+    private readonly recordedLocalActivities;
+    private readonly localActivityResults;
+    private readonly localActivities;
+    private memo;
     private conditions;
     private currentDetails;
     readonly context: WorkflowContext;
@@ -198,10 +208,24 @@ declare class WorkflowExecution {
     step(): 'more' | 'done';
     /** The task's result. Call after `step()` returned `done` and jobs were drained. */
     complete(): WorkflowTaskResult;
+    /**
+     * The local activities the open activation waits for, when the task is a
+     * workflow task that has not failed or closed the run (a run that ends
+     * abandons a local activity it did not await).
+     */
+    private pendingLocalActivityRequests;
     /** Fail the task (the runtime's own failures and code errors). */
     failTask(cause: WorkflowTaskFailureCause, message: string, stackTrace?: string, seq?: number, errorType?: string): void;
     private beginActivation;
     private finishActivation;
+    /**
+     * A local activity issued on a replayed activation without a recorded
+     * outcome is fine only when the first execution dropped it in that same
+     * activation: its scope was cancelled (the entry is gone) or the run closed.
+     * One still waiting means the first execution would have requested and
+     * recorded it, so the code diverged from the history.
+     */
+    private checkReplayedLocalActivities;
     private deliver;
     private expectIssued;
     private settleActivity;
@@ -209,6 +233,12 @@ declare class WorkflowExecution {
     private dispatchSignal;
     private takeBuffered;
     private runHandler;
+    /**
+     * The drain check of 11 §2.18 when the workflow finishes: handlers still
+     * running with policy `WARN_AND_ABANDON` give one warning line and
+     * `unfinishedHandlers` in the result. A replay never reports them.
+     */
+    private checkUnfinishedHandlers;
     private startFunction;
     private onReturn;
     private isFailureType;
@@ -227,6 +257,15 @@ declare class WorkflowExecution {
     private stack;
     private never;
     scheduleActivity<In, Out>(scope: Scope, operation: Operation<In, Out>, options: RunOptions<In>): Promise<Out>;
+    /**
+     * `ctx.localActivity` (11 §2.12). A replayed activation returns the outcome
+     * its history recorded; the open activation takes the outcome the worker
+     * passed in `localActivityResults`, or asks for the local activity
+     * (`localActivityRequested`) and waits for the same task to run again.
+     * Either way the outcome is recorded with `RECORD_LOCAL_ACTIVITY` at the
+     * call, so a replay issues the same command at the same position.
+     */
+    localActivity<In, Out>(scope: Scope, operation: unknown, options: LocalActivityOptions<In> | undefined): Promise<Out>;
     startTimer(scope: Scope, durationMs: number, summary: string | undefined): Promise<void>;
     /** Start a durable timer; `timerId` is undefined when no timer was needed or issued. */
     private timer;
@@ -236,8 +275,11 @@ declare class WorkflowExecution {
     /** Resolve conditions whose predicate now holds; true when any did. */
     private checkConditions;
     signalReceived<P>(scope: Scope, signal: SignalDefinition<P> | string): Promise<P>;
-    onSignal(signal: SignalDefinition<unknown> | string, handler: (payload: unknown) => unknown): void;
+    onSignal(signal: SignalDefinition<unknown> | string, handler: (payload: unknown) => unknown, options?: SignalHandlerOptions): void;
     setDefaultSignalHandler(handler: (name: string, payload: unknown) => unknown): void;
+    /** The command target of a run handle (11 §2.1, §2.24). */
+    externalTarget(target: ExternalRunTarget): RunTarget;
+    runHandle(target: ExternalRunTarget): ExternalRunHandle;
     private childTarget;
     private childCommand;
     private startChildRun;

package/dist/runtime/index.js

@@ -1,8 +1,9 @@
-export { CommandIds, RUNTIME_GLOBAL, SDK_NAME, WorkflowExecution, buildWorkflowRegistry, createWorkflowRuntime, installWorkflowRuntime, isPatchMarkerId, isRuntimeAbi, matchActivation, mismatch, patchMarkerId } from '../chunk-VRHHBPT6.js';
-import '../chunk-C5OLWZ42.js';
-import '../chunk-LNUQE6D6.js';
+export { CommandIds, RUNTIME_GLOBAL, SDK_NAME, WorkflowExecution, buildWorkflowRegistry, createWorkflowRuntime, installWorkflowRuntime, isPatchMarkerId, isRuntimeAbi, matchActivation, mismatch, patchMarkerId } from '../chunk-MJ5TGYVG.js';
+import '../chunk-KXJDRQ6G.js';
+import '../chunk-M272AHEX.js';
 export { SHIM_HOOK, SHIM_VIOLATION, TASK_PRELUDE, createRandom, seedOf, uuidFrom } from '../chunk-4LYSEANA.js';
-import '../chunk-N23SKIG4.js';
-export { splitActivations } from '../chunk-ABFZWYHT.js';
-import '../chunk-DJYMDLV5.js';
-import '../chunk-BO6OVILK.js';
+import '../chunk-7ILGCUI6.js';
+import '../chunk-LNUQE6D6.js';
+export { splitActivations } from '../chunk-FWBRQWRX.js';
+import '../chunk-2DDULZFM.js';
+import '../chunk-PWIUEWC3.js';