@cortexkit/aft-opencode 0.2.0

package/dist/tools/editing.d.ts

@@ -0,0 +1,7 @@
+import type { ToolDefinition } from "@opencode-ai/plugin";
+import type { PluginContext } from "../types.js";
+/**
+ * Tool definitions for code editing commands: write, edit_symbol, edit_match, batch.
+ */
+export declare function editingTools(ctx: PluginContext): Record<string, ToolDefinition>;
+//# sourceMappingURL=editing.d.ts.map

package/dist/tools/editing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"editing.d.ts","sourceRoot":"","sources":["../../src/tools/editing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAG1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAsBjD;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAgI/E"}

package/dist/tools/editing.js

@@ -0,0 +1,150 @@
+import { tool } from "@opencode-ai/plugin";
+import { queryLspHints } from "../lsp.js";
+const z = tool.schema;
+/** Valid operations for edit_symbol. */
+const editOperationEnum = z
+    .enum(["replace", "delete", "insert_before", "insert_after"])
+    .describe("The edit operation to perform on the symbol");
+/** Schema for a single batch edit item — either match-replace or line-range. */
+const batchEditItem = z.union([
+    z.object({
+        match: z.string().describe("Text pattern to find and replace"),
+        replacement: z.string().describe("Replacement text"),
+    }),
+    z.object({
+        line_start: z.number().describe("Start line number (1-indexed)"),
+        line_end: z.number().describe("End line number (1-indexed, inclusive)"),
+        content: z.string().describe("Content to replace the line range with"),
+    }),
+]);
+/**
+ * Tool definitions for code editing commands: write, edit_symbol, edit_match, batch.
+ */
+export function editingTools(ctx) {
+    return {
+        aft_edit: {
+            description: "Edit files with tree-sitter precision. All modes auto-backup before changes and support dry_run.\n" +
+                "Modes:\n" +
+                "- 'symbol': Edit a named symbol (function, class, type) — preferred for code changes. Needs 'symbol', 'operation' (replace/delete/insert_before/insert_after), and 'content'. Response includes context_before/context_after (3 lines each) to detect duplication.\n" +
+                "- 'match': Find and replace text by content match — use for config values, strings, unnamed code. Needs 'match', 'replacement'. Set replace_all=true to replace ALL occurrences at once. Returns ambiguous_match if multiple hits without occurrence or replace_all. For multi-line matching, use actual newlines in the JSON string value. Supports glob patterns in 'file' (e.g. '**/*.ts') to replace across multiple files at once — returns {files: [...], total_replacements, total_files}.\n" +
+                "- 'write': Write full file content — for new files or complete rewrites. Needs 'content'.\n" +
+                "- 'batch': Multiple edits in one file atomically — each edit is {match, replacement} or {line_start, line_end, content} (1-based, inclusive). Supports per-edit 'occurrence' for disambiguation. Set content to empty string to delete lines entirely. line_start == total_lines+1 appends at EOF. line_end is auto-clamped to last line (safe to overshoot).\n" +
+                "- 'transaction': Atomic multi-file edits with rollback — if any file fails, all revert. Needs 'operations' array of {file, command, ...}.\n" +
+                "Returns formatted, validation_errors, backup_id.",
+            args: {
+                mode: z.enum(["symbol", "match", "write", "batch", "transaction"]).describe("Editing mode"),
+                file: z
+                    .string()
+                    .optional()
+                    .describe("Path to the file (required for all modes except transaction)"),
+                // symbol mode
+                symbol: z.string().optional().describe("Symbol name to edit (symbol mode)"),
+                operation: editOperationEnum.optional().describe("Edit operation (symbol mode)"),
+                scope: z
+                    .string()
+                    .optional()
+                    .describe("Qualified scope for disambiguation (e.g. 'ClassName.method')"),
+                // match mode
+                match: z.string().optional().describe("Text to find (match mode)"),
+                replacement: z.string().optional().describe("Replacement text (match mode)"),
+                occurrence: z
+                    .number()
+                    .describe("Zero-based index selecting which occurrence to replace when multiple matches exist (0 = first, 1 = second, etc). Use with ambiguous_match response. (match mode)"),
+                replace_all: z
+                    .boolean()
+                    .optional()
+                    .describe("Replace ALL occurrences instead of disambiguating (match mode, default: false)"),
+                // write + symbol content
+                content: z
+                    .string()
+                    .optional()
+                    .describe("New content (write mode: full file, symbol mode: replacement body)"),
+                create_dirs: z
+                    .boolean()
+                    .optional()
+                    .describe("Create parent directories (write mode, default: false)"),
+                // batch mode
+                edits: z
+                    .array(batchEditItem)
+                    .optional()
+                    .describe("Array of edits to apply atomically (batch mode)"),
+                // transaction mode
+                operations: z
+                    .array(z.object({
+                    file: z.string().describe("File path"),
+                    command: z.enum(["write", "edit_match"]).describe("Operation type"),
+                    content: z.string().optional().describe("Full content for write"),
+                    match: z.string().optional().describe("Text to find for edit_match"),
+                    replacement: z.string().optional().describe("Replacement for edit_match"),
+                }))
+                    .optional()
+                    .describe("Array of file operations (transaction mode)"),
+                // common
+                validate: z
+                    .enum(["syntax", "full"])
+                    .optional()
+                    .describe("Validation level: 'syntax' (default) or 'full'"),
+                dry_run: z.boolean().optional().describe("Preview as unified diff without modifying files"),
+            },
+            execute: async (args, context) => {
+                const bridge = ctx.pool.getBridge(context.directory);
+                const mode = args.mode;
+                const params = {};
+                if (args.file !== undefined)
+                    params.file = args.file;
+                if (args.validate !== undefined)
+                    params.validate = args.validate;
+                if (args.dry_run !== undefined)
+                    params.dry_run = args.dry_run;
+                let command;
+                switch (mode) {
+                    case "symbol": {
+                        command = "edit_symbol";
+                        params.symbol = args.symbol;
+                        params.operation = args.operation;
+                        if (args.content !== undefined)
+                            params.content = args.content;
+                        if (args.scope !== undefined)
+                            params.scope = args.scope;
+                        const hints = await queryLspHints(ctx.client, args.symbol);
+                        if (hints)
+                            params.lsp_hints = hints;
+                        break;
+                    }
+                    case "match": {
+                        command = "edit_match";
+                        params.match = args.match;
+                        params.replacement = args.replacement;
+                        if (args.occurrence !== undefined)
+                            params.occurrence = Number(args.occurrence);
+                        if (args.replace_all !== undefined)
+                            params.replace_all = args.replace_all;
+                        break;
+                    }
+                    case "write": {
+                        command = "write";
+                        params.content = args.content;
+                        if (args.create_dirs !== undefined)
+                            params.create_dirs = args.create_dirs;
+                        break;
+                    }
+                    case "batch": {
+                        command = "batch";
+                        params.edits = args.edits;
+                        break;
+                    }
+                    case "transaction": {
+                        command = "transaction";
+                        params.operations = args.operations;
+                        break;
+                    }
+                    default:
+                        command = mode;
+                }
+                const response = await bridge.send(command, params);
+                return JSON.stringify(response);
+            },
+        },
+    };
+}
+//# sourceMappingURL=editing.js.map

