ysagc-agent 0.9.5 → 0.9.14

package/dist/hooks.js

@@ -0,0 +1,211 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hooksDisabled = hooksDisabled;
+exports.loadHooks = loadHooks;
+exports.runPreHooks = runPreHooks;
+exports.runPostHooks = runPostHooks;
+exports.attachHookResult = attachHookResult;
+exports.describeHooks = describeHooks;
+exports.clearHooksCache = clearHooksCache;
+exports.writeSampleHooks = writeSampleHooks;
+// ============================================================================
+// hooks：工具调用前后自动执行命令（工作区级配置）
+// ----------------------------------------------------------------------------
+// 解决什么问题：有些事「每次都得做」，但只能靠每轮叮嘱 AI —— 而 AI 会漏。
+//   - 改完 .ts/.vue 要跑 prettier / eslint --fix
+//   - 写完文件要跑一遍类型检查
+//   - 动完迁移文件要提醒
+// 配一次 hooks，之后每次命中都自动跑，不用再靠 prompt 兜。
+//
+// 配置位置：<工作区根>/.ysagc/hooks.json（跟着项目走，用户看得见、能提交进 git）
+//   {
+//     "post_tool": { "write_file": "npx prettier --write {{path}}", "*": "" },
+//     "pre_tool":  { "run_command": "echo about to run {{tool}}" }
+//   }
+// 占位符：{{path}} 工具的目标路径 / {{tool}} 工具名
+//
+// 几条硬规则（都是为了不把工作台变成后门）：
+//   1) hook 命令照样过危险命令检测（isDangerCommand）—— 配置文件里写 rm -rf / 也会被拦；
+//   2) hook 失败**不推翻工具本身**（文件已经写成功了），但会把失败信息回给模型，让它知道；
+//   3) 超时短（默认 30s）、输出截断，避免一个卡死的 hook 拖垮整个任务；
+//   4) 用 YSAGC_HOOKS=0 可整体关掉（排查问题时用）。
+const fs = __importStar(require("node:fs"));
+const node_fs_1 = require("node:fs");
+const path = __importStar(require("node:path"));
+const path_utils_1 = require("./path-utils");
+const security_1 = require("./security");
+const executor_1 = require("./executor");
+const HOOKS_REL = path.join('.ysagc', 'hooks.json');
+const HOOK_TIMEOUT_MS = Math.max(3000, Number(process.env.YSAGC_HOOK_TIMEOUT_MS || 30000));
+const MAX_HOOK_OUTPUT = 1200;
+/** 配置缓存：按文件 mtime 失效，避免每次工具调用都读盘 */
+const cache = new Map();
+function hooksDisabled() {
+    return String(process.env.YSAGC_HOOKS || '') === '0';
+}
+function hooksPathOf(root) {
+    try {
+        const r = (0, path_utils_1.canonicalize)(root);
+        const p = (0, path_utils_1.safeResolve)(r, HOOKS_REL, r, { allowEqual: false });
+        if ((0, security_1.isSensitivePath)(p))
+            return null;
+        return p;
+    }
+    catch {
+        return null;
+    }
+}
+/** 读配置（带 mtime 缓存）。读不到/解析失败一律当「没配」，绝不因此让工具调用失败。 */
+function loadHooks(root) {
+    if (hooksDisabled())
+        return {};
+    const p = hooksPathOf(root);
+    if (!p)
+        return {};
+    try {
+        if (!fs.existsSync(p))
+            return {};
+        const st = fs.statSync(p);
+        const hit = cache.get(p);
+        if (hit && hit.mtime === st.mtimeMs)
+            return hit.config;
+        const raw = JSON.parse(fs.readFileSync(p, 'utf8'));
+        const cfg = {
+            pre_tool: raw && typeof raw.pre_tool === 'object' ? raw.pre_tool : {},
+            post_tool: raw && typeof raw.post_tool === 'object' ? raw.post_tool : {},
+        };
+        cache.set(p, { mtime: st.mtimeMs, config: cfg });
+        return cfg;
+    }
+    catch {
+        return {};
+    }
+}
+/** 取某个工具命中的 hook 命令：精确名优先，其次通配 "*" */
+function hookFor(map, tool) {
+    if (!map)
+        return '';
+    const exact = String(map[tool] || '').trim();
+    if (exact)
+        return exact;
+    return String(map['*'] || '').trim();
+}
+function fillTemplate(cmd, tool, args) {
+    const target = String((args.path ?? args.file_path ?? args.name ?? '') || '');
+    return cmd.replace(/\{\{\s*tool\s*\}\}/g, tool).replace(/\{\{\s*path\s*\}\}/g, target);
+}
+/**
+ * 跑一条 hook 命令。
+ * 复用 executor.runCommand（带超时/输出上限），所以行为和 run_command 完全一致。
+ */
+async function runHook(ctx, command, tool, args) {
+    const filled = fillTemplate(command, tool, args);
+    const danger = (0, security_1.isDangerCommand)(filled);
+    if (danger.danger) {
+        return { command: filled, ok: false, output: `hook 被安全策略拦下（${danger.reason}）`, blocked: true };
+    }
+    try {
+        // 复用 executor.runCommand：超时、输出上限、脱敏都和 run_command 完全一致
+        const res = await (0, executor_1.runCommand)({
+            command: filled,
+            cwd: ctx.root,
+            timeoutMs: HOOK_TIMEOUT_MS,
+            maxBytes: Math.min(Number(ctx.maxBytes) || 64000, 64000),
+        });
+        const text = [res.stdout, res.stderr].filter(Boolean).join('\n').trim().slice(0, MAX_HOOK_OUTPUT);
+        return { command: filled, ok: res.exitCode === 0 && !res.timedOut, output: text };
+    }
+    catch (e) {
+        return { command: filled, ok: false, output: String(e?.message || e).slice(0, MAX_HOOK_OUTPUT) };
+    }
+}
+/** pre_tool：在工具执行**前**跑。返回 null 表示没配 / 不需要拦。 */
+async function runPreHooks(ctx, tool, args) {
+    const cmd = hookFor(loadHooks(ctx.root).pre_tool, tool);
+    if (!cmd)
+        return null;
+    return runHook(ctx, cmd, tool, args);
+}
+/** post_tool：工具**成功**后跑。失败的工具不触发（避免对着半成品又跑一遍格式化）。 */
+async function runPostHooks(ctx, tool, args) {
+    const cmd = hookFor(loadHooks(ctx.root).post_tool, tool);
+    if (!cmd)
+        return null;
+    return runHook(ctx, cmd, tool, args);
+}
+/** 把 hook 结果并进工具返回值：模型看得到「hook 做了什么 / 失败了什么」 */
+function attachHookResult(outcome, hook, phase) {
+    const label = phase === 'pre' ? '前置 hook' : '后置 hook';
+    const note = hook.ok
+        ? `${label} \`${hook.command}\` 执行成功${hook.output ? `：${hook.output}` : ''}`
+        : `${label} \`${hook.command}\` 执行失败${hook.output ? `：${hook.output}` : ''}`;
+    if (!outcome.result || typeof outcome.result !== 'object') {
+        return { ...outcome, result: { hook: note } };
+    }
+    return { ...outcome, result: { ...outcome.result, hook: note } };
+}
+/** 给「任务开始」时用：告诉模型这个工作区配了哪些 hooks（省得它以为是灵异事件） */
+function describeHooks(root) {
+    const cfg = loadHooks(root);
+    const pre = Object.entries(cfg.pre_tool || {}).filter(([, v]) => String(v || '').trim());
+    const post = Object.entries(cfg.post_tool || {}).filter(([, v]) => String(v || '').trim());
+    if (!pre.length && !post.length)
+        return '';
+    const lines = [];
+    if (pre.length)
+        lines.push(`前置（执行前）：${pre.map(([k, v]) => `${k} → ${v}`).join('；')}`);
+    if (post.length)
+        lines.push(`后置（执行后）：${post.map(([k, v]) => `${k} → ${v}`).join('；')}`);
+    return `\n\n【本工作区已配置自动 hooks】\n${lines.join('\n')}\n（这些命令会在对应工具调用前后自动执行，你不需要自己再跑一遍；如果它们失败，工具结果里会带上 hook 的报错。）`;
+}
+/** 供 selftest / 调试：清掉配置缓存 */
+function clearHooksCache() {
+    cache.clear();
+}
+/** 写入一份示例配置（供用户点「生成示例」时用） */
+async function writeSampleHooks(root) {
+    const r = (0, path_utils_1.canonicalize)(root);
+    const p = (0, path_utils_1.safeResolve)(r, HOOKS_REL, r, { allowEqual: false });
+    await node_fs_1.promises.mkdir(path.dirname(p), { recursive: true });
+    const sample = {
+        pre_tool: {},
+        post_tool: { write_file: 'npx --no-install prettier --write {{path}}' },
+    };
+    await node_fs_1.promises.writeFile(p, JSON.stringify(sample, null, 2) + '\n', 'utf8');
+    clearHooksCache();
+    return HOOKS_REL;
+}
+//# sourceMappingURL=hooks.js.map

