@topline-build/harness-mcp 0.5.3 → 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.3`
+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": [
@@ -2710,3 +2740,1876 @@ Output schema:
   ]
 }
 ```
+
+### `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
+    }
+  ]
+}
+```