package/dist/tools/editing.js.map

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

package/dist/tools/imports.d.ts

@@ -0,0 +1,7 @@
+import type { ToolDefinition } from "@opencode-ai/plugin";
+import type { PluginContext } from "../types.js";
+/**
+ * Tool definitions for import management commands: add_import, remove_import, organize_imports.
+ */
+export declare function importTools(ctx: PluginContext): Record<string, ToolDefinition>;
+//# sourceMappingURL=imports.d.ts.map

package/dist/tools/imports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"imports.d.ts","sourceRoot":"","sources":["../../src/tools/imports.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAIjD;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAwD9E"}

package/dist/tools/imports.js

@@ -0,0 +1,67 @@
+import { tool } from "@opencode-ai/plugin";
+const z = tool.schema;
+/**
+ * Tool definitions for import management commands: add_import, remove_import, organize_imports.
+ */
+export function importTools(ctx) {
+    return {
+        aft_import: {
+            description: "Language-aware import management. Supports TS, JS, TSX, Python, Rust, and Go.\n" +
+                "Ops:\n" +
+                "- 'add': Add an import. Auto-detects group (stdlib/external/internal), deduplicates. Needs 'module', optional 'names', 'default_import', 'type_only'.\n" +
+                "- 'remove': Remove an import or a specific name from one. Needs 'module', optional 'name' to remove a single named import.\n" +
+                "- 'organize': Re-sort and re-group all imports by language convention, deduplicate.\n" +
+                "All ops need 'file'. Returns formatted, validation_errors.",
+            args: {
+                op: z.enum(["add", "remove", "organize"]).describe("Import operation"),
+                file: z.string().describe("Path to the file"),
+                module: z
+                    .string()
+                    .optional()
+                    .describe("Module path (required for add, remove — e.g. 'react', './utils', 'std::fmt')"),
+                names: z
+                    .array(z.string())
+                    .optional()
+                    .describe("Named imports to add (e.g. ['useState', 'useEffect'])"),
+                default_import: z.string().optional().describe("Default import name (e.g. 'React')"),
+                type_only: z.boolean().optional().describe("Type-only import (TS only, default: false)"),
+                name: z
+                    .string()
+                    .optional()
+                    .describe("Specific named import to remove (for remove op; omit to remove entire import)"),
+                validate: z
+                    .enum(["syntax", "full"])
+                    .optional()
+                    .describe("Validation level: 'syntax' (default) or 'full'"),
+                dry_run: z.boolean().optional().describe("Preview without modifying the file"),
+            },
+            execute: async (args, context) => {
+                const bridge = ctx.pool.getBridge(context.directory);
+                const op = args.op;
+                const commandMap = {
+                    add: "add_import",
+                    remove: "remove_import",
+                    organize: "organize_imports",
+                };
+                const params = { file: args.file };
+                if (args.module !== undefined)
+                    params.module = args.module;
+                if (args.names !== undefined)
+                    params.names = args.names;
+                if (args.default_import !== undefined)
+                    params.default_import = args.default_import;
+                if (args.type_only !== undefined)
+                    params.type_only = args.type_only;
+                if (args.name !== undefined)
+                    params.name = args.name;
+                if (args.validate !== undefined)
+                    params.validate = args.validate;
+                if (args.dry_run !== undefined)
+                    params.dry_run = args.dry_run;
+                const response = await bridge.send(commandMap[op], params);
+                return JSON.stringify(response);
+            },
+        },
+    };
+}
+//# sourceMappingURL=imports.js.map

