@hansjm10/volt-coding-agent 0.0.0-bootstrap.0 → 0.1.0

package/dist/core/tools/index.js

@@ -0,0 +1,174 @@
+export { createMcpTool, createMcpToolDefinition, } from "../mcp/gateway-tool.js";
+export { createBashTool, createBashToolDefinition, createLocalBashOperations, } from "./bash.js";
+export { createEditTool, createEditToolDefinition, } from "./edit.js";
+export { withFileMutationQueue } from "./file-mutation-queue.js";
+export { createFindTool, createFindToolDefinition, } from "./find.js";
+export { createGrepTool, createGrepToolDefinition, } from "./grep.js";
+export { createLsTool, createLsToolDefinition, } from "./ls.js";
+export { createLspTool, createLspToolDefinition, } from "./lsp.js";
+export { createReadTool, createReadToolDefinition, } from "./read.js";
+export { createSubagentTool, createSubagentToolDefinition, DEFAULT_SUBAGENT_AGGREGATE_OUTPUT_MAX_BYTES, DEFAULT_SUBAGENT_CHAIN_MAX_STEPS, DEFAULT_SUBAGENT_OUTPUT_MAX_BYTES, DEFAULT_SUBAGENT_PARALLEL_MAX_CONCURRENCY, DEFAULT_SUBAGENT_PARALLEL_MAX_TASKS, } from "./subagent.js";
+export { DEFAULT_MAX_BYTES, DEFAULT_MAX_LINES, formatSize, truncateHead, truncateLine, truncateTail, } from "./truncate.js";
+export { BRAVE_SEARCH_AUTH_PROVIDER, createDefaultWebSearchOperations, createWebSearchTool, createWebSearchToolDefinition, } from "./web-search.js";
+export { createWriteTool, createWriteToolDefinition, } from "./write.js";
+import { createMcpTool, createMcpToolDefinition } from "../mcp/gateway-tool.js";
+import { createBashTool, createBashToolDefinition } from "./bash.js";
+import { createEditTool, createEditToolDefinition } from "./edit.js";
+import { createFindTool, createFindToolDefinition } from "./find.js";
+import { createGrepTool, createGrepToolDefinition } from "./grep.js";
+import { createLsTool, createLsToolDefinition } from "./ls.js";
+import { createLspTool, createLspToolDefinition } from "./lsp.js";
+import { createReadTool, createReadToolDefinition } from "./read.js";
+import { createSubagentTool, createSubagentToolDefinition } from "./subagent.js";
+import { createWebSearchTool, createWebSearchToolDefinition } from "./web-search.js";
+import { createWriteTool, createWriteToolDefinition } from "./write.js";
+export const DEFAULT_ACTIVE_TOOL_NAMES = ["read", "bash", "edit", "write", "web_search"];
+export const READ_ONLY_TOOL_NAMES = ["read", "web_search", "grep", "find", "ls"];
+export const allToolNames = new Set([
+    "read",
+    "bash",
+    "edit",
+    "write",
+    "web_search",
+    "grep",
+    "find",
+    "ls",
+    "lsp",
+    "subagent",
+    "mcp",
+]);
+export function createToolDefinition(toolName, cwd, options) {
+    switch (toolName) {
+        case "read":
+            return createReadToolDefinition(cwd, options?.read);
+        case "bash":
+            return createBashToolDefinition(cwd, options?.bash);
+        case "edit":
+            return createEditToolDefinition(cwd, options?.edit);
+        case "write":
+            return createWriteToolDefinition(cwd, options?.write);
+        case "web_search":
+            return createWebSearchToolDefinition(cwd, options?.webSearch);
+        case "grep":
+            return createGrepToolDefinition(cwd, options?.grep);
+        case "find":
+            return createFindToolDefinition(cwd, options?.find);
+        case "ls":
+            return createLsToolDefinition(cwd, options?.ls);
+        case "lsp":
+            return createLspToolDefinition(cwd, options?.lsp);
+        case "subagent":
+            if (!options?.subagent) {
+                throw new Error("Subagent tool requires SubagentToolOptions");
+            }
+            return createSubagentToolDefinition(options.subagent);
+        case "mcp":
+            if (!options?.mcp) {
+                throw new Error("MCP tool requires McpGatewayToolOptions");
+            }
+            return createMcpToolDefinition(options.mcp);
+        default:
+            throw new Error(`Unknown tool name: ${toolName}`);
+    }
+}
+export function createTool(toolName, cwd, options) {
+    switch (toolName) {
+        case "read":
+            return createReadTool(cwd, options?.read);
+        case "bash":
+            return createBashTool(cwd, options?.bash);
+        case "edit":
+            return createEditTool(cwd, options?.edit);
+        case "write":
+            return createWriteTool(cwd, options?.write);
+        case "web_search":
+            return createWebSearchTool(cwd, options?.webSearch);
+        case "grep":
+            return createGrepTool(cwd, options?.grep);
+        case "find":
+            return createFindTool(cwd, options?.find);
+        case "ls":
+            return createLsTool(cwd, options?.ls);
+        case "lsp":
+            return createLspTool(cwd, options?.lsp);
+        case "subagent":
+            if (!options?.subagent) {
+                throw new Error("Subagent tool requires SubagentToolOptions");
+            }
+            return createSubagentTool(cwd, options.subagent);
+        case "mcp":
+            if (!options?.mcp) {
+                throw new Error("MCP tool requires McpGatewayToolOptions");
+            }
+            return createMcpTool(options.mcp);
+        default:
+            throw new Error(`Unknown tool name: ${toolName}`);
+    }
+}
+export function createCodingToolDefinitions(cwd, options) {
+    return [
+        createReadToolDefinition(cwd, options?.read),
+        createBashToolDefinition(cwd, options?.bash),
+        createEditToolDefinition(cwd, options?.edit),
+        createWriteToolDefinition(cwd, options?.write),
+        createWebSearchToolDefinition(cwd, options?.webSearch),
+    ];
+}
+export function createReadOnlyToolDefinitions(cwd, options) {
+    return [
+        createReadToolDefinition(cwd, options?.read),
+        createWebSearchToolDefinition(cwd, options?.webSearch),
+        createGrepToolDefinition(cwd, options?.grep),
+        createFindToolDefinition(cwd, options?.find),
+        createLsToolDefinition(cwd, options?.ls),
+    ];
+}
+export function createAllToolDefinitions(cwd, options) {
+    return {
+        read: createReadToolDefinition(cwd, options?.read),
+        bash: createBashToolDefinition(cwd, options?.bash),
+        edit: createEditToolDefinition(cwd, options?.edit),
+        write: createWriteToolDefinition(cwd, options?.write),
+        web_search: createWebSearchToolDefinition(cwd, options?.webSearch),
+        grep: createGrepToolDefinition(cwd, options?.grep),
+        find: createFindToolDefinition(cwd, options?.find),
+        ls: createLsToolDefinition(cwd, options?.ls),
+        lsp: createLspToolDefinition(cwd, options?.lsp),
+        ...(options?.subagent ? { subagent: createSubagentToolDefinition(options.subagent) } : {}),
+        ...(options?.mcp ? { mcp: createMcpToolDefinition(options.mcp) } : {}),
+    };
+}
+export function createCodingTools(cwd, options) {
+    return [
+        createReadTool(cwd, options?.read),
+        createBashTool(cwd, options?.bash),
+        createEditTool(cwd, options?.edit),
+        createWriteTool(cwd, options?.write),
+        createWebSearchTool(cwd, options?.webSearch),
+    ];
+}
+export function createReadOnlyTools(cwd, options) {
+    return [
+        createReadTool(cwd, options?.read),
+        createWebSearchTool(cwd, options?.webSearch),
+        createGrepTool(cwd, options?.grep),
+        createFindTool(cwd, options?.find),
+        createLsTool(cwd, options?.ls),
+    ];
+}
+export function createAllTools(cwd, options) {
+    return {
+        read: createReadTool(cwd, options?.read),
+        bash: createBashTool(cwd, options?.bash),
+        edit: createEditTool(cwd, options?.edit),
+        write: createWriteTool(cwd, options?.write),
+        web_search: createWebSearchTool(cwd, options?.webSearch),
+        grep: createGrepTool(cwd, options?.grep),
+        find: createFindTool(cwd, options?.find),
+        ls: createLsTool(cwd, options?.ls),
+        lsp: createLspTool(cwd, options?.lsp),
+        ...(options?.subagent ? { subagent: createSubagentTool(cwd, options.subagent) } : {}),
+        ...(options?.mcp ? { mcp: createMcpTool(options.mcp) } : {}),
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/core/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/tools/index.ts"],"names":[],"mappings":"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","sourcesContent":["export {\n\tcreateMcpTool,\n\tcreateMcpToolDefinition,\n\ttype McpGatewayToolDetails,\n\ttype McpGatewayToolInput,\n\ttype McpGatewayToolOptions,\n} from \"../mcp/gateway-tool.ts\";\nexport {\n\ttype BashOperations,\n\ttype BashSpawnContext,\n\ttype BashSpawnHook,\n\ttype BashToolDetails,\n\ttype BashToolInput,\n\ttype BashToolOptions,\n\tcreateBashTool,\n\tcreateBashToolDefinition,\n\tcreateLocalBashOperations,\n} from \"./bash.ts\";\nexport type { ToolDiagnosticsProvider } from \"./diagnostics-provider.ts\";\nexport {\n\tcreateEditTool,\n\tcreateEditToolDefinition,\n\ttype EditOperations,\n\ttype EditToolDetails,\n\ttype EditToolInput,\n\ttype EditToolOptions,\n} from \"./edit.ts\";\nexport { withFileMutationQueue } from \"./file-mutation-queue.ts\";\nexport {\n\tcreateFindTool,\n\tcreateFindToolDefinition,\n\ttype FindOperations,\n\ttype FindToolDetails,\n\ttype FindToolInput,\n\ttype FindToolOptions,\n} from \"./find.ts\";\nexport {\n\tcreateGrepTool,\n\tcreateGrepToolDefinition,\n\ttype GrepOperations,\n\ttype GrepToolDetails,\n\ttype GrepToolInput,\n\ttype GrepToolOptions,\n} from \"./grep.ts\";\nexport {\n\tcreateLsTool,\n\tcreateLsToolDefinition,\n\ttype LsOperations,\n\ttype LsToolDetails,\n\ttype LsToolInput,\n\ttype LsToolOptions,\n} from \"./ls.ts\";\nexport {\n\tcreateLspTool,\n\tcreateLspToolDefinition,\n\ttype LspAction,\n\ttype LspNavigationProvider,\n\ttype LspToolDetails,\n\ttype LspToolInput,\n\ttype LspToolOptions,\n} from \"./lsp.ts\";\nexport {\n\tcreateReadTool,\n\tcreateReadToolDefinition,\n\ttype ReadOperations,\n\ttype ReadToolDetails,\n\ttype ReadToolInput,\n\ttype ReadToolOptions,\n} from \"./read.ts\";\nexport {\n\tcreateSubagentTool,\n\tcreateSubagentToolDefinition,\n\tDEFAULT_SUBAGENT_AGGREGATE_OUTPUT_MAX_BYTES,\n\tDEFAULT_SUBAGENT_CHAIN_MAX_STEPS,\n\tDEFAULT_SUBAGENT_OUTPUT_MAX_BYTES,\n\tDEFAULT_SUBAGENT_PARALLEL_MAX_CONCURRENCY,\n\tDEFAULT_SUBAGENT_PARALLEL_MAX_TASKS,\n\ttype SubagentToolAgentDetails,\n\ttype SubagentToolDetails,\n\ttype SubagentToolErrorDetails,\n\ttype SubagentToolInput,\n\ttype SubagentToolManager,\n\ttype SubagentToolMode,\n\ttype SubagentToolOptions,\n\ttype SubagentToolOutputDetails,\n\ttype SubagentToolOverallStatus,\n\ttype SubagentToolStatus,\n\ttype SubagentToolTaskDetails,\n\ttype SubagentToolTaskInput,\n\ttype SubagentToolUsageDetails,\n} from \"./subagent.ts\";\nexport {\n\tDEFAULT_MAX_BYTES,\n\tDEFAULT_MAX_LINES,\n\tformatSize,\n\ttype TruncationOptions,\n\ttype TruncationResult,\n\ttruncateHead,\n\ttruncateLine,\n\ttruncateTail,\n} from \"./truncate.ts\";\nexport {\n\tBRAVE_SEARCH_AUTH_PROVIDER,\n\tcreateDefaultWebSearchOperations,\n\tcreateWebSearchTool,\n\tcreateWebSearchToolDefinition,\n\ttype DefaultWebSearchOperationsOptions,\n\ttype WebSearchFetcher,\n\ttype WebSearchModelContext,\n\ttype WebSearchModelContextProvider,\n\ttype WebSearchOperations,\n\ttype WebSearchRequest,\n\ttype WebSearchResponse,\n\ttype WebSearchResult,\n\ttype WebSearchToolDetails,\n\ttype WebSearchToolInput,\n\ttype WebSearchToolOptions,\n} from \"./web-search.ts\";\nexport {\n\tcreateWriteTool,\n\tcreateWriteToolDefinition,\n\ttype WriteOperations,\n\ttype WriteToolDetails,\n\ttype WriteToolInput,\n\ttype WriteToolOptions,\n} from \"./write.ts\";\n\nimport type { AgentTool } from \"@hansjm10/volt-agent-core\";\nimport type { ToolDefinition } from \"../extensions/types.ts\";\nimport { createMcpTool, createMcpToolDefinition, type McpGatewayToolOptions } from \"../mcp/gateway-tool.ts\";\nimport { type BashToolOptions, createBashTool, createBashToolDefinition } from \"./bash.ts\";\nimport { createEditTool, createEditToolDefinition, type EditToolOptions } from \"./edit.ts\";\nimport { createFindTool, createFindToolDefinition, type FindToolOptions } from \"./find.ts\";\nimport { createGrepTool, createGrepToolDefinition, type GrepToolOptions } from \"./grep.ts\";\nimport { createLsTool, createLsToolDefinition, type LsToolOptions } from \"./ls.ts\";\nimport { createLspTool, createLspToolDefinition, type LspToolOptions } from \"./lsp.ts\";\nimport { createReadTool, createReadToolDefinition, type ReadToolOptions } from \"./read.ts\";\nimport { createSubagentTool, createSubagentToolDefinition, type SubagentToolOptions } from \"./subagent.ts\";\nimport { createWebSearchTool, createWebSearchToolDefinition, type WebSearchToolOptions } from \"./web-search.ts\";\nimport { createWriteTool, createWriteToolDefinition, type WriteToolOptions } from \"./write.ts\";\n\nexport type Tool = AgentTool<any>;\nexport type ToolDef = ToolDefinition<any, any>;\nexport type CoreToolName = \"read\" | \"bash\" | \"edit\" | \"write\" | \"web_search\" | \"grep\" | \"find\" | \"ls\" | \"lsp\";\nexport type ToolName = CoreToolName | \"subagent\" | \"mcp\";\nexport const DEFAULT_ACTIVE_TOOL_NAMES: readonly CoreToolName[] = [\"read\", \"bash\", \"edit\", \"write\", \"web_search\"];\nexport const READ_ONLY_TOOL_NAMES: readonly CoreToolName[] = [\"read\", \"web_search\", \"grep\", \"find\", \"ls\"];\nexport const allToolNames: Set<ToolName> = new Set([\n\t\"read\",\n\t\"bash\",\n\t\"edit\",\n\t\"write\",\n\t\"web_search\",\n\t\"grep\",\n\t\"find\",\n\t\"ls\",\n\t\"lsp\",\n\t\"subagent\",\n\t\"mcp\",\n]);\n\nexport interface ToolsOptions {\n\tread?: ReadToolOptions;\n\tbash?: BashToolOptions;\n\twrite?: WriteToolOptions;\n\tedit?: EditToolOptions;\n\twebSearch?: WebSearchToolOptions;\n\tgrep?: GrepToolOptions;\n\tfind?: FindToolOptions;\n\tls?: LsToolOptions;\n\tlsp?: LspToolOptions;\n\tsubagent?: SubagentToolOptions;\n\tmcp?: McpGatewayToolOptions;\n}\n\nexport function createToolDefinition(toolName: ToolName, cwd: string, options?: ToolsOptions): ToolDef {\n\tswitch (toolName) {\n\t\tcase \"read\":\n\t\t\treturn createReadToolDefinition(cwd, options?.read);\n\t\tcase \"bash\":\n\t\t\treturn createBashToolDefinition(cwd, options?.bash);\n\t\tcase \"edit\":\n\t\t\treturn createEditToolDefinition(cwd, options?.edit);\n\t\tcase \"write\":\n\t\t\treturn createWriteToolDefinition(cwd, options?.write);\n\t\tcase \"web_search\":\n\t\t\treturn createWebSearchToolDefinition(cwd, options?.webSearch);\n\t\tcase \"grep\":\n\t\t\treturn createGrepToolDefinition(cwd, options?.grep);\n\t\tcase \"find\":\n\t\t\treturn createFindToolDefinition(cwd, options?.find);\n\t\tcase \"ls\":\n\t\t\treturn createLsToolDefinition(cwd, options?.ls);\n\t\tcase \"lsp\":\n\t\t\treturn createLspToolDefinition(cwd, options?.lsp);\n\t\tcase \"subagent\":\n\t\t\tif (!options?.subagent) {\n\t\t\t\tthrow new Error(\"Subagent tool requires SubagentToolOptions\");\n\t\t\t}\n\t\t\treturn createSubagentToolDefinition(options.subagent);\n\t\tcase \"mcp\":\n\t\t\tif (!options?.mcp) {\n\t\t\t\tthrow new Error(\"MCP tool requires McpGatewayToolOptions\");\n\t\t\t}\n\t\t\treturn createMcpToolDefinition(options.mcp);\n\t\tdefault:\n\t\t\tthrow new Error(`Unknown tool name: ${toolName}`);\n\t}\n}\n\nexport function createTool(toolName: ToolName, cwd: string, options?: ToolsOptions): Tool {\n\tswitch (toolName) {\n\t\tcase \"read\":\n\t\t\treturn createReadTool(cwd, options?.read);\n\t\tcase \"bash\":\n\t\t\treturn createBashTool(cwd, options?.bash);\n\t\tcase \"edit\":\n\t\t\treturn createEditTool(cwd, options?.edit);\n\t\tcase \"write\":\n\t\t\treturn createWriteTool(cwd, options?.write);\n\t\tcase \"web_search\":\n\t\t\treturn createWebSearchTool(cwd, options?.webSearch);\n\t\tcase \"grep\":\n\t\t\treturn createGrepTool(cwd, options?.grep);\n\t\tcase \"find\":\n\t\t\treturn createFindTool(cwd, options?.find);\n\t\tcase \"ls\":\n\t\t\treturn createLsTool(cwd, options?.ls);\n\t\tcase \"lsp\":\n\t\t\treturn createLspTool(cwd, options?.lsp);\n\t\tcase \"subagent\":\n\t\t\tif (!options?.subagent) {\n\t\t\t\tthrow new Error(\"Subagent tool requires SubagentToolOptions\");\n\t\t\t}\n\t\t\treturn createSubagentTool(cwd, options.subagent);\n\t\tcase \"mcp\":\n\t\t\tif (!options?.mcp) {\n\t\t\t\tthrow new Error(\"MCP tool requires McpGatewayToolOptions\");\n\t\t\t}\n\t\t\treturn createMcpTool(options.mcp);\n\t\tdefault:\n\t\t\tthrow new Error(`Unknown tool name: ${toolName}`);\n\t}\n}\n\nexport function createCodingToolDefinitions(cwd: string, options?: ToolsOptions): ToolDef[] {\n\treturn [\n\t\tcreateReadToolDefinition(cwd, options?.read),\n\t\tcreateBashToolDefinition(cwd, options?.bash),\n\t\tcreateEditToolDefinition(cwd, options?.edit),\n\t\tcreateWriteToolDefinition(cwd, options?.write),\n\t\tcreateWebSearchToolDefinition(cwd, options?.webSearch),\n\t];\n}\n\nexport function createReadOnlyToolDefinitions(cwd: string, options?: ToolsOptions): ToolDef[] {\n\treturn [\n\t\tcreateReadToolDefinition(cwd, options?.read),\n\t\tcreateWebSearchToolDefinition(cwd, options?.webSearch),\n\t\tcreateGrepToolDefinition(cwd, options?.grep),\n\t\tcreateFindToolDefinition(cwd, options?.find),\n\t\tcreateLsToolDefinition(cwd, options?.ls),\n\t];\n}\n\nexport function createAllToolDefinitions(\n\tcwd: string,\n\toptions?: ToolsOptions,\n): Record<CoreToolName, ToolDef> & Partial<Record<\"subagent\" | \"mcp\", ToolDef>> {\n\treturn {\n\t\tread: createReadToolDefinition(cwd, options?.read),\n\t\tbash: createBashToolDefinition(cwd, options?.bash),\n\t\tedit: createEditToolDefinition(cwd, options?.edit),\n\t\twrite: createWriteToolDefinition(cwd, options?.write),\n\t\tweb_search: createWebSearchToolDefinition(cwd, options?.webSearch),\n\t\tgrep: createGrepToolDefinition(cwd, options?.grep),\n\t\tfind: createFindToolDefinition(cwd, options?.find),\n\t\tls: createLsToolDefinition(cwd, options?.ls),\n\t\tlsp: createLspToolDefinition(cwd, options?.lsp),\n\t\t...(options?.subagent ? { subagent: createSubagentToolDefinition(options.subagent) } : {}),\n\t\t...(options?.mcp ? { mcp: createMcpToolDefinition(options.mcp) } : {}),\n\t};\n}\n\nexport function createCodingTools(cwd: string, options?: ToolsOptions): Tool[] {\n\treturn [\n\t\tcreateReadTool(cwd, options?.read),\n\t\tcreateBashTool(cwd, options?.bash),\n\t\tcreateEditTool(cwd, options?.edit),\n\t\tcreateWriteTool(cwd, options?.write),\n\t\tcreateWebSearchTool(cwd, options?.webSearch),\n\t];\n}\n\nexport function createReadOnlyTools(cwd: string, options?: ToolsOptions): Tool[] {\n\treturn [\n\t\tcreateReadTool(cwd, options?.read),\n\t\tcreateWebSearchTool(cwd, options?.webSearch),\n\t\tcreateGrepTool(cwd, options?.grep),\n\t\tcreateFindTool(cwd, options?.find),\n\t\tcreateLsTool(cwd, options?.ls),\n\t];\n}\n\nexport function createAllTools(\n\tcwd: string,\n\toptions?: ToolsOptions,\n): Record<CoreToolName, Tool> & Partial<Record<\"subagent\" | \"mcp\", Tool>> {\n\treturn {\n\t\tread: createReadTool(cwd, options?.read),\n\t\tbash: createBashTool(cwd, options?.bash),\n\t\tedit: createEditTool(cwd, options?.edit),\n\t\twrite: createWriteTool(cwd, options?.write),\n\t\tweb_search: createWebSearchTool(cwd, options?.webSearch),\n\t\tgrep: createGrepTool(cwd, options?.grep),\n\t\tfind: createFindTool(cwd, options?.find),\n\t\tls: createLsTool(cwd, options?.ls),\n\t\tlsp: createLspTool(cwd, options?.lsp),\n\t\t...(options?.subagent ? { subagent: createSubagentTool(cwd, options.subagent) } : {}),\n\t\t...(options?.mcp ? { mcp: createMcpTool(options.mcp) } : {}),\n\t};\n}\n"]}

