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

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

@@ -1,4 +1,4 @@
-import { It as ArtifactRevision$1 } from "./index-Dg-y1mrq.mjs";
+import { It as ArtifactRevision$1 } from "./index-DS6kxiFl.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";
@@ -177,8 +177,8 @@ declare const WorkflowNodeTypeSchema: z.ZodEnum<{
   "delegate-agent": "delegate-agent";
   "delegate-role": "delegate-role";
   sequence: "sequence";
-  parallel: "parallel";
   gate: "gate";
+  parallel: "parallel";
   iterate: "iterate";
   "iterate-chain": "iterate-chain";
   loop: "loop";
@@ -845,9 +845,9 @@ declare const ExecutionStatusSchema$1: z.ZodEnum<{
   pending: "pending";
   completed: "completed";
   cancelled: "cancelled";
+  running: "running";
   failed: "failed";
   paused: "paused";
-  running: "running";
 }>;
 type ExecutionStatus = z.infer<typeof ExecutionStatusSchema$1>;
 /**
@@ -861,9 +861,9 @@ declare const WorkflowExecutionSchema$1: z.ZodObject<{
     pending: "pending";
     completed: "completed";
     cancelled: "cancelled";
+    running: "running";
     failed: "failed";
     paused: "paused";
-    running: "running";
   }>;
   inputs: z.ZodType<_$_makaio_contracts0.JsonValue, unknown, z.core.$ZodTypeInternals<_$_makaio_contracts0.JsonValue, unknown>>;
   config: z.ZodOptional<z.ZodType<Record<string, unknown>, Record<string, unknown>, z.core.$ZodTypeInternals<Record<string, unknown>, Record<string, unknown>>>>;
@@ -906,8 +906,8 @@ declare const WorkflowFrameStateSchema$1: z.ZodObject<{
     "delegate-agent": "delegate-agent";
     "delegate-role": "delegate-role";
     sequence: "sequence";
-    parallel: "parallel";
     gate: "gate";
+    parallel: "parallel";
     iterate: "iterate";
     "iterate-chain": "iterate-chain";
     loop: "loop";
@@ -918,8 +918,8 @@ declare const WorkflowFrameStateSchema$1: z.ZodObject<{
     pending: "pending";
     completed: "completed";
     cancelled: "cancelled";
-    failed: "failed";
     running: "running";
+    failed: "failed";
     waiting: "waiting";
     skipped: "skipped";
   }>;
@@ -1118,9 +1118,9 @@ declare const ExecutionListQuerySchema$1: z.ZodObject<{
     pending: "pending";
     completed: "completed";
     cancelled: "cancelled";
+    running: "running";
     failed: "failed";
     paused: "paused";
-    running: "running";
   }>>;
   artifactRef: z.ZodOptional<z.ZodObject<{
     kind: z.ZodString;
@@ -1472,8 +1472,8 @@ interface IStepRunner {
  */
 declare const SpanStatusSchema: z.ZodEnum<{
   completed: "completed";
-  failed: "failed";
   running: "running";
+  failed: "failed";
   skipped: "skipped";
 }>;
 type SpanStatus = z.infer<typeof SpanStatusSchema>;
@@ -1497,8 +1497,8 @@ declare const SpanRecordSchema$1: z.ZodObject<{
   }>;
   status: z.ZodEnum<{
     completed: "completed";
-    failed: "failed";
     running: "running";
+    failed: "failed";
     skipped: "skipped";
   }>;
   startedAt: z.ZodOptional<z.ZodNumber>;
@@ -2564,9 +2564,9 @@ declare const WorkflowSchemas: {
           pending: "pending";
           completed: "completed";
           cancelled: "cancelled";
+          running: "running";
           failed: "failed";
           paused: "paused";
-          running: "running";
         }>;
         inputs: z.ZodType<_$_makaio_contracts0.JsonValue, unknown, z.core.$ZodTypeInternals<_$_makaio_contracts0.JsonValue, unknown>>;
         config: z.ZodOptional<z.ZodType<Record<string, unknown>, Record<string, unknown>, z.core.$ZodTypeInternals<Record<string, unknown>, Record<string, unknown>>>>;
@@ -2621,9 +2621,9 @@ declare const WorkflowSchemas: {
         pending: "pending";
         completed: "completed";
         cancelled: "cancelled";
+        running: "running";
         failed: "failed";
         paused: "paused";
-        running: "running";
       }>>;
       artifactRef: z.ZodOptional<z.ZodObject<{
         kind: z.ZodString;
@@ -2644,9 +2644,9 @@ declare const WorkflowSchemas: {
           pending: "pending";
           completed: "completed";
           cancelled: "cancelled";
+          running: "running";
           failed: "failed";
           paused: "paused";
-          running: "running";
         }>;
         inputs: z.ZodType<_$_makaio_contracts0.JsonValue, unknown, z.core.$ZodTypeInternals<_$_makaio_contracts0.JsonValue, unknown>>;
         config: z.ZodOptional<z.ZodType<Record<string, unknown>, Record<string, unknown>, z.core.$ZodTypeInternals<Record<string, unknown>, Record<string, unknown>>>>;
@@ -2700,9 +2700,9 @@ declare const WorkflowSchemas: {
           pending: "pending";
           completed: "completed";
           cancelled: "cancelled";
+          running: "running";
           failed: "failed";
           paused: "paused";
-          running: "running";
         }>;
         inputs: z.ZodType<_$_makaio_contracts0.JsonValue, unknown, z.core.$ZodTypeInternals<_$_makaio_contracts0.JsonValue, unknown>>;
         config: z.ZodOptional<z.ZodType<Record<string, unknown>, Record<string, unknown>, z.core.$ZodTypeInternals<Record<string, unknown>, Record<string, unknown>>>>;
@@ -2754,8 +2754,8 @@ declare const WorkflowSchemas: {
         }>;
         status: z.ZodEnum<{
           completed: "completed";
-          failed: "failed";
           running: "running";
+          failed: "failed";
           skipped: "skipped";
         }>;
         startedAt: z.ZodOptional<z.ZodNumber>;
@@ -2885,8 +2885,8 @@ declare const WorkflowSchemas: {
           "delegate-agent": "delegate-agent";
           "delegate-role": "delegate-role";
           sequence: "sequence";
-          parallel: "parallel";
           gate: "gate";
+          parallel: "parallel";
           iterate: "iterate";
           "iterate-chain": "iterate-chain";
           loop: "loop";
@@ -2897,8 +2897,8 @@ declare const WorkflowSchemas: {
           pending: "pending";
           completed: "completed";
           cancelled: "cancelled";
-          failed: "failed";
           running: "running";
+          failed: "failed";
           waiting: "waiting";
           skipped: "skipped";
         }>;
@@ -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`.
@@ -3477,8 +3548,8 @@ declare const WorkflowSchemas: {
       "delegate-agent": "delegate-agent";
       "delegate-role": "delegate-role";
       sequence: "sequence";
-      parallel: "parallel";
       gate: "gate";
+      parallel: "parallel";
       iterate: "iterate";
       "iterate-chain": "iterate-chain";
       loop: "loop";
@@ -3602,9 +3673,9 @@ declare const WorkflowSchemas: {
           pending: "pending";
           completed: "completed";
           cancelled: "cancelled";
+          running: "running";
           failed: "failed";
           paused: "paused";
-          running: "running";
         }>;
         startedAt: z.ZodNumber;
         completedAt: z.ZodOptional<z.ZodNumber>;
@@ -3630,9 +3701,9 @@ declare const WorkflowSchemas: {
         pending: "pending";
         completed: "completed";
         cancelled: "cancelled";
+        running: "running";
         failed: "failed";
         paused: "paused";
-        running: "running";
       }>>;
       limit: z.ZodOptional<z.ZodNumber>;
       offset: z.ZodOptional<z.ZodNumber>;
@@ -3646,9 +3717,9 @@ declare const WorkflowSchemas: {
           pending: "pending";
           completed: "completed";
           cancelled: "cancelled";
+          running: "running";
           failed: "failed";
           paused: "paused";
-          running: "running";
         }>;
         startedAt: z.ZodNumber;
         completedAt: z.ZodOptional<z.ZodNumber>;
@@ -4482,9 +4553,9 @@ declare const WorkflowNamespace$1: _$_makaio_core0.BusNamespaceDefinition<"workf
           pending: "pending";
           completed: "completed";
           cancelled: "cancelled";
+          running: "running";
           failed: "failed";
           paused: "paused";
-          running: "running";
         }>;
         inputs: z.ZodType<_$_makaio_contracts0.JsonValue, unknown, z.core.$ZodTypeInternals<_$_makaio_contracts0.JsonValue, unknown>>;
         config: z.ZodOptional<z.ZodType<Record<string, unknown>, Record<string, unknown>, z.core.$ZodTypeInternals<Record<string, unknown>, Record<string, unknown>>>>;
@@ -4539,9 +4610,9 @@ declare const WorkflowNamespace$1: _$_makaio_core0.BusNamespaceDefinition<"workf
         pending: "pending";
         completed: "completed";
         cancelled: "cancelled";
+        running: "running";
         failed: "failed";
         paused: "paused";
-        running: "running";
       }>>;
       artifactRef: z.ZodOptional<z.ZodObject<{
         kind: z.ZodString;
@@ -4562,9 +4633,9 @@ declare const WorkflowNamespace$1: _$_makaio_core0.BusNamespaceDefinition<"workf
           pending: "pending";
           completed: "completed";
           cancelled: "cancelled";
+          running: "running";
           failed: "failed";
           paused: "paused";
-          running: "running";
         }>;
         inputs: z.ZodType<_$_makaio_contracts0.JsonValue, unknown, z.core.$ZodTypeInternals<_$_makaio_contracts0.JsonValue, unknown>>;
         config: z.ZodOptional<z.ZodType<Record<string, unknown>, Record<string, unknown>, z.core.$ZodTypeInternals<Record<string, unknown>, Record<string, unknown>>>>;
@@ -4618,9 +4689,9 @@ declare const WorkflowNamespace$1: _$_makaio_core0.BusNamespaceDefinition<"workf
           pending: "pending";
           completed: "completed";
           cancelled: "cancelled";
+          running: "running";
           failed: "failed";
           paused: "paused";
-          running: "running";
         }>;
         inputs: z.ZodType<_$_makaio_contracts0.JsonValue, unknown, z.core.$ZodTypeInternals<_$_makaio_contracts0.JsonValue, unknown>>;
         config: z.ZodOptional<z.ZodType<Record<string, unknown>, Record<string, unknown>, z.core.$ZodTypeInternals<Record<string, unknown>, Record<string, unknown>>>>;
@@ -4672,8 +4743,8 @@ declare const WorkflowNamespace$1: _$_makaio_core0.BusNamespaceDefinition<"workf
         }>;
         status: z.ZodEnum<{
           completed: "completed";
-          failed: "failed";
           running: "running";
+          failed: "failed";
           skipped: "skipped";
         }>;
         startedAt: z.ZodOptional<z.ZodNumber>;
@@ -4803,8 +4874,8 @@ declare const WorkflowNamespace$1: _$_makaio_core0.BusNamespaceDefinition<"workf
           "delegate-agent": "delegate-agent";
           "delegate-role": "delegate-role";
           sequence: "sequence";
-          parallel: "parallel";
           gate: "gate";
+          parallel: "parallel";
           iterate: "iterate";
           "iterate-chain": "iterate-chain";
           loop: "loop";
@@ -4815,8 +4886,8 @@ declare const WorkflowNamespace$1: _$_makaio_core0.BusNamespaceDefinition<"workf
           pending: "pending";
           completed: "completed";
           cancelled: "cancelled";
-          failed: "failed";
           running: "running";
+          failed: "failed";
           waiting: "waiting";
           skipped: "skipped";
         }>;
@@ -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`.
@@ -5395,8 +5537,8 @@ declare const WorkflowNamespace$1: _$_makaio_core0.BusNamespaceDefinition<"workf
       "delegate-agent": "delegate-agent";
       "delegate-role": "delegate-role";
       sequence: "sequence";
-      parallel: "parallel";
       gate: "gate";
+      parallel: "parallel";
       iterate: "iterate";
       "iterate-chain": "iterate-chain";
       loop: "loop";
@@ -5520,9 +5662,9 @@ declare const WorkflowNamespace$1: _$_makaio_core0.BusNamespaceDefinition<"workf
           pending: "pending";
           completed: "completed";
           cancelled: "cancelled";
+          running: "running";
           failed: "failed";
           paused: "paused";
-          running: "running";
         }>;
         startedAt: z.ZodNumber;
         completedAt: z.ZodOptional<z.ZodNumber>;
@@ -5548,9 +5690,9 @@ declare const WorkflowNamespace$1: _$_makaio_core0.BusNamespaceDefinition<"workf
         pending: "pending";
         completed: "completed";
         cancelled: "cancelled";
+        running: "running";
         failed: "failed";
         paused: "paused";
-        running: "running";
       }>>;
       limit: z.ZodOptional<z.ZodNumber>;
       offset: z.ZodOptional<z.ZodNumber>;
@@ -5564,9 +5706,9 @@ declare const WorkflowNamespace$1: _$_makaio_core0.BusNamespaceDefinition<"workf
           pending: "pending";
           completed: "completed";
           cancelled: "cancelled";
+          running: "running";
           failed: "failed";
           paused: "paused";
-          running: "running";
         }>;
         startedAt: z.ZodNumber;
         completedAt: z.ZodOptional<z.ZodNumber>;