package/dist/tools/imports.js.map

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

package/dist/tools/lsp.d.ts

@@ -0,0 +1,8 @@
+import type { ToolDefinition } from "@opencode-ai/plugin";
+import type { PluginContext } from "../types.js";
+/**
+ * Tool definitions for LSP commands: diagnostics, hover, goto_definition,
+ * find_references, prepare_rename, rename.
+ */
+export declare function lspTools(ctx: PluginContext): Record<string, ToolDefinition>;
+//# sourceMappingURL=lsp.d.ts.map

package/dist/tools/lsp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lsp.d.ts","sourceRoot":"","sources":["../../src/tools/lsp.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAGjD;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CA6H3E"}

package/dist/tools/lsp.js

@@ -0,0 +1,120 @@
+import { tool } from "@opencode-ai/plugin";
+const z = tool.schema;
+/**
+ * Tool definitions for LSP commands: diagnostics, hover, goto_definition,
+ * find_references, prepare_rename, rename.
+ */
+export function lspTools(ctx) {
+    return {
+        aft_lsp_diagnostics: {
+            description: "Get errors, warnings, hints from language server. " +
+                "Returns diagnostics from LSP servers (typescript-language-server, pyright, rust-analyzer, gopls). " +
+                "Lazily spawns the appropriate server on first use. " +
+                "For files, provide 'file' path. For directories, provide 'directory' path. " +
+                "Use 'severity' to filter (error/warning/information/hint/all). " +
+                "Use 'wait_ms' (default 0, max 10000) to wait for fresh diagnostics after an edit.",
+            args: {
+                file: z.string().optional().describe("Absolute path to file to get diagnostics for"),
+                directory: z
+                    .string()
+                    .optional()
+                    .describe("Absolute path to directory to get diagnostics for all files under it"),
+                severity: z
+                    .enum(["error", "warning", "information", "hint", "all"])
+                    .optional()
+                    .describe("Filter by severity level (default: all)"),
+                wait_ms: z
+                    .number()
+                    .optional()
+                    .describe("Wait N milliseconds for fresh diagnostics before returning (max 10000, default 0)"),
+            },
+            execute: async (args, context) => {
+                const bridge = ctx.pool.getBridge(context.directory);
+                const result = await bridge.send("lsp_diagnostics", args);
+                return JSON.stringify(result);
+            },
+        },
+        aft_lsp_hover: {
+            description: "Get type information and documentation for a symbol at a position. " +
+                "Returns hover content (type signatures, JSDoc, docstrings) from the language server. " +
+                "Line and character are 1-based.",
+            args: {
+                file: z.string().describe("Absolute path to the file"),
+                line: z.number().describe("1-based line number"),
+                character: z.number().describe("1-based column number"),
+            },
+            execute: async (args, context) => {
+                const bridge = ctx.pool.getBridge(context.directory);
+                const result = await bridge.send("lsp_hover", args);
+                return JSON.stringify(result);
+            },
+        },
+        aft_lsp_goto_definition: {
+            description: "Jump to symbol definition. Find WHERE something is defined. " +
+                "Returns definition location(s) with file path and 1-based line/column. " +
+                "Works across files — follows imports, type references, function calls.",
+            args: {
+                file: z.string().describe("Absolute path to the file"),
+                line: z.number().describe("1-based line number"),
+                character: z.number().describe("1-based column number"),
+            },
+            execute: async (args, context) => {
+                const bridge = ctx.pool.getBridge(context.directory);
+                const result = await bridge.send("lsp_goto_definition", args);
+                return JSON.stringify(result);
+            },
+        },
+        aft_lsp_find_references: {
+            description: "Find ALL usages/references of a symbol across the entire workspace. " +
+                "Returns all locations where the symbol is used, with 1-based line/column. " +
+                "Use before renaming or changing a function's signature to understand impact.",
+            args: {
+                file: z.string().describe("Absolute path to the file"),
+                line: z.number().describe("1-based line number"),
+                character: z.number().describe("1-based column number"),
+                include_declaration: z
+                    .boolean()
+                    .optional()
+                    .describe("Include the declaration itself (default: true)"),
+            },
+            execute: async (args, context) => {
+                const bridge = ctx.pool.getBridge(context.directory);
+                const result = await bridge.send("lsp_find_references", args);
+                return JSON.stringify(result);
+            },
+        },
+        aft_lsp_prepare_rename: {
+            description: "Check if rename is valid at a position. Use BEFORE aft_lsp_rename. " +
+                "Returns whether the symbol can be renamed, the current name (placeholder), " +
+                "and the range of the symbol. Line and character are 1-based.",
+            args: {
+                file: z.string().describe("Absolute path to the file"),
+                line: z.number().describe("1-based line number"),
+                character: z.number().describe("1-based column number"),
+            },
+            execute: async (args, context) => {
+                const bridge = ctx.pool.getBridge(context.directory);
+                const result = await bridge.send("lsp_prepare_rename", args);
+                return JSON.stringify(result);
+            },
+        },
+        aft_lsp_rename: {
+            description: "Rename symbol across entire workspace via LSP. " +
+                "APPLIES changes to all files atomically with backup and rollback on failure. " +
+                "Always call aft_lsp_prepare_rename first to verify the rename is valid. " +
+                "Line and character are 1-based.",
+            args: {
+                file: z.string().describe("Absolute path to the file"),
+                line: z.number().describe("1-based line number"),
+                character: z.number().describe("1-based column number"),
+                new_name: z.string().describe("New name for the symbol"),
+            },
+            execute: async (args, context) => {
+                const bridge = ctx.pool.getBridge(context.directory);
+                const result = await bridge.send("lsp_rename", args);
+                return JSON.stringify(result);
+            },
+        },
+    };
+}
+//# sourceMappingURL=lsp.js.map

