Surface diff between two versions
diff_surfaceWhat changed in a package's runtime surface between two versions: symbols removed, added, and arity changes, plus renames the package itself proves (a removed name that shared one declaration with a name the new version still exports). Removals break node; type-only removals are returned separately because they break tsc instead. Answers "when did this stop working" from static comparison, with no install required. Use before an upgrade, and to explain a break after one.
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": {
"package": "<package>",
"fromVersion": "<fromVersion>",
"toVersion": "<toVersion>"
},
"name": "diff_surface"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| package | Yes | npm package name | |
| toVersion | Yes | Version you are moving to | |
| fromVersion | Yes | Version you are on |