@makaio/framework 1.0.0-dev-1781442380278 → 1.0.0-dev-1781454904823

package/dist/workflow-engine/index.d.mts

@@ -1,12 +1,14 @@
-import { a as WorkflowExecutor, i as WorkflowEngineService, n as createWorkflowEnginePackage, o as registerDrizzleWorkflowStorage, r as workflowEnginePackage, t as WorkflowEngineToken } from "../package-BEbo1-6S.mjs";
+import { a as WorkflowExecutor, i as WorkflowEngineService, n as createWorkflowEnginePackage, o as registerDrizzleWorkflowStorage, r as workflowEnginePackage, t as WorkflowEngineToken } from "../package-fwIv7zzj.mjs";
 import { z } from "zod";
 import * as _$_makaio_core0 from "@makaio/framework/core";
+import { IMakaioBus } from "@makaio/framework/bus";
 import * as _$_makaio_contracts0 from "@makaio/framework/contracts";
-import { JsonValue, WorkflowExecutionSchema, WorkflowListQuerySchema } from "@makaio/framework/contracts";
+import { JsonPatchOperation, JsonValue, WorkflowExecutionSchema, WorkflowListQuerySchema } from "@makaio/framework/contracts";
 import * as _$_makaio_storage_core0 from "@makaio/framework/storage";
 import * as _$drizzle_orm_sqlite_core0 from "drizzle-orm/sqlite-core";
 import * as _$drizzle_orm_pg_core0 from "drizzle-orm/pg-core";
 import * as _$_makaio_storage_drizzle0 from "@makaio/framework/storage/drizzle";
+import { MakaioDatabase } from "@makaio/framework/storage/drizzle";
 import * as _$drizzle_orm0 from "drizzle-orm";
 import { WorkflowExpressionContext } from "@makaio/framework/expression";
 
@@ -43,6 +45,10 @@ declare const WorkflowStorageNamespace: _$_makaio_storage_core0.StorageNamespace
         inputSchema: z.ZodOptional<z.ZodType<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>, z.core.$ZodTypeInternals<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>>>>;
         configSchema: z.ZodOptional<z.ZodType<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>, z.core.$ZodTypeInternals<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>>>>;
         outputSchema: z.ZodOptional<z.ZodType<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>, z.core.$ZodTypeInternals<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>>>>;
+        state: z.ZodOptional<z.ZodObject<{
+          schema: z.ZodType<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>, z.core.$ZodTypeInternals<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>>>;
+          initial: z.ZodOptional<z.ZodType<_$_makaio_contracts0.JsonValue, unknown, z.core.$ZodTypeInternals<_$_makaio_contracts0.JsonValue, unknown>>>;
+        }, z.core.$strip>>;
         artifact: z.ZodOptional<z.ZodObject<{
           kind: z.ZodString;
           schemaVersion: z.ZodString;
@@ -155,6 +161,10 @@ declare const WorkflowStorageNamespace: _$_makaio_storage_core0.StorageNamespace
         inputSchema: z.ZodOptional<z.ZodType<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>, z.core.$ZodTypeInternals<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>>>>;
         configSchema: z.ZodOptional<z.ZodType<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>, z.core.$ZodTypeInternals<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>>>>;
         outputSchema: z.ZodOptional<z.ZodType<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>, z.core.$ZodTypeInternals<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>>>>;
+        state: z.ZodOptional<z.ZodObject<{
+          schema: z.ZodType<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>, z.core.$ZodTypeInternals<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>>>;
+          initial: z.ZodOptional<z.ZodType<_$_makaio_contracts0.JsonValue, unknown, z.core.$ZodTypeInternals<_$_makaio_contracts0.JsonValue, unknown>>>;
+        }, z.core.$strip>>;
         artifact: z.ZodOptional<z.ZodObject<{
           kind: z.ZodString;
           schemaVersion: z.ZodString;
@@ -293,6 +303,10 @@ declare const WorkflowStorageNamespace: _$_makaio_storage_core0.StorageNamespace
         inputSchema: z.ZodOptional<z.ZodType<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>, z.core.$ZodTypeInternals<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>>>>;
         configSchema: z.ZodOptional<z.ZodType<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>, z.core.$ZodTypeInternals<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>>>>;
         outputSchema: z.ZodOptional<z.ZodType<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>, z.core.$ZodTypeInternals<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>>>>;
+        state: z.ZodOptional<z.ZodObject<{
+          schema: z.ZodType<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>, z.core.$ZodTypeInternals<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>>>;
+          initial: z.ZodOptional<z.ZodType<_$_makaio_contracts0.JsonValue, unknown, z.core.$ZodTypeInternals<_$_makaio_contracts0.JsonValue, unknown>>>;
+        }, z.core.$strip>>;
         artifact: z.ZodOptional<z.ZodObject<{
           kind: z.ZodString;
           schemaVersion: z.ZodString;
@@ -410,8 +424,8 @@ declare const WorkflowStorageNamespace: _$_makaio_storage_core0.StorageNamespace
           completed: "completed";
           cancelled: "cancelled";
           failed: "failed";
-          running: "running";
           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>>>>;
@@ -451,8 +465,8 @@ declare const WorkflowStorageNamespace: _$_makaio_storage_core0.StorageNamespace
           completed: "completed";
           cancelled: "cancelled";
           failed: "failed";
-          running: "running";
           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>>>>;
@@ -499,8 +513,8 @@ declare const WorkflowStorageNamespace: _$_makaio_storage_core0.StorageNamespace
           completed: "completed";
           cancelled: "cancelled";
           failed: "failed";
-          running: "running";
           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>>>>;
@@ -548,6 +562,10 @@ declare const WorkflowStorageNamespace: _$_makaio_storage_core0.StorageNamespace
           inputSchema: z.ZodOptional<z.ZodType<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>, z.core.$ZodTypeInternals<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>>>>;
           configSchema: z.ZodOptional<z.ZodType<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>, z.core.$ZodTypeInternals<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>>>>;
           outputSchema: z.ZodOptional<z.ZodType<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>, z.core.$ZodTypeInternals<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>>>>;
+          state: z.ZodOptional<z.ZodObject<{
+            schema: z.ZodType<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>, z.core.$ZodTypeInternals<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>>>;
+            initial: z.ZodOptional<z.ZodType<_$_makaio_contracts0.JsonValue, unknown, z.core.$ZodTypeInternals<_$_makaio_contracts0.JsonValue, unknown>>>;
+          }, z.core.$strip>>;
           artifact: z.ZodOptional<z.ZodObject<{
             kind: z.ZodString;
             schemaVersion: z.ZodString;
@@ -716,6 +734,7 @@ declare const WorkflowStorageNamespace: _$_makaio_storage_core0.StorageNamespace
           "exit-and-resume": "exit-and-resume";
         }>>;
       }, z.core.$strip>;
+      initialState: z.ZodOptional<z.ZodType<_$_makaio_contracts0.JsonValue, unknown, z.core.$ZodTypeInternals<_$_makaio_contracts0.JsonValue, unknown>>>;
     }, z.core.$strip>;
     response: z.ZodObject<{
       id: z.ZodString;
@@ -730,8 +749,8 @@ declare const WorkflowStorageNamespace: _$_makaio_storage_core0.StorageNamespace
         completed: "completed";
         cancelled: "cancelled";
         failed: "failed";
-        running: "running";
         paused: "paused";
+        running: "running";
       }>>;
       error: z.ZodOptional<z.ZodNullable<z.ZodString>>;
       reason: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -799,8 +818,8 @@ declare const WorkflowStorageNamespace: _$_makaio_storage_core0.StorageNamespace
         completed: "completed";
         cancelled: "cancelled";
         failed: "failed";
-        running: "running";
         paused: "paused";
+        running: "running";
       }>>;
       artifactRef: z.ZodOptional<z.ZodObject<{
         kind: z.ZodString;
@@ -822,8 +841,8 @@ declare const WorkflowStorageNamespace: _$_makaio_storage_core0.StorageNamespace
           completed: "completed";
           cancelled: "cancelled";
           failed: "failed";
-          running: "running";
           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>>>>;
@@ -852,6 +871,58 @@ declare const WorkflowStorageNamespace: _$_makaio_storage_core0.StorageNamespace
       }, z.core.$strip>>;
     }, z.core.$strip>;
   };