package/dist/core/tools/ls.d.ts

@@ -0,0 +1,37 @@
+import type { AgentTool } from "@hansjm10/volt-agent-core";
+import { type Static, Type } from "typebox";
+import type { ToolDefinition } from "../extensions/types.ts";
+import { type TruncationResult } from "./truncate.ts";
+declare const lsSchema: Type.TObject<{
+    path: Type.TOptional<Type.TString>;
+    limit: Type.TOptional<Type.TNumber>;
+}>;
+export type LsToolInput = Static<typeof lsSchema>;
+export interface LsToolDetails {
+    truncation?: TruncationResult;
+    entryLimitReached?: number;
+}
+/**
+ * Pluggable operations for the ls tool.
+ * Override these to delegate directory listing to remote systems (for example SSH).
+ */
+export interface LsOperations {
+    /** Check if path exists */
+    exists: (absolutePath: string) => Promise<boolean> | boolean;
+    /** Get file or directory stats. Throws if not found. */
+    stat: (absolutePath: string) => Promise<{
+        isDirectory: () => boolean;
+    }> | {
+        isDirectory: () => boolean;
+    };
+    /** Read directory entries */
+    readdir: (absolutePath: string) => Promise<string[]> | string[];
+}
+export interface LsToolOptions {
+    /** Custom operations for directory listing. Default: local filesystem */
+    operations?: LsOperations;
+}
+export declare function createLsToolDefinition(cwd: string, options?: LsToolOptions): ToolDefinition<typeof lsSchema, LsToolDetails | undefined>;
+export declare function createLsTool(cwd: string, options?: LsToolOptions): AgentTool<typeof lsSchema>;
+export {};
+//# sourceMappingURL=ls.d.ts.map

