minimal-agent 0.10.0 → 0.12.0

package/src/tools/index.js

@@ -19,6 +19,8 @@ import { advisorTool } from './advisor/advisor.js';
 import { agentTool } from './agent/agent.js';
 import { askUserQuestionTool } from './ask/ask.js';
 import { bashTool } from './bash/bash.js';
+import { assertCapabilityRegistry } from './capabilities.js';
+import { computerUseTool } from './computeruse/computeruse.js';
 import { downloadTool } from './download/download.js';
 import { editTool } from './edit/edit.js';
 import { multiEditTool } from './edit/multi-edit.js';
@@ -26,10 +28,23 @@ import { genImageTool } from './genimage/genimage.js';
 import { generateSpeechTool } from './genspeech/genspeech.js';
 import { globTool } from './glob/glob.js';
 import { grepTool } from './grep/grep.js';
+import { lspTool } from './lsp/lsp.js';
+import { clearPersonaTool, confirmMemoryTool, forgetMemoryTool, listMemoriesTool, recallMemoryTool, rememberMemoryTool, reviewMemoriesTool, searchConversationsTool, setPersonaTool, updateMemoryTool, } from './memory/memory.js';
+import { notebookEditTool } from './notebook/notebookEdit.js';
+import { powerShellTool } from './powershell/powershell.js';
+import { presentResultTool } from './presentresult/presentresult.js';
 import { readTool } from './read/read.js';
-import { webfetchTool } from './webfetch/webfetch.js';
+import { skillTool } from './skill/skill.js';
+import { snipTool } from './snip/snip.js';
+import { taskCreateTool, taskGetTool, taskListTool, taskUpdateTool, } from './tasks/taskManagement.js';
+import { taskOutputTool } from './tasks/taskOutput.js';
+import { taskStopTool } from './tasks/taskStop.js';
+import { terminalCaptureTool } from './terminal/terminalCapture.js';
+import { trashTool } from './trash/trash.js';
 import { webbrowserTool } from './webbrowser/webbrowser.js';
+import { webfetchTool } from './webfetch/webfetch.js';
 import { webSearchTool } from './websearch/websearch.js';