+  /**
+   * Batch-fetch recent executions grouped by artifact reference.
+   * Internal storage implementation for the public `workflow.listExecutionsByArtifactRefs` subject.
+   */
+  listExecutionsByArtifactRefs: {
+    request: z.ZodObject<{
+      refs: z.ZodArray<z.ZodObject<{
+        kind: z.ZodString;
+        id: z.ZodString;
+      }, z.core.$strip>>;
+      limitPerRef: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>;
+    response: z.ZodObject<{
+      executionsByRef: z.ZodRecord<z.ZodString, z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        workflowId: z.ZodString;
+        coordinatorSessionId: z.ZodOptional<z.ZodString>;
+        status: z.ZodEnum<{
+          pending: "pending";
+          completed: "completed";
+          cancelled: "cancelled";
+          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>>>>;
+        startedAt: z.ZodNumber;
+        completedAt: z.ZodOptional<z.ZodNumber>;
+        error: z.ZodOptional<z.ZodString>;
+        reason: z.ZodOptional<z.ZodString>;
+        triggerPayload: z.ZodOptional<z.ZodType<Record<string, unknown>, Record<string, unknown>, z.core.$ZodTypeInternals<Record<string, unknown>, Record<string, unknown>>>>;
+        scope: 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>>;
+      }, z.core.$strip>>>;
+    }, z.core.$strip>;
+  };
   /**
    * Upsert a single execution frame by `frameId`.
    * Called by the runtime when a frame is created or transitions state.
@@ -865,12 +936,12 @@ declare const WorkflowStorageNamespace: _$_makaio_storage_core0.StorageNamespace
         frameId: z.ZodString;
         nodeId: z.ZodString;
         nodeType: z.ZodEnum<{
-          sequence: "sequence";
           station: "station";
           "delegate-agent": "delegate-agent";
           "delegate-role": "delegate-role";
-          parallel: "parallel";
+          sequence: "sequence";
           gate: "gate";
+          parallel: "parallel";
           iterate: "iterate";
           "iterate-chain": "iterate-chain";
         }>;
@@ -910,12 +981,12 @@ declare const WorkflowStorageNamespace: _$_makaio_storage_core0.StorageNamespace
         frameId: z.ZodString;
         nodeId: z.ZodString;
         nodeType: z.ZodEnum<{
-          sequence: "sequence";
           station: "station";
           "delegate-agent": "delegate-agent";
           "delegate-role": "delegate-role";
-          parallel: "parallel";
+          sequence: "sequence";
           gate: "gate";
+          parallel: "parallel";
           iterate: "iterate";
           "iterate-chain": "iterate-chain";
         }>;
@@ -952,12 +1023,12 @@ declare const WorkflowStorageNamespace: _$_makaio_storage_core0.StorageNamespace
         frameId: z.ZodString;
         nodeId: z.ZodString;
         nodeType: z.ZodEnum<{
-          sequence: "sequence";
           station: "station";
           "delegate-agent": "delegate-agent";
           "delegate-role": "delegate-role";
-          parallel: "parallel";
+          sequence: "sequence";
           gate: "gate";
+          parallel: "parallel";
           iterate: "iterate";
           "iterate-chain": "iterate-chain";
         }>;
@@ -1347,6 +1418,10 @@ declare const WorkflowStorageNamespace: _$_makaio_storage_core0.StorageNamespace
           inputSchema: z.ZodOptional<z.ZodType<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>, z.core.$ZodTypeInternals<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>>>>;
           configSchema: z.ZodOptional<z.ZodType<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>, z.core.$ZodTypeInternals<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>>>>;
           outputSchema: z.ZodOptional<z.ZodType<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>, z.core.$ZodTypeInternals<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>>>>;
+          state: z.ZodOptional<z.ZodObject<{
+            schema: z.ZodType<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>, z.core.$ZodTypeInternals<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>>>;
+            initial: z.ZodOptional<z.ZodType<_$_makaio_contracts0.JsonValue, unknown, z.core.$ZodTypeInternals<_$_makaio_contracts0.JsonValue, unknown>>>;
+          }, z.core.$strip>>;
           artifact: z.ZodOptional<z.ZodObject<{
             kind: z.ZodString;
             schemaVersion: z.ZodString;
@@ -1550,6 +1625,10 @@ declare const WorkflowStorageNamespace: _$_makaio_storage_core0.StorageNamespace
           inputSchema: z.ZodOptional<z.ZodType<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>, z.core.$ZodTypeInternals<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>>>>;
           configSchema: z.ZodOptional<z.ZodType<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>, z.core.$ZodTypeInternals<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>>>>;
           outputSchema: z.ZodOptional<z.ZodType<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>, z.core.$ZodTypeInternals<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>>>>;
+          state: z.ZodOptional<z.ZodObject<{
+            schema: z.ZodType<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>, z.core.$ZodTypeInternals<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>>>;
+            initial: z.ZodOptional<z.ZodType<_$_makaio_contracts0.JsonValue, unknown, z.core.$ZodTypeInternals<_$_makaio_contracts0.JsonValue, unknown>>>;
+          }, z.core.$strip>>;
           artifact: z.ZodOptional<z.ZodObject<{
             kind: z.ZodString;
             schemaVersion: z.ZodString;
@@ -1719,6 +1798,38 @@ declare const WorkflowStorageNamespace: _$_makaio_storage_core0.StorageNamespace
         }>>;
       }, z.core.$strip>>;
     }, z.core.$strip>;
+  }>; /** Initialize execution state snapshot at sequence 0. */
+  initializeState: _$_makaio_core0.LocalSubjectSchema<{
+    request: z.ZodObject<{
+      executionId: z.ZodString;
+      initialValue: z.ZodType<_$_makaio_contracts0.JsonValue, unknown, z.core.$ZodTypeInternals<_$_makaio_contracts0.JsonValue, unknown>>;
+    }, z.core.$strip>;
+    response: z.ZodObject<{}, z.core.$strip>;
+  }>; /** Read current execution state snapshot. */
+  getState: _$_makaio_core0.LocalSubjectSchema<{
+    request: z.ZodObject<{
+      executionId: z.ZodString;
+    }, z.core.$strip>;
+    response: z.ZodObject<{
+      state: z.ZodNullable<z.ZodObject<{
+        executionId: z.ZodString;
+        sequence: z.ZodNumber;
+        value: z.ZodType<_$_makaio_contracts0.JsonValue, unknown, z.core.$ZodTypeInternals<_$_makaio_contracts0.JsonValue, unknown>>;
+      }, z.core.$strip>>;
+    }, z.core.$strip>;
+  }>; /** Apply a state mutation with optimistic concurrency control. */
+  patchState: _$_makaio_core0.LocalSubjectSchema<{
+    request: z.ZodObject<{
+      executionId: z.ZodString;
+      expectedSequence: z.ZodNumber;
+      nextValue: z.ZodType<_$_makaio_contracts0.JsonValue, unknown, z.core.$ZodTypeInternals<_$_makaio_contracts0.JsonValue, unknown>>;
+    }, z.core.$strip>;
+    response: z.ZodObject<{
+      executionId: z.ZodString;
+      sequence: z.ZodNumber;
+      patch: z.ZodArray<z.ZodType<_$_makaio_contracts0.JsonPatchOperation, unknown, z.core.$ZodTypeInternals<_$_makaio_contracts0.JsonPatchOperation, unknown>>>;
+      value: z.ZodType<_$_makaio_contracts0.JsonValue, unknown, z.core.$ZodTypeInternals<_$_makaio_contracts0.JsonValue, unknown>>;
+    }, z.core.$strip>;
   }>;
 }, {
   drizzle: {
@@ -2086,6 +2197,31 @@ declare const WorkflowStorageNamespace: _$_makaio_storage_core0.StorageNamespace
         }, {}, {
           $type: Record<string, _$_makaio_contracts0.JsonValue>;
         }>;
+        state: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
+          name: string;
+          tableName: "workflow_definitions";
+          dataType: "json";
+          columnType: "SQLiteTextJson";
+          data: {
+            schema: Record<string, _$_makaio_contracts0.JsonValue>;
+            initial?: _$_makaio_contracts0.JsonValue | undefined;
+          };
+          driverParam: string;
+          notNull: false;
+          hasDefault: false;
+          isPrimaryKey: false;
+          isAutoincrement: false;
+          hasRuntimeDefault: false;
+          enumValues: undefined;
+          baseColumn: never;
+          identity: undefined;
+          generated: undefined;
+        }, {}, {
+          $type: {
+            schema: Record<string, _$_makaio_contracts0.JsonValue>;
+            initial?: _$_makaio_contracts0.JsonValue | undefined;
+          };
+        }>;
         artifact: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
           name: string;
           tableName: "workflow_definitions";
