@topline-build/harness-mcp 0.5.2 → 0.6.0

package/docs/generated/build-mcp-reference.md

@@ -2,7 +2,7 @@
 
 > Generated from `src/index.ts#BUILD_MCP_TOOLS`. Do not edit this file by hand.
 
-Package: `@topline-build/harness-mcp@0.5.2`
+Package: `@topline-build/harness-mcp@0.6.0`
 Transport: `stdio`
 Default protocol: `2025-11-25`
 Canonical guide: https://topline.build/docs/build-mcp-guide
@@ -359,6 +359,31 @@ Input schema:
       "minLength": 1,
       "maxLength": 128,
       "description": "Optional stable retry key; generated deterministically when omitted."
+    },
+    "sessionId": {
+      "type": "string",
+      "format": "uuid"
+    },
+    "artifactVersionId": {
+      "type": "string",
+      "format": "uuid",
+      "description": "Exact current version from the session or checkout; required with sessionId."
+    },
+    "idempotencyKey": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 128,
+      "pattern": "^[A-Za-z0-9._:-]+$"
+    },
+    "inspectedSourceHash": {
+      "type": "string",
+      "pattern": "^[0-9a-fA-F]{64}$",
+      "description": "Echo the session/source checkout hash; required with sessionId. expectedBundleSha256 separately pins the newly inspected local upload."
+    },
+    "platformAppDir": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Saved remote app root from an existing-app checkout. Session mode only; preserve this when the local checkout directory has a different name."
     }
   },
   "required": [
@@ -495,6 +520,11 @@ Input schema:
     "appDir": {
       "type": "string",
       "minLength": 1
+    },
+    "platformAppDir": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Preserve the saved remote source root returned by checkout when inspecting an existing app."
     }
   },
   "required": [
@@ -1605,17 +1635,95 @@ Output schema:
 }
 ```
 
-### `platform_validate_artifact`
+### `platform_get_design_system_state`
 
-Read trusted smoke and health evidence for a private artifact draft without requiring a browser session.
+Get the tenant Storyboard's published and draft commits, run status, and preview URL before editing or publishing. May reconcile a completed managed draft.
 
-Safety: read-only=true, destructive=false, idempotent=false, open-world=false.
+Safety: read-only=false, destructive=false, idempotent=false, open-world=false.
 
 Example request:
 
+```json
+{}
+```
+
+Example success:
+
+```json
+{}
+```
+
+Input schema:
+
 ```json
 {
-  "artifactId": "00000000-0000-4000-8000-000000000001"
+  "type": "object",
+  "properties": {},
+  "additionalProperties": false
+}
+```
+
+Output schema:
+
+```json
+{
+  "type": "object",
+  "oneOf": [
+    {
+      "type": "object"
+    },
+    {
+      "type": "object",
+      "properties": {
+        "ok": {
+          "const": false
+        },
+        "error": {
+          "type": "object",
+          "properties": {
+            "code": {
+              "type": "string"
+            },
+            "message": {
+              "type": "string"
+            },
+            "retryable": {
+              "type": "boolean"
+            },
+            "recoveryAction": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "code",
+            "message",
+            "retryable",
+            "recoveryAction"
+          ],
+          "additionalProperties": false
+        }
+      },
+      "required": [
+        "ok",
+        "error"
+      ],
+      "additionalProperties": false
+    }
+  ]
+}
+```
+
+### `platform_checkout_design_system`
+
+Download the exact published tenant Storyboard source into a new local directory for Codex or Claude Code to edit and run with npm ci and npm run storybook. Never overwrites an existing directory.
+
+Safety: read-only=false, destructive=false, idempotent=false, open-world=true.
+
+Example request:
+
+```json
+{
+  "targetDir": "<targetDir>"
 }
 ```
 
@@ -1624,14 +1732,9 @@ Example success:
 ```json
 {
   "ok": true,
-  "phase": "<phase>",
-  "artifactId": "00000000-0000-4000-8000-000000000001",
-  "deploymentRecordId": "00000000-0000-4000-8000-000000000003",
-  "deploymentState": "<deploymentState>",
-  "healthy": true,
-  "checkedAt": "<checkedAt>",
-  "draftUrl": "<draftUrl>",
-  "smoke": {}
+  "directory": "<directory>",
+  "currentCommit": "<currentCommit>",
+  "localCommands": []
 }
 ```
 
@@ -1641,17 +1744,13 @@ Input schema:
 {
   "type": "object",
   "properties": {
-    "artifactId": {
-      "type": "string",
-      "format": "uuid"
-    },
-    "deploymentRecordId": {
+    "targetDir": {
       "type": "string",
-      "format": "uuid"
+      "minLength": 1
     }
   },
   "required": [
-    "artifactId"
+    "targetDir"
   ],
   "additionalProperties": false
 }
@@ -1669,50 +1768,24 @@ Output schema:
         "ok": {
           "type": "boolean"
         },
-        "phase": {
-          "type": "string"
-        },
-        "artifactId": {
-          "type": "string"
-        },
-        "deploymentRecordId": {
+        "directory": {
           "type": "string"
         },
-        "deploymentState": {
+        "currentCommit": {
           "type": "string"
         },
-        "healthy": {
-          "type": "boolean"
-        },
-        "checkedAt": {
-          "type": [
-            "string",
-            "null"
-          ]
-        },
-        "draftUrl": {
-          "type": [
-            "string",
-            "null"
-          ]
-        },
-        "smoke": {
-          "type": [
-            "object",
-            "null"
-          ]
+        "localCommands": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
         }
       },
       "required": [
         "ok",
-        "phase",
-        "artifactId",
-        "deploymentRecordId",
-        "deploymentState",
-        "healthy",
-        "checkedAt",
-        "draftUrl",
-        "smoke"
+        "directory",
+        "currentCommit",
+        "localCommands"
       ]
     },
     {
@@ -1756,9 +1829,9 @@ Output schema:
 }
 ```
 
-### `platform_run_artifact_smoke`
+### `platform_submit_design_system_draft`
 
-Rerun the trusted draft smoke check and return fresh rendered-page evidence.
+Package a locally edited Storyboard source directory and submit it as a private draft against exact published and draft revisions. The server validates and builds it before it can be published.
 
 Safety: read-only=false, destructive=false, idempotent=false, open-world=true.
 
@@ -1766,7 +1839,9 @@ Example request:
 
 ```json
 {
-  "artifactId": "00000000-0000-4000-8000-000000000001"
+  "localDir": "<localDir>",
+  "expectedCurrentCommit": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+  "expectedDraftRunId": "00000000-0000-4000-8000-000000000001"
 }
 ```
 
