sema-core 2.0.10 → 2.0.12

package/dist/services/hooks/hookTriggers.js.map

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

package/dist/services/hooks/hooksManager.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Hooks 管理器
+ *
+ * 负责 hooks.json 的加载、合并、校验、缓存与 matcher 匹配。
+ * 加载顺序：用户级(~/.sema/hooks/hooks.json) → 项目级(<workingDir>/.sema/hooks/hooks.json)，
+ * 同一事件的条目按加载顺序追加（不覆盖）。
+ */
+import { HooksInfo, LoadedHookEntry } from '../../types/hook';
+declare class HooksManager {
+    private userConfigPath;
+    private projectConfigPath;
+    private entriesByEvent;
+    private infoCache;
+    private loadingPromise;
+    private matcherCache;
+    constructor();
+    /**
+     * 发起一次加载（single-flight：并发调用共享同一个在飞 promise，避免重复文件 IO）
+     */
+    private startLoad;
+    /**
+     * 等待配置缓存就绪（就绪后近零开销）
+     */
+    ready(): Promise<void>;
+    /**
+     * 配置缓存是否已就绪（同步判断，供需要同步捕获条目的调用方使用）
+     */
+    isReady(): boolean;
+    /**
+     * 返回指定事件下 matcher 命中的可执行条目（仅 status === 'ok'）
+     * 工具类事件按通用工具名 / 内置名匹配；其他事件忽略 matcher 总是触发
+     */
+    getMatchedEntries(event: string, genericToolName?: string, semaToolName?: string): LoadedHookEntry[];
+    /**
+     * 获取合并后的配置视图
+     * @param refresh true 时重新加载配置，下一次 hook 触发即生效
+     */
+    getHooksInfo(refresh?: boolean): Promise<HooksInfo>;
+    private invalidateCache;
+    /**
+     * 加载并缓存配置。保证不抛错且总是落缓存：任何异常兜底为空配置，
+     * 避免缓存留 null 导致后续每次 hook 触发都重试文件 IO
+     */
+    private loadAndCache;
+    /**
+     * 解析单个 hooks.json 内容为条目列表（校验只标 status，不抛错）
+     */
+    private parseHooksFile;
+    private clampTimeoutMs;
+    /**
+     * matcher 编译（结果按 matcher 字符串缓存）：
+     * 1. 缺失/空串/'*' → 全匹配
+     * 2. 按 '|' 分段后每段均为简单名 → 精确集合匹配（通用工具名和内置名均可命中）
+     * 3. 否则整串按正则匹配通用工具名；编译失败 logWarn 一次且该条永不匹配
+     */
+    private compileMatcher;
+    dispose(): void;
+}
+/**
+ * 获取 Hooks Manager 实例（单例模式）
+ */
+export declare function getHooksManager(): HooksManager;
+export { HooksManager };
+//# sourceMappingURL=hooksManager.d.ts.map

package/dist/services/hooks/hooksManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooksManager.d.ts","sourceRoot":"","sources":["../../../src/services/hooks/hooksManager.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AASH,OAAO,EAIL,SAAS,EACT,eAAe,EAEhB,MAAM,kBAAkB,CAAA;AAazB,cAAM,YAAY;IAChB,OAAO,CAAC,cAAc,CAAQ;IAC9B,OAAO,CAAC,iBAAiB,CAAQ;IAEjC,OAAO,CAAC,cAAc,CAA8C;IACpE,OAAO,CAAC,SAAS,CAAyB;IAC1C,OAAO,CAAC,cAAc,CAA6B;IACnD,OAAO,CAAC,YAAY,CAAsC;;IAU1D;;OAEG;IACH,OAAO,CAAC,SAAS;IASjB;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAK5B;;OAEG;IACH,OAAO,IAAI,OAAO;IAIlB;;;OAGG;IACH,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,eAAe,EAAE;IAYpG;;;OAGG;IACG,YAAY,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,SAAS,CAAC;IAYzD,OAAO,CAAC,eAAe;IAMvB;;;OAGG;YACW,YAAY;IAqF1B;;OAEG;IACH,OAAO,CAAC,cAAc;IA0DtB,OAAO,CAAC,cAAc;IAUtB;;;;;OAKG;IACH,OAAO,CAAC,cAAc;IA+BtB,OAAO,IAAI,IAAI;CAGhB;AAMD;;GAEG;AACH,wBAAgB,eAAe,IAAI,YAAY,CAK9C;AAED,OAAO,EAAE,YAAY,EAAE,CAAA"}

