@osovv/vv-opencode 1.3.8 → 1.4.0

package/dist/plugins/workflow/persistence.d.ts

@@ -1,10 +1,12 @@
+import type { DelegatedPlanRun, DelegatedRunCheckpoint } from "./checkpoints.js";
 import type { WorkItemRecord, WorkItemStoreData } from "./state.js";
+export declare const PERSISTED_WORKFLOW_STATE_VERSION = 2;
 /**
- * JSON-serializable shape of a per-session workflow state.
- * Maps are converted to plain objects for JSON compatibility.
+ * JSON-serializable shape of a per-session workflow state. Version 1 legacy
+ * files lack planRuns; version 2 files carry delegated and plan-run state.
  */
 export type PersistedWorkflowState = {
-    version: 1;
+    version: 1 | 2;
     updatedAt: string;
     sessionId: string;
     nextId: number;
@@ -12,12 +14,39 @@ export type PersistedWorkflowState = {
     records: WorkItemRecord[];
     /** key -> workItemId lookup for idempotent open-by-key. */
     keyIndex: Record<string, string>;
+    /** Version 2 only: registered delegated plan runs. */
+    planRuns?: SerializedDelegatedPlanRun[];
+};
+/** JSON form of one registered plan run with maps flattened to arrays. */
+export type SerializedDelegatedPlanRun = Omit<DelegatedPlanRun, "tasks" | "checkpoints"> & {
+    tasks: Array<{
+        taskId: string;
+        workItemId: string;
+    }>;
+    checkpoints: DelegatedRunCheckpoint[];
+};
+export type HydratedWorkflowStateResult = {
+    status: "missing";
+} | {
+    status: "valid";
+    data: WorkItemStoreData;
+} | {
+    status: "invalid";
+    errors: string[];
+};
+export type SnapshotWorkflowStateResult = {
+    ok: true;
+} | {
+    ok: false;
+    error: string;
 };
 /**
  * Resolve the per-session workflow data directory.
  * Path: $XDG_DATA_HOME/vvoc/workflow/<sessionId>/
  */
 export declare function getWorkflowSessionDir(sessionId: string): string;
+export declare function hydrateWorkflowStateChecked(sessionId: string): HydratedWorkflowStateResult;
 export declare function hydrateWorkflowState(sessionId: string): WorkItemStoreData | null;
+export declare function snapshotWorkflowStateChecked(sessionId: string, data: WorkItemStoreData): SnapshotWorkflowStateResult;
 export declare function snapshotWorkflowState(sessionId: string, data: WorkItemStoreData): void;
 export declare function deleteWorkflowSessionDir(sessionId: string): Promise<void>;