zelari-code 1.1.1 → 1.3.0

package/dist/cli/lsp/manager.js

@@ -0,0 +1,287 @@
+/**
+ * lsp/manager — spawn + lifecycle for language servers, exposing normalized
+ * navigation operations (the `LspProvider` the LSP tools depend on).
+ *
+ * One server process is started lazily per language and reused for the
+ * session. Documents are opened/synced on demand. All operations are
+ * best-effort: a missing server binary, a spawn failure, or a request
+ * timeout resolves to an empty/neutral result so the tools degrade cleanly.
+ */
+import { spawn } from 'node:child_process';
+import { readFileSync } from 'node:fs';
+import { LspClient } from './client.js';
+import { pathToUri, uriToPath } from './protocol.js';
+import { resolveServerCommand, languageIdForFile } from './servers.js';
+/** Spawn a child process and adapt its stdio to an LspTransport. */
+function processTransport(child) {
+    return {
+        send: (data) => {
+            if (child.stdin.writable)
+                child.stdin.write(data);
+        },
+        onData: (cb) => child.stdout.on('data', (b) => cb(b.toString('utf8'))),
+        onClose: (cb) => child.on('exit', cb),
+        dispose: () => {
+            try {
+                child.kill();
+            }
+            catch {
+                /* ignore */
+            }
+        },
+    };
+}
+const SYMBOL_KINDS = {
+    1: 'File', 2: 'Module', 3: 'Namespace', 4: 'Package', 5: 'Class', 6: 'Method',
+    7: 'Property', 8: 'Field', 9: 'Constructor', 10: 'Enum', 11: 'Interface',
+    12: 'Function', 13: 'Variable', 14: 'Constant', 15: 'String', 16: 'Number',
+    17: 'Boolean', 18: 'Array', 19: 'Object', 20: 'Key', 21: 'Null',
+    22: 'EnumMember', 23: 'Struct', 24: 'Event', 25: 'Operator', 26: 'TypeParameter',
+};
+export class LspManager {
+    cwd;
+    spawnImpl;
+    timeoutMs;
+    servers = new Map(); // language → entry (null = unavailable)
+    constructor(options = {}) {
+        this.cwd = options.cwd ?? process.cwd();
+        this.spawnImpl = options.spawnImpl ?? spawn;
+        this.timeoutMs = options.timeoutMs ?? 15_000;
+    }
+    /** Lazily start (or reuse) the server for a file's language. Null if none. */
+    getServer(file) {
+        const cmd = resolveServerCommand(file, this.cwd);
+        if (!cmd)
+            return null;
+        const cached = this.servers.get(cmd.language);
+        if (cached !== undefined)
+            return cached;
+        let entry = null;
+        try {
+            const child = this.spawnImpl(cmd.command, cmd.args, {
+                cwd: this.cwd,
+            });
+            const client = new LspClient(processTransport(child), { timeoutMs: this.timeoutMs });
+            const initialized = client
+                .request('initialize', {
+                processId: process.pid,
+                rootUri: pathToUri(this.cwd),
+                capabilities: {},
+                workspaceFolders: [{ uri: pathToUri(this.cwd), name: 'root' }],
+            })
+                .then(() => {
+                client.notify('initialized', {});
+            });
+            entry = { client, initialized, opened: new Map(), dispose: () => client.dispose() };
+        }
+        catch {
+            entry = null; // spawn failed (binary not found)
+        }
+        this.servers.set(cmd.language, entry);
+        return entry;
+    }
+    /** Ensure a document is open (or synced) on the server. */
+    async openDoc(entry, file) {
+        await entry.initialized;
+        const uri = pathToUri(file);
+        let text;
+        try {
+            text = readFileSync(file, 'utf8');
+        }
+        catch {
+            text = '';
+        }
+        const prev = entry.opened.get(uri);
+        if (prev === undefined) {
+            entry.client.notify('textDocument/didOpen', {
+                textDocument: { uri, languageId: languageIdForFile(file), version: 1, text },
+            });
+            entry.opened.set(uri, 1);
+        }
+        else {
+            const version = prev + 1;
+            entry.client.notify('textDocument/didChange', {
+                textDocument: { uri, version },
+                contentChanges: [{ text }],
+            });
+            entry.opened.set(uri, version);
+        }
+        return uri;
+    }
+    async withDoc(file, fn, fallback) {
+        const entry = this.getServer(file);
+        if (!entry)
+            return fallback;
+        try {
+            const uri = await this.openDoc(entry, file);
+            return await fn(entry, uri);
+        }
+        catch {
+            return fallback;
+        }
+    }
+    async definition(file, line, character) {
+        return this.withDoc(file, async (entry, uri) => {
+            const res = await entry.client.request('textDocument/definition', {
+                textDocument: { uri },
+                position: { line, character },
+            });
+            return normalizeLocations(res);
+        }, []);
+    }
+    async references(file, line, character) {
+        return this.withDoc(file, async (entry, uri) => {
+            const res = await entry.client.request('textDocument/references', {
+                textDocument: { uri },
+                position: { line, character },
+                context: { includeDeclaration: true },
+            });
+            return normalizeLocations(res);
+        }, []);
+    }
+    async hover(file, line, character) {
+        return this.withDoc(file, async (entry, uri) => {
+            const res = (await entry.client.request('textDocument/hover', {
+                textDocument: { uri },
+                position: { line, character },
+            }));
+            return extractHoverText(res);
+        }, null);
+    }
+    async documentSymbols(file) {
+        return this.withDoc(file, async (entry, uri) => {
+            const res = (await entry.client.request('textDocument/documentSymbol', {
+                textDocument: { uri },
+            }));
+            return normalizeSymbols(res);
+        }, []);
+    }
+    async rename(file, line, character, newName) {
+        return this.withDoc(file, async (entry, uri) => {
+            const res = (await entry.client.request('textDocument/rename', {
+                textDocument: { uri },
+                position: { line, character },
+                newName,
+            }));
+            return normalizeRename(res);
+        }, null);
+    }
+    dispose() {
+        for (const entry of this.servers.values())
+            entry?.dispose();
+        this.servers.clear();
+    }
+}
+// ---------------------------------------------------------------------------
+// Shared singleton — LSP servers are heavy, so one manager is reused across
+// turns and disposed on process exit (rather than one per tool registry).
+// ---------------------------------------------------------------------------
+let shared = null;
+export function getSharedLspManager(cwd = process.cwd()) {
+    if (shared && shared.cwd === cwd)
+        return shared.manager;
+    // cwd changed (rare) — dispose the old one and start fresh.
+    shared?.manager.dispose();
+    const manager = new LspManager({ cwd });
+    shared = { cwd, manager };
+    return manager;
+}
+export function disposeSharedLspManager() {
+    shared?.manager.dispose();
+    shared = null;
+}
+// Best-effort cleanup so language servers don't outlive the CLI.
+if (typeof process !== 'undefined' && typeof process.once === 'function') {
+    process.once('exit', () => {
+        try {
+            shared?.manager.dispose();
+        }
+        catch {
+            /* ignore */
+        }
+    });
+}
+// ---------------------------------------------------------------------------
+// Response normalizers (exported for unit testing)
+// ---------------------------------------------------------------------------
+export function normalizeLocations(res) {
+    if (!res)
+        return [];
+    const arr = Array.isArray(res) ? res : [res];
+    const out = [];
+    for (const item of arr) {
+        if (!item || typeof item !== 'object')
+            continue;
+        const loc = item;
+        const uri = loc.uri ?? loc.targetUri;
+        const range = (loc.range ?? loc.targetRange);
+        if (typeof uri === 'string' && range)
+            out.push({ uri, range });
+    }
+    return out;
+}
+export function extractHoverText(res) {
+    if (!res || !res.contents)
+        return null;
+    const c = res.contents;
+    if (typeof c === 'string')
+        return c.trim() || null;
+    if (Array.isArray(c)) {
+        return (c
+            .map((x) => (typeof x === 'string' ? x : x?.value ?? ''))
+            .filter(Boolean)
+            .join('\n')
+            .trim() || null);
+    }
+    if (typeof c === 'object' && 'value' in c) {
+        return (c.value ?? '').trim() || null;
+    }
+    return null;
+}
+export function normalizeSymbols(res) {
+    if (!Array.isArray(res))
+        return [];
+    const out = [];
+    const visit = (nodes) => {
+        for (const n of nodes) {
+            if (!n || typeof n !== 'object')
+                continue;
+            const s = n;
+            const line0 = s.range?.start?.line ?? s.location?.range?.start?.line;
+            if (typeof s.name === 'string' && typeof line0 === 'number') {
+                out.push({ name: s.name, kind: SYMBOL_KINDS[s.kind ?? 0] ?? 'Symbol', line: line0 + 1 });
+            }
+            if (Array.isArray(s.children))
+                visit(s.children);
+        }
+    };
+    visit(res);
+    return out;
+}
+export function normalizeRename(res) {
+    if (!res)
+        return null;
+    const files = [];
+    let total = 0;
+    if (res.changes && typeof res.changes === 'object') {
+        for (const [uri, edits] of Object.entries(res.changes)) {
+            const count = Array.isArray(edits) ? edits.length : 0;
+            files.push({ file: uriToPath(uri), count });
+            total += count;
+        }
+    }
+    if (Array.isArray(res.documentChanges)) {
+        for (const dc of res.documentChanges) {
+            const d = dc;
+            if (d?.textDocument?.uri) {
+                const count = Array.isArray(d.edits) ? d.edits.length : 0;
+                files.push({ file: uriToPath(d.textDocument.uri), count });
+                total += count;
+            }
+        }
+    }
+    if (files.length === 0)
+        return null;
+    return { files, totalEdits: total };
+}
+//# sourceMappingURL=manager.js.map

