@osolmaz/pi-workflows 0.15.1 → 0.15.3

package/dist/host/runner.js

@@ -402,15 +402,37 @@ export class WorkflowHost {
             case "run.pause": {
                 const runId = requireRunId(request);
                 const active = this.activeRuns.get(runId);
-                if (active === undefined)
-                    return { outcome: "rejected", error: "Run is not active" };
-                this.commitActivePause(active);
-                active.control = "pause";
-                afterCommit.push(() => void active.supervisor.stop("cancelled"));
-                return { outcome: "accepted", receipt: { runId, status: "parked", paused: true } };
+                if (active !== undefined) {
+                    if (active.control === "pause") {
+                        return { outcome: "adopted", receipt: { runId, status: "parked", paused: true } };
+                    }
+                    if (active.control === "handoff") {
+                        const paused = this.queue.pauseParkedWorkflowRun({ runId });
+                        return paused
+                            ? { outcome: "accepted", receipt: { runId, status: "parked", paused: true } }
+                            : { outcome: "rejected", error: "Run handoff is not pausable" };
+                    }
+                    if (active.control !== undefined) {
+                        return { outcome: "rejected", error: `Run is already handling ${active.control}` };
+                    }
+                    this.commitActivePause(active);
+                    active.control = "pause";
+                    afterCommit.push(() => void active.supervisor.stop("cancelled"));
+                    return { outcome: "accepted", receipt: { runId, status: "parked", paused: true } };
+                }
+                const paused = this.queue.pauseParkedWorkflowRun({ runId });
+                return paused
+                    ? { outcome: "accepted", receipt: { runId, status: "parked", paused: true } }
+                    : { outcome: "rejected", error: "Run is not pausable" };
             }
             case "run.resume": {
                 const runId = requireRunId(request);
+                if (this.queue.resumePausedInteraction({ runId })) {
+                    return {
+                        outcome: "accepted",
+                        receipt: { runId, status: "parked", paused: false, waitingForInteraction: true },
+                    };
+                }
                 if (this.activeRuns.has(runId) || this.pendingStarts.has(runId)) {
                     return { outcome: "adopted", receipt: { runId, active: true } };
                 }
@@ -448,17 +470,25 @@ export class WorkflowHost {
             case "interaction.update": {
                 const payload = requireRecord(request.payload, "interaction update payload");
                 if (payload.claimPresentation === true) {
-                    const interaction = this.hostState.claimInteractionPresentation({
-                        requestId: requireString(payload.requestId, "requestId"),
-                        expectedRevision: requireNonNegativeInteger(request.expectedRevision, "expectedRevision"),
-                        presenterId: request.clientId,
-                        leaseMs: PRESENTATION_CLAIM_LEASE_MS,
-                    });
-                    return {
-                        outcome: "accepted",
-                        revision: interaction.revision,
-                        receipt: interaction,
-                    };
+                    try {
+                        const interaction = this.hostState.claimInteractionPresentation({
+                            requestId: requireString(payload.requestId, "requestId"),
+                            expectedRevision: requireNonNegativeInteger(request.expectedRevision, "expectedRevision"),
+                            presenterId: request.clientId,
+                            leaseMs: PRESENTATION_CLAIM_LEASE_MS,
+                        });
+                        return {
+                            outcome: "accepted",
+                            revision: interaction.revision,
+                            receipt: interaction,
+                        };
+                    }
+                    catch (error) {
+                        if (errorMessage(error) === "Interactive request presentation claim conflict") {
+                            return { outcome: "conflict", error: errorMessage(error) };
+                        }
+                        throw error;
+                    }
                 }
                 if (typeof payload.sessionEntryId === "string") {
                     const interaction = this.hostState.markInteractionPresented({
@@ -585,11 +615,9 @@ export class WorkflowHost {
                 this.deliveryClaims.delete(claimId);
         }
         const claimId = randomUUID();
-        this.deliveryClaims.set(claimId, {
-            ...options,
-            expiresAt: now + DELIVERY_CLAIM_LEASE_MS,
-        });
-        return claimId;
+        const expiresAt = now + DELIVERY_CLAIM_LEASE_MS;
+        this.deliveryClaims.set(claimId, { ...options, expiresAt });
+        return { claimId, claimExpiresAt: new Date(expiresAt).toISOString() };
     }
     deliveryClaim(claimId, clientId, kind, resourceId, targetSessionId) {
         const claim = this.deliveryClaims.get(claimId);
@@ -604,8 +632,34 @@ export class WorkflowHost {
         }
         return claim;
     }
+    validateDelivery(command, payload, kind) {
+        const resourceId = requireString(payload.resourceId, "resourceId");
+        const targetSessionId = requireString(payload.targetSessionId, "targetSessionId");
+        const claimId = requireString(payload.claimId, "claimId");
+        const claim = this.deliveryClaim(claimId, command.clientId, kind, resourceId, targetSessionId);
+        if (claim === undefined) {
+            return { outcome: "accepted", receipt: { claimId, live: false } };
+        }
+        const live = kind === "notification"
+            ? this.queue.isWorkflowNotificationClaimLive({
+                notificationId: resourceId,
+                targetSessionId,
+                claimToken: claim.token,
+            })
+            : this.queue.isWorkflowTurnIntentClaimLive({
+                intentId: resourceId,
+                targetSessionId,
+                claimToken: claim.token,
+            });
+        if (!live)
+            this.deliveryClaims.delete(claimId);
+        return { outcome: "accepted", receipt: { claimId, live } };
+    }
     claimNotification(command) {
         const payload = requireRecord(command.payload, "notification claim payload");
+        if (payload.validateClaim === true) {
+            return this.validateDelivery(command, payload, "notification");
+        }
         const targetSessionId = requireString(payload.targetSessionId, "targetSessionId");
         const token = randomUUID();
         const notification = this.queue.claimPendingWorkflowNotifications({
@@ -617,7 +671,7 @@ export class WorkflowHost {
         if (notification === undefined) {
             return { outcome: "accepted", receipt: { notification: null } };
         }
-        const claimId = this.rememberDeliveryClaim({
+        const claim = this.rememberDeliveryClaim({
             clientId: command.clientId,
             token,
             targetSessionId,
@@ -626,7 +680,7 @@ export class WorkflowHost {
         });
         return {
             outcome: "accepted",
-            receipt: { claimId, notification },
+            receipt: { ...claim, notification },
         };
     }
     deliverNotification(command) {
@@ -650,6 +704,9 @@ export class WorkflowHost {
     }
     claimTurn(command) {
         const payload = requireRecord(command.payload, "turn claim payload");
+        if (payload.validateClaim === true) {
+            return this.validateDelivery(command, payload, "turn");
+        }
         const targetSessionId = requireString(payload.targetSessionId, "targetSessionId");
         const token = randomUUID();
         const intent = this.queue.claimEligibleWorkflowTurnIntents({
@@ -661,7 +718,7 @@ export class WorkflowHost {
         if (intent === undefined) {
             return { outcome: "accepted", receipt: { turn: null } };
         }
-        const claimId = this.rememberDeliveryClaim({
+        const claim = this.rememberDeliveryClaim({
             clientId: command.clientId,
             token,
             targetSessionId,
@@ -670,7 +727,7 @@ export class WorkflowHost {
         });
         return {
             outcome: "accepted",
-            receipt: { claimId, turn: intent },
+            receipt: { ...claim, turn: intent },
         };
     }
     resolveTurn(command) {
@@ -740,6 +797,9 @@ export class WorkflowHost {
         if (interaction === undefined || interaction.kind !== "decision") {
             return { outcome: "notFound", error: `Decision request not found: ${requestId}` };
         }
+        if (this.queue.isWorkflowRunPaused(interaction.runId)) {
+            return { outcome: "conflict", error: "Workflow run is paused" };
+        }
         const request = interaction.contract;
         const response = payload.response;
         const accepted = this.decisions.acceptSync(request, {
@@ -878,6 +938,9 @@ export class WorkflowHost {
         if (interaction === undefined || interaction.runId !== runId) {
             return { outcome: "notFound", error: `Interactive request not found: ${requestId}` };
         }
+        if (this.queue.isWorkflowRunPaused(runId)) {
+            return { outcome: "conflict", error: "Workflow run is paused" };
+        }
         const attemptId = requireString(payload.attempt, "attempt");
         const nodeId = requireString(payload.step, "step");
         const storedContract = requireRecord(interaction.contract, "interactive contract");
@@ -931,6 +994,9 @@ export class WorkflowHost {
         if (current === undefined || current.runId !== requireRunId(request)) {
             return { outcome: "notFound", error: `Interactive request not found: ${requestId}` };
         }
+        if (this.queue.isWorkflowRunPaused(current.runId)) {
+            return { outcome: "conflict", error: "Workflow run is paused" };
+        }
         const attemptId = requireString(payload.attempt, "attempt");
         const nodeId = requireString(payload.step, "step");
         const storedContract = requireRecord(current.contract, "interactive contract");