sema-core 2.0.11 → 2.0.12

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":"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"}

package/dist/types/hook.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Hook 相关类型定义
+ *
+ * 事件名、stdin payload、输出协议与业界通用 hooks 格式一致（详见 test/hook.md）。
+ * 基础功能支持 8 个事件，配置文件为 ~/.sema/hooks/hooks.json 与 <workingDir>/.sema/hooks/hooks.json。
+ */
+export declare const HOOK_EVENTS: readonly ["SessionStart", "UserPromptSubmit", "PreToolUse", "PostToolUse", "PostToolUseFailure", "PermissionRequest", "Stop", "SessionEnd"];
+export type HookEventName = (typeof HOOK_EVENTS)[number];
+export declare const TOOL_HOOK_EVENTS: ReadonlySet<string>;
+export interface RawHookCommand {
+    type?: string;
+    command?: string;
+    timeout?: number;
+    failClosed?: boolean;
+    if?: string;
+    [k: string]: unknown;
+}
+export interface RawHookMatcherGroup {
+    matcher?: string;
+    hooks?: RawHookCommand[];
+    [k: string]: unknown;
+}
+export interface RawHooksFile {
+    hooks?: Record<string, RawHookMatcherGroup[]>;
+    [k: string]: unknown;
+}
+export interface LoadedHookEntry {
+    event: string;
+    source: 'user' | 'project';
+    matcher?: string;
+    command: string;
+    timeoutMs: number;
+    timeoutRaw?: number;
+    failClosed: boolean;
+    status: 'ok' | 'skipped' | 'invalid';
+    statusReason?: string;
+}
+export interface HookEntryInfo {
+    event: string;
+    source: 'user' | 'project';
+    matcher?: string;
+    command: string;
+    timeout?: number;
+    status: 'ok' | 'skipped' | 'invalid';
+    statusReason?: string;
+    filePath?: string;
+}
+export interface HooksInfo {
+    userConfigPath: string;
+    projectConfigPath: string;
+    userConfigExists: boolean;
+    projectConfigExists: boolean;
+    parseErrors: Array<{
+        source: 'user' | 'project';
+        message: string;
+    }>;
+    events: Record<string, HookEntryInfo[]>;
+}
+export interface HookExecResult {
+    exitCode: number | null;
+    stdout: string;
+    stderr: string;
+    timedOut: boolean;
+    failedToSpawn: boolean;
+    durationMs: number;
+}
+export interface HookOutcome {
+    kind: 'pass' | 'block' | 'error';
+    decision?: 'allow' | 'deny' | 'ask';
+    reason?: string;
+    additionalContext?: string;
+    systemMessage?: string;
+    suppressOutput?: boolean;
+    blockIgnored?: boolean;
+}
+//# sourceMappingURL=hook.d.ts.map

package/dist/types/hook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook.d.ts","sourceRoot":"","sources":["../../src/types/hook.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,eAAO,MAAM,WAAW,6IASd,CAAA;AAEV,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAA;AAGxD,eAAO,MAAM,gBAAgB,EAAE,WAAW,CAAC,MAAM,CAK/C,CAAA;AAIF,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,cAAc,EAAE,CAAA;IACxB,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,EAAE,CAAC,CAAA;IAC7C,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;CACrB;AAID,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,GAAG,SAAS,CAAA;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,UAAU,EAAE,OAAO,CAAA;IACnB,MAAM,EAAE,IAAI,GAAG,SAAS,GAAG,SAAS,CAAA;IACpC,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAID,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,GAAG,SAAS,CAAA;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,IAAI,GAAG,SAAS,GAAG,SAAS,CAAA;IACpC,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,SAAS;IACxB,cAAc,EAAE,MAAM,CAAA;IACtB,iBAAiB,EAAE,MAAM,CAAA;IACzB,gBAAgB,EAAE,OAAO,CAAA;IACzB,mBAAmB,EAAE,OAAO,CAAA;IAC5B,WAAW,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IACnE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC,CAAA;CACxC;AAID,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,OAAO,CAAA;IACjB,aAAa,EAAE,OAAO,CAAA;IACtB,UAAU,EAAE,MAAM,CAAA;CACnB;AAGD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,CAAA;IAChC,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,KAAK,CAAA;IACnC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,YAAY,CAAC,EAAE,OAAO,CAAA;CACvB"}

package/dist/types/hook.js