package/dist/cli/lsp/manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.js","sourceRoot":"","sources":["../../../src/cli/lsp/manager.ts"],"names":[],"mappings":"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"}

package/dist/cli/lsp/protocol.js

@@ -0,0 +1,83 @@
+/**
+ * lsp/protocol — LSP wire framing + minimal type helpers.
+ *
+ * Language Server Protocol messages are JSON-RPC 2.0 objects framed with an
+ * HTTP-style header: `Content-Length: <bytes>\r\n\r\n<json-body>`. This module
+ * is the pure, dependency-free core: encode a message, and incrementally
+ * decode a byte stream into complete messages (handling partial frames and
+ * multiple messages per chunk). It never does I/O, so it's fully unit-testable.
+ */
+/** Encode a JSON-RPC message into a framed LSP wire string. */
+export function encodeMessage(message) {
+    const json = JSON.stringify(message);
+    // Content-Length is the BYTE length of the body, not the char length.
+    const contentLength = Buffer.byteLength(json, 'utf8');
+    return `Content-Length: ${contentLength}\r\n\r\n${json}`;
+}
+/**
+ * Incremental LSP message decoder. Feed it raw stdout chunks; it returns any
+ * complete JSON-RPC messages parsed so far, buffering partial frames.
+ */
+export function createMessageParser() {
+    let buffer = '';
+    return {
+        push(chunk) {
+            buffer += chunk;
+            const out = [];
+            // Loop: each iteration extracts one complete frame, or breaks when the
+            // buffer doesn't yet hold a full header+body.
+            for (;;) {
+                const headerEnd = buffer.indexOf('\r\n\r\n');
+                if (headerEnd === -1)
+                    break; // header not complete yet
+                const header = buffer.slice(0, headerEnd);
+                const match = /Content-Length:\s*(\d+)/i.exec(header);
+                if (!match) {
+                    // Malformed header — drop up to the separator and resync.
+                    buffer = buffer.slice(headerEnd + 4);
+                    continue;
+                }
+                const length = Number(match[1]);
+                const bodyStart = headerEnd + 4;
+                // Content-Length is bytes; slice by bytes to be correct with UTF-8.
+                const rest = Buffer.from(buffer.slice(bodyStart), 'utf8');
+                if (rest.length < length)
+                    break; // body not fully arrived yet
+                const body = rest.subarray(0, length).toString('utf8');
+                // Advance the buffer past the consumed body (re-encode remainder).
+                buffer = rest.subarray(length).toString('utf8');
+                try {
+                    out.push(JSON.parse(body));
+                }
+                catch {
+                    // Skip an unparseable body — the stream stays framed correctly
+                    // because we already consumed exactly Content-Length bytes.
+                }
+            }
+            return out;
+        },
+    };
+}
+/** Convert a filesystem path to a `file://` URI (LSP identifies docs by URI). */
+export function pathToUri(filePath) {
+    // Normalize Windows backslashes and ensure a leading slash.
+    let p = filePath.replace(/\\/g, '/');
+    if (!p.startsWith('/'))
+        p = `/${p}`;
+    // Encode each segment but keep the slashes.
+    const encoded = p
+        .split('/')
+        .map((seg) => encodeURIComponent(seg))
+        .join('/');
+    return `file://${encoded}`;
+}
+/** Convert a `file://` URI back to a filesystem path. */
+export function uriToPath(uri) {
+    if (!uri.startsWith('file://'))
+        return uri;
+    const withoutScheme = decodeURIComponent(uri.slice('file://'.length));
+    // On POSIX the path already starts with '/'. On Windows LSP emits
+    // file:///C:/... — strip the leading slash before a drive letter.
+    return /^\/[A-Za-z]:/.test(withoutScheme) ? withoutScheme.slice(1) : withoutScheme;
+}
+//# sourceMappingURL=protocol.js.map