package/dist/hooks.js.map

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

package/dist/index.d.ts

@@ -6,7 +6,9 @@ export { canonicalize, isWithinRoot, assertInsideRoot, safeResolve } from './pat
 export type { WithinRootOptions } from './path-utils';
 export { isDangerCommand, isSensitivePath, maskSecrets, MASK, } from './security';
 export type { DangerAssessment, DangerSeverity } from './security';
-export { createToolRegistry, preExecute, postExecute, walkTree, globToRegex } from './tools';
+export { createToolRegistry, preExecute, postExecute, walkTree, globToRegex, listMcpTools, mcpFailuresFor, shutdownMcp } from './tools';
+export { loadMcpConfig, mcpToolName, parseMcpToolName, renderMcpResult, writeSampleMcpConfig, mcpDisabled, McpManager, } from './mcp';
+export type { McpToolDef, McpServerConfig, McpConfig } from './mcp';
 export type { ToolRegistry, ToolContext, ToolResult, ToolOutcome, PreCheckOutcome, PostCheckOutcome, WalkEntry, } from './tools';
 export { loadConfig, loadSavedConfig, saveConfig, resolveConfigPath, configFileExists, normalizeServerUrl, validateConfig, describeConfig, DEFAULT_SERVER, } from './config';
 export type { AgentConfig, ConfigOverrides, PermissionMode, PermissionPreset, } from './config';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACpD,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAExD,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AACpC,YAAY,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAEtC,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AACzF,YAAY,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEtD,OAAO,EACL,eAAe,EACf,eAAe,EACf,WAAW,EACX,IAAI,GACL,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEnE,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC7F,YAAY,EACV,YAAY,EACZ,WAAW,EACX,UAAU,EACV,WAAW,EACX,eAAe,EACf,gBAAgB,EAChB,SAAS,GACV,MAAM,SAAS,CAAC;AAEjB,OAAO,EACL,UAAU,EACV,eAAe,EACf,UAAU,EACV,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,EACd,cAAc,EACd,cAAc,GACf,MAAM,UAAU,CAAC;AAClB,YAAY,EACV,WAAW,EACX,eAAe,EACf,cAAc,EACd,gBAAgB,GACjB,MAAM,UAAU,CAAC;AAElB,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACvF,YAAY,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAClG,YAAY,EACV,aAAa,EACb,aAAa,EACb,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,YAAY,EACZ,WAAW,EACX,cAAc,EACd,aAAa,EACb,YAAY,EACZ,WAAW,GACZ,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACzE,YAAY,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC/E,YAAY,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEnE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAClE,YAAY,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE5C,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,YAAY,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAExD,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,eAAe,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACpD,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAExD,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AACpC,YAAY,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAEtC,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AACzF,YAAY,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEtD,OAAO,EACL,eAAe,EACf,eAAe,EACf,WAAW,EACX,IAAI,GACL,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEnE,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAExI,OAAO,EACL,aAAa,EAAE,WAAW,EAAE,gBAAgB,EAAE,eAAe,EAAE,oBAAoB,EAAE,WAAW,EAAE,UAAU,GAC7G,MAAM,OAAO,CAAC;AACf,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACpE,YAAY,EACV,YAAY,EACZ,WAAW,EACX,UAAU,EACV,WAAW,EACX,eAAe,EACf,gBAAgB,EAChB,SAAS,GACV,MAAM,SAAS,CAAC;AAEjB,OAAO,EACL,UAAU,EACV,eAAe,EACf,UAAU,EACV,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,EACd,cAAc,EACd,cAAc,GACf,MAAM,UAAU,CAAC;AAClB,YAAY,EACV,WAAW,EACX,eAAe,EACf,cAAc,EACd,gBAAgB,GACjB,MAAM,UAAU,CAAC;AAElB,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACvF,YAAY,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAClG,YAAY,EACV,aAAa,EACb,aAAa,EACb,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,YAAY,EACZ,WAAW,EACX,cAAc,EACd,aAAa,EACb,YAAY,EACZ,WAAW,GACZ,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACzE,YAAY,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC/E,YAAY,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEnE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAClE,YAAY,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE5C,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,YAAY,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAExD,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,eAAe,UAAU,CAAC"}

