@makaio/framework 1.0.0-dev-1782480236258 → 1.0.0-dev-1783355411417

package/dist/{index-D4gn93gL.d.mts → index-3X0368CL.d.mts}

@@ -19,8 +19,8 @@ import { ExtensionWarningEntry, ExtensionWarningEntrySchema } from "@makaio/fram
  */
 declare const ComponentStateSchema: z.ZodEnum<{
   failed: "failed";
-  stopped: "stopped";
   discovered: "discovered";
+  stopped: "stopped";
   active: "active";
   skipped: "skipped";
   initializing: "initializing";
@@ -48,8 +48,8 @@ declare const ComponentInfoSchema: z.ZodObject<{
   displayName: z.ZodString;
   state: z.ZodEnum<{
     failed: "failed";
-    stopped: "stopped";
     discovered: "discovered";
+    stopped: "stopped";
     active: "active";
     skipped: "skipped";
     initializing: "initializing";
@@ -69,8 +69,8 @@ declare const ServiceInfoSchema: z.ZodObject<{
   displayName: z.ZodString;
   state: z.ZodEnum<{
     failed: "failed";
-    stopped: "stopped";
     discovered: "discovered";
+    stopped: "stopped";
     active: "active";
     skipped: "skipped";
     initializing: "initializing";
@@ -91,8 +91,8 @@ declare const ExtensionInfoSchema: z.ZodObject<{
   displayName: z.ZodString;
   state: z.ZodEnum<{
     failed: "failed";
-    stopped: "stopped";
     discovered: "discovered";
+    stopped: "stopped";
     active: "active";
     skipped: "skipped";
     initializing: "initializing";
@@ -139,16 +139,16 @@ declare const ExtensionNamespace: _$_makaio_core0.BusNamespaceDefinition<"kernel
     displayName: z.ZodString;
     from: z.ZodEnum<{
       failed: "failed";
-      stopped: "stopped";
       discovered: "discovered";
+      stopped: "stopped";
       active: "active";
       skipped: "skipped";
       initializing: "initializing";
     }>;
     to: z.ZodEnum<{
       failed: "failed";
-      stopped: "stopped";
       discovered: "discovered";
+      stopped: "stopped";
       active: "active";
       skipped: "skipped";
       initializing: "initializing";
@@ -182,8 +182,8 @@ declare const ExtensionNamespace: _$_makaio_core0.BusNamespaceDefinition<"kernel
         displayName: z.ZodString;
         state: z.ZodEnum<{
           failed: "failed";
-          stopped: "stopped";
           discovered: "discovered";
+          stopped: "stopped";
           active: "active";
           skipped: "skipped";
           initializing: "initializing";
@@ -220,8 +220,8 @@ declare const ExtensionNamespace: _$_makaio_core0.BusNamespaceDefinition<"kernel
         displayName: z.ZodString;
         state: z.ZodEnum<{
           failed: "failed";
-          stopped: "stopped";
           discovered: "discovered";
+          stopped: "stopped";
           active: "active";
           skipped: "skipped";
           initializing: "initializing";
@@ -594,16 +594,16 @@ declare const ExtensionSubjects: _$_makaio_core0.BusSubjects<_$_makaio_core0.Fla
     displayName: z.ZodString;
     from: z.ZodEnum<{
       failed: "failed";
-      stopped: "stopped";
       discovered: "discovered";
+      stopped: "stopped";
       active: "active";
       skipped: "skipped";
       initializing: "initializing";
     }>;
     to: z.ZodEnum<{
       failed: "failed";
-      stopped: "stopped";
       discovered: "discovered";
+      stopped: "stopped";
       active: "active";
       skipped: "skipped";
       initializing: "initializing";
@@ -637,8 +637,8 @@ declare const ExtensionSubjects: _$_makaio_core0.BusSubjects<_$_makaio_core0.Fla
         displayName: z.ZodString;
         state: z.ZodEnum<{
           failed: "failed";
-          stopped: "stopped";
           discovered: "discovered";
+          stopped: "stopped";
           active: "active";
           skipped: "skipped";
           initializing: "initializing";
@@ -675,8 +675,8 @@ declare const ExtensionSubjects: _$_makaio_core0.BusSubjects<_$_makaio_core0.Fla
         displayName: z.ZodString;
         state: z.ZodEnum<{
           failed: "failed";
-          stopped: "stopped";
           discovered: "discovered";
+          stopped: "stopped";
           active: "active";
           skipped: "skipped";
           initializing: "initializing";

package/dist/{index-gAFwNiJT.d.mts → index-BYfSAJRC.d.mts}

@@ -201,6 +201,16 @@ type TurnCompleteCallback = (turn: Turn$1, result: TurnCompletionResult) => Prom
  * `TurnStorageSubjects.create` is unhandled, synthetic IDs are generated
  * locally. When `TurnStorageSubjects.complete` is unhandled, the turn is
  * still cleared from memory and `session.turn.completed` is emitted.
+ *
+ * **Persist-before-emit barrier:** `session.turn.completed` promises the
+ * four-point consumer contract, including messages being queryable via
+ * `storage:message.getByTurn`. Message persistence (SessionBridge) and turn
+ * completion both react to `agent.complete`, and the bus runs event handlers
+ * in parallel — so before emitting, `completeTurn` awaits
+ * `storage:message.stored` confirmations for the turn's assistant messages
+ * (bus-mediated: the manager holds no reference to SessionBridge). The wait
+ * is bounded by {@link TURN_COMPLETION_PERSISTENCE_TIMEOUT_MS} and skipped
+ * entirely in ephemeral mode.
  */
 declare class SessionTurnManager {
   private readonly bus;
@@ -221,6 +231,18 @@ declare class SessionTurnManager {
    * the counter and cause duplicate turn numbers if the session continues.
    */
   private readonly syntheticTurnCounters;
+  /**
+   * Stored assistant messages per turnId, counted from `storage:message.stored`.
+   *
+   * Populated continuously (from construction) so messages persisted before
+   * `completeTurn` runs are counted. FIFO-capped at
+   * {@link ASSISTANT_PERSISTENCE_COUNTER_CAP}; a turn's entry is deleted when
+   * its completion emits, so late `stored` events for an already-emitted turn
+   * merely recreate a short-lived entry that the cap eventually evicts.
+   */
+  private readonly assistantStoredCounts;
+  /** Pending persist-before-emit barrier waiters, keyed by turnId. */
+  private readonly assistantPersistenceWaiters;
   /** Bus subscription cleanup functions. */
   private readonly cleanups;
   /**
@@ -240,6 +262,15 @@ declare class SessionTurnManager {
    * @returns The newly created and activated Turn entity
    */
   createTurn(sessionId: string, agentIds: string[], initiator?: TurnInitiator, turnId?: string): Promise<Turn$1>;
+  /**
+   * Discard active in-memory state for a turn that failed before routing began.
+   *
+   * The storage contract has no turn-delete operation, so this only rolls back
+   * the active manager state that would otherwise make the next user message
+   * reuse a turn whose first message was never persisted.
+   * @param turn - Newly created active turn to discard
+   */
+  discardActiveTurn(turn: Turn$1): void;
   /**
    * Register bus listeners for `agent.usage` and `agent.complete` events.
    *
@@ -260,6 +291,12 @@ declare class SessionTurnManager {
    * `TurnStorageSubjects.complete` call. State is cleared only after durable
    * persistence succeeds; if persistence fails, the state remains intact so
    * completion can be retried.
+   *
+   * Before the event fires, the persist-before-emit barrier waits for the
+   * turn's assistant messages to be stored (see class docs), then a
+   * `turn.completed` lifecycle row is appended to `session_events` — so both
+   * message rows and the lifecycle row are durable before consumers observe
+   * `session.turn.completed`.
    * @param turn - The turn to complete
    * @param result - Turn result (success status and error messages)
    */
@@ -311,6 +348,33 @@ declare class SessionTurnManager {
    * @param usageEvent - Usage event to defer until after persistence
    */
   private bufferUsageDuringCompletion;
+  /**
+   * Subscribe to `storage:message.stored` and count stored assistant messages
+   * per turnId, resolving any pending barrier waiter on each increment.
+   *
+   * Registered from the constructor (not `registerCompletionHandlers`) so the
+   * barrier also works for callers that drive `completeTurn` directly without
+   * wiring the agent-event handlers.
+   */
+  private registerAssistantPersistenceCounter;
+  /**
+   * Persist-before-emit barrier: wait until the turn's assistant messages are
+   * durably stored (one per agent) or the bounded timeout elapses.
+   *
+   * Resolution paths, in order:
+   * 1. The continuous `storage:message.stored` counter already reached the
+   *    expected count (messages stored before `completeTurn` ran).
+   * 2. `storage:message.getByTurn` is unhandled — no message storage exists,
+   *    nothing can be waited for (skip).
+   * 3. A queryable-state probe already shows the expected assistant messages
+   *    (covers messages persisted before this manager was constructed).
+   * 4. A waiter resolved by the counter reaching the expected count, bounded
+   *    by {@link TURN_COMPLETION_PERSISTENCE_TIMEOUT_MS} — the timeout is
+   *    mandatory because SessionBridge persists nothing for agents with zero
+   *    blocks and no error, and swallows write errors.
+   * @param turn - The completing turn (expected count = its agent count)
+   */
+  private awaitAssistantPersistence;
 }
 //#endregion
 //#region services/core/src/session/handlers/abandon-handler.d.ts

package/dist/{index-B1XsbrAr.d.mts → index-BwGfdbI0.d.mts}

@@ -48,8 +48,8 @@ declare const MaterializationSchemas: {
         template: z.ZodString;
       }, z.core.$strip>], "kind">;
       appliesTo: z.ZodArray<z.ZodEnum<{
-        artifact: "artifact";
         workpiece: "workpiece";
+        artifact: "artifact";
         surface: "surface";
       }>>;
       valueMapping: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
@@ -88,8 +88,8 @@ declare const MaterializationSchemas: {
           template: z.ZodString;
         }, z.core.$strip>], "kind">;
         appliesTo: z.ZodArray<z.ZodEnum<{
-          artifact: "artifact";
           workpiece: "workpiece";
+          artifact: "artifact";
           surface: "surface";
         }>>;
         valueMapping: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
@@ -153,8 +153,8 @@ declare const MaterializationNamespace: _$_makaio_core0.BusNamespaceDefinition<"
         template: z.ZodString;
       }, z.core.$strip>], "kind">;
       appliesTo: z.ZodArray<z.ZodEnum<{
-        artifact: "artifact";
         workpiece: "workpiece";
+        artifact: "artifact";
         surface: "surface";
       }>>;
       valueMapping: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
@@ -193,8 +193,8 @@ declare const MaterializationNamespace: _$_makaio_core0.BusNamespaceDefinition<"
           template: z.ZodString;
         }, z.core.$strip>], "kind">;
         appliesTo: z.ZodArray<z.ZodEnum<{
-          artifact: "artifact";
           workpiece: "workpiece";
+          artifact: "artifact";
           surface: "surface";
         }>>;
         valueMapping: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
@@ -268,8 +268,8 @@ declare const MaterializationSubjects: _$_makaio_core0.BusSubjects<_$_makaio_cor
         template: z.ZodString;
       }, z.core.$strip>], "kind">;
       appliesTo: z.ZodArray<z.ZodEnum<{
-        artifact: "artifact";
         workpiece: "workpiece";
+        artifact: "artifact";
         surface: "surface";
       }>>;
       valueMapping: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
@@ -308,8 +308,8 @@ declare const MaterializationSubjects: _$_makaio_core0.BusSubjects<_$_makaio_cor
           template: z.ZodString;
         }, z.core.$strip>], "kind">;
         appliesTo: z.ZodArray<z.ZodEnum<{
-          artifact: "artifact";
           workpiece: "workpiece";
+          artifact: "artifact";
           surface: "surface";
         }>>;
         valueMapping: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;

package/dist/{index-D8ScOpus.d.mts → index-C5C1tk9f.d.mts}

@@ -1,4 +1,4 @@
-import { It as ArtifactRevision$1 } from "./index-0WhPbKnH.mjs";
+import { It as ArtifactRevision$1 } from "./index-DV4nRk0h.mjs";
 import { i as JsonValue$1, t as JsonObjectContractSchema } from "./json-value-DtIkQN7g.mjs";
 import { z } from "zod";
 import * as _$_makaio_core0 from "@makaio/framework/core";
@@ -173,10 +173,10 @@ type WorkflowSourceLocation = z.infer<typeof WorkflowSourceLocationSchema>;
  * - `sequence`       — ordered list of child nodes (the structural container)
  */
 declare const WorkflowNodeTypeSchema: z.ZodEnum<{
-  sequence: "sequence";
   station: "station";
   "delegate-agent": "delegate-agent";
   "delegate-role": "delegate-role";
+  sequence: "sequence";
   parallel: "parallel";
   gate: "gate";
   iterate: "iterate";
@@ -902,10 +902,10 @@ declare const WorkflowFrameStateSchema$1: z.ZodObject<{
   frameId: z.ZodString;
   nodeId: z.ZodString;
   nodeType: z.ZodEnum<{
-    sequence: "sequence";
     station: "station";
     "delegate-agent": "delegate-agent";
     "delegate-role": "delegate-role";
+    sequence: "sequence";
     parallel: "parallel";
     gate: "gate";
     iterate: "iterate";
@@ -2881,10 +2881,10 @@ declare const WorkflowSchemas: {
         frameId: z.ZodString;
         nodeId: z.ZodString;
         nodeType: z.ZodEnum<{
-          sequence: "sequence";
           station: "station";
           "delegate-agent": "delegate-agent";
           "delegate-role": "delegate-role";
+          sequence: "sequence";
           parallel: "parallel";
           gate: "gate";
           iterate: "iterate";
@@ -2959,6 +2959,77 @@ declare const WorkflowSchemas: {
       executionId: z.ZodString;
     }, z.core.$strip>;
   };
+  /**
+   * Register an external execution that is not driven by the workflow engine.
+   *
+   * Creates a minimal `workflow_executions` row so that subsequent lifecycle
+   * events (`execution.started`, `frame.*`, `execution.completed/failed`)
+   * satisfy the foreign-key constraints on WorkLog projection tables.
+   *
+   * External executions are not associated with a persisted workflow definition
+   * and do not create coordinator sessions, run-context snapshots, or
+   * runtime state. They exist solely to provide a legitimate parent row for
+   * telemetry projections.
+   *
+   * After registration the caller is responsible for emitting the standard
+   * execution and frame lifecycle events on the bus. The WorkLog projection
+   * consumes them exactly as it does for engine-driven executions.
+   */
+  registerExternalExecution: {
+    request: z.ZodObject<{
+      name: z.ZodString;
+      scope: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"global">;
+      }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"workspace">;
+        id: z.ZodString;
+      }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"session">;
+        id: z.ZodString;
+      }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"external">;
+        kind: z.ZodString;
+        id: z.ZodString;
+      }, z.core.$strict>], "type">>;
+      artifactRef: z.ZodOptional<z.ZodObject<{
+        kind: z.ZodString;
+        id: z.ZodString;
+      }, z.core.$strip>>;
+      input: z.ZodOptional<z.ZodType<_$_makaio_contracts0.JsonValue, unknown, z.core.$ZodTypeInternals<_$_makaio_contracts0.JsonValue, unknown>>>;
+      triggerPayload: z.ZodOptional<z.ZodType<Record<string, unknown>, Record<string, unknown>, z.core.$ZodTypeInternals<Record<string, unknown>, Record<string, unknown>>>>;
+    }, z.core.$strip>;
+    response: z.ZodObject<{
+      executionId: z.ZodString;
+    }, z.core.$strip>;
+  };
+  /**
+   * Complete an external execution by updating its terminal status.
+   *
+   * Callers should also emit the corresponding lifecycle event
+   * (`execution.completed`, `execution.failed`, or `execution.cancelled`)
+   * so that WorkLog projections update the summary row.
+   *
+   * Cross-field invariants (enforced by schema refinement):
+   * - `'failed'` requires a non-empty `error` string.
+   * - `'cancelled'` requires a non-empty `reason` string.
+   * - `'completed'` must not carry `error` or `reason`.
+   */
+  completeExternalExecution: {
+    request: z.ZodObject<{
+      executionId: z.ZodString;
+      status: z.ZodEnum<{
+        completed: "completed";
+        cancelled: "cancelled";
+        failed: "failed";
+      }>;
+      error: z.ZodOptional<z.ZodString>;
+      reason: z.ZodOptional<z.ZodString>;
+      completedAt: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>;
+    response: z.ZodObject<{
+      success: z.ZodBoolean;
+    }, z.core.$strip>;
+  };
   /**
    * Resolve a named role to its full adapter configuration.
    * Called by the workflow executor when an agent step specifies `role`.
@@ -3473,10 +3544,10 @@ declare const WorkflowSchemas: {
     frameId: z.ZodString;
     nodeId: z.ZodString;
     nodeType: z.ZodEnum<{
-      sequence: "sequence";
       station: "station";
       "delegate-agent": "delegate-agent";
       "delegate-role": "delegate-role";
+      sequence: "sequence";
       parallel: "parallel";
       gate: "gate";
       iterate: "iterate";
@@ -4799,10 +4870,10 @@ declare const WorkflowNamespace$1: _$_makaio_core0.BusNamespaceDefinition<"workf
         frameId: z.ZodString;
         nodeId: z.ZodString;
         nodeType: z.ZodEnum<{
-          sequence: "sequence";
           station: "station";
           "delegate-agent": "delegate-agent";
           "delegate-role": "delegate-role";
+          sequence: "sequence";
           parallel: "parallel";
           gate: "gate";
           iterate: "iterate";
@@ -4877,6 +4948,77 @@ declare const WorkflowNamespace$1: _$_makaio_core0.BusNamespaceDefinition<"workf
       executionId: z.ZodString;
     }, z.core.$strip>;
   };
+  /**
+   * Register an external execution that is not driven by the workflow engine.
+   *
+   * Creates a minimal `workflow_executions` row so that subsequent lifecycle
+   * events (`execution.started`, `frame.*`, `execution.completed/failed`)
+   * satisfy the foreign-key constraints on WorkLog projection tables.
+   *
+   * External executions are not associated with a persisted workflow definition
+   * and do not create coordinator sessions, run-context snapshots, or
+   * runtime state. They exist solely to provide a legitimate parent row for
+   * telemetry projections.
+   *
+   * After registration the caller is responsible for emitting the standard
+   * execution and frame lifecycle events on the bus. The WorkLog projection
+   * consumes them exactly as it does for engine-driven executions.
+   */
+  registerExternalExecution: {
+    request: z.ZodObject<{
+      name: z.ZodString;
+      scope: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"global">;
+      }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"workspace">;
+        id: z.ZodString;
+      }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"session">;
+        id: z.ZodString;
+      }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"external">;
+        kind: z.ZodString;
+        id: z.ZodString;
+      }, z.core.$strict>], "type">>;
+      artifactRef: z.ZodOptional<z.ZodObject<{
+        kind: z.ZodString;
+        id: z.ZodString;
+      }, z.core.$strip>>;
+      input: z.ZodOptional<z.ZodType<_$_makaio_contracts0.JsonValue, unknown, z.core.$ZodTypeInternals<_$_makaio_contracts0.JsonValue, unknown>>>;
+      triggerPayload: z.ZodOptional<z.ZodType<Record<string, unknown>, Record<string, unknown>, z.core.$ZodTypeInternals<Record<string, unknown>, Record<string, unknown>>>>;
+    }, z.core.$strip>;
+    response: z.ZodObject<{
+      executionId: z.ZodString;
+    }, z.core.$strip>;
+  };
+  /**
+   * Complete an external execution by updating its terminal status.
+   *
+   * Callers should also emit the corresponding lifecycle event
+   * (`execution.completed`, `execution.failed`, or `execution.cancelled`)
+   * so that WorkLog projections update the summary row.
+   *
+   * Cross-field invariants (enforced by schema refinement):
+   * - `'failed'` requires a non-empty `error` string.
+   * - `'cancelled'` requires a non-empty `reason` string.
+   * - `'completed'` must not carry `error` or `reason`.
+   */
+  completeExternalExecution: {
+    request: z.ZodObject<{
+      executionId: z.ZodString;
+      status: z.ZodEnum<{
+        completed: "completed";
+        cancelled: "cancelled";
+        failed: "failed";
+      }>;
+      error: z.ZodOptional<z.ZodString>;
+      reason: z.ZodOptional<z.ZodString>;
+      completedAt: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>;
+    response: z.ZodObject<{
+      success: z.ZodBoolean;
+    }, z.core.$strip>;
+  };
   /**
    * Resolve a named role to its full adapter configuration.
    * Called by the workflow executor when an agent step specifies `role`.
@@ -5391,10 +5533,10 @@ declare const WorkflowNamespace$1: _$_makaio_core0.BusNamespaceDefinition<"workf
     frameId: z.ZodString;
     nodeId: z.ZodString;
     nodeType: z.ZodEnum<{
-      sequence: "sequence";
       station: "station";
       "delegate-agent": "delegate-agent";
       "delegate-role": "delegate-role";
+      sequence: "sequence";
       parallel: "parallel";
       gate: "gate";
       iterate: "iterate";
@@ -6717,10 +6859,10 @@ declare const WorkflowSubjects$1: _$_makaio_core0.BusSubjects<_$_makaio_core0.Fl
         frameId: z.ZodString;
         nodeId: z.ZodString;
         nodeType: z.ZodEnum<{
-          sequence: "sequence";
           station: "station";
           "delegate-agent": "delegate-agent";
           "delegate-role": "delegate-role";
+          sequence: "sequence";
           parallel: "parallel";
           gate: "gate";
           iterate: "iterate";
@@ -6795,6 +6937,77 @@ declare const WorkflowSubjects$1: _$_makaio_core0.BusSubjects<_$_makaio_core0.Fl
       executionId: z.ZodString;
     }, z.core.$strip>;
   };
+  /**
+   * Register an external execution that is not driven by the workflow engine.
+   *
+   * Creates a minimal `workflow_executions` row so that subsequent lifecycle
+   * events (`execution.started`, `frame.*`, `execution.completed/failed`)
+   * satisfy the foreign-key constraints on WorkLog projection tables.
+   *
+   * External executions are not associated with a persisted workflow definition
+   * and do not create coordinator sessions, run-context snapshots, or
+   * runtime state. They exist solely to provide a legitimate parent row for
+   * telemetry projections.
+   *
+   * After registration the caller is responsible for emitting the standard
+   * execution and frame lifecycle events on the bus. The WorkLog projection
+   * consumes them exactly as it does for engine-driven executions.
+   */
+  registerExternalExecution: {
+    request: z.ZodObject<{
+      name: z.ZodString;
+      scope: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"global">;
+      }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"workspace">;
+        id: z.ZodString;
+      }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"session">;
+        id: z.ZodString;
+      }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"external">;
+        kind: z.ZodString;
+        id: z.ZodString;
+      }, z.core.$strict>], "type">>;
+      artifactRef: z.ZodOptional<z.ZodObject<{
+        kind: z.ZodString;
+        id: z.ZodString;
+      }, z.core.$strip>>;
+      input: z.ZodOptional<z.ZodType<_$_makaio_contracts0.JsonValue, unknown, z.core.$ZodTypeInternals<_$_makaio_contracts0.JsonValue, unknown>>>;
+      triggerPayload: z.ZodOptional<z.ZodType<Record<string, unknown>, Record<string, unknown>, z.core.$ZodTypeInternals<Record<string, unknown>, Record<string, unknown>>>>;
+    }, z.core.$strip>;
+    response: z.ZodObject<{
+      executionId: z.ZodString;
+    }, z.core.$strip>;
+  };
+  /**
+   * Complete an external execution by updating its terminal status.
+   *
+   * Callers should also emit the corresponding lifecycle event
+   * (`execution.completed`, `execution.failed`, or `execution.cancelled`)
+   * so that WorkLog projections update the summary row.
+   *
+   * Cross-field invariants (enforced by schema refinement):
+   * - `'failed'` requires a non-empty `error` string.
+   * - `'cancelled'` requires a non-empty `reason` string.
+   * - `'completed'` must not carry `error` or `reason`.
+   */
+  completeExternalExecution: {
+    request: z.ZodObject<{
+      executionId: z.ZodString;
+      status: z.ZodEnum<{
+        completed: "completed";
+        cancelled: "cancelled";
+        failed: "failed";
+      }>;
+      error: z.ZodOptional<z.ZodString>;
+      reason: z.ZodOptional<z.ZodString>;
+      completedAt: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>;
+    response: z.ZodObject<{
+      success: z.ZodBoolean;
+    }, z.core.$strip>;
+  };
   /**
    * Resolve a named role to its full adapter configuration.
    * Called by the workflow executor when an agent step specifies `role`.
@@ -7309,10 +7522,10 @@ declare const WorkflowSubjects$1: _$_makaio_core0.BusSubjects<_$_makaio_core0.Fl
     frameId: z.ZodString;
     nodeId: z.ZodString;
     nodeType: z.ZodEnum<{
-      sequence: "sequence";
       station: "station";
       "delegate-agent": "delegate-agent";
       "delegate-role": "delegate-role";
+      sequence: "sequence";
       parallel: "parallel";
       gate: "gate";
       iterate: "iterate";

package/dist/{index-Cvjnj7Zh.d.mts → index-C6Ys8pxt.d.mts}

@@ -1,12 +1,12 @@
-import { J as ArtifactLifecycleHookEvent, Y as ArtifactLifecycleHookRegistration$1, z as AnyArtifactKindDefinition } from "./index-0WhPbKnH.mjs";
+import { J as ArtifactLifecycleHookEvent, Y as ArtifactLifecycleHookRegistration$1, z as AnyArtifactKindDefinition } from "./index-DV4nRk0h.mjs";
 import { A as VersionRange, O as VersionLiteral$1, r as ClientDefinition$1 } from "./definition-CuJvtYeG.mjs";
 import { c as ProviderDefinitionInput$1, r as ProtocolId$1 } from "./definition-Cllhr9mi.mjs";
 import { t as RequiredTimeoutConfig } from "./index-CuHqL95P.mjs";
-import { b as SESSION_EVENT_TYPES, i as MakaioSessionEvent$1, j as SessionMessage$1 } from "./types-8rhArs_K.mjs";
+import { F as SessionMessage$1, b as SESSION_EVENT_TYPES, i as MakaioSessionEvent$1 } from "./types-C76EP81O.mjs";
 import { D as EntityUIConfig, I as FormFieldProps } from "./index-CaerrEDH.mjs";
-import { n as ExtensionTransitionRulesContribution, t as ExtensionTransitionActionsContribution, y as WorkflowBlockCollection$1 } from "./transition-CBjccCMw.mjs";
-import { l as FacetNamespaceDefinition } from "./index-BMbmoarE.mjs";
-import { t as SurfaceBindingDefinition } from "./definition-DePb3ke-.mjs";
+import { n as ExtensionTransitionRulesContribution, t as ExtensionTransitionActionsContribution, y as WorkflowBlockCollection$1 } from "./transition-Dq41YCkc.mjs";
+import { l as FacetNamespaceDefinition } from "./index-O08Q2ikz.mjs";
+import { t as SurfaceBindingDefinition } from "./definition-b9jyJqPD.mjs";
 import { z } from "zod";
 import { MakaioBusLike, PayloadFilter, RegistrableBusNamespaceDefinition, SubjectSchema } from "@makaio/framework/core";
 import * as _$_makaio_contracts0 from "@makaio/framework/contracts";