@@ -1775,11 +1850,12 @@ Example success:
 ```json
 {
   "ok": true,
-  "phase": "<phase>",
-  "artifactId": "00000000-0000-4000-8000-000000000001",
-  "deploymentRecordId": "00000000-0000-4000-8000-000000000003",
-  "smoke": {},
-  "validation": {}
+  "runId": "<runId>",
+  "draftCommit": "<draftCommit>",
+  "draftState": "<draftState>",
+  "previewUrl": "<previewUrl>",
+  "requestId": "<requestId>",
+  "bundleSha256": "<bundleSha256>"
 }
 ```
 
@@ -1789,17 +1865,30 @@ Input schema:
 {
   "type": "object",
   "properties": {
-    "artifactId": {
+    "localDir": {
       "type": "string",
-      "format": "uuid"
+      "minLength": 1
     },
-    "deploymentRecordId": {
+    "expectedCurrentCommit": {
       "type": "string",
-      "format": "uuid"
+      "pattern": "^[a-f0-9]{40}$"
+    },
+    "expectedDraftRunId": {
+      "anyOf": [
+        {
+          "type": "string",
+          "format": "uuid"
+        },
+        {
+          "type": "null"
+        }
+      ]
     }
   },
   "required": [
-    "artifactId"
+    "localDir",
+    "expectedCurrentCommit",
+    "expectedDraftRunId"
   ],
   "additionalProperties": false
 }
@@ -1817,29 +1906,33 @@ Output schema:
         "ok": {
           "type": "boolean"
         },
-        "phase": {
+        "runId": {
           "type": "string"
         },
-        "artifactId": {
+        "draftCommit": {
           "type": "string"
         },
-        "deploymentRecordId": {
+        "draftState": {
           "type": "string"
         },
-        "smoke": {
-          "type": "object"
+        "previewUrl": {
+          "type": "string"
         },
-        "validation": {
-          "type": "object"
+        "requestId": {
+          "type": "string"
+        },
+        "bundleSha256": {
+          "type": "string"
         }
       },
       "required": [
         "ok",
-        "phase",
-        "artifactId",
-        "deploymentRecordId",
-        "smoke",
-        "validation"
+        "runId",
+        "draftCommit",
+        "draftState",
+        "previewUrl",
+        "requestId",
+        "bundleSha256"
       ]
     },
     {
@@ -1883,17 +1976,19 @@ Output schema:
 }
 ```
 
-### `platform_plan_artifact_draft_delete`
+### `platform_edit_design_system`
 
-Preview cleanup effects and receive the state-bound plan token required for deletion.
+Start an asynchronous Storyboard draft edit in an existing writable Topline Storyboard conversation. Pass expectedDraftRunId from the last state read (null for no draft); stale or concurrent retries are rejected.
 
-Safety: read-only=true, destructive=false, idempotent=false, open-world=true.
+Safety: read-only=false, destructive=false, idempotent=false, open-world=true.
 
 Example request:
 
 ```json
 {
-  "artifactId": "00000000-0000-4000-8000-000000000001"
+  "conversationId": "00000000-0000-4000-8000-000000000001",
+  "instruction": "<instruction>",
+  "expectedDraftRunId": "00000000-0000-4000-8000-000000000001"
 }
 ```
 
@@ -1901,12 +1996,8 @@ Example success:
 
 ```json
 {
-  "ok": true,
-  "phase": "<phase>",
-  "artifactId": "00000000-0000-4000-8000-000000000001",
-  "eligible": true,
-  "effects": {},
-  "planToken": "example-plan-token"
+  "runId": "<runId>",
+  "previewUrl": "<previewUrl>"
 }
 ```
 
@@ -1916,13 +2007,31 @@ Input schema:
 {
   "type": "object",
   "properties": {
-    "artifactId": {
+    "conversationId": {
       "type": "string",
       "format": "uuid"
+    },
+    "instruction": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 10000
+    },
+    "expectedDraftRunId": {
+      "anyOf": [
+        {
+          "type": "string",
+          "format": "uuid"
+        },
+        {
+          "type": "null"
+        }
+      ]
     }
   },
   "required": [
-    "artifactId"
+    "conversationId",
+    "instruction",
+    "expectedDraftRunId"
   ],
   "additionalProperties": false
 }
@@ -1937,32 +2046,16 @@ Output schema:
     {
       "type": "object",
       "properties": {
-        "ok": {
-          "type": "boolean"
-        },
-        "phase": {
-          "type": "string"
-        },
-        "artifactId": {
+        "runId": {
           "type": "string"
         },
-        "eligible": {
-          "type": "boolean"
-        },
-        "effects": {
-          "type": "object"
-        },
-        "planToken": {
+        "previewUrl": {
           "type": "string"
         }
       },
       "required": [
-        "ok",
-        "phase",
-        "artifactId",
-        "eligible",
-        "effects",
-        "planToken"
+        "runId",
+        "previewUrl"
       ]
     },
     {
@@ -2006,9 +2099,9 @@ Output schema:
 }
 ```
 
-### `platform_delete_artifact_draft`
+### `platform_publish_design_system`
 
-Permanently remove an unpromoted private draft created by this MCP connection after exact-id confirmation.
+Publish the exact reviewed Storyboard draft after its build passes. Managed edits require their writable Storyboard conversation; local submissions require the submitting actor. Always pass state-bound run, draft, and current commits.
 
 Safety: read-only=false, destructive=true, idempotent=false, open-world=true.
 
@@ -2016,9 +2109,9 @@ Example request:
 
 ```json
 {
-  "artifactId": "00000000-0000-4000-8000-000000000001",
-  "confirmArtifactId": "00000000-0000-4000-8000-000000000001",
-  "planToken": "example-plan-token"
+  "expectedDraftRunId": "00000000-0000-4000-8000-000000000001",
+  "expectedDraftCommit": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+  "expectedCurrentCommit": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
 }
 ```
 
@@ -2026,9 +2119,7 @@ Example success:
 
 ```json
 {
-  "ok": true,
-  "deleted": true,
-  "artifactId": "00000000-0000-4000-8000-000000000001"
+  "publishedCommit": "<publishedCommit>"
 }
 ```
 
@@ -2038,23 +2129,34 @@ Input schema:
 {
   "type": "object",
   "properties": {
-    "artifactId": {
+    "conversationId": {
       "type": "string",
       "format": "uuid"
     },
-    "confirmArtifactId": {
+    "expectedDraftRunId": {
       "type": "string",
       "format": "uuid"
     },
-    "planToken": {
+    "expectedDraftCommit": {
       "type": "string",
-      "minLength": 1
+      "pattern": "^[a-f0-9]{40}$"
+    },
+    "expectedCurrentCommit": {
+      "anyOf": [
+        {
+          "type": "string",
+          "pattern": "^[a-f0-9]{40}$"
+        },
+        {
+          "type": "null"
+        }
+      ]
     }
   },
   "required": [
-    "artifactId",
-    "confirmArtifactId",
-    "planToken"
+    "expectedDraftRunId",
+    "expectedDraftCommit",
+    "expectedCurrentCommit"
   ],
   "additionalProperties": false
 }
@@ -2069,20 +2171,163 @@ Output schema:
     {
       "type": "object",
       "properties": {
-        "ok": {
-          "type": "boolean"
-        },
-        "deleted": {
-          "type": "boolean"
-        },
+        "publishedCommit": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "publishedCommit"
+      ]
+    },
+    {
+      "type": "object",
+      "properties": {
+        "ok": {
+          "const": false
+        },
+        "error": {
+          "type": "object",
+          "properties": {
+            "code": {
+              "type": "string"
+            },
+            "message": {
+              "type": "string"
+            },
+            "retryable": {
+              "type": "boolean"
+            },
+            "recoveryAction": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "code",
+            "message",
+            "retryable",
+            "recoveryAction"
+          ],
+          "additionalProperties": false
+        }
+      },
+      "required": [
+        "ok",
+        "error"
+      ],
+      "additionalProperties": false
+    }
+  ]
+}
+```
+
+### `platform_validate_artifact`
+
+Read trusted smoke and health evidence for a private artifact draft without requiring a browser session.
+
+Safety: read-only=true, destructive=false, idempotent=false, open-world=false.
+
+Example request:
+
+```json
+{
+  "artifactId": "00000000-0000-4000-8000-000000000001"
+}
+```
+
+Example success:
+
+```json
+{
+  "ok": true,
+  "phase": "<phase>",
+  "artifactId": "00000000-0000-4000-8000-000000000001",
+  "deploymentRecordId": "00000000-0000-4000-8000-000000000003",
+  "deploymentState": "<deploymentState>",
+  "healthy": true,
+  "checkedAt": "<checkedAt>",
+  "draftUrl": "<draftUrl>",
+  "smoke": {}
+}
+```
+
+Input schema:
+
+```json
+{
+  "type": "object",
+  "properties": {
+    "artifactId": {
+      "type": "string",
+      "format": "uuid"
+    },
+    "deploymentRecordId": {
+      "type": "string",
+      "format": "uuid"
+    }
+  },
+  "required": [
+    "artifactId"
+  ],
+  "additionalProperties": false
+}
+```
+
+Output schema:
+
+```json
+{
+  "type": "object",
+  "oneOf": [
+    {
+      "type": "object",
+      "properties": {
+        "ok": {
+          "type": "boolean"
+        },
+        "phase": {
+          "type": "string"
+        },
         "artifactId": {
           "type": "string"
+        },
+        "deploymentRecordId": {
+          "type": "string"
+        },
+        "deploymentState": {
+          "type": "string"
+        },
+        "healthy": {
+          "type": "boolean"
+        },
+        "checkedAt": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "draftUrl": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "smoke": {
+          "type": [
+            "object",
+            "null"
+          ]
         }
       },
       "required": [
         "ok",
-        "deleted",
-        "artifactId"
+        "phase",
+        "artifactId",
+        "deploymentRecordId",
+        "deploymentState",
+        "healthy",
+        "checkedAt",
+        "draftUrl",
+        "smoke"
       ]
     },
     {
@@ -2125,3 +2370,2246 @@ Output schema:
   ]
 }
 ```
+
+### `platform_run_artifact_smoke`
+
+Rerun the trusted draft smoke check and return fresh rendered-page evidence.
+
+Safety: read-only=false, destructive=false, idempotent=false, open-world=true.
+
+Example request:
+
+```json
+{
+  "artifactId": "00000000-0000-4000-8000-000000000001"
+}
+```
+
+Example success:
+
+```json
+{
+  "ok": true,
+  "phase": "<phase>",
+  "artifactId": "00000000-0000-4000-8000-000000000001",
+  "deploymentRecordId": "00000000-0000-4000-8000-000000000003",
+  "smoke": {},
+  "validation": {}
+}
+```
+
+Input schema:
+
+```json
+{
+  "type": "object",
+  "properties": {
+    "artifactId": {
+      "type": "string",
+      "format": "uuid"
+    },
+    "deploymentRecordId": {
+      "type": "string",
+      "format": "uuid"
+    }
+  },
+  "required": [
+    "artifactId"
+  ],
+  "additionalProperties": false
+}
+```
+
+Output schema:
+
+```json
+{
+  "type": "object",
+  "oneOf": [
+    {
+      "type": "object",
+      "properties": {
+        "ok": {
+          "type": "boolean"
+        },
+        "phase": {
+          "type": "string"
+        },
+        "artifactId": {
+          "type": "string"
+        },
+        "deploymentRecordId": {
+          "type": "string"
+        },
+        "smoke": {
+          "type": "object"
+        },
+        "validation": {
+          "type": "object"
+        }
+      },
+      "required": [
+        "ok",
+        "phase",
+        "artifactId",
+        "deploymentRecordId",
+        "smoke",
+        "validation"
+      ]
+    },
+    {
+      "type": "object",
+      "properties": {
+        "ok": {
+          "const": false
+        },
+        "error": {
+          "type": "object",
+          "properties": {
+            "code": {
+              "type": "string"
+            },
+            "message": {
+              "type": "string"
+            },
+            "retryable": {
+              "type": "boolean"
+            },
+            "recoveryAction": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "code",
+            "message",
+            "retryable",
+            "recoveryAction"
+          ],
+          "additionalProperties": false
+        }
+      },
+      "required": [
+        "ok",
+        "error"
+      ],
+      "additionalProperties": false
+    }
+  ]
+}
+```
+
+### `platform_plan_artifact_draft_delete`
+
+Preview cleanup effects and receive the state-bound plan token required for deletion.
+
+Safety: read-only=true, destructive=false, idempotent=false, open-world=true.
+
+Example request:
+
+```json
+{
+  "artifactId": "00000000-0000-4000-8000-000000000001"
+}
+```
+
+Example success:
+
+```json
+{
+  "ok": true,
+  "phase": "<phase>",
+  "artifactId": "00000000-0000-4000-8000-000000000001",
+  "eligible": true,
+  "effects": {},
+  "planToken": "example-plan-token"
+}
+```
+
+Input schema:
+
+```json
+{
+  "type": "object",
+  "properties": {
+    "artifactId": {
+      "type": "string",
+      "format": "uuid"
+    }
+  },
+  "required": [
+    "artifactId"
+  ],
+  "additionalProperties": false
+}
+```
+
+Output schema:
+
+```json
+{
+  "type": "object",
+  "oneOf": [
+    {
+      "type": "object",
+      "properties": {
+        "ok": {
+          "type": "boolean"
+        },
+        "phase": {
+          "type": "string"
+        },
+        "artifactId": {
+          "type": "string"
+        },
+        "eligible": {
+          "type": "boolean"
+        },
+        "effects": {
+          "type": "object"
+        },
+        "planToken": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "ok",
+        "phase",
+        "artifactId",
+        "eligible",
+        "effects",
+        "planToken"
+      ]
+    },
+    {
+      "type": "object",
+      "properties": {
+        "ok": {
+          "const": false
+        },
+        "error": {
+          "type": "object",
+          "properties": {
+            "code": {
+              "type": "string"
+            },
+            "message": {
+              "type": "string"
+            },
+            "retryable": {
+              "type": "boolean"
+            },
+            "recoveryAction": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "code",
+            "message",
+            "retryable",
+            "recoveryAction"
+          ],
+          "additionalProperties": false
+        }
+      },
+      "required": [
+        "ok",
+        "error"
+      ],
+      "additionalProperties": false
+    }
+  ]
+}
+```
+
+### `platform_delete_artifact_draft`
+
+Permanently remove an unpromoted private draft created by this MCP connection after exact-id confirmation.
+
+Safety: read-only=false, destructive=true, idempotent=false, open-world=true.
+
+Example request:
+
+```json
+{
+  "artifactId": "00000000-0000-4000-8000-000000000001",
+  "confirmArtifactId": "00000000-0000-4000-8000-000000000001",
+  "planToken": "example-plan-token"
+}
+```
+
+Example success:
+
+```json
+{
+  "ok": true,
+  "deleted": true,
+  "artifactId": "00000000-0000-4000-8000-000000000001"
+}
+```
+
+Input schema:
+
+```json
+{
+  "type": "object",
+  "properties": {
+    "artifactId": {
+      "type": "string",
+      "format": "uuid"
+    },
+    "confirmArtifactId": {
+      "type": "string",
+      "format": "uuid"
+    },
+    "planToken": {
+      "type": "string",
+      "minLength": 1
+    }
+  },
+  "required": [
+    "artifactId",
+    "confirmArtifactId",
+    "planToken"
+  ],
+  "additionalProperties": false
+}
+```
+
+Output schema:
+
+```json
+{
+  "type": "object",
+  "oneOf": [
+    {
+      "type": "object",
+      "properties": {
+        "ok": {
+          "type": "boolean"
+        },
+        "deleted": {
+          "type": "boolean"
+        },
+        "artifactId": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "ok",
+        "deleted",
+        "artifactId"
+      ]
+    },
+    {
+      "type": "object",
+      "properties": {
+        "ok": {
+          "const": false
+        },
+        "error": {
+          "type": "object",
+          "properties": {
+            "code": {
+              "type": "string"
+            },
+            "message": {
+              "type": "string"
+            },
+            "retryable": {
+              "type": "boolean"
+            },
+            "recoveryAction": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "code",
+            "message",
+            "retryable",
+            "recoveryAction"
+          ],
+          "additionalProperties": false
+        }
+      },
+      "required": [
+        "ok",
+        "error"
+      ],
+      "additionalProperties": false
+    }
+  ]
+}
+```
+
+### `platform_capability_status`
+
+Read the connected Build product's current available, denied, unsupported and unconfigured tool families, contract version and helper requirement. Reconnect explicitly for newly consented scopes.
+
+Safety: read-only=true, destructive=false, idempotent=true, open-world=true.
+
+Example request:
+
+```json
+{}
+```
+
+Example success:
+
+```json
+{}
+```
+
+Input schema:
+
+```json
+{
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {},
+  "required": []
+}
+```
+
+Output schema:
+
+```json
+{
+  "type": "object",
+  "oneOf": [
+    {
+      "type": "object",
+      "properties": {
+        "ok": {
+          "const": true
+        }
+      }
+    },
+    {
+      "type": "object",
+      "properties": {
+        "ok": {
+          "const": false
+        },
+        "error": {
+          "type": "object",
+          "properties": {
+            "code": {
+              "type": "string"
+            },
+            "message": {
+              "type": "string"
+            },
+            "retryable": {
+              "type": "boolean"
+            },
+            "recoveryAction": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "code",
+            "message",
+            "retryable",
+            "recoveryAction"
+          ],
+          "additionalProperties": false
+        }
+      },
+      "required": [
+        "ok",
+        "error"
+      ],
+      "additionalProperties": false
+    }
+  ]
+}
+```
+
+### `platform_start_build_session`
+
+Start external authoring with a private artifact identity, current version and platform-operation budget. Launches no internal coder. Existing artifact starts require its current version; new app starts require a manifest. Optional own conversation selects exact operator-approved secret references.
+
+Safety: read-only=false, destructive=false, idempotent=true, open-world=true.
+
+Example request:
+
+```json
+{
+  "idempotencyKey": "example-request",
+  "budgetCents": 0,
+  "brief": "<brief>"
+}
+```
+
+Example success:
+
+```json
+{}
+```
+
+Input schema:
+
+```json
+{
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "idempotencyKey": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 128,
+      "pattern": "^[A-Za-z0-9._:-]+$"
+    },
+    "artifactId": {
+      "type": "string",
+      "format": "uuid"
+    },
+    "artifactVersionId": {
+      "type": "string",
+      "format": "uuid"
+    },
+    "manifest": {
+      "type": "object"
+    },
+    "projectId": {
+      "type": "string",
+      "format": "uuid"
+    },
+    "owningConversationId": {
+      "type": "string",
+      "format": "uuid"
+    },
+    "budgetCents": {
+      "type": "integer",
+      "minimum": 0,
+      "maximum": 100000
+    },
+    "brief": {
+      "type": "string",
+      "minLength": 3,
+      "maxLength": 4000
+    }
+  },
+  "required": [
+    "idempotencyKey",
+    "budgetCents",
+    "brief"
+  ]
+}
+```
+
+Output schema:
+
+```json
+{
+  "type": "object",
+  "oneOf": [
+    {
+      "type": "object",
+      "properties": {
+        "ok": {
+          "const": true
+        }
+      }
+    },
+    {
+      "type": "object",
+      "properties": {
+        "ok": {
+          "const": false
+        },
+        "error": {
+          "type": "object",
+          "properties": {
+            "code": {
+              "type": "string"
+            },
+            "message": {
+              "type": "string"
+            },
+            "retryable": {
+              "type": "boolean"
+            },
+            "recoveryAction": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "code",
+            "message",
+            "retryable",
+            "recoveryAction"
+          ],
+          "additionalProperties": false
+        }
+      },
+      "required": [
+        "ok",
+        "error"
+      ],
+      "additionalProperties": false
+    }
+  ]
+}
+```
+
+### `platform_read_build_session`
+
+Read the owned build session and original pending operations. Does not start another coder or deployment.
+
+Safety: read-only=true, destructive=false, idempotent=true, open-world=true.
+
+Example request:
+
+```json
+{
+  "sessionId": "00000000-0000-4000-8000-000000000001"
+}
+```
+
+Example success:
+
+```json
+{}
+```
+
+Input schema:
+
+```json
+{
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "sessionId": {
+      "type": "string",
+      "format": "uuid"
+    }
+  },
+  "required": [
+    "sessionId"
+  ]
+}
+```
+
+Output schema:
+
+```json
+{
+  "type": "object",
+  "oneOf": [
+    {
+      "type": "object",
+      "properties": {
+        "ok": {
+          "const": true
+        }
+      }
+    },
+    {
+      "type": "object",
+      "properties": {
+        "ok": {
+          "const": false
+        },
+        "error": {
+          "type": "object",
+          "properties": {
+            "code": {
+              "type": "string"
+            },
+            "message": {
+              "type": "string"
+            },
+            "retryable": {
+              "type": "boolean"
+            },
+            "recoveryAction": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "code",
+            "message",
+            "retryable",
+            "recoveryAction"
+          ],
+          "additionalProperties": false
+        }
+      },
+      "required": [
+        "ok",
+        "error"
+      ],
+      "additionalProperties": false
+    }
+  ]
+}
+```
+
+### `platform_close_build_session`
+
+Stop new authoring and request pending-operation cancellation. Unknown effects retain their reservation; cancellation does not undo committed writes.
+
+Safety: read-only=false, destructive=false, idempotent=true, open-world=true.
+
+Example request:
+
+```json
+{
+  "sessionId": "00000000-0000-4000-8000-000000000001"
+}
+```
+
+Example success:
+
+```json
+{}
+```
+
+Input schema:
+
+```json
+{
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "sessionId": {
+      "type": "string",
+      "format": "uuid"
+    }
+  },
+  "required": [
+    "sessionId"
+  ]
+}
+```
+
+Output schema:
+
+```json
+{
+  "type": "object",
+  "oneOf": [
+    {
+      "type": "object",
+      "properties": {
+        "ok": {
+          "const": true
+        }
+      }
+    },
+    {
+      "type": "object",
+      "properties": {
+        "ok": {
+          "const": false
+        },
+        "error": {
+          "type": "object",
+          "properties": {
+            "code": {
+              "type": "string"
+            },
+            "message": {
+              "type": "string"
+            },
+            "retryable": {
+              "type": "boolean"
+            },
+            "recoveryAction": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "code",
+            "message",
+            "retryable",
+            "recoveryAction"
+          ],
+          "additionalProperties": false
+        }
+      },
+      "required": [
+        "ok",
+        "error"
+      ],
+      "additionalProperties": false
+    }
+  ]
+}
+```
+
+### `platform_run_artifact_workspace_sql`
+
+Run guarded private artifact SQL using the exact session namespace, version and retry key. CREATE TABLE/ADD COLUMN require documentation. Enforced non-admin writes remain denied; unknown writes are never replayed.
+
+Safety: read-only=false, destructive=false, idempotent=true, open-world=true.
+
+Example request:
+
+```json
+{
+  "sessionId": "00000000-0000-4000-8000-000000000001",
+  "artifactVersionId": "00000000-0000-4000-8000-000000000001",
+  "idempotencyKey": "example-request",
+  "sql": "<sql>",
+  "purpose": "<purpose>"
+}
+```
+
+Example success:
+
+```json
+{}
+```
+
+Input schema:
+
+```json
+{
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "sessionId": {
+      "type": "string",
+      "format": "uuid"
+    },
+    "artifactVersionId": {
+      "type": "string",
+      "format": "uuid"
+    },
+    "idempotencyKey": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 128,
+      "pattern": "^[A-Za-z0-9._:-]+$"
+    },
+    "sql": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 20000
+    },
+    "purpose": {
+      "type": "string",
+      "minLength": 3,
+      "maxLength": 500
+    },
+    "params": {
+      "type": "object",
+      "additionalProperties": true
+    },
+    "maxRows": {
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 5000
+    },
+    "documentation": {
+      "type": "object"
+    },
+    "columnDocumentation": {
+      "type": "object"
+    }
+  },
+  "required": [
+    "sessionId",
+    "artifactVersionId",
+    "idempotencyKey",
+    "sql",
+    "purpose"
+  ]
+}
+```
+
+Output schema:
+
+```json
+{
+  "type": "object",
+  "oneOf": [
+    {
+      "type": "object",
+      "properties": {
+        "ok": {
+          "const": true
+        }
+      }
+    },
+    {
+      "type": "object",
+      "properties": {
+        "ok": {
+          "const": false
+        },
+        "error": {
+          "type": "object",
+          "properties": {
+            "code": {
+              "type": "string"
+            },
+            "message": {
+              "type": "string"
+            },
+            "retryable": {
+              "type": "boolean"
+            },
+            "recoveryAction": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "code",
+            "message",
+            "retryable",
+            "recoveryAction"
+          ],
+          "additionalProperties": false
+        }
+      },
+      "required": [
+        "ok",
+        "error"
+      ],
+      "additionalProperties": false
+    }
+  ]
+}
+```
+
+### `platform_checkout_artifact_app`
+
+Download exact saved app source through the owned session, verify archive hash/version/commit and extract regular source files into a new local directory. Missing source is never reconstructed.
+
+Safety: read-only=false, destructive=false, idempotent=true, open-world=true.
+
+Example request:
+
+```json
+{
+  "sessionId": "00000000-0000-4000-8000-000000000001",
+  "targetDir": "<targetDir>"
+}
+```
+
+Example success:
+
+```json
+{}
+```
+
+Input schema:
+
+```json
+{
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "sessionId": {
+      "type": "string",
+      "format": "uuid"
+    },
+    "targetDir": {
+      "type": "string",
+      "minLength": 1
+    }
+  },
+  "required": [
+    "sessionId",
+    "targetDir"
+  ]
+}
+```
+
+Output schema:
+
+```json
+{
+  "type": "object",
+  "oneOf": [
+    {
+      "type": "object",
+      "properties": {
+        "ok": {
+          "const": true
+        }
+      }
+    },
+    {
+      "type": "object",
+      "properties": {
+        "ok": {
+          "const": false
+        },
+        "error": {
+          "type": "object",
+          "properties": {
+            "code": {
+              "type": "string"
+            },
+            "message": {
+              "type": "string"
+            },
+            "retryable": {
+              "type": "boolean"
+            },
+            "recoveryAction": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "code",
+            "message",
+            "retryable",
+            "recoveryAction"
+          ],
+          "additionalProperties": false
+        }
+      },
+      "required": [
+        "ok",
+        "error"
+      ],
+      "additionalProperties": false
+    }
+  ]
+}
+```
+
+### `platform_list_asset_folders`
+
+List the session's permitted reusable asset folders.
+
+Safety: read-only=true, destructive=false, idempotent=true, open-world=true.
+
+Example request:
+
+```json
+{
+  "sessionId": "00000000-0000-4000-8000-000000000001"
+}
+```
+
+Example success:
+
+```json
+{}
+```
+
+Input schema:
+
+```json
+{
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "sessionId": {
+      "type": "string",
+      "format": "uuid"
+    }
+  },
+  "required": [
+    "sessionId"
+  ]
+}
+```
+
+Output schema:
+
+```json
+{
+  "type": "object",
+  "oneOf": [
+    {
+      "type": "object",
+      "properties": {
+        "ok": {
+          "const": true
+        }
+      }
+    },
+    {
+      "type": "object",
+      "properties": {
+        "ok": {
+          "const": false
+        },
+        "error": {
+          "type": "object",
+          "properties": {
+            "code": {
+              "type": "string"
+            },
+            "message": {
+              "type": "string"
+            },
+            "retryable": {
+              "type": "boolean"
+            },
+            "recoveryAction": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "code",
+            "message",
+            "retryable",
+            "recoveryAction"
+          ],
+          "additionalProperties": false
+        }
+      },
+      "required": [
+        "ok",
+        "error"
+      ],
+      "additionalProperties": false
+    }
+  ]
+}
+```
+
+### `platform_list_assets`
+
+List permitted reusable asset metadata with bounded pagination; excluded/deleted attachments are omitted.
+
+Safety: read-only=true, destructive=false, idempotent=true, open-world=true.
+
+Example request:
+
+```json
+{
+  "sessionId": "00000000-0000-4000-8000-000000000001"
+}
+```
+
+Example success:
+
+```json
+{}
+```
+
+Input schema:
+
+```json
+{
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "sessionId": {
+      "type": "string",
+      "format": "uuid"
+    },
+    "query": {
+      "type": "string",
+      "maxLength": 200
+    },
+    "folderId": {
+      "type": "string",
+      "format": "uuid"
+    },
+    "limit": {
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 500
+    },
+    "offset": {
+      "type": "integer",
+      "minimum": 0
+    }
+  },
+  "required": [
+    "sessionId"
+  ]
+}
+```
+
+Output schema:
+
+```json
+{
+  "type": "object",
+  "oneOf": [
+    {
+      "type": "object",
+      "properties": {
+        "ok": {
+          "const": true
+        }
+      }
+    },
+    {
+      "type": "object",
+      "properties": {
+        "ok": {
+          "const": false
+        },
+        "error": {
+          "type": "object",
+          "properties": {
+            "code": {
+              "type": "string"
+            },
+            "message": {
+              "type": "string"
+            },
+            "retryable": {
+              "type": "boolean"
+            },
+            "recoveryAction": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "code",
+            "message",
+            "retryable",
+            "recoveryAction"
+          ],
+          "additionalProperties": false
+        }
+      },
+      "required": [
+        "ok",
+        "error"
+      ],
+      "additionalProperties": false
+    }
+  ]
+}
+```
+
+### `platform_materialize_assets`
+
+Download exactly selected approved files into a new local directory. Verify each authenticated transfer's hash and size; source and attachment budgets remain separate.
+
+Safety: read-only=false, destructive=false, idempotent=true, open-world=true.
+
+Example request:
+
+```json
+{
+  "sessionId": "00000000-0000-4000-8000-000000000001",
+  "assetIds": [
+    "00000000-0000-4000-8000-000000000001"
+  ],
+  "targetDir": "<targetDir>"
+}
+```
+
+Example success:
+
+```json
+{}
+```
+
+Input schema:
+
+```json
+{
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "sessionId": {
+      "type": "string",
+      "format": "uuid"
+    },
+    "assetIds": {
+      "type": "array",
+      "minItems": 1,
+      "maxItems": 50,
+      "uniqueItems": true,
+      "items": {
+        "type": "string",
+        "format": "uuid"
+      }
+    },
+    "targetDir": {
+      "type": "string",
+      "minLength": 1
+    }
+  },
+  "required": [
+    "sessionId",
+    "assetIds",
+    "targetDir"
+  ]
+}
+```
+
+Output schema:
+
+```json
+{
+  "type": "object",
+  "oneOf": [
+    {
+      "type": "object",
+      "properties": {
+        "ok": {
+          "const": true
+        }
+      }
+    },
+    {
+      "type": "object",
+      "properties": {
+        "ok": {
+          "const": false
+        },
+        "error": {
+          "type": "object",
+          "properties": {
+            "code": {
+              "type": "string"
+            },
+            "message": {
+              "type": "string"
+            },
+            "retryable": {
+              "type": "boolean"
+            },
+            "recoveryAction": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "code",
+            "message",
+            "retryable",
+            "recoveryAction"
+          ],
+          "additionalProperties": false
+        }
+      },
+      "required": [
+        "ok",
+        "error"
+      ],
+      "additionalProperties": false
+    }
+  ]
+}
+```
+
+### `platform_list_build_secrets`
+
+Read only exact operator-approved binding references for this session. Values are never retrieved. Authoring detach does not prove deployed runtime revocation.
+
+Safety: read-only=true, destructive=false, idempotent=true, open-world=true.
+
+Example request:
+
+```json
+{
+  "sessionId": "00000000-0000-4000-8000-000000000001"
+}
+```
+
+Example success:
+
+```json
+{}
+```
+
+Input schema:
+
+```json
+{
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "sessionId": {
+      "type": "string",
+      "format": "uuid"
+    }
+  },
+  "required": [
+    "sessionId"
+  ]
+}
+```
+
+Output schema:
+
+```json
+{
+  "type": "object",
+  "oneOf": [
+    {
+      "type": "object",
+      "properties": {
+        "ok": {
+          "const": true
+        }
+      }
+    },
+    {
+      "type": "object",
+      "properties": {
+        "ok": {
+          "const": false
+        },
+        "error": {
+          "type": "object",
+          "properties": {
+            "code": {
+              "type": "string"
+            },
+            "message": {
+              "type": "string"
+            },
+            "retryable": {
+              "type": "boolean"
+            },
+            "recoveryAction": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "code",
+            "message",
+            "retryable",
+            "recoveryAction"
+          ],
+          "additionalProperties": false
+        }
+      },
+      "required": [
+        "ok",
+        "error"
+      ],
+      "additionalProperties": false
+    }
+  ]
+}
+```
+
+### `platform_add_acceptance_check`
+
+Add a required acceptance check bound to this build session and deployed revision. A semantic control query requires separate Build data-verification consent.
+
+Safety: read-only=false, destructive=false, idempotent=true, open-world=true.
+
+Example request:
+
+```json
+{
+  "sessionId": "00000000-0000-4000-8000-000000000001",
+  "artifactVersionId": "00000000-0000-4000-8000-000000000001",
+  "idempotencyKey": "example-request",
+  "description": "<description>"
+}
+```
+
+Example success:
+
+```json
+{}
+```
+
+Input schema:
+
+```json
+{
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "sessionId": {
+      "type": "string",
+      "format": "uuid"
+    },
+    "artifactVersionId": {
+      "type": "string",
+      "format": "uuid"
+    },
+    "idempotencyKey": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 128,
+      "pattern": "^[A-Za-z0-9._:-]+$"
+    },
+    "description": {
+      "type": "string",
+      "minLength": 3,
+      "maxLength": 1000
+    }
+  },
+  "required": [
+    "sessionId",
+    "artifactVersionId",
+    "idempotencyKey",
+    "description"
+  ]
+}
+```
+
+Output schema:
+
+```json
+{
+  "type": "object",
+  "oneOf": [
+    {
+      "type": "object",
+      "properties": {
+        "ok": {
+          "const": true
+        }
+      }
+    },
+    {
+      "type": "object",
+      "properties": {
+        "ok": {
+          "const": false
+        },
+        "error": {
+          "type": "object",
+          "properties": {
+            "code": {
+              "type": "string"
+            },
+            "message": {
+              "type": "string"
+            },
+            "retryable": {
+              "type": "boolean"
+            },
+            "recoveryAction": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "code",
+            "message",
+            "retryable",
+            "recoveryAction"
+          ],
+          "additionalProperties": false
+        }
+      },
+      "required": [
+        "ok",
+        "error"
+      ],
+      "additionalProperties": false
+    }
+  ]
+}
+```
+
+### `platform_run_acceptance_checks`
+
+Run required acceptance checks for the exact current draft revision through the shared service.
+
+Safety: read-only=false, destructive=false, idempotent=true, open-world=true.
+
+Example request:
+
+```json
+{
+  "sessionId": "00000000-0000-4000-8000-000000000001",
+  "artifactVersionId": "00000000-0000-4000-8000-000000000001",
+  "idempotencyKey": "example-request"
+}
+```
+
+Example success:
+
+```json
+{}
+```
+
+Input schema:
+
+```json
+{
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "sessionId": {
+      "type": "string",
+      "format": "uuid"
+    },
+    "artifactVersionId": {
+      "type": "string",
+      "format": "uuid"
+    },
+    "idempotencyKey": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 128,
+      "pattern": "^[A-Za-z0-9._:-]+$"
+    }
+  },
+  "required": [
+    "sessionId",
+    "artifactVersionId",
+    "idempotencyKey"
+  ]
+}
+```
+
+Output schema:
+
+```json
+{
+  "type": "object",
+  "oneOf": [
+    {
+      "type": "object",
+      "properties": {
+        "ok": {
+          "const": true
+        }
+      }
+    },
+    {
+      "type": "object",
+      "properties": {
+        "ok": {
+          "const": false
+        },
+        "error": {
+          "type": "object",
+          "properties": {
+            "code": {
+              "type": "string"
+            },
+            "message": {
+              "type": "string"
+            },
+            "retryable": {
+              "type": "boolean"
+            },
+            "recoveryAction": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "code",
+            "message",
+            "retryable",
+            "recoveryAction"
+          ],
+          "additionalProperties": false
+        }
+      },
+      "required": [
+        "ok",
+        "error"
+      ],
+      "additionalProperties": false
+    }
+  ]
+}
+```
+
+### `platform_record_acceptance_review`
+
+Record the builder's acceptance review without impersonating the independent validator or removing required checks.
+
+Safety: read-only=false, destructive=false, idempotent=true, open-world=true.
+
+Example request:
+
+```json
+{
+  "sessionId": "00000000-0000-4000-8000-000000000001",
+  "artifactVersionId": "00000000-0000-4000-8000-000000000001",
+  "idempotencyKey": "example-request",
+  "checkId": "00000000-0000-4000-8000-000000000001",
+  "status": "passed",
+  "summary": "<summary>"
+}
+```
+
+Example success:
+
+```json
+{}
+```
+
+Input schema:
+
+```json
+{
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "sessionId": {
+      "type": "string",
+      "format": "uuid"
+    },
+    "artifactVersionId": {
+      "type": "string",
+      "format": "uuid"
+    },
+    "idempotencyKey": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 128,
+      "pattern": "^[A-Za-z0-9._:-]+$"
+    },
+    "checkId": {
+      "type": "string",
+      "format": "uuid"
+    },
+    "status": {
+      "type": "string",
+      "enum": [
+        "passed",
+        "failed"
+      ]
+    },
+    "summary": {
+      "type": "string",
+      "minLength": 3,
+      "maxLength": 2000
+    }
+  },
+  "required": [
+    "sessionId",
+    "artifactVersionId",
+    "idempotencyKey",
+    "checkId",
+    "status",
+    "summary"
+  ]
+}
+```
+
+Output schema:
+
+```json
+{
+  "type": "object",
+  "oneOf": [
+    {
+      "type": "object",
+      "properties": {
+        "ok": {
+          "const": true
+        }
+      }
+    },
+    {
+      "type": "object",
+      "properties": {
+        "ok": {
+          "const": false
+        },
+        "error": {
+          "type": "object",
+          "properties": {
+            "code": {
+              "type": "string"
+            },
+            "message": {
+              "type": "string"
+            },
+            "retryable": {
+              "type": "boolean"
+            },
+            "recoveryAction": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "code",
+            "message",
+            "retryable",
+            "recoveryAction"
+          ],
+          "additionalProperties": false
+        }
+      },
+      "required": [
+        "ok",
+        "error"
+      ],
+      "additionalProperties": false
+    }
+  ]
+}
+```
+
+### `platform_prepare_artifact_validation`
+
+Prepare validation evidence for the exact private draft revision; missing required checks block readiness.
+
+Safety: read-only=true, destructive=false, idempotent=true, open-world=true.
+
+Example request:
+
+```json
+{
+  "sessionId": "00000000-0000-4000-8000-000000000001",
+  "artifactVersionId": "00000000-0000-4000-8000-000000000001",
+  "deploymentRecordId": "00000000-0000-4000-8000-000000000001"
+}
+```
+
+Example success:
+
+```json
+{}
+```
+
+Input schema:
+
+```json
+{
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "sessionId": {
+      "type": "string",
+      "format": "uuid"
+    },
+    "artifactVersionId": {
+      "type": "string",
+      "format": "uuid"
+    },
+    "deploymentRecordId": {
+      "type": "string",
+      "format": "uuid"
+    }
+  },
+  "required": [
+    "sessionId",
+    "artifactVersionId",
+    "deploymentRecordId"
+  ]
+}
+```
+
+Output schema:
+
+```json
+{
+  "type": "object",
+  "oneOf": [
+    {
+      "type": "object",
+      "properties": {
+        "ok": {
+          "const": true
+        }
+      }
+    },
+    {
+      "type": "object",
+      "properties": {
+        "ok": {
+          "const": false
+        },
+        "error": {
+          "type": "object",
+          "properties": {
+            "code": {
+              "type": "string"
+            },
+            "message": {
+              "type": "string"
+            },
+            "retryable": {
+              "type": "boolean"
+            },
+            "recoveryAction": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "code",
+            "message",
+            "retryable",
+            "recoveryAction"
+          ],
+          "additionalProperties": false
+        }
+      },
+      "required": [
+        "ok",
+        "error"
+      ],
+      "additionalProperties": false
+    }
+  ]
+}
+```
+
+### `platform_request_artifact_validation`
+
+Request the independent reviewer for the exact deployment and bounded evidence. Returns durable operation status; unavailable infrastructure leaves operator review required, never approval.
+
+Safety: read-only=false, destructive=false, idempotent=true, open-world=true.
+
+Example request:
+
+```json
+{
+  "sessionId": "00000000-0000-4000-8000-000000000001",
+  "artifactVersionId": "00000000-0000-4000-8000-000000000001",
+  "idempotencyKey": "example-request",
+  "deploymentRecordId": "00000000-0000-4000-8000-000000000001",
+  "summary": "<summary>",
+  "docImpact": "material",
+  "docImpactNotes": "<docImpactNotes>",
+  "visualReview": {}
+}
+```
+
+Example success:
+
+```json
+{}
+```
+
+Input schema:
+
+```json
+{
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "sessionId": {
+      "type": "string",
+      "format": "uuid"
+    },
+    "artifactVersionId": {
+      "type": "string",
+      "format": "uuid"
+    },
+    "idempotencyKey": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 128,
+      "pattern": "^[A-Za-z0-9._:-]+$"
+    },
+    "deploymentRecordId": {
+      "type": "string",
+      "format": "uuid"
+    },
+    "summary": {
+      "type": "string",
+      "minLength": 3,
+      "maxLength": 4000
+    },
+    "waitMs": {
+      "type": "integer",
+      "minimum": 0,
+      "maximum": 1000
+    },
+    "buildOk": {
+      "type": "boolean"
+    },
+    "typecheckOk": {
+      "type": "boolean"
+    },
+    "docImpact": {
+      "type": "string",
+      "enum": [
+        "material",
+        "none"
+      ]
+    },
+    "docImpactNotes": {
+      "type": "string",
+      "minLength": 12,
+      "maxLength": 2000
+    },
+    "visualReview": {
+      "type": "object",
+      "additionalProperties": true
+    },
+    "dataValidation": {
+      "type": "object",
+      "additionalProperties": true
+    }
+  },
+  "required": [
+    "sessionId",
+    "artifactVersionId",
+    "idempotencyKey",
+    "deploymentRecordId",
+    "summary",
+    "docImpact",
+    "docImpactNotes",
+    "visualReview"
+  ]
+}
+```
+
+Output schema:
+
+```json
+{
+  "type": "object",
+  "oneOf": [
+    {
+      "type": "object",
+      "properties": {
+        "ok": {
+          "const": true
+        }
+      }
+    },
+    {
+      "type": "object",
+      "properties": {
+        "ok": {
+          "const": false
+        },
+        "error": {
+          "type": "object",
+          "properties": {
+            "code": {
+              "type": "string"
+            },
+            "message": {
+              "type": "string"
+            },
+            "retryable": {
+              "type": "boolean"
+            },
+            "recoveryAction": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "code",
+            "message",
+            "retryable",
+            "recoveryAction"
+          ],
+          "additionalProperties": false
+        }
+      },
+      "required": [
+        "ok",
+        "error"
+      ],
+      "additionalProperties": false
+    }
+  ]
+}
+```
+
+### `platform_artifact_validation_status`
+
+Read the original validation result and pending prompts without starting another reviewer or deploy. Current authorization is rechecked before evidence delivery.
+
+Safety: read-only=true, destructive=false, idempotent=true, open-world=true.
+
+Example request:
+
+```json
+{
+  "sessionId": "00000000-0000-4000-8000-000000000001",
+  "operationId": "00000000-0000-4000-8000-000000000001"
+}
+```
+
+Example success:
+
+```json
+{}
+```
+
+Input schema:
+
+```json
+{
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "sessionId": {
+      "type": "string",
+      "format": "uuid"
+    },
+    "operationId": {
+      "type": "string",
+      "format": "uuid"
+    }
+  },
+  "required": [
+    "sessionId",
+    "operationId"
+  ]
+}
+```
+
+Output schema:
+
+```json
+{
+  "type": "object",
+  "oneOf": [
+    {
+      "type": "object",
+      "properties": {
+        "ok": {
+          "const": true
+        }
+      }
+    },
+    {
+      "type": "object",
+      "properties": {
+        "ok": {
+          "const": false
+        },
+        "error": {
+          "type": "object",
+          "properties": {
+            "code": {
+              "type": "string"
+            },
+            "message": {
+              "type": "string"
+            },
+            "retryable": {
+              "type": "boolean"
+            },
+            "recoveryAction": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "code",
+            "message",
+            "retryable",
+            "recoveryAction"
+          ],
+          "additionalProperties": false
+        }
+      },
+      "required": [
+        "ok",
+        "error"
+      ],
+      "additionalProperties": false
+    }
+  ]
+}
+```
+
+### `platform_answer_operator_prompt`
+
+Answer the exact saved operator prompt on the original review operation. Appends guidance and reopens the same eligible session; cannot approve validation or widen the saved grant.
+
+Safety: read-only=false, destructive=false, idempotent=true, open-world=true.
+
+Example request:
+
+```json
+{
+  "sessionId": "00000000-0000-4000-8000-000000000001",
+  "operationId": "00000000-0000-4000-8000-000000000001",
+  "promptId": "00000000-0000-4000-8000-000000000001",
+  "idempotencyKey": "example-request",
+  "message": "<message>"
+}
+```
+
+Example success:
+
+```json
+{}
+```
+
+Input schema:
+
+```json
+{
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "sessionId": {
+      "type": "string",
+      "format": "uuid"
+    },
+    "operationId": {
+      "type": "string",
+      "format": "uuid"
+    },
+    "promptId": {
+      "type": "string",
+      "format": "uuid"
+    },
+    "idempotencyKey": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 128,
+      "pattern": "^[A-Za-z0-9._:-]+$"
+    },
+    "message": {
+      "type": "string",
+      "minLength": 3,
+      "maxLength": 4000
+    }
+  },
+  "required": [
+    "sessionId",
+    "operationId",
+    "promptId",
+    "idempotencyKey",
+    "message"
+  ]
+}
+```
+
+Output schema:
+
+```json
+{
+  "type": "object",
+  "oneOf": [
+    {
+      "type": "object",
+      "properties": {
+        "ok": {
+          "const": true
+        }
+      }
+    },
+    {
+      "type": "object",
+      "properties": {
+        "ok": {
+          "const": false
+        },
+        "error": {
+          "type": "object",
+          "properties": {
+            "code": {
+              "type": "string"
+            },
+            "message": {
+              "type": "string"
+            },
+            "retryable": {
+              "type": "boolean"
+            },
+            "recoveryAction": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "code",
+            "message",
+            "retryable",
+            "recoveryAction"
+          ],
+          "additionalProperties": false
+        }
+      },
+      "required": [
+        "ok",
+        "error"
+      ],
+      "additionalProperties": false
+    }
+  ]
+}
+```