package/dist/cli/lsp/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../../../src/cli/lsp/protocol.ts"],"names":[],"mappings":"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"}

package/dist/cli/lsp/servers.js

@@ -0,0 +1,80 @@
+/**
+ * lsp/servers — map a source file to the language server that handles it.
+ *
+ * Servers are external binaries resolved at runtime (project-local
+ * node_modules/.bin first, then PATH), exactly like the diagnostics
+ * checkers. When none is installed the LSP tools degrade silently.
+ */
+import path from 'node:path';
+import { resolveBin } from '../diagnostics/engine.js';
+/**
+ * Built-in server specs. Order matters only for display; extension lookup is
+ * exact. All speak LSP over stdio.
+ */
+export const LSP_SERVERS = [
+    {
+        language: 'typescript',
+        bin: 'typescript-language-server',
+        args: ['--stdio'],
+        extensions: ['.ts', '.tsx', '.js', '.jsx', '.mjs', '.cjs'],
+    },
+    {
+        language: 'python',
+        bin: 'pyright-langserver',
+        args: ['--stdio'],
+        extensions: ['.py'],
+    },
+    {
+        language: 'go',
+        bin: 'gopls',
+        args: [],
+        extensions: ['.go'],
+    },
+    {
+        language: 'rust',
+        bin: 'rust-analyzer',
+        args: [],
+        extensions: ['.rs'],
+    },
+];
+/** The `languageId` LSP expects for a given extension (didOpen). */
+export function languageIdForFile(file) {
+    const ext = path.extname(file).toLowerCase();
+    const map = {
+        '.ts': 'typescript',
+        '.tsx': 'typescriptreact',
+        '.js': 'javascript',
+        '.jsx': 'javascriptreact',
+        '.mjs': 'javascript',
+        '.cjs': 'javascript',
+        '.py': 'python',
+        '.go': 'go',
+        '.rs': 'rust',
+    };
+    return map[ext] ?? 'plaintext';
+}
+/** Find the server spec for a file's extension, or null. */
+export function serverForFile(file, servers = LSP_SERVERS) {
+    const ext = path.extname(file).toLowerCase();
+    return servers.find((s) => s.extensions.includes(ext)) ?? null;
+}
+/**
+ * Resolve the launch command for a file's server, or null when no server is
+ * installed for that language. `bin` is resolved project-local first.
+ */
+export function resolveServerCommand(file, cwd, servers = LSP_SERVERS) {
+    const spec = serverForFile(file, servers);
+    if (!spec)
+        return null;
+    const command = resolveBin(spec.bin, cwd);
+    // resolveBin returns the bare name when nothing local was found; we can't
+    // know if it's on PATH without spawning, so report `resolved` = whether a
+    // path (vs the bare bin name) came back.
+    return {
+        language: spec.language,
+        command,
+        args: spec.args,
+        resolved: command !== spec.bin,
+    };
+}
+//# sourceMappingURL=servers.js.map