@@ -2331,7 +2467,7 @@ declare const WorkflowStorageNamespace: _$_makaio_storage_core0.StorageNamespace
           tableName: "workflow_executions";
           dataType: "string";
           columnType: "SQLiteText";
-          data: "pending" | "completed" | "cancelled" | "failed" | "running" | "paused";
+          data: "pending" | "completed" | "cancelled" | "failed" | "paused" | "running";
           driverParam: string;
           notNull: true;
           hasDefault: false;
@@ -2562,7 +2698,7 @@ declare const WorkflowStorageNamespace: _$_makaio_storage_core0.StorageNamespace
           tableName: "workflow_execution_frames";
           dataType: "string";
           columnType: "SQLiteText";
-          data: "sequence" | "station" | "delegate-agent" | "delegate-role" | "parallel" | "gate" | "iterate" | "iterate-chain";
+          data: "station" | "delegate-agent" | "delegate-role" | "sequence" | "gate" | "parallel" | "iterate" | "iterate-chain";
           driverParam: string;
           notNull: true;
           hasDefault: false;
@@ -2575,7 +2711,7 @@ declare const WorkflowStorageNamespace: _$_makaio_storage_core0.StorageNamespace
           generated: undefined;
         }, {}, {
           length: number | undefined;
-          $type: "sequence" | "station" | "delegate-agent" | "delegate-role" | "parallel" | "gate" | "iterate" | "iterate-chain";
+          $type: "station" | "delegate-agent" | "delegate-role" | "sequence" | "gate" | "parallel" | "iterate" | "iterate-chain";
         }>;
         path: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
           name: string;
@@ -3568,6 +3704,10 @@ declare const WorkflowStorageNamespace: _$_makaio_storage_core0.StorageNamespace
             inputSchema?: Record<string, _$_makaio_contracts0.JsonValue> | undefined;
             configSchema?: Record<string, _$_makaio_contracts0.JsonValue> | undefined;
             outputSchema?: Record<string, _$_makaio_contracts0.JsonValue> | undefined;
+            state?: {
+              schema: Record<string, _$_makaio_contracts0.JsonValue>;
+              initial?: _$_makaio_contracts0.JsonValue | undefined;
+            } | undefined;
             artifact?: {
               kind: string;
               schemaVersion: string;
@@ -3685,6 +3825,10 @@ declare const WorkflowStorageNamespace: _$_makaio_storage_core0.StorageNamespace
             inputSchema?: Record<string, _$_makaio_contracts0.JsonValue> | undefined;
             configSchema?: Record<string, _$_makaio_contracts0.JsonValue> | undefined;
             outputSchema?: Record<string, _$_makaio_contracts0.JsonValue> | undefined;
+            state?: {
+              schema: Record<string, _$_makaio_contracts0.JsonValue>;
+              initial?: _$_makaio_contracts0.JsonValue | undefined;
+            } | undefined;
             artifact?: {
               kind: string;
               schemaVersion: string;
@@ -4170,7 +4314,7 @@ declare const WorkflowStorageNamespace: _$_makaio_storage_core0.StorageNamespace
           tableName: "worklog_summaries";
           dataType: "string";
           columnType: "SQLiteText";
-          data: "pending" | "completed" | "cancelled" | "failed" | "running" | "paused";
+          data: "pending" | "completed" | "cancelled" | "failed" | "paused" | "running";
           driverParam: string;
           notNull: true;
           hasDefault: false;
@@ -4393,7 +4537,7 @@ declare const WorkflowStorageNamespace: _$_makaio_storage_core0.StorageNamespace
           tableName: "worklog_frame_entries";
           dataType: "string";
           columnType: "SQLiteText";
-          data: "sequence" | "station" | "delegate-agent" | "delegate-role" | "parallel" | "gate" | "iterate" | "iterate-chain";
+          data: "station" | "delegate-agent" | "delegate-role" | "sequence" | "gate" | "parallel" | "iterate" | "iterate-chain";
           driverParam: string;
           notNull: true;
           hasDefault: false;
@@ -4406,7 +4550,7 @@ declare const WorkflowStorageNamespace: _$_makaio_storage_core0.StorageNamespace
           generated: undefined;
         }, {}, {
           length: number | undefined;
-          $type: "sequence" | "station" | "delegate-agent" | "delegate-role" | "parallel" | "gate" | "iterate" | "iterate-chain";
+          $type: "station" | "delegate-agent" | "delegate-role" | "sequence" | "gate" | "parallel" | "iterate" | "iterate-chain";
         }>;
         path: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
           name: string;
@@ -4956,6 +5100,183 @@ declare const WorkflowStorageNamespace: _$_makaio_storage_core0.StorageNamespace
       };
       dialect: "sqlite";
     }>;