@@ -0,0 +1,28 @@
+"use strict";
+/**
+ * Hook 相关类型定义
+ *
+ * 事件名、stdin payload、输出协议与业界通用 hooks 格式一致（详见 test/hook.md）。
+ * 基础功能支持 8 个事件，配置文件为 ~/.sema/hooks/hooks.json 与 <workingDir>/.sema/hooks/hooks.json。
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TOOL_HOOK_EVENTS = exports.HOOK_EVENTS = void 0;
+// 基础功能支持的 hook 事件
+exports.HOOK_EVENTS = [
+    'SessionStart',
+    'UserPromptSubmit',
+    'PreToolUse',
+    'PostToolUse',
+    'PostToolUseFailure',
+    'PermissionRequest',
+    'Stop',
+    'SessionEnd',
+];
+// 工具类事件（matcher 仅对这些事件生效）
+exports.TOOL_HOOK_EVENTS = new Set([
+    'PreToolUse',
+    'PostToolUse',
+    'PostToolUseFailure',
+    'PermissionRequest',
+]);
+//# sourceMappingURL=hook.js.map

package/dist/types/hook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook.js","sourceRoot":"","sources":["../../src/types/hook.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,kBAAkB;AACL,QAAA,WAAW,GAAG;IACzB,cAAc;IACd,kBAAkB;IAClB,YAAY;IACZ,aAAa;IACb,oBAAoB;IACpB,mBAAmB;IACnB,MAAM;IACN,YAAY;CACJ,CAAA;AAIV,0BAA0B;AACb,QAAA,gBAAgB,GAAwB,IAAI,GAAG,CAAC;IAC3D,YAAY;IACZ,aAAa;IACb,oBAAoB;IACpB,mBAAmB;CACpB,CAAC,CAAA"}

package/dist/types/index.d.ts

@@ -118,4 +118,5 @@ export type { TodoItem, TodoTaskStatus, TodoTask, } from './todoTask';
 export type { CronTask, CronTaskFile, } from './cron';
 export { TOOL_NAME_VIEW_FILE, TOOL_NAME_RUN_SHELL, TOOL_NAME_PEEK_BG_JOB, TOOL_NAME_STOP_BG_JOB, TOOL_NAME_DEL_CRON, TOOL_NAME_LIST_CRONS, TOOL_NAME_CREATE_TODO, TOOL_NAME_LIST_TODOS, TOOL_NAME_GET_TODO, TOOL_NAME_UPDATE_TODO, TOOL_NAME_CREATE_CRON, TOOL_NAME_PICK_OPTION, TOOL_NAME_PLAN_TO_AGENT, TOOL_NAME_FETCH_URL, TOOL_NAME_SEARCH_FILES, TOOL_NAME_SEARCH_CONTENT, TOOL_NAME_EDIT_NOTEBOOK, TOOL_NAME_SKILL, TOOL_NAME_SUB_AGENT, TOOL_NAME_WRITE_FILE, TOOL_NAME_PATCH_FILE, } from '../prompt/tool';
 export type { CreateSessionOptions, CreateSessionResult } from './session';
+export type { HooksInfo, HookEntryInfo, } from './hook';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

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

package/dist/util/file.d.ts

@@ -46,6 +46,14 @@ export declare function formatWithLineNumbers({ content, startLine, }: {
  *
  */
 export declare function findJsonObjectLineRange(json: string, match: string): [number, number] | undefined;
+/**
+ * 在 JSON 文本中，查找包含 match 的 key 行及其值块（对象或数组）的行范围。
+ *
+ * 与 findJsonObjectLineRange 的差异：起始行取 match 所在行本身，
+ * 结束行按 match 行缩进往下找同缩进的 ']' 或 '}' 行，适用于值为数组的 key
+ * （如 hooks.json 的事件块 "PreToolUse": [...]）。值与 key 同行闭合时返回单行范围。
+ */
+export declare function findJsonKeyValueLineRange(json: string, match: string): [number, number] | undefined;
 /**
  * 获取相对于初始工作目录的显示路径，超出范围则返回绝对路径
  */

