@osolmaz/pi-workflows 0.15.2 → 0.16.0

package/src/host/state.ts

@@ -1,9 +1,13 @@
 import { createHash, randomBytes } from "node:crypto";
+import {
+  CLIENT_PROTOCOL_SCHEMA,
+  clientRequestFingerprint,
+  type ClientRequest,
+  type ClientResponse,
+} from "../client/protocol.js";
 import { StateDatabase } from "../state/database.js";
 import { canonicalJson, type JsonValue } from "../state/json.js";
 import { tokenHash } from "../state/mutation.js";
-import type { HostRequest, HostResponse } from "./protocol.js";
-import { requestFingerprint } from "./protocol.js";
 import type { WorkerMessage, WorkerResponse } from "./worker-protocol.js";
 
 export type HostClaim = {
@@ -65,6 +69,8 @@ export type InteractiveRequestRecord = {
   contract: JsonValue;
   revision: number;
   status: "pending" | "presenting" | "settled" | "cancelled";
+  presenterId: string | null;
+  presentationClaimExpiresAt: string | null;
   presentationSessionEntryId: string | null;
   acceptedSubmissionId: string | null;
   createdAt: string;
@@ -199,53 +205,65 @@ export class HostStateStore {
     };
   }
 
-  readCommand(request: HostRequest): HostResponse | undefined {
+  readCommand(request: ClientRequest): ClientResponse | undefined {
     const row = this.state.connection
       .prepare(
-        `SELECT request_fingerprint AS requestFingerprint, outcome, accepted_revision AS revision,
+        `SELECT request_fingerprint AS clientRequestFingerprint, outcome, accepted_revision AS revision,
                 receipt_hash AS receiptHash, error_hash AS errorHash
          FROM host_commands WHERE request_id = ?`,
       )
       .get(request.requestId);
     if (!isCommandRow(row)) return undefined;
-    if (!row.requestFingerprint.equals(requestFingerprint(request))) {
+    if (!row.clientRequestFingerprint.equals(clientRequestFingerprint(request))) {
       return conflictResponse(request.requestId, "Request ID was reused with another payload");
     }
     return this.commandResponse(request.requestId, row);
   }
 
-  executeCommand(
-    request: HostRequest,
-    hostEpoch: number,
-    operation: () => Omit<HostResponse, "schema" | "requestId">,
-  ): HostResponse {
+  adoptCommand(request: ClientRequest): ClientResponse | undefined {
     const existing = this.readCommand(request);
     if (existing !== undefined) {
-      return existing.outcome === "conflict" ? existing : { ...existing, outcome: "adopted" };
+      return existing.outcome === "accepted" || existing.outcome === "adopted"
+        ? { ...existing, outcome: "adopted" }
+        : existing;
+    }
+    const idempotent = this.state.connection
+      .prepare(
+        `SELECT request_id AS requestId, request_fingerprint AS clientRequestFingerprint,
+                outcome, accepted_revision AS revision, receipt_hash AS receiptHash,
+                error_hash AS errorHash
+         FROM host_commands WHERE client_id = ? AND idempotency_key = ?`,
+      )
+      .get(request.clientId, request.idempotencyKey);
+    if (!isIdempotentCommandRow(idempotent)) return undefined;
+    if (!idempotent.clientRequestFingerprint.equals(clientRequestFingerprint(request))) {
+      return conflictResponse(request.requestId, "Idempotency key was reused with another payload");
     }
+    const adopted = this.commandResponse(idempotent.requestId, idempotent);
+    return {
+      ...adopted,
+      requestId: request.requestId,
+      ...(adopted.outcome === "accepted" || adopted.outcome === "adopted"
+        ? { outcome: "adopted" as const }
+        : {}),
+    };
+  }
+
+  executeCommand(
+    request: ClientRequest,
+    hostEpoch: number,
+    operation: () => Omit<ClientResponse, "schema" | "type" | "requestId">,
+  ): ClientResponse {
+    const existing = this.adoptCommand(request);
+    if (existing !== undefined) return existing;
     return this.state.transaction(() => {
-      const idempotent = this.state.connection
-        .prepare(
-          `SELECT request_id AS requestId, request_fingerprint AS requestFingerprint,
-                  outcome, accepted_revision AS revision, receipt_hash AS receiptHash,
-                  error_hash AS errorHash
-           FROM host_commands WHERE client_id = ? AND idempotency_key = ?`,
-        )
-        .get(request.clientId, request.idempotencyKey);
-      if (isIdempotentCommandRow(idempotent)) {
-        if (!idempotent.requestFingerprint.equals(requestFingerprint(request))) {
-          return conflictResponse(
-            request.requestId,
-            "Idempotency key was reused with another payload",
-          );
-        }
-        const adopted = this.commandResponse(idempotent.requestId, idempotent);
-        return { ...adopted, requestId: request.requestId, outcome: "adopted" };
-      }
+      const idempotent = this.adoptCommand(request);
+      if (idempotent !== undefined) return idempotent;
 
       const result = operation();
-      const response: HostResponse = {
-        schema: "pi-workflows.host-response.v1",
+      const response: ClientResponse = {
+        schema: CLIENT_PROTOCOL_SCHEMA,
+        type: "response",
         requestId: request.requestId,
         ...result,
       };
@@ -267,7 +285,7 @@ export class HostStateStore {
           request.clientId,
           request.operation,
           request.idempotencyKey,
-          requestFingerprint(request),
+          clientRequestFingerprint(request),
           request.runId ?? null,
           response.revision ?? null,
           response.outcome,
@@ -350,13 +368,13 @@ export class HostStateStore {
   readWorkerMessage(message: WorkerMessage): WorkerResponse | undefined {
     const row = this.state.connection
       .prepare(
-        `SELECT request_fingerprint AS requestFingerprint, outcome,
+        `SELECT request_fingerprint AS clientRequestFingerprint, outcome,
                 accepted_revision AS revision, result_hash AS resultHash, error_hash AS errorHash
          FROM worker_messages WHERE worker_epoch = ? AND message_id = ?`,
       )
       .get(message.workerEpoch, message.messageId);
     if (!isWorkerMessageRow(row)) return undefined;
-    if (!row.requestFingerprint.equals(workerMessageFingerprint(message))) {
+    if (!row.clientRequestFingerprint.equals(workerMessageFingerprint(message))) {
       return {
         schema: "pi-workflows.worker-response.v1",
         messageId: message.messageId,
@@ -726,6 +744,7 @@ export class HostStateStore {
     receipt?: JsonValue;
   }): {
     interaction: InteractiveRequestRecord;
+    submissionId: string;
     outcome: "accepted" | "adopted";
     receipt: JsonValue;
   } {
@@ -745,6 +764,7 @@ export class HostStateStore {
     receipt?: JsonValue;
   }): {
     interaction: InteractiveRequestRecord;
+    submissionId: string;
     outcome: "accepted" | "adopted";
     receipt: JsonValue;
   } {
@@ -766,6 +786,7 @@ export class HostStateStore {
     receipt?: JsonValue;
   }): {
     interaction: InteractiveRequestRecord;
+    submissionId: string;
     outcome: "accepted" | "adopted";
     receipt: JsonValue;
   } {
@@ -785,6 +806,7 @@ export class HostStateStore {
         }
         return {
           interaction: this.requireInteractiveRequest(options.requestId),
+          submissionId: existing.submissionId,
           outcome: "adopted",
           receipt:
             existing.receiptHash === null
@@ -843,6 +865,7 @@ export class HostStateStore {
       }
       return {
         interaction: this.requireInteractiveRequest(options.requestId),
+        submissionId: options.submissionId,
         outcome: "accepted",
         receipt: options.receipt ?? {
           requestId: options.requestId,
@@ -865,14 +888,15 @@ export class HostStateStore {
     return row;
   }
 
-  private commandResponse(requestId: string, row: CommandRow): HostResponse {
+  private commandResponse(requestId: string, row: CommandRow): ClientResponse {
     const receipt = row.receiptHash === null ? undefined : this.state.readJson(row.receiptHash);
     const error =
       row.errorHash === null
         ? undefined
         : this.state.readBlob(row.errorHash)?.content.toString("utf8");
     return {
-      schema: "pi-workflows.host-response.v1",
+      schema: CLIENT_PROTOCOL_SCHEMA,
+      type: "response",
       requestId,
       outcome: row.outcome,
       ...(row.revision === null ? {} : { revision: row.revision }),
@@ -886,7 +910,9 @@ export class HostStateStore {
       .prepare(
         `SELECT request_id AS requestId, run_id AS runId, attempt_id AS attemptId,
                 target_session_id AS targetSessionId, kind, contract_hash AS contractHash,
-                revision, status, presentation_session_entry_id AS presentationSessionEntryId,
+                revision, status, presenter_id AS presenterId,
+                presentation_claim_expires_at AS presentationClaimExpiresAt,
+                presentation_session_entry_id AS presentationSessionEntryId,
                 accepted_submission_id AS acceptedSubmissionId, created_at AS createdAt,
                 updated_at AS updatedAt, settled_at AS settledAt, consumed_at AS consumedAt
          FROM interactive_requests WHERE request_id = ?`,
@@ -902,6 +928,8 @@ export class HostStateStore {
       contract: this.state.readJson(row.contractHash),
       revision: row.revision,
       status: row.status,
+      presenterId: row.presenterId,
+      presentationClaimExpiresAt: iso(row.presentationClaimExpiresAt),
       presentationSessionEntryId: row.presentationSessionEntryId,
       acceptedSubmissionId: row.acceptedSubmissionId,
       createdAt: new Date(row.createdAt).toISOString(),
@@ -918,8 +946,14 @@ export class HostStateStore {
   }
 }
 
-function conflictResponse(requestId: string, error: string): HostResponse {
-  return { schema: "pi-workflows.host-response.v1", requestId, outcome: "conflict", error };
+function conflictResponse(requestId: string, error: string): ClientResponse {
+  return {
+    schema: CLIENT_PROTOCOL_SCHEMA,
+    type: "response",
+    requestId,
+    outcome: "conflict",
+    error,
+  };
 }
 
 function requireLeaseMs(value: number): void {
@@ -943,8 +977,8 @@ type HostRow = {
 };
 
 type CommandRow = {
-  requestFingerprint: Buffer;
-  outcome: HostResponse["outcome"];
+  clientRequestFingerprint: Buffer;
+  outcome: ClientResponse["outcome"];
   revision: number | null;
   receiptHash: Buffer | null;
   errorHash: Buffer | null;
@@ -970,7 +1004,7 @@ type SubmissionDetailRow = {
   submittedAt: number;
 };
 type WorkerMessageRow = {
-  requestFingerprint: Buffer;
+  clientRequestFingerprint: Buffer;
   outcome: WorkerResponse["outcome"];
   revision: number | null;
   resultHash: Buffer | null;
@@ -997,6 +1031,8 @@ type InteractiveRequestRow = {
   contractHash: Buffer;
   revision: number;
   status: InteractiveRequestRecord["status"];
+  presenterId: string | null;
+  presentationClaimExpiresAt: number | null;
   presentationSessionEntryId: string | null;
   acceptedSubmissionId: string | null;
   createdAt: number;
@@ -1022,7 +1058,7 @@ function isHostRow(value: unknown): value is HostRow {
 function isCommandRow(value: unknown): value is CommandRow {
   return (
     isRecord(value) &&
-    Buffer.isBuffer(value.requestFingerprint) &&
+    Buffer.isBuffer(value.clientRequestFingerprint) &&
     typeof value.outcome === "string" &&
     nullableNumber(value.revision) &&
     (value.receiptHash === null || Buffer.isBuffer(value.receiptHash)) &&
@@ -1049,7 +1085,7 @@ function isRunIdRow(value: unknown): value is RunIdRow {
 function isWorkerMessageRow(value: unknown): value is WorkerMessageRow {
   return (
     isRecord(value) &&
-    Buffer.isBuffer(value.requestFingerprint) &&
+    Buffer.isBuffer(value.clientRequestFingerprint) &&
     ["accepted", "adopted", "rejected", "claimLost"].includes(value.outcome as string) &&
     nullableNumber(value.revision) &&
     (value.resultHash === null || Buffer.isBuffer(value.resultHash)) &&
@@ -1115,6 +1151,8 @@ function isInteractiveRequestRow(value: unknown): value is InteractiveRequestRow
     Buffer.isBuffer(value.contractHash) &&
     typeof value.revision === "number" &&
     ["pending", "presenting", "settled", "cancelled"].includes(value.status as string) &&
+    nullableString(value.presenterId) &&
+    nullableNumber(value.presentationClaimExpiresAt) &&
     nullableString(value.presentationSessionEntryId) &&
     nullableString(value.acceptedSubmissionId) &&
     typeof value.createdAt === "number" &&