sema-core 2.0.11 → 2.0.12

package/dist/services/hooks/hookRunner.js

@@ -0,0 +1,252 @@
+"use strict";
+/**
+ * Hook 命令执行器与输出解析
+ *
+ * 一次性子进程执行（不复用 PersistentShell：其为单例长驻共享 shell，有状态且命令排队），
+ * stdin 写入 JSON payload，输出走通用 hooks 协议（exit code + stdout JSON 两条通道）。
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MAX_ADDITIONAL_CONTEXT_CHARS = void 0;
+exports.executeHookCommand = executeHookCommand;
+exports.parseHookOutput = parseHookOutput;
+exports.truncateContext = truncateContext;
+const child_process_1 = require("child_process");
+const cwd_1 = require("../../util/cwd");
+const log_1 = require("../../util/log");
+const process_1 = require("../../util/process");
+const platform_1 = require("../../util/platform");
+// 单流输出上限 1MB
+const MAX_STREAM_BYTES = 1024 * 1024;
+// additionalContext 长度上限（超出截断并记 warning）
+exports.MAX_ADDITIONAL_CONTEXT_CHARS = 10_000;
+// SIGTERM 后升级 SIGKILL 的宽限期
+const KILL_GRACE_MS = 2000;
+// SIGKILL 后强制 settle 的期限（不依赖 close/exit 事件到达，保证 Promise 有界结束）
+const SETTLE_GRACE_MS = 2000;
+// 不可阻断的事件（exit 2 / decision block 降级为 pass 并打 blockIgnored 标）。
+// Stop 暂不支持续驱（block stop 强迫模型继续），只作观察型埋点
+const NON_BLOCKABLE_EVENTS = new Set(['SessionStart', 'SessionEnd', 'Stop']);
+/**
+ * 终止 hook 进程。POSIX 下 hook 以独立进程组运行（spawn detached），
+ * 负 pid 整组终止（含孙进程）；Windows 复用 taskkill /f /t（已是整树强杀）
+ */
+function terminateHookProcess(proc, force) {
+    if (!proc.pid)
+        return;
+    try {
+        if (platform_1.IS_WIN) {
+            (0, process_1.killProcess)(proc);
+        }
+        else {
+            try {
+                process.kill(-proc.pid, force ? 'SIGKILL' : 'SIGTERM');
+            }
+            catch {
+                // 进程组终止失败（如进程已退出）回落单进程 kill
+                try {
+                    proc.kill(force ? 'SIGKILL' : 'SIGTERM');
+                }
+                catch { /* 已退出 */ }
+            }
+        }
+    }
+    catch (error) {
+        (0, log_1.logWarn)(`[Hook] 终止 hook 进程失败: ${error}`);
+    }
+}
+/**
+ * 以一次性子进程执行 hook 命令，payload 经 stdin 写入
+ */
+function executeHookCommand(command, payloadJson, timeoutMs, signal) {
+    return new Promise(resolve => {
+        const startTime = Date.now();
+        let stdout = '';
+        let stderr = '';
+        let timedOut = false;
+        let settled = false;
+        let terminating = false;
+        let timeoutTimer = null;
+        let escalationTimer = null;
+        let deadlineTimer = null;
+        let proc;
+        const finish = (result) => {
+            if (settled)
+                return;
+            settled = true;
+            if (timeoutTimer)
+                clearTimeout(timeoutTimer);
+            if (escalationTimer)
+                clearTimeout(escalationTimer);
+            if (deadlineTimer)
+                clearTimeout(deadlineTimer);
+            if (signal)
+                signal.removeEventListener('abort', onAbort);
+            resolve({ ...result, durationMs: Date.now() - startTime });
+        };
+        // 终止升级链（配置超时与 AbortSignal 中断共用同一入口）：
+        // SIGTERM → KILL_GRACE → SIGKILL → SETTLE_GRACE 到期直接 settle。
+        // 最后一级不依赖任何进程事件，是 Promise 有界结束的确定性保证
+        const beginTermination = () => {
+            if (terminating || settled)
+                return;
+            terminating = true;
+            terminateHookProcess(proc, false);
+            escalationTimer = setTimeout(() => {
+                if (settled)
+                    return;
+                terminateHookProcess(proc, true);
+                deadlineTimer = setTimeout(() => {
+                    (0, log_1.logWarn)(`[Hook] 进程未在期限内退出，强制结束等待（可能残留进程）: ${command}`);
+                    finish({ exitCode: null, stdout, stderr, timedOut, failedToSpawn: !timedOut });
+                }, SETTLE_GRACE_MS);
+            }, KILL_GRACE_MS);
+        };
+        const onAbort = () => beginTermination();
+        const { bin, args } = (0, process_1.getShellForSpawn)();
+        try {
+            proc = (0, child_process_1.spawn)(bin, [...args, command], {
+                cwd: (0, cwd_1.readInitialCwd)(),
+                env: process.env,
+                stdio: ['pipe', 'pipe', 'pipe'],
+                // POSIX 下 detached 使 hook 独占进程组，便于整组终止；
+                // 子进程不会随宿主退出自动回收，与非 detached 行为一致（SessionEnd 本为尽力而为）
+                ...(platform_1.IS_WIN ? { windowsHide: true } : { detached: true }),
+            });
+        }
+        catch (error) {
+            (0, log_1.logWarn)(`[Hook] spawn 失败: ${error}`);
+            finish({ exitCode: null, stdout: '', stderr: '', timedOut: false, failedToSpawn: true });
+            return;
+        }
+        timeoutTimer = setTimeout(() => {
+            timedOut = true;
+            beginTermination();
+        }, timeoutMs);
+        if (signal) {
+            if (signal.aborted)
+                beginTermination();
+            else
+                signal.addEventListener('abort', onAbort, { once: true });
+        }
+        proc.on('error', error => {
+            (0, log_1.logWarn)(`[Hook] 子进程执行失败: ${error}`);
+            finish({ exitCode: null, stdout, stderr, timedOut, failedToSpawn: true });
+        });
+        proc.stdout?.on('data', (chunk) => {
+            if (stdout.length < MAX_STREAM_BYTES)
+                stdout += chunk.toString('utf-8');
+        });
+        proc.stderr?.on('data', (chunk) => {
+            if (stderr.length < MAX_STREAM_BYTES)
+                stderr += chunk.toString('utf-8');
+        });
+        // EPIPE 防护：脚本不读 stdin 直接退出时 write 会触发 error
+        proc.stdin?.on('error', () => { });
+        proc.stdin?.write(payloadJson);
+        proc.stdin?.end();
+        proc.on('close', code => {
+            // abort 场景按执行失败处理（外层 fail-open）
+            const abortedExternally = signal?.aborted === true && !timedOut;
+            finish({
+                exitCode: code,
+                stdout,
+                stderr,
+                timedOut,
+                failedToSpawn: abortedExternally,
+            });
+        });
+    });
+}
+/**
+ * 解析单条 hook 的执行输出（exit code + stdout JSON 双通道）
+ */
+function parseHookOutput(event, exec) {
+    if (exec.timedOut || exec.failedToSpawn) {
+        return { kind: 'error' };
+    }
+    // exit 2：阻断，stderr 作为原因；SessionStart/SessionEnd 不可阻断，降级 pass
+    if (exec.exitCode === 2) {
+        if (NON_BLOCKABLE_EVENTS.has(event)) {
+            (0, log_1.logWarn)(`[Hook] ${event} 不可阻断，忽略 exit 2（stderr: ${exec.stderr.trim().slice(0, 200)}）`);
+            return { kind: 'pass', blockIgnored: true };
+        }
+        return { kind: 'block', reason: exec.stderr.trim() || `Blocked by ${event} hook` };
+    }
+    // 其他非 0 exit code（含 null）：hook 执行失败，fail-open（exit 1 明确不阻断）
+    if (exec.exitCode !== 0) {
+        return { kind: 'error' };
+    }
+    // exit 0：stdout 若为单个合法 JSON 对象则结构化解析，否则按纯文本处理
+    const rawStdout = exec.stdout.trim();
+    let parsed = null;
+    if (rawStdout.startsWith('{')) {
+        try {
+            const obj = JSON.parse(rawStdout);
+            if (obj && typeof obj === 'object' && !Array.isArray(obj)) {
+                parsed = obj;
+            }
+        }
+        catch {
+            // 非法 JSON 按纯文本处理
+        }
+    }
+    if (!parsed) {
+        // 纯文本：SessionStart / UserPromptSubmit 作为附加上下文注入，其他事件忽略
+        if (rawStdout && (event === 'SessionStart' || event === 'UserPromptSubmit')) {
+            return { kind: 'pass', additionalContext: truncateContext(rawStdout) };
+        }
+        return { kind: 'pass' };
+    }
+    const outcome = { kind: 'pass' };
+    // 通用字段（顶层）；未识别字段（continue/stopReason/updatedInput 等）一律静默忽略
+    if (typeof parsed.systemMessage === 'string')
+        outcome.systemMessage = parsed.systemMessage;
+    if (typeof parsed.suppressOutput === 'boolean')
+        outcome.suppressOutput = parsed.suppressOutput;
+    if (parsed.decision === 'block') {
+        if (NON_BLOCKABLE_EVENTS.has(event)) {
+            (0, log_1.logWarn)(`[Hook] ${event} 不可阻断，忽略 decision: block`);
+            outcome.blockIgnored = true;
+        }
+        else {
+            outcome.kind = 'block';
+            outcome.reason = typeof parsed.reason === 'string' ? parsed.reason : `Blocked by ${event} hook`;
+        }
+    }
+    // 事件专属字段（hookSpecificOutput 壳，hookEventName 为判别字段）
+    const hso = parsed.hookSpecificOutput;
+    if (hso && typeof hso === 'object' && !Array.isArray(hso)) {
+        const shell = hso;
+        if (shell.hookEventName !== undefined && shell.hookEventName !== event) {
+            (0, log_1.logWarn)(`[Hook] hookSpecificOutput.hookEventName (${shell.hookEventName}) 与事件 ${event} 不匹配，忽略`);
+        }
+        else {
+            const pd = shell.permissionDecision;
+            if (pd !== undefined) {
+                if (pd === 'allow' || pd === 'deny' || pd === 'ask') {
+                    outcome.decision = pd;
+                    if (typeof shell.permissionDecisionReason === 'string') {
+                        outcome.reason = shell.permissionDecisionReason;
+                    }
+                }
+                else {
+                    (0, log_1.logWarn)(`[Hook] 未识别的 permissionDecision: ${pd}，忽略`);
+                }
+            }
+            if (typeof shell.additionalContext === 'string' && shell.additionalContext) {
+                outcome.additionalContext = truncateContext(shell.additionalContext);
+            }
+        }
+    }
+    return outcome;
+}
+/**
+ * additionalContext 截断（上限 10k 字符）
+ */
+function truncateContext(text) {
+    if (text.length <= exports.MAX_ADDITIONAL_CONTEXT_CHARS)
+        return text;
+    (0, log_1.logWarn)(`[Hook] additionalContext 超出 ${exports.MAX_ADDITIONAL_CONTEXT_CHARS} 字符上限，已截断`);
+    return text.slice(0, exports.MAX_ADDITIONAL_CONTEXT_CHARS);
+}
+//# sourceMappingURL=hookRunner.js.map

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

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

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