@@ -6400,9 +6542,9 @@ declare const WorkflowSubjects$1: _$_makaio_core0.BusSubjects<_$_makaio_core0.Fl
           pending: "pending";
           completed: "completed";
           cancelled: "cancelled";
+          running: "running";
           failed: "failed";
           paused: "paused";
-          running: "running";
         }>;
         inputs: z.ZodType<_$_makaio_contracts0.JsonValue, unknown, z.core.$ZodTypeInternals<_$_makaio_contracts0.JsonValue, unknown>>;
         config: z.ZodOptional<z.ZodType<Record<string, unknown>, Record<string, unknown>, z.core.$ZodTypeInternals<Record<string, unknown>, Record<string, unknown>>>>;
@@ -6457,9 +6599,9 @@ declare const WorkflowSubjects$1: _$_makaio_core0.BusSubjects<_$_makaio_core0.Fl
         pending: "pending";
         completed: "completed";
         cancelled: "cancelled";
+        running: "running";
         failed: "failed";
         paused: "paused";
-        running: "running";
       }>>;
       artifactRef: z.ZodOptional<z.ZodObject<{
         kind: z.ZodString;
@@ -6480,9 +6622,9 @@ declare const WorkflowSubjects$1: _$_makaio_core0.BusSubjects<_$_makaio_core0.Fl
           pending: "pending";
           completed: "completed";
           cancelled: "cancelled";
+          running: "running";
           failed: "failed";
           paused: "paused";
-          running: "running";
         }>;
         inputs: z.ZodType<_$_makaio_contracts0.JsonValue, unknown, z.core.$ZodTypeInternals<_$_makaio_contracts0.JsonValue, unknown>>;
         config: z.ZodOptional<z.ZodType<Record<string, unknown>, Record<string, unknown>, z.core.$ZodTypeInternals<Record<string, unknown>, Record<string, unknown>>>>;
