@cadenza.io/core 3.28.0 → 3.28.1

package/dist/index.d.mts

@@ -946,6 +946,9 @@ declare class GraphNode extends SignalEmitter implements Graph {
      * @return {string} The tag retrieved from the task within the given context.
      */
     getTag(): string;
+    private classifyBusinessRoutineLifecycle;
+    private getBusinessRoutineLifecycleDecision;
+    private rememberBusinessRoutineLifecycleDecision;
     /**
      * Schedules the current node/task on the specified graph layer if applicable.
      *
@@ -2123,7 +2126,7 @@ interface ActorTaskContext<D extends Record<string, any>, R = AnyObject> {
 /**
  * Handler signature used by `actor.task(...)`.
  */
-type ActorTaskHandler<D extends Record<string, any>, R = AnyObject> = (context: ActorTaskContext<D, R>) => TaskResult | ActorStateReducer<D> | Promise<TaskResult | ActorStateReducer<D>>;
+type ActorTaskHandler<D extends Record<string, any>, R = AnyObject> = (context: ActorTaskContext<D, R>, emit: (signal: string, payload?: AnyObject) => void, inquire: (inquiry: string, context?: AnyObject, options?: InquiryOptions) => Promise<AnyObject>, tools: RuntimeTools, progressCallback: (progress: number) => void) => TaskResult | ActorStateReducer<D> | Promise<TaskResult | ActorStateReducer<D>>;
 interface ActorDurableStateHydration<D extends Record<string, any>> {
     durableState: D;
     durableVersion: number;

package/dist/index.d.ts

@@ -946,6 +946,9 @@ declare class GraphNode extends SignalEmitter implements Graph {
      * @return {string} The tag retrieved from the task within the given context.
      */
     getTag(): string;
+    private classifyBusinessRoutineLifecycle;
+    private getBusinessRoutineLifecycleDecision;
+    private rememberBusinessRoutineLifecycleDecision;
     /**
      * Schedules the current node/task on the specified graph layer if applicable.
      *
@@ -2123,7 +2126,7 @@ interface ActorTaskContext<D extends Record<string, any>, R = AnyObject> {
 /**
  * Handler signature used by `actor.task(...)`.
  */
-type ActorTaskHandler<D extends Record<string, any>, R = AnyObject> = (context: ActorTaskContext<D, R>) => TaskResult | ActorStateReducer<D> | Promise<TaskResult | ActorStateReducer<D>>;
+type ActorTaskHandler<D extends Record<string, any>, R = AnyObject> = (context: ActorTaskContext<D, R>, emit: (signal: string, payload?: AnyObject) => void, inquire: (inquiry: string, context?: AnyObject, options?: InquiryOptions) => Promise<AnyObject>, tools: RuntimeTools, progressCallback: (progress: number) => void) => TaskResult | ActorStateReducer<D> | Promise<TaskResult | ActorStateReducer<D>>;
 interface ActorDurableStateHydration<D extends Record<string, any>> {
     durableState: D;
     durableVersion: number;

package/dist/index.js

@@ -2584,6 +2584,38 @@ var GraphNode = class _GraphNode extends SignalEmitter {
   getTag() {
     return this.task.getTag(this.context);
   }
+  classifyBusinessRoutineLifecycle() {
+    const fullContext = this.context?.getFullContext?.() ?? {};
+    const metadata = fullContext.__metadata && typeof fullContext.__metadata === "object" ? fullContext.__metadata : {};
+    if (this.task.isMeta || this.task.isSubMeta || this.task.isHidden) {
+      return false;
+    }
+    if (fullContext.__isInquiry === true || fullContext.__isDeputy === true || metadata.__isInquiry === true || metadata.__isDeputy === true || metadata.__isSubMeta === true) {
+      return false;
+    }
+    return true;
+  }
+  getBusinessRoutineLifecycleDecision() {
+    const fullContext = this.context?.getFullContext?.() ?? {};
+    const metadata = this.context?.getMetadata?.() ?? {};
+    if (typeof metadata.__emitBusinessRoutineLifecycle === "boolean") {
+      return metadata.__emitBusinessRoutineLifecycle;
+    }
+    if (typeof fullContext.__emitBusinessRoutineLifecycle === "boolean") {
+      return fullContext.__emitBusinessRoutineLifecycle;
+    }
+    return this.classifyBusinessRoutineLifecycle();
+  }
+  rememberBusinessRoutineLifecycleDecision(value) {
+    const fullContext = this.context?.getFullContext?.();
+    const metadata = this.context?.getMetadata?.();
+    if (fullContext && typeof fullContext === "object") {
+      fullContext.__emitBusinessRoutineLifecycle = value;
+    }
+    if (metadata && typeof metadata === "object") {
+      metadata.__emitBusinessRoutineLifecycle = value;
+    }
+  }
   /**
    * Schedules the current node/task on the specified graph layer if applicable.
    *
@@ -2709,17 +2741,23 @@ var GraphNode = class _GraphNode extends SignalEmitter {
       this.executionStart = Date.now();
     }
     if (this.previousNodes.length === 0) {
-      this.emitMetricsWithMetadata(
-        "meta.node.started_routine_execution",
-        {
-          data: {
-            isRunning: true,
-            started: formatTimestamp(this.executionStart)
-          },
-          filter: { uuid: this.routineExecId }
-        },
-        { squash: true, squashId: this.routineExecId }
+      const shouldEmitBusinessRoutineLifecycle = this.getBusinessRoutineLifecycleDecision();
+      this.rememberBusinessRoutineLifecycleDecision(
+        shouldEmitBusinessRoutineLifecycle
       );
+      if (shouldEmitBusinessRoutineLifecycle) {
+        this.emitMetricsWithMetadata(
+          "meta.node.started_routine_execution",
+          {
+            data: {
+              isRunning: true,
+              started: formatTimestamp(this.executionStart)
+            },
+            filter: { uuid: this.routineExecId }
+          },
+          { squash: true, squashId: this.routineExecId }
+        );
+      }
     }
     if (this.debug && !this.task.isSubMeta && !this.context.getMetadata().__isSubMeta || this.verbose) {
       this.log();
@@ -2788,21 +2826,23 @@ var GraphNode = class _GraphNode extends SignalEmitter {
           `meta.node.graph_completed:${this.routineExecId}`,
           context2
         );
-      this.emitMetricsWithMetadata(
-        "meta.node.ended_routine_execution",
-        {
-          data: {
-            isRunning: false,
-            isComplete: true,
-            resultContext: this.context.getContext(),
-            metaResultContext: this.context.getMetadata(),
-            progress: 1,
-            ended: formatTimestamp(end)
+      if (this.getBusinessRoutineLifecycleDecision()) {
+        this.emitMetricsWithMetadata(
+          "meta.node.ended_routine_execution",
+          {
+            data: {
+              isRunning: false,
+              isComplete: true,
+              resultContext: this.context.getContext(),
+              metaResultContext: this.context.getMetadata(),
+              progress: 1,
+              ended: formatTimestamp(end)
+            },
+            filter: { uuid: this.routineExecId }
           },
-          filter: { uuid: this.routineExecId }
-        },
-        { squash: true, squashId: this.routineExecId }
-      );
+          { squash: true, squashId: this.routineExecId }
+        );
+      }
     }
     return end;
   }
@@ -3689,7 +3729,7 @@ var GraphRunner = class extends SignalEmitter {
       allTasks
     );
     const ctx = new GraphContext(context || {});
-    if (!isSubMeta) {
+    if (!isSubMeta && (!isMeta || this.debug)) {
       if (isNewTrace) {
         this.emitMetrics("meta.runner.new_trace", {
           data: {
@@ -4108,7 +4148,13 @@ var Actor = class {
           inquire: (inquiryName, inquiryContext = {}, options = {}) => inquire(inquiryName, inquiryContext, options),
           tools: resolvedTools
         };
-        const handlerResult = await handler(actorContext);
+        const handlerResult = await handler(
+          actorContext,
+          actorContext.emit,
+          actorContext.inquire,
+          resolvedTools,
+          resolvedProgressCallback
+        );
         if (invocationOptions.writeContract === "reducer" && typeof handlerResult === "function") {
           reduceDurableState(handlerResult);
         }