package/dist/services/hooks/hooksManager.js

@@ -0,0 +1,346 @@
+"use strict";
+/**
+ * Hooks 管理器
+ *
+ * 负责 hooks.json 的加载、合并、校验、缓存与 matcher 匹配。
+ * 加载顺序：用户级(~/.sema/hooks/hooks.json) → 项目级(<workingDir>/.sema/hooks/hooks.json)，
+ * 同一事件的条目按加载顺序追加（不覆盖）。
+ */
+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.HooksManager = void 0;
+exports.getHooksManager = getHooksManager;
+const fs = __importStar(require("fs"));
+const fs_1 = require("fs");
+const path = __importStar(require("path"));
+const file_1 = require("../../util/file");
+const log_1 = require("../../util/log");
+const savePath_1 = require("../../util/savePath");
+const cwd_1 = require("../../util/cwd");
+const hook_1 = require("../../types/hook");
+// 配置文件位于 hooks 子目录下（hook 脚本可与配置同目录存放）
+const HOOKS_DIR_NAME = 'hooks';
+const HOOKS_FILE_NAME = 'hooks.json';
+const DEFAULT_TIMEOUT_S = 60;
+const MAX_TIMEOUT_S = 60;
+const MAX_TIMEOUT_PERMISSION_REQUEST_S = 120;
+const HOOK_EVENT_SET = new Set(hook_1.HOOK_EVENTS);
+class HooksManager {
+    constructor() {
+        this.entriesByEvent = null;
+        this.infoCache = null;
+        this.loadingPromise = null;
+        this.matcherCache = new Map();
+        this.userConfigPath = path.join((0, savePath_1.getSemaRootDir)(), HOOKS_DIR_NAME, HOOKS_FILE_NAME);
+        this.projectConfigPath = path.join((0, cwd_1.readInitialCwd)(), '.sema', HOOKS_DIR_NAME, HOOKS_FILE_NAME);
+        // 后台静默加载 hooks 配置
+        this.startLoad();
+    }
+    /**
+     * 发起一次加载（single-flight：并发调用共享同一个在飞 promise，避免重复文件 IO）
+     */
+    startLoad() {
+        if (!this.loadingPromise) {
+            this.loadingPromise = this.loadAndCache().finally(() => {
+                this.loadingPromise = null;
+            });
+        }
+        return this.loadingPromise;
+    }
+    /**
+     * 等待配置缓存就绪（就绪后近零开销）
+     */
+    async ready() {
+        if (this.entriesByEvent)
+            return;
+        await this.startLoad();
+    }
+    /**
+     * 配置缓存是否已就绪（同步判断，供需要同步捕获条目的调用方使用）
+     */
+    isReady() {
+        return this.entriesByEvent !== null;
+    }
+    /**
+     * 返回指定事件下 matcher 命中的可执行条目（仅 status === 'ok'）
+     * 工具类事件按通用工具名 / 内置名匹配；其他事件忽略 matcher 总是触发
+     */
+    getMatchedEntries(event, genericToolName, semaToolName) {
+        const entries = this.entriesByEvent?.get(event);
+        if (!entries || entries.length === 0)
+            return [];
+        const isToolEvent = hook_1.TOOL_HOOK_EVENTS.has(event);
+        return entries.filter(entry => {
+            if (entry.status !== 'ok')
+                return false;
+            if (!isToolEvent)
+                return true;
+            return this.compileMatcher(entry.matcher)(genericToolName, semaToolName);
+        });
+    }
+    /**
+     * 获取合并后的配置视图
+     * @param refresh true 时重新加载配置，下一次 hook 触发即生效
+     */
+    async getHooksInfo(refresh) {
+        if (refresh || !this.infoCache) {
+            if (!refresh && this.loadingPromise) {
+                await this.loadingPromise;
+            }
+            if (refresh || !this.infoCache) {
+                await this.loadAndCache();
+            }
+        }
+        return { ...this.infoCache };
+    }
+    invalidateCache() {
+        this.entriesByEvent = null;
+        this.infoCache = null;
+        this.matcherCache.clear();
+    }
+    /**
+     * 加载并缓存配置。保证不抛错且总是落缓存：任何异常兜底为空配置，
+     * 避免缓存留 null 导致后续每次 hook 触发都重试文件 IO
+     */
+    async loadAndCache() {
+        (0, log_1.logDebug)('刷新 Hooks 配置...');
+        const parseErrors = [];
+        const allEntries = [];
+        const rawBySource = {};
+        let userExists = false;
+        let projectExists = false;
+        try {
+            userExists = fs.existsSync(this.userConfigPath);
+            projectExists = fs.existsSync(this.projectConfigPath);
+            // 用户级 → 项目级，条目追加不覆盖
+            for (const [source, filePath, exists] of [
+                ['user', this.userConfigPath, userExists],
+                ['project', this.projectConfigPath, projectExists],
+            ]) {
+                if (!exists)
+                    continue;
+                try {
+                    const raw = await fs_1.promises.readFile(filePath, 'utf-8');
+                    const parsed = JSON.parse(raw);
+                    rawBySource[source] = raw;
+                    allEntries.push(...this.parseHooksFile(parsed, source));
+                }
+                catch (error) {
+                    const message = error instanceof Error ? error.message : String(error);
+                    (0, log_1.logWarn)(`Hooks 配置解析失败 [${filePath}]: ${message}`);
+                    parseErrors.push({ source, message });
+                }
+            }
+        }
+        catch (error) {
+            (0, log_1.logError)(`加载 Hooks 配置失败(按空配置处理): ${error}`);
+            allEntries.length = 0;
+        }
+        // 事件块行范围定位（供 IDE 跳转），按 source+event 缓存，定位失败退化为纯配置文件路径
+        const locationCache = new Map();
+        const locateEvent = (source, event) => {
+            const cacheKey = `${source}:${event}`;
+            const cached = locationCache.get(cacheKey);
+            if (cached)
+                return cached;
+            const filePath = source === 'user' ? this.userConfigPath : this.projectConfigPath;
+            const raw = rawBySource[source];
+            const range = raw ? (0, file_1.findJsonKeyValueLineRange)(raw, `"${event}"`) : undefined;
+            const location = range ? `${filePath}:${range[0]}-${range[1]}` : filePath;
+            locationCache.set(cacheKey, location);
+            return location;
+        };
+        const entriesByEvent = new Map();
+        const eventsView = {};
+        for (const entry of allEntries) {
+            if (!entriesByEvent.has(entry.event)) {
+                entriesByEvent.set(entry.event, []);
+                eventsView[entry.event] = [];
+            }
+            entriesByEvent.get(entry.event).push(entry);
+            eventsView[entry.event].push({
+                event: entry.event,
+                source: entry.source,
+                matcher: entry.matcher,
+                command: entry.command,
+                timeout: entry.timeoutRaw,
+                status: entry.status,
+                statusReason: entry.statusReason,
+                filePath: locateEvent(entry.source, entry.event),
+            });
+        }
+        this.entriesByEvent = entriesByEvent;
+        this.matcherCache.clear();
+        this.infoCache = {
+            userConfigPath: this.userConfigPath,
+            projectConfigPath: this.projectConfigPath,
+            userConfigExists: userExists,
+            projectConfigExists: projectExists,
+            parseErrors,
+            events: eventsView,
+        };
+        const okCount = allEntries.filter(e => e.status === 'ok').length;
+        if (allEntries.length > 0 || parseErrors.length > 0) {
+            (0, log_1.logInfo)(`Hooks 配置刷新完成: ${okCount}/${allEntries.length} 条可用`);
+        }
+    }
+    /**
+     * 解析单个 hooks.json 内容为条目列表（校验只标 status，不抛错）
+     */
+    parseHooksFile(parsed, source) {
+        const entries = [];
+        const hooks = parsed?.hooks;
+        if (!hooks || typeof hooks !== 'object')
+            return entries;
+        for (const [event, groups] of Object.entries(hooks)) {
+            if (!Array.isArray(groups))
+                continue;
+            for (const group of groups) {
+                if (!group || typeof group !== 'object' || !Array.isArray(group.hooks))
+                    continue;
+                const matcher = typeof group.matcher === 'string' ? group.matcher : undefined;
+                for (const cmd of group.hooks) {
+                    if (!cmd || typeof cmd !== 'object')
+                        continue;
+                    const command = typeof cmd.command === 'string' ? cmd.command.trim() : '';
+                    const timeoutRaw = typeof cmd.timeout === 'number' && Number.isFinite(cmd.timeout)
+                        ? cmd.timeout
+                        : undefined;
+                    const entry = {
+                        event,
+                        source,
+                        matcher,
+                        command,
+                        timeoutMs: this.clampTimeoutMs(event, timeoutRaw),
+                        timeoutRaw,
+                        failClosed: cmd.failClosed === true,
+                        status: 'ok',
+                    };
+                    // 校验（顺序即优先级，命中即定案）
+                    if (cmd.type !== undefined && cmd.type !== 'command') {
+                        entry.status = 'skipped';
+                        entry.statusReason = `unsupported type: ${cmd.type}`;
+                        (0, log_1.logWarn)(`[Hook] 跳过不支持的 hook 类型 [${source}] ${event}: ${cmd.type}`);
+                    }
+                    else if ('if' in cmd) {
+                        // 忽略 if 会把条件触发放大成无条件触发，比不执行更糟，整条跳过
+                        entry.status = 'skipped';
+                        entry.statusReason = `contains 'if' condition`;
+                        (0, log_1.logWarn)(`[Hook] 跳过含 'if' 条件的 hook 条目 [${source}] ${event}`);
+                    }
+                    else if (!command) {
+                        entry.status = 'invalid';
+                        entry.statusReason = 'missing command';
+                    }
+                    else if (!HOOK_EVENT_SET.has(event)) {
+                        entry.status = 'invalid';
+                        entry.statusReason = 'unknown event';
+                        (0, log_1.logWarn)(`[Hook] 未支持的 hook 事件 [${source}]: ${event}`);
+                    }
+                    else if (matcher !== undefined && !hook_1.TOOL_HOOK_EVENTS.has(event)) {
+                        entry.statusReason = 'matcher ignored for non-tool event';
+                        (0, log_1.logWarn)(`[Hook] ${event} 不支持 matcher，将总是触发 [${source}]`);
+                    }
+                    entries.push(entry);
+                }
+            }
+        }
+        return entries;
+    }
+    clampTimeoutMs(event, timeoutS) {
+        const max = event === 'PermissionRequest' ? MAX_TIMEOUT_PERMISSION_REQUEST_S : MAX_TIMEOUT_S;
+        if (timeoutS === undefined)
+            return DEFAULT_TIMEOUT_S * 1000;
+        const clamped = Math.min(Math.max(Math.floor(timeoutS), 1), max);
+        if (clamped !== timeoutS) {
+            (0, log_1.logWarn)(`[Hook] timeout ${timeoutS}s 超出范围 [1, ${max}]，已调整为 ${clamped}s`);
+        }
+        return clamped * 1000;
+    }
+    /**
+     * matcher 编译（结果按 matcher 字符串缓存）：
+     * 1. 缺失/空串/'*' → 全匹配
+     * 2. 按 '|' 分段后每段均为简单名 → 精确集合匹配（通用工具名和内置名均可命中）
+     * 3. 否则整串按正则匹配通用工具名；编译失败 logWarn 一次且该条永不匹配
+     */
+    compileMatcher(matcher) {
+        const key = matcher ?? '';
+        const cached = this.matcherCache.get(key);
+        if (cached)
+            return cached;
+        let predicate;
+        const trimmed = key.trim();
+        if (!trimmed || trimmed === '*') {
+            predicate = () => true;
+        }
+        else {
+            const parts = trimmed.split('|');
+            const isSimple = parts.every(p => /^[A-Za-z0-9_-]+$/.test(p));
+            if (isSimple) {
+                const nameSet = new Set(parts);
+                predicate = (genericName, semaName) => (genericName !== undefined && nameSet.has(genericName)) ||
+                    (semaName !== undefined && nameSet.has(semaName));
+            }
+            else {
+                try {
+                    const regex = new RegExp(trimmed);
+                    predicate = genericName => genericName !== undefined && regex.test(genericName);
+                }
+                catch (error) {
+                    (0, log_1.logWarn)(`[Hook] matcher 正则编译失败，该条目永不匹配: ${trimmed} (${error})`);
+                    predicate = () => false;
+                }
+            }
+        }
+        this.matcherCache.set(key, predicate);
+        return predicate;
+    }
+    dispose() {
+        this.invalidateCache();
+    }
+}
+exports.HooksManager = HooksManager;
+// ===================== 全局 Hooks 管理器 =====================
+let hooksManagerInstance = null;
+/**
+ * 获取 Hooks Manager 实例（单例模式）
+ */
+function getHooksManager() {
+    if (!hooksManagerInstance) {
+        hooksManagerInstance = new HooksManager();
+    }
+    return hooksManagerInstance;
+}
+//# sourceMappingURL=hooksManager.js.map