@@ -6536,9 +6678,9 @@ declare const WorkflowSubjects$1: _$_makaio_core0.BusSubjects<_$_makaio_core0.Fl
           pending: "pending";
           completed: "completed";
           cancelled: "cancelled";
+          running: "running";
           failed: "failed";
           paused: "paused";
-          running: "running";
         }>;
         inputs: z.ZodType<_$_makaio_contracts0.JsonValue, unknown, z.core.$ZodTypeInternals<_$_makaio_contracts0.JsonValue, unknown>>;
         config: z.ZodOptional<z.ZodType<Record<string, unknown>, Record<string, unknown>, z.core.$ZodTypeInternals<Record<string, unknown>, Record<string, unknown>>>>;
@@ -6590,8 +6732,8 @@ declare const WorkflowSubjects$1: _$_makaio_core0.BusSubjects<_$_makaio_core0.Fl
         }>;
         status: z.ZodEnum<{
           completed: "completed";
-          failed: "failed";
           running: "running";
+          failed: "failed";
           skipped: "skipped";
         }>;
         startedAt: z.ZodOptional<z.ZodNumber>;
@@ -6721,8 +6863,8 @@ declare const WorkflowSubjects$1: _$_makaio_core0.BusSubjects<_$_makaio_core0.Fl
           "delegate-agent": "delegate-agent";
           "delegate-role": "delegate-role";
           sequence: "sequence";