package/dist/cli/lsp/servers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"servers.js","sourceRoot":"","sources":["../../../src/cli/lsp/servers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAatD;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAA6B;IACnD;QACE,QAAQ,EAAE,YAAY;QACtB,GAAG,EAAE,4BAA4B;QACjC,IAAI,EAAE,CAAC,SAAS,CAAC;QACjB,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;KAC3D;IACD;QACE,QAAQ,EAAE,QAAQ;QAClB,GAAG,EAAE,oBAAoB;QACzB,IAAI,EAAE,CAAC,SAAS,CAAC;QACjB,UAAU,EAAE,CAAC,KAAK,CAAC;KACpB;IACD;QACE,QAAQ,EAAE,IAAI;QACd,GAAG,EAAE,OAAO;QACZ,IAAI,EAAE,EAAE;QACR,UAAU,EAAE,CAAC,KAAK,CAAC;KACpB;IACD;QACE,QAAQ,EAAE,MAAM;QAChB,GAAG,EAAE,eAAe;QACpB,IAAI,EAAE,EAAE;QACR,UAAU,EAAE,CAAC,KAAK,CAAC;KACpB;CACF,CAAC;AAEF,oEAAoE;AACpE,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;IAC7C,MAAM,GAAG,GAA2B;QAClC,KAAK,EAAE,YAAY;QACnB,MAAM,EAAE,iBAAiB;QACzB,KAAK,EAAE,YAAY;QACnB,MAAM,EAAE,iBAAiB;QACzB,MAAM,EAAE,YAAY;QACpB,MAAM,EAAE,YAAY;QACpB,KAAK,EAAE,QAAQ;QACf,KAAK,EAAE,IAAI;QACX,KAAK,EAAE,MAAM;KACd,CAAC;IACF,OAAO,GAAG,CAAC,GAAG,CAAC,IAAI,WAAW,CAAC;AACjC,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,aAAa,CAC3B,IAAY,EACZ,UAAoC,WAAW;IAE/C,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;IAC7C,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC;AACjE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAClC,IAAY,EACZ,GAAW,EACX,UAAoC,WAAW;IAE/C,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC1C,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IACvB,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAC1C,0EAA0E;IAC1E,0EAA0E;IAC1E,yCAAyC;IACzC,OAAO;QACL,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,OAAO;QACP,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,QAAQ,EAAE,OAAO,KAAK,IAAI,CAAC,GAAG;KAC/B,CAAC;AACJ,CAAC"}