package/dist/core/tools/ls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ls.d.ts","sourceRoot":"","sources":["../../../src/core/tools/ls.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAG3D,OAAO,EAAE,KAAK,MAAM,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAE5C,OAAO,KAAK,EAAE,cAAc,EAA2B,MAAM,wBAAwB,CAAC;AAKtF,OAAO,EAAiC,KAAK,gBAAgB,EAAgB,MAAM,eAAe,CAAC;AAEnG,QAAA,MAAM,QAAQ;;;EAGZ,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,QAAQ,CAAC,CAAC;AAIlD,MAAM,WAAW,aAAa;IAC7B,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC5B,2BAA2B;IAC3B,MAAM,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;IAC7D,wDAAwD;IACxD,IAAI,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC;QAAE,WAAW,EAAE,MAAM,OAAO,CAAA;KAAE,CAAC,GAAG;QAAE,WAAW,EAAE,MAAM,OAAO,CAAA;KAAE,CAAC;IACzG,6BAA6B;IAC7B,OAAO,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC;CAChE;AAQD,MAAM,WAAW,aAAa;IAC7B,yEAAyE;IACzE,UAAU,CAAC,EAAE,YAAY,CAAC;CAC1B;AA6CD,wBAAgB,sBAAsB,CACrC,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,aAAa,GACrB,cAAc,CAAC,OAAO,QAAQ,EAAE,aAAa,GAAG,SAAS,CAAC,CA2H5D;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC,OAAO,QAAQ,CAAC,CAE7F","sourcesContent":["import { readdir as fsReaddir, stat as fsStat } from \"node:fs/promises\";\nimport type { AgentTool } from \"@hansjm10/volt-agent-core\";\nimport { Text } from \"@hansjm10/volt-tui\";\nimport nodePath from \"path\";\nimport { type Static, Type } from \"typebox\";\nimport { keyHint } from \"../../modes/interactive/components/keybinding-hints.ts\";\nimport type { ToolDefinition, ToolRenderResultOptions } from \"../extensions/types.ts\";\nimport type { Theme } from \"../theme/runtime.ts\";\nimport { pathExists, resolveToCwd } from \"./path-utils.ts\";\nimport { getTextOutput, renderToolPath, str } from \"./render-utils.ts\";\nimport { wrapToolDefinition } from \"./tool-definition-wrapper.ts\";\nimport { DEFAULT_MAX_BYTES, formatSize, type TruncationResult, truncateHead } from \"./truncate.ts\";\n\nconst lsSchema = Type.Object({\n\tpath: Type.Optional(Type.String({ description: \"Directory to list (default: current directory)\" })),\n\tlimit: Type.Optional(Type.Number({ description: \"Maximum number of entries to return (default: 500)\" })),\n});\n\nexport type LsToolInput = Static<typeof lsSchema>;\n\nconst DEFAULT_LIMIT = 500;\n\nexport interface LsToolDetails {\n\ttruncation?: TruncationResult;\n\tentryLimitReached?: number;\n}\n\n/**\n * Pluggable operations for the ls tool.\n * Override these to delegate directory listing to remote systems (for example SSH).\n */\nexport interface LsOperations {\n\t/** Check if path exists */\n\texists: (absolutePath: string) => Promise<boolean> | boolean;\n\t/** Get file or directory stats. Throws if not found. */\n\tstat: (absolutePath: string) => Promise<{ isDirectory: () => boolean }> | { isDirectory: () => boolean };\n\t/** Read directory entries */\n\treaddir: (absolutePath: string) => Promise<string[]> | string[];\n}\n\nconst defaultLsOperations: LsOperations = {\n\texists: pathExists,\n\tstat: fsStat,\n\treaddir: fsReaddir,\n};\n\nexport interface LsToolOptions {\n\t/** Custom operations for directory listing. Default: local filesystem */\n\toperations?: LsOperations;\n}\n\nfunction formatLsCall(args: { path?: string; limit?: number } | undefined, theme: Theme, cwd: string): string {\n\tconst limit = args?.limit;\n\tconst pathDisplay = renderToolPath(str(args?.path), theme, cwd, { emptyFallback: \".\" });\n\tlet text = `${theme.fg(\"toolTitle\", theme.bold(\"ls\"))} ${pathDisplay}`;\n\tif (limit !== undefined) {\n\t\ttext += theme.fg(\"toolOutput\", ` (limit ${limit})`);\n\t}\n\treturn text;\n}\n\nfunction formatLsResult(\n\tresult: {\n\t\tcontent: Array<{ type: string; text?: string; data?: string; mimeType?: string }>;\n\t\tdetails?: LsToolDetails;\n\t},\n\toptions: ToolRenderResultOptions,\n\ttheme: Theme,\n\tshowImages: boolean,\n): string {\n\tconst output = getTextOutput(result, showImages).trim();\n\tlet text = \"\";\n\tif (output) {\n\t\tconst lines = output.split(\"\\n\");\n\t\tconst maxLines = options.expanded ? lines.length : 20;\n\t\tconst displayLines = lines.slice(0, maxLines);\n\t\tconst remaining = lines.length - maxLines;\n\t\ttext += `\\n${displayLines.map((line) => theme.fg(\"toolOutput\", line)).join(\"\\n\")}`;\n\t\tif (remaining > 0) {\n\t\t\ttext += `${theme.fg(\"muted\", `\\n... (${remaining} more lines,`)} ${keyHint(\"app.tools.expand\", \"to expand\")}${theme.fg(\"muted\", \")\")}`;\n\t\t}\n\t}\n\n\tconst entryLimit = result.details?.entryLimitReached;\n\tconst truncation = result.details?.truncation;\n\tif (entryLimit || truncation?.truncated) {\n\t\tconst warnings: string[] = [];\n\t\tif (entryLimit) warnings.push(`${entryLimit} entries limit`);\n\t\tif (truncation?.truncated) warnings.push(`${formatSize(truncation.maxBytes ?? DEFAULT_MAX_BYTES)} limit`);\n\t\ttext += `\\n${theme.fg(\"warning\", `[Truncated: ${warnings.join(\", \")}]`)}`;\n\t}\n\treturn text;\n}\n\nexport function createLsToolDefinition(\n\tcwd: string,\n\toptions?: LsToolOptions,\n): ToolDefinition<typeof lsSchema, LsToolDetails | undefined> {\n\tconst ops = options?.operations ?? defaultLsOperations;\n\treturn {\n\t\tname: \"ls\",\n\t\tlabel: \"ls\",\n\t\tdescription: `List directory contents. Returns entries sorted alphabetically, with '/' suffix for directories. Includes dotfiles. Output is truncated to ${DEFAULT_LIMIT} entries or ${DEFAULT_MAX_BYTES / 1024}KB (whichever is hit first).`,\n\t\tpromptSnippet: \"List directory contents\",\n\t\tparameters: lsSchema,\n\t\tasync execute(\n\t\t\t_toolCallId,\n\t\t\t{ path, limit }: { path?: string; limit?: number },\n\t\t\tsignal?: AbortSignal,\n\t\t\t_onUpdate?,\n\t\t\t_ctx?,\n\t\t) {\n\t\t\treturn new Promise((resolve, reject) => {\n\t\t\t\tif (signal?.aborted) {\n\t\t\t\t\treject(new Error(\"Operation aborted\"));\n\t\t\t\t\treturn;\n\t\t\t\t}\n\n\t\t\t\tconst onAbort = () => reject(new Error(\"Operation aborted\"));\n\t\t\t\tsignal?.addEventListener(\"abort\", onAbort, { once: true });\n\n\t\t\t\t(async () => {\n\t\t\t\t\ttry {\n\t\t\t\t\t\tconst dirPath = resolveToCwd(path || \".\", cwd);\n\t\t\t\t\t\tconst effectiveLimit = limit ?? DEFAULT_LIMIT;\n\n\t\t\t\t\t\t// Check if path exists.\n\t\t\t\t\t\tif (!(await ops.exists(dirPath))) {\n\t\t\t\t\t\t\treject(new Error(`Path not found: ${dirPath}`));\n\t\t\t\t\t\t\treturn;\n\t\t\t\t\t\t}\n\n\t\t\t\t\t\t// Check if path is a directory.\n\t\t\t\t\t\tconst stat = await ops.stat(dirPath);\n\t\t\t\t\t\tif (!stat.isDirectory()) {\n\t\t\t\t\t\t\treject(new Error(`Not a directory: ${dirPath}`));\n\t\t\t\t\t\t\treturn;\n\t\t\t\t\t\t}\n\n\t\t\t\t\t\t// Read directory entries.\n\t\t\t\t\t\tlet entries: string[];\n\t\t\t\t\t\ttry {\n\t\t\t\t\t\t\tentries = await ops.readdir(dirPath);\n\t\t\t\t\t\t} catch (e: any) {\n\t\t\t\t\t\t\treject(new Error(`Cannot read directory: ${e.message}`));\n\t\t\t\t\t\t\treturn;\n\t\t\t\t\t\t}\n\n\t\t\t\t\t\t// Sort alphabetically, case-insensitive.\n\t\t\t\t\t\tentries.sort((a, b) => a.toLowerCase().localeCompare(b.toLowerCase()));\n\n\t\t\t\t\t\t// Format entries with directory indicators.\n\t\t\t\t\t\tconst results: string[] = [];\n\t\t\t\t\t\tlet entryLimitReached = false;\n\t\t\t\t\t\tfor (const entry of entries) {\n\t\t\t\t\t\t\tif (results.length >= effectiveLimit) {\n\t\t\t\t\t\t\t\tentryLimitReached = true;\n\t\t\t\t\t\t\t\tbreak;\n\t\t\t\t\t\t\t}\n\n\t\t\t\t\t\t\tconst fullPath = nodePath.join(dirPath, entry);\n\t\t\t\t\t\t\tlet suffix = \"\";\n\t\t\t\t\t\t\ttry {\n\t\t\t\t\t\t\t\tconst entryStat = await ops.stat(fullPath);\n\t\t\t\t\t\t\t\tif (entryStat.isDirectory()) suffix = \"/\";\n\t\t\t\t\t\t\t} catch {\n\t\t\t\t\t\t\t\t// Skip entries we cannot stat.\n\t\t\t\t\t\t\t\tcontinue;\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\tresults.push(entry + suffix);\n\t\t\t\t\t\t}\n\n\t\t\t\t\t\tsignal?.removeEventListener(\"abort\", onAbort);\n\n\t\t\t\t\t\tif (results.length === 0) {\n\t\t\t\t\t\t\tresolve({ content: [{ type: \"text\", text: \"(empty directory)\" }], details: undefined });\n\t\t\t\t\t\t\treturn;\n\t\t\t\t\t\t}\n\n\t\t\t\t\t\tconst rawOutput = results.join(\"\\n\");\n\t\t\t\t\t\t// Apply byte truncation. There is no separate line limit because entry count is already capped.\n\t\t\t\t\t\tconst truncation = truncateHead(rawOutput, { maxLines: Number.MAX_SAFE_INTEGER });\n\t\t\t\t\t\tlet output = truncation.content;\n\t\t\t\t\t\tconst details: LsToolDetails = {};\n\t\t\t\t\t\t// Build actionable notices for truncation and entry limits.\n\t\t\t\t\t\tconst notices: string[] = [];\n\t\t\t\t\t\tif (entryLimitReached) {\n\t\t\t\t\t\t\tnotices.push(`${effectiveLimit} entries limit reached. Use limit=${effectiveLimit * 2} for more`);\n\t\t\t\t\t\t\tdetails.entryLimitReached = effectiveLimit;\n\t\t\t\t\t\t}\n\t\t\t\t\t\tif (truncation.truncated) {\n\t\t\t\t\t\t\tnotices.push(`${formatSize(DEFAULT_MAX_BYTES)} limit reached`);\n\t\t\t\t\t\t\tdetails.truncation = truncation;\n\t\t\t\t\t\t}\n\t\t\t\t\t\tif (notices.length > 0) {\n\t\t\t\t\t\t\toutput += `\\n\\n[${notices.join(\". \")}]`;\n\t\t\t\t\t\t}\n\n\t\t\t\t\t\tresolve({\n\t\t\t\t\t\t\tcontent: [{ type: \"text\", text: output }],\n\t\t\t\t\t\t\tdetails: Object.keys(details).length > 0 ? details : undefined,\n\t\t\t\t\t\t});\n\t\t\t\t\t} catch (e: any) {\n\t\t\t\t\t\tsignal?.removeEventListener(\"abort\", onAbort);\n\t\t\t\t\t\treject(e);\n\t\t\t\t\t}\n\t\t\t\t})();\n\t\t\t});\n\t\t},\n\t\trenderCall(args, theme, context) {\n\t\t\tconst text = (context.lastComponent as Text | undefined) ?? new Text(\"\", 0, 0);\n\t\t\ttext.setText(formatLsCall(args, theme, context.cwd));\n\t\t\treturn text;\n\t\t},\n\t\trenderResult(result, options, theme, context) {\n\t\t\tconst text = (context.lastComponent as Text | undefined) ?? new Text(\"\", 0, 0);\n\t\t\ttext.setText(formatLsResult(result as any, options, theme, context.showImages));\n\t\t\treturn text;\n\t\t},\n\t};\n}\n\nexport function createLsTool(cwd: string, options?: LsToolOptions): AgentTool<typeof lsSchema> {\n\treturn wrapToolDefinition(createLsToolDefinition(cwd, options));\n}\n"]}

