project_diff_versions
Compare two preserved deploy versions of a project. Returns per-file added / removed / changed paths, plus truncated text previews for changed files. After a 409 VERSION_CONFLICT it shows what the other deployer shipped, ahead of merging and retrying.
Both versions must still exist in the preserved-snapshot window (the platform keeps the most recent 10 versions). project_deploys shows whether both numbers are available.
Example:
{ "project_id": "my-saas", "from": 46, "to": 47 }
// Returns: {
// from: 46, to: 47,
// added: [{ path: "api/billing.ts", size: 1244 }],
// removed: [],
// changed: [{ path: "index.html", from_size: 980, to_size: 1102, from_preview: "<html>...", to_preview: "<html>..." }],
// functions: { added: ["api/billing.ts"], removed: [], changed: [] },
// functions_changed: true
// }Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"project_id": "<project_id>",
"from": "<from>",
"to": "<to>"
},
"name": "project_diff_versions"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | Yes | The later version number (e.g. current_version from the 409 response, or project_get().version) | |
| from | Yes | The earlier version number (e.g. your last expected_version) | |
| project_id | Yes | Project ID (UUID), subdomain, or slug — resolved server-side, no UUID lookup needed. 'default' also works when the account has exactly one project; multi-project accounts must name one (the error lists them). |