+    workflowExecutionState: _$drizzle_orm_sqlite_core0.SQLiteTableWithColumns<{
+      name: "workflow_execution_state";
+      schema: undefined;
+      columns: {
+        executionId: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
+          name: "execution_id";
+          tableName: "workflow_execution_state";
+          dataType: "string";
+          columnType: "SQLiteText";
+          data: string;
+          driverParam: string;
+          notNull: true;
+          hasDefault: false;
+          isPrimaryKey: true;
+          isAutoincrement: false;
+          hasRuntimeDefault: false;
+          enumValues: [string, ...string[]];
+          baseColumn: never;
+          identity: undefined;
+          generated: undefined;
+        }, {}, {
+          length: number | undefined;
+        }>;
+        sequence: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
+          name: string;
+          tableName: "workflow_execution_state";
+          dataType: "number";
+          columnType: "SQLiteInteger";
+          data: number;
+          driverParam: number;
+          notNull: true;
+          hasDefault: true;
+          isPrimaryKey: false;
+          isAutoincrement: false;
+          hasRuntimeDefault: false;
+          enumValues: undefined;
+          baseColumn: never;
+          identity: undefined;
+          generated: undefined;
+        }, {}, {}>;
+        value: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
+          name: string;
+          tableName: "workflow_execution_state";
+          dataType: "json";
+          columnType: "SQLiteTextJson";
+          data: _$_makaio_contracts0.JsonValue;
+          driverParam: string;
+          notNull: true;
+          hasDefault: false;
+          isPrimaryKey: false;
+          isAutoincrement: false;
+          hasRuntimeDefault: false;
+          enumValues: undefined;
+          baseColumn: never;
+          identity: undefined;
+          generated: undefined;
+        }, {}, {
+          $type: _$_makaio_contracts0.JsonValue;
+        }>;
+        updatedAt: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
+          name: string;
+          tableName: "workflow_execution_state";
+          dataType: "number";
+          columnType: "SQLiteInteger";
+          data: number;
+          driverParam: number;
+          notNull: true;
+          hasDefault: false;
+          isPrimaryKey: false;
+          isAutoincrement: false;
+          hasRuntimeDefault: false;
+          enumValues: undefined;
+          baseColumn: never;
+          identity: undefined;
+          generated: undefined;
+        }, {}, {}>;
+      };
+      dialect: "sqlite";
+    }>;
+    workflowExecutionStateEvents: _$drizzle_orm_sqlite_core0.SQLiteTableWithColumns<{
+      name: "workflow_execution_state_events";
+      schema: undefined;
+      columns: {
+        executionId: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
+          name: "execution_id";
+          tableName: "workflow_execution_state_events";
+          dataType: "string";
+          columnType: "SQLiteText";
+          data: string;
+          driverParam: string;
+          notNull: true;
+          hasDefault: false;
+          isPrimaryKey: false;
+          isAutoincrement: false;
+          hasRuntimeDefault: false;
+          enumValues: [string, ...string[]];
+          baseColumn: never;
+          identity: undefined;
+          generated: undefined;
+        }, {}, {
+          length: number | undefined;
+        }>;
+        sequence: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
+          name: string;
+          tableName: "workflow_execution_state_events";
+          dataType: "number";
+          columnType: "SQLiteInteger";
+          data: number;
+          driverParam: number;
+          notNull: true;
+          hasDefault: false;
+          isPrimaryKey: false;
+          isAutoincrement: false;
+          hasRuntimeDefault: false;
+          enumValues: undefined;
+          baseColumn: never;
+          identity: undefined;
+          generated: undefined;
+        }, {}, {}>;
+        patch: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
+          name: string;
+          tableName: "workflow_execution_state_events";
+          dataType: "json";
+          columnType: "SQLiteTextJson";
+          data: _$_makaio_contracts0.JsonPatchOperation[];
+          driverParam: string;
+          notNull: true;
+          hasDefault: false;
+          isPrimaryKey: false;
+          isAutoincrement: false;
+          hasRuntimeDefault: false;
+          enumValues: undefined;
+          baseColumn: never;
+          identity: undefined;
+          generated: undefined;
+        }, {}, {
+          $type: _$_makaio_contracts0.JsonPatchOperation[];
+        }>;
+        value: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
+          name: string;
+          tableName: "workflow_execution_state_events";
+          dataType: "json";
+          columnType: "SQLiteTextJson";
+          data: _$_makaio_contracts0.JsonValue;
+          driverParam: string;
+          notNull: true;
+          hasDefault: false;
+          isPrimaryKey: false;
+          isAutoincrement: false;
+          hasRuntimeDefault: false;
+          enumValues: undefined;
+          baseColumn: never;
+          identity: undefined;
+          generated: undefined;
+        }, {}, {
+          $type: _$_makaio_contracts0.JsonValue;
+        }>;
+        createdAt: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
+          name: string;
+          tableName: "workflow_execution_state_events";
+          dataType: "number";
+          columnType: "SQLiteInteger";
+          data: number;
+          driverParam: number;
+          notNull: true;
+          hasDefault: false;
+          isPrimaryKey: false;
+          isAutoincrement: false;
+          hasRuntimeDefault: false;
+          enumValues: undefined;
+          baseColumn: never;
+          identity: undefined;
+          generated: undefined;
+        }, {}, {}>;
+      };
+      dialect: "sqlite";
+    }>;
   };
 }>;
 declare const WorkflowStorageSubjects: _$_makaio_core0.BusSubjects<_$_makaio_core0.FlatSubjectDefinitions<"storage:workflow", {
@@ -4971,6 +5292,10 @@ declare const WorkflowStorageSubjects: _$_makaio_core0.BusSubjects<_$_makaio_cor
         inputSchema: z.ZodOptional<z.ZodType<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>, z.core.$ZodTypeInternals<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>>>>;
         configSchema: z.ZodOptional<z.ZodType<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>, z.core.$ZodTypeInternals<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>>>>;
         outputSchema: z.ZodOptional<z.ZodType<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>, z.core.$ZodTypeInternals<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>>>>;
+        state: z.ZodOptional<z.ZodObject<{
+          schema: z.ZodType<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>, z.core.$ZodTypeInternals<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>>>;
+          initial: z.ZodOptional<z.ZodType<_$_makaio_contracts0.JsonValue, unknown, z.core.$ZodTypeInternals<_$_makaio_contracts0.JsonValue, unknown>>>;
+        }, z.core.$strip>>;
         artifact: z.ZodOptional<z.ZodObject<{
           kind: z.ZodString;
           schemaVersion: z.ZodString;
@@ -5083,6 +5408,10 @@ declare const WorkflowStorageSubjects: _$_makaio_core0.BusSubjects<_$_makaio_cor
         inputSchema: z.ZodOptional<z.ZodType<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>, z.core.$ZodTypeInternals<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>>>>;
         configSchema: z.ZodOptional<z.ZodType<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>, z.core.$ZodTypeInternals<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>>>>;
         outputSchema: z.ZodOptional<z.ZodType<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>, z.core.$ZodTypeInternals<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>>>>;
+        state: z.ZodOptional<z.ZodObject<{
+          schema: z.ZodType<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>, z.core.$ZodTypeInternals<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>>>;
+          initial: z.ZodOptional<z.ZodType<_$_makaio_contracts0.JsonValue, unknown, z.core.$ZodTypeInternals<_$_makaio_contracts0.JsonValue, unknown>>>;
+        }, z.core.$strip>>;
         artifact: z.ZodOptional<z.ZodObject<{
           kind: z.ZodString;
           schemaVersion: z.ZodString;
@@ -5221,6 +5550,10 @@ declare const WorkflowStorageSubjects: _$_makaio_core0.BusSubjects<_$_makaio_cor
         inputSchema: z.ZodOptional<z.ZodType<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>, z.core.$ZodTypeInternals<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>>>>;
         configSchema: z.ZodOptional<z.ZodType<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>, z.core.$ZodTypeInternals<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>>>>;
         outputSchema: z.ZodOptional<z.ZodType<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>, z.core.$ZodTypeInternals<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>>>>;
+        state: z.ZodOptional<z.ZodObject<{
+          schema: z.ZodType<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>, z.core.$ZodTypeInternals<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>>>;
+          initial: z.ZodOptional<z.ZodType<_$_makaio_contracts0.JsonValue, unknown, z.core.$ZodTypeInternals<_$_makaio_contracts0.JsonValue, unknown>>>;
+        }, z.core.$strip>>;
         artifact: z.ZodOptional<z.ZodObject<{
           kind: z.ZodString;
           schemaVersion: z.ZodString;
@@ -5338,8 +5671,8 @@ declare const WorkflowStorageSubjects: _$_makaio_core0.BusSubjects<_$_makaio_cor
           completed: "completed";
           cancelled: "cancelled";
           failed: "failed";
-          running: "running";
           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>>>>;
@@ -5379,8 +5712,8 @@ declare const WorkflowStorageSubjects: _$_makaio_core0.BusSubjects<_$_makaio_cor
           completed: "completed";
           cancelled: "cancelled";
           failed: "failed";
-          running: "running";
           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>>>>;
@@ -5427,8 +5760,8 @@ declare const WorkflowStorageSubjects: _$_makaio_core0.BusSubjects<_$_makaio_cor
           completed: "completed";
           cancelled: "cancelled";
           failed: "failed";
-          running: "running";
           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>>>>;
@@ -5476,6 +5809,10 @@ declare const WorkflowStorageSubjects: _$_makaio_core0.BusSubjects<_$_makaio_cor
           inputSchema: z.ZodOptional<z.ZodType<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>, z.core.$ZodTypeInternals<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>>>>;
           configSchema: z.ZodOptional<z.ZodType<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>, z.core.$ZodTypeInternals<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>>>>;
           outputSchema: z.ZodOptional<z.ZodType<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>, z.core.$ZodTypeInternals<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>>>>;
+          state: z.ZodOptional<z.ZodObject<{
+            schema: z.ZodType<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>, z.core.$ZodTypeInternals<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>>>;
+            initial: z.ZodOptional<z.ZodType<_$_makaio_contracts0.JsonValue, unknown, z.core.$ZodTypeInternals<_$_makaio_contracts0.JsonValue, unknown>>>;
+          }, z.core.$strip>>;
           artifact: z.ZodOptional<z.ZodObject<{
             kind: z.ZodString;
             schemaVersion: z.ZodString;
@@ -5644,6 +5981,7 @@ declare const WorkflowStorageSubjects: _$_makaio_core0.BusSubjects<_$_makaio_cor
           "exit-and-resume": "exit-and-resume";
         }>>;
       }, z.core.$strip>;
+      initialState: z.ZodOptional<z.ZodType<_$_makaio_contracts0.JsonValue, unknown, z.core.$ZodTypeInternals<_$_makaio_contracts0.JsonValue, unknown>>>;
     }, z.core.$strip>;
     response: z.ZodObject<{
       id: z.ZodString;
@@ -5658,8 +5996,8 @@ declare const WorkflowStorageSubjects: _$_makaio_core0.BusSubjects<_$_makaio_cor
         completed: "completed";
         cancelled: "cancelled";
         failed: "failed";
-        running: "running";
         paused: "paused";
+        running: "running";
       }>>;
       error: z.ZodOptional<z.ZodNullable<z.ZodString>>;
       reason: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -5727,8 +6065,8 @@ declare const WorkflowStorageSubjects: _$_makaio_core0.BusSubjects<_$_makaio_cor
         completed: "completed";
         cancelled: "cancelled";
         failed: "failed";
-        running: "running";
         paused: "paused";
+        running: "running";
       }>>;
       artifactRef: z.ZodOptional<z.ZodObject<{
         kind: z.ZodString;
@@ -5750,8 +6088,8 @@ declare const WorkflowStorageSubjects: _$_makaio_core0.BusSubjects<_$_makaio_cor
           completed: "completed";
           cancelled: "cancelled";
           failed: "failed";
-          running: "running";
           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>>>>;
@@ -5780,6 +6118,58 @@ declare const WorkflowStorageSubjects: _$_makaio_core0.BusSubjects<_$_makaio_cor
       }, z.core.$strip>>;
     }, z.core.$strip>;
   };