@@ -0,0 +1,65 @@
+/**
+ * Hook 埋点入口
+ *
+ * 核心链路仅 import 本模块。埋点稳定性硬约束：
+ * ① 无匹配条目零开销早退；② 整体 try/catch fail-open，
+ * 内部任何错误只记日志不上抛——未配置 hooks 的现有用户零影响。
+ */
+/**
+ * SessionStart：engine session 初始化成功后触发；不可阻断
+ * @returns 注入模型上下文的 additionalContext，无则 null
+ */
+export declare function fireSessionStart(sessionId: string): Promise<string | null>;
+/**
+ * UserPromptSubmit：用户输入进入命令处理或模型处理前触发
+ * block → 丢弃本次输入（原因经 hook:notice 展示给用户，由调用方发出）
+ */
+export declare function fireUserPromptSubmit(sessionId: string, prompt: string, signal?: AbortSignal): Promise<{
+    blocked: boolean;
+    reason?: string;
+    additionalContext?: string;
+    ran: boolean;
+}>;
+/**
+ * PreToolUse：工具执行前触发
+ * deny → 工具不执行，原因以 is_error tool_result 回给模型（exit 2 等价 deny）
+ * allow → 跳过权限询问直接执行；ask/无输出 → 走原权限流程
+ */
+export declare function firePreToolUse(sessionId: string, agentId: string, semaToolName: string, input: unknown, signal?: AbortSignal): Promise<{
+    decision: 'allow' | 'deny' | 'none';
+    reason?: string;
+    ran: boolean;
+}>;
+/**
+ * PostToolUse：工具执行成功后触发
+ * @returns contextBlocks 注入模型上下文的文本块（exit 2 的 stderr 与 additionalContext）
+ */
+export declare function firePostToolUse(sessionId: string, agentId: string, semaToolName: string, input: unknown, response: unknown, signal?: AbortSignal): Promise<{
+    contextBlocks: string[];
+}>;
+/**
+ * PostToolUseFailure：工具执行抛错后触发（可注入纠错提示）
+ */
+export declare function firePostToolUseFailure(sessionId: string, agentId: string, semaToolName: string, input: unknown, error: string, signal?: AbortSignal): Promise<{
+    contextBlocks: string[];
+}>;
+/**
+ * PermissionRequest：权限系统即将向用户发起询问前触发
+ * allow → 批准（等价用户 agree，不产生永久授权）；deny → 拒绝（exit 2 等价 deny）；
+ * ask/无输出 → 保持正常询问流程
+ */
+export declare function firePermissionRequest(sessionId: string, agentId: string, semaToolName: string, input: unknown, signal?: AbortSignal): Promise<{
+    decision: 'allow' | 'deny' | 'none';
+    reason?: string;
+}>;
+/**
+ * Stop：主链路一轮处理自然完成并转入 idle 时触发，fire-and-forget（观察型埋点）。
+ * 不可阻断（暂不支持续驱，block 输出忽略并告警）、不注入上下文；
+ * systemMessage 照常经 hook:notice 展示。中断的轮次与排队输入接续的轮次不触发。
+ */
+export declare function fireStop(sessionId: string): void;
+/**
+ * SessionEnd：会话关闭时触发，fire-and-forget（不可阻断，输出忽略）
+ */
+export declare function fireSessionEnd(sessionId: string): void;
+//# sourceMappingURL=hookTriggers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hookTriggers.d.ts","sourceRoot":"","sources":["../../../src/services/hooks/hookTriggers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAmMH;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAWhF;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,OAAO,CAAA;CAAE,CAAC,CAoB1F;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAClC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,OAAO,EACd,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC;IAAE,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,OAAO,CAAA;CAAE,CAAC,CAWjF;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACnC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,OAAO,EACjB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC;IAAE,aAAa,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAUtC;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC;IAAE,aAAa,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAStC;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CACzC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,OAAO,EACd,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC;IAAE,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAWnE;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAYhD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAiBtD"}

