@osolmaz/pi-workflows 0.11.2 → 0.12.1

package/src/workflows/types.ts

@@ -71,9 +71,10 @@ export type WorkflowProgressData = {
 export type WorkflowNodeCommon = {
   /**
    * Per-node timeout or a callback that derives it from the run context.
-   * Falls back to the engine default (15 minutes).
+   * Null disables the wall-clock deadline. Omission falls back to the engine
+   * default (15 minutes).
    */
-  timeoutMs?: number | ((context: WorkflowNodeContext) => MaybePromise<number>);
+  timeoutMs?: number | null | ((context: WorkflowNodeContext) => MaybePromise<number | null>);
   /** Short human-readable label shown in the viewer while the node runs. */
   statusDetail?: string;
 };
@@ -230,37 +231,34 @@ export type DecisionPresentation = {
   blocks: DecisionPresentationBlock[];
 };
 
-export type LegacyHumanDecisionPrompt = {
-  title: string;
-  body: unknown;
-  subject?: never;
-  presentation?: never;
-  revision?: never;
-  /** Optional absolute expiry. An expired request cannot accept an answer. */
-  expiresAt?: string;
-};
-
-export type PresentedHumanDecisionPrompt<TSubject = unknown> = {
+export type HumanDecisionPrompt<TSubject = unknown> = {
   title: string;
   subject: TSubject;
   presentation: DecisionPresentation;
-  body?: never;
   /** Positive revision of the decision subject and presentation. Defaults to 1. */
   revision?: number;
   /** Optional absolute expiry. An expired request cannot accept an answer. */
   expiresAt?: string;
 };
 
-export type HumanDecisionPrompt = LegacyHumanDecisionPrompt | PresentedHumanDecisionPrompt;
-
 export type HumanDecisionAudience =
   | string
   | ((context: WorkflowNodeContext) => MaybePromise<string>);
 
+export type HumanDecisionTimeout = {
+  afterMs: number;
+  response: HumanDecisionResponse;
+};
+
+export type HumanDecisionTimeoutPolicy =
+  | HumanDecisionTimeout
+  | ((context: WorkflowNodeContext) => MaybePromise<HumanDecisionTimeout | undefined>);
+
 export type HumanDecisionNodeContract = {
   audience: HumanDecisionAudience;
   choices: HumanDecisionChoiceMap;
   request: (context: WorkflowNodeContext) => MaybePromise<HumanDecisionPrompt>;
+  onTimeout?: HumanDecisionTimeoutPolicy;
 };
 
 type HumanDecisionRequestCommon = {
@@ -275,15 +273,11 @@ type HumanDecisionRequestCommon = {
   choices: HumanDecisionChoiceMap;
   createdAt: string;
   expiresAt?: string;
+  defaultResponse?: HumanDecisionResponse;
 };
 
-export type HumanDecisionRequestV1 = HumanDecisionRequestCommon & {
+export type HumanDecisionRequest = HumanDecisionRequestCommon & {
   schema: "pi-workflows.human-decision-request.v1";
-  body: unknown;
-};
-
-export type HumanDecisionRequestV2 = HumanDecisionRequestCommon & {
-  schema: "pi-workflows.human-decision-request.v2";
   subject: unknown;
   presentation: DecisionPresentation;
   revision: number;
@@ -291,11 +285,9 @@ export type HumanDecisionRequestV2 = HumanDecisionRequestCommon & {
   presentationDigest: string;
 };
 
-export type HumanDecisionRequest = HumanDecisionRequestV1 | HumanDecisionRequestV2;
-
 /**
  * Complete operator-facing request passed to a decision channel. It excludes
- * the canonical subject and legacy body by design.
+ * the canonical subject by design.
  */
 export type HumanDecisionChannelRequest = HumanDecisionRequestCommon & {
   schema: "pi-workflows.human-decision-channel-request.v1";
@@ -323,69 +315,62 @@ export type HumanDecisionSubmission = HumanDecisionResponse & {
   idempotencyKey: string;
 };
 
-type AcceptedHumanDecisionCommon = {
+type ResolvedHumanDecisionCommon = {
   decisionId: string;
   requestDigest: string;
   response: HumanDecisionResponse;
-  source: HumanDecisionAnswerSource;
-  idempotencyKey: string;
+  provenance: "human" | "timeout";
   acceptedAt: string;
   answerDigest: string;
 };
 
-export type AcceptedHumanDecisionV1 = AcceptedHumanDecisionCommon & {
-  schema: "pi-workflows.human-decision-accepted.v1";
+type AcceptedHumanDecisionCommon = ResolvedHumanDecisionCommon & {
+  provenance: "human";
+  source: HumanDecisionAnswerSource;
+  idempotencyKey: string;
 };
 
-export type AcceptedHumanDecisionV2 = AcceptedHumanDecisionCommon & {
-  schema: "pi-workflows.human-decision-accepted.v2";
+type DefaultedHumanDecisionCommon = ResolvedHumanDecisionCommon & {
+  provenance: "timeout";
+};
+
+export type AcceptedHumanDecision = AcceptedHumanDecisionCommon & {
+  schema: "pi-workflows.human-decision-accepted.v1";
   subjectDigest: string;
   presentationDigest: string;
   revision: number;
 };
 
-export type AcceptedHumanDecision = AcceptedHumanDecisionV1 | AcceptedHumanDecisionV2;
+export type DefaultedHumanDecision = DefaultedHumanDecisionCommon & {
+  schema: "pi-workflows.human-decision-accepted.v1";
+  subjectDigest: string;
+  presentationDigest: string;
+  revision: number;
+};
+export type ResolvedHumanDecision = AcceptedHumanDecision | DefaultedHumanDecision;
 
 type HumanDecisionReceiptCommon = {
   decisionId: string;
   requestDigest: string;
   nodeId: string;
   response: HumanDecisionResponse;
+  provenance: "human" | "timeout";
   acceptedAt: string;
   answerDigest: string;
 };
 
-export type HumanDecisionReceiptV1 = HumanDecisionReceiptCommon & {
+export type HumanDecisionReceipt = HumanDecisionReceiptCommon & {
   schema: "pi-workflows.human-decision-receipt.v1";
-};
-
-export type HumanDecisionReceiptV2 = HumanDecisionReceiptCommon & {
-  schema: "pi-workflows.human-decision-receipt.v2";
   subjectDigest: string;
   presentationDigest: string;
   revision: number;
 };
 
-export type HumanDecisionReceipt = HumanDecisionReceiptV1 | HumanDecisionReceiptV2;
-
-export type HumanDecisionDeliveryRecordV1 = {
+export type HumanDecisionDeliveryRecord = {
   schema: "pi-workflows.human-decision-delivery.v1";
   attemptId: string;
   decisionId: string;
   requestDigest: string;
-  channel: string;
-  state: "intent" | "confirmed" | "failed" | "unknown";
-  createdAt: string;
-  finishedAt?: string;
-  messageCount?: number;
-  errorCode?: string;
-};
-
-export type HumanDecisionDeliveryRecordV2 = {
-  schema: "pi-workflows.human-decision-delivery.v2";
-  attemptId: string;
-  decisionId: string;
-  requestDigest: string;
   presentationDigest: string;
   channel: string;
   phase: "intent" | "part" | "complete";
@@ -400,10 +385,6 @@ export type HumanDecisionDeliveryRecordV2 = {
   errorCode?: string;
 };
 
-export type HumanDecisionDeliveryRecord =
-  | HumanDecisionDeliveryRecordV1
-  | HumanDecisionDeliveryRecordV2;
-
 export type HumanDecisionSettlementRecord = {
   schema: "pi-workflows.human-decision-settlement.v1";
   attemptId: string;
@@ -428,6 +409,7 @@ export type HumanDecisionContinuationRecord = {
   schema: "pi-workflows.human-decision-continuation.v1";
   decisionId: string;
   requestDigest: string;
+  provenance: "human" | "timeout";
   parentRunId: string;
   runId: string;
   createdAt: string;
@@ -715,7 +697,7 @@ export type WorkflowRunState = {
 
 export type WorkflowNodeSnapshot = {
   nodeType: WorkflowNodeDefinition["nodeType"];
-  timeoutMs?: number;
+  timeoutMs?: number | null;
   statusDetail?: string;
   summary?: string;
   expectedOutput?: string;
@@ -727,6 +709,8 @@ export type WorkflowNodeSnapshot = {
     audience: string;
     dynamicAudience?: boolean;
     choices: HumanDecisionChoiceMap;
+    onTimeout?: HumanDecisionTimeout;
+    dynamicTimeout?: boolean;
   };
 };
 

package/schemas/human-decision-accepted-v2.schema.json

@@ -1,50 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://github.com/osolmaz/pi-workflows/schemas/human-decision-accepted-v2.schema.json",
-  "title": "Pi Workflows accepted human decision v2",
-  "type": "object",
-  "additionalProperties": false,
-  "required": [
-    "schema",
-    "decisionId",
-    "requestDigest",
-    "subjectDigest",
-    "presentationDigest",
-    "revision",
-    "response",
-    "source",
-    "idempotencyKey",
-    "acceptedAt",
-    "answerDigest"
-  ],
-  "properties": {
-    "schema": { "const": "pi-workflows.human-decision-accepted.v2" },
-    "decisionId": { "type": "string" },
-    "requestDigest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
-    "subjectDigest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
-    "presentationDigest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
-    "revision": { "type": "integer", "minimum": 1 },
-    "response": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": ["choice"],
-      "properties": {
-        "choice": { "type": "string" },
-        "input": { "type": "object", "additionalProperties": { "type": "string" } }
-      }
-    },
-    "source": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": ["channel", "actorId", "eventId"],
-      "properties": {
-        "channel": { "type": "string" },
-        "actorId": { "type": "string" },
-        "eventId": { "type": "string" }
-      }
-    },
-    "idempotencyKey": { "type": "string" },
-    "acceptedAt": { "type": "string", "format": "date-time" },
-    "answerDigest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }
-  }
-}

package/schemas/human-decision-delivery-v2.schema.json

@@ -1,36 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://github.com/osolmaz/pi-workflows/schemas/human-decision-delivery-v2.schema.json",
-  "title": "Pi Workflows human decision delivery v2",
-  "type": "object",
-  "additionalProperties": false,
-  "required": [
-    "schema",
-    "attemptId",
-    "decisionId",
-    "requestDigest",
-    "presentationDigest",
-    "channel",
-    "phase",
-    "state",
-    "createdAt"
-  ],
-  "properties": {
-    "schema": { "const": "pi-workflows.human-decision-delivery.v2" },
-    "attemptId": { "type": "string" },
-    "decisionId": { "type": "string" },
-    "requestDigest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
-    "presentationDigest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
-    "channel": { "type": "string" },
-    "phase": { "enum": ["intent", "part", "complete"] },
-    "state": { "enum": ["intent", "confirmed", "failed", "unknown"] },
-    "createdAt": { "type": "string", "format": "date-time" },
-    "finishedAt": { "type": "string", "format": "date-time" },
-    "recipientIndex": { "type": "integer", "minimum": 1 },
-    "partIndex": { "type": "integer", "minimum": 1 },
-    "partCount": { "type": "integer", "minimum": 1, "maximum": 20 },
-    "contentDigest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
-    "messageCount": { "type": "integer", "minimum": 0 },
-    "errorCode": { "type": "string" }
-  }
-}

package/schemas/human-decision-receipt-v2.schema.json

@@ -1,39 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://github.com/osolmaz/pi-workflows/schemas/human-decision-receipt-v2.schema.json",
-  "title": "Pi Workflows redacted human decision receipt v2",
-  "type": "object",
-  "additionalProperties": false,
-  "required": [
-    "schema",
-    "decisionId",
-    "requestDigest",
-    "subjectDigest",
-    "presentationDigest",
-    "revision",
-    "nodeId",
-    "response",
-    "acceptedAt",
-    "answerDigest"
-  ],
-  "properties": {
-    "schema": { "const": "pi-workflows.human-decision-receipt.v2" },
-    "decisionId": { "type": "string" },
-    "requestDigest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
-    "subjectDigest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
-    "presentationDigest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
-    "revision": { "type": "integer", "minimum": 1 },
-    "nodeId": { "type": "string" },
-    "response": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": ["choice"],
-      "properties": {
-        "choice": { "type": "string" },
-        "input": { "type": "object", "additionalProperties": { "type": "string" } }
-      }
-    },
-    "acceptedAt": { "type": "string", "format": "date-time" },
-    "answerDigest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }
-  }
-}

package/schemas/human-decision-request-v2.schema.json

@@ -1,69 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://github.com/osolmaz/pi-workflows/schemas/human-decision-request-v2.schema.json",
-  "title": "Pi Workflows human decision request v2",
-  "type": "object",
-  "additionalProperties": false,
-  "required": [
-    "schema",
-    "decisionId",
-    "requestDigest",
-    "subjectDigest",
-    "presentationDigest",
-    "runId",
-    "workflowName",
-    "nodeId",
-    "attemptId",
-    "audience",
-    "title",
-    "subject",
-    "presentation",
-    "revision",
-    "choices",
-    "createdAt"
-  ],
-  "properties": {
-    "schema": { "const": "pi-workflows.human-decision-request.v2" },
-    "decisionId": { "type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,199}$" },
-    "requestDigest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
-    "subjectDigest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
-    "presentationDigest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
-    "runId": { "type": "string" },
-    "workflowName": { "type": "string" },
-    "nodeId": { "type": "string" },
-    "attemptId": { "type": "string" },
-    "audience": { "type": "string" },
-    "title": { "type": "string", "minLength": 1 },
-    "subject": true,
-    "presentation": {
-      "$ref": "decision-presentation-v1.schema.json"
-    },
-    "revision": { "type": "integer", "minimum": 1 },
-    "choices": {
-      "type": "object",
-      "minProperties": 1,
-      "additionalProperties": {
-        "type": "object",
-        "additionalProperties": false,
-        "required": ["label"],
-        "properties": {
-          "label": { "type": "string", "minLength": 1 },
-          "input": {
-            "type": "object",
-            "additionalProperties": false,
-            "required": ["kind", "name", "prompt", "minLength", "maxLength"],
-            "properties": {
-              "kind": { "const": "text" },
-              "name": { "type": "string" },
-              "prompt": { "type": "string", "minLength": 1 },
-              "minLength": { "type": "integer", "minimum": 0 },
-              "maxLength": { "type": "integer", "minimum": 1 }
-            }
-          }
-        }
-      }
-    },
-    "createdAt": { "type": "string", "format": "date-time" },
-    "expiresAt": { "type": "string", "format": "date-time" }
-  }
-}

package/schemas/human-decision-resolution-v2.schema.json

@@ -1,27 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://github.com/osolmaz/pi-workflows/schemas/human-decision-resolution-v2.schema.json",
-  "title": "Pi Workflows human decision resolution v2",
-  "oneOf": [
-    {
-      "type": "object",
-      "additionalProperties": false,
-      "required": ["schema", "outcome", "decision"],
-      "properties": {
-        "schema": { "const": "pi-workflows.human-decision-resolution.v2" },
-        "outcome": { "const": "accepted" },
-        "decision": { "$ref": "human-decision-accepted-v2.schema.json" }
-      }
-    },
-    {
-      "type": "object",
-      "additionalProperties": false,
-      "required": ["schema", "outcome", "cancellation"],
-      "properties": {
-        "schema": { "const": "pi-workflows.human-decision-resolution.v2" },
-        "outcome": { "const": "cancelled" },
-        "cancellation": { "$ref": "human-decision-cancellation-v1.schema.json" }
-      }
-    }
-  ]
-}