opencodekit 0.6.2 → 0.6.4

package/dist/template/.opencode/package.json

@@ -11,7 +11,7 @@
   "author": "",
   "license": "ISC",
   "dependencies": {
-    "@opencode-ai/plugin": "1.0.199"
+    "@opencode-ai/plugin": "1.0.202"
   },
   "devDependencies": {
     "@types/node": "^25.0.3",

package/dist/template/.opencode/tool/lsp.ts

@@ -0,0 +1,325 @@
+/**
+ * LSP Refactor Tools for OpenCode
+ * Semantic code refactoring using Language Server Protocol
+ *
+ * Provides: lsp_rename, lsp_code_actions, lsp_code_action_apply, lsp_organize_imports
+ * Requires: Language servers installed (e.g., typescript-language-server, pyright, gopls)
+ */
+
+import { resolve } from "node:path";
+import { tool } from "@opencode-ai/plugin";
+import { lspManager } from "../lib/lsp/client";
+import { resolveServer } from "../lib/lsp/config";
+import type {
+	CodeAction,
+	PrepareRenameResult,
+	WorkspaceEdit,
+} from "../lib/lsp/types";
+import {
+	applyWorkspaceEdit,
+	formatWorkspaceEditPreview,
+} from "../lib/lsp/utils";
+
+/**
+ * Rename a symbol across the entire codebase using LSP
+ */
+export const lsp_rename = tool({
+	description: `Rename a symbol (function, variable, class, etc.) across the entire codebase using LSP.
+
+This tool performs semantic renaming - it understands code structure and renames all references correctly, including:
+- Function/method definitions and all their calls
+- Variable declarations and usages
+- Class names and their instantiations
+- Import/export statements
+
+IMPORTANT: This tool directly modifies files. Review the changes shown in output.`,
+
+	args: {
+		filePath: tool.schema
+			.string()
+			.describe("Path to the file containing the symbol to rename"),
+		line: tool.schema
+			.number()
+			.describe("Line number (1-based) where the symbol is located"),
+		character: tool.schema
+			.number()
+			.describe("Character position (0-based) within the line"),
+		newName: tool.schema.string().describe("The new name for the symbol"),
+	},
+
+	async execute(args) {
+		const cwd = process.cwd();
+		const absPath = resolve(cwd, args.filePath);
+		const server = resolveServer(absPath);
+
+		if (!server) {
+			return `Error: No LSP server available for file type: ${absPath}
+
+Install a language server:
+- TypeScript: npm i -g typescript-language-server typescript
+- Python: npm i -g pyright
+- Go: go install golang.org/x/tools/gopls@latest
+- Rust: rustup component add rust-analyzer`;
+		}
+
+		try {
+			const client = await lspManager.getClient(cwd, server);
+
+			const prepareResult = (await client.prepareRename(
+				absPath,
+				args.line,
+				args.character,
+			)) as PrepareRenameResult | null;
+			if (!prepareResult) {
+				lspManager.releaseClient(cwd, server.id);
+				return "Error: Cannot rename at this position. Make sure the cursor is on a valid symbol.";
+			}
+
+			const result = (await client.rename(
+				absPath,
+				args.line,
+				args.character,
+				args.newName,
+			)) as WorkspaceEdit | null;
+			lspManager.releaseClient(cwd, server.id);
+
+			if (!result) {
+				return "Error: Rename returned no changes.";
+			}
+
+			const preview = formatWorkspaceEditPreview(result);
+			const applyResult = applyWorkspaceEdit(result);
+
+			if (!applyResult.success) {
+				return `Error applying changes: ${applyResult.error}\n\nPlanned changes:\n${preview}`;
+			}
+
+			return `Successfully renamed to "${args.newName}".
+
+Files modified:
+${applyResult.filesModified.map((f) => `  - ${f}`).join("\n")}
+
+Note: Files were modified directly. Re-read before editing.`;
+		} catch (error) {
+			return `Error: ${error instanceof Error ? error.message : String(error)}`;
+		}
+	},
+});
+
+/**
+ * Get available code actions for a code range
+ */
+export const lsp_code_actions = tool({
+	description: `Get available code actions (quick fixes, refactorings) for a code range.
+
+This tool lists available actions like:
+- Quick fixes for diagnostics/errors
+- Refactoring options (extract function, inline variable, etc.)
+- Source actions (organize imports, fix all)
+
+Use lsp_code_action_apply to execute a specific action.`,
+
+	args: {
+		filePath: tool.schema.string().describe("Path to the file"),
+		startLine: tool.schema.number().describe("Start line (1-based)"),
+		startCharacter: tool.schema.number().describe("Start character (0-based)"),
+		endLine: tool.schema.number().describe("End line (1-based)"),
+		endCharacter: tool.schema.number().describe("End character (0-based)"),
+		only: tool.schema
+			.array(tool.schema.string())
+			.optional()
+			.describe(
+				"Filter by action kind: 'quickfix', 'refactor', 'refactor.extract', 'source.organizeImports'",
+			),
+	},
+
+	async execute(args) {
+		const cwd = process.cwd();
+		const absPath = resolve(cwd, args.filePath);
+		const server = resolveServer(absPath);
+
+		if (!server) {
+			return `Error: No LSP server available for file type: ${absPath}`;
+		}
+
+		try {
+			const client = await lspManager.getClient(cwd, server);
+			const result = (await client.codeAction(
+				absPath,
+				args.startLine,
+				args.startCharacter,
+				args.endLine,
+				args.endCharacter,
+				args.only,
+			)) as CodeAction[] | null;
+			lspManager.releaseClient(cwd, server.id);
+
+			if (!result || result.length === 0) {
+				return "No code actions available for this range.";
+			}
+
+			const actions = result.map((action, index) => {
+				const parts = [`${index + 1}. ${action.title}`];
+				if (action.kind) parts.push(`   Kind: ${action.kind}`);
+				if (action.isPreferred) parts.push("   (Preferred)");
+				if (action.disabled)
+					parts.push(`   (Disabled: ${action.disabled.reason})`);
+				return parts.join("\n");
+			});
+
+			return `Available code actions:\n\n${actions.join("\n\n")}\n\nUse lsp_refactor_code_action_apply with the action index to apply.`;
+		} catch (error) {
+			return `Error: ${error instanceof Error ? error.message : String(error)}`;
+		}
+	},
+});
+
+/**
+ * Apply a specific code action
+ */
+export const lsp_code_action_apply = tool({
+	description: `Apply a specific code action from lsp_refactor_code_actions.
+
+First call lsp_refactor_code_actions to see available actions, then use this tool with the action index to apply it.`,
+
+	args: {
+		filePath: tool.schema.string().describe("Path to the file"),
+		startLine: tool.schema.number().describe("Start line (1-based)"),
+		startCharacter: tool.schema.number().describe("Start character (0-based)"),
+		endLine: tool.schema.number().describe("End line (1-based)"),
+		endCharacter: tool.schema.number().describe("End character (0-based)"),
+		actionIndex: tool.schema
+			.number()
+			.describe(
+				"Index of the action to apply (1-based, from lsp_refactor_code_actions output)",
+			),
+		only: tool.schema
+			.array(tool.schema.string())
+			.optional()
+			.describe(
+				"Filter by action kind (same filter used in lsp_refactor_code_actions)",
+			),
+	},
+
+	async execute(args) {
+		const cwd = process.cwd();
+		const absPath = resolve(cwd, args.filePath);
+		const server = resolveServer(absPath);
+
+		if (!server) {
+			return `Error: No LSP server available for file type: ${absPath}`;
+		}
+
+		try {
+			const client = await lspManager.getClient(cwd, server);
+			const actions = (await client.codeAction(
+				absPath,
+				args.startLine,
+				args.startCharacter,
+				args.endLine,
+				args.endCharacter,
+				args.only,
+			)) as CodeAction[] | null;
+
+			if (!actions || actions.length === 0) {
+				lspManager.releaseClient(cwd, server.id);
+				return "No code actions available for this range.";
+			}
+
+			if (args.actionIndex < 1 || args.actionIndex > actions.length) {
+				lspManager.releaseClient(cwd, server.id);
+				return `Invalid action index. Available: 1-${actions.length}`;
+			}
+
+			let action = actions[args.actionIndex - 1];
+
+			if (action.data && !action.edit) {
+				action = (await client.codeActionResolve(action)) as CodeAction;
+			}
+
+			lspManager.releaseClient(cwd, server.id);
+
+			if (!action.edit) {
+				if (action.command) {
+					return `Action "${action.title}" has a command instead of edits. Commands are not supported yet.`;
+				}
+				return `Action "${action.title}" produced no edits.`;
+			}
+
+			const applyResult = applyWorkspaceEdit(action.edit);
+
+			if (!applyResult.success) {
+				return `Error applying action: ${applyResult.error}`;
+			}
+
+			return `Applied: "${action.title}"
+
+Files modified:
+${applyResult.filesModified.map((f) => `  - ${f}`).join("\n")}
+
+Note: Files were modified directly. Re-read before editing.`;
+		} catch (error) {
+			return `Error: ${error instanceof Error ? error.message : String(error)}`;
+		}
+	},
+});
+
+/**
+ * Organize imports in a file
+ */
+export const lsp_organize_imports = tool({
+	description: `Organize imports in a file using LSP.
+
+This removes unused imports and sorts/groups remaining imports according to language conventions.`,
+
+	args: {
+		filePath: tool.schema.string().describe("Path to the file"),
+	},
+
+	async execute(args) {
+		const cwd = process.cwd();
+		const absPath = resolve(cwd, args.filePath);
+		const server = resolveServer(absPath);
+
+		if (!server) {
+			return `Error: No LSP server available for file type: ${absPath}`;
+		}
+
+		try {
+			const client = await lspManager.getClient(cwd, server);
+			const actions = (await client.codeAction(absPath, 1, 0, 10000, 0, [
+				"source.organizeImports",
+			])) as CodeAction[] | null;
+
+			if (!actions || actions.length === 0) {
+				lspManager.releaseClient(cwd, server.id);
+				return "No organize imports action available for this file.";
+			}
+
+			let action = actions[0];
+			if (action.data && !action.edit) {
+				action = (await client.codeActionResolve(action)) as CodeAction;
+			}
+			lspManager.releaseClient(cwd, server.id);
+
+			if (!action.edit) {
+				return "Organize imports produced no changes (imports may already be organized).";
+			}
+
+			const applyResult = applyWorkspaceEdit(action.edit);
+
+			if (!applyResult.success) {
+				return `Error organizing imports: ${applyResult.error}`;
+			}
+
+			return `Imports organized in ${args.filePath}
+
+Note: File was modified directly. Re-read before editing.`;
+		} catch (error) {
+			return `Error: ${error instanceof Error ? error.message : String(error)}`;
+		}
+	},
+});
+
+// Default export for single-tool registration (uses rename as primary)
+export default lsp_rename;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "opencodekit",
-	"version": "0.6.2",
+	"version": "0.6.4",
 	"description": "CLI tool for bootstrapping and managing OpenCodeKit projects",
 	"type": "module",
 	"repository": {