-          parallel: "parallel";
           gate: "gate";
+          parallel: "parallel";
           iterate: "iterate";
           "iterate-chain": "iterate-chain";
           loop: "loop";
@@ -6733,8 +6875,8 @@ declare const WorkflowSubjects$1: _$_makaio_core0.BusSubjects<_$_makaio_core0.Fl
           pending: "pending";
           completed: "completed";
           cancelled: "cancelled";
-          failed: "failed";
           running: "running";
+          failed: "failed";
           waiting: "waiting";
           skipped: "skipped";
         }>;
@@ -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`.
@@ -7313,8 +7526,8 @@ declare const WorkflowSubjects$1: _$_makaio_core0.BusSubjects<_$_makaio_core0.Fl
       "delegate-agent": "delegate-agent";
       "delegate-role": "delegate-role";
       sequence: "sequence";
-      parallel: "parallel";
       gate: "gate";
+      parallel: "parallel";
       iterate: "iterate";
       "iterate-chain": "iterate-chain";
       loop: "loop";
@@ -7438,9 +7651,9 @@ declare const WorkflowSubjects$1: _$_makaio_core0.BusSubjects<_$_makaio_core0.Fl
           pending: "pending";
           completed: "completed";
           cancelled: "cancelled";
+          running: "running";
           failed: "failed";
           paused: "paused";
-          running: "running";
         }>;
         startedAt: z.ZodNumber;
         completedAt: z.ZodOptional<z.ZodNumber>;
@@ -7466,9 +7679,9 @@ declare const WorkflowSubjects$1: _$_makaio_core0.BusSubjects<_$_makaio_core0.Fl
         pending: "pending";
         completed: "completed";
         cancelled: "cancelled";
+        running: "running";
         failed: "failed";
         paused: "paused";
-        running: "running";
       }>>;
       limit: z.ZodOptional<z.ZodNumber>;
       offset: z.ZodOptional<z.ZodNumber>;
@@ -7482,9 +7695,9 @@ declare const WorkflowSubjects$1: _$_makaio_core0.BusSubjects<_$_makaio_core0.Fl
           pending: "pending";
           completed: "completed";
           cancelled: "cancelled";
+          running: "running";
           failed: "failed";
           paused: "paused";
-          running: "running";
         }>;
         startedAt: z.ZodNumber;
         completedAt: z.ZodOptional<z.ZodNumber>;
@@ -8494,9 +8707,9 @@ declare const WorkLogExecutionSummarySchema: z.ZodObject<{
     pending: "pending";
     completed: "completed";
     cancelled: "cancelled";
+    running: "running";
     failed: "failed";
     paused: "paused";
-    running: "running";
   }>;
   startedAt: z.ZodNumber;
   completedAt: z.ZodOptional<z.ZodNumber>;
@@ -8531,8 +8744,8 @@ declare const WorkLogFrameEntrySchema: z.ZodObject<{
     pending: "pending";
     completed: "completed";
     cancelled: "cancelled";
-    failed: "failed";
     running: "running";
+    failed: "failed";
     waiting: "waiting";
     skipped: "skipped";
   }>;
@@ -8675,11 +8888,11 @@ type ContextMode = z.infer<typeof ContextModeSchema$1>;
 declare const SubagentStatusSchema: z.ZodEnum<{
   completed: "completed";
   cancelled: "cancelled";
-  failed: "failed";
   running: "running";
   spawning: "spawning";
   waiting_input: "waiting_input";
   hung: "hung";
+  failed: "failed";
 }>;
 type SubagentStatus$1 = z.infer<typeof SubagentStatusSchema>;
 /**
@@ -8868,8 +9081,8 @@ declare const AwaitSubagentResponseSchema: z.ZodObject<{
   status: z.ZodEnum<{
     completed: "completed";
     cancelled: "cancelled";
-    failed: "failed";
     waiting_input: "waiting_input";
+    failed: "failed";
     timeout: "timeout";
   }>;
   result: z.ZodOptional<z.ZodString>;
@@ -8972,11 +9185,11 @@ declare const ListSubagentsBySessionResponseSchema: z.ZodObject<{
     status: z.ZodEnum<{
       completed: "completed";
       cancelled: "cancelled";
-      failed: "failed";
       running: "running";
       spawning: "spawning";
       waiting_input: "waiting_input";
       hung: "hung";
+      failed: "failed";
     }>;
   }, z.core.$strip>>;
 }, z.core.$strip>;