@osolmaz/pi-workflows 0.10.0 → 0.11.0

package/docs/workflows.md

@@ -15,8 +15,11 @@ Files are discovered by suffix (`.workflow.ts`, `.workflow.js`, `.workflow.mts`,
 2. `~/.pi/agent/workflows/` globally
 3. Workflows built into Pi Workflows
 
-Pi Workflows includes a built-in `monitor` workflow. A project or global file
-named `monitor.workflow.ts` replaces it. The package registers each built-in in
+Pi Workflows includes built-in `autoplan`, `autodoc`, `autoimplement`,
+`plan-approval`, and `monitor` workflows. `autoplan` is the current name for the
+planning workflow that was first released as `autodevise`; the old command and
+export are not retained. A project or global file named `monitor.workflow.ts`
+replaces the built-in monitor. The package registers each built-in in
 a process-local catalog with a stable reference such as `builtin:monitor` and
 an explicit revision. Built-ins are imported with the engine when a Pi process
 starts. They are not read from the package directory when a run starts or
@@ -271,6 +274,39 @@ checkpoint({
 });
 ```
 
+A typed human decision is an authoring layer over checkpoint:
+
+```typescript
+const choices = defineHumanChoices({
+  continue: choice({ label: "Continue" }),
+  stop: choice({ label: "Stop" }),
+  replan: choice({
+    label: "Replan",
+    input: textInput({ name: "instructions", prompt: "What should change?" }),
+  }),
+});
+
+humanDecision({
+  audience: "operator",
+  choices,
+  request: ({ outputs }) => ({
+    title: "Approve plan",
+    subject: outputs.plan,
+    presentation: {
+      schema: "pi-workflows.decision-presentation.v1",
+      summary: "Review the implementation plan.",
+      blocks: [{ kind: "paragraph", text: "The plan is ready for approval." }],
+    },
+  }),
+});
+```
+
+The waiting run stores a versioned request and asks every channel configured for the logical audience. The structured `subject` remains machine data. Channels receive only the normalized `presentation`, title, choices, and input prompts. The first valid verified human answer wins. A continuation preserves the original workflow input and exposes the accepted answer as the checkpoint output. `humanDecisionEdge()` provides exhaustive routing for the choices. Existing `body` requests remain a legacy compatibility form and use deterministic readable formatting.
+
+The model-facing workflow tool cannot answer a protected human decision. Pi interactive UI and configured external channels use a host-owned answer path. Ordinary checkpoints keep the existing `/workflow answer` behavior.
+
+See [Human decisions](HUMAN_DECISIONS.md) for channels, recovery, persistence, and plan approval.
+
 ### decision
 
 `decision` is sugar over `agent` for constrained choices. It builds the prompt
@@ -364,7 +400,7 @@ The model sees one `workflow` tool. Its `action` field supports:
 - `start` with a workflow name or path and structured input.
 - `status` for the active run or a supplied run ID.
 - `pause`, `resume`, and `cancel` for the active run.
-- `answer` with checkpoint input and an optional run ID.
+- `answer` with ordinary checkpoint input and an optional run ID. Protected `humanDecision()` gates reject this model-facing action.
 - `update` for a non-completing update from the current agent attempt.
 - `submit` for the current workflow step contract.
 
@@ -377,7 +413,9 @@ runs.
 
 ### Built-in planning and implementation
 
-The built-in `autodevise` workflow selects a practical in-scope solution and writes a detailed plan. The built-in `autoimplement` workflow implements a supplied plan and returns to its internal `autodevise` mount when new evidence invalidates that plan.
+The built-in `autoplan` workflow selects a practical in-scope solution and writes a detailed plan. The standalone `autodoc` workflow finds an already selected plan, records it in canonical documentation, verifies those documents, and never devises or implements. The built-in `autoimplement` workflow finds a clear existing plan from explicit input, conversation context, or referenced canonical documents. It blocks when no clear plan exists. An explicit plan bypasses autodoc only when a current-document receipt carries its matching plan digest; otherwise autodoc inspects and adopts or updates the canonical documents. Later invalidating evidence returns to `autoplan` followed by `autodoc`.
+
+The built-in `plan-approval` workflow offers verified human `continue`, `stop`, and exact-text `replan` exits. It is optional. A replan exit returns the unchanged text to autoplan, documents the revised plan, and asks again through a new plan digest.
 
 Autoimplement writes and runs the exact Pi Reviewer command. It records P0 through P2 by review round. P0 or P1 work requires another review. P2-only work can be addressed and verified without another reviewer run. CI tracking commands are also explicit. One CI watch lasts at most five minutes, after which the model runs more useful local tests before checking CI again.
 
@@ -397,7 +435,7 @@ one looping workflow run. Its input is:
 }
 ```
 
-The first check runs immediately. Omit `repair` for observation-only monitoring. An authorized repair can route through outer `autodevise`, `autoimplement`, and internal redesign before the monitor checks the target again. A repeated issue with unchanged target evidence stops as blocked.
+The first check runs immediately. Omit `repair` for observation-only monitoring. An authorized repair routes through outer `autoplan`, `autodoc`, optional `plan-approval`, `autoimplement`, and internal redesign before the monitor checks the target again. A repeated issue with unchanged target evidence stops as blocked. Add `repair.approval` with a named audience and bounded replan limit only when the operator wants a human decision before implementation.
 
 `everyMinutes` defaults to 30. Each accepted check must provide one concise report and choose `continue`, `repair` when authorized, or `stop`. The
 runtime queues that report as a workflow notification with `triggerTurn:

package/examples/workflows/approved-plan.workflow.ts

@@ -0,0 +1,58 @@
+import { compute, defineWorkflow, includeWorkflow, includedResult } from "@osolmaz/pi-workflows";
+import autodoc from "../../src/builtins/autodoc.workflow.js";
+import autoplan from "../../src/builtins/autoplan.workflow.js";
+import planApproval from "../../src/builtins/plan-approval.workflow.js";
+
+export default defineWorkflow({
+  name: "approved-plan-example",
+  startAt: "design",
+  maxSteps: 80,
+  includes: {
+    design: includeWorkflow(autoplan, {
+      input: ({ input, outputs }) => {
+        const prior = outputs.design as { exit?: string; output?: { plan?: unknown } } | undefined;
+        const answer = outputs.approval as
+          | { exit?: string; output?: { instructions?: string } }
+          | undefined;
+        return {
+          problem: (input as { task: string }).task,
+          ...(prior?.exit === "ready" ? { previousPlan: prior.output?.plan } : {}),
+          ...(answer?.exit === "replan" ? { newEvidence: answer.output?.instructions } : {}),
+        };
+      },
+    }),
+    documentation: includeWorkflow(autodoc, {
+      input: ({ input, outputs }) => {
+        const result = includedResult(autoplan, outputs.design);
+        if (result.exit !== "ready") throw new Error("design is not ready");
+        return { task: (input as { task: string }).task, plan: result.output.plan };
+      },
+    }),
+    approval: includeWorkflow(planApproval, {
+      input: ({ input, outputs }) => {
+        const result = includedResult(autodoc, outputs.documentation);
+        if (result.exit !== "ready") throw new Error("documentation is not ready");
+        return {
+          task: (input as { task: string }).task,
+          plan: result.output.plan,
+          planDigest: result.output.planDigest,
+          audience: "operator",
+        };
+      },
+    }),
+  },
+  nodes: {
+    done: compute({ run: ({ outputs }) => ({ status: "approved", approval: outputs.approval }) }),
+    stopped: compute({ run: ({ outputs }) => ({ status: "stopped", approval: outputs.approval }) }),
+    blocked: compute({ run: ({ outputs }) => ({ status: "blocked", outputs }) }),
+  },
+  edges: [
+    { from: "design.ready", to: "documentation" },
+    { from: "design.blocked", to: "blocked" },
+    { from: "documentation.ready", to: "approval" },
+    { from: "documentation.blocked", to: "blocked" },
+    { from: "approval.continue", to: "done" },
+    { from: "approval.stop", to: "stopped" },
+    { from: "approval.replan", to: "design" },
+  ],
+});

package/examples/workflows/autoplan.workflow.ts

@@ -0,0 +1 @@
+export { autoplanWorkflow as default } from "@osolmaz/pi-workflows/builtins";

package/examples/workflows/human-decision.workflow.ts

@@ -0,0 +1,62 @@
+import {
+  choice,
+  compute,
+  defineHumanChoices,
+  defineWorkflow,
+  humanDecision,
+  humanDecisionEdge,
+  textInput,
+} from "@osolmaz/pi-workflows";
+
+const choices = defineHumanChoices({
+  continue: choice({ label: "Yes, continue" }),
+  stop: choice({ label: "No, stop" }),
+  replan: choice({
+    label: "Replan",
+    input: textInput({ name: "instructions", prompt: "What should change?" }),
+  }),
+});
+
+export default defineWorkflow({
+  name: "human-decision-example",
+  startAt: "proposal",
+  nodes: {
+    proposal: compute({
+      run: ({ input }) => ({
+        summary: "Apply the proposed workflow change.",
+        changes: ["Keep the durable subject.", "Show readable decision text."],
+        source: input,
+      }),
+    }),
+    approve: humanDecision({
+      audience: "operator",
+      choices,
+      request: ({ outputs }) => {
+        const proposal = outputs.proposal as { summary: string; changes: string[] };
+        return {
+          title: "Approve the proposal",
+          subject: proposal,
+          presentation: {
+            schema: "pi-workflows.decision-presentation.v1",
+            summary: proposal.summary,
+            blocks: [
+              { kind: "section", title: "Changes" },
+              { kind: "bullets", items: proposal.changes },
+            ],
+          },
+        };
+      },
+    }),
+    continued: compute({ run: ({ outputs }) => ({ status: "continue", answer: outputs.approve }) }),
+    stopped: compute({ run: ({ outputs }) => ({ status: "stop", answer: outputs.approve }) }),
+    replan: compute({ run: ({ outputs }) => ({ status: "replan", answer: outputs.approve }) }),
+  },
+  edges: [
+    { from: "proposal", to: "approve" },
+    humanDecisionEdge({
+      from: "approve",
+      choices,
+      cases: { continue: "continued", stop: "stopped", replan: "replan" },
+    }),
+  ],
+});

package/herdr-plugin.toml

@@ -1,6 +1,6 @@
 id = "osolmaz.pi-workflows"
 name = "Pi Workflows"
-version = "0.10.0"
+version = "0.11.0"
 min_herdr_version = "0.7.0"
 description = "Open the active Pi Workflows run in piw from a managed Herdr pane."
 platforms = ["linux", "macos"]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@osolmaz/pi-workflows",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "description": "Workflow and controller runtime with a live terminal viewer for the pi coding agent",
   "keywords": [
     "pi-package"
@@ -23,6 +23,7 @@
     "skills",
     "examples",
     "docs",
+    "schemas",
     "plugins/herdr",
     "herdr-plugin.toml",
     "README.md",

package/schemas/decision-presentation-v1.schema.json

@@ -0,0 +1,83 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/osolmaz/pi-workflows/schemas/decision-presentation-v1.schema.json",
+  "title": "Pi Workflows decision presentation v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema", "summary", "blocks"],
+  "properties": {
+    "schema": { "const": "pi-workflows.decision-presentation.v1" },
+    "summary": { "type": "string", "minLength": 1, "maxLength": 16000 },
+    "blocks": {
+      "type": "array",
+      "maxItems": 256,
+      "items": {
+        "oneOf": [
+          {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["kind", "text"],
+            "properties": {
+              "kind": { "const": "paragraph" },
+              "text": { "type": "string", "minLength": 1, "maxLength": 16000 }
+            }
+          },
+          {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["kind", "title"],
+            "properties": {
+              "kind": { "const": "section" },
+              "title": { "type": "string", "minLength": 1, "maxLength": 16000 }
+            }
+          },
+          {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["kind", "items"],
+            "properties": {
+              "kind": { "const": "bullets" },
+              "items": {
+                "type": "array",
+                "minItems": 1,
+                "maxItems": 256,
+                "items": { "type": "string", "minLength": 1, "maxLength": 16000 }
+              }
+            }
+          },
+          {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["kind", "items"],
+            "properties": {
+              "kind": { "const": "fields" },
+              "items": {
+                "type": "array",
+                "minItems": 1,
+                "maxItems": 256,
+                "items": {
+                  "type": "object",
+                  "additionalProperties": false,
+                  "required": ["label", "value"],
+                  "properties": {
+                    "label": { "type": "string", "minLength": 1, "maxLength": 16000 },
+                    "value": { "type": "string", "minLength": 1, "maxLength": 16000 }
+                  }
+                }
+              }
+            }
+          },
+          {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["kind", "text"],
+            "properties": {
+              "kind": { "const": "preformatted" },
+              "text": { "type": "string", "minLength": 1, "maxLength": 16000 }
+            }
+          }
+        ]
+      }
+    }
+  }
+}

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

@@ -0,0 +1,44 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/osolmaz/pi-workflows/schemas/human-decision-accepted-v1.schema.json",
+  "title": "Pi Workflows accepted human decision v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema",
+    "decisionId",
+    "requestDigest",
+    "response",
+    "source",
+    "idempotencyKey",
+    "acceptedAt",
+    "answerDigest"
+  ],
+  "properties": {
+    "schema": { "const": "pi-workflows.human-decision-accepted.v1" },
+    "decisionId": { "type": "string" },
+    "requestDigest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "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-accepted-v2.schema.json

@@ -0,0 +1,50 @@
+{
+  "$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-answer-attempt-v1.schema.json

@@ -0,0 +1,37 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/osolmaz/pi-workflows/schemas/human-decision-answer-attempt-v1.schema.json",
+  "title": "Pi Workflows human decision answer attempt v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema",
+    "attemptId",
+    "attemptedAt",
+    "decisionId",
+    "requestDigest",
+    "choice",
+    "source",
+    "idempotencyKey"
+  ],
+  "properties": {
+    "schema": { "const": "pi-workflows.human-decision-answer-attempt.v1" },
+    "attemptId": { "type": "string" },
+    "attemptedAt": { "type": "string", "format": "date-time" },
+    "decisionId": { "type": "string" },
+    "requestDigest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "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" }
+  }
+}

package/schemas/human-decision-cancellation-v1.schema.json

@@ -0,0 +1,15 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/osolmaz/pi-workflows/schemas/human-decision-cancellation-v1.schema.json",
+  "title": "Pi Workflows human decision cancellation v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema", "decisionId", "requestDigest", "cancelledAt", "reason"],
+  "properties": {
+    "schema": { "const": "pi-workflows.human-decision-cancellation.v1" },
+    "decisionId": { "type": "string" },
+    "requestDigest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "cancelledAt": { "type": "string", "format": "date-time" },
+    "reason": { "enum": ["cancelled", "expired"] }
+  }
+}

package/schemas/human-decision-continuation-v1.schema.json

@@ -0,0 +1,16 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/osolmaz/pi-workflows/schemas/human-decision-continuation-v1.schema.json",
+  "title": "Pi Workflows human decision continuation v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema", "decisionId", "requestDigest", "parentRunId", "runId", "createdAt"],
+  "properties": {
+    "schema": { "const": "pi-workflows.human-decision-continuation.v1" },
+    "decisionId": { "type": "string" },
+    "requestDigest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "parentRunId": { "type": "string" },
+    "runId": { "type": "string" },
+    "createdAt": { "type": "string", "format": "date-time" }
+  }
+}

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

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

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

@@ -0,0 +1,36 @@
+{
+  "$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-v1.schema.json

@@ -0,0 +1,33 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/osolmaz/pi-workflows/schemas/human-decision-receipt-v1.schema.json",
+  "title": "Pi Workflows redacted human decision receipt v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema",
+    "decisionId",
+    "requestDigest",
+    "nodeId",
+    "response",
+    "acceptedAt",
+    "answerDigest"
+  ],
+  "properties": {
+    "schema": { "const": "pi-workflows.human-decision-receipt.v1" },
+    "decisionId": { "type": "string" },
+    "requestDigest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "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-receipt-v2.schema.json

@@ -0,0 +1,39 @@
+{
+  "$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}$" }
+  }
+}