package/dist/tools/lsp.js.map

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

package/dist/tools/navigation.d.ts

@@ -0,0 +1,7 @@
+import type { ToolDefinition } from "@opencode-ai/plugin";
+import type { PluginContext } from "../types.js";
+/**
+ * Tool definitions for navigation commands: configure, call_tree, callers, trace_to, impact, and trace_data.
+ */
+export declare function navigationTools(ctx: PluginContext): Record<string, ToolDefinition>;
+//# sourceMappingURL=navigation.d.ts.map

package/dist/tools/navigation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigation.d.ts","sourceRoot":"","sources":["../../src/tools/navigation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAIjD;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAwClF"}

package/dist/tools/navigation.js

@@ -0,0 +1,46 @@
+import { tool } from "@opencode-ai/plugin";
+const z = tool.schema;
+/**
+ * Tool definitions for navigation commands: configure, call_tree, callers, trace_to, impact, and trace_data.
+ */
+export function navigationTools(ctx) {
+    return {
+        aft_navigate: {
+            description: "Navigate code structure across files using call graph analysis.\n" +
+                "Modes:\n" +
+                "- 'call_tree': See what a function calls (forward). Use to understand dependencies before modifying a function.\n" +
+                "- 'callers': Find all call sites of a symbol. Use before renaming or changing a function's signature.\n" +
+                "- 'trace_to': Trace how execution reaches a function from entry points (routes, exports, main). Use to understand context around deeply-nested code.\n" +
+                "- 'impact': Analyze what breaks if a symbol changes. Returns affected callers with signatures and entry point status.\n" +
+                "- 'trace_data': Follow a value through variable assignments and function parameters across files. Needs 'expression' arg.",
+            args: {
+                mode: z
+                    .enum(["call_tree", "callers", "trace_to", "impact", "trace_data"])
+                    .describe("Navigation mode"),
+                file: z.string().describe("Path to the source file containing the symbol"),
+                symbol: z.string().describe("Name of the symbol to analyze"),
+                depth: z
+                    .number()
+                    .describe("Max traversal depth (default: call_tree=5, callers=1, trace_to=10, impact=5, trace_data=5)"),
+                expression: z
+                    .string()
+                    .optional()
+                    .describe("Expression to track through data flow (required for trace_data mode)"),
+            },
+            execute: async (args, context) => {
+                const bridge = ctx.pool.getBridge(context.directory);
+                const params = {
+                    file: args.file,
+                    symbol: args.symbol,
+                };
+                if (args.depth !== undefined)
+                    params.depth = Number(args.depth);
+                if (args.expression !== undefined)
+                    params.expression = args.expression;
+                const response = await bridge.send(args.mode, params);
+                return JSON.stringify(response);
+            },
+        },
+    };
+}
+//# sourceMappingURL=navigation.js.map