+  /**
+   * Batch-fetch recent executions grouped by artifact reference.
+   * Internal storage implementation for the public `workflow.listExecutionsByArtifactRefs` subject.
+   */
+  listExecutionsByArtifactRefs: {
+    request: z.ZodObject<{
+      refs: z.ZodArray<z.ZodObject<{
+        kind: z.ZodString;
+        id: z.ZodString;
+      }, z.core.$strip>>;
+      limitPerRef: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>;
+    response: z.ZodObject<{
+      executionsByRef: z.ZodRecord<z.ZodString, z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        workflowId: z.ZodString;
+        coordinatorSessionId: z.ZodOptional<z.ZodString>;
+        status: z.ZodEnum<{
+          pending: "pending";
+          completed: "completed";
+          cancelled: "cancelled";
+          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>>>>;
+        startedAt: z.ZodNumber;
+        completedAt: z.ZodOptional<z.ZodNumber>;
+        error: z.ZodOptional<z.ZodString>;
+        reason: z.ZodOptional<z.ZodString>;
+        triggerPayload: z.ZodOptional<z.ZodType<Record<string, unknown>, Record<string, unknown>, z.core.$ZodTypeInternals<Record<string, unknown>, Record<string, unknown>>>>;
+        scope: 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>>;
+      }, z.core.$strip>>>;
+    }, z.core.$strip>;
+  };
   /**
    * Upsert a single execution frame by `frameId`.
    * Called by the runtime when a frame is created or transitions state.
@@ -5793,12 +6183,12 @@ declare const WorkflowStorageSubjects: _$_makaio_core0.BusSubjects<_$_makaio_cor
         frameId: z.ZodString;
         nodeId: z.ZodString;
         nodeType: z.ZodEnum<{
-          sequence: "sequence";
           station: "station";
           "delegate-agent": "delegate-agent";
           "delegate-role": "delegate-role";
-          parallel: "parallel";
+          sequence: "sequence";
           gate: "gate";
+          parallel: "parallel";
           iterate: "iterate";
           "iterate-chain": "iterate-chain";
         }>;
@@ -5838,12 +6228,12 @@ declare const WorkflowStorageSubjects: _$_makaio_core0.BusSubjects<_$_makaio_cor
         frameId: z.ZodString;
         nodeId: z.ZodString;
         nodeType: z.ZodEnum<{
-          sequence: "sequence";
           station: "station";
           "delegate-agent": "delegate-agent";
           "delegate-role": "delegate-role";
-          parallel: "parallel";
+          sequence: "sequence";
           gate: "gate";
+          parallel: "parallel";
           iterate: "iterate";
           "iterate-chain": "iterate-chain";
         }>;
@@ -5880,12 +6270,12 @@ declare const WorkflowStorageSubjects: _$_makaio_core0.BusSubjects<_$_makaio_cor
         frameId: z.ZodString;
         nodeId: z.ZodString;
         nodeType: z.ZodEnum<{
-          sequence: "sequence";
           station: "station";
           "delegate-agent": "delegate-agent";
           "delegate-role": "delegate-role";
-          parallel: "parallel";
+          sequence: "sequence";
           gate: "gate";
+          parallel: "parallel";
           iterate: "iterate";
           "iterate-chain": "iterate-chain";
         }>;
@@ -6275,6 +6665,10 @@ declare const WorkflowStorageSubjects: _$_makaio_core0.BusSubjects<_$_makaio_cor
           inputSchema: z.ZodOptional<z.ZodType<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>, z.core.$ZodTypeInternals<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>>>>;
           configSchema: z.ZodOptional<z.ZodType<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>, z.core.$ZodTypeInternals<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>>>>;
           outputSchema: z.ZodOptional<z.ZodType<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>, z.core.$ZodTypeInternals<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>>>>;
+          state: z.ZodOptional<z.ZodObject<{
+            schema: z.ZodType<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>, z.core.$ZodTypeInternals<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>>>;
+            initial: z.ZodOptional<z.ZodType<_$_makaio_contracts0.JsonValue, unknown, z.core.$ZodTypeInternals<_$_makaio_contracts0.JsonValue, unknown>>>;
+          }, z.core.$strip>>;
           artifact: z.ZodOptional<z.ZodObject<{
             kind: z.ZodString;
             schemaVersion: z.ZodString;
@@ -6478,6 +6872,10 @@ declare const WorkflowStorageSubjects: _$_makaio_core0.BusSubjects<_$_makaio_cor
           inputSchema: z.ZodOptional<z.ZodType<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>, z.core.$ZodTypeInternals<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>>>>;
           configSchema: z.ZodOptional<z.ZodType<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>, z.core.$ZodTypeInternals<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>>>>;
           outputSchema: z.ZodOptional<z.ZodType<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>, z.core.$ZodTypeInternals<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>>>>;
+          state: z.ZodOptional<z.ZodObject<{
+            schema: z.ZodType<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>, z.core.$ZodTypeInternals<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>>>;
+            initial: z.ZodOptional<z.ZodType<_$_makaio_contracts0.JsonValue, unknown, z.core.$ZodTypeInternals<_$_makaio_contracts0.JsonValue, unknown>>>;
+          }, z.core.$strip>>;
           artifact: z.ZodOptional<z.ZodObject<{
             kind: z.ZodString;
             schemaVersion: z.ZodString;
@@ -6647,6 +7045,38 @@ declare const WorkflowStorageSubjects: _$_makaio_core0.BusSubjects<_$_makaio_cor
         }>>;
       }, z.core.$strip>>;
     }, z.core.$strip>;
+  }>; /** Initialize execution state snapshot at sequence 0. */
+  initializeState: _$_makaio_core0.LocalSubjectSchema<{
+    request: z.ZodObject<{
+      executionId: z.ZodString;
+      initialValue: z.ZodType<_$_makaio_contracts0.JsonValue, unknown, z.core.$ZodTypeInternals<_$_makaio_contracts0.JsonValue, unknown>>;
+    }, z.core.$strip>;
+    response: z.ZodObject<{}, z.core.$strip>;
+  }>; /** Read current execution state snapshot. */
+  getState: _$_makaio_core0.LocalSubjectSchema<{
+    request: z.ZodObject<{
+      executionId: z.ZodString;
+    }, z.core.$strip>;
+    response: z.ZodObject<{
+      state: z.ZodNullable<z.ZodObject<{
+        executionId: z.ZodString;
+        sequence: z.ZodNumber;
+        value: z.ZodType<_$_makaio_contracts0.JsonValue, unknown, z.core.$ZodTypeInternals<_$_makaio_contracts0.JsonValue, unknown>>;
+      }, z.core.$strip>>;
+    }, z.core.$strip>;
+  }>; /** Apply a state mutation with optimistic concurrency control. */
+  patchState: _$_makaio_core0.LocalSubjectSchema<{
+    request: z.ZodObject<{
+      executionId: z.ZodString;
+      expectedSequence: z.ZodNumber;
+      nextValue: z.ZodType<_$_makaio_contracts0.JsonValue, unknown, z.core.$ZodTypeInternals<_$_makaio_contracts0.JsonValue, unknown>>;
+    }, z.core.$strip>;
+    response: z.ZodObject<{
+      executionId: z.ZodString;
+      sequence: z.ZodNumber;
+      patch: z.ZodArray<z.ZodType<_$_makaio_contracts0.JsonPatchOperation, unknown, z.core.$ZodTypeInternals<_$_makaio_contracts0.JsonPatchOperation, unknown>>>;
+      value: z.ZodType<_$_makaio_contracts0.JsonValue, unknown, z.core.$ZodTypeInternals<_$_makaio_contracts0.JsonValue, unknown>>;
+    }, z.core.$strip>;
   }>;
 }>, "storage:workflow">;
 //#endregion