package/dist/cli/lsp/tools.js

@@ -0,0 +1,125 @@
+/**
+ * lsp/tools — agent-facing LSP navigation tools.
+ *
+ * These give the agent IDE-grade code intelligence: jump to a definition,
+ * find every reference, read the real type/docs under a symbol, list a file's
+ * symbols, and preview the blast radius of a rename. They depend only on the
+ * `LspProvider` interface, so they're unit-testable with a fake provider (no
+ * language server required).
+ *
+ * Positions are exposed to the model as 1-based `line`/`column` (what editors
+ * show) and converted to LSP's 0-based coordinates internally.
+ */
+import path from 'node:path';
+import { z } from 'zod';
+import { typedOk } from '@zelari/core/harness/tools/toolTypes';
+import { uriToPath } from './protocol.js';
+function fmtLocation(loc, relativeTo) {
+    const file = uriToPath(loc.uri);
+    const rel = relativeTo ? relPath(relativeTo, file) : file;
+    // LSP ranges are 0-based; present 1-based to match editors.
+    const line = (loc.range?.start?.line ?? 0) + 1;
+    const col = (loc.range?.start?.character ?? 0) + 1;
+    return `${rel}:${line}:${col}`;
+}
+function relPath(from, to) {
+    try {
+        const r = path.relative(from, to);
+        return r && !r.startsWith('..') ? r : to;
+    }
+    catch {
+        return to;
+    }
+}
+const PosArgs = z.object({
+    path: z.string().min(1).describe('File path (relative to the project root or absolute).'),
+    line: z.number().int().positive().describe('1-based line number of the symbol.'),
+    column: z.number().int().positive().describe('1-based column of the symbol.'),
+});
+/** Build the LSP tool set from a provider. `root` is used to relativize paths. */
+export function createLspTools(provider, root = process.cwd()) {
+    const goToDefinition = {
+        name: 'go_to_definition',
+        description: 'Jump to where the symbol at a position is defined (via the language server). ' +
+            'Returns the defining file:line:col — use it instead of guessing with grep.',
+        permissions: ['read'],
+        inputSchema: PosArgs,
+        execute: async (args) => {
+            const a = args;
+            const locs = await provider.definition(a.path, a.line - 1, a.column - 1);
+            return typedOk({
+                definitions: locs.map((l) => fmtLocation(l, root)),
+                count: locs.length,
+            });
+        },
+    };
+    const findReferences = {
+        name: 'find_references',
+        description: 'Find every reference to the symbol at a position across the workspace ' +
+            '(via the language server). Returns a list of file:line:col — reliable ' +
+            'where a text grep would miss shadowed names or match strings/comments.',
+        permissions: ['read'],
+        inputSchema: PosArgs,
+        execute: async (args) => {
+            const a = args;
+            const locs = await provider.references(a.path, a.line - 1, a.column - 1);
+            return typedOk({
+                references: locs.map((l) => fmtLocation(l, root)),
+                count: locs.length,
+            });
+        },
+    };
+    const hoverType = {
+        name: 'hover_type',
+        description: 'Get the resolved type signature and documentation for the symbol at a ' +
+            'position (via the language server) — the real type the compiler sees.',
+        permissions: ['read'],
+        inputSchema: PosArgs,
+        execute: async (args) => {
+            const a = args;
+            const text = await provider.hover(a.path, a.line - 1, a.column - 1);
+            return typedOk({ hover: text ?? '(no hover information)' });
+        },
+    };
+    const documentSymbols = {
+        name: 'document_symbols',
+        description: 'List the symbols (functions, classes, methods, variables) declared in a ' +
+            'file with their line numbers — a fast structural outline via the language server.',
+        permissions: ['read'],
+        inputSchema: z.object({
+            path: z.string().min(1).describe('File path to outline.'),
+        }),
+        execute: async (args) => {
+            const a = args;
+            const symbols = await provider.documentSymbols(a.path);
+            return typedOk({
+                symbols: symbols.map((s) => `${s.kind} ${s.name} (line ${s.line})`),
+                count: symbols.length,
+            });
+        },
+    };
+    const renameSymbol = {
+        name: 'rename_symbol',
+        description: 'PREVIEW a safe, workspace-wide rename of the symbol at a position (via the ' +
+            'language server): returns which files change and how many edits each gets, ' +
+            'so you know the blast radius before touching anything. It does NOT write ' +
+            'files — apply the change yourself with edit_file once the scope looks right.',
+        permissions: ['read'],
+        inputSchema: PosArgs.extend({
+            newName: z.string().min(1).describe('The new symbol name.'),
+        }),
+        execute: async (args) => {
+            const a = args;
+            const result = await provider.rename(a.path, a.line - 1, a.column - 1, a.newName);
+            if (!result) {
+                return typedOk({ preview: 'no rename available at this position (symbol not found or not renameable)' });
+            }
+            return typedOk({
+                totalEdits: result.totalEdits,
+                files: result.files.map((f) => `${relPath(root, f.file)} (${f.count} edit${f.count === 1 ? '' : 's'})`),
+            });
+        },
+    };
+    return [goToDefinition, findReferences, hoverType, documentSymbols, renameSymbol];
+}
+//# sourceMappingURL=tools.js.map

package/dist/cli/lsp/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../../src/cli/lsp/tools.ts"],"names":[],"mappings":"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"}