@topline-build/harness-mcp 0.5.3 → 0.6.0

package/docs/generated/build-mcp-manifest.json

@@ -2,7 +2,7 @@
   "schemaVersion": 1,
   "package": {
     "name": "@topline-build/harness-mcp",
-    "version": "0.5.3",
+    "version": "0.6.0",
     "bin": {
       "topline-mcp": "dist/cli.js"
     }
@@ -12,7 +12,7 @@
     "defaultVersion": "2025-11-25",
     "server": {
       "name": "topline-build-stdio",
-      "version": "0.5.3"
+      "version": "0.6.0"
     }
   },
   "generatedFrom": {
@@ -499,6 +499,31 @@
             "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": [
@@ -623,6 +648,11 @@
           "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": [
@@ -2645,6 +2675,1692 @@
           }
         }
       ]
+    },
+    {
+      "name": "platform_capability_status",
+      "description": "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.",
+      "annotations": {
+        "title": "Platform Capability Status",
+        "readOnlyHint": true,
+        "destructiveHint": false,
+        "idempotentHint": true,
+        "openWorldHint": true
+      },
+      "inputSchema": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {},
+        "required": []
+      },
+      "outputSchema": {
+        "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
+          }
+        ]
+      },
+      "examples": [
+        {
+          "request": {},
+          "success": {}
+        }
+      ]
+    },
+    {
+      "name": "platform_start_build_session",
+      "description": "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.",
+      "annotations": {
+        "title": "Platform Start Build Session",
+        "readOnlyHint": false,
+        "destructiveHint": false,
+        "idempotentHint": true,
+        "openWorldHint": true
+      },
+      "inputSchema": {
+        "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"
+        ]
+      },
+      "outputSchema": {
+        "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
+          }
+        ]
+      },
+      "examples": [
+        {
+          "request": {
+            "idempotencyKey": "example-request",
+            "budgetCents": 0,
+            "brief": "<brief>"
+          },
+          "success": {}
+        }
+      ]
+    },
+    {
+      "name": "platform_read_build_session",
+      "description": "Read the owned build session and original pending operations. Does not start another coder or deployment.",
+      "annotations": {
+        "title": "Platform Read Build Session",
+        "readOnlyHint": true,
+        "destructiveHint": false,
+        "idempotentHint": true,
+        "openWorldHint": true
+      },
+      "inputSchema": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "sessionId": {
+            "type": "string",
+            "format": "uuid"
+          }
+        },
+        "required": [
+          "sessionId"
+        ]
+      },
+      "outputSchema": {
+        "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
+          }
+        ]
+      },
+      "examples": [
+        {
+          "request": {
+            "sessionId": "00000000-0000-4000-8000-000000000001"
+          },
+          "success": {}
+        }
+      ]
+    },
+    {
+      "name": "platform_close_build_session",
+      "description": "Stop new authoring and request pending-operation cancellation. Unknown effects retain their reservation; cancellation does not undo committed writes.",
+      "annotations": {
+        "title": "Platform Close Build Session",
+        "readOnlyHint": false,
+        "destructiveHint": false,
+        "idempotentHint": true,
+        "openWorldHint": true
+      },
+      "inputSchema": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "sessionId": {
+            "type": "string",
+            "format": "uuid"
+          }
+        },
+        "required": [
+          "sessionId"
+        ]
+      },
+      "outputSchema": {
+        "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
+          }
+        ]
+      },
+      "examples": [
+        {
+          "request": {
+            "sessionId": "00000000-0000-4000-8000-000000000001"
+          },
+          "success": {}
+        }
+      ]
+    },
+    {
+      "name": "platform_run_artifact_workspace_sql",
+      "description": "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.",
+      "annotations": {
+        "title": "Platform Run Artifact Workspace Sql",
+        "readOnlyHint": false,
+        "destructiveHint": false,
+        "idempotentHint": true,
+        "openWorldHint": true
+      },
+      "inputSchema": {
+        "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"
+        ]
+      },
+      "outputSchema": {
+        "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
+          }
+        ]
+      },
+      "examples": [
+        {
+          "request": {
+            "sessionId": "00000000-0000-4000-8000-000000000001",
+            "artifactVersionId": "00000000-0000-4000-8000-000000000001",
+            "idempotencyKey": "example-request",
+            "sql": "<sql>",
+            "purpose": "<purpose>"
+          },
+          "success": {}
+        }
+      ]
+    },
+    {
+      "name": "platform_checkout_artifact_app",
+      "description": "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.",
+      "annotations": {
+        "title": "Platform Checkout Artifact App",
+        "readOnlyHint": false,
+        "destructiveHint": false,
+        "idempotentHint": true,
+        "openWorldHint": true
+      },
+      "inputSchema": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "sessionId": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "targetDir": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "required": [
+          "sessionId",
+          "targetDir"
+        ]
+      },
+      "outputSchema": {
+        "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
+          }
+        ]
+      },
+      "examples": [
+        {
+          "request": {
+            "sessionId": "00000000-0000-4000-8000-000000000001",
+            "targetDir": "<targetDir>"
+          },
+          "success": {}
+        }
+      ]
+    },
+    {
+      "name": "platform_list_asset_folders",
+      "description": "List the session's permitted reusable asset folders.",
+      "annotations": {
+        "title": "Platform List Asset Folders",
+        "readOnlyHint": true,
+        "destructiveHint": false,
+        "idempotentHint": true,
+        "openWorldHint": true
+      },
+      "inputSchema": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "sessionId": {
+            "type": "string",
+            "format": "uuid"
+          }
+        },
+        "required": [
+          "sessionId"
+        ]
+      },
+      "outputSchema": {
+        "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
+          }
+        ]
+      },
+      "examples": [
+        {
+          "request": {
+            "sessionId": "00000000-0000-4000-8000-000000000001"
+          },
+          "success": {}
+        }
+      ]
+    },
+    {
+      "name": "platform_list_assets",
+      "description": "List permitted reusable asset metadata with bounded pagination; excluded/deleted attachments are omitted.",
+      "annotations": {
+        "title": "Platform List Assets",
+        "readOnlyHint": true,
+        "destructiveHint": false,
+        "idempotentHint": true,
+        "openWorldHint": true
+      },
+      "inputSchema": {
+        "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"
+        ]
+      },
+      "outputSchema": {
+        "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
+          }
+        ]
+      },
+      "examples": [
+        {
+          "request": {
+            "sessionId": "00000000-0000-4000-8000-000000000001"
+          },
+          "success": {}
+        }
+      ]
+    },
+    {
+      "name": "platform_materialize_assets",
+      "description": "Download exactly selected approved files into a new local directory. Verify each authenticated transfer's hash and size; source and attachment budgets remain separate.",
+      "annotations": {
+        "title": "Platform Materialize Assets",
+        "readOnlyHint": false,
+        "destructiveHint": false,
+        "idempotentHint": true,
+        "openWorldHint": true
+      },
+      "inputSchema": {
+        "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"
+        ]
+      },
+      "outputSchema": {
+        "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
+          }
+        ]
+      },
+      "examples": [
+        {
+          "request": {
+            "sessionId": "00000000-0000-4000-8000-000000000001",
+            "assetIds": [
+              "00000000-0000-4000-8000-000000000001"
+            ],
+            "targetDir": "<targetDir>"
+          },
+          "success": {}
+        }
+      ]
+    },
+    {
+      "name": "platform_list_build_secrets",
+      "description": "Read only exact operator-approved binding references for this session. Values are never retrieved. Authoring detach does not prove deployed runtime revocation.",
+      "annotations": {
+        "title": "Platform List Build Secrets",
+        "readOnlyHint": true,
+        "destructiveHint": false,
+        "idempotentHint": true,
+        "openWorldHint": true
+      },
+      "inputSchema": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "sessionId": {
+            "type": "string",
+            "format": "uuid"
+          }
+        },
+        "required": [
+          "sessionId"
+        ]
+      },
+      "outputSchema": {
+        "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
+          }
+        ]
+      },
+      "examples": [
+        {
+          "request": {
+            "sessionId": "00000000-0000-4000-8000-000000000001"
+          },
+          "success": {}
+        }
+      ]
+    },
+    {
+      "name": "platform_add_acceptance_check",
+      "description": "Add a required acceptance check bound to this build session and deployed revision. A semantic control query requires separate Build data-verification consent.",
+      "annotations": {
+        "title": "Platform Add Acceptance Check",
+        "readOnlyHint": false,
+        "destructiveHint": false,
+        "idempotentHint": true,
+        "openWorldHint": true
+      },
+      "inputSchema": {
+        "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"
+        ]
+      },
+      "outputSchema": {
+        "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
+          }
+        ]
+      },
+      "examples": [
+        {
+          "request": {
+            "sessionId": "00000000-0000-4000-8000-000000000001",
+            "artifactVersionId": "00000000-0000-4000-8000-000000000001",
+            "idempotencyKey": "example-request",
+            "description": "<description>"
+          },
+          "success": {}
+        }
+      ]
+    },
+    {
+      "name": "platform_run_acceptance_checks",
+      "description": "Run required acceptance checks for the exact current draft revision through the shared service.",
+      "annotations": {
+        "title": "Platform Run Acceptance Checks",
+        "readOnlyHint": false,
+        "destructiveHint": false,
+        "idempotentHint": true,
+        "openWorldHint": true
+      },
+      "inputSchema": {
+        "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"
+        ]
+      },
+      "outputSchema": {
+        "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
+          }
+        ]
+      },
+      "examples": [
+        {
+          "request": {
+            "sessionId": "00000000-0000-4000-8000-000000000001",
+            "artifactVersionId": "00000000-0000-4000-8000-000000000001",
+            "idempotencyKey": "example-request"
+          },
+          "success": {}
+        }
+      ]
+    },
+    {
+      "name": "platform_record_acceptance_review",
+      "description": "Record the builder's acceptance review without impersonating the independent validator or removing required checks.",
+      "annotations": {
+        "title": "Platform Record Acceptance Review",
+        "readOnlyHint": false,
+        "destructiveHint": false,
+        "idempotentHint": true,
+        "openWorldHint": true
+      },
+      "inputSchema": {
+        "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"
+        ]
+      },
+      "outputSchema": {
+        "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
+          }
+        ]
+      },
+      "examples": [
+        {
+          "request": {
+            "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>"
+          },
+          "success": {}
+        }
+      ]
+    },
+    {
+      "name": "platform_prepare_artifact_validation",
+      "description": "Prepare validation evidence for the exact private draft revision; missing required checks block readiness.",
+      "annotations": {
+        "title": "Platform Prepare Artifact Validation",
+        "readOnlyHint": true,
+        "destructiveHint": false,
+        "idempotentHint": true,
+        "openWorldHint": true
+      },
+      "inputSchema": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "sessionId": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "artifactVersionId": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "deploymentRecordId": {
+            "type": "string",
+            "format": "uuid"
+          }
+        },
+        "required": [
+          "sessionId",
+          "artifactVersionId",
+          "deploymentRecordId"
+        ]
+      },
+      "outputSchema": {
+        "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
+          }
+        ]
+      },
+      "examples": [
+        {
+          "request": {
+            "sessionId": "00000000-0000-4000-8000-000000000001",
+            "artifactVersionId": "00000000-0000-4000-8000-000000000001",
+            "deploymentRecordId": "00000000-0000-4000-8000-000000000001"
+          },
+          "success": {}
+        }
+      ]
+    },
+    {
+      "name": "platform_request_artifact_validation",
+      "description": "Request the independent reviewer for the exact deployment and bounded evidence. Returns durable operation status; unavailable infrastructure leaves operator review required, never approval.",
+      "annotations": {
+        "title": "Platform Request Artifact Validation",
+        "readOnlyHint": false,
+        "destructiveHint": false,
+        "idempotentHint": true,
+        "openWorldHint": true
+      },
+      "inputSchema": {
+        "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"
+        ]
+      },
+      "outputSchema": {
+        "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
+          }
+        ]
+      },
+      "examples": [
+        {
+          "request": {
+            "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": {}
+          },
+          "success": {}
+        }
+      ]
+    },
+    {
+      "name": "platform_artifact_validation_status",
+      "description": "Read the original validation result and pending prompts without starting another reviewer or deploy. Current authorization is rechecked before evidence delivery.",
+      "annotations": {
+        "title": "Platform Artifact Validation Status",
+        "readOnlyHint": true,
+        "destructiveHint": false,
+        "idempotentHint": true,
+        "openWorldHint": true
+      },
+      "inputSchema": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "sessionId": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "operationId": {
+            "type": "string",
+            "format": "uuid"
+          }
+        },
+        "required": [
+          "sessionId",
+          "operationId"
+        ]
+      },
+      "outputSchema": {
+        "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
+          }
+        ]
+      },
+      "examples": [
+        {
+          "request": {
+            "sessionId": "00000000-0000-4000-8000-000000000001",
+            "operationId": "00000000-0000-4000-8000-000000000001"
+          },
+          "success": {}
+        }
+      ]
+    },
+    {
+      "name": "platform_answer_operator_prompt",
+      "description": "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.",
+      "annotations": {
+        "title": "Platform Answer Operator Prompt",
+        "readOnlyHint": false,
+        "destructiveHint": false,
+        "idempotentHint": true,
+        "openWorldHint": true
+      },
+      "inputSchema": {
+        "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"
+        ]
+      },
+      "outputSchema": {
+        "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
+          }
+        ]
+      },
+      "examples": [
+        {
+          "request": {
+            "sessionId": "00000000-0000-4000-8000-000000000001",
+            "operationId": "00000000-0000-4000-8000-000000000001",
+            "promptId": "00000000-0000-4000-8000-000000000001",
+            "idempotencyKey": "example-request",
+            "message": "<message>"
+          },
+          "success": {}
+        }
+      ]
     }
   ]
 }