package/dist/core/tools/ls.js

@@ -0,0 +1,167 @@
+import { readdir as fsReaddir, stat as fsStat } from "node:fs/promises";
+import { Text } from "@hansjm10/volt-tui";
+import nodePath from "path";
+import { Type } from "typebox";
+import { keyHint } from "../../modes/interactive/components/keybinding-hints.js";
+import { pathExists, resolveToCwd } from "./path-utils.js";
+import { getTextOutput, renderToolPath, str } from "./render-utils.js";
+import { wrapToolDefinition } from "./tool-definition-wrapper.js";
+import { DEFAULT_MAX_BYTES, formatSize, truncateHead } from "./truncate.js";
+const lsSchema = Type.Object({
+    path: Type.Optional(Type.String({ description: "Directory to list (default: current directory)" })),
+    limit: Type.Optional(Type.Number({ description: "Maximum number of entries to return (default: 500)" })),
+});
+const DEFAULT_LIMIT = 500;
+const defaultLsOperations = {
+    exists: pathExists,
+    stat: fsStat,
+    readdir: fsReaddir,
+};
+function formatLsCall(args, theme, cwd) {
+    const limit = args?.limit;
+    const pathDisplay = renderToolPath(str(args?.path), theme, cwd, { emptyFallback: "." });
+    let text = `${theme.fg("toolTitle", theme.bold("ls"))} ${pathDisplay}`;
+    if (limit !== undefined) {
+        text += theme.fg("toolOutput", ` (limit ${limit})`);
+    }
+    return text;
+}
+function formatLsResult(result, options, theme, showImages) {
+    const output = getTextOutput(result, showImages).trim();
+    let text = "";
+    if (output) {
+        const lines = output.split("\n");
+        const maxLines = options.expanded ? lines.length : 20;
+        const displayLines = lines.slice(0, maxLines);
+        const remaining = lines.length - maxLines;
+        text += `\n${displayLines.map((line) => theme.fg("toolOutput", line)).join("\n")}`;
+        if (remaining > 0) {
+            text += `${theme.fg("muted", `\n... (${remaining} more lines,`)} ${keyHint("app.tools.expand", "to expand")}${theme.fg("muted", ")")}`;
+        }
+    }
+    const entryLimit = result.details?.entryLimitReached;
+    const truncation = result.details?.truncation;
+    if (entryLimit || truncation?.truncated) {
+        const warnings = [];
+        if (entryLimit)
+            warnings.push(`${entryLimit} entries limit`);
+        if (truncation?.truncated)
+            warnings.push(`${formatSize(truncation.maxBytes ?? DEFAULT_MAX_BYTES)} limit`);
+        text += `\n${theme.fg("warning", `[Truncated: ${warnings.join(", ")}]`)}`;
+    }
+    return text;
+}
+export function createLsToolDefinition(cwd, options) {
+    const ops = options?.operations ?? defaultLsOperations;
+    return {
+        name: "ls",
+        label: "ls",
+        description: `List directory contents. Returns entries sorted alphabetically, with '/' suffix for directories. Includes dotfiles. Output is truncated to ${DEFAULT_LIMIT} entries or ${DEFAULT_MAX_BYTES / 1024}KB (whichever is hit first).`,
+        promptSnippet: "List directory contents",
+        parameters: lsSchema,
+        async execute(_toolCallId, { path, limit }, signal, _onUpdate, _ctx) {
+            return new Promise((resolve, reject) => {
+                if (signal?.aborted) {
+                    reject(new Error("Operation aborted"));
+                    return;
+                }
+                const onAbort = () => reject(new Error("Operation aborted"));
+                signal?.addEventListener("abort", onAbort, { once: true });
+                (async () => {
+                    try {
+                        const dirPath = resolveToCwd(path || ".", cwd);
+                        const effectiveLimit = limit ?? DEFAULT_LIMIT;
+                        // Check if path exists.
+                        if (!(await ops.exists(dirPath))) {
+                            reject(new Error(`Path not found: ${dirPath}`));
+                            return;
+                        }
+                        // Check if path is a directory.
+                        const stat = await ops.stat(dirPath);
+                        if (!stat.isDirectory()) {
+                            reject(new Error(`Not a directory: ${dirPath}`));
+                            return;
+                        }
+                        // Read directory entries.
+                        let entries;
+                        try {
+                            entries = await ops.readdir(dirPath);
+                        }
+                        catch (e) {
+                            reject(new Error(`Cannot read directory: ${e.message}`));
+                            return;
+                        }
+                        // Sort alphabetically, case-insensitive.
+                        entries.sort((a, b) => a.toLowerCase().localeCompare(b.toLowerCase()));
+                        // Format entries with directory indicators.
+                        const results = [];
+                        let entryLimitReached = false;
+                        for (const entry of entries) {
+                            if (results.length >= effectiveLimit) {
+                                entryLimitReached = true;
+                                break;
+                            }
+                            const fullPath = nodePath.join(dirPath, entry);
+                            let suffix = "";
+                            try {
+                                const entryStat = await ops.stat(fullPath);
+                                if (entryStat.isDirectory())
+                                    suffix = "/";
+                            }
+                            catch {
+                                // Skip entries we cannot stat.
+                                continue;
+                            }
+                            results.push(entry + suffix);
+                        }
+                        signal?.removeEventListener("abort", onAbort);
+                        if (results.length === 0) {
+                            resolve({ content: [{ type: "text", text: "(empty directory)" }], details: undefined });
+                            return;
+                        }
+                        const rawOutput = results.join("\n");
+                        // Apply byte truncation. There is no separate line limit because entry count is already capped.
+                        const truncation = truncateHead(rawOutput, { maxLines: Number.MAX_SAFE_INTEGER });
+                        let output = truncation.content;
+                        const details = {};
+                        // Build actionable notices for truncation and entry limits.
+                        const notices = [];
+                        if (entryLimitReached) {
+                            notices.push(`${effectiveLimit} entries limit reached. Use limit=${effectiveLimit * 2} for more`);
+                            details.entryLimitReached = effectiveLimit;
+                        }
+                        if (truncation.truncated) {
+                            notices.push(`${formatSize(DEFAULT_MAX_BYTES)} limit reached`);
+                            details.truncation = truncation;
+                        }
+                        if (notices.length > 0) {
+                            output += `\n\n[${notices.join(". ")}]`;
+                        }
+                        resolve({
+                            content: [{ type: "text", text: output }],
+                            details: Object.keys(details).length > 0 ? details : undefined,
+                        });
+                    }
+                    catch (e) {
+                        signal?.removeEventListener("abort", onAbort);
+                        reject(e);
+                    }
+                })();
+            });
+        },
+        renderCall(args, theme, context) {
+            const text = context.lastComponent ?? new Text("", 0, 0);
+            text.setText(formatLsCall(args, theme, context.cwd));
+            return text;
+        },
+        renderResult(result, options, theme, context) {
+            const text = context.lastComponent ?? new Text("", 0, 0);
+            text.setText(formatLsResult(result, options, theme, context.showImages));
+            return text;
+        },
+    };
+}
+export function createLsTool(cwd, options) {
+    return wrapToolDefinition(createLsToolDefinition(cwd, options));
+}
+//# sourceMappingURL=ls.js.map

package/dist/core/tools/ls.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ls.js","sourceRoot":"","sources":["../../../src/core/tools/ls.ts"],"names":[],"mappings":"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","sourcesContent":["import { readdir as fsReaddir, stat as fsStat } from \"node:fs/promises\";\nimport type { AgentTool } from \"@hansjm10/volt-agent-core\";\nimport { Text } from \"@hansjm10/volt-tui\";\nimport nodePath from \"path\";\nimport { type Static, Type } from \"typebox\";\nimport { keyHint } from \"../../modes/interactive/components/keybinding-hints.ts\";\nimport type { ToolDefinition, ToolRenderResultOptions } from \"../extensions/types.ts\";\nimport type { Theme } from \"../theme/runtime.ts\";\nimport { pathExists, resolveToCwd } from \"./path-utils.ts\";\nimport { getTextOutput, renderToolPath, str } from \"./render-utils.ts\";\nimport { wrapToolDefinition } from \"./tool-definition-wrapper.ts\";\nimport { DEFAULT_MAX_BYTES, formatSize, type TruncationResult, truncateHead } from \"./truncate.ts\";\n\nconst lsSchema = Type.Object({\n\tpath: Type.Optional(Type.String({ description: \"Directory to list (default: current directory)\" })),\n\tlimit: Type.Optional(Type.Number({ description: \"Maximum number of entries to return (default: 500)\" })),\n});\n\nexport type LsToolInput = Static<typeof lsSchema>;\n\nconst DEFAULT_LIMIT = 500;\n\nexport interface LsToolDetails {\n\ttruncation?: TruncationResult;\n\tentryLimitReached?: number;\n}\n\n/**\n * Pluggable operations for the ls tool.\n * Override these to delegate directory listing to remote systems (for example SSH).\n */\nexport interface LsOperations {\n\t/** Check if path exists */\n\texists: (absolutePath: string) => Promise<boolean> | boolean;\n\t/** Get file or directory stats. Throws if not found. */\n\tstat: (absolutePath: string) => Promise<{ isDirectory: () => boolean }> | { isDirectory: () => boolean };\n\t/** Read directory entries */\n\treaddir: (absolutePath: string) => Promise<string[]> | string[];\n}\n\nconst defaultLsOperations: LsOperations = {\n\texists: pathExists,\n\tstat: fsStat,\n\treaddir: fsReaddir,\n};\n\nexport interface LsToolOptions {\n\t/** Custom operations for directory listing. Default: local filesystem */\n\toperations?: LsOperations;\n}\n\nfunction formatLsCall(args: { path?: string; limit?: number } | undefined, theme: Theme, cwd: string): string {\n\tconst limit = args?.limit;\n\tconst pathDisplay = renderToolPath(str(args?.path), theme, cwd, { emptyFallback: \".\" });\n\tlet text = `${theme.fg(\"toolTitle\", theme.bold(\"ls\"))} ${pathDisplay}`;\n\tif (limit !== undefined) {\n\t\ttext += theme.fg(\"toolOutput\", ` (limit ${limit})`);\n\t}\n\treturn text;\n}\n\nfunction formatLsResult(\n\tresult: {\n\t\tcontent: Array<{ type: string; text?: string; data?: string; mimeType?: string }>;\n\t\tdetails?: LsToolDetails;\n\t},\n\toptions: ToolRenderResultOptions,\n\ttheme: Theme,\n\tshowImages: boolean,\n): string {\n\tconst output = getTextOutput(result, showImages).trim();\n\tlet text = \"\";\n\tif (output) {\n\t\tconst lines = output.split(\"\\n\");\n\t\tconst maxLines = options.expanded ? lines.length : 20;\n\t\tconst displayLines = lines.slice(0, maxLines);\n\t\tconst remaining = lines.length - maxLines;\n\t\ttext += `\\n${displayLines.map((line) => theme.fg(\"toolOutput\", line)).join(\"\\n\")}`;\n\t\tif (remaining > 0) {\n\t\t\ttext += `${theme.fg(\"muted\", `\\n... (${remaining} more lines,`)} ${keyHint(\"app.tools.expand\", \"to expand\")}${theme.fg(\"muted\", \")\")}`;\n\t\t}\n\t}\n\n\tconst entryLimit = result.details?.entryLimitReached;\n\tconst truncation = result.details?.truncation;\n\tif (entryLimit || truncation?.truncated) {\n\t\tconst warnings: string[] = [];\n\t\tif (entryLimit) warnings.push(`${entryLimit} entries limit`);\n\t\tif (truncation?.truncated) warnings.push(`${formatSize(truncation.maxBytes ?? DEFAULT_MAX_BYTES)} limit`);\n\t\ttext += `\\n${theme.fg(\"warning\", `[Truncated: ${warnings.join(\", \")}]`)}`;\n\t}\n\treturn text;\n}\n\nexport function createLsToolDefinition(\n\tcwd: string,\n\toptions?: LsToolOptions,\n): ToolDefinition<typeof lsSchema, LsToolDetails | undefined> {\n\tconst ops = options?.operations ?? defaultLsOperations;\n\treturn {\n\t\tname: \"ls\",\n\t\tlabel: \"ls\",\n\t\tdescription: `List directory contents. Returns entries sorted alphabetically, with '/' suffix for directories. Includes dotfiles. Output is truncated to ${DEFAULT_LIMIT} entries or ${DEFAULT_MAX_BYTES / 1024}KB (whichever is hit first).`,\n\t\tpromptSnippet: \"List directory contents\",\n\t\tparameters: lsSchema,\n\t\tasync execute(\n\t\t\t_toolCallId,\n\t\t\t{ path, limit }: { path?: string; limit?: number },\n\t\t\tsignal?: AbortSignal,\n\t\t\t_onUpdate?,\n\t\t\t_ctx?,\n\t\t) {\n\t\t\treturn new Promise((resolve, reject) => {\n\t\t\t\tif (signal?.aborted) {\n\t\t\t\t\treject(new Error(\"Operation aborted\"));\n\t\t\t\t\treturn;\n\t\t\t\t}\n\n\t\t\t\tconst onAbort = () => reject(new Error(\"Operation aborted\"));\n\t\t\t\tsignal?.addEventListener(\"abort\", onAbort, { once: true });\n\n\t\t\t\t(async () => {\n\t\t\t\t\ttry {\n\t\t\t\t\t\tconst dirPath = resolveToCwd(path || \".\", cwd);\n\t\t\t\t\t\tconst effectiveLimit = limit ?? DEFAULT_LIMIT;\n\n\t\t\t\t\t\t// Check if path exists.\n\t\t\t\t\t\tif (!(await ops.exists(dirPath))) {\n\t\t\t\t\t\t\treject(new Error(`Path not found: ${dirPath}`));\n\t\t\t\t\t\t\treturn;\n\t\t\t\t\t\t}\n\n\t\t\t\t\t\t// Check if path is a directory.\n\t\t\t\t\t\tconst stat = await ops.stat(dirPath);\n\t\t\t\t\t\tif (!stat.isDirectory()) {\n\t\t\t\t\t\t\treject(new Error(`Not a directory: ${dirPath}`));\n\t\t\t\t\t\t\treturn;\n\t\t\t\t\t\t}\n\n\t\t\t\t\t\t// Read directory entries.\n\t\t\t\t\t\tlet entries: string[];\n\t\t\t\t\t\ttry {\n\t\t\t\t\t\t\tentries = await ops.readdir(dirPath);\n\t\t\t\t\t\t} catch (e: any) {\n\t\t\t\t\t\t\treject(new Error(`Cannot read directory: ${e.message}`));\n\t\t\t\t\t\t\treturn;\n\t\t\t\t\t\t}\n\n\t\t\t\t\t\t// Sort alphabetically, case-insensitive.\n\t\t\t\t\t\tentries.sort((a, b) => a.toLowerCase().localeCompare(b.toLowerCase()));\n\n\t\t\t\t\t\t// Format entries with directory indicators.\n\t\t\t\t\t\tconst results: string[] = [];\n\t\t\t\t\t\tlet entryLimitReached = false;\n\t\t\t\t\t\tfor (const entry of entries) {\n\t\t\t\t\t\t\tif (results.length >= effectiveLimit) {\n\t\t\t\t\t\t\t\tentryLimitReached = true;\n\t\t\t\t\t\t\t\tbreak;\n\t\t\t\t\t\t\t}\n\n\t\t\t\t\t\t\tconst fullPath = nodePath.join(dirPath, entry);\n\t\t\t\t\t\t\tlet suffix = \"\";\n\t\t\t\t\t\t\ttry {\n\t\t\t\t\t\t\t\tconst entryStat = await ops.stat(fullPath);\n\t\t\t\t\t\t\t\tif (entryStat.isDirectory()) suffix = \"/\";\n\t\t\t\t\t\t\t} catch {\n\t\t\t\t\t\t\t\t// Skip entries we cannot stat.\n\t\t\t\t\t\t\t\tcontinue;\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\tresults.push(entry + suffix);\n\t\t\t\t\t\t}\n\n\t\t\t\t\t\tsignal?.removeEventListener(\"abort\", onAbort);\n\n\t\t\t\t\t\tif (results.length === 0) {\n\t\t\t\t\t\t\tresolve({ content: [{ type: \"text\", text: \"(empty directory)\" }], details: undefined });\n\t\t\t\t\t\t\treturn;\n\t\t\t\t\t\t}\n\n\t\t\t\t\t\tconst rawOutput = results.join(\"\\n\");\n\t\t\t\t\t\t// Apply byte truncation. There is no separate line limit because entry count is already capped.\n\t\t\t\t\t\tconst truncation = truncateHead(rawOutput, { maxLines: Number.MAX_SAFE_INTEGER });\n\t\t\t\t\t\tlet output = truncation.content;\n\t\t\t\t\t\tconst details: LsToolDetails = {};\n\t\t\t\t\t\t// Build actionable notices for truncation and entry limits.\n\t\t\t\t\t\tconst notices: string[] = [];\n\t\t\t\t\t\tif (entryLimitReached) {\n\t\t\t\t\t\t\tnotices.push(`${effectiveLimit} entries limit reached. Use limit=${effectiveLimit * 2} for more`);\n\t\t\t\t\t\t\tdetails.entryLimitReached = effectiveLimit;\n\t\t\t\t\t\t}\n\t\t\t\t\t\tif (truncation.truncated) {\n\t\t\t\t\t\t\tnotices.push(`${formatSize(DEFAULT_MAX_BYTES)} limit reached`);\n\t\t\t\t\t\t\tdetails.truncation = truncation;\n\t\t\t\t\t\t}\n\t\t\t\t\t\tif (notices.length > 0) {\n\t\t\t\t\t\t\toutput += `\\n\\n[${notices.join(\". \")}]`;\n\t\t\t\t\t\t}\n\n\t\t\t\t\t\tresolve({\n\t\t\t\t\t\t\tcontent: [{ type: \"text\", text: output }],\n\t\t\t\t\t\t\tdetails: Object.keys(details).length > 0 ? details : undefined,\n\t\t\t\t\t\t});\n\t\t\t\t\t} catch (e: any) {\n\t\t\t\t\t\tsignal?.removeEventListener(\"abort\", onAbort);\n\t\t\t\t\t\treject(e);\n\t\t\t\t\t}\n\t\t\t\t})();\n\t\t\t});\n\t\t},\n\t\trenderCall(args, theme, context) {\n\t\t\tconst text = (context.lastComponent as Text | undefined) ?? new Text(\"\", 0, 0);\n\t\t\ttext.setText(formatLsCall(args, theme, context.cwd));\n\t\t\treturn text;\n\t\t},\n\t\trenderResult(result, options, theme, context) {\n\t\t\tconst text = (context.lastComponent as Text | undefined) ?? new Text(\"\", 0, 0);\n\t\t\ttext.setText(formatLsResult(result as any, options, theme, context.showImages));\n\t\t\treturn text;\n\t\t},\n\t};\n}\n\nexport function createLsTool(cwd: string, options?: LsToolOptions): AgentTool<typeof lsSchema> {\n\treturn wrapToolDefinition(createLsToolDefinition(cwd, options));\n}\n"]}

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