package/dist/tools/navigation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigation.js","sourceRoot":"","sources":["../../src/tools/navigation.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAG3C,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;AAEtB;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,GAAkB;IAChD,OAAO;QACL,YAAY,EAAE;YACZ,WAAW,EACT,mEAAmE;gBACnE,UAAU;gBACV,mHAAmH;gBACnH,yGAAyG;gBACzG,wJAAwJ;gBACxJ,yHAAyH;gBACzH,2HAA2H;YAC7H,IAAI,EAAE;gBACJ,IAAI,EAAE,CAAC;qBACJ,IAAI,CAAC,CAAC,WAAW,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC;qBAClE,QAAQ,CAAC,iBAAiB,CAAC;gBAC9B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+CAA+C,CAAC;gBAC1E,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;gBAC5D,KAAK,EAAE,CAAC;qBACL,MAAM,EAAE;qBACR,QAAQ,CACP,4FAA4F,CAC7F;gBACH,UAAU,EAAE,CAAC;qBACV,MAAM,EAAE;qBACR,QAAQ,EAAE;qBACV,QAAQ,CAAC,sEAAsE,CAAC;aACpF;YACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAmB,EAAE;gBAChD,MAAM,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;gBACrD,MAAM,MAAM,GAA4B;oBACtC,IAAI,EAAE,IAAI,CAAC,IAAI;oBACf,MAAM,EAAE,IAAI,CAAC,MAAM;iBACpB,CAAC;gBACF,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS;oBAAE,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBAChE,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS;oBAAE,MAAM,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;gBACvE,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAc,EAAE,MAAM,CAAC,CAAC;gBAChE,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;YAClC,CAAC;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/reading.d.ts

@@ -0,0 +1,7 @@
+import type { ToolDefinition } from "@opencode-ai/plugin";
+import type { PluginContext } from "../types.js";
+/**
+ * Tool definitions for code reading commands: outline and zoom.
+ */
+export declare function readingTools(ctx: PluginContext): Record<string, ToolDefinition>;
+//# sourceMappingURL=reading.d.ts.map

package/dist/tools/reading.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reading.d.ts","sourceRoot":"","sources":["../../src/tools/reading.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAG1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAIjD;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAsG/E"}

package/dist/tools/reading.js