package/dist/services/hooks/hooksManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooksManager.js","sourceRoot":"","sources":["../../../src/services/hooks/hooksManager.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgUH,0CAKC;AAnUD,uCAAwB;AACxB,2BAA2C;AAC3C,2CAA4B;AAC5B,0CAA2D;AAC3D,wCAAqE;AACrE,kDAAoD;AACpD,wCAA+C;AAC/C,2CAOyB;AAEzB,sCAAsC;AACtC,MAAM,cAAc,GAAG,OAAO,CAAA;AAC9B,MAAM,eAAe,GAAG,YAAY,CAAA;AACpC,MAAM,iBAAiB,GAAG,EAAE,CAAA;AAC5B,MAAM,aAAa,GAAG,EAAE,CAAA;AACxB,MAAM,gCAAgC,GAAG,GAAG,CAAA;AAE5C,MAAM,cAAc,GAAwB,IAAI,GAAG,CAAC,kBAAW,CAAC,CAAA;AAIhE,MAAM,YAAY;IAShB;QALQ,mBAAc,GAA0C,IAAI,CAAA;QAC5D,cAAS,GAAqB,IAAI,CAAA;QAClC,mBAAc,GAAyB,IAAI,CAAA;QAC3C,iBAAY,GAAG,IAAI,GAAG,EAA4B,CAAA;QAGxD,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,IAAA,yBAAc,GAAE,EAAE,cAAc,EAAE,eAAe,CAAC,CAAA;QAClF,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC,IAAI,CAAC,IAAA,oBAAc,GAAE,EAAE,OAAO,EAAE,cAAc,EAAE,eAAe,CAAC,CAAA;QAE9F,kBAAkB;QAClB,IAAI,CAAC,SAAS,EAAE,CAAA;IAClB,CAAC;IAED;;OAEG;IACK,SAAS;QACf,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;YACzB,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE;gBACrD,IAAI,CAAC,cAAc,GAAG,IAAI,CAAA;YAC5B,CAAC,CAAC,CAAA;QACJ,CAAC;QACD,OAAO,IAAI,CAAC,cAAc,CAAA;IAC5B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,cAAc;YAAE,OAAM;QAC/B,MAAM,IAAI,CAAC,SAAS,EAAE,CAAA;IACxB,CAAC;IAED;;OAEG;IACH,OAAO;QACL,OAAO,IAAI,CAAC,cAAc,KAAK,IAAI,CAAA;IACrC,CAAC;IAED;;;OAGG;IACH,iBAAiB,CAAC,KAAa,EAAE,eAAwB,EAAE,YAAqB;QAC9E,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,EAAE,GAAG,CAAC,KAAK,CAAC,CAAA;QAC/C,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAA;QAE/C,MAAM,WAAW,GAAG,uBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;QAC/C,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;YAC5B,IAAI,KAAK,CAAC,MAAM,KAAK,IAAI;gBAAE,OAAO,KAAK,CAAA;YACvC,IAAI,CAAC,WAAW;gBAAE,OAAO,IAAI,CAAA;YAC7B,OAAO,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,eAAe,EAAE,YAAY,CAAC,CAAA;QAC1E,CAAC,CAAC,CAAA;IACJ,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,YAAY,CAAC,OAAiB;QAClC,IAAI,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YAC/B,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;gBACpC,MAAM,IAAI,CAAC,cAAc,CAAA;YAC3B,CAAC;YACD,IAAI,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;gBAC/B,MAAM,IAAI,CAAC,YAAY,EAAE,CAAA;YAC3B,CAAC;QACH,CAAC;QACD,OAAO,EAAE,GAAG,IAAI,CAAC,SAAU,EAAE,CAAA;IAC/B,CAAC;IAEO,eAAe;QACrB,IAAI,CAAC,cAAc,GAAG,IAAI,CAAA;QAC1B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAA;QACrB,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAA;IAC3B,CAAC;IAED;;;OAGG;IACK,KAAK,CAAC,YAAY;QACxB,IAAA,cAAQ,EAAC,gBAAgB,CAAC,CAAA;QAC1B,MAAM,WAAW,GAA2D,EAAE,CAAA;QAC9E,MAAM,UAAU,GAAsB,EAAE,CAAA;QACxC,MAAM,WAAW,GAAgD,EAAE,CAAA;QACnE,IAAI,UAAU,GAAG,KAAK,CAAA;QACtB,IAAI,aAAa,GAAG,KAAK,CAAA;QAEzB,IAAI,CAAC;YACH,UAAU,GAAG,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,cAAc,CAAC,CAAA;YAC/C,aAAa,GAAG,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAA;YAErD,oBAAoB;YACpB,KAAK,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,IAAI;gBACvC,CAAC,MAAM,EAAE,IAAI,CAAC,cAAc,EAAE,UAAU,CAAC;gBACzC,CAAC,SAAS,EAAE,IAAI,CAAC,iBAAiB,EAAE,aAAa,CAAC;aACH,EAAE,CAAC;gBAClD,IAAI,CAAC,MAAM;oBAAE,SAAQ;gBACrB,IAAI,CAAC;oBACH,MAAM,GAAG,GAAG,MAAM,aAAU,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;oBACxD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAiB,CAAA;oBAC9C,WAAW,CAAC,MAAM,CAAC,GAAG,GAAG,CAAA;oBACzB,UAAU,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;gBACzD,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;oBACtE,IAAA,aAAO,EAAC,iBAAiB,QAAQ,MAAM,OAAO,EAAE,CAAC,CAAA;oBACjD,WAAW,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAA;gBACvC,CAAC;YACH,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAA,cAAQ,EAAC,0BAA0B,KAAK,EAAE,CAAC,CAAA;YAC3C,UAAU,CAAC,MAAM,GAAG,CAAC,CAAA;QACvB,CAAC;QAED,sDAAsD;QACtD,MAAM,aAAa,GAAG,IAAI,GAAG,EAAkB,CAAA;QAC/C,MAAM,WAAW,GAAG,CAAC,MAA0B,EAAE,KAAa,EAAU,EAAE;YACxE,MAAM,QAAQ,GAAG,GAAG,MAAM,IAAI,KAAK,EAAE,CAAA;YACrC,MAAM,MAAM,GAAG,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;YAC1C,IAAI,MAAM;gBAAE,OAAO,MAAM,CAAA;YACzB,MAAM,QAAQ,GAAG,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAA;YACjF,MAAM,GAAG,GAAG,WAAW,CAAC,MAAM,CAAC,CAAA;YAC/B,MAAM,KAAK,GAAG,GAAG,CAAC,CAAC,CAAC,IAAA,gCAAyB,EAAC,GAAG,EAAE,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;YAC5E,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,QAAQ,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAA;YACzE,aAAa,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAA;YACrC,OAAO,QAAQ,CAAA;QACjB,CAAC,CAAA;QAED,MAAM,cAAc,GAAG,IAAI,GAAG,EAA6B,CAAA;QAC3D,MAAM,UAAU,GAAoC,EAAE,CAAA;QACtD,KAAK,MAAM,KAAK,IAAI,UAAU,EAAE,CAAC;YAC/B,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;gBACrC,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC,CAAA;gBACnC,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,CAAA;YAC9B,CAAC;YACD,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;YAC5C,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC;gBAC3B,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,OAAO,EAAE,KAAK,CAAC,UAAU;gBACzB,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,YAAY,EAAE,KAAK,CAAC,YAAY;gBAChC,QAAQ,EAAE,WAAW,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,KAAK,CAAC;aACjD,CAAC,CAAA;QACJ,CAAC;QAED,IAAI,CAAC,cAAc,GAAG,cAAc,CAAA;QACpC,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAA;QACzB,IAAI,CAAC,SAAS,GAAG;YACf,cAAc,EAAE,IAAI,CAAC,cAAc;YACnC,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;YACzC,gBAAgB,EAAE,UAAU;YAC5B,mBAAmB,EAAE,aAAa;YAClC,WAAW;YACX,MAAM,EAAE,UAAU;SACnB,CAAA;QAED,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,MAAM,CAAA;QAChE,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpD,IAAA,aAAO,EAAC,iBAAiB,OAAO,IAAI,UAAU,CAAC,MAAM,MAAM,CAAC,CAAA;QAC9D,CAAC;IACH,CAAC;IAED;;OAEG;IACK,cAAc,CAAC,MAAoB,EAAE,MAA0B;QACrE,MAAM,OAAO,GAAsB,EAAE,CAAA;QACrC,MAAM,KAAK,GAAG,MAAM,EAAE,KAAK,CAAA;QAC3B,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,OAAO,OAAO,CAAA;QAEvD,KAAK,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACpD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;gBAAE,SAAQ;YACpC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;gBAC3B,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC;oBAAE,SAAQ;gBAChF,MAAM,OAAO,GAAG,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAA;gBAE7E,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;oBAC9B,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;wBAAE,SAAQ;oBAC7C,MAAM,OAAO,GAAG,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;oBACzE,MAAM,UAAU,GAAG,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC;wBAChF,CAAC,CAAC,GAAG,CAAC,OAAO;wBACb,CAAC,CAAC,SAAS,CAAA;oBAEb,MAAM,KAAK,GAAoB;wBAC7B,KAAK;wBACL,MAAM;wBACN,OAAO;wBACP,OAAO;wBACP,SAAS,EAAE,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,UAAU,CAAC;wBACjD,UAAU;wBACV,UAAU,EAAE,GAAG,CAAC,UAAU,KAAK,IAAI;wBACnC,MAAM,EAAE,IAAI;qBACb,CAAA;oBAED,mBAAmB;oBACnB,IAAI,GAAG,CAAC,IAAI,KAAK,SAAS,IAAI,GAAG,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;wBACrD,KAAK,CAAC,MAAM,GAAG,SAAS,CAAA;wBACxB,KAAK,CAAC,YAAY,GAAG,qBAAqB,GAAG,CAAC,IAAI,EAAE,CAAA;wBACpD,IAAA,aAAO,EAAC,0BAA0B,MAAM,KAAK,KAAK,KAAK,GAAG,CAAC,IAAI,EAAE,CAAC,CAAA;oBACpE,CAAC;yBAAM,IAAI,IAAI,IAAI,GAAG,EAAE,CAAC;wBACvB,mCAAmC;wBACnC,KAAK,CAAC,MAAM,GAAG,SAAS,CAAA;wBACxB,KAAK,CAAC,YAAY,GAAG,yBAAyB,CAAA;wBAC9C,IAAA,aAAO,EAAC,gCAAgC,MAAM,KAAK,KAAK,EAAE,CAAC,CAAA;oBAC7D,CAAC;yBAAM,IAAI,CAAC,OAAO,EAAE,CAAC;wBACpB,KAAK,CAAC,MAAM,GAAG,SAAS,CAAA;wBACxB,KAAK,CAAC,YAAY,GAAG,iBAAiB,CAAA;oBACxC,CAAC;yBAAM,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;wBACtC,KAAK,CAAC,MAAM,GAAG,SAAS,CAAA;wBACxB,KAAK,CAAC,YAAY,GAAG,eAAe,CAAA;wBACpC,IAAA,aAAO,EAAC,wBAAwB,MAAM,MAAM,KAAK,EAAE,CAAC,CAAA;oBACtD,CAAC;yBAAM,IAAI,OAAO,KAAK,SAAS,IAAI,CAAC,uBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;wBACjE,KAAK,CAAC,YAAY,GAAG,oCAAoC,CAAA;wBACzD,IAAA,aAAO,EAAC,UAAU,KAAK,uBAAuB,MAAM,GAAG,CAAC,CAAA;oBAC1D,CAAC;oBAED,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;gBACrB,CAAC;YACH,CAAC;QACH,CAAC;QACD,OAAO,OAAO,CAAA;IAChB,CAAC;IAEO,cAAc,CAAC,KAAa,EAAE,QAAiB;QACrD,MAAM,GAAG,GAAG,KAAK,KAAK,mBAAmB,CAAC,CAAC,CAAC,gCAAgC,CAAC,CAAC,CAAC,aAAa,CAAA;QAC5F,IAAI,QAAQ,KAAK,SAAS;YAAE,OAAO,iBAAiB,GAAG,IAAI,CAAA;QAC3D,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;QAChE,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;YACzB,IAAA,aAAO,EAAC,kBAAkB,QAAQ,cAAc,GAAG,UAAU,OAAO,GAAG,CAAC,CAAA;QAC1E,CAAC;QACD,OAAO,OAAO,GAAG,IAAI,CAAA;IACvB,CAAC;IAED;;;;;OAKG;IACK,cAAc,CAAC,OAAgB;QACrC,MAAM,GAAG,GAAG,OAAO,IAAI,EAAE,CAAA;QACzB,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QACzC,IAAI,MAAM;YAAE,OAAO,MAAM,CAAA;QAEzB,IAAI,SAA2B,CAAA;QAC/B,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAA;QAC1B,IAAI,CAAC,OAAO,IAAI,OAAO,KAAK,GAAG,EAAE,CAAC;YAChC,SAAS,GAAG,GAAG,EAAE,CAAC,IAAI,CAAA;QACxB,CAAC;aAAM,CAAC;YACN,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;YAChC,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAA;YAC7D,IAAI,QAAQ,EAAE,CAAC;gBACb,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAA;gBAC9B,SAAS,GAAG,CAAC,WAAW,EAAE,QAAQ,EAAE,EAAE,CACpC,CAAC,WAAW,KAAK,SAAS,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;oBACvD,CAAC,QAAQ,KAAK,SAAS,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAA;YACrD,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC;oBACH,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,OAAO,CAAC,CAAA;oBACjC,SAAS,GAAG,WAAW,CAAC,EAAE,CAAC,WAAW,KAAK,SAAS,IAAI,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;gBACjF,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,IAAA,aAAO,EAAC,kCAAkC,OAAO,KAAK,KAAK,GAAG,CAAC,CAAA;oBAC/D,SAAS,GAAG,GAAG,EAAE,CAAC,KAAK,CAAA;gBACzB,CAAC;YACH,CAAC;QACH,CAAC;QACD,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,SAAS,CAAC,CAAA;QACrC,OAAO,SAAS,CAAA;IAClB,CAAC;IAED,OAAO;QACL,IAAI,CAAC,eAAe,EAAE,CAAA;IACxB,CAAC;CACF;AAgBQ,oCAAY;AAdrB,2DAA2D;AAE3D,IAAI,oBAAoB,GAAwB,IAAI,CAAA;AAEpD;;GAEG;AACH,SAAgB,eAAe;IAC7B,IAAI,CAAC,oBAAoB,EAAE,CAAC;QAC1B,oBAAoB,GAAG,IAAI,YAAY,EAAE,CAAA;IAC3C,CAAC;IACD,OAAO,oBAAoB,CAAA;AAC7B,CAAC"}

