zelari-code 1.2.0 → 1.3.0

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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"}