@@ -0,0 +1,103 @@
+import { tool } from "@opencode-ai/plugin";
+import { queryLspHints } from "../lsp.js";
+const z = tool.schema;
+/**
+ * Tool definitions for code reading commands: outline and zoom.
+ */
+export function readingTools(ctx) {
+    return {
+        aft_outline: {
+            description: "Get a structural outline of a source file — lists all top-level symbols with their kind, name, line range, and visibility. Use this to understand file structure before editing. " +
+                "Supports single file (via 'file') or multiple files in one call (via 'files' array).\n" +
+                "Each entry includes 'name', 'kind' (function/class/struct/heading/etc), 'range', 'signature', and 'members' (nested children like methods in classes or sub-headings in markdown).\n" +
+                "For Markdown files (.md, .mdx): returns heading hierarchy — h1/h2/h3 as nested symbols with section ranges covering all content until the next same-level heading.",
+            args: {
+                file: z
+                    .string()
+                    .optional()
+                    .describe("Path to a single source file to outline (relative to project root or absolute)"),
+                files: z
+                    .array(z.string())
+                    .optional()
+                    .describe("Array of file paths to outline in one call — returns per-file results"),
+            },
+            execute: async (args, context) => {
+                const bridge = ctx.pool.getBridge(context.directory);
+                if (Array.isArray(args.files) && args.files.length > 0) {
+                    const response = await bridge.send("outline", { files: args.files });
+                    return JSON.stringify(response);
+                }
+                const response = await bridge.send("outline", { file: args.file });
+                return JSON.stringify(response);
+            },
+        },
+        aft_zoom: {
+            description: "Deep-inspect symbols or read arbitrary line ranges from a source file.\n" +
+                "Returns full source, surrounding context lines, and call-graph annotations (calls_out, called_by) for code symbols.\n" +
+                "Supports three access patterns:\n" +
+                "- 'symbol': Inspect a named symbol (function, class, type, or markdown heading)\n" +
+                "- 'symbols': Inspect multiple symbols in one call — returns an array of results\n" +
+                "- 'start_line' + 'end_line': Read arbitrary line range (1-based) without needing a symbol name\n" +
+                "For Markdown: use heading text as symbol name (e.g. symbol='Architecture') to read entire section.",
+            args: {
+                file: z.string().describe("Path to the source file containing the symbol"),
+                symbol: z.string().optional().describe("Name of a single symbol to inspect"),
+                symbols: z
+                    .array(z.string())
+                    .optional()
+                    .describe("Array of symbol names to inspect in one call — returns results for each"),
+                context_lines: z
+                    .number()
+                    .optional()
+                    .describe("Number of lines of context to include above and below the symbol (default: 3)"),
+                scope: z
+                    .string()
+                    .optional()
+                    .describe("Qualified scope to disambiguate symbols with the same name (e.g. 'ClassName.method')"),
+                start_line: z.number().optional().describe("Start line (1-based) for line-range read mode"),
+                end_line: z
+                    .number()
+                    .optional()
+                    .describe("End line (1-based, inclusive) for line-range read mode"),
+            },
+            execute: async (args, context) => {
+                const bridge = ctx.pool.getBridge(context.directory);
+                // Batch symbols mode: zoom into multiple symbols in one call
+                if (Array.isArray(args.symbols) && args.symbols.length > 0) {
+                    const results = await Promise.all(args.symbols.map(async (sym) => {
+                        const params = { file: args.file, symbol: sym };
+                        if (args.context_lines !== undefined)
+                            params.context_lines = Number(args.context_lines);
+                        if (args.scope !== undefined)
+                            params.scope = args.scope;
+                        const hints = await queryLspHints(ctx.client, sym);
+                        if (hints)
+                            params.lsp_hints = hints;
+                        return bridge.send("zoom", params);
+                    }));
+                    return JSON.stringify(results);
+                }
+                // Single symbol or line-range mode
+                const params = { file: args.file };
+                if (args.symbol !== undefined)
+                    params.symbol = args.symbol;
+                if (args.context_lines !== undefined)
+                    params.context_lines = Number(args.context_lines);
+                if (args.scope !== undefined)
+                    params.scope = args.scope;
+                if (args.start_line !== undefined)
+                    params.start_line = Number(args.start_line);
+                if (args.end_line !== undefined)
+                    params.end_line = Number(args.end_line);
+                if (args.symbol) {
+                    const hints = await queryLspHints(ctx.client, args.symbol);
+                    if (hints)
+                        params.lsp_hints = hints;
+                }
+                const response = await bridge.send("zoom", params);
+                return JSON.stringify(response);
+            },
+        },
+    };
+}
+//# sourceMappingURL=reading.js.map