package/dist/tools/LoadTools.d.ts

@@ -0,0 +1,46 @@
+import { z } from 'zod';
+import { Tool } from './base/Tool';
+import { ToolControlSignal } from '../types/message';
+declare const toolParams: z.ZodObject<{
+    tool_names: z.ZodArray<z.ZodString, "many">;
+}, "strict", z.ZodTypeAny, {
+    tool_names: string[];
+}, {
+    tool_names: string[];
+}>;
+type ToolRes = {
+    loaded: string[];
+    alreadyAvailable: string[];
+    notFound: string[];
+    scope?: string;
+    controlSignal?: ToolControlSignal;
+};
+export declare const LoadTools: {
+    name: string;
+    description(): string;
+    toolParams: z.ZodObject<{
+        tool_names: z.ZodArray<z.ZodString, "many">;
+    }, "strict", z.ZodTypeAny, {
+        tool_names: string[];
+    }, {
+        tool_names: string[];
+    }>;
+    isSafe(): true;
+    getDisplayTitle(input?: z.infer<typeof toolParams>): string;
+    call({ tool_names }: z.infer<typeof toolParams>, agentContext: any): AsyncGenerator<{
+        type: "result";
+        data: ToolRes;
+        resultForAssistant: string | (import("@anthropic-ai/sdk/resources").TextBlockParam | import("@anthropic-ai/sdk/resources").ImageBlockParam)[] | undefined;
+    }, void, unknown>;
+    genResultForAssistant(output: ToolRes): string;
+};
+export declare function createSubagentLoadTools(opts: {
+    sessionId: string;
+    agentId: string;
+    /** spawn 时快照：默认集 + 继承段的名字（已在列表，无需加载） */
+    staticToolNames: string[];
+    /** 子代理视角延迟池（未扣除自身已加载段） */
+    getDeferredPool: () => Tool[];
+}): Tool;
+export {};
+//# sourceMappingURL=LoadTools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"LoadTools.d.ts","sourceRoot":"","sources":["../../src/tools/LoadTools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAA;AAClC,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AAOpD,QAAA,MAAM,UAAU;;;;;;EAEd,CAAA;AAEF,KAAK,OAAO,GAAG;IACb,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,gBAAgB,EAAE,MAAM,EAAE,CAAA;IAC1B,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,aAAa,CAAC,EAAE,iBAAiB,CAAA;CAClC,CAAA;AA4FD,eAAO,MAAM,SAAS;;;;;;;;;;;4BASI,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC;yBAGtB,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,gBAAgB,GAAG;;;;;kCAgB3C,OAAO,GAAG,MAAM;CAiBJ,CAAA;AAI5C,wBAAgB,uBAAuB,CAAC,IAAI,EAAE;IAC5C,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;IACf,wCAAwC;IACxC,eAAe,EAAE,MAAM,EAAE,CAAA;IACzB,0BAA0B;IAC1B,eAAe,EAAE,MAAM,IAAI,EAAE,CAAA;CAC9B,GAAG,IAAI,CA6BP"}