@osolmaz/pi-workflows 0.16.1 → 0.16.3

package/dist/workflows/store.js

@@ -68,7 +68,7 @@ export class WorkflowRunStore {
     state;
     authorityProvider;
     snapshotLifecycle;
-    allowHostSessionRecording;
+    allowServerSessionRecording;
     contexts = new Map();
     ownsState;
     mutations;
@@ -76,7 +76,7 @@ export class WorkflowRunStore {
     constructor(databasePath = workflowStatePath(), options = {}) {
         this.authorityProvider = options.authorityProvider;
         this.snapshotLifecycle = options.snapshotLifecycle;
-        this.allowHostSessionRecording = options.allowHostSessionRecording === true;
+        this.allowServerSessionRecording = options.allowServerSessionRecording === true;
         this.ownsState = options.state === undefined;
         this.state =
             options.state ??
@@ -93,7 +93,7 @@ export class WorkflowRunStore {
         if (this.ownsState)
             this.state.close();
     }
-    /** Host-only synchronization after a queue lifecycle mutation on the run resource. */
+    /** Server-only synchronization after a queue lifecycle mutation on the run resource. */
     synchronizeRevision(runId) {
         const revision = this.resourceRevision(runId);
         const context = this.contexts.get(runId);
@@ -712,11 +712,11 @@ export class WorkflowRunStore {
         return { runId, originSessionId, followUps };
     }
     async prepareRunResume(runId) {
-        const loaded = this.readRun(runId, { includeTrace: true });
-        if (loaded === null)
+        const state = this.readRunState(runId);
+        if (state === null)
             throw new Error(`Cannot resume unreadable workflow run: ${runId}`);
-        if (loaded.state.status !== "running") {
-            throw new Error(`Cannot resume workflow run ${runId} with status ${loaded.state.status}`);
+        if (state.status !== "running") {
+            throw new Error(`Cannot resume workflow run ${runId} with status ${state.status}`);
         }
         this.verifySettingsProjections(runId);
         const revision = this.resourceRevision(runId);
@@ -742,18 +742,18 @@ export class WorkflowRunStore {
                 payload: {},
             };
             insertRunEvent(this.state, row.resourceId, nextRevision, at, traceEvent);
-            loaded.state.traceSeq = nextRevision;
-            loaded.state.updatedAt = at;
-            this.persistRunState(row, loaded.state, nextRevision, now);
-            recordViewerDeltas(this.state, runId, runViewerTargets(loaded.state, traceEvent), now);
+            state.traceSeq = nextRevision;
+            state.updatedAt = at;
+            this.persistRunState(row, state, nextRevision, now);
+            recordViewerDeltas(this.state, runId, runViewerTargets(state, traceEvent), now);
             context.revision = nextRevision;
         });
-        const prepared = this.readRun(runId, { includeTrace: true });
+        const prepared = this.readRunState(runId);
         if (prepared === null)
             throw new Error(`Workflow run became unreadable: ${runId}`);
         return prepared;
     }
-    async markRunInterrupted(runId, reason = "Workflow host stopped before the run finished") {
+    async markRunInterrupted(runId, reason = "Workflow server stopped before the run finished") {
         const loaded = this.readRun(runId);
         if (loaded === null || loaded.state.status !== "running")
             return loaded;
@@ -780,7 +780,7 @@ export class WorkflowRunStore {
     async publishUpdate(runId, state, nodeId, attemptId, update, options = {}) {
         return await this.withRunLock(runId, async () => this.publishUpdateSynchronous(runId, state, nodeId, attemptId, update, options));
     }
-    /** Host-only synchronous form for an already serialized command transaction. */
+    /** Server-only synchronous form for an already serialized command transaction. */
     publishUpdateSynchronous(runId, state, nodeId, attemptId, update, options = {}) {
         if (options.signal?.aborted === true) {
             throw options.signal.reason ?? new Error("workflow update attempt is no longer active");
@@ -941,7 +941,7 @@ export class WorkflowRunStore {
                     },
                 };
                 insertRunEvent(this.state, run.resourceId, revision, at, traceEvent);
-                const current = this.readRunState(run, this.readDefinition(run.definitionHash));
+                const current = this.materializeRunState(run, this.readDefinition(run.definitionHash));
                 current.traceSeq = revision;
                 current.updatedAt = at;
                 this.persistRunState(run, current, revision, now);
@@ -1262,12 +1262,60 @@ export class WorkflowRunStore {
             lastEventSeq: segment?.eventCount ?? 0,
         };
     }
+    readRunInput(runId) {
+        const row = this.readRunRow(runId);
+        return row === undefined ? null : this.state.readJson(row.inputHash);
+    }
+    readRunFinalOutput(runId) {
+        const row = this.readRunRow(runId);
+        return row?.finalOutputHash == null ? null : this.state.readJson(row.finalOutputHash);
+    }
+    readRunError(runId) {
+        const row = this.readRunRow(runId);
+        return row?.errorHash == null ? null : this.readText(row.errorHash);
+    }
+    readPresentationInstructions(runId) {
+        const row = this.state.connection
+            .prepare("SELECT presentation_prompt_hash AS hash FROM runs WHERE run_id = ?")
+            .get(runId);
+        if (row?.hash == null) {
+            return "Explain the final workflow result to the user in a normal response.";
+        }
+        return this.readText(row.hash);
+    }
+    readTerminalData(runId) {
+        const row = this.state.connection
+            .prepare(`SELECT status, status_detail AS statusDetail, restart_number AS restartNumber
+         FROM runs WHERE run_id = ?`)
+            .get(runId);
+        if (row === undefined ||
+            !["completed", "failed", "timed_out", "cancelled"].includes(String(row.status)) ||
+            typeof row.restartNumber !== "number") {
+            return null;
+        }
+        return {
+            runId,
+            status: row.status,
+            statusDetail: typeof row.statusDetail === "string" ? row.statusDetail : null,
+            input: this.readRunInput(runId),
+            finalOutput: this.readRunFinalOutput(runId),
+            error: this.readRunError(runId),
+            presentationInstructions: this.readPresentationInstructions(runId),
+            restartNumber: row.restartNumber,
+        };
+    }
+    readRunState(runId) {
+        const row = this.readRunRow(runId);
+        if (row === undefined)
+            return null;
+        return this.materializeRunState(row, this.readDefinition(row.definitionHash));
+    }
     readRun(runId, options = {}) {
         const row = this.readRunRow(runId);
         if (row === undefined)
             return null;
         const snapshot = this.readDefinition(row.definitionHash);
-        const state = this.readRunState(row, snapshot);
+        const state = this.materializeRunState(row, snapshot);
         const segments = this.segmentRows(runId).map((segment) => this.loadSegment(segment, state));
         const flat = segments.find((segment) => segment.attemptId === "") ?? emptySegment();
         return {
@@ -1506,7 +1554,7 @@ export class WorkflowRunStore {
     }
     assertSessionWriteAuthority(runId) {
         const run = this.requireRunRow(runId);
-        if (this.allowHostSessionRecording)
+        if (this.allowServerSessionRecording)
             return;
         this.assertWriteAuthority(run, this.contextFor(runId).revision);
     }
@@ -2222,7 +2270,7 @@ export class WorkflowRunStore {
             throw new Error(`Workflow run is missing: ${runId}`);
         return row;
     }
-    readRunState(row, snapshot) {
+    materializeRunState(row, snapshot) {
         const steps = this.readSteps(row.runId);
         return this.buildRunState(row, snapshot, steps, steps, this.readUpdates(row.runId).updates ?? []);
     }