package/dist/index.js

@@ -1,7 +1,8 @@
 "use strict";
 // Public API for ysagc-agent.
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Logger = exports.loadSkillRecord = exports.loadSkill = exports.listSkills = exports.shouldUseShell = exports.tokenize = exports.sanitizeEnv = exports.runCommand = exports.computeUsage = exports.estimateTokens = exports.countTextTokens = exports.stableStringify = exports.computeIdempotencyKey = exports.decodeMessage = exports.encodeMessage = exports.promptMasked = exports.prompt = exports.isInteractiveStdin = exports.runOnboarding = exports.DEFAULT_SERVER = exports.describeConfig = exports.validateConfig = exports.normalizeServerUrl = exports.configFileExists = exports.resolveConfigPath = exports.saveConfig = exports.loadSavedConfig = exports.loadConfig = exports.globToRegex = exports.walkTree = exports.postExecute = exports.preExecute = exports.createToolRegistry = exports.MASK = exports.maskSecrets = exports.isSensitivePath = exports.isDangerCommand = exports.safeResolve = exports.assertInsideRoot = exports.isWithinRoot = exports.canonicalize = exports.runSelfTest = exports.AGENT_VERSION = exports.startAgent = void 0;
+exports.shouldUseShell = exports.tokenize = exports.sanitizeEnv = exports.runCommand = exports.computeUsage = exports.estimateTokens = exports.countTextTokens = exports.stableStringify = exports.computeIdempotencyKey = exports.decodeMessage = exports.encodeMessage = exports.promptMasked = exports.prompt = exports.isInteractiveStdin = exports.runOnboarding = exports.DEFAULT_SERVER = exports.describeConfig = exports.validateConfig = exports.normalizeServerUrl = exports.configFileExists = exports.resolveConfigPath = exports.saveConfig = exports.loadSavedConfig = exports.loadConfig = exports.McpManager = exports.mcpDisabled = exports.writeSampleMcpConfig = exports.renderMcpResult = exports.parseMcpToolName = exports.mcpToolName = exports.loadMcpConfig = exports.shutdownMcp = exports.mcpFailuresFor = exports.listMcpTools = exports.globToRegex = exports.walkTree = exports.postExecute = exports.preExecute = exports.createToolRegistry = exports.MASK = exports.maskSecrets = exports.isSensitivePath = exports.isDangerCommand = exports.safeResolve = exports.assertInsideRoot = exports.isWithinRoot = exports.canonicalize = exports.runSelfTest = exports.AGENT_VERSION = exports.startAgent = void 0;
+exports.Logger = exports.loadSkillRecord = exports.loadSkill = exports.listSkills = void 0;
 var agent_1 = require("./agent");
 Object.defineProperty(exports, "startAgent", { enumerable: true, get: function () { return agent_1.startAgent; } });
 Object.defineProperty(exports, "AGENT_VERSION", { enumerable: true, get: function () { return agent_1.AGENT_VERSION; } });