package/dist/services/hooks/hookTriggers.js

@@ -0,0 +1,295 @@
+"use strict";
+/**
+ * Hook 埋点入口
+ *
+ * 核心链路仅 import 本模块。埋点稳定性硬约束：
+ * ① 无匹配条目零开销早退；② 整体 try/catch fail-open，
+ * 内部任何错误只记日志不上抛——未配置 hooks 的现有用户零影响。
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fireSessionStart = fireSessionStart;
+exports.fireUserPromptSubmit = fireUserPromptSubmit;
+exports.firePreToolUse = firePreToolUse;
+exports.firePostToolUse = firePostToolUse;
+exports.firePostToolUseFailure = firePostToolUseFailure;
+exports.firePermissionRequest = firePermissionRequest;
+exports.fireStop = fireStop;
+exports.fireSessionEnd = fireSessionEnd;
+const EventSystem_1 = require("../../events/EventSystem");
+const toolAliases_1 = require("../../prompt/toolAliases");
+const cwd_1 = require("../../util/cwd");
+const log_1 = require("../../util/log");
+const hooksManager_1 = require("./hooksManager");
+const hookRunner_1 = require("./hookRunner");
+const MAIN_AGENT = 'main';
+function neutralAggregate() {
+    return { ran: false, blocked: false, decision: 'none', additionalContext: [] };
+}
+/**
+ * fail-open 总兜底：入口全部逻辑（含单例获取、开关读取）都在其中执行，
+ * 任何异常只记日志并返回中性结果，绝不上抛到核心链路
+ */
+async function safeRun(neutral, fn) {
+    try {
+        return await fn();
+    }
+    catch (error) {
+        (0, log_1.logWarn)(`[Hook] 内部错误(fail-open): ${error}`);
+        return neutral;
+    }
+}
+function emitNotice(sessionId, data) {
+    (0, EventSystem_1.getEventBus)().emit('hook:notice', data, sessionId);
+}
+/**
+ * 顺序执行单个事件下的全部命中条目并聚合结果
+ * - 第一个阻断（block / deny）立即停止后续条目
+ * - 聚合优先级：deny > ask > allow > none（ask 保守优先于 allow）
+ */
+async function runEventHooks(event, sessionId, payload, entries, signal) {
+    const aggregate = { ran: true, blocked: false, decision: 'none', additionalContext: [] };
+    const payloadJson = JSON.stringify(payload);
+    for (const entry of entries) {
+        // 中断后短路剩余条目，避免逐个 spawn 出立即被 kill 的进程
+        if (signal?.aborted)
+            break;
+        const exec = await (0, hookRunner_1.executeHookCommand)(entry.command, payloadJson, entry.timeoutMs, signal);
+        const outcome = (0, hookRunner_1.parseHookOutput)(event, exec);
+        // 审计日志（PreToolUse / PermissionRequest 的 allow 等于把权限决策交给 hook 脚本，日志不可省）
+        (0, log_1.logInfo)(`[Hook][audit] event=${event} agent=${String(payload.agent_id ?? MAIN_AGENT)} ` +
+            `source=${entry.source} command="${entry.command}" timeoutMs=${entry.timeoutMs} ` +
+            `exit=${exec.exitCode} timedOut=${exec.timedOut} kind=${outcome.kind} ` +
+            `decision=${outcome.decision ?? '-'} duration=${exec.durationMs}ms`);
+        if (exec.timedOut) {
+            emitNotice(sessionId, {
+                kind: 'warning',
+                hookEvent: event,
+                message: `hook 执行超时（${entry.timeoutMs / 1000}s）已终止: ${entry.command}`,
+                command: entry.command,
+                source: entry.source,
+            });
+        }
+        // 不可阻断事件上的 block 输出被忽略：告警而非静默，
+        // 避免用户从其他工具迁移来的续驱配置（Stop + exit 2）看似生效实则无效
+        if (outcome.blockIgnored) {
+            emitNotice(sessionId, {
+                kind: 'warning',
+                hookEvent: event,
+                message: `${event} 事件不支持阻断，hook 的 block 输出已忽略: ${entry.command}`,
+                command: entry.command,
+                source: entry.source,
+            });
+        }
+        if (outcome.systemMessage) {
+            emitNotice(sessionId, {
+                kind: 'systemMessage',
+                hookEvent: event,
+                message: outcome.systemMessage,
+                command: entry.command,
+                source: entry.source,
+            });
+        }
+        if (outcome.additionalContext) {
+            aggregate.additionalContext.push(outcome.additionalContext);
+        }
+        // fail-closed 条目：hook 执行失败按阻断处理
+        const effectiveKind = outcome.kind === 'error' && entry.failClosed ? 'block' : outcome.kind;
+        if (effectiveKind === 'block') {
+            aggregate.blocked = true;
+            aggregate.blockReason =
+                outcome.kind === 'error'
+                    ? `hook failed (fail-closed): ${entry.command}`
+                    : outcome.reason;
+            break;
+        }
+        if (outcome.decision === 'deny') {
+            aggregate.decision = 'deny';
+            aggregate.decisionReason = outcome.reason;
+            break;
+        }
+        if (outcome.decision === 'ask') {
+            aggregate.decision = 'ask';
+            if (outcome.reason)
+                aggregate.decisionReason = outcome.reason;
+        }
+        else if (outcome.decision === 'allow' && aggregate.decision === 'none') {
+            aggregate.decision = 'allow';
+            if (outcome.reason)
+                aggregate.decisionReason = outcome.reason;
+        }
+    }
+    // 聚合后总量再做一次截断
+    const total = aggregate.additionalContext.join('\n\n');
+    if (total.length > hookRunner_1.MAX_ADDITIONAL_CONTEXT_CHARS) {
+        aggregate.additionalContext = [(0, hookRunner_1.truncateContext)(total)];
+    }
+    return aggregate;
+}
+function buildCommonPayload(event, sessionId, agentId) {
+    return {
+        session_id: sessionId,
+        cwd: (0, cwd_1.readInitialCwd)(),
+        hook_event_name: event,
+        agent_id: agentId,
+    };
+}
+/**
+ * 工具类事件的统一触发（PreToolUse / PostToolUse / PostToolUseFailure / PermissionRequest）
+ */
+async function runToolEventHooks(event, sessionId, agentId, semaToolName, extraPayload, signal) {
+    // ran 在 safeRun 外持有：条目进入执行链路后即置位，
+    // 后续执行失败/被中断（fail-open 返回中性结果）时 ran 仍为 true
+    let ran = false;
+    const result = await safeRun(neutralAggregate(), async () => {
+        const manager = (0, hooksManager_1.getHooksManager)();
+        await manager.ready();
+        const genericToolName = (0, toolAliases_1.toGenericToolName)(semaToolName);
+        const entries = manager.getMatchedEntries(event, genericToolName, semaToolName);
+        if (entries.length === 0)
+            return neutralAggregate();
+        ran = true;
+        const payload = {
+            ...buildCommonPayload(event, sessionId, agentId),
+            tool_name: genericToolName,
+            sema_tool_name: semaToolName,
+            ...extraPayload,
+        };
+        return runEventHooks(event, sessionId, payload, entries, signal);
+    });
+    return { ...result, ran };
+}
+// ==================== 8 个事件入口 ====================
+/**
+ * SessionStart：engine session 初始化成功后触发；不可阻断
+ * @returns 注入模型上下文的 additionalContext，无则 null
+ */
+async function fireSessionStart(sessionId) {
+    return safeRun(null, async () => {
+        const manager = (0, hooksManager_1.getHooksManager)();
+        await manager.ready();
+        const entries = manager.getMatchedEntries('SessionStart');
+        if (entries.length === 0)
+            return null;
+        const payload = { ...buildCommonPayload('SessionStart', sessionId, MAIN_AGENT), source: 'startup' };
+        const aggregate = await runEventHooks('SessionStart', sessionId, payload, entries);
+        return aggregate.additionalContext.length > 0 ? aggregate.additionalContext.join('\n\n') : null;
+    });
+}
+/**
+ * UserPromptSubmit：用户输入进入命令处理或模型处理前触发
+ * block → 丢弃本次输入（原因经 hook:notice 展示给用户，由调用方发出）
+ */
+async function fireUserPromptSubmit(sessionId, prompt, signal) {
+    const neutral = { blocked: false };
+    let ran = false;
+    const result = await safeRun(neutral, async () => {
+        const manager = (0, hooksManager_1.getHooksManager)();
+        await manager.ready();
+        const entries = manager.getMatchedEntries('UserPromptSubmit');
+        if (entries.length === 0)
+            return neutral;
+        ran = true;
+        const payload = { ...buildCommonPayload('UserPromptSubmit', sessionId, MAIN_AGENT), prompt };
+        const aggregate = await runEventHooks('UserPromptSubmit', sessionId, payload, entries, signal);
+        return {
+            blocked: aggregate.blocked,
+            reason: aggregate.blockReason,
+            additionalContext: aggregate.additionalContext.length > 0 ? aggregate.additionalContext.join('\n\n') : undefined,
+        };
+    });
+    return { ...result, ran };
+}
+/**
+ * PreToolUse：工具执行前触发
+ * deny → 工具不执行，原因以 is_error tool_result 回给模型（exit 2 等价 deny）
+ * allow → 跳过权限询问直接执行；ask/无输出 → 走原权限流程
+ */
+async function firePreToolUse(sessionId, agentId, semaToolName, input, signal) {
+    const aggregate = await runToolEventHooks('PreToolUse', sessionId, agentId, semaToolName, { tool_input: input }, signal);
+    if (aggregate.blocked) {
+        return { decision: 'deny', reason: aggregate.blockReason, ran: aggregate.ran };
+    }
+    if (aggregate.decision === 'allow' || aggregate.decision === 'deny') {
+        return { decision: aggregate.decision, reason: aggregate.decisionReason, ran: aggregate.ran };
+    }
+    return { decision: 'none', ran: aggregate.ran };
+}
+/**
+ * PostToolUse：工具执行成功后触发
+ * @returns contextBlocks 注入模型上下文的文本块（exit 2 的 stderr 与 additionalContext）
+ */
+async function firePostToolUse(sessionId, agentId, semaToolName, input, response, signal) {
+    const aggregate = await runToolEventHooks('PostToolUse', sessionId, agentId, semaToolName, { tool_input: input, tool_response: response }, signal);
+    const contextBlocks = [...aggregate.additionalContext];
+    if (aggregate.blocked && aggregate.blockReason) {
+        // 工具已执行完，无法撤销，stderr 仅回灌模型
+        contextBlocks.push(`[PostToolUse hook] ${aggregate.blockReason}`);
+    }
+    return { contextBlocks };
+}
+/**
+ * PostToolUseFailure：工具执行抛错后触发（可注入纠错提示）
+ */
+async function firePostToolUseFailure(sessionId, agentId, semaToolName, input, error, signal) {
+    const aggregate = await runToolEventHooks('PostToolUseFailure', sessionId, agentId, semaToolName, { tool_input: input, error }, signal);
+    const contextBlocks = [...aggregate.additionalContext];
+    if (aggregate.blocked && aggregate.blockReason) {
+        contextBlocks.push(`[PostToolUseFailure hook] ${aggregate.blockReason}`);
+    }
+    return { contextBlocks };
+}
+/**
+ * PermissionRequest：权限系统即将向用户发起询问前触发
+ * allow → 批准（等价用户 agree，不产生永久授权）；deny → 拒绝（exit 2 等价 deny）；
+ * ask/无输出 → 保持正常询问流程
+ */
+async function firePermissionRequest(sessionId, agentId, semaToolName, input, signal) {
+    const aggregate = await runToolEventHooks('PermissionRequest', sessionId, agentId, semaToolName, { tool_input: input }, signal);
+    if (aggregate.blocked) {
+        return { decision: 'deny', reason: aggregate.blockReason };
+    }
+    if (aggregate.decision === 'allow' || aggregate.decision === 'deny') {
+        return { decision: aggregate.decision, reason: aggregate.decisionReason };
+    }
+    return { decision: 'none' };
+}
+/**
+ * Stop：主链路一轮处理自然完成并转入 idle 时触发，fire-and-forget（观察型埋点）。
+ * 不可阻断（暂不支持续驱，block 输出忽略并告警）、不注入上下文；
+ * systemMessage 照常经 hook:notice 展示。中断的轮次与排队输入接续的轮次不触发。
+ */
+function fireStop(sessionId) {
+    void safeRun(null, async () => {
+        const manager = (0, hooksManager_1.getHooksManager)();
+        await manager.ready();
+        const entries = manager.getMatchedEntries('Stop');
+        if (entries.length === 0)
+            return null;
+        // stop_hook_active 对齐通用 hooks 字段形状（无续驱恒为 false），方便脚本跨端复用
+        const payload = { ...buildCommonPayload('Stop', sessionId, MAIN_AGENT), stop_hook_active: false };
+        await runEventHooks('Stop', sessionId, payload, entries);
+        return null;
+    });
+}
+/**
+ * SessionEnd：会话关闭时触发，fire-and-forget（不可阻断，输出忽略）
+ */
+function fireSessionEnd(sessionId) {
+    void safeRun(null, async () => {
+        // async 函数体在首个 await 前同步执行：缓存就绪时条目在本调用返回前即被同步捕获，
+        // 不受 SemaCore.dispose 同步链路随后清空 hooksManager 缓存的影响（捕获的是过滤后的新数组）。
+        // 缓存未就绪（会话刚创建即销毁的窄窗口）走异步加载兜底，此时仍可能因 dispose 竞态跳过——
+        // SessionEnd 本为 best-effort（宿主进程随即退出也可能截断 hook 执行），该残余可接受
+        const manager = (0, hooksManager_1.getHooksManager)();
+        if (!manager.isReady()) {
+            await manager.ready();
+        }
+        const entries = manager.getMatchedEntries('SessionEnd');
+        if (entries.length === 0)
+            return null;
+        const payload = { ...buildCommonPayload('SessionEnd', sessionId, MAIN_AGENT), reason: 'dispose' };
+        await runEventHooks('SessionEnd', sessionId, payload, entries);
+        return null;
+    });
+}
+//# sourceMappingURL=hookTriggers.js.map

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