// tool-globals.d.ts — generated by axon prepare, do not edit // Every tool the capsule can call, declared as it is callable. // Mirrors the block the model receives — same source, same members. declare global { /** * A file path and source position pointing to a symbol in the workspace. * All positions are 1-based. `preview` contains the raw source line at that * position so you can evaluate relevance without a second read. */ export type Location = { /** Absolute path to the file. */ file: string; /** Line number, 1-based. */ line: number; /** Column number, 1-based. */ col: number; /** The full source line at this position. Use this to assess relevance before reading the file. */ preview: string; }; /** * A TypeScript compiler diagnostic — an error, warning, or hint in a file. */ export type Diagnostic = { severity: "error" | "warning" | "hint"; /** Line number, 1-based. */ line: number; /** Column number, 1-based. */ col: number; /** The full diagnostic message from the compiler. */ message: string; /** Language-server error code e.g. 2345. Used by codeActions() to find fixes. */ code: number; }; /** * A fix or refactor action suggested by the language server at a given position. * Use `codeActions()` to get the list, then pass one to `applyCodeAction()` to * get the edits. Never apply without inspecting `title` first. */ export type CodeAction = { /** Human-readable description of what this action does. Read this before applying. */ title: string; /** Opaque handle. Pass back to `applyCodeAction()` unchanged. */ action: unknown; }; /** * A set of text edits to apply to a single file. * Mutations return `FileEdit[]` rather than writing directly — inspect before applying. */ export type FileEdit = { /** Absolute path to the file to edit. */ file: string; edits: TextEdit[]; }; const lsp: { /** * Find all definitions of a named symbol across the workspace. * * This is the primary entry point. Start here when you know a name but not * its location, then drill into results with position-based tools. * * Returns up to `maxResults` locations (default 20). Narrow the name if you * get too many results — common names like `id` or `type` will hit the cap. * * @example * const locs = await lsp.symbol("AuthToken") * // → [{ file: "src/types.ts", line: 14, col: 12, preview: "export type AuthToken = ..." }] */ symbol(name: string, maxResults?: number): Promise; /** * Resolve the definition of whatever symbol is at the given position. * * Use after `symbol()` or `references()` to follow a usage back to its * declaration. Returns null if the position has no resolvable symbol * (e.g. a string literal, comment, or whitespace). * * @example * const def = await lsp.definition("src/auth.ts", 42, 18) * // → { file: "src/types.ts", line: 14, col: 12, preview: "export type AuthToken = ..." } */ definition(file: string, line: number, col: number): Promise; /** * Find every reference to the symbol at the given position across the workspace. * * Semantically precise — finds all usages of this specific symbol, not all * occurrences of the same string. Catches re-exports, type positions, and * aliased imports that grep would miss. * * @example * const refs = await lsp.references("src/types.ts", 14, 12) * // → [{ file: "src/auth.ts", line: 3, col: 10, preview: "import { AuthToken } from ..." }, ...] */ references(file: string, line: number, col: number): Promise; /** * Get type information for the symbol at the given position. * * Returns the type signature as a string — the same text you'd see hovering * in VS Code. Useful for understanding what a variable or function is without * reading the declaration file. * * Returns null if the position has no type information. * * @example * const type = await lsp.hover("src/auth.ts", 42, 18) * // → "(parameter) token: AuthToken" */ hover(file: string, line: number, col: number): Promise; /** * Get all errors and warnings in a file. * * Note: standard LSP delivers diagnostics as push notifications, not on * request. This method opens the file and waits briefly for the server to * send diagnostics. Use before editing to establish a baseline and after * editing to confirm no new errors were introduced. * * @example * const errors = await lsp.diagnostics("src/auth.ts") * // → [{ severity: "error", line: 42, col: 18, code: 2345, message: "Type 'string' is not assignable..." }] */ diagnostics(file: string): Promise; /** * Get the fixes and refactors the language server suggests at this position. * * Read `action.title` on each result before applying. * * @example * const actions = await lsp.codeActions("src/auth.ts", 42, 18) * // → [{ title: "Add missing import 'AuthToken' from './types'", action: ... }] */ codeActions(file: string, line: number, col: number): Promise; /** * Resolve a `CodeAction` returned by `codeActions()` into concrete file edits. * * Does not write anything. Returns the full set of edits across all affected * files. Apply them with your file writing tools once you've confirmed they * look correct. * * @example * const actions = await lsp.codeActions("src/auth.ts", 42, 18) * const edits = await lsp.applyCodeAction(actions[0]) * // → [{ file: "src/auth.ts", edits: [{ startLine: 1, ..., newText: "import { AuthToken }..." }] }] */ applyCodeAction(action: CodeAction): Promise; /** * Rename a symbol at the given position everywhere it is referenced. * * Semantically precise — renames across re-exports, type positions, aliased * imports, and JSDoc references. Safe to use where grep+sed would miss cases * or create false positives. * * Returns edits for every affected file. Does not write anything. * * @example * const edits = await lsp.rename("src/types.ts", 14, 12, "AccessToken") * // → [{ file: "src/types.ts", edits: [...] }, { file: "src/auth.ts", edits: [...] }] */ rename(file: string, line: number, col: number, newName: string): Promise; /** * Clean up imports in a file — remove unused, add missing, sort. * * Run after edits that add or remove symbols to keep imports consistent. * Returns edits for the single file only. Does not write anything. * * @example * const edits = await lsp.organizeImports("src/auth.ts") * // → [{ file: "src/auth.ts", edits: [{ startLine: 1, ..., newText: "" }] }] */ organizeImports(file: string): Promise; } } export {}

@axon/lsp