@@ -0,0 +1,59 @@
+/**
+ * LSP navigation tool: definition, references, hover, symbols, and on-demand
+ * diagnostics through the language servers configured in the lsp settings.
+ *
+ * The tool is registered as a built-in but only does useful work when an
+ * LspNavigationProvider (the LspManager) is supplied, i.e. when LSP is not
+ * disabled in settings.
+ */
+import type { AgentTool } from "@hansjm10/volt-agent-core";
+import { type Static, Type } from "typebox";
+import type { ToolDefinition } from "../extensions/types.ts";
+export declare const LSP_ACTIONS: readonly ["definition", "references", "implementations", "type-definition", "callers", "callees", "hover", "symbols", "diagnostics", "rename", "fix"];
+export type LspAction = (typeof LSP_ACTIONS)[number];
+/**
+ * Navigation interface implemented by the LspManager.
+ *
+ * All methods return formatted, human-readable text. Failures (no server, no
+ * symbol found, server errors) are reported as text rather than thrown so the
+ * model can react to them.
+ */
+export interface LspNavigationProvider {
+    definition(absolutePath: string, symbol: string, line?: number, signal?: AbortSignal): Promise<string>;
+    references(absolutePath: string, symbol: string, line?: number, signal?: AbortSignal): Promise<string>;
+    implementations(absolutePath: string, symbol: string, line?: number, signal?: AbortSignal): Promise<string>;
+    typeDefinition(absolutePath: string, symbol: string, line?: number, signal?: AbortSignal): Promise<string>;
+    hover(absolutePath: string, symbol: string, line?: number, signal?: AbortSignal): Promise<string>;
+    documentSymbols(absolutePath: string, signal?: AbortSignal): Promise<string>;
+    workspaceSymbols(absolutePath: string, query: string, signal?: AbortSignal): Promise<string>;
+    callHierarchy(absolutePath: string, symbol: string, direction: "incoming" | "outgoing", line?: number, signal?: AbortSignal): Promise<string>;
+    fileDiagnostics(absolutePath: string, signal?: AbortSignal): Promise<string>;
+    rename(absolutePath: string, symbol: string, newName: string, line?: number, signal?: AbortSignal): Promise<string>;
+    codeFix(absolutePath: string, options: {
+        symbol?: string;
+        line?: number;
+        title?: string;
+        kind?: string;
+    }, signal?: AbortSignal): Promise<string>;
+}
+declare const lspSchema: Type.TObject<{
+    action: Type.TUnsafe<"callees" | "callers" | "definition" | "diagnostics" | "fix" | "hover" | "implementations" | "references" | "rename" | "symbols" | "type-definition">;
+    path: Type.TString;
+    symbol: Type.TOptional<Type.TString>;
+    line: Type.TOptional<Type.TNumber>;
+    newName: Type.TOptional<Type.TString>;
+    title: Type.TOptional<Type.TString>;
+    kind: Type.TOptional<Type.TString>;
+}>;
+export type LspToolInput = Static<typeof lspSchema>;
+export interface LspToolDetails {
+    action: LspAction;
+}
+export interface LspToolOptions {
+    /** Navigation provider (the LspManager). When absent, the tool reports that LSP is disabled. */
+    provider?: LspNavigationProvider;
+}
+export declare function createLspToolDefinition(cwd: string, options?: LspToolOptions): ToolDefinition<typeof lspSchema, LspToolDetails | undefined>;
+export declare function createLspTool(cwd: string, options?: LspToolOptions): AgentTool<typeof lspSchema>;
+export {};
+//# sourceMappingURL=lsp.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lsp.d.ts","sourceRoot":"","sources":["../../../src/core/tools/lsp.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * LSP navigation tool: definition, references, hover, symbols, and on-demand\n * diagnostics through the language servers configured in the lsp settings.\n *\n * The tool is registered as a built-in but only does useful work when an\n * LspNavigationProvider (the LspManager) is supplied, i.e. when LSP is not\n * disabled in settings.\n */\n\nimport type { AgentTool } from \"@hansjm10/volt-agent-core\";\nimport { StringEnum } from \"@hansjm10/volt-ai\";\nimport { Text } from \"@hansjm10/volt-tui\";\nimport { type Static, Type } from \"typebox\";\nimport type { ToolDefinition } from \"../extensions/types.ts\";\nimport type { Theme } from \"../theme/runtime.ts\";\nimport { resolveToCwd } from \"./path-utils.ts\";\nimport { renderToolPath, str } from \"./render-utils.ts\";\nimport { wrapToolDefinition } from \"./tool-definition-wrapper.ts\";\n\nexport const LSP_ACTIONS = [\n\t\"definition\",\n\t\"references\",\n\t\"implementations\",\n\t\"type-definition\",\n\t\"callers\",\n\t\"callees\",\n\t\"hover\",\n\t\"symbols\",\n\t\"diagnostics\",\n\t\"rename\",\n\t\"fix\",\n] as const;\nexport type LspAction = (typeof LSP_ACTIONS)[number];\n\n/**\n * Navigation interface implemented by the LspManager.\n *\n * All methods return formatted, human-readable text. Failures (no server, no\n * symbol found, server errors) are reported as text rather than thrown so the\n * model can react to them.\n */\nexport interface LspNavigationProvider {\n\tdefinition(absolutePath: string, symbol: string, line?: number, signal?: AbortSignal): Promise<string>;\n\treferences(absolutePath: string, symbol: string, line?: number, signal?: AbortSignal): Promise<string>;\n\timplementations(absolutePath: string, symbol: string, line?: number, signal?: AbortSignal): Promise<string>;\n\ttypeDefinition(absolutePath: string, symbol: string, line?: number, signal?: AbortSignal): Promise<string>;\n\thover(absolutePath: string, symbol: string, line?: number, signal?: AbortSignal): Promise<string>;\n\tdocumentSymbols(absolutePath: string, signal?: AbortSignal): Promise<string>;\n\tworkspaceSymbols(absolutePath: string, query: string, signal?: AbortSignal): Promise<string>;\n\tcallHierarchy(\n\t\tabsolutePath: string,\n\t\tsymbol: string,\n\t\tdirection: \"incoming\" | \"outgoing\",\n\t\tline?: number,\n\t\tsignal?: AbortSignal,\n\t): Promise<string>;\n\tfileDiagnostics(absolutePath: string, signal?: AbortSignal): Promise<string>;\n\trename(absolutePath: string, symbol: string, newName: string, line?: number, signal?: AbortSignal): Promise<string>;\n\tcodeFix(\n\t\tabsolutePath: string,\n\t\toptions: { symbol?: string; line?: number; title?: string; kind?: string },\n\t\tsignal?: AbortSignal,\n\t): Promise<string>;\n}\n\nconst lspSchema = Type.Object({\n\taction: StringEnum(LSP_ACTIONS, {\n\t\tdescription:\n\t\t\t\"definition: where a symbol is defined. references: all usages of a symbol. implementations: implementations of an interface/abstract symbol. type-definition: where a symbol's type is defined. callers: functions that call a symbol. callees: functions a symbol calls. hover: type/docs for a symbol. symbols: outline of a file, or project-wide symbol search when symbol is provided. diagnostics: current errors in a file. rename: rename a symbol across the project. fix: apply a quick fix (e.g. add a missing import) or a kind like source.organizeImports.\",\n\t}),\n\tpath: Type.String({ description: \"Path to the file to query (relative or absolute)\" }),\n\tsymbol: Type.Optional(\n\t\tType.String({\n\t\t\tdescription:\n\t\t\t\t\"Symbol name to look up. Required for definition, references, callers, callees, hover, and rename; recommended for fix. For symbols, turns the file outline into a project-wide symbol search using this as the query.\",\n\t\t}),\n\t),\n\tline: Type.Optional(\n\t\tType.Number({\n\t\t\tdescription:\n\t\t\t\t\"1-based line number where the symbol occurrence is located. Recommended when the symbol appears multiple times in the file. For fix without a symbol, selects the line to fix.\",\n\t\t}),\n\t),\n\tnewName: Type.Optional(\n\t\tType.String({\n\t\t\tdescription: \"New symbol name. Required for rename.\",\n\t\t}),\n\t),\n\ttitle: Type.Optional(\n\t\tType.String({\n\t\t\tdescription: \"Code action title to apply when fix reports multiple available actions.\",\n\t\t}),\n\t),\n\tkind: Type.Optional(\n\t\tType.String({\n\t\t\tdescription:\n\t\t\t\t'Code action kind filter for fix, e.g. \"source.organizeImports\" to organize imports or \"source.fixAll\" to apply all safe fixes (requested over the whole file when no symbol/line is given).',\n\t\t}),\n\t),\n});\n\nexport type LspToolInput = Static<typeof lspSchema>;\n\nexport interface LspToolDetails {\n\taction: LspAction;\n}\n\nexport interface LspToolOptions {\n\t/** Navigation provider (the LspManager). When absent, the tool reports that LSP is disabled. */\n\tprovider?: LspNavigationProvider;\n}\n\nfunction formatLspCall(args: Partial<LspToolInput> | undefined, theme: Theme, cwd: string): string {\n\tconst action = str(args?.action) ?? \"\";\n\tconst path = str(args?.path);\n\tconst line = typeof args?.line === \"number\" ? `:${args.line}` : \"\";\n\tconst symbol = str(args?.symbol);\n\tlet text = `${theme.fg(\"toolTitle\", theme.bold(\"lsp\"))} ${theme.fg(\"muted\", action)}`;\n\tif (path) {\n\t\ttext += ` ${renderToolPath(path, theme, cwd)}${theme.fg(\"muted\", line)}`;\n\t}\n\tif (symbol) {\n\t\ttext += ` ${theme.fg(\"toolOutput\", symbol)}`;\n\t}\n\tconst newName = str(args?.newName);\n\tif (newName) {\n\t\ttext += ` ${theme.fg(\"muted\", \"->\")} ${theme.fg(\"toolOutput\", newName)}`;\n\t}\n\tconst title = str(args?.title);\n\tif (title) {\n\t\ttext += ` ${theme.fg(\"muted\", `\"${title}\"`)}`;\n\t}\n\treturn text;\n}\n\nexport function createLspToolDefinition(\n\tcwd: string,\n\toptions?: LspToolOptions,\n): ToolDefinition<typeof lspSchema, LspToolDetails | undefined> {\n\tconst provider = options?.provider;\n\treturn {\n\t\tname: \"lsp\",\n\t\tlabel: \"lsp\",\n\t\tdescription:\n\t\t\t\"Query language servers for code intelligence and refactoring. Actions: definition (where a symbol is defined), references (all usages of a symbol), implementations (implementations of an interface/abstract symbol), type-definition (where a symbol's type is defined), callers (functions calling a symbol), callees (functions a symbol calls), hover (type signature and docs), symbols (file outline, or project-wide symbol search when symbol is provided), diagnostics (current errors in a file), rename (rename a symbol across the project; requires symbol and newName), fix (apply a quick fix for diagnostics at a symbol or line; pass title to choose among multiple, or kind such as source.organizeImports). definition/references/implementations/type-definition/callers/callees/hover/rename require a symbol name; pass line when the symbol occurs more than once.\",\n\t\tpromptSnippet:\n\t\t\t\"Code intelligence via language servers: definition, references, hover, symbols, diagnostics, rename, quick fixes\",\n\t\tpromptGuidelines: [\n\t\t\t\"Prefer lsp references over grep when finding usages of a symbol, and lsp definition over grep when locating where a symbol is defined.\",\n\t\t\t\"Use lsp rename to rename a symbol across the project instead of manual edits, and lsp fix to apply quick fixes such as adding missing imports reported by diagnostics.\",\n\t\t],\n\t\tparameters: lspSchema,\n\t\tasync execute(_toolCallId, input: LspToolInput, signal?: AbortSignal, _onUpdate?, _ctx?) {\n\t\t\tif (!provider) {\n\t\t\t\tthrow new Error(\"LSP is disabled. Run volt with --lsp or set lsp.enabled=true in settings.\");\n\t\t\t}\n\t\t\tconst absolutePath = resolveToCwd(input.path, cwd);\n\t\t\tconst needsSymbol =\n\t\t\t\tinput.action === \"definition\" ||\n\t\t\t\tinput.action === \"references\" ||\n\t\t\t\tinput.action === \"implementations\" ||\n\t\t\t\tinput.action === \"type-definition\" ||\n\t\t\t\tinput.action === \"callers\" ||\n\t\t\t\tinput.action === \"callees\" ||\n\t\t\t\tinput.action === \"hover\" ||\n\t\t\t\tinput.action === \"rename\";\n\t\t\tif (needsSymbol && !input.symbol) {\n\t\t\t\tthrow new Error(`lsp ${input.action} requires a symbol name.`);\n\t\t\t}\n\t\t\tif (input.action === \"rename\" && !input.newName) {\n\t\t\t\tthrow new Error(\"lsp rename requires newName.\");\n\t\t\t}\n\n\t\t\tlet text: string;\n\t\t\tswitch (input.action) {\n\t\t\t\tcase \"definition\":\n\t\t\t\t\ttext = await provider.definition(absolutePath, input.symbol!, input.line, signal);\n\t\t\t\t\tbreak;\n\t\t\t\tcase \"references\":\n\t\t\t\t\ttext = await provider.references(absolutePath, input.symbol!, input.line, signal);\n\t\t\t\t\tbreak;\n\t\t\t\tcase \"implementations\":\n\t\t\t\t\ttext = await provider.implementations(absolutePath, input.symbol!, input.line, signal);\n\t\t\t\t\tbreak;\n\t\t\t\tcase \"type-definition\":\n\t\t\t\t\ttext = await provider.typeDefinition(absolutePath, input.symbol!, input.line, signal);\n\t\t\t\t\tbreak;\n\t\t\t\tcase \"callers\":\n\t\t\t\t\ttext = await provider.callHierarchy(absolutePath, input.symbol!, \"incoming\", input.line, signal);\n\t\t\t\t\tbreak;\n\t\t\t\tcase \"callees\":\n\t\t\t\t\ttext = await provider.callHierarchy(absolutePath, input.symbol!, \"outgoing\", input.line, signal);\n\t\t\t\t\tbreak;\n\t\t\t\tcase \"hover\":\n\t\t\t\t\ttext = await provider.hover(absolutePath, input.symbol!, input.line, signal);\n\t\t\t\t\tbreak;\n\t\t\t\tcase \"symbols\":\n\t\t\t\t\ttext = input.symbol\n\t\t\t\t\t\t? await provider.workspaceSymbols(absolutePath, input.symbol, signal)\n\t\t\t\t\t\t: await provider.documentSymbols(absolutePath, signal);\n\t\t\t\t\tbreak;\n\t\t\t\tcase \"diagnostics\":\n\t\t\t\t\ttext = await provider.fileDiagnostics(absolutePath, signal);\n\t\t\t\t\tbreak;\n\t\t\t\tcase \"rename\":\n\t\t\t\t\ttext = await provider.rename(absolutePath, input.symbol!, input.newName!, input.line, signal);\n\t\t\t\t\tbreak;\n\t\t\t\tcase \"fix\":\n\t\t\t\t\ttext = await provider.codeFix(\n\t\t\t\t\t\tabsolutePath,\n\t\t\t\t\t\t{ symbol: input.symbol, line: input.line, title: input.title, kind: input.kind },\n\t\t\t\t\t\tsignal,\n\t\t\t\t\t);\n\t\t\t\t\tbreak;\n\t\t\t\tdefault:\n\t\t\t\t\tthrow new Error(`Unknown lsp action: ${String(input.action)}`);\n\t\t\t}\n\n\t\t\treturn {\n\t\t\t\tcontent: [{ type: \"text\", text }],\n\t\t\t\tdetails: { action: input.action },\n\t\t\t};\n\t\t},\n\t\trenderCall(args, theme, context) {\n\t\t\tconst component = (context.lastComponent as Text | undefined) ?? new Text(\"\", 0, 0);\n\t\t\tcomponent.setText(formatLspCall(args as Partial<LspToolInput> | undefined, theme, context.cwd));\n\t\t\treturn component;\n\t\t},\n\t};\n}\n\nexport function createLspTool(cwd: string, options?: LspToolOptions): AgentTool<typeof lspSchema> {\n\treturn wrapToolDefinition(createLspToolDefinition(cwd, options));\n}\n"]}