@fluidgrids/workflows 2026.1028.1 → 2026.1029.1

package/dist/{chunk-CSNWNFKU.cjs → chunk-OMY3CKUZ.cjs}

@@ -1,15 +1,24 @@
 'use strict';
 
-var chunkFMSW2HDF_cjs = require('./chunk-FMSW2HDF.cjs');
+var chunkELL2RBML_cjs = require('./chunk-ELL2RBML.cjs');
+var chunkQ4MWQNJK_cjs = require('./chunk-Q4MWQNJK.cjs');
 var chunkL24YIZY7_cjs = require('./chunk-L24YIZY7.cjs');
-var chunkFQIHX7YI_cjs = require('./chunk-FQIHX7YI.cjs');
-var chunkP6TA5EZT_cjs = require('./chunk-P6TA5EZT.cjs');
-var chunk623FVQSN_cjs = require('./chunk-623FVQSN.cjs');
-var chunk2J6TF7YI_cjs = require('./chunk-2J6TF7YI.cjs');
+var chunkJ3PYFGKA_cjs = require('./chunk-J3PYFGKA.cjs');
+var chunkRUQIMTN5_cjs = require('./chunk-RUQIMTN5.cjs');
+var chunk3FIDHONL_cjs = require('./chunk-3FIDHONL.cjs');
+var chunkYHBVMOMK_cjs = require('./chunk-YHBVMOMK.cjs');
 
 // src/runtime/ids.ts
 var CommandIds = class {
-  counters = { a: 0, t: 0, c: 0, s: 0, x: 0, m: 0 };
+  counters = {
+    a: 0,
+    t: 0,
+    c: 0,
+    s: 0,
+    x: 0,
+    m: 0,
+    l: 0
+  };
   /** The next id of a kind: `a1`, `a2`, ... */
   next(kind) {
     this.counters[kind] += 1;
@@ -47,7 +56,7 @@ function describeCommand(command) {
     case "RECORD_MARKER":
       return `RECORD_MARKER ${command.markerId}`;
     case "RECORD_LOCAL_ACTIVITY":
-      return `RECORD_LOCAL_ACTIVITY ${command.localActivityId}`;
+      return `RECORD_LOCAL_ACTIVITY ${command.localActivityId}${command.nodeType !== void 0 ? ` (${command.nodeType} ${command.operation ?? ""})` : ""}`;
     default:
       return command.type;
   }
@@ -57,7 +66,7 @@ function describeEvent(event) {
   return `${event.type}${typeof id === "string" ? ` ${id}` : ""} (seq ${event.seq})`;
 }
 function mismatch(command, event) {
-  const expected = chunk623FVQSN_cjs.COMMAND_EVENT_TYPES[command.type];
+  const expected = chunk3FIDHONL_cjs.COMMAND_EVENT_TYPES[command.type];
   const typeOk = command.type === "RECORD_LOCAL_ACTIVITY" ? event.type === "LOCAL_ACTIVITY_COMPLETED" || event.type === "LOCAL_ACTIVITY_FAILED" : event.type === expected;
   const differ = () => `the code issued ${describeCommand(command)} where the history has ${describeEvent(event)}`;
   if (!typeOk) return differ();
@@ -79,8 +88,10 @@ function mismatch(command, event) {
       return field(event, "sideEffectId") === command.sideEffectId ? void 0 : differ();
     case "RECORD_MARKER":
       return field(event, "markerId") === command.markerId ? void 0 : differ();
-    case "RECORD_LOCAL_ACTIVITY":
-      return field(event, "localActivityId") === command.localActivityId ? void 0 : differ();
+    case "RECORD_LOCAL_ACTIVITY": {
+      const sameOperation = field(event, "nodeType") === void 0 || field(event, "nodeType") === command.nodeType && field(event, "operation") === command.operation;
+      return field(event, "localActivityId") === command.localActivityId && sameOperation ? void 0 : differ();
+    }
     default:
       return void 0;
   }
@@ -116,30 +127,6 @@ function matchActivation(commands, recorded) {
   return void 0;
 }
 
-// src/runtime/stack.ts
-var RUNTIME_FRAME = /fluidgrids-runtime|\/runtime\/(scheduler|index)\.|WorkflowExecution|RuntimeContext/;
-function captureStack() {
-  const stack = new Error("stack").stack ?? "";
-  return stack.split("\n").slice(1).filter((line) => line.trim() !== "" && !RUNTIME_FRAME.test(line)).join("\n");
-}
-var V8_FRAME = /^\s*at (?:(.*?) \()?(.*?):(\d+):(\d+)\)?$/;
-var QUICKJS_FRAME = /^\s*at (?:(.*?) )?\(?(.*?)(?::(\d+))?(?::(\d+))?\)?$/;
-function parseStack(stack) {
-  const locations = [];
-  for (const line of stack.split("\n")) {
-    if (line.trim() === "") continue;
-    const match = V8_FRAME.exec(line) ?? QUICKJS_FRAME.exec(line);
-    if (!match) continue;
-    const location = {};
-    if (match[1]) location.functionName = match[1];
-    if (match[2]) location.filePath = match[2];
-    if (match[3]) location.line = Number(match[3]);
-    if (match[4]) location.column = Number(match[4]);
-    locations.push(location);
-  }
-  return locations;
-}
-
 // src/runtime/scheduler.ts
 var SDK_NAME = "@fluidgrids/workflows";
 var ContinueAsNewRequest = class {
@@ -200,7 +187,7 @@ var Scope = class {
   cancel() {
     if (this.consideredCancelled) return;
     this.consideredCancelled = true;
-    this.rejectRequested(new chunkFMSW2HDF_cjs.CancelledFailure("Cancellation requested"));
+    this.rejectRequested(new chunkELL2RBML_cjs.CancelledFailure("Cancellation requested"));
     const errors = [];
     const handlers = [...this.handlers];
     this.handlers.clear();
@@ -253,6 +240,49 @@ function messageOf(error) {
 function stackTextOf(error) {
   return error instanceof Error && typeof error.stack === "string" ? error.stack : void 0;
 }
+function isJsonObject(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function asFailure(value) {
+  return isJsonObject(value) ? value : void 0;
+}
+function infoFromStarted(info, started) {
+  if (started?.type !== "WORKFLOW_STARTED") return { ...info };
+  const p = started.payload;
+  const out = { ...info };
+  if (Object.hasOwn(p, "lastCompletionResult")) out.lastResult = p["lastCompletionResult"] ?? null;
+  if (Object.hasOwn(p, "lastFailure")) out.lastFailure = asFailure(p["lastFailure"]) ?? null;
+  const businessId = typeof p["businessId"] === "string" ? p["businessId"] : void 0;
+  const workflowId = typeof p["workflowId"] === "string" ? p["workflowId"] : businessId;
+  if (businessId !== void 0) out.businessId = businessId;
+  if (workflowId !== void 0) out.workflowId = workflowId;
+  if (typeof p["runAttempt"] === "number") {
+    out.runAttempt = p["runAttempt"];
+    out.attempt = p["runAttempt"];
+  }
+  if (typeof p["summary"] === "string") out.summary = p["summary"];
+  if (typeof p["details"] === "string") out.details = p["details"];
+  if (isJsonObject(p["context"])) {
+    out.context = { ...p["context"] };
+    out.memo = { ...p["context"] };
+  }
+  const timeouts = {};
+  const nested = isJsonObject(p["timeouts"]) ? p["timeouts"] : {};
+  for (const key of ["executionTimeout", "runTimeout", "workflowTaskTimeout"]) {
+    const value = nested[key] ?? p[key];
+    if (typeof value === "number") timeouts[key] = value;
+  }
+  if (Object.keys(timeouts).length > 0) out.timeouts = timeouts;
+  if (p["versioningBehavior"] === "PINNED" || p["versioningBehavior"] === "AUTO_UPGRADE")
+    out.versioningBehavior = p["versioningBehavior"];
+  if (isJsonObject(p["retry"])) out.retry = p["retry"];
+  if (typeof p["priority"] === "number") out.priority = p["priority"];
+  if (typeof p["firstRunId"] === "string") out.firstRunId = p["firstRunId"];
+  if (typeof p["continuedFromRunId"] === "string") out.continuedFromRunId = p["continuedFromRunId"];
+  if (out.workflowId === void 0 && out.businessId !== void 0) out.workflowId = out.businessId;
+  if (out.runAttempt === void 0 && out.attempt !== void 0) out.runAttempt = out.attempt;
+  return out;
+}
 var WorkflowExecution = class {
   request;
   definition;
@@ -302,7 +332,16 @@ var WorkflowExecution = class {
   signalHandlers = /* @__PURE__ */ new Map();
   signalWaiters = /* @__PURE__ */ new Map();
   defaultSignalHandler;
+  defaultSignalPolicy = "WARN_AND_ABANDON";
+  signalPolicies = /* @__PURE__ */ new Map();
   runningHandlers = 0;
+  /** Running asynchronous handlers by name, for the drain warning (11 §2.18). */
+  running = /* @__PURE__ */ new Map();
+  unfinished;
+  recordedLocalActivities = /* @__PURE__ */ new Map();
+  localActivityResults = /* @__PURE__ */ new Map();
+  localActivities = /* @__PURE__ */ new Map();
+  memo;
   conditions = [];
   currentDetails;
   context;
@@ -316,12 +355,12 @@ var WorkflowExecution = class {
     this.bytesUpTo = [0];
     let bytes = 0;
     for (const event of history) {
-      bytes += chunkP6TA5EZT_cjs.utf8Bytes(JSON.stringify(event.payload));
+      bytes += chunkRUQIMTN5_cjs.utf8Bytes(JSON.stringify(event.payload));
       this.bytesUpTo.push(bytes);
     }
     this.historyLength = history.length;
     this.historyBytes = bytes;
-    const limit = input.request.info.historyLimit ?? chunk623FVQSN_cjs.DEFAULT_HISTORY_LIMIT;
+    const limit = input.request.info.historyLimit ?? chunk3FIDHONL_cjs.DEFAULT_HISTORY_LIMIT;
     this.limitEvents = limit.events;
     this.limitBytes = limit.bytes;
     this.captureStacks = input.request.kind === "query";
@@ -334,17 +373,40 @@ var WorkflowExecution = class {
       } else if (event.type === "MARKER_RECORDED") {
         const id = event.payload["markerId"];
         if (typeof id === "string") this.recordedMarkers.add(id);
+      } else if (event.type === "LOCAL_ACTIVITY_COMPLETED" || event.type === "LOCAL_ACTIVITY_FAILED") {
+        const id = event.payload["localActivityId"];
+        const failure = asFailure(event.payload["failure"]);
+        const attempts = event.payload["attempts"];
+        if (typeof id === "string")
+          this.recordedLocalActivities.set(id, {
+            ...event.type === "LOCAL_ACTIVITY_FAILED" && failure ? { failure } : { result: event.payload["result"] ?? null },
+            attempts: typeof attempts === "number" ? attempts : 1
+          });
       }
     }
-    this.activations = chunkP6TA5EZT_cjs.splitActivations(
+    if (input.request.kind === "task")
+      for (const entry of input.request.localActivityResults ?? [])
+        this.localActivityResults.set(entry.localActivityId, {
+          ...entry.failure !== void 0 ? { failure: entry.failure } : { result: entry.result ?? null },
+          attempts: entry.attempts
+        });
+    this.activations = chunkRUQIMTN5_cjs.splitActivations(
       history,
       input.request.nowMs,
       input.request.kind !== "query"
     );
     const execution = this;
+    const snapshot = infoFromStarted(input.request.info, history[0]);
+    this.memo = { ...snapshot.memo ?? snapshot.context ?? {} };
     this.info = {
-      ...input.request.info,
+      ...snapshot,
       workflowFn: input.request.workflowFn,
+      get context() {
+        return { ...execution.memo };
+      },
+      get memo() {
+        return { ...execution.memo };
+      },
       get historyLength() {
         return execution.historyLength;
       },
@@ -361,7 +423,7 @@ var WorkflowExecution = class {
     this.context = this.contextFor(void 0);
   }
   continueAsNewSuggested() {
-    return this.historyLength >= this.limitEvents * chunk623FVQSN_cjs.CONTINUE_AS_NEW_SUGGESTED_RATIO || this.historyBytes >= this.limitBytes * chunk623FVQSN_cjs.CONTINUE_AS_NEW_SUGGESTED_RATIO;
+    return this.historyLength >= this.limitEvents * chunk3FIDHONL_cjs.CONTINUE_AS_NEW_SUGGESTED_RATIO || this.historyBytes >= this.limitBytes * chunk3FIDHONL_cjs.CONTINUE_AS_NEW_SUGGESTED_RATIO;
   }
   /** The workflow clock. */
   now() {
@@ -391,12 +453,24 @@ var WorkflowExecution = class {
       this.checkConditions();
       this.finishActivation();
     }
+    const requests = this.pendingLocalActivityRequests();
+    if (requests.length > 0) {
+      const requested = {
+        protocol: chunk3FIDHONL_cjs.HISTORY_PROTOCOL,
+        outcome: "localActivityRequested",
+        commands: [],
+        localActivityRequests: requests,
+        logs: []
+      };
+      return requested;
+    }
     const result = {
-      protocol: chunk623FVQSN_cjs.HISTORY_PROTOCOL,
+      protocol: chunk3FIDHONL_cjs.HISTORY_PROTOCOL,
       outcome: this.failure ? "failed" : "commands",
       commands: this.failure ? [] : this.newCommands,
       logs: this.logs
     };
+    if (!this.failure && this.unfinished !== void 0) result.unfinishedHandlers = this.unfinished;
     if (this.failure) {
       result.failure = { cause: this.failure.cause, message: this.failure.message };
       if (this.failure.stackTrace !== void 0)
@@ -407,6 +481,15 @@ var WorkflowExecution = class {
     if (this.request.kind === "query") result.queryResults = this.answerQueries();
     return result;
   }
+  /**
+   * 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).
+   */
+  pendingLocalActivityRequests() {
+    if (this.failure || this.closed || this.request.kind !== "task") return [];
+    return [...this.localActivities.values()].filter((entry) => !entry.replayed).map((entry) => entry.request);
+  }
   /** Fail the task (the runtime's own failures and code errors). */
   failTask(cause, message, stackTrace, seq, errorType) {
     if (!this.failure) this.failure = new TaskFailure(cause, message, stackTrace, seq, errorType);
@@ -436,11 +519,30 @@ var WorkflowExecution = class {
           void 0,
           found.seq
         );
+      else this.checkReplayedLocalActivities();
     } else {
       this.newCommands = this.commands;
     }
     this.commands = [];
   }
+  /**
+   * 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.
+   */
+  checkReplayedLocalActivities() {
+    if (this.closed) return;
+    for (const entry of this.localActivities.values()) {
+      if (!entry.replayed) continue;
+      this.failTask(
+        "NON_DETERMINISM",
+        `Replay of ${entry.description ?? "a local activity"} found no recorded outcome: the code issued a local activity the history does not have`
+      );
+      return;
+    }
+  }
   // ---- inputs ---------------------------------------------------------------
   deliver(event) {
     const p = event.payload;
@@ -488,7 +590,7 @@ var WorkflowExecution = class {
         else {
           const failure = p["failure"];
           pending.reject(
-            typeof failure === "object" && failure !== null && !Array.isArray(failure) ? chunkFMSW2HDF_cjs.failureToError(failure) : new chunkFMSW2HDF_cjs.ServerFailure(`${pending.description} was not delivered`)
+            typeof failure === "object" && failure !== null && !Array.isArray(failure) ? chunkELL2RBML_cjs.failureToError(failure) : new chunkELL2RBML_cjs.ServerFailure(`${pending.description} was not delivered`)
           );
         }
         return;
@@ -518,7 +620,7 @@ var WorkflowExecution = class {
     pending.release?.();
     const p = event.payload;
     const failure = typeof p["failure"] === "object" && p["failure"] !== null && !Array.isArray(p["failure"]) ? p["failure"] : void 0;
-    const wrap = (cause) => new chunkFMSW2HDF_cjs.ActivityFailure(
+    const wrap = (cause) => new chunkELL2RBML_cjs.ActivityFailure(
       `Activity ${activityId} (${pending.nodeType} ${pending.operation}) failed: ${cause.message}`,
       activityId,
       pending.nodeType,
@@ -532,19 +634,19 @@ var WorkflowExecution = class {
       case "ACTIVITY_FAILED":
         pending.reject(
           wrap(
-            failure ? chunkFMSW2HDF_cjs.failureToError(failure) : new chunkFMSW2HDF_cjs.ApplicationError("Activity failed", { errorType: "UNKNOWN" })
+            failure ? chunkELL2RBML_cjs.failureToError(failure) : new chunkELL2RBML_cjs.ApplicationError("Activity failed", { errorType: "UNKNOWN" })
           )
         );
         return;
       case "ACTIVITY_TIMED_OUT": {
         const timeoutType = typeof p["timeoutType"] === "string" ? p["timeoutType"] : "UNKNOWN";
         pending.reject(
-          wrap(new chunkFMSW2HDF_cjs.TimeoutFailure(`Activity timed out (${timeoutType})`, timeoutType))
+          wrap(new chunkELL2RBML_cjs.TimeoutFailure(`Activity timed out (${timeoutType})`, timeoutType))
         );
         return;
       }
       default:
-        pending.reject(wrap(new chunkFMSW2HDF_cjs.CancelledFailure("Activity cancelled")));
+        pending.reject(wrap(new chunkELL2RBML_cjs.CancelledFailure("Activity cancelled")));
     }
   }
   settleChild(event, childId) {
@@ -562,7 +664,7 @@ var WorkflowExecution = class {
     let outcome;
     const failureValue = p["failure"];
     const failure = typeof failureValue === "object" && failureValue !== null && !Array.isArray(failureValue) ? failureValue : void 0;
-    const wrap = (cause) => new chunkFMSW2HDF_cjs.ChildRunFailure(
+    const wrap = (cause) => new chunkELL2RBML_cjs.ChildRunFailure(
       `Child run ${childId} ${event.type.slice("CHILD_RUN_".length).toLowerCase().replace("_", " ")}: ${cause.message}`,
       childId,
       child.runId,
@@ -576,18 +678,18 @@ var WorkflowExecution = class {
         outcome = {
           ok: false,
           error: wrap(
-            failure ? chunkFMSW2HDF_cjs.failureToError(failure) : new chunkFMSW2HDF_cjs.ApplicationError("Child failed", { errorType: "UNKNOWN" })
+            failure ? chunkELL2RBML_cjs.failureToError(failure) : new chunkELL2RBML_cjs.ApplicationError("Child failed", { errorType: "UNKNOWN" })
           )
         };
         break;
       case "CHILD_RUN_CANCELLED":
-        outcome = { ok: false, error: wrap(new chunkFMSW2HDF_cjs.CancelledFailure("Child run cancelled")) };
+        outcome = { ok: false, error: wrap(new chunkELL2RBML_cjs.CancelledFailure("Child run cancelled")) };
         break;
       case "CHILD_RUN_TERMINATED":
         outcome = {
           ok: false,
           error: wrap(
-            new chunkFMSW2HDF_cjs.TerminatedFailure(typeof p["reason"] === "string" ? p["reason"] : "Terminated")
+            new chunkELL2RBML_cjs.TerminatedFailure(typeof p["reason"] === "string" ? p["reason"] : "Terminated")
           )
         };
         break;
@@ -595,7 +697,7 @@ var WorkflowExecution = class {
         const timeoutType = typeof p["timeoutType"] === "string" ? p["timeoutType"] : "WORKFLOW_RUN";
         outcome = {
           ok: false,
-          error: wrap(new chunkFMSW2HDF_cjs.TimeoutFailure(`Child run timed out (${timeoutType})`, timeoutType))
+          error: wrap(new chunkELL2RBML_cjs.TimeoutFailure(`Child run timed out (${timeoutType})`, timeoutType))
         };
       }
     }
@@ -618,7 +720,7 @@ var WorkflowExecution = class {
   dispatchSignal(name, payload) {
     const handler = this.signalHandlers.get(name);
     if (handler) {
-      this.runHandler(() => handler(payload));
+      this.runHandler(() => handler(payload), name, this.signalPolicies.get(name));
       return;
     }
     const waiters = this.signalWaiters.get(name);
@@ -630,7 +732,7 @@ var WorkflowExecution = class {
     }
     if (this.defaultSignalHandler) {
       const fallback = this.defaultSignalHandler;
-      this.runHandler(() => fallback(name, payload));
+      this.runHandler(() => fallback(name, payload), name, this.defaultSignalPolicy);
       return;
     }
     const buffer = this.signalBuffers.get(name) ?? [];
@@ -646,7 +748,7 @@ var WorkflowExecution = class {
     if (position >= 0) this.signalOrder.splice(position, 1);
     return payload;
   }
-  runHandler(call) {
+  runHandler(call, name, policy = "WARN_AND_ABANDON") {
     let result;
     try {
       result = call();
@@ -656,17 +758,40 @@ var WorkflowExecution = class {
     }
     if (result instanceof Promise) {
       this.runningHandlers += 1;
-      result.then(
-        () => {
-          this.runningHandlers -= 1;
-        },
-        (error) => {
-          this.runningHandlers -= 1;
-          this.onWorkflowError(error);
-        }
-      );
+      const entry = this.running.get(name) ?? { count: 0, policy };
+      entry.count += 1;
+      entry.policy = policy;
+      this.running.set(name, entry);
+      const done = () => {
+        this.runningHandlers -= 1;
+        entry.count -= 1;
+        if (entry.count === 0) this.running.delete(name);
+      };
+      result.then(done, (error) => {
+        done();
+        this.onWorkflowError(error);
+      });
     }
   }
+  /**
+   * 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.
+   */
+  checkUnfinishedHandlers(command) {
+    if (this.replaying || command.type === "CANCEL_WORKFLOW") return;
+    const unfinished = [...this.running.entries()].filter(([, entry]) => entry.count > 0 && entry.policy === "WARN_AND_ABANDON").map(([name, entry]) => ({ kind: "signal", name, count: entry.count })).sort((a, b) => a.name < b.name ? -1 : a.name > b.name ? 1 : 0);
+    if (unfinished.length === 0) return;
+    this.unfinished = unfinished;
+    const total = unfinished.reduce((sum, entry) => sum + entry.count, 0);
+    this.logs.push({
+      level: "warn",
+      message: `The workflow finished while ${total} signal handler${total === 1 ? " was" : "s were"} still running (${unfinished.map((entry) => `${entry.name} x${entry.count}`).join(
+        ", "
+      )}); await ctx.allHandlersFinished() before returning, or set unfinishedPolicy: 'ABANDON' on the handler`,
+      data: unfinished.map((entry) => ({ kind: entry.kind, name: entry.name, count: entry.count }))
+    });
+  }
   // ---- the workflow function ------------------------------------------------
   startFunction(input) {
     let promise;
@@ -705,11 +830,11 @@ var WorkflowExecution = class {
       return;
     }
     const name = errorName(error);
-    if (error instanceof chunkFMSW2HDF_cjs.DeterminismViolation || name === "DeterminismViolation") {
+    if (error instanceof chunkELL2RBML_cjs.DeterminismViolation || name === "DeterminismViolation") {
       this.failTask("NON_DETERMINISM", messageOf(error), stackTextOf(error), void 0, name);
       return;
     }
-    if (error instanceof chunkFMSW2HDF_cjs.HistoryLimitExceeded) {
+    if (error instanceof chunkELL2RBML_cjs.HistoryLimitExceeded) {
       this.failTask("HISTORY_LIMIT", messageOf(error), stackTextOf(error));
       return;
     }
@@ -717,16 +842,16 @@ var WorkflowExecution = class {
       this.failTask("ISOLATE_MEMORY", messageOf(error), stackTextOf(error), void 0, name);
       return;
     }
-    if (error instanceof chunkFMSW2HDF_cjs.PhaseCFeatureError) {
+    if (error instanceof chunkELL2RBML_cjs.PhaseCFeatureError) {
       this.failTask("UNSUPPORTED_COMMAND", messageOf(error), stackTextOf(error));
       return;
     }
-    if (this.cancelRequested && chunkFMSW2HDF_cjs.isCancellation(error)) {
+    if (this.cancelRequested && chunkELL2RBML_cjs.isCancellation(error)) {
       this.pushTerminal({ type: "CANCEL_WORKFLOW" });
       return;
     }
-    if (chunkFMSW2HDF_cjs.isRunFailure(error) || this.isFailureType(error)) {
-      this.pushTerminal({ type: "FAIL_WORKFLOW", failure: chunkFMSW2HDF_cjs.errorToFailure(error) });
+    if (chunkELL2RBML_cjs.isRunFailure(error) || this.isFailureType(error)) {
+      this.pushTerminal({ type: "FAIL_WORKFLOW", failure: chunkELL2RBML_cjs.errorToFailure(error) });
       return;
     }
     this.failTask(
@@ -748,8 +873,8 @@ var WorkflowExecution = class {
    */
   checkLimit() {
     const events = this.historyLength + this.commands.length;
-    if (events >= this.limitEvents * chunk623FVQSN_cjs.HISTORY_LIMIT_EXCEEDED_RATIO || this.historyBytes >= this.limitBytes * chunk623FVQSN_cjs.HISTORY_LIMIT_EXCEEDED_RATIO)
-      throw new chunkFMSW2HDF_cjs.HistoryLimitExceeded(
+    if (events >= this.limitEvents * chunk3FIDHONL_cjs.HISTORY_LIMIT_EXCEEDED_RATIO || this.historyBytes >= this.limitBytes * chunk3FIDHONL_cjs.HISTORY_LIMIT_EXCEEDED_RATIO)
+      throw new chunkELL2RBML_cjs.HistoryLimitExceeded(
         `The history has ${events} events and ${this.historyBytes} bytes, past 95 % of its limit (${this.limitEvents} events, ${this.limitBytes} bytes); continue as new`
       );
   }
@@ -764,9 +889,10 @@ var WorkflowExecution = class {
     if (this.closed || this.failure) return;
     this.commands.push(command);
     this.closed = true;
+    this.checkUnfinishedHandlers(command);
   }
   stack() {
-    return this.captureStacks ? captureStack() : void 0;
+    return this.captureStacks ? chunkQ4MWQNJK_cjs.captureStack() : void 0;
   }
   never() {
     return new Promise(() => void 0);
@@ -774,8 +900,8 @@ var WorkflowExecution = class {
   scheduleActivity(scope, operation, options) {
     if (typeof operation !== "object" || operation === null || typeof operation.nodeType !== "string")
       throw new TypeError("ctx.run needs a node operation (from nodes.* or the generated clients)");
-    if (operation.role === "trigger" || !chunk2J6TF7YI_cjs.isActivityNodeTypeAllowed(operation.nodeType))
-      throw new chunkFMSW2HDF_cjs.ApplicationError(
+    if (operation.role === "trigger" || !chunk3FIDHONL_cjs.isActivityNodeTypeAllowed(operation.nodeType))
+      throw new chunkELL2RBML_cjs.ApplicationError(
         `${operation.nodeType} cannot run as a durable activity: only store and registry nodes and internal:http, internal:datatable, internal:set and internal:code can`,
         { type: "durable.activityTypeNotAllowed", errorType: "VALIDATION", nonRetryable: true }
       );
@@ -790,14 +916,14 @@ var WorkflowExecution = class {
       nodeType: operation.nodeType,
       operation: operationName,
       args: toJson(options.args, `The args of ${operation.nodeType}`),
-      retry: chunkP6TA5EZT_cjs.explicitRetryPolicy(options.retry)
+      retry: chunkYHBVMOMK_cjs.explicitRetryPolicy(options.retry)
     };
     if (nodeVersion !== void 0) command.nodeVersion = nodeVersion;
     if (options.connection !== void 0) command.connection = options.connection;
-    const startToClose = chunkFMSW2HDF_cjs.optionalMs(options.startToCloseTimeout, "startToCloseTimeout");
-    const scheduleToClose = chunkFMSW2HDF_cjs.optionalMs(options.scheduleToCloseTimeout, "scheduleToCloseTimeout");
-    const scheduleToStart = chunkFMSW2HDF_cjs.optionalMs(options.scheduleToStartTimeout, "scheduleToStartTimeout");
-    const heartbeat = chunkFMSW2HDF_cjs.optionalMs(options.heartbeatTimeout, "heartbeatTimeout");
+    const startToClose = chunkJ3PYFGKA_cjs.optionalMs(options.startToCloseTimeout, "startToCloseTimeout");
+    const scheduleToClose = chunkJ3PYFGKA_cjs.optionalMs(options.scheduleToCloseTimeout, "scheduleToCloseTimeout");
+    const scheduleToStart = chunkJ3PYFGKA_cjs.optionalMs(options.scheduleToStartTimeout, "scheduleToStartTimeout");
+    const heartbeat = chunkJ3PYFGKA_cjs.optionalMs(options.heartbeatTimeout, "heartbeatTimeout");
     if (startToClose !== void 0) command.startToCloseTimeout = startToClose;
     if (scheduleToClose !== void 0) command.scheduleToCloseTimeout = scheduleToClose;
     if (scheduleToStart !== void 0) command.scheduleToStartTimeout = scheduleToStart;
@@ -808,7 +934,7 @@ var WorkflowExecution = class {
     if (options.runOn !== void 0) command.runOn = options.runOn;
     if (options.headers !== void 0) command.headers = { ...options.headers };
     if (scope.consideredCancelled)
-      return Promise.reject(new chunkFMSW2HDF_cjs.CancelledFailure("Scope is cancelled"));
+      return Promise.reject(new chunkELL2RBML_cjs.CancelledFailure("Scope is cancelled"));
     if (!this.push(command)) return this.never();
     this.issued.add(`activity:${activityId}`);
     return new Promise((resolve, reject) => {
@@ -824,12 +950,12 @@ var WorkflowExecution = class {
       if (stack !== void 0) entry.stack = stack;
       entry.release = scope.onCancel(() => {
         if (!this.activities.has(activityId)) return;
-        const cancelled = new chunkFMSW2HDF_cjs.ActivityFailure(
+        const cancelled = new chunkELL2RBML_cjs.ActivityFailure(
           `Activity ${activityId} cancelled`,
           activityId,
           entry.nodeType,
           entry.operation,
-          new chunkFMSW2HDF_cjs.CancelledFailure("Activity cancelled")
+          new chunkELL2RBML_cjs.CancelledFailure("Activity cancelled")
         );
         if (cancellationType !== "ABANDON")
           this.push({ type: "REQUEST_CANCEL_ACTIVITY", activityId });
@@ -841,6 +967,110 @@ var WorkflowExecution = class {
       this.activities.set(activityId, entry);
     });
   }
+  /**
+   * `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(scope, operation, options) {
+    if (typeof operation === "function")
+      throw new chunkELL2RBML_cjs.PhaseCFeatureError("ctx.localActivity with a function (user local activities)");
+    if (typeof operation !== "object" || operation === null || typeof operation.nodeType !== "string")
+      throw new TypeError(
+        "ctx.localActivity needs a node operation (from nodes.* or the generated clients)"
+      );
+    const descriptor = operation;
+    if (descriptor.role === "trigger" || !chunk3FIDHONL_cjs.isActivityNodeTypeAllowed(descriptor.nodeType))
+      throw new chunkELL2RBML_cjs.ApplicationError(
+        `${descriptor.nodeType} cannot run as a durable activity: only store and registry nodes and internal:http, internal:datatable, internal:set and internal:code can`,
+        { type: "durable.activityTypeNotAllowed", errorType: "VALIDATION", nonRetryable: true }
+      );
+    if (typeof options !== "object" || options === null)
+      throw new TypeError("ctx.localActivity needs options with args");
+    const timeout = options.startToCloseTimeout === void 0 ? chunk3FIDHONL_cjs.LOCAL_ACTIVITY_MAX_TIMEOUT_MS : chunkJ3PYFGKA_cjs.toMs(options.startToCloseTimeout, "startToCloseTimeout");
+    if (timeout < 1 || timeout > chunk3FIDHONL_cjs.LOCAL_ACTIVITY_MAX_TIMEOUT_MS)
+      throw new TypeError(
+        `A local activity's startToCloseTimeout must be between 1 ms and 30 s (got ${timeout} ms); use ctx.run for longer calls`
+      );
+    const localActivityId = this.ids.next("l");
+    const operationName = options.operation ?? descriptor.operation ?? "execute";
+    const nodeVersion = options.nodeVersion ?? descriptor.version;
+    const retry = chunkYHBVMOMK_cjs.explicitRetryPolicy(options.retry);
+    const args = toJson(options.args, `The args of ${descriptor.nodeType}`);
+    if (scope.consideredCancelled)
+      return Promise.reject(new chunkELL2RBML_cjs.CancelledFailure("Scope is cancelled"));
+    const label = `local activity ${localActivityId} (${descriptor.nodeType} ${operationName})`;
+    const wrap = (cause) => new chunkELL2RBML_cjs.ActivityFailure(
+      `Local activity ${localActivityId} (${descriptor.nodeType} ${operationName}) failed: ${cause.message}`,
+      localActivityId,
+      descriptor.nodeType,
+      operationName,
+      cause
+    );
+    const record = (outcome) => {
+      const command = {
+        type: "RECORD_LOCAL_ACTIVITY",
+        localActivityId,
+        attempts: Math.max(1, Math.round(outcome.attempts)),
+        nodeType: descriptor.nodeType,
+        operation: operationName,
+        ...outcome.failure !== void 0 ? { failure: outcome.failure } : { result: outcome.result ?? null }
+      };
+      if (options.summary !== void 0) command.summary = options.summary;
+      if (!this.push(command)) return this.never();
+      if (outcome.failure !== void 0)
+        return Promise.reject(wrap(chunkELL2RBML_cjs.failureToError(outcome.failure)));
+      return Promise.resolve(outcome.result ?? null);
+    };
+    const replayed = this.replaying;
+    if (replayed) {
+      const recorded = this.recordedLocalActivities.get(localActivityId);
+      if (recorded !== void 0) return record(recorded);
+    }
+    const given = replayed ? void 0 : this.localActivityResults.get(localActivityId);
+    let attempt = 1;
+    let backoffMs = 0;
+    if (given !== void 0) {
+      if (given.failure === void 0) return record(given);
+      const decision = chunkYHBVMOMK_cjs.computeRetryDelay(retry, given.attempts, given.failure);
+      if (!decision.retry) return record(given);
+      attempt = given.attempts + 1;
+      backoffMs = decision.delayMs;
+    }
+    const request = {
+      localActivityId,
+      kind: "node",
+      nodeType: descriptor.nodeType,
+      operation: operationName,
+      args,
+      retry,
+      startToCloseTimeout: timeout,
+      attempt,
+      backoffMs
+    };
+    if (nodeVersion !== void 0) request.nodeVersion = nodeVersion;
+    if (options.connection !== void 0) request.connection = options.connection;
+    if (options.summary !== void 0) request.summary = options.summary;
+    return new Promise((resolve, reject) => {
+      const entry = {
+        resolve,
+        reject,
+        description: label,
+        request,
+        replayed
+      };
+      const stack = this.stack();
+      if (stack !== void 0) entry.stack = stack;
+      entry.release = scope.onCancel(() => {
+        if (!this.localActivities.delete(localActivityId)) return;
+        reject(wrap(new chunkELL2RBML_cjs.CancelledFailure("Local activity cancelled")));
+      });
+      this.localActivities.set(localActivityId, entry);
+    });
+  }
   startTimer(scope, durationMs, summary) {
     return this.timer(scope, durationMs, summary).promise;
   }
@@ -848,7 +1078,7 @@ var WorkflowExecution = class {
   timer(scope, durationMs, summary) {
     if (durationMs <= 0) return { promise: Promise.resolve() };
     if (scope.consideredCancelled)
-      return { promise: Promise.reject(new chunkFMSW2HDF_cjs.CancelledFailure("Scope is cancelled")) };
+      return { promise: Promise.reject(new chunkELL2RBML_cjs.CancelledFailure("Scope is cancelled")) };
     const timerId = this.ids.next("t");
     const command = {
       type: "START_TIMER",
@@ -870,7 +1100,7 @@ var WorkflowExecution = class {
         if (!this.timers.has(timerId)) return;
         this.timers.delete(timerId);
         this.push({ type: "CANCEL_TIMER", timerId });
-        reject(new chunkFMSW2HDF_cjs.CancelledFailure("Timer cancelled"));
+        reject(new chunkELL2RBML_cjs.CancelledFailure("Timer cancelled"));
       });
       this.timers.set(timerId, entry);
     });
@@ -888,14 +1118,14 @@ var WorkflowExecution = class {
   condition(scope, predicate, timeout) {
     if (predicate()) return Promise.resolve(true);
     if (scope.consideredCancelled)
-      return Promise.reject(new chunkFMSW2HDF_cjs.CancelledFailure("Scope is cancelled"));
+      return Promise.reject(new chunkELL2RBML_cjs.CancelledFailure("Scope is cancelled"));
     return new Promise((resolve, reject) => {
       const condition = { predicate, resolve, reject };
       const stack = this.stack();
       if (stack !== void 0) condition.stack = stack;
       this.conditions.push(condition);
       if (timeout !== void 0) {
-        const timer = this.timer(scope, chunkFMSW2HDF_cjs.toMs(timeout, "condition timeout"), void 0);
+        const timer = this.timer(scope, chunkJ3PYFGKA_cjs.toMs(timeout, "condition timeout"), void 0);
         if (timer.timerId !== void 0) condition.timerId = timer.timerId;
         timer.promise.then(
           () => {
@@ -911,7 +1141,7 @@ var WorkflowExecution = class {
         if (!this.conditions.includes(condition)) return;
         this.conditions = this.conditions.filter((entry) => entry !== condition);
         this.cancelOwnTimer(condition.timerId);
-        reject(new chunkFMSW2HDF_cjs.CancelledFailure("Condition cancelled"));
+        reject(new chunkELL2RBML_cjs.CancelledFailure("Condition cancelled"));
       });
     });
   }
@@ -939,7 +1169,7 @@ var WorkflowExecution = class {
     return fired;
   }
   signalReceived(scope, signal) {
-    const name = chunkFMSW2HDF_cjs.signalName(signal);
+    const name = chunkELL2RBML_cjs.signalName(signal);
     const buffered = this.takeBuffered(name);
     if (buffered !== void 0) return Promise.resolve(buffered);
     return new Promise((resolve, reject) => {
@@ -958,17 +1188,22 @@ var WorkflowExecution = class {
         const position = list.indexOf(entry);
         if (position < 0) return;
         list.splice(position, 1);
-        reject(new chunkFMSW2HDF_cjs.CancelledFailure("Signal wait cancelled"));
+        reject(new chunkELL2RBML_cjs.CancelledFailure("Signal wait cancelled"));
       });
     });
   }
-  onSignal(signal, handler) {
-    const name = chunkFMSW2HDF_cjs.signalName(signal);
+  onSignal(signal, handler, options = {}) {
+    if (typeof handler !== "function") throw new TypeError("ctx.onSignal needs a handler function");
+    const policy = options.unfinishedPolicy ?? "WARN_AND_ABANDON";
+    if (policy !== "WARN_AND_ABANDON" && policy !== "ABANDON")
+      throw new TypeError("unfinishedPolicy must be WARN_AND_ABANDON or ABANDON");
+    const name = chunkELL2RBML_cjs.signalName(signal);
     this.signalHandlers.set(name, handler);
+    this.signalPolicies.set(name, policy);
     let payload = this.takeBuffered(name);
     while (payload !== void 0) {
       const value = payload;
-      this.runHandler(() => handler(value));
+      this.runHandler(() => handler(value), name, policy);
       payload = this.takeBuffered(name);
     }
   }
@@ -978,15 +1213,43 @@ var WorkflowExecution = class {
     for (const entry of buffered) {
       if (this.signalHandlers.has(entry.name)) continue;
       const payload = this.takeBuffered(entry.name);
-      if (payload !== void 0) this.runHandler(() => handler(entry.name, payload));
+      if (payload !== void 0)
+        this.runHandler(() => handler(entry.name, payload), entry.name, this.defaultSignalPolicy);
     }
   }
+  /** The command target of a run handle (11 §2.1, §2.24). */
+  externalTarget(target) {
+    if (typeof target === "string") {
+      if (target === "") throw new TypeError("A run handle needs a run id");
+      return { runId: target };
+    }
+    if (typeof target === "object" && target !== null) {
+      if ("runId" in target && typeof target.runId === "string" && target.runId !== "")
+        return { runId: target.runId };
+      if ("workflowKey" in target && typeof target.workflowKey === "string" && target.workflowKey !== "" && typeof target.workflowId === "string" && target.workflowId !== "") {
+        const out = { workflowKey: target.workflowKey, workflowId: target.workflowId };
+        if (typeof target.firstRunId === "string" && target.firstRunId !== "")
+          out.firstRunId = target.firstRunId;
+        return out;
+      }
+    }
+    throw new TypeError("A run handle needs a run id or { workflowKey, workflowId }");
+  }
+  runHandle(target) {
+    const resolved = this.externalTarget(target);
+    return {
+      runId: "runId" in resolved ? resolved.runId : "",
+      ..."workflowId" in resolved ? { workflowKey: resolved.workflowKey, workflowId: resolved.workflowId } : {},
+      signal: (signal, payload) => this.signalExternal(resolved, chunkELL2RBML_cjs.signalName(signal), payload),
+      cancel: () => this.cancelExternal(resolved)
+    };
+  }
   childTarget(target) {
     if (typeof target === "string") {
       if (target === "") throw new TypeError("ctx.child needs a workflow key or function");
       return { workflowKey: target };
     }
-    if (chunkFQIHX7YI_cjs.isDurableWorkflow(target)) {
+    if (chunkJ3PYFGKA_cjs.isDurableWorkflow(target)) {
       const exportName = this.exportNames.get(target);
       if (exportName === void 0)
         throw new TypeError(
@@ -1006,6 +1269,12 @@ var WorkflowExecution = class {
     if (options.details !== void 0) opts["details"] = options.details;
     if (options.context !== void 0)
       opts["context"] = toJson(options.context, "The child context");
+    if (options.retry !== void 0)
+      opts["retry"] = toJson(chunkJ3PYFGKA_cjs.runRetryPolicyOf(options.retry), "The child retry policy");
+    if (options.versioningBehavior !== void 0)
+      opts["versioningBehavior"] = options.versioningBehavior;
+    if (options.idReusePolicy !== void 0) opts["idReusePolicy"] = options.idReusePolicy;
+    if (options.idConflictPolicy !== void 0) opts["idConflictPolicy"] = options.idConflictPolicy;
     const durations = [
       ["startDelay", "startDelay"],
       ["executionTimeout", "executionTimeout"],
@@ -1015,7 +1284,7 @@ var WorkflowExecution = class {
     for (const [key, name] of durations) {
       const value = options[key];
       if (value !== void 0 && (typeof value === "number" || typeof value === "string"))
-        opts[name] = chunkFMSW2HDF_cjs.toMs(value, name);
+        opts[name] = chunkJ3PYFGKA_cjs.toMs(value, name);
     }
     const command = {
       type: "START_CHILD_RUN",
@@ -1046,12 +1315,12 @@ var WorkflowExecution = class {
   onChildCancel(child, entry) {
     return () => {
       if (child.settled) return;
-      const type = child.cancellationType ?? chunkP6TA5EZT_cjs.CHILD_DEFAULT_CANCELLATION_TYPE;
-      const error = new chunkFMSW2HDF_cjs.ChildRunFailure(
+      const type = child.cancellationType ?? chunkRUQIMTN5_cjs.CHILD_DEFAULT_CANCELLATION_TYPE;
+      const error = new chunkELL2RBML_cjs.ChildRunFailure(
         `Child run ${child.childId} cancelled`,
         child.childId,
         child.runId,
-        new chunkFMSW2HDF_cjs.CancelledFailure("Child run cancelled")
+        new chunkELL2RBML_cjs.CancelledFailure("Child run cancelled")
       );
       if (type === "ABANDON") {
         child.result = void 0;
@@ -1096,10 +1365,10 @@ var WorkflowExecution = class {
       scope,
       target,
       options,
-      chunkP6TA5EZT_cjs.CHILD_DEFAULT_PARENT_CLOSE_POLICY.child
+      chunkRUQIMTN5_cjs.CHILD_DEFAULT_PARENT_CLOSE_POLICY.child
     );
     if (!child)
-      return scope.consideredCancelled ? Promise.reject(new chunkFMSW2HDF_cjs.CancelledFailure("Scope is cancelled")) : this.never();
+      return scope.consideredCancelled ? Promise.reject(new chunkELL2RBML_cjs.CancelledFailure("Scope is cancelled")) : this.never();
     return this.childResult(child);
   }
   childResult(child) {
@@ -1124,10 +1393,10 @@ var WorkflowExecution = class {
       scope,
       target,
       options,
-      chunkP6TA5EZT_cjs.CHILD_DEFAULT_PARENT_CLOSE_POLICY.startChild
+      chunkRUQIMTN5_cjs.CHILD_DEFAULT_PARENT_CLOSE_POLICY.startChild
     );
     if (!child)
-      return scope.consideredCancelled ? Promise.reject(new chunkFMSW2HDF_cjs.CancelledFailure("Scope is cancelled")) : this.never();
+      return scope.consideredCancelled ? Promise.reject(new chunkELL2RBML_cjs.CancelledFailure("Scope is cancelled")) : this.never();
     return new Promise((resolve, reject) => {
       const entry = {
         resolve,
@@ -1142,7 +1411,7 @@ var WorkflowExecution = class {
         childId: child.childId,
         runId: runId ?? child.runId ?? "",
         result: () => this.childResult(child),
-        signal: (signal, payload) => this.signalExternal({ childId: child.childId }, chunkFMSW2HDF_cjs.signalName(signal), payload),
+        signal: (signal, payload) => this.signalExternal({ childId: child.childId }, chunkELL2RBML_cjs.signalName(signal), payload),
         cancel: () => this.cancelExternal({ childId: child.childId })
       };
       return handle;
@@ -1235,19 +1504,18 @@ var WorkflowExecution = class {
     });
   }
   upsertContext(entries) {
-    this.push({
-      type: "UPSERT_CONTEXT",
-      entries: toJson(entries, "The context entries")
-    });
+    const json = toJson(entries, "The context entries");
+    if (!isJsonObject(json)) throw new TypeError("ctx.upsertContext takes an object");
+    if (this.push({ type: "UPSERT_CONTEXT", entries: json })) this.memo = { ...this.memo, ...json };
   }
   /** The request a `ctx.continueAsNew` call throws; the run ends with `CONTINUE_AS_NEW`. */
   continueAsNew(input, options) {
     const opts = {};
     if (options.taskQueue !== void 0) opts["taskQueue"] = options.taskQueue;
     if (options.retry !== void 0)
-      opts["retry"] = toJson(chunkP6TA5EZT_cjs.explicitRetryPolicy(options.retry), "retry");
+      opts["retry"] = toJson(chunkJ3PYFGKA_cjs.continueAsNewRetryOf(options.retry), "retry");
     if (options.workflowTaskTimeout !== void 0)
-      opts["workflowTaskTimeout"] = chunkFMSW2HDF_cjs.toMs(options.workflowTaskTimeout, "workflowTaskTimeout");
+      opts["workflowTaskTimeout"] = chunkJ3PYFGKA_cjs.toMs(options.workflowTaskTimeout, "workflowTaskTimeout");
     if (options.context !== void 0) opts["context"] = toJson(options.context, "context");
     if (options.versioningBehavior !== void 0)
       opts["versioningBehavior"] = options.versioningBehavior;
@@ -1257,7 +1525,7 @@ var WorkflowExecution = class {
     const scope = new Scope(parent, options.nonCancellable === true);
     let timerId;
     if (options.timeout !== void 0) {
-      const timer = this.timer(parent, chunkFMSW2HDF_cjs.toMs(options.timeout, "scope timeout"), void 0);
+      const timer = this.timer(parent, chunkJ3PYFGKA_cjs.toMs(options.timeout, "scope timeout"), void 0);
       timerId = timer.timerId;
       timer.promise.then(
         () => scope.cancel(),
@@ -1294,6 +1562,7 @@ var WorkflowExecution = class {
       out.push({ description: entry.description ?? fallback, stack: entry.stack ?? "" });
     };
     for (const entry of this.activities.values()) add(entry, "activity");
+    for (const entry of this.localActivities.values()) add(entry, "local activity");
     for (const entry of this.timers.values()) add(entry, "timer");
     for (const child of this.children.values()) {
       add(child.started, "child start");
@@ -1313,7 +1582,7 @@ var WorkflowExecution = class {
   }
   answerQueries() {
     return (this.request.queries ?? []).map((query) => {
-      if (!chunk623FVQSN_cjs.BUILT_IN_QUERIES.includes(query.name))
+      if (!chunk3FIDHONL_cjs.BUILT_IN_QUERIES.includes(query.name))
         return {
           queryId: query.queryId,
           error: `Unknown query ${String(query.name)}; custom queries are Phase C`
@@ -1333,7 +1602,7 @@ ${entry.stack}`).join("\n\n")
             sdk: { name: SDK_NAME, version: this.sdkVersion },
             stacks: this.pendingStacks().map((entry) => ({
               description: entry.description,
-              locations: parseStack(entry.stack).map((location) => {
+              locations: chunkQ4MWQNJK_cjs.parseStack(entry.stack).map((location) => {
                 const out = {};
                 if (location.filePath !== void 0) out["filePath"] = location.filePath;
                 if (location.line !== void 0) out["line"] = location.line;
@@ -1379,27 +1648,28 @@ ${entry.stack}`).join("\n\n")
     const scopeFn = ((fn, options = {}) => this.cancellationScope(scope(), fn, options));
     scopeFn.current = () => scope();
     const phaseC = (feature) => () => {
-      throw new chunkFMSW2HDF_cjs.PhaseCFeatureError(feature);
+      throw new chunkELL2RBML_cjs.PhaseCFeatureError(feature);
     };
     const context = {
       info: this.info,
       log: logger,
       run: (operation, options) => this.scheduleActivity(scope(), operation, options),
-      sleep: (duration, options = {}) => this.startTimer(scope(), chunkFMSW2HDF_cjs.toMs(duration, "sleep duration"), options.summary),
+      sleep: (duration, options = {}) => this.startTimer(scope(), chunkJ3PYFGKA_cjs.toMs(duration, "sleep duration"), options.summary),
       condition: (predicate, timeout) => this.condition(scope(), predicate, timeout),
       signalReceived: (signal) => this.signalReceived(scope(), signal),
-      onSignal: (signal, handler) => this.onSignal(signal, handler),
+      onSignal: ((signal, optionsOrHandler, maybeHandler) => {
+        if (typeof optionsOrHandler === "function") this.onSignal(signal, optionsOrHandler);
+        else if (maybeHandler !== void 0)
+          this.onSignal(signal, maybeHandler, optionsOrHandler ?? {});
+        else throw new TypeError("ctx.onSignal needs a handler function");
+      }),
       setDefaultSignalHandler: (handler) => this.setDefaultSignalHandler(handler),
       child: (target, options = {}) => this.child(scope(), target, options),
       startChild: (target, options = {}) => this.startChild(scope(), target, options),
-      signalRun: (runId, signal, payload) => this.signalExternal({ runId }, chunkFMSW2HDF_cjs.signalName(signal), payload),
-      signalParent: (signal, payload) => this.signalExternal({ parent: true }, chunkFMSW2HDF_cjs.signalName(signal), payload),
-      getRunHandle: (runId) => ({
-        runId,
-        signal: (signal, payload) => this.signalExternal({ runId }, chunkFMSW2HDF_cjs.signalName(signal), payload),
-        cancel: () => this.cancelExternal({ runId })
-      }),
-      cancelRun: (runId) => this.cancelExternal({ runId }),
+      signalRun: (target, signal, payload) => this.signalExternal(this.externalTarget(target), chunkELL2RBML_cjs.signalName(signal), payload),
+      signalParent: (signal, payload) => this.signalExternal({ parent: true }, chunkELL2RBML_cjs.signalName(signal), payload),
+      getRunHandle: (target) => this.runHandle(target),
+      cancelRun: (target) => this.cancelExternal(this.externalTarget(target)),
       now: () => this.clock,
       random: () => this.random(),
       uuid: () => chunkL24YIZY7_cjs.uuidFrom(this.random),
@@ -1428,7 +1698,7 @@ ${entry.stack}`).join("\n\n")
           }
         });
       },
-      isCancellation: (error) => chunkFMSW2HDF_cjs.isCancellation(error),
+      isCancellation: (error) => chunkELL2RBML_cjs.isCancellation(error),
       saga: () => {
         const compensations = [];
         return {
@@ -1453,9 +1723,7 @@ ${entry.stack}`).join("\n\n")
       },
       allHandlersFinished: () => this.allHandlersFinished(),
       activity: phaseC("ctx.activity (user activities)"),
-      localActivity: phaseC(
-        "ctx.localActivity (local activities)"
-      ),
+      localActivity: ((operation, options) => this.localActivity(scope(), operation, options)),
       handleQuery: phaseC("ctx.handleQuery (custom queries)"),
       handleUpdate: phaseC("ctx.handleUpdate (updates)"),
       upsertSearchAttributes: phaseC("ctx.upsertSearchAttributes (search attributes)")
@@ -1473,7 +1741,7 @@ function buildWorkflowRegistry(modules) {
   for (const [, namespace] of modules) {
     for (const exportName of Object.keys(namespace).sort()) {
       const value = namespace[exportName];
-      if (!chunkFQIHX7YI_cjs.isDurableWorkflow(value)) continue;
+      if (!chunkJ3PYFGKA_cjs.isDurableWorkflow(value)) continue;
       const existing = byName.get(exportName);
       if (existing && existing !== value) ambiguous.add(exportName);
       byName.set(exportName, value);
@@ -1484,7 +1752,7 @@ function buildWorkflowRegistry(modules) {
 }
 function failedResult(cause, message) {
   return {
-    protocol: chunk623FVQSN_cjs.HISTORY_PROTOCOL,
+    protocol: chunk3FIDHONL_cjs.HISTORY_PROTOCOL,
     outcome: "failed",
     commands: [],
     failure: { cause, message },
@@ -1517,14 +1785,14 @@ function createWorkflowRuntime(registry, shims = void 0) {
   const internalFailure = (error) => {
     const message = error instanceof Error ? error.message : String(error);
     const stack = error instanceof Error ? error.stack : void 0;
-    if (error instanceof chunkFMSW2HDF_cjs.HistoryLimitExceeded) execution?.failTask("HISTORY_LIMIT", message, stack);
-    else if (error instanceof chunkFMSW2HDF_cjs.DeterminismViolation || error instanceof Error && error.name === "DeterminismViolation")
+    if (error instanceof chunkELL2RBML_cjs.HistoryLimitExceeded) execution?.failTask("HISTORY_LIMIT", message, stack);
+    else if (error instanceof chunkELL2RBML_cjs.DeterminismViolation || error instanceof Error && error.name === "DeterminismViolation")
       execution?.failTask("NON_DETERMINISM", message, stack);
     else execution?.failTask("INTERNAL", message, stack);
   };
   return Object.freeze({
-    protocol: chunk623FVQSN_cjs.HISTORY_PROTOCOL,
-    sdkVersion: chunkFQIHX7YI_cjs.SDK_VERSION,
+    protocol: chunk3FIDHONL_cjs.HISTORY_PROTOCOL,
+    sdkVersion: chunkJ3PYFGKA_cjs.SDK_VERSION,
     start(requestJson) {
       shims?.detach();
       execution = void 0;
@@ -1539,10 +1807,10 @@ function createWorkflowRuntime(registry, shims = void 0) {
         );
         return;
       }
-      if (isObject(parsed) && parsed["protocol"] !== chunk623FVQSN_cjs.HISTORY_PROTOCOL) {
+      if (isObject(parsed) && parsed["protocol"] !== chunk3FIDHONL_cjs.HISTORY_PROTOCOL) {
         early = failedResult(
           "PROTOCOL_MISMATCH",
-          `This bundle speaks runtime protocol ${chunk623FVQSN_cjs.HISTORY_PROTOCOL}; the request uses ${String(parsed["protocol"])}`
+          `This bundle speaks runtime protocol ${chunk3FIDHONL_cjs.HISTORY_PROTOCOL}; the request uses ${String(parsed["protocol"])}`
         );
         return;
       }
@@ -1571,7 +1839,7 @@ function createWorkflowRuntime(registry, shims = void 0) {
           definition,
           exportNames: registry.exportNames,
           request,
-          sdkVersion: chunkFQIHX7YI_cjs.SDK_VERSION
+          sdkVersion: chunkJ3PYFGKA_cjs.SDK_VERSION
         });
         execution = created;
         shims?.attach({ now: () => created.now(), random: () => created.nextRandom() });