package/dist/util/file.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file.d.ts","sourceRoot":"","sources":["../../src/util/file.ts"],"names":[],"mappings":"AA4BA,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,IAAI,CAAA;AAE1C,wBAAsB,SAAS,CAC7B,WAAW,EAAE,MAAM,EACnB,GAAG,EAAE,MAAM,EACX,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EACpD,WAAW,EAAE,WAAW,GACvB,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAAC,CAiBlD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,GAClB,OAAO,CAqCT;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAChB,MAAM,SAAI,EACV,QAAQ,CAAC,EAAE,MAAM,GAChB;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAmB5D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,cAAc,EACxB,OAAO,EAAE,cAAc,GACtB,IAAI,CAON;AAsCD,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAGrE;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,CAuBlE;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,CAajE;AAID,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAgB7D;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAsB7E;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,EACpC,OAAO,EACP,SAAS,GACV,EAAE;IACD,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;CAClB,GAAG,MAAM,CAOT;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CA6BjG;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGvD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,GAAG,MAAM,GAAG,SAAS,CAEjF;AAQD,UAAU,UAAU;IAClB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;CACb;AAGD,wBAAsB,cAAc,CAClC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EAAE,EACd,WAAW,CAAC,EAAE,WAAW,EACzB,OAAO,SAAuB,EAC9B,qBAAqB,UAAO,EAC5B,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,UAAU,CAAC,CAsBrB"}
+{"version":3,"file":"file.d.ts","sourceRoot":"","sources":["../../src/util/file.ts"],"names":[],"mappings":"AA4BA,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,IAAI,CAAA;AAE1C,wBAAsB,SAAS,CAC7B,WAAW,EAAE,MAAM,EACnB,GAAG,EAAE,MAAM,EACX,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EACpD,WAAW,EAAE,WAAW,GACvB,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAAC,CAiBlD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,GAClB,OAAO,CAqCT;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAChB,MAAM,SAAI,EACV,QAAQ,CAAC,EAAE,MAAM,GAChB;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAmB5D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,cAAc,EACxB,OAAO,EAAE,cAAc,GACtB,IAAI,CAON;AAsCD,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAGrE;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,CAuBlE;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,CAajE;AAID,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAgB7D;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAsB7E;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,EACpC,OAAO,EACP,SAAS,GACV,EAAE;IACD,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;CAClB,GAAG,MAAM,CAOT;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CA6BjG;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CA2BnG;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGvD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,GAAG,MAAM,GAAG,SAAS,CAEjF;AAQD,UAAU,UAAU;IAClB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;CACb;AAGD,wBAAsB,cAAc,CAClC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EAAE,EACd,WAAW,CAAC,EAAE,WAAW,EACzB,OAAO,SAAuB,EAC9B,qBAAqB,UAAO,EAC5B,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,UAAU,CAAC,CAsBrB"}

package/dist/util/file.js

@@ -12,6 +12,7 @@ exports.canonicalizeFilePath = canonicalizeFilePath;
 exports.findFileWithDifferentExt = findFileWithDifferentExt;
 exports.formatWithLineNumbers = formatWithLineNumbers;
 exports.findJsonObjectLineRange = findJsonObjectLineRange;
+exports.findJsonKeyValueLineRange = findJsonKeyValueLineRange;
 exports.getDisplayPath = getDisplayPath;
 exports.getFilePath = getFilePath;
 exports.execFileSafely = execFileSafely;
@@ -274,6 +275,44 @@ function findJsonObjectLineRange(json, match) {
     }
     return undefined;
 }
+/**
+ * 在 JSON 文本中，查找包含 match 的 key 行及其值块（对象或数组）的行范围。
+ *
+ * 与 findJsonObjectLineRange 的差异：起始行取 match 所在行本身，
+ * 结束行按 match 行缩进往下找同缩进的 ']' 或 '}' 行，适用于值为数组的 key
+ * （如 hooks.json 的事件块 "PreToolUse": [...]）。值与 key 同行闭合时返回单行范围。
+ */
+function findJsonKeyValueLineRange(json, match) {
+    const lines = json.split('\n');
+    const matchIdx = lines.findIndex(l => l.includes(match));
+    if (matchIdx === -1)
+        return undefined;
+    // 值在 match 行内闭合（含压缩 JSON 整文件一行的场景）：按 match 之后的括号配平判断
+    const afterMatch = lines[matchIdx].slice(lines[matchIdx].indexOf(match) + match.length);
+    let depth = 0;
+    let opened = false;
+    for (const ch of afterMatch) {
+        if (ch === '[' || ch === '{') {
+            depth++;
+            opened = true;
+        }
+        else if (ch === ']' || ch === '}')
+            depth--;
+        if (opened && depth === 0)
+            return [matchIdx + 1, matchIdx + 1];
+    }
+    if (!opened)
+        return [matchIdx + 1, matchIdx + 1];
+    // 多行值：往下找与 match 行同缩进的闭合行
+    const indent = lines[matchIdx].search(/\S/);
+    for (let i = matchIdx + 1; i < lines.length; i++) {
+        const trimmed = lines[i].trimStart();
+        if ((trimmed.startsWith(']') || trimmed.startsWith('}')) && lines[i].search(/\S/) === indent) {
+            return [matchIdx + 1, i + 1];
+        }
+    }
+    return undefined;
+}
 /**
  * 获取相对于初始工作目录的显示路径，超出范围则返回绝对路径
  */