+import { enterWorktreeTool, exitWorktreeTool, } from './worktree/sessionWorktree.js';
 import { writeTool } from './write/write.js';
 /** 所有内置工具（顺序 = 给 LLM 呈现的顺序，不影响代码执行，但会影响模型的优先级直觉） */
 export const ALL_TOOLS = [
@@ -37,24 +52,72 @@ export const ALL_TOOLS = [
     editTool,
     multiEditTool,
     writeTool,
+    notebookEditTool,
     globTool,
     grepTool,
+    lspTool,
     webSearchTool,
     webfetchTool,
     webbrowserTool,
     downloadTool,
     genImageTool,
     generateSpeechTool,
+    presentResultTool,
+    recallMemoryTool,
+    rememberMemoryTool,
+    updateMemoryTool,
+    listMemoriesTool,
+    forgetMemoryTool,
+    setPersonaTool,
+    clearPersonaTool,
+    confirmMemoryTool,
+    reviewMemoriesTool,
+    searchConversationsTool,
     bashTool,
+    powerShellTool,
+    taskOutputTool,
+    taskStopTool,
     askUserQuestionTool,
     advisorTool,
+    computerUseTool,
     // 追加在末尾：主循环 tools schema 的原有前缀字节不动（提示词缓存友好）
     agentTool,
+    // Product tools append at the end to preserve the existing schema prefix cache.
+    trashTool,
+    taskCreateTool,
+    taskGetTool,
+    taskUpdateTool,
+    taskListTool,
+    skillTool,
+    enterWorktreeTool,
+    exitWorktreeTool,
+    terminalCaptureTool,
+    snipTool,
 ];
+assertCapabilityRegistry(ALL_TOOLS.map((tool) => tool.name));
 /** 按名字查表 */
 export function getToolByName(name) {
     return ALL_TOOLS.find((t) => t.name === name);
 }
+export function getToolGateDetails(name, rawArguments, context) {
+    const tool = getToolByName(name);
+    if (!tool?.gateRequest)
+        return undefined;
+    let parsed;
+    try {
+        parsed = rawArguments.length === 0 ? {} : JSON.parse(rawArguments);
+    }
+    catch {
+        return undefined;
+    }
+    // ⚠️ 校验失败也要调 gateRequest（传 undefined）：**参数烂掉不等于身份不明**。
+    // 身份来自宿主注入的 context，与模型给的参数无关；跳过它会让闸门拿不到
+    // runContext，进而把参数格式问题报成「运行身份不匹配」——实测把排查方向
+    // 彻底带偏（见 Tool.gateRequest 的注释）。具体还能给出什么由各工具自己决定，
+    // 这里不认识任何工具的字段。
+    const checked = tool.inputSchema.safeParse(parsed);
+    return tool.gateRequest(checked.success ? checked.data : undefined, context);
+}
 /**
  * 执行一次工具调用。
  *
@@ -87,12 +150,31 @@ export async function executeTool(name, rawArguments, signal, ctx) {
     // 3. Zod 校验
     const checked = tool.inputSchema.safeParse(parsedJson);
     if (!checked.success) {
+        // 校验失败的回执是**给模型自己改的**，所以三样东西缺一不可：
+        // 哪个字段、它收到了什么、该怎么改。只说「参数校验失败」等于让模型盲猜。
+        //
+        // ⚠️ 那条「别填默认值占位」的提示不是废话：不少模型（GPT 系尤其明显）会把
+        // schema 里**每个**可选字段都填上 ""/0/{} 再发过来。实测一次 Desktop 侧的
+        // ComputerUse 调用就死在 `actionClass: ""` 上 —— 而且当时错误还被转述成
+        // 「运行身份与当前宿主会话不匹配」，根本查不出是参数问题。
+        const seen = (path) => {
+            let cur = parsedJson;
+            for (const k of path) {
+                if (cur == null || typeof cur !== 'object')
+                    return '（无）';
+                cur = cur[k];
+            }
+            return cur === undefined ? '（未提供）' : JSON.stringify(cur);
+        };
         const issues = checked.error.issues
-            .map((i) => `  - ${i.path.join('.') || '<root>'}: ${i.message}`)
+            .map((i) => {
+            const where = i.path.join('.') || '<root>';
+            return `  - ${where}：${i.message}\n    收到的值：${seen(i.path)}`;
+        })
             .join('\n');
         return {
             ok: false,
-            error: `参数校验失败（请检查参数名/类型）：\n${issues}`,
+            error: `工具 ${name} 参数校验失败，**请按下面逐条改正后重新调用**：\n${issues}\n\n通用修法：\n  · **只填你这次确实要用的字段**。可选字段不要用 ""、0、{} 之类的默认值占位 ——\n    留空不填即可；填了占位值反而会被当成"你要用它"而触发校验。\n  · 枚举字段只能取列出的值；数值字段注意上下限。\n  · 改完直接重发这次调用，不要因为这个错误就换一条完全不同的路子。`,
         };
     }
     // 4. 调用 call()，捕获意外异常
@@ -110,10 +192,22 @@ export async function executeTool(name, rawArguments, signal, ctx) {
     }
 }
 // 导出每个工具，方便测试单独 import
-export { readTool, editTool, writeTool, globTool, grepTool, webSearchTool, webfetchTool, webbrowserTool, downloadTool, bashTool, askUserQuestionTool };
+export { readTool, editTool, writeTool, globTool, grepTool, webSearchTool, webfetchTool, webbrowserTool, computerUseTool, downloadTool, presentResultTool, bashTool, askUserQuestionTool, };
+export { clearPersonaTool, confirmMemoryTool, forgetMemoryTool, listMemoriesTool, recallMemoryTool, rememberMemoryTool, reviewMemoriesTool, searchConversationsTool, setPersonaTool, updateMemoryTool, } from './memory/memory.js';
 export { multiEditTool } from './edit/multi-edit.js';
 export { genImageTool } from './genimage/genimage.js';
 export { advisorTool } from './advisor/advisor.js';
 export { agentTool } from './agent/agent.js';
-export { createGenerateSpeechTool, generateSpeechTool } from './genspeech/genspeech.js';
+export { createGenerateSpeechTool, generateSpeechTool, } from './genspeech/genspeech.js';
 export { createWebSearchTool } from './websearch/websearch.js';
+export { lspTool } from './lsp/lsp.js';
+export { notebookEditTool } from './notebook/notebookEdit.js';
+export { powerShellTool } from './powershell/powershell.js';
+export { taskOutputTool } from './tasks/taskOutput.js';
+export { taskStopTool } from './tasks/taskStop.js';
+export { taskCreateTool, taskGetTool, taskUpdateTool, taskListTool, } from './tasks/taskManagement.js';
+export { trashTool } from './trash/trash.js';
+export { skillTool } from './skill/skill.js';
+export { snipTool } from './snip/snip.js';
+export { enterWorktreeTool, exitWorktreeTool, } from './worktree/sessionWorktree.js';
+export { terminalCaptureTool, installTerminalCapture, } from './terminal/terminalCapture.js';

package/src/tools/index.ts

@@ -0,0 +1,293 @@
+/**
+ * ============================================================
+ *  src/tools/index.ts —— 工具注册表 + 执行入口
+ * ------------------------------------------------------------
+ *  这里做两件事：
+ *    1. 把所有工具集中起来导出一个 ALL_TOOLS 数组（loop.ts 会用）
+ *    2. 实现 executeTool(name, rawArgs)：
+ *         a. 按 name 查表
+ *         b. 用 Zod safeParse 校验 arguments（LLM 给的是 JSON 字符串！）
+ *         c. 调用 tool.call()，统一包装错误
+ *
+ *  这层是"防线"：模型给的参数永远不可信，必须 Zod 校验后才进 call()。
+ * ============================================================
+ */
+
+import type { Tool, ToolCallContext, ToolResult } from '../types.js';
+import { advisorTool } from './advisor/advisor.js';
+// ⚠️ agent.ts 与本模块构成环（tools/index → agent → loop → tools/index）：
+// agent.ts 顶层不求值本模块/loop 的任何导出、loop.ts 的工具 token 估算已懒化，
+// 环在运行时是安全的（详见 agent.ts 文件头「循环依赖纪律」）。
+import { agentTool } from './agent/agent.js';
+import { askUserQuestionTool } from './ask/ask.js';
+import { bashTool } from './bash/bash.js';
+import { assertCapabilityRegistry } from './capabilities.js';
+import { computerUseTool } from './computeruse/computeruse.js';
+import { downloadTool } from './download/download.js';
+import { editTool } from './edit/edit.js';
+import { multiEditTool } from './edit/multi-edit.js';
+import { genImageTool } from './genimage/genimage.js';
+import { generateSpeechTool } from './genspeech/genspeech.js';
+import { globTool } from './glob/glob.js';
+import { grepTool } from './grep/grep.js';
+import { lspTool } from './lsp/lsp.js';
+import {
+  clearPersonaTool,
+  confirmMemoryTool,
+  forgetMemoryTool,
+  listMemoriesTool,
+  recallMemoryTool,
+  rememberMemoryTool,
+  reviewMemoriesTool,
+  searchConversationsTool,
+  setPersonaTool,
+  updateMemoryTool,
+} from './memory/memory.js';
+import { notebookEditTool } from './notebook/notebookEdit.js';
+import { powerShellTool } from './powershell/powershell.js';
+import { presentResultTool } from './presentresult/presentresult.js';
+import { readTool } from './read/read.js';
+import { skillTool } from './skill/skill.js';
+import { snipTool } from './snip/snip.js';
+import {
+  taskCreateTool,
+  taskGetTool,
+  taskListTool,
+  taskUpdateTool,
+} from './tasks/taskManagement.js';
+import { taskOutputTool } from './tasks/taskOutput.js';
+import { taskStopTool } from './tasks/taskStop.js';
+import { terminalCaptureTool } from './terminal/terminalCapture.js';
+import { trashTool } from './trash/trash.js';
+import { webbrowserTool } from './webbrowser/webbrowser.js';
+import { webfetchTool } from './webfetch/webfetch.js';
+import { webSearchTool } from './websearch/websearch.js';
+import {
+  enterWorktreeTool,
+  exitWorktreeTool,
+} from './worktree/sessionWorktree.js';
+import { writeTool } from './write/write.js';
+
+/** 所有内置工具（顺序 = 给 LLM 呈现的顺序，不影响代码执行，但会影响模型的优先级直觉） */
+export const ALL_TOOLS: Tool[] = [
+  readTool,
+  editTool,
+  multiEditTool,
+  writeTool,
+  notebookEditTool,
+  globTool,
+  grepTool,
+  lspTool,
+  webSearchTool,
+  webfetchTool,
+  webbrowserTool,
+  downloadTool,
+  genImageTool,
+  generateSpeechTool,
+  presentResultTool,
+  recallMemoryTool,
+  rememberMemoryTool,
+  updateMemoryTool,
+  listMemoriesTool,
+  forgetMemoryTool,
+  setPersonaTool,
+  clearPersonaTool,
+  confirmMemoryTool,
+  reviewMemoriesTool,
+  searchConversationsTool,
+  bashTool,
+  powerShellTool,
+  taskOutputTool,
+  taskStopTool,
+  askUserQuestionTool,
+  advisorTool,
+  computerUseTool,
+  // 追加在末尾：主循环 tools schema 的原有前缀字节不动（提示词缓存友好）
+  agentTool,
+  // Product tools append at the end to preserve the existing schema prefix cache.
+  trashTool,
+  taskCreateTool,
+  taskGetTool,
+  taskUpdateTool,
+  taskListTool,
+  skillTool,
+  enterWorktreeTool,
+  exitWorktreeTool,
+  terminalCaptureTool,
+  snipTool,
+];
+
+assertCapabilityRegistry(ALL_TOOLS.map((tool) => tool.name));
+
+/** 按名字查表 */
+export function getToolByName(name: string): Tool | undefined {
+  return ALL_TOOLS.find((t) => t.name === name);
+}
+
+export function getToolGateDetails(
+  name: string,
+  rawArguments: string,
+  context: ToolCallContext,
+):
+  | Partial<
+      Pick<
+        import('../toolGate.js').ToolGateRequest,
+        'isReadOnly' | 'runContext' | 'action'
+      >
+    >
+  | undefined {
+  const tool = getToolByName(name);
+  if (!tool?.gateRequest) return undefined;
+  let parsed: unknown;
+  try {
+    parsed = rawArguments.length === 0 ? {} : JSON.parse(rawArguments);
+  } catch {
+    return undefined;
+  }
+  // ⚠️ 校验失败也要调 gateRequest（传 undefined）：**参数烂掉不等于身份不明**。
+  // 身份来自宿主注入的 context，与模型给的参数无关；跳过它会让闸门拿不到
+  // runContext，进而把参数格式问题报成「运行身份不匹配」——实测把排查方向
+  // 彻底带偏（见 Tool.gateRequest 的注释）。具体还能给出什么由各工具自己决定，
+  // 这里不认识任何工具的字段。
+  const checked = tool.inputSchema.safeParse(parsed);
+  return tool.gateRequest(checked.success ? checked.data : undefined, context);
+}
+
+/**
+ * 执行一次工具调用。
+ *
+ * @param name        工具名（来自 LLM 的 tool_call.function.name）
+ * @param rawArguments LLM 给的参数 —— 注意这是 JSON 字符串，不是对象
+ * @param signal      支持中断
+ * @param ctx         可选环境态透传（如 Advisor 需要的当前 history），绝大多数工具忽略
+ *
+ * 返回 ToolResult：失败时不抛异常，把 error 写在结果里（便于把"工具失败"
+ * 当成普通 tool_result 喂回 LLM，让模型自己重试或换思路）。
+ */
+export async function executeTool(
+  name: string,
+  rawArguments: string,
+  signal?: AbortSignal,
+  ctx?: ToolCallContext,
+): Promise<ToolResult> {
+  // 1. 找工具
+  const tool = getToolByName(name);
+  if (!tool) {
+    const available = ALL_TOOLS.map((t) => t.name).join(', ');
+    return { ok: false, error: `未知工具 "${name}"。可用工具：${available}` };
+  }
+
+  // 2. 解析 JSON
+  let parsedJson: unknown;
+  try {
+    parsedJson = rawArguments.length === 0 ? {} : JSON.parse(rawArguments);
+  } catch (e) {
+    return {
+      ok: false,
+      error: `工具参数不是合法 JSON：${(e as Error).message}\n收到的字符串：${rawArguments.slice(0, 200)}`,
+    };
+  }
+
+  // 3. Zod 校验
+  const checked = tool.inputSchema.safeParse(parsedJson);
+  if (!checked.success) {
+    // 校验失败的回执是**给模型自己改的**，所以三样东西缺一不可：
+    // 哪个字段、它收到了什么、该怎么改。只说「参数校验失败」等于让模型盲猜。
+    //
+    // ⚠️ 那条「别填默认值占位」的提示不是废话：不少模型（GPT 系尤其明显）会把
+    // schema 里**每个**可选字段都填上 ""/0/{} 再发过来。实测一次 Desktop 侧的
+    // ComputerUse 调用就死在 `actionClass: ""` 上 —— 而且当时错误还被转述成
+    // 「运行身份与当前宿主会话不匹配」，根本查不出是参数问题。
+    const seen = (path: (string | number)[]): string => {
+      let cur: unknown = parsedJson;
+      for (const k of path) {
+        if (cur == null || typeof cur !== 'object') return '（无）';
+        cur = (cur as Record<string | number, unknown>)[k];
+      }
+      return cur === undefined ? '（未提供）' : JSON.stringify(cur);
+    };
+    const issues = checked.error.issues
+      .map((i) => {
+        const where = i.path.join('.') || '<root>';
+        return `  - ${where}：${i.message}\n    收到的值：${seen(i.path)}`;
+      })
+      .join('\n');
+    return {
+      ok: false,
+      error: `工具 ${name} 参数校验失败，**请按下面逐条改正后重新调用**：\n${issues}\n\n通用修法：\n  · **只填你这次确实要用的字段**。可选字段不要用 ""、0、{} 之类的默认值占位 ——\n    留空不填即可；填了占位值反而会被当成"你要用它"而触发校验。\n  · 枚举字段只能取列出的值；数值字段注意上下限。\n  · 改完直接重发这次调用，不要因为这个错误就换一条完全不同的路子。`,
+    };
+  }
+
+  // 4. 调用 call()，捕获意外异常
+  //
+  try {
+    if (tool.callWithContext)
+      return await tool.callWithContext(checked.data, signal, ctx ?? {});
+    return await tool.call(checked.data, signal);
+  } catch (e) {
+    return {
+      ok: false,
+      error: `工具执行抛出异常：${(e as Error).message}`,
+    };
+  }
+}
+
+// 导出每个工具，方便测试单独 import
+export {
+  readTool,
+  editTool,
+  writeTool,
+  globTool,
+  grepTool,
+  webSearchTool,
+  webfetchTool,
+  webbrowserTool,
+  computerUseTool,
+  downloadTool,
+  presentResultTool,
+  bashTool,
+  askUserQuestionTool,
+};
+export {
+  clearPersonaTool,
+  confirmMemoryTool,
+  forgetMemoryTool,
+  listMemoriesTool,
+  recallMemoryTool,
+  rememberMemoryTool,
+  reviewMemoriesTool,
+  searchConversationsTool,
+  setPersonaTool,
+  updateMemoryTool,
+} from './memory/memory.js';
+export { multiEditTool } from './edit/multi-edit.js';
+export { genImageTool } from './genimage/genimage.js';
+export { advisorTool } from './advisor/advisor.js';
+export { agentTool } from './agent/agent.js';
+export {
+  createGenerateSpeechTool,
+  generateSpeechTool,
+} from './genspeech/genspeech.js';
+export { createWebSearchTool } from './websearch/websearch.js';
+export { lspTool } from './lsp/lsp.js';
+export { notebookEditTool } from './notebook/notebookEdit.js';
+export { powerShellTool } from './powershell/powershell.js';
+export { taskOutputTool } from './tasks/taskOutput.js';
+export { taskStopTool } from './tasks/taskStop.js';
+export {
+  taskCreateTool,
+  taskGetTool,
+  taskUpdateTool,
+  taskListTool,
+} from './tasks/taskManagement.js';
+export { trashTool } from './trash/trash.js';
+export { skillTool } from './skill/skill.js';
+export { snipTool } from './snip/snip.js';
+export {
+  enterWorktreeTool,
+  exitWorktreeTool,
+} from './worktree/sessionWorktree.js';
+export {
+  terminalCaptureTool,
+  installTerminalCapture,
+} from './terminal/terminalCapture.js';

package/src/tools/lsp/config.js

@@ -0,0 +1,113 @@
+import { createHash } from 'node:crypto';
+import { existsSync, readFileSync, statSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { delimiter, isAbsolute, join, resolve } from 'node:path';
+const AUTO_SERVERS = {
+    typescript: {
+        command: 'typescript-language-server', args: ['--stdio'],
+        extensionToLanguage: {
+            '.ts': 'typescript', '.tsx': 'typescriptreact', '.mts': 'typescript', '.cts': 'typescript',
+            '.js': 'javascript', '.jsx': 'javascriptreact', '.mjs': 'javascript', '.cjs': 'javascript',
+        },
+    },
+    pyright: { command: 'pyright-langserver', args: ['--stdio'], extensionToLanguage: { '.py': 'python', '.pyi': 'python' } },
+    rust: { command: 'rust-analyzer', extensionToLanguage: { '.rs': 'rust' } },
+    go: { command: 'gopls', extensionToLanguage: { '.go': 'go' } },
+    clangd: {
+        command: 'clangd',
+        extensionToLanguage: { '.c': 'c', '.h': 'c', '.cc': 'cpp', '.cpp': 'cpp', '.cxx': 'cpp', '.hpp': 'cpp' },
+    },
+};
+function executableNames(command) {
+    if (process.platform !== 'win32')
+        return [command];
+    if (/\.(?:exe|cmd|bat)$/i.test(command))
+        return [command];
+    return [command, `${command}.cmd`, `${command}.exe`, `${command}.bat`];
+}
+export function resolveExecutable(command, cwd) {
+    if (isAbsolute(command))
+        return existsSync(command) ? command : null;
+    const roots = [join(cwd, 'node_modules', '.bin'), ...(process.env.PATH ?? '').split(delimiter)];
+    for (const root of roots) {
+        if (!root)
+            continue;
+        for (const name of executableNames(command)) {
+            const candidate = resolve(root, name);
+            if (existsSync(candidate))
+                return candidate;
+        }
+    }
+    return null;
+}
+function readConfig(path) {
+    if (!existsSync(path))
+        return {};
+    try {
+        const value = JSON.parse(readFileSync(path, 'utf8'));
+        const record = value && typeof value === 'object' && 'servers' in value
+            ? value.servers
+            : value;
+        if (!record || typeof record !== 'object' || Array.isArray(record))
+            return {};
+        const out = {};
+        for (const [name, raw] of Object.entries(record)) {
+            if (!raw || typeof raw !== 'object')
+                continue;
+            const item = raw;
+            if (typeof item.command !== 'string' || !item.extensionToLanguage || typeof item.extensionToLanguage !== 'object')
+                continue;
+            const extensions = Object.fromEntries(Object.entries(item.extensionToLanguage)
+                .filter((entry) => typeof entry[1] === 'string')
+                .map(([extension, language]) => [extension.startsWith('.') ? extension.toLowerCase() : `.${extension.toLowerCase()}`, language]));
+            if (Object.keys(extensions).length === 0)
+                continue;
+            out[name] = {
+                command: item.command,
+                ...(Array.isArray(item.args) ? { args: item.args.filter((arg) => typeof arg === 'string') } : {}),
+                extensionToLanguage: extensions,
+                ...(item.env && typeof item.env === 'object' ? { env: Object.fromEntries(Object.entries(item.env).filter((entry) => typeof entry[1] === 'string')) } : {}),
+                ...('initializationOptions' in item ? { initializationOptions: item.initializationOptions } : {}),
+                ...(typeof item.startupTimeoutMs === 'number' ? { startupTimeoutMs: item.startupTimeoutMs } : {}),
+            };
+        }
+        return out;
+    }
+    catch {
+        return {};
+    }
+}
+function configPaths(cwd) {
+    const home = process.env.MINIMAL_AGENT_HOME ?? homedir();
+    return [join(home, '.minimal-agent', 'lsp.json'), join(cwd, '.minimal-agent', 'lsp.json')];
+}
+export function discoverLspServers(cwd) {
+    const merged = { ...AUTO_SERVERS };
+    for (const path of configPaths(cwd))
+        Object.assign(merged, readConfig(path));
+    return Object.entries(merged).flatMap(([name, config]) => {
+        const command = resolveExecutable(config.command, cwd);
+        return command ? [{ ...config, name, command }] : [];
+    });
+}
+export function lspAvailabilitySignature(cwd, discovered = discoverLspServers(cwd)) {
+    const configStats = configPaths(cwd).map((path) => {
+        try {
+            const value = statSync(path);
+            return `${path}:${value.mtimeMs}:${value.size}`;
+        }
+        catch {
+            return `${path}:missing`;
+        }
+    });
+    const servers = discovered.map((server) => {
+        try {
+            const info = statSync(server.command);
+            return `${server.name}:${server.command}:${info.mtimeMs}:${info.size}`;
+        }
+        catch {
+            return `${server.name}:${server.command}:missing`;
+        }
+    }).sort();
+    return createHash('sha256').update(JSON.stringify({ configStats, servers, path: process.env.PATH ?? '' })).digest('hex');
+}

package/src/tools/lsp/config.ts

@@ -0,0 +1,113 @@
+import { createHash } from 'node:crypto';
+import { existsSync, readFileSync, statSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { delimiter, isAbsolute, join, resolve } from 'node:path';
+
+export interface LspServerConfig {
+  command: string;
+  args?: string[];
+  extensionToLanguage: Record<string, string>;
+  env?: Record<string, string>;
+  initializationOptions?: unknown;
+  startupTimeoutMs?: number;
+}
+
+export interface ResolvedLspServerConfig extends LspServerConfig {
+  name: string;
+  command: string;
+}
+
+const AUTO_SERVERS: Record<string, LspServerConfig> = {
+  typescript: {
+    command: 'typescript-language-server', args: ['--stdio'],
+    extensionToLanguage: {
+      '.ts': 'typescript', '.tsx': 'typescriptreact', '.mts': 'typescript', '.cts': 'typescript',
+      '.js': 'javascript', '.jsx': 'javascriptreact', '.mjs': 'javascript', '.cjs': 'javascript',
+    },
+  },
+  pyright: { command: 'pyright-langserver', args: ['--stdio'], extensionToLanguage: { '.py': 'python', '.pyi': 'python' } },
+  rust: { command: 'rust-analyzer', extensionToLanguage: { '.rs': 'rust' } },
+  go: { command: 'gopls', extensionToLanguage: { '.go': 'go' } },
+  clangd: {
+    command: 'clangd',
+    extensionToLanguage: { '.c': 'c', '.h': 'c', '.cc': 'cpp', '.cpp': 'cpp', '.cxx': 'cpp', '.hpp': 'cpp' },
+  },
+};
+
+function executableNames(command: string): string[] {
+  if (process.platform !== 'win32') return [command];
+  if (/\.(?:exe|cmd|bat)$/i.test(command)) return [command];
+  return [command, `${command}.cmd`, `${command}.exe`, `${command}.bat`];
+}
+
+export function resolveExecutable(command: string, cwd: string): string | null {
+  if (isAbsolute(command)) return existsSync(command) ? command : null;
+  const roots = [join(cwd, 'node_modules', '.bin'), ...(process.env.PATH ?? '').split(delimiter)];
+  for (const root of roots) {
+    if (!root) continue;
+    for (const name of executableNames(command)) {
+      const candidate = resolve(root, name);
+      if (existsSync(candidate)) return candidate;
+    }
+  }
+  return null;
+}
+
+function readConfig(path: string): Record<string, LspServerConfig> {
+  if (!existsSync(path)) return {};
+  try {
+    const value = JSON.parse(readFileSync(path, 'utf8')) as unknown;
+    const record = value && typeof value === 'object' && 'servers' in value
+      ? (value as { servers?: unknown }).servers
+      : value;
+    if (!record || typeof record !== 'object' || Array.isArray(record)) return {};
+    const out: Record<string, LspServerConfig> = {};
+    for (const [name, raw] of Object.entries(record as Record<string, unknown>)) {
+      if (!raw || typeof raw !== 'object') continue;
+      const item = raw as Record<string, unknown>;
+      if (typeof item.command !== 'string' || !item.extensionToLanguage || typeof item.extensionToLanguage !== 'object') continue;
+      const extensions = Object.fromEntries(Object.entries(item.extensionToLanguage as Record<string, unknown>)
+        .filter((entry): entry is [string, string] => typeof entry[1] === 'string')
+        .map(([extension, language]) => [extension.startsWith('.') ? extension.toLowerCase() : `.${extension.toLowerCase()}`, language]));
+      if (Object.keys(extensions).length === 0) continue;
+      out[name] = {
+        command: item.command,
+        ...(Array.isArray(item.args) ? { args: item.args.filter((arg): arg is string => typeof arg === 'string') } : {}),
+        extensionToLanguage: extensions,
+        ...(item.env && typeof item.env === 'object' ? { env: Object.fromEntries(Object.entries(item.env as Record<string, unknown>).filter((entry): entry is [string, string] => typeof entry[1] === 'string')) } : {}),
+        ...('initializationOptions' in item ? { initializationOptions: item.initializationOptions } : {}),
+        ...(typeof item.startupTimeoutMs === 'number' ? { startupTimeoutMs: item.startupTimeoutMs } : {}),
+      };
+    }
+    return out;
+  } catch {
+    return {};
+  }
+}
+
+function configPaths(cwd: string): string[] {
+  const home = process.env.MINIMAL_AGENT_HOME ?? homedir();
+  return [join(home, '.minimal-agent', 'lsp.json'), join(cwd, '.minimal-agent', 'lsp.json')];
+}
+
+export function discoverLspServers(cwd: string): ResolvedLspServerConfig[] {
+  const merged = { ...AUTO_SERVERS };
+  for (const path of configPaths(cwd)) Object.assign(merged, readConfig(path));
+  return Object.entries(merged).flatMap(([name, config]) => {
+    const command = resolveExecutable(config.command, cwd);
+    return command ? [{ ...config, name, command }] : [];
+  });
+}
+
+export function lspAvailabilitySignature(cwd: string, discovered = discoverLspServers(cwd)): string {
+  const configStats = configPaths(cwd).map((path) => {
+    try { const value = statSync(path); return `${path}:${value.mtimeMs}:${value.size}`; } catch { return `${path}:missing`; }
+  });
+  const servers = discovered.map((server) => {
+    try {
+      const info = statSync(server.command);
+      return `${server.name}:${server.command}:${info.mtimeMs}:${info.size}`;
+    } catch { return `${server.name}:${server.command}:missing`; }
+  }).sort();
+  return createHash('sha256').update(JSON.stringify({ configStats, servers, path: process.env.PATH ?? '' })).digest('hex');
+}