package/dist/tools/reading.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reading.js","sourceRoot":"","sources":["../../src/tools/reading.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAG1C,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;AAEtB;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,GAAkB;IAC7C,OAAO;QACL,WAAW,EAAE;YACX,WAAW,EACT,mLAAmL;gBACnL,wFAAwF;gBACxF,sLAAsL;gBACtL,oKAAoK;YACtK,IAAI,EAAE;gBACJ,IAAI,EAAE,CAAC;qBACJ,MAAM,EAAE;qBACR,QAAQ,EAAE;qBACV,QAAQ,CACP,gFAAgF,CACjF;gBACH,KAAK,EAAE,CAAC;qBACL,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;qBACjB,QAAQ,EAAE;qBACV,QAAQ,CAAC,uEAAuE,CAAC;aACrF;YACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAmB,EAAE;gBAChD,MAAM,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;gBACrD,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACvD,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;oBACrE,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;gBAClC,CAAC;gBACD,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;gBACnE,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;YAClC,CAAC;SACF;QAED,QAAQ,EAAE;YACR,WAAW,EACT,0EAA0E;gBAC1E,uHAAuH;gBACvH,mCAAmC;gBACnC,mFAAmF;gBACnF,mFAAmF;gBACnF,kGAAkG;gBAClG,oGAAoG;YACtG,IAAI,EAAE;gBACJ,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+CAA+C,CAAC;gBAC1E,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;gBAC5E,OAAO,EAAE,CAAC;qBACP,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;qBACjB,QAAQ,EAAE;qBACV,QAAQ,CAAC,yEAAyE,CAAC;gBACtF,aAAa,EAAE,CAAC;qBACb,MAAM,EAAE;qBACR,QAAQ,EAAE;qBACV,QAAQ,CACP,+EAA+E,CAChF;gBACH,KAAK,EAAE,CAAC;qBACL,MAAM,EAAE;qBACR,QAAQ,EAAE;qBACV,QAAQ,CACP,sFAAsF,CACvF;gBACH,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+CAA+C,CAAC;gBAC3F,QAAQ,EAAE,CAAC;qBACR,MAAM,EAAE;qBACR,QAAQ,EAAE;qBACV,QAAQ,CAAC,wDAAwD,CAAC;aACtE;YACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAmB,EAAE;gBAChD,MAAM,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;gBAErD,6DAA6D;gBAC7D,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAC3D,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAC9B,IAAI,CAAC,OAAoB,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;wBAC3C,MAAM,MAAM,GAA4B,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;wBACzE,IAAI,IAAI,CAAC,aAAa,KAAK,SAAS;4BAClC,MAAM,CAAC,aAAa,GAAG,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;wBACpD,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS;4BAAE,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;wBACxD,MAAM,KAAK,GAAG,MAAM,aAAa,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;wBACnD,IAAI,KAAK;4BAAE,MAAM,CAAC,SAAS,GAAG,KAAK,CAAC;wBACpC,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;oBACrC,CAAC,CAAC,CACH,CAAC;oBACF,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;gBACjC,CAAC;gBAED,mCAAmC;gBACnC,MAAM,MAAM,GAA4B,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;gBAC5D,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS;oBAAE,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;gBAC3D,IAAI,IAAI,CAAC,aAAa,KAAK,SAAS;oBAAE,MAAM,CAAC,aAAa,GAAG,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;gBACxF,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS;oBAAE,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;gBACxD,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS;oBAAE,MAAM,CAAC,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;gBAC/E,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS;oBAAE,MAAM,CAAC,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBAEzE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;oBAChB,MAAM,KAAK,GAAG,MAAM,aAAa,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,MAAgB,CAAC,CAAC;oBACrE,IAAI,KAAK;wBAAE,MAAM,CAAC,SAAS,GAAG,KAAK,CAAC;gBACtC,CAAC;gBAED,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;gBACnD,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;YAClC,CAAC;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/refactoring.d.ts

@@ -0,0 +1,7 @@
+import type { ToolDefinition } from "@opencode-ai/plugin";
+import type { PluginContext } from "../types.js";
+/**
+ * Tool definitions for refactoring commands: move_symbol, extract_function, inline_symbol.
+ */
+export declare function refactoringTools(ctx: PluginContext): Record<string, ToolDefinition>;
+//# sourceMappingURL=refactoring.d.ts.map

package/dist/tools/refactoring.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"refactoring.d.ts","sourceRoot":"","sources":["../../src/tools/refactoring.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAG1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAIjD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAyEnF"}