@cadenza.io/core 3.25.1 → 3.26.0

package/dist/index.d.mts

@@ -355,6 +355,7 @@ interface InquiryOptions {
     timeout?: number;
     rejectOnTimeout?: boolean;
     includePendingTasks?: boolean;
+    requireComplete?: boolean;
 }
 declare class InquiryBroker extends SignalEmitter {
     static instance_: InquiryBroker;
@@ -1070,14 +1071,14 @@ declare class Task extends SignalEmitter implements Graph {
      * @param {...string[]} signals - The array of signal names to observe.
      * @return {this} The current instance after adding the specified signals.
      */
-    doOn(...signals: string[]): this;
+    doOn(...signals: SignalDefinitionInput[]): this;
     /**
      * Registers the specified signals to be emitted after the Task executes successfully and attaches them for further processing.
      *
      * @param {...string} signals - The list of signals to be registered for emission.
      * @return {this} The current instance for method chaining.
      */
-    emits(...signals: string[]): this;
+    emits(...signals: SignalDefinitionInput[]): this;
     /**
      * Configures the instance to emit specified signals when the task execution fails.
      * A failure is defined as anything that does not return a successful result.
@@ -1085,14 +1086,14 @@ declare class Task extends SignalEmitter implements Graph {
      * @param {...string} signals - The names of the signals to emit upon failure.
      * @return {this} Returns the current instance for chaining.
      */
-    emitsOnFail(...signals: string[]): this;
+    emitsOnFail(...signals: SignalDefinitionInput[]): this;
     /**
      * Attaches a signal to the current context and emits metadata if the register flag is set.
      *
      * @param {...string} signals - The names of the signals to attach.
      * @return {void} This method does not return a value.
      */
-    attachSignal(...signals: string[]): Task;
+    attachSignal(...signals: SignalDefinitionInput[]): Task;
     /**
      * Unsubscribes the current instance from the specified signals.
      * This method removes the signals from the observedSignals set, unsubscribes
@@ -1485,6 +1486,22 @@ interface EmitOptions {
     throttleBatch?: number;
     flushStrategy?: string;
 }
+type SignalDeliveryMode = "single" | "broadcast";
+type SignalReceiverFilter = {
+    serviceNames?: string[];
+    serviceInstanceIds?: string[];
+    origins?: string[];
+    roles?: string[];
+    protocols?: string[];
+    runtimeStates?: string[];
+};
+type SignalMetadata = {
+    deliveryMode?: SignalDeliveryMode;
+    broadcastFilter?: SignalReceiverFilter | null;
+};
+type SignalDefinitionInput = string | ({
+    name: string;
+} & SignalMetadata);
 type FlushStrategyName = string;
 interface FlushStrategy {
     intervalMs: number;
@@ -1513,12 +1530,17 @@ declare class SignalBroker {
         registered: boolean;
     }>;
     emittedSignalsRegistry: Set<string>;
+    signalMetadataRegistry: Map<string, SignalMetadata>;
     private flushStrategies;
     private strategyData;
     private strategyTimers;
     private isStrategyFlushing;
     private readonly defaultStrategyName;
     constructor();
+    private resolveSignalMetadataKey;
+    private normalizeSignalMetadata;
+    setSignalMetadata(signal: string, metadata?: SignalMetadata | null): void;
+    getSignalMetadata(signal: string): SignalMetadata | undefined;
     logMemoryFootprint(label?: string): void;
     /**
      * Validates the provided signal name string to ensure it adheres to specific formatting rules.
@@ -1617,15 +1639,15 @@ declare class SignalBroker {
      * @param {string} signal - The name of the signal to be added.
      * @return {void} This method does not return any value.
      */
-    addSignal(signal: string): void;
+    addSignal(signal: string, metadata?: SignalMetadata | null): void;
     /**
      * Observes a signal with a routine/task.
      * @param signal The signal (e.g., 'domain.action', 'domain.*' for wildcards).
      * @param routineOrTask The observer.
      * @edge Duplicates ignored; supports wildcards for broad listening.
      */
-    observe(signal: string, routineOrTask: Task | GraphRoutine): void;
-    registerEmittedSignal(signal: string): void;
+    observe(signal: string, routineOrTask: Task | GraphRoutine, metadata?: SignalMetadata | null): void;
+    registerEmittedSignal(signal: string, metadata?: SignalMetadata | null): void;
     /**
      * Unsubscribes a routine/task from a signal.
      * @param signal The signal.
@@ -2082,6 +2104,7 @@ declare class Actor<D extends Record<string, any> = AnyObject, R = AnyObject> {
     private readonly stateByKey;
     private readonly sessionByKey;
     private readonly idempotencyByKey;
+    private readonly writeQueueByKey;
     private nextTaskBindingIndex;
     /**
      * Creates an actor instance and optionally materializes the default key.
@@ -2133,6 +2156,7 @@ declare class Actor<D extends Record<string, any> = AnyObject, R = AnyObject> {
     private ensureStateRecord;
     private touchSession;
     private runWithOptionalIdempotency;
+    private runWithPerKeyWriteSerialization;
     private getActiveIdempotencyRecord;
     private persistDurableStateIfConfigured;
     private emitActorCreatedSignal;
@@ -2666,4 +2690,4 @@ declare class Cadenza {
     static reset(): void;
 }
 
-export { Actor, type ActorConsistencyProfileName, type ActorDefinition, type ActorFactoryOptions, type ActorInvocationOptions, type ActorKeyDefinition, type ActorKind, type ActorLoadPolicy, type ActorRuntimeReadGuard, type ActorSpec, type ActorStateDefinition, type ActorStateReducer, type ActorStateStore, type ActorTaskBindingDefinition, type ActorTaskBindingOptions, type ActorTaskContext, type ActorTaskHandler, type ActorTaskMode, type ActorTaskRuntimeMetadata, type ActorWriteContract, type AnyObject, type CadenzaMode, type DebounceOptions, DebounceTask, type EmitOptions, EphemeralTask, type EphemeralTaskOptions, GraphContext, GraphRegistry, GraphRoutine, GraphRun, GraphRunner, type IdempotencyPolicy, InquiryBroker, type InquiryOptions, type Intent, META_ACTOR_SESSION_STATE_PERSIST_INTENT, type ResolvedRuntimeValidationPolicy, type RetryPolicy, type RuntimeValidationMode, type RuntimeValidationPolicy, type RuntimeValidationScope, type Schema, type SchemaConstraints, type SchemaDefinition, type SchemaType, type SessionPolicy, SignalBroker, SignalEmitter, Task, type TaskFunction, type TaskOptions, type TaskResult, type ThrottleTagGetter, Cadenza as default, getActorTaskRuntimeMetadata };
+export { Actor, type ActorConsistencyProfileName, type ActorDefinition, type ActorFactoryOptions, type ActorInvocationOptions, type ActorKeyDefinition, type ActorKind, type ActorLoadPolicy, type ActorRuntimeReadGuard, type ActorSpec, type ActorStateDefinition, type ActorStateReducer, type ActorStateStore, type ActorTaskBindingDefinition, type ActorTaskBindingOptions, type ActorTaskContext, type ActorTaskHandler, type ActorTaskMode, type ActorTaskRuntimeMetadata, type ActorWriteContract, type AnyObject, type CadenzaMode, type DebounceOptions, DebounceTask, type EmitOptions, EphemeralTask, type EphemeralTaskOptions, GraphContext, GraphRegistry, GraphRoutine, GraphRun, GraphRunner, type IdempotencyPolicy, InquiryBroker, type InquiryOptions, type Intent, META_ACTOR_SESSION_STATE_PERSIST_INTENT, type ResolvedRuntimeValidationPolicy, type RetryPolicy, type RuntimeValidationMode, type RuntimeValidationPolicy, type RuntimeValidationScope, type Schema, type SchemaConstraints, type SchemaDefinition, type SchemaType, type SessionPolicy, SignalBroker, type SignalDefinitionInput, type SignalDeliveryMode, SignalEmitter, type SignalMetadata, type SignalReceiverFilter, Task, type TaskFunction, type TaskOptions, type TaskResult, type ThrottleTagGetter, Cadenza as default, getActorTaskRuntimeMetadata };

package/dist/index.d.ts

@@ -355,6 +355,7 @@ interface InquiryOptions {
     timeout?: number;
     rejectOnTimeout?: boolean;
     includePendingTasks?: boolean;
+    requireComplete?: boolean;
 }
 declare class InquiryBroker extends SignalEmitter {
     static instance_: InquiryBroker;
@@ -1070,14 +1071,14 @@ declare class Task extends SignalEmitter implements Graph {
      * @param {...string[]} signals - The array of signal names to observe.
      * @return {this} The current instance after adding the specified signals.
      */
-    doOn(...signals: string[]): this;
+    doOn(...signals: SignalDefinitionInput[]): this;
     /**
      * Registers the specified signals to be emitted after the Task executes successfully and attaches them for further processing.
      *
      * @param {...string} signals - The list of signals to be registered for emission.
      * @return {this} The current instance for method chaining.
      */
-    emits(...signals: string[]): this;
+    emits(...signals: SignalDefinitionInput[]): this;
     /**
      * Configures the instance to emit specified signals when the task execution fails.
      * A failure is defined as anything that does not return a successful result.
@@ -1085,14 +1086,14 @@ declare class Task extends SignalEmitter implements Graph {
      * @param {...string} signals - The names of the signals to emit upon failure.
      * @return {this} Returns the current instance for chaining.
      */
-    emitsOnFail(...signals: string[]): this;
+    emitsOnFail(...signals: SignalDefinitionInput[]): this;
     /**
      * Attaches a signal to the current context and emits metadata if the register flag is set.
      *
      * @param {...string} signals - The names of the signals to attach.
      * @return {void} This method does not return a value.
      */
-    attachSignal(...signals: string[]): Task;
+    attachSignal(...signals: SignalDefinitionInput[]): Task;
     /**
      * Unsubscribes the current instance from the specified signals.
      * This method removes the signals from the observedSignals set, unsubscribes
@@ -1485,6 +1486,22 @@ interface EmitOptions {
     throttleBatch?: number;
     flushStrategy?: string;
 }
+type SignalDeliveryMode = "single" | "broadcast";
+type SignalReceiverFilter = {
+    serviceNames?: string[];
+    serviceInstanceIds?: string[];
+    origins?: string[];
+    roles?: string[];
+    protocols?: string[];
+    runtimeStates?: string[];
+};
+type SignalMetadata = {
+    deliveryMode?: SignalDeliveryMode;
+    broadcastFilter?: SignalReceiverFilter | null;
+};
+type SignalDefinitionInput = string | ({
+    name: string;
+} & SignalMetadata);
 type FlushStrategyName = string;
 interface FlushStrategy {
     intervalMs: number;
@@ -1513,12 +1530,17 @@ declare class SignalBroker {
         registered: boolean;
     }>;
     emittedSignalsRegistry: Set<string>;
+    signalMetadataRegistry: Map<string, SignalMetadata>;
     private flushStrategies;
     private strategyData;
     private strategyTimers;
     private isStrategyFlushing;
     private readonly defaultStrategyName;
     constructor();
+    private resolveSignalMetadataKey;
+    private normalizeSignalMetadata;
+    setSignalMetadata(signal: string, metadata?: SignalMetadata | null): void;
+    getSignalMetadata(signal: string): SignalMetadata | undefined;
     logMemoryFootprint(label?: string): void;
     /**
      * Validates the provided signal name string to ensure it adheres to specific formatting rules.
@@ -1617,15 +1639,15 @@ declare class SignalBroker {
      * @param {string} signal - The name of the signal to be added.
      * @return {void} This method does not return any value.
      */
-    addSignal(signal: string): void;
+    addSignal(signal: string, metadata?: SignalMetadata | null): void;
     /**
      * Observes a signal with a routine/task.
      * @param signal The signal (e.g., 'domain.action', 'domain.*' for wildcards).
      * @param routineOrTask The observer.
      * @edge Duplicates ignored; supports wildcards for broad listening.
      */
-    observe(signal: string, routineOrTask: Task | GraphRoutine): void;
-    registerEmittedSignal(signal: string): void;
+    observe(signal: string, routineOrTask: Task | GraphRoutine, metadata?: SignalMetadata | null): void;
+    registerEmittedSignal(signal: string, metadata?: SignalMetadata | null): void;
     /**
      * Unsubscribes a routine/task from a signal.
      * @param signal The signal.
@@ -2082,6 +2104,7 @@ declare class Actor<D extends Record<string, any> = AnyObject, R = AnyObject> {
     private readonly stateByKey;
     private readonly sessionByKey;
     private readonly idempotencyByKey;
+    private readonly writeQueueByKey;
     private nextTaskBindingIndex;
     /**
      * Creates an actor instance and optionally materializes the default key.
@@ -2133,6 +2156,7 @@ declare class Actor<D extends Record<string, any> = AnyObject, R = AnyObject> {
     private ensureStateRecord;
     private touchSession;
     private runWithOptionalIdempotency;
+    private runWithPerKeyWriteSerialization;
     private getActiveIdempotencyRecord;
     private persistDurableStateIfConfigured;
     private emitActorCreatedSignal;
@@ -2666,4 +2690,4 @@ declare class Cadenza {
     static reset(): void;
 }
 
-export { Actor, type ActorConsistencyProfileName, type ActorDefinition, type ActorFactoryOptions, type ActorInvocationOptions, type ActorKeyDefinition, type ActorKind, type ActorLoadPolicy, type ActorRuntimeReadGuard, type ActorSpec, type ActorStateDefinition, type ActorStateReducer, type ActorStateStore, type ActorTaskBindingDefinition, type ActorTaskBindingOptions, type ActorTaskContext, type ActorTaskHandler, type ActorTaskMode, type ActorTaskRuntimeMetadata, type ActorWriteContract, type AnyObject, type CadenzaMode, type DebounceOptions, DebounceTask, type EmitOptions, EphemeralTask, type EphemeralTaskOptions, GraphContext, GraphRegistry, GraphRoutine, GraphRun, GraphRunner, type IdempotencyPolicy, InquiryBroker, type InquiryOptions, type Intent, META_ACTOR_SESSION_STATE_PERSIST_INTENT, type ResolvedRuntimeValidationPolicy, type RetryPolicy, type RuntimeValidationMode, type RuntimeValidationPolicy, type RuntimeValidationScope, type Schema, type SchemaConstraints, type SchemaDefinition, type SchemaType, type SessionPolicy, SignalBroker, SignalEmitter, Task, type TaskFunction, type TaskOptions, type TaskResult, type ThrottleTagGetter, Cadenza as default, getActorTaskRuntimeMetadata };
+export { Actor, type ActorConsistencyProfileName, type ActorDefinition, type ActorFactoryOptions, type ActorInvocationOptions, type ActorKeyDefinition, type ActorKind, type ActorLoadPolicy, type ActorRuntimeReadGuard, type ActorSpec, type ActorStateDefinition, type ActorStateReducer, type ActorStateStore, type ActorTaskBindingDefinition, type ActorTaskBindingOptions, type ActorTaskContext, type ActorTaskHandler, type ActorTaskMode, type ActorTaskRuntimeMetadata, type ActorWriteContract, type AnyObject, type CadenzaMode, type DebounceOptions, DebounceTask, type EmitOptions, EphemeralTask, type EphemeralTaskOptions, GraphContext, GraphRegistry, GraphRoutine, GraphRun, GraphRunner, type IdempotencyPolicy, InquiryBroker, type InquiryOptions, type Intent, META_ACTOR_SESSION_STATE_PERSIST_INTENT, type ResolvedRuntimeValidationPolicy, type RetryPolicy, type RuntimeValidationMode, type RuntimeValidationPolicy, type RuntimeValidationScope, type Schema, type SchemaConstraints, type SchemaDefinition, type SchemaType, type SessionPolicy, SignalBroker, type SignalDefinitionInput, type SignalDeliveryMode, SignalEmitter, type SignalMetadata, type SignalReceiverFilter, Task, type TaskFunction, type TaskOptions, type TaskResult, type ThrottleTagGetter, Cadenza as default, getActorTaskRuntimeMetadata };

package/dist/index.js

@@ -1280,6 +1280,7 @@ var SignalBroker = class _SignalBroker {
     // TODO: Signals should be a class with a the observers, registered flag and other data.
     this.signalObservers = /* @__PURE__ */ new Map();
     this.emittedSignalsRegistry = /* @__PURE__ */ new Set();
+    this.signalMetadataRegistry = /* @__PURE__ */ new Map();
     // ── Flush Strategy Management ───────────────────────────────────────
     this.flushStrategies = /* @__PURE__ */ new Map();
     this.strategyData = /* @__PURE__ */ new Map();
@@ -1312,6 +1313,47 @@ var SignalBroker = class _SignalBroker {
   setVerbose(value) {
     this.verbose = value;
   }
+  resolveSignalMetadataKey(signal) {
+    const normalizedSignal = typeof signal === "string" ? signal.trim() : "";
+    if (!normalizedSignal) {
+      return "";
+    }
+    return normalizedSignal.split(":")[0] ?? normalizedSignal;
+  }
+  normalizeSignalMetadata(metadata) {
+    if (!metadata) {
+      return void 0;
+    }
+    const deliveryMode = metadata.deliveryMode === "broadcast" ? "broadcast" : "single";
+    const broadcastFilter = metadata.broadcastFilter && typeof metadata.broadcastFilter === "object" && !Array.isArray(metadata.broadcastFilter) ? merge_default({}, metadata.broadcastFilter) : null;
+    return {
+      deliveryMode,
+      broadcastFilter
+    };
+  }
+  setSignalMetadata(signal, metadata) {
+    const metadataKey = this.resolveSignalMetadataKey(signal);
+    if (!metadataKey) {
+      return;
+    }
+    const normalized = this.normalizeSignalMetadata(metadata);
+    if (!normalized) {
+      this.signalMetadataRegistry.delete(metadataKey);
+      return;
+    }
+    this.signalMetadataRegistry.set(metadataKey, normalized);
+  }
+  getSignalMetadata(signal) {
+    const metadataKey = this.resolveSignalMetadataKey(signal);
+    if (!metadataKey) {
+      return void 0;
+    }
+    const metadata = this.signalMetadataRegistry.get(metadataKey);
+    if (!metadata) {
+      return void 0;
+    }
+    return merge_default({}, metadata);
+  }
   // Dor debugging
   logMemoryFootprint(label = "current") {
     console.log(`[${label}] SignalBroker state sizes:`);
@@ -1396,7 +1438,8 @@ var SignalBroker = class _SignalBroker {
       const processedSignals = uniqueSignals.map((signal) => ({
         signal,
         data: {
-          registered: this.signalObservers.get(signal)?.registered ?? false
+          registered: this.signalObservers.get(signal)?.registered ?? false,
+          metadata: this.getSignalMetadata(signal) ?? null
         }
       }));
       return {
@@ -1746,10 +1789,11 @@ var SignalBroker = class _SignalBroker {
   execute(signal, context) {
     const isMeta = signal.includes("meta.");
     const isSubMeta = signal.includes("sub_meta.") || context.__isSubMeta;
+    const isReceivedSignalTransmission = context.__receivedSignalTransmission === true;
     const isMetric = context.__signalEmission?.isMetric;
+    const isNewTrace = !context.__signalEmission?.executionTraceId && !context.__metadata?.__executionTraceId && !context.__executionTraceId;
     const executionTraceId = context.__signalEmission?.executionTraceId ?? context.__metadata?.__executionTraceId ?? context.__executionTraceId ?? (0, import_uuid.v4)();
     if (!isSubMeta && (!isMeta || this.debug)) {
-      const isNewTrace = !context.__signalEmission?.executionTraceId && !context.__metadata?.__executionTraceId && !context.__executionTraceId;
       if (isNewTrace) {
         this.emit("sub_meta.signal_broker.new_trace", {
           data: {
@@ -1778,21 +1822,33 @@ var SignalBroker = class _SignalBroker {
       const signalParts = signal.split(":");
       const signalName = signalParts[0];
       const signalTag = signalParts.length > 1 ? signalParts[1] : null;
+      const existingSignalEmission = context.__signalEmission && typeof context.__signalEmission === "object" ? context.__signalEmission : {};
       context.__signalEmission = {
-        ...context.__signalEmission ?? {},
-        uuid: (0, import_uuid.v4)(),
-        executionTraceId,
-        signalName,
-        signalTag,
-        emittedAt: formatTimestamp(emittedAt),
-        consumed: false,
-        consumedBy: null,
-        isMeta
+        ...existingSignalEmission,
+        fullSignalName: existingSignalEmission.fullSignalName ?? signal,
+        uuid: existingSignalEmission.uuid ?? (0, import_uuid.v4)(),
+        executionTraceId: existingSignalEmission.executionTraceId ?? executionTraceId,
+        signalName: existingSignalEmission.signalName ?? signalName,
+        signalTag: existingSignalEmission.signalTag ?? signalTag,
+        emittedAt: existingSignalEmission.emittedAt ?? formatTimestamp(emittedAt),
+        consumed: existingSignalEmission.consumed ?? false,
+        consumedBy: existingSignalEmission.consumedBy ?? null,
+        isMeta: existingSignalEmission.isMeta ?? isMeta,
+        __traceCreatedBySignalBroker: existingSignalEmission.__traceCreatedBySignalBroker ?? isNewTrace
       };
-      this.emit("sub_meta.signal_broker.emitting_signal", { ...context });
+      if (!isReceivedSignalTransmission) {
+        if (isNewTrace) {
+          context.__traceCreatedBySignalBroker = true;
+        }
+        this.emit("sub_meta.signal_broker.emitting_signal", { ...context });
+        if (isNewTrace) {
+          delete context.__traceCreatedBySignalBroker;
+        }
+      }
     } else if (isSubMeta) {
       context.__isSubMeta = true;
     }
+    delete context.__receivedSignalTransmission;
     context.__metadata = {
       ...context.__metadata,
       __executionTraceId: executionTraceId
@@ -1856,8 +1912,11 @@ var SignalBroker = class _SignalBroker {
    * @param {string} signal - The name of the signal to be added.
    * @return {void} This method does not return any value.
    */
-  addSignal(signal) {
+  addSignal(signal, metadata) {
     let _signal = signal;
+    if (metadata) {
+      this.setSignalMetadata(signal, metadata);
+    }
     if (!this.signalObservers.has(_signal)) {
       this.validateSignalName(_signal);
       this.signalObservers.set(_signal, {
@@ -1887,11 +1946,14 @@ var SignalBroker = class _SignalBroker {
    * @param routineOrTask The observer.
    * @edge Duplicates ignored; supports wildcards for broad listening.
    */
-  observe(signal, routineOrTask) {
-    this.addSignal(signal);
+  observe(signal, routineOrTask, metadata) {
+    this.addSignal(signal, metadata);
     this.signalObservers.get(signal).tasks.add(routineOrTask);
   }
-  registerEmittedSignal(signal) {
+  registerEmittedSignal(signal, metadata) {
+    if (metadata) {
+      this.setSignalMetadata(signal, metadata);
+    }
     this.emittedSignalsRegistry.add(signal);
   }
   /**
@@ -1926,6 +1988,7 @@ var SignalBroker = class _SignalBroker {
     this.clearThrottleState();
     this.signalObservers.clear();
     this.emittedSignalsRegistry.clear();
+    this.signalMetadataRegistry.clear();
   }
   shutdown() {
     this.reset();
@@ -2334,6 +2397,27 @@ var SignalEmitter = class {
 };
 
 // src/graph/execution/GraphNode.ts
+function normalizeGraphErrorMessage(error) {
+  if (typeof error === "string") {
+    return error;
+  }
+  if (error instanceof Error) {
+    return error.message;
+  }
+  if (error && typeof error === "object") {
+    const record = error;
+    if (typeof record.__error === "string") {
+      return record.__error;
+    }
+    if (typeof record.error === "string") {
+      return record.error;
+    }
+    if (typeof record.message === "string") {
+      return record.message;
+    }
+  }
+  return String(error);
+}
 var GraphNode = class _GraphNode extends SignalEmitter {
   constructor(task, context, routineExecId, prevNodes = [], debug = false, verbose = false) {
     super(
@@ -2518,7 +2602,8 @@ var GraphNode = class _GraphNode extends SignalEmitter {
           {
             data: {
               taskExecutionId: this.id,
-              previousTaskExecutionId: node.id
+              previousTaskExecutionId: node.id,
+              executionTraceId: context.__metadata?.__executionTraceId ?? context.__executionTraceId ?? null
             },
             filter: {
               taskName: this.task.name,
@@ -2536,7 +2621,8 @@ var GraphNode = class _GraphNode extends SignalEmitter {
           {
             data: {
               taskExecutionId: this.id,
-              previousTaskExecutionId: context.__previousTaskExecutionId
+              previousTaskExecutionId: context.__previousTaskExecutionId,
+              executionTraceId: context.__metadata?.__executionTraceId ?? context.__executionTraceId ?? null
             },
             filter: {
               taskName: this.task.name,
@@ -2950,11 +3036,12 @@ var GraphNode = class _GraphNode extends SignalEmitter {
    * @return {void} This method does not return any value.
    */
   onError(error, errorData = {}) {
+    const normalizedError = normalizeGraphErrorMessage(error);
     this.result = {
       ...this.context.getFullContext(),
-      __error: `Node error: ${error}`,
+      __error: `Node error: ${normalizedError}`,
       __retries: this.retries,
-      error: `Node error: ${error}`,
+      error: `Node error: ${normalizedError}`,
       errored: true,
       returnedValue: this.result,
       ...errorData
@@ -3529,8 +3616,16 @@ var GraphRunner = class extends SignalEmitter {
     const isNewTrace = !context.__routineExecId && !context.__metadata?.__executionTraceId && !context.__executionTraceId;
     const executionTraceId = context.__metadata?.__executionTraceId ?? context.__executionTraceId ?? (0, import_uuid5.v4)();
     context.__executionTraceId = executionTraceId;
+    context.__traceCreatedByRunner = isNewTrace;
+    const isNewRoutine = !context.__routineExecId;
     const routineExecId = context.__routineExecId ?? (0, import_uuid5.v4)();
     context.__routineExecId = routineExecId;
+    const routineCreatedAt = formatTimestamp(Date.now());
+    context.__routineCreatedByRunner = isNewRoutine;
+    context.__routineName = routineName;
+    context.__routineVersion = routineVersion;
+    context.__routineCreatedAt = routineCreatedAt;
+    context.__routineIsMeta = isMeta;
     Cadenza.applyRuntimeValidationScopesToContext(
       context,
       routineName,
@@ -3565,8 +3660,7 @@ var GraphRunner = class extends SignalEmitter {
           executionTraceId,
           context: ctx.getContext(),
           metaContext: ctx.getMetadata(),
-          previousRoutineExecution: context.__localRoutineExecId ?? context.__metadata?.__routineExecId ?? null,
-          created: formatTimestamp(Date.now())
+          created: routineCreatedAt
         },
         __metadata: {
           __executionTraceId: executionTraceId
@@ -3799,6 +3893,7 @@ var Actor = class {
     this.stateByKey = /* @__PURE__ */ new Map();
     this.sessionByKey = /* @__PURE__ */ new Map();
     this.idempotencyByKey = /* @__PURE__ */ new Map();
+    this.writeQueueByKey = /* @__PURE__ */ new Map();
     this.nextTaskBindingIndex = 0;
     if (!spec.name || typeof spec.name !== "string") {
       throw new Error("Actor name must be a non-empty string");
@@ -3980,7 +4075,7 @@ var Actor = class {
         taskBindingId,
         actorKey,
         invocationOptions,
-        runTask
+        () => this.runWithPerKeyWriteSerialization(actorKey, mode, runTask)
       );
     };
     wrapped[ACTOR_TASK_METADATA] = {
@@ -4258,6 +4353,24 @@ var Actor = class {
     });
     return promise;
   }
+  runWithPerKeyWriteSerialization(actorKey, mode, runTask) {
+    if (mode === "read") {
+      return runTask();
+    }
+    const previous = this.writeQueueByKey.get(actorKey) ?? Promise.resolve();
+    let releaseCurrent;
+    const currentGate = new Promise((resolve) => {
+      releaseCurrent = resolve;
+    });
+    const currentTail = previous.catch(() => void 0).then(() => currentGate);
+    this.writeQueueByKey.set(actorKey, currentTail);
+    return previous.catch(() => void 0).then(runTask).finally(() => {
+      releaseCurrent();
+      if (this.writeQueueByKey.get(actorKey) === currentTail) {
+        this.writeQueueByKey.delete(actorKey);
+      }
+    });
+  }
   getActiveIdempotencyRecord(compositeKey) {
     const record = this.idempotencyByKey.get(compositeKey);
     if (!record) {
@@ -4275,23 +4388,25 @@ var Actor = class {
       return;
     }
     const timeoutMs = normalizePositiveInteger(this.spec.session?.persistenceTimeoutMs) ?? 5e3;
+    const persistenceContext = {
+      actor_name: this.spec.name,
+      actor_version: 1,
+      actor_key: actorKey,
+      durable_state: cloneForDurableState(durableState),
+      durable_version: durableVersion,
+      expires_at: null
+    };
     const response = await inquire(
       META_ACTOR_SESSION_STATE_PERSIST_INTENT,
-      {
-        actor_name: this.spec.name,
-        actor_version: 1,
-        actor_key: actorKey,
-        durable_state: cloneForDurableState(durableState),
-        durable_version: durableVersion,
-        expires_at: null
-      },
+      persistenceContext,
       {
         timeout: timeoutMs,
+        requireComplete: true,
         rejectOnTimeout: true
       }
     );
     if (!isObject2(response) || response.__success !== true || response.persisted !== true) {
-      const reason = isObject2(response) ? response.__error ?? response.error : void 0;
+      const reason = isObject2(response) ? response.__error ?? response.error ?? response.internalError ?? (response.errored === true ? `errored response keys: ${Object.keys(response).join(",")}` : response.failed === true ? `failed response keys: ${Object.keys(response).join(",")}` : void 0) : void 0;
       throw new Error(
         `Actor "${this.spec.name}" durable state persistence failed for key "${actorKey}"${reason ? `: ${String(reason)}` : ""}`
       );
@@ -4325,6 +4440,20 @@ var Actor = class {
 };
 
 // src/graph/definition/Task.ts
+function normalizeSignalDefinition(input) {
+  if (typeof input === "string") {
+    return {
+      name: input
+    };
+  }
+  return {
+    name: input.name,
+    metadata: {
+      deliveryMode: input.deliveryMode,
+      broadcastFilter: input.broadcastFilter ?? null
+    }
+  };
+}
 var Task = class _Task extends SignalEmitter {
   /**
    * Constructs an instance of the task with the specified properties and configuration options.
@@ -5145,9 +5274,10 @@ var Task = class _Task extends SignalEmitter {
    * @return {this} The current instance after adding the specified signals.
    */
   doOn(...signals) {
-    signals.forEach((signal) => {
+    signals.forEach((input) => {
+      const { name: signal, metadata } = normalizeSignalDefinition(input);
       if (this.observedSignals.has(signal)) return;
-      Cadenza.signalBroker.observe(signal, this);
+      Cadenza.signalBroker.observe(signal, this, metadata);
       this.observedSignals.add(signal);
       if (this.register) {
         this.emitWithMetadata("meta.task.observed_signal", {
@@ -5168,13 +5298,14 @@ var Task = class _Task extends SignalEmitter {
    * @return {this} The current instance for method chaining.
    */
   emits(...signals) {
-    signals.forEach((signal) => {
+    signals.forEach((input) => {
+      const { name: signal } = normalizeSignalDefinition(input);
       if (this.observedSignals.has(signal))
         throw new Error(
           `Detected signal loop for task ${this.name}. Signal name: ${signal}`
         );
       this.signalsToEmitAfter.add(signal);
-      this.attachSignal(signal);
+      this.attachSignal(input);
     });
     return this;
   }
@@ -5186,9 +5317,10 @@ var Task = class _Task extends SignalEmitter {
    * @return {this} Returns the current instance for chaining.
    */
   emitsOnFail(...signals) {
-    signals.forEach((signal) => {
+    signals.forEach((input) => {
+      const { name: signal } = normalizeSignalDefinition(input);
       this.signalsToEmitOnFail.add(signal);
-      this.attachSignal(signal);
+      this.attachSignal(input);
     });
     return this;
   }
@@ -5199,9 +5331,10 @@ var Task = class _Task extends SignalEmitter {
    * @return {void} This method does not return a value.
    */
   attachSignal(...signals) {
-    signals.forEach((signal) => {
+    signals.forEach((input) => {
+      const { name: signal, metadata } = normalizeSignalDefinition(input);
       this.emitsSignals.add(signal);
-      Cadenza.signalBroker.registerEmittedSignal(signal);
+      Cadenza.signalBroker.registerEmittedSignal(signal, metadata);
       if (this.register) {
         const data = {
           signals: {