Version-exact API surface + drift
usageA package version's TYPED API: exported symbols and their signatures from its shipped .d.ts (or DefinitelyTyped), exact to the version, none of it in the model's training data. Use before writing code against a package whose API may have moved. For whether a name exists at RUNTIME (what decides if an import throws) use resolve_surface; for is-it-safe-to-install use verify. Pass knownVersion (e.g. the version you were trained on) to get the precise delta: added, removed, renamed, changed. Also returns the version's declared engines (Node/runtime floor). Large surfaces are paged, 80 symbols per call: totalSymbols is the size, query filters by name, offset pages. shallow: true means the API lives on an interface's members that are not listed, and the note says where to read them. For framework file/convention changes (not exported symbols), consult the official migration guide / Context7 instead.
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>"
},
"name": "usage"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | No | Part of a symbol name (case-insensitive); returns only matching symbols | |
| offset | No | Index of the first symbol to return, to page past the first 80 | |
| package | Yes | npm package name | |
| version | No | Target version (defaults to latest) | |
| knownVersion | No | A version you already know; returns the API delta from it to the target |