@@ -6813,7 +7243,14 @@ declare const workflowDefinitionsDual: _$_makaio_storage_drizzle0.DualTable<"wor
   }>>>; /** JSON Schema for workflow input parameters (JSON object). */
   inputSchema: _$_makaio_storage_drizzle0.DualBuilder<_$drizzle_orm0.$Type<_$drizzle_orm_sqlite_core0.SQLiteTextJsonBuilderInitial<string>, Record<string, JsonValue>>, _$drizzle_orm0.$Type<_$drizzle_orm_pg_core0.PgJsonbBuilderInitial<string>, Record<string, JsonValue>>>; /** JSON Schema for static workflow configuration (JSON object). */
   configSchema: _$_makaio_storage_drizzle0.DualBuilder<_$drizzle_orm0.$Type<_$drizzle_orm_sqlite_core0.SQLiteTextJsonBuilderInitial<string>, Record<string, JsonValue>>, _$drizzle_orm0.$Type<_$drizzle_orm_pg_core0.PgJsonbBuilderInitial<string>, Record<string, JsonValue>>>; /** JSON Schema for the workflow's primary output (JSON object). */
-  outputSchema: _$_makaio_storage_drizzle0.DualBuilder<_$drizzle_orm0.$Type<_$drizzle_orm_sqlite_core0.SQLiteTextJsonBuilderInitial<string>, Record<string, JsonValue>>, _$drizzle_orm0.$Type<_$drizzle_orm_pg_core0.PgJsonbBuilderInitial<string>, Record<string, JsonValue>>>; /** Primary artifact binding for workflow output/state (JSON object). */
+  outputSchema: _$_makaio_storage_drizzle0.DualBuilder<_$drizzle_orm0.$Type<_$drizzle_orm_sqlite_core0.SQLiteTextJsonBuilderInitial<string>, Record<string, JsonValue>>, _$drizzle_orm0.$Type<_$drizzle_orm_pg_core0.PgJsonbBuilderInitial<string>, Record<string, JsonValue>>>; /** Optional state contract for run-scoped mutable state (JSON object). */
+  state: _$_makaio_storage_drizzle0.DualBuilder<_$drizzle_orm0.$Type<_$drizzle_orm_sqlite_core0.SQLiteTextJsonBuilderInitial<string>, {
+    schema: Record<string, JsonValue>;
+    initial?: JsonValue | undefined;
+  }>, _$drizzle_orm0.$Type<_$drizzle_orm_pg_core0.PgJsonbBuilderInitial<string>, {
+    schema: Record<string, JsonValue>;
+    initial?: JsonValue | undefined;
+  }>>; /** Primary artifact binding declared by the workflow (JSON object). */
   artifact: _$_makaio_storage_drizzle0.DualBuilder<_$drizzle_orm0.$Type<_$drizzle_orm_sqlite_core0.SQLiteTextJsonBuilderInitial<string>, {
     kind: string;
     schemaVersion: string;
@@ -6975,7 +7412,7 @@ declare const worklogFrameEntriesDual: _$_makaio_storage_drizzle0.DualTable<"wor
   /** Unique frame identifier within the execution. */frameId: _$_makaio_storage_drizzle0.DualBuilder<_$drizzle_orm0.IsPrimaryKey<_$drizzle_orm0.NotNull<_$drizzle_orm_sqlite_core0.SQLiteTextBuilderInitial<"frame_id", [string, ...string[]], number | undefined>>>, _$drizzle_orm0.IsPrimaryKey<_$drizzle_orm0.NotNull<_$drizzle_orm_pg_core0.PgTextBuilderInitial<"frame_id", [string, ...string[]]>>>>; /** Execution this frame belongs to. */
   executionId: _$_makaio_storage_drizzle0.DualBuilder<_$drizzle_orm0.NotNull<_$drizzle_orm_sqlite_core0.SQLiteTextBuilderInitial<"execution_id", [string, ...string[]], number | undefined>>, _$drizzle_orm0.NotNull<_$drizzle_orm_pg_core0.PgTextBuilderInitial<"execution_id", [string, ...string[]]>>>; /** Node identifier from the workflow definition. */
   nodeId: _$_makaio_storage_drizzle0.DualBuilder<_$drizzle_orm0.NotNull<_$drizzle_orm_sqlite_core0.SQLiteTextBuilderInitial<"node_id", [string, ...string[]], number | undefined>>, _$drizzle_orm0.NotNull<_$drizzle_orm_pg_core0.PgTextBuilderInitial<"node_id", [string, ...string[]]>>>; /** Node type discriminant. */
-  nodeType: _$_makaio_storage_drizzle0.DualBuilder<_$drizzle_orm0.$Type<_$drizzle_orm0.NotNull<_$drizzle_orm_sqlite_core0.SQLiteTextBuilderInitial<"node_type", [string, ...string[]], number | undefined>>, "sequence" | "station" | "delegate-agent" | "delegate-role" | "parallel" | "gate" | "iterate" | "iterate-chain">, _$drizzle_orm0.$Type<_$drizzle_orm0.NotNull<_$drizzle_orm_pg_core0.PgTextBuilderInitial<"node_type", [string, ...string[]]>>, "sequence" | "station" | "delegate-agent" | "delegate-role" | "parallel" | "gate" | "iterate" | "iterate-chain">>;
+  nodeType: _$_makaio_storage_drizzle0.DualBuilder<_$drizzle_orm0.$Type<_$drizzle_orm0.NotNull<_$drizzle_orm_sqlite_core0.SQLiteTextBuilderInitial<"node_type", [string, ...string[]], number | undefined>>, "station" | "delegate-agent" | "delegate-role" | "sequence" | "gate" | "parallel" | "iterate" | "iterate-chain">, _$drizzle_orm0.$Type<_$drizzle_orm0.NotNull<_$drizzle_orm_pg_core0.PgTextBuilderInitial<"node_type", [string, ...string[]]>>, "station" | "delegate-agent" | "delegate-role" | "sequence" | "gate" | "parallel" | "iterate" | "iterate-chain">>;
   /**
    * Ordered path of frame IDs from the root frame to this frame (inclusive).
    * Stored as a JSON array for tree correlation.
@@ -6993,5 +7430,87 @@ declare const worklogFrameEntriesDual: _$_makaio_storage_drizzle0.DualTable<"wor
   estimatedCost: _$_makaio_storage_drizzle0.DualBuilder<_$drizzle_orm_sqlite_core0.SQLiteRealBuilderInitial<string>, _$drizzle_orm_pg_core0.PgDoublePrecisionBuilderInitial<string>>; /** Human-readable error message when `status` is `'failed'`. */
   error: _$_makaio_storage_drizzle0.DualBuilder<_$drizzle_orm_sqlite_core0.SQLiteTextBuilderInitial<"error", [string, ...string[]], number | undefined>, _$drizzle_orm_pg_core0.PgTextBuilderInitial<"error", [string, ...string[]]>>;
 }>;
