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

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

@@ -18,8 +18,8 @@ import { ExtensionWarningEntry, ExtensionWarningEntrySchema } from "@makaio/fram
  * detail, not an externally observable state.
  */
 declare const ComponentStateSchema: z.ZodEnum<{
-  discovered: "discovered";
   failed: "failed";
+  discovered: "discovered";
   stopped: "stopped";
   active: "active";
   skipped: "skipped";
@@ -47,8 +47,8 @@ declare const ComponentInfoSchema: z.ZodObject<{
   name: z.ZodString;
   displayName: z.ZodString;
   state: z.ZodEnum<{
-    discovered: "discovered";
     failed: "failed";
+    discovered: "discovered";
     stopped: "stopped";
     active: "active";
     skipped: "skipped";
@@ -68,8 +68,8 @@ declare const ServiceInfoSchema: z.ZodObject<{
   name: z.ZodString;
   displayName: z.ZodString;
   state: z.ZodEnum<{
-    discovered: "discovered";
     failed: "failed";
+    discovered: "discovered";
     stopped: "stopped";
     active: "active";
     skipped: "skipped";
@@ -90,8 +90,8 @@ declare const ExtensionInfoSchema: z.ZodObject<{
   name: z.ZodString;
   displayName: z.ZodString;
   state: z.ZodEnum<{
-    discovered: "discovered";
     failed: "failed";
+    discovered: "discovered";
     stopped: "stopped";
     active: "active";
     skipped: "skipped";
@@ -138,16 +138,16 @@ declare const ExtensionNamespace: _$_makaio_core0.BusNamespaceDefinition<"kernel
     name: z.ZodString;
     displayName: z.ZodString;
     from: z.ZodEnum<{
-      discovered: "discovered";
       failed: "failed";
+      discovered: "discovered";
       stopped: "stopped";
       active: "active";
       skipped: "skipped";
       initializing: "initializing";
     }>;
     to: z.ZodEnum<{
-      discovered: "discovered";
       failed: "failed";
+      discovered: "discovered";
       stopped: "stopped";
       active: "active";
       skipped: "skipped";
@@ -181,8 +181,8 @@ declare const ExtensionNamespace: _$_makaio_core0.BusNamespaceDefinition<"kernel
         name: z.ZodString;
         displayName: z.ZodString;
         state: z.ZodEnum<{
-          discovered: "discovered";
           failed: "failed";
+          discovered: "discovered";
           stopped: "stopped";
           active: "active";
           skipped: "skipped";
@@ -219,8 +219,8 @@ declare const ExtensionNamespace: _$_makaio_core0.BusNamespaceDefinition<"kernel
         name: z.ZodString;
         displayName: z.ZodString;
         state: z.ZodEnum<{
-          discovered: "discovered";
           failed: "failed";
+          discovered: "discovered";
           stopped: "stopped";
           active: "active";
           skipped: "skipped";
@@ -488,8 +488,8 @@ declare const ExtensionNamespace: _$_makaio_core0.BusNamespaceDefinition<"kernel
         extensionName: z.ZodString;
         warnings: z.ZodArray<z.ZodObject<{
           severity: z.ZodEnum<{
-            info: "info";
             degraded: "degraded";
+            info: "info";
             recommended: "recommended";
           }>;
           title: z.ZodString;
@@ -528,8 +528,8 @@ declare const ExtensionNamespace: _$_makaio_core0.BusNamespaceDefinition<"kernel
     extensionName: z.ZodString;
     warnings: z.ZodArray<z.ZodObject<{
       severity: z.ZodEnum<{
-        info: "info";
         degraded: "degraded";
+        info: "info";
         recommended: "recommended";
       }>;
       title: z.ZodString;
@@ -593,16 +593,16 @@ declare const ExtensionSubjects: _$_makaio_core0.BusSubjects<_$_makaio_core0.Fla
     name: z.ZodString;
     displayName: z.ZodString;
     from: z.ZodEnum<{
-      discovered: "discovered";
       failed: "failed";
+      discovered: "discovered";
       stopped: "stopped";
       active: "active";
       skipped: "skipped";
       initializing: "initializing";
     }>;
     to: z.ZodEnum<{
-      discovered: "discovered";
       failed: "failed";
+      discovered: "discovered";
       stopped: "stopped";
       active: "active";
       skipped: "skipped";
@@ -636,8 +636,8 @@ declare const ExtensionSubjects: _$_makaio_core0.BusSubjects<_$_makaio_core0.Fla
         name: z.ZodString;
         displayName: z.ZodString;
         state: z.ZodEnum<{
-          discovered: "discovered";
           failed: "failed";
+          discovered: "discovered";
           stopped: "stopped";
           active: "active";
           skipped: "skipped";
@@ -674,8 +674,8 @@ declare const ExtensionSubjects: _$_makaio_core0.BusSubjects<_$_makaio_core0.Fla
         name: z.ZodString;
         displayName: z.ZodString;
         state: z.ZodEnum<{
-          discovered: "discovered";
           failed: "failed";
+          discovered: "discovered";
           stopped: "stopped";
           active: "active";
           skipped: "skipped";
@@ -943,8 +943,8 @@ declare const ExtensionSubjects: _$_makaio_core0.BusSubjects<_$_makaio_core0.Fla
         extensionName: z.ZodString;
         warnings: z.ZodArray<z.ZodObject<{
           severity: z.ZodEnum<{
-            info: "info";
             degraded: "degraded";
+            info: "info";
             recommended: "recommended";
           }>;
           title: z.ZodString;
@@ -983,8 +983,8 @@ declare const ExtensionSubjects: _$_makaio_core0.BusSubjects<_$_makaio_core0.Fla
     extensionName: z.ZodString;
     warnings: z.ZodArray<z.ZodObject<{
       severity: z.ZodEnum<{
-        info: "info";
         degraded: "degraded";
+        info: "info";
         recommended: "recommended";
       }>;
       title: z.ZodString;

package/dist/{index-Y2r0Zvcm.d.mts → index-B5w-0Gg9.d.mts}

@@ -141,11 +141,11 @@ declare const HarnessDefinitionCreateSchema: z.ZodObject<{
   env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
   name: z.ZodString;
   adapterName: z.ZodOptional<z.ZodString>;
+  clientId: z.ZodOptional<z.ZodString>;
   nativeTools: z.ZodObject<{
     enabled: z.ZodArray<z.ZodString>;
     disabled: z.ZodArray<z.ZodString>;
   }, z.core.$strip>;
-  clientId: z.ZodOptional<z.ZodString>;
   credentials: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
   registryTools: z.ZodObject<{
     enabled: z.ZodArray<z.ZodString>;
@@ -317,11 +317,11 @@ declare const HarnessSchemas: {
       env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
       name: z.ZodString;
       adapterName: z.ZodOptional<z.ZodString>;
+      clientId: z.ZodOptional<z.ZodString>;
       nativeTools: z.ZodObject<{
         enabled: z.ZodArray<z.ZodString>;
         disabled: z.ZodArray<z.ZodString>;
       }, z.core.$strip>;
-      clientId: z.ZodOptional<z.ZodString>;
       credentials: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
       registryTools: z.ZodObject<{
         enabled: z.ZodArray<z.ZodString>;
@@ -760,11 +760,11 @@ declare const HarnessNamespace: _$_makaio_core0.BusNamespaceDefinition<"harness"
       env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
       name: z.ZodString;
       adapterName: z.ZodOptional<z.ZodString>;
+      clientId: z.ZodOptional<z.ZodString>;
       nativeTools: z.ZodObject<{
         enabled: z.ZodArray<z.ZodString>;
         disabled: z.ZodArray<z.ZodString>;
       }, z.core.$strip>;
-      clientId: z.ZodOptional<z.ZodString>;
       credentials: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
       registryTools: z.ZodObject<{
         enabled: z.ZodArray<z.ZodString>;
@@ -1203,11 +1203,11 @@ declare const HarnessSubjects: _$_makaio_core0.BusSubjects<_$_makaio_core0.FlatS
       env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
       name: z.ZodString;
       adapterName: z.ZodOptional<z.ZodString>;
+      clientId: z.ZodOptional<z.ZodString>;
       nativeTools: z.ZodObject<{
         enabled: z.ZodArray<z.ZodString>;
         disabled: z.ZodArray<z.ZodString>;
       }, z.core.$strip>;
-      clientId: z.ZodOptional<z.ZodString>;
       credentials: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
       registryTools: z.ZodObject<{
         enabled: z.ZodArray<z.ZodString>;

package/dist/{index-DdBRlm7m.d.mts → index-BKZhnb2B.d.mts}

@@ -1583,9 +1583,9 @@ declare const AdapterNamespace: _$_makaio_core0.BusNamespaceDefinition<"adapter"
     timestamp: _$zod.ZodNumber;
     level: _$zod.ZodOptional<_$zod.ZodEnum<{
       error: "error";
+      warn: "warn";
       debug: "debug";
       info: "info";
-      warn: "warn";
     }>>;
   }, _$zod_v4_core0.$strip>;
   error: _$zod.ZodObject<{
@@ -3195,9 +3195,9 @@ declare const AdapterSubjects$1: _$_makaio_core0.BusSubjects<_$_makaio_core0.Fla
     timestamp: _$zod.ZodNumber;
     level: _$zod.ZodOptional<_$zod.ZodEnum<{
       error: "error";
+      warn: "warn";
       debug: "debug";
       info: "info";
-      warn: "warn";
     }>>;
   }, _$zod_v4_core0.$strip>;
   error: _$zod.ZodObject<{
@@ -4831,9 +4831,9 @@ declare const AdapterSchemas: {
     timestamp: _$zod.ZodNumber;
     level: _$zod.ZodOptional<_$zod.ZodEnum<{
       error: "error";
+      warn: "warn";
       debug: "debug";
       info: "info";
-      warn: "warn";
     }>>;
   }, _$zod_v4_core0.$strip>;
   error: _$zod.ZodObject<{

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-2fK9iSHI.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>>;
@@ -106,8 +106,8 @@ declare const MaterializationSchemas: {
     provider: z.ZodString;
     externalId: z.ZodString;
     operation: z.ZodEnum<{
-      deleted: "deleted";
       upserted: "upserted";
+      deleted: "deleted";
     }>;
   }, z.core.$strip>; /** Emitted when a provider surface capability set has been resolved. */
   'capability.resolved': z.ZodObject<{
@@ -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>>;
@@ -211,8 +211,8 @@ declare const MaterializationNamespace: _$_makaio_core0.BusNamespaceDefinition<"
     provider: z.ZodString;
     externalId: z.ZodString;
     operation: z.ZodEnum<{
-      deleted: "deleted";
       upserted: "upserted";
+      deleted: "deleted";
     }>;
   }, z.core.$strip>; /** Emitted when a provider surface capability set has been resolved. */
   'capability.resolved': z.ZodObject<{
@@ -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>>;
@@ -326,8 +326,8 @@ declare const MaterializationSubjects: _$_makaio_core0.BusSubjects<_$_makaio_cor
     provider: z.ZodString;
     externalId: z.ZodString;
     operation: z.ZodEnum<{
-      deleted: "deleted";
       upserted: "upserted";
+      deleted: "deleted";
     }>;
   }, z.core.$strip>; /** Emitted when a provider surface capability set has been resolved. */
   'capability.resolved': z.ZodObject<{

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

@@ -1,4 +1,4 @@
-import { It as ArtifactRevision$1 } from "./index-Dg-y1mrq.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";
@@ -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`.
@@ -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`.
@@ -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`.