@@ -23,6 +24,17 @@ Object.defineProperty(exports, "preExecute", { enumerable: true, get: function (
 Object.defineProperty(exports, "postExecute", { enumerable: true, get: function () { return tools_1.postExecute; } });
 Object.defineProperty(exports, "walkTree", { enumerable: true, get: function () { return tools_1.walkTree; } });
 Object.defineProperty(exports, "globToRegex", { enumerable: true, get: function () { return tools_1.globToRegex; } });
+Object.defineProperty(exports, "listMcpTools", { enumerable: true, get: function () { return tools_1.listMcpTools; } });
+Object.defineProperty(exports, "mcpFailuresFor", { enumerable: true, get: function () { return tools_1.mcpFailuresFor; } });
+Object.defineProperty(exports, "shutdownMcp", { enumerable: true, get: function () { return tools_1.shutdownMcp; } });
+var mcp_1 = require("./mcp");
+Object.defineProperty(exports, "loadMcpConfig", { enumerable: true, get: function () { return mcp_1.loadMcpConfig; } });
+Object.defineProperty(exports, "mcpToolName", { enumerable: true, get: function () { return mcp_1.mcpToolName; } });
+Object.defineProperty(exports, "parseMcpToolName", { enumerable: true, get: function () { return mcp_1.parseMcpToolName; } });
+Object.defineProperty(exports, "renderMcpResult", { enumerable: true, get: function () { return mcp_1.renderMcpResult; } });
+Object.defineProperty(exports, "writeSampleMcpConfig", { enumerable: true, get: function () { return mcp_1.writeSampleMcpConfig; } });
+Object.defineProperty(exports, "mcpDisabled", { enumerable: true, get: function () { return mcp_1.mcpDisabled; } });
+Object.defineProperty(exports, "McpManager", { enumerable: true, get: function () { return mcp_1.McpManager; } });
 var config_1 = require("./config");
 Object.defineProperty(exports, "loadConfig", { enumerable: true, get: function () { return config_1.loadConfig; } });
 Object.defineProperty(exports, "loadSavedConfig", { enumerable: true, get: function () { return config_1.loadSavedConfig; } });

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA,8BAA8B;;;AAE9B,iCAAoD;AAA3C,mGAAA,UAAU,OAAA;AAAE,sGAAA,aAAa,OAAA;AAGlC,6BAAoC;AAA3B,kGAAA,WAAW,OAAA;AAGpB,2CAAyF;AAAhF,0GAAA,YAAY,OAAA;AAAE,0GAAA,YAAY,OAAA;AAAE,8GAAA,gBAAgB,OAAA;AAAE,yGAAA,WAAW,OAAA;AAGlE,uCAKoB;AAJlB,2GAAA,eAAe,OAAA;AACf,2GAAA,eAAe,OAAA;AACf,uGAAA,WAAW,OAAA;AACX,gGAAA,IAAI,OAAA;AAIN,iCAA6F;AAApF,2GAAA,kBAAkB,OAAA;AAAE,mGAAA,UAAU,OAAA;AAAE,oGAAA,WAAW,OAAA;AAAE,iGAAA,QAAQ,OAAA;AAAE,oGAAA,WAAW,OAAA;AAW3E,mCAUkB;AAThB,oGAAA,UAAU,OAAA;AACV,yGAAA,eAAe,OAAA;AACf,oGAAA,UAAU,OAAA;AACV,2GAAA,iBAAiB,OAAA;AACjB,0GAAA,gBAAgB,OAAA;AAChB,4GAAA,kBAAkB,OAAA;AAClB,wGAAA,cAAc,OAAA;AACd,wGAAA,cAAc,OAAA;AACd,wGAAA,cAAc,OAAA;AAShB,2CAAuF;AAA9E,2GAAA,aAAa,OAAA;AAAE,gHAAA,kBAAkB,OAAA;AAAE,oGAAA,MAAM,OAAA;AAAE,0GAAA,YAAY,OAAA;AAGhE,uCAAkG;AAAzF,yGAAA,aAAa,OAAA;AAAE,yGAAA,aAAa,OAAA;AAAE,iHAAA,qBAAqB,OAAA;AAAE,2GAAA,eAAe,OAAA;AAe7E,mCAAyE;AAAhE,yGAAA,eAAe,OAAA;AAAE,wGAAA,cAAc,OAAA;AAAE,sGAAA,YAAY,OAAA;AAGtD,uCAA+E;AAAtE,sGAAA,UAAU,OAAA;AAAE,uGAAA,WAAW,OAAA;AAAE,oGAAA,QAAQ,OAAA;AAAE,0GAAA,cAAc,OAAA;AAG1D,mCAAkE;AAAzD,oGAAA,UAAU,OAAA;AAAE,mGAAA,SAAS,OAAA;AAAE,yGAAA,eAAe,OAAA;AAG/C,mCAAkC;AAAzB,gGAAA,MAAM,OAAA;AAGf,mCAAqC;AACrC,kBAAe,kBAAU,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA,8BAA8B;;;;AAE9B,iCAAoD;AAA3C,mGAAA,UAAU,OAAA;AAAE,sGAAA,aAAa,OAAA;AAGlC,6BAAoC;AAA3B,kGAAA,WAAW,OAAA;AAGpB,2CAAyF;AAAhF,0GAAA,YAAY,OAAA;AAAE,0GAAA,YAAY,OAAA;AAAE,8GAAA,gBAAgB,OAAA;AAAE,yGAAA,WAAW,OAAA;AAGlE,uCAKoB;AAJlB,2GAAA,eAAe,OAAA;AACf,2GAAA,eAAe,OAAA;AACf,uGAAA,WAAW,OAAA;AACX,gGAAA,IAAI,OAAA;AAIN,iCAAwI;AAA/H,2GAAA,kBAAkB,OAAA;AAAE,mGAAA,UAAU,OAAA;AAAE,oGAAA,WAAW,OAAA;AAAE,iGAAA,QAAQ,OAAA;AAAE,oGAAA,WAAW,OAAA;AAAE,qGAAA,YAAY,OAAA;AAAE,uGAAA,cAAc,OAAA;AAAE,oGAAA,WAAW,OAAA;AAEtH,6BAEe;AADb,oGAAA,aAAa,OAAA;AAAE,kGAAA,WAAW,OAAA;AAAE,uGAAA,gBAAgB,OAAA;AAAE,sGAAA,eAAe,OAAA;AAAE,2GAAA,oBAAoB,OAAA;AAAE,kGAAA,WAAW,OAAA;AAAE,iGAAA,UAAU,OAAA;AAa9G,mCAUkB;AAThB,oGAAA,UAAU,OAAA;AACV,yGAAA,eAAe,OAAA;AACf,oGAAA,UAAU,OAAA;AACV,2GAAA,iBAAiB,OAAA;AACjB,0GAAA,gBAAgB,OAAA;AAChB,4GAAA,kBAAkB,OAAA;AAClB,wGAAA,cAAc,OAAA;AACd,wGAAA,cAAc,OAAA;AACd,wGAAA,cAAc,OAAA;AAShB,2CAAuF;AAA9E,2GAAA,aAAa,OAAA;AAAE,gHAAA,kBAAkB,OAAA;AAAE,oGAAA,MAAM,OAAA;AAAE,0GAAA,YAAY,OAAA;AAGhE,uCAAkG;AAAzF,yGAAA,aAAa,OAAA;AAAE,yGAAA,aAAa,OAAA;AAAE,iHAAA,qBAAqB,OAAA;AAAE,2GAAA,eAAe,OAAA;AAe7E,mCAAyE;AAAhE,yGAAA,eAAe,OAAA;AAAE,wGAAA,cAAc,OAAA;AAAE,sGAAA,YAAY,OAAA;AAGtD,uCAA+E;AAAtE,sGAAA,UAAU,OAAA;AAAE,uGAAA,WAAW,OAAA;AAAE,oGAAA,QAAQ,OAAA;AAAE,0GAAA,cAAc,OAAA;AAG1D,mCAAkE;AAAzD,oGAAA,UAAU,OAAA;AAAE,mGAAA,SAAS,OAAA;AAAE,yGAAA,eAAe,OAAA;AAG/C,mCAAkC;AAAzB,gGAAA,MAAM,OAAA;AAGf,mCAAqC;AACrC,kBAAe,kBAAU,CAAC"}

package/dist/mcp.d.ts

@@ -0,0 +1,92 @@
+export interface McpServerConfig {
+    /** stdio 传输：要拉起的命令（与 url 二选一） */
+    command?: string;
+    args?: string[];
+    env?: Record<string, string>;
+    cwd?: string;
+    /**
+     * HTTP 传输（Streamable HTTP / 旧版 SSE）：MCP server 的地址（与 command 二选一）。
+     * 远端 server、或本地以 HTTP 方式跑起来的 server 都用这个。
+     */
+    url?: string;
+    /** HTTP 传输的请求头（如 Authorization）。支持 ${ENV_VAR} 形式从环境变量取值，避免把密钥写进仓库。 */
+    headers?: Record<string, string>;
+    /** 默认 true；设为 false 可单独停用某个 server */
+    enabled?: boolean;
+}
+export interface McpToolDef {
+    /** 平台侧使用的完整工具名：mcp__<server>__<tool> */
+    name: string;
+    server: string;
+    tool: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+}
+export interface McpConfig {
+    mcpServers: Record<string, McpServerConfig>;
+}
+export declare function mcpDisabled(): boolean;
+export declare function mcpConfigPath(root: string): string;
+/** 读取工作区 MCP 配置；不存在/格式不对返回 null（不抛，避免拖垮 Agent 启动） */
+export declare function loadMcpConfig(root: string): McpConfig | null;
+/**
+ * 带原因的版本。
+ *
+ * 为什么需要它：JSON 里写 Windows 路径时 `\m` 这种是**非法转义**，JSON.parse 直接抛，
+ * 配置整个作废。以前这种情况只会表现为「一个 MCP 工具都没有」，用户完全看不出是自己
+ * 把反斜杠写错了。现在把原因带出来，经 mcp_tools 消息里的 failures 一路报到 UI。
+ */
+export declare function loadMcpConfigDetailed(root: string): {
+    config: McpConfig | null;
+    error?: string;
+};
+/** 工具名里的 server/tool 分隔符。用双下划线，和 Claude 的 mcp__server__tool 命名保持一致。 */
+export declare const MCP_PREFIX = "mcp__";
+/** 把 server+tool 拼成平台可见的工具名。名字里不允许再出现分隔符，否则解析会歧义。 */
+export declare function mcpToolName(server: string, tool: string): string;
+/** 反向解析；不是 mcp__ 前缀或格式不对返回 null */
+export declare function parseMcpToolName(name: string): {
+    server: string;
+    tool: string;
+} | null;
+/**
+ * 一个工作区对应一个 Manager：懒启动、缓存工具清单。
+ * 配置变化（mtime 变了）时整体重启 —— MCP server 不支持热加载，重建是最稳的做法。
+ */
+export declare class McpManager {
+    private root;
+    private log?;
+    private clients;
+    private errors;
+    private loadedMtime;
+    private starting;
+    constructor(root: string, log?: (msg: string) => void);
+    private configMtime;
+    /** 确保按当前配置把所有 server 拉起来（幂等） */
+    ensure(): Promise<void>;
+    private doEnsure;
+    private reset;
+    /** 平台可见的工具清单（已带 mcp__server__tool 名字） */
+    listTools(): Promise<McpToolDef[]>;
+    /** 启动失败的 server 及其原因（用于在工具清单里如实说明，而不是静默消失） */
+    failures(): {
+        server: string;
+        error: string;
+    }[];
+    /** 按平台工具名分发一次 MCP 调用 */
+    callByName(name: string, args: Record<string, unknown>): Promise<any>;
+    /** 进程退出时收尾（Agent 关闭时调用） */
+    shutdown(): void;
+}
+/**
+ * 把 MCP 的 tools/call 结果压成模型好读的文本。
+ * MCP 返回 { content: [{type:'text', text} | {type:'image', data, mimeType}], isError? }，
+ * 图片没法直接塞进文本结果，用占位说明代替（否则模型会以为拿到了空结果）。
+ */
+export declare function renderMcpResult(result: any): {
+    ok: boolean;
+    text: string;
+};
+/** 给工作区写一份示例配置（用户点「添加 MCP」时用） */
+export declare function writeSampleMcpConfig(root: string): string;
+//# sourceMappingURL=mcp.d.ts.map

package/dist/mcp.d.ts.map

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