+/**
+ * Workflow execution state snapshot table.
+ *
+ * Stores the latest state value for each execution. Updated in place via
+ * optimistic-concurrency patches through the `patchWorkflowState` handler.
+ * The `sequence` column is a monotonically increasing counter used for
+ * compare-and-set conflict detection.
+ *
+ * CENTRAL tier — migrated alongside `workflow_executions`.
+ */
+declare const workflowExecutionStateDual: _$_makaio_storage_drizzle0.DualTable<"workflow_execution_state", {
+  /** Execution this state belongs to (1:1 with workflow_executions.id). */executionId: _$_makaio_storage_drizzle0.DualBuilder<_$drizzle_orm0.IsPrimaryKey<_$drizzle_orm0.NotNull<_$drizzle_orm_sqlite_core0.SQLiteTextBuilderInitial<"execution_id", [string, ...string[]], number | undefined>>>, _$drizzle_orm0.IsPrimaryKey<_$drizzle_orm0.NotNull<_$drizzle_orm_pg_core0.PgTextBuilderInitial<"execution_id", [string, ...string[]]>>>>; /** Monotonically increasing sequence number for optimistic concurrency. */
+  sequence: _$_makaio_storage_drizzle0.DualBuilder<_$drizzle_orm0.HasDefault<_$drizzle_orm0.NotNull<_$drizzle_orm_sqlite_core0.SQLiteIntegerBuilderInitial<string>>>, _$drizzle_orm0.HasDefault<_$drizzle_orm0.NotNull<_$drizzle_orm_pg_core0.PgIntegerBuilderInitial<string>>>>; /** Current state value (JSON). */
+  value: _$_makaio_storage_drizzle0.DualBuilder<_$drizzle_orm0.NotNull<_$drizzle_orm0.$Type<_$drizzle_orm_sqlite_core0.SQLiteTextJsonBuilderInitial<string>, JsonValue>>, _$drizzle_orm0.NotNull<_$drizzle_orm0.$Type<_$drizzle_orm_pg_core0.PgJsonbBuilderInitial<string>, JsonValue>>>; /** Last update timestamp (epoch ms). */
+  updatedAt: _$_makaio_storage_drizzle0.DualBuilder<_$drizzle_orm0.NotNull<_$drizzle_orm_sqlite_core0.SQLiteIntegerBuilderInitial<string>>, _$drizzle_orm0.NotNull<_$drizzle_orm_pg_core0.PgBigInt53BuilderInitial<string>>>;
+}>;
+/**
+ * Workflow execution state mutation log table.
+ *
+ * Append-only log of every state mutation applied to an execution. Each row
+ * records the JSON-Patch array (`patch`) and the resulting full value
+ * (`value`) at the given `sequence` number. Used for audit trails,
+ * debugging, and eventual replay.
+ *
+ * CENTRAL tier — migrated alongside `workflow_executions`.
+ */
+declare const workflowExecutionStateEventsDual: _$_makaio_storage_drizzle0.DualTable<"workflow_execution_state_events", {
+  /** Execution this event belongs to. */executionId: _$_makaio_storage_drizzle0.DualBuilder<_$drizzle_orm0.NotNull<_$drizzle_orm_sqlite_core0.SQLiteTextBuilderInitial<"execution_id", [string, ...string[]], number | undefined>>, _$drizzle_orm0.NotNull<_$drizzle_orm_pg_core0.PgTextBuilderInitial<"execution_id", [string, ...string[]]>>>; /** Sequence number of the mutation (matches the snapshot sequence after apply). */
+  sequence: _$_makaio_storage_drizzle0.DualBuilder<_$drizzle_orm0.NotNull<_$drizzle_orm_sqlite_core0.SQLiteIntegerBuilderInitial<string>>, _$drizzle_orm0.NotNull<_$drizzle_orm_pg_core0.PgIntegerBuilderInitial<string>>>; /** JSON-Patch operations applied in this mutation (JSON array). */
+  patch: _$_makaio_storage_drizzle0.DualBuilder<_$drizzle_orm0.NotNull<_$drizzle_orm0.$Type<_$drizzle_orm_sqlite_core0.SQLiteTextJsonBuilderInitial<string>, JsonPatchOperation[]>>, _$drizzle_orm0.NotNull<_$drizzle_orm0.$Type<_$drizzle_orm_pg_core0.PgJsonbBuilderInitial<string>, JsonPatchOperation[]>>>; /** Full state value after applying the patch (JSON). */
+  value: _$_makaio_storage_drizzle0.DualBuilder<_$drizzle_orm0.NotNull<_$drizzle_orm0.$Type<_$drizzle_orm_sqlite_core0.SQLiteTextJsonBuilderInitial<string>, JsonValue>>, _$drizzle_orm0.NotNull<_$drizzle_orm0.$Type<_$drizzle_orm_pg_core0.PgJsonbBuilderInitial<string>, JsonValue>>>; /** Mutation timestamp (epoch ms). */
+  createdAt: _$_makaio_storage_drizzle0.DualBuilder<_$drizzle_orm0.NotNull<_$drizzle_orm_sqlite_core0.SQLiteIntegerBuilderInitial<string>>, _$drizzle_orm0.NotNull<_$drizzle_orm_pg_core0.PgBigInt53BuilderInitial<string>>>;
+}>;
+//#endregion
+//#region subsystems/workflow-engine/src/storage/state-handler.d.ts
+/**
+ * Initialize workflow state for an execution.
+ *
+ * Creates the initial state snapshot row with sequence 0 and appends a
+ * corresponding entry to the mutation log. If a state row already exists
+ * for the given execution, the insert is a no-op (idempotent) to prevent
+ * a restart or re-init from overwriting live state.
+ * @param db - Database instance.
+ * @param executionId - Execution to initialize state for.
+ * @param initialValue - Initial state value.
+ */
+declare function initializeWorkflowState(db: MakaioDatabase, executionId: string, initialValue: JsonValue): Promise<void>;
+/**
+ * Get the current state snapshot for an execution.
+ * @param db - Database instance.
+ * @param executionId - Execution to get state for.
+ * @returns Current state with sequence number, or null if no state exists.
+ */
+declare function getWorkflowState(db: MakaioDatabase, executionId: string): Promise<{
+  executionId: string;
+  sequence: number;
+  value: JsonValue;
+} | null>;
+/**
+ * Apply a state mutation with optimistic concurrency control.
+ *
+ * Atomically updates the snapshot and appends a mutation log entry. The
+ * persisted patch is derived from the stored current value and accepted next
+ * value so the append-only event log always reflects the actual snapshot
+ * transition.
+ * Throws when the current sequence does not match `expectedSequence`.
+ * @param db - Database instance
+ * @param params - Patch parameters including executionId, expectedSequence, and nextValue
+ * @returns The new state with updated sequence number.
+ * @throws Error with message containing 'state sequence conflict' when expectedSequence doesn't match.
+ * @throws Error when no state exists for the given execution.
+ */
+declare function patchWorkflowState(db: MakaioDatabase, params: {
+  executionId: string;
+  expectedSequence: number;
+  nextValue: JsonValue;
+}): Promise<{
+  executionId: string;
+  sequence: number;
+  patch: JsonPatchOperation[];
+  value: JsonValue;
+}>;
 //#endregion
-export { WorkflowEngineService, WorkflowEngineToken, WorkflowExecutor, WorkflowStorageNamespace, WorkflowStorageSubjects, buildWorkflowExpressionContextFromResolvedInputs, createWorkflowEnginePackage, registerDrizzleWorkflowStorage, runShellStep, workflowDefinitionsDual, workflowEnginePackage, workflowExecutionsDual, workflowStepSpansDual, worklogFrameEntriesDual, worklogSummariesDual };
+export { WorkflowEngineService, WorkflowEngineToken, WorkflowExecutor, WorkflowStorageNamespace, WorkflowStorageSubjects, buildWorkflowExpressionContextFromResolvedInputs, createWorkflowEnginePackage, getWorkflowState, initializeWorkflowState, patchWorkflowState, registerDrizzleWorkflowStorage, runShellStep, workflowDefinitionsDual, workflowEnginePackage, workflowExecutionStateDual, workflowExecutionStateEventsDual, workflowExecutionsDual, workflowStepSpansDual, worklogFrameEntriesDual, worklogSummariesDual };