@lingxiao-office/sdk 1.0.0

package/dist/core/hooks/executor.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Hook 执行器
+ *
+ * 当前仅 executeStop / executePreCompact / executePostCompact 有外部消费者。
+ * 其余 hook 类型保留类型定义（types.ts），但不预建 execute* 包装——
+ * 需要时按实际需求添加。
+ */
+import { AggregatedHookResult, HookEvent, HookInput } from './types.js';
+/**
+ * Hook 执行器
+ */
+export declare class HookExecutor {
+    private registry;
+    /**
+     * 执行所有匹配的 Hook
+     */
+    execute(event: HookEvent, input: HookInput, toolName?: string): Promise<AggregatedHookResult>;
+    /**
+     * 执行单个 Hook
+     */
+    private executeSingle;
+    /**
+     * 执行函数 Hook
+     */
+    private executeFunction;
+    /**
+     * 执行命令 Hook
+     */
+    private executeCommand;
+    /**
+     * 将 HookInput 转换为字典
+     */
+    private inputToDict;
+}
+/**
+ * 通用 Hook 执行入口
+ */
+export declare function executeHooks(event: HookEvent, sessionId: string, toolName?: string, partial?: Partial<HookInput>): Promise<AggregatedHookResult>;
+/**
+ * 执行 Stop Hook
+ */
+export declare function executeStop(sessionId: string, reason?: string): Promise<AggregatedHookResult>;
+/**
+ * 执行 PreCompact Hook
+ */
+export declare function executePreCompact(sessionId: string, compactType?: string): Promise<AggregatedHookResult>;
+/**
+ * 执行 PostCompact Hook
+ */
+export declare function executePostCompact(sessionId: string, compactType?: string, tokensSaved?: number, summary?: string): Promise<AggregatedHookResult>;
+//# sourceMappingURL=executor.d.ts.map

package/dist/core/hooks/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../../src/core/hooks/executor.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EACL,oBAAoB,EAGpB,SAAS,EACT,SAAS,EAIV,MAAM,YAAY,CAAC;AAsBpB;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAqB;IAErC;;OAEG;IACG,OAAO,CACX,KAAK,EAAE,SAAS,EAChB,KAAK,EAAE,SAAS,EAChB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,oBAAoB,CAAC;IAuDhC;;OAEG;YACW,aAAa;IAqD3B;;OAEG;YACW,eAAe;IA+B7B;;OAEG;YACW,cAAc;IAsG5B;;OAEG;IACH,OAAO,CAAC,WAAW;CAwBpB;AAID;;GAEG;AACH,wBAAsB,YAAY,CAChC,KAAK,EAAE,SAAS,EAChB,SAAS,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,GAC3B,OAAO,CAAC,oBAAoB,CAAC,CAU/B;AAED;;GAEG;AACH,wBAAsB,WAAW,CAC/B,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,oBAAoB,CAAC,CAI/B;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,MAAM,EACjB,WAAW,SAAS,GACnB,OAAO,CAAC,oBAAoB,CAAC,CAI/B;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,MAAM,EACjB,WAAW,SAAS,EACpB,WAAW,CAAC,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,oBAAoB,CAAC,CAM/B"}

package/dist/core/hooks/executor.js

@@ -0,0 +1,317 @@
+/**
+ * Hook 执行器
+ *
+ * 当前仅 executeStop / executePreCompact / executePostCompact 有外部消费者。
+ * 其余 hook 类型保留类型定义（types.ts），但不预建 execute* 包装——
+ * 需要时按实际需求添加。
+ */
+import { spawn } from 'child_process';
+import { HookEvent, } from './types.js';
+import { getHookRegistry } from './registry.js';
+/**
+ * command hook 执行失败（非零退出或被信号杀死）时抛出。
+ * - block=true 表示这是 hook 主动 deny（正常非零退出），应阻止后续操作；
+ * - signal 非空表示进程被信号杀死（如超时 SIGTERM），属基础设施失败而非主动 deny。
+ */
+class HookCommandError extends Error {
+    stderr;
+    exitCode;
+    signal;
+    block;
+    blockReason;
+    constructor(message, stderr, exitCode, signal, block, blockReason) {
+        super(message);
+        this.stderr = stderr;
+        this.exitCode = exitCode;
+        this.signal = signal;
+        this.block = block;
+        this.blockReason = blockReason;
+        this.name = 'HookCommandError';
+    }
+}
+/**
+ * Hook 执行器
+ */
+export class HookExecutor {
+    registry = getHookRegistry();
+    /**
+     * 执行所有匹配的 Hook
+     */
+    async execute(event, input, toolName) {
+        const hooks = this.registry.getHooksForEvent(event, toolName);
+        if (!hooks.length) {
+            return {
+                results: [],
+                blocked: false,
+                system_messages: [],
+            };
+        }
+        const results = [];
+        let blocked = false;
+        let blockReason;
+        let modifiedInput;
+        const systemMessages = [];
+        for (const hook of hooks) {
+            if (blocked)
+                break;
+            const result = await this.executeSingle(hook, input);
+            results.push(result);
+            // 命令 hook 非零退出会返回 success:false + output.block（deny 语义），
+            // 因此 block 判定不能要求 success，否则 hook 的 block/deny 失效。
+            if (result.output) {
+                const output = result.output;
+                if (output.block) {
+                    blocked = true;
+                    blockReason = output.block_reason;
+                }
+                if (result.success) {
+                    if (output.modified_input) {
+                        modifiedInput = output.modified_input;
+                        input.tool_input = modifiedInput;
+                    }
+                    if (output.system_message) {
+                        systemMessages.push(output.system_message);
+                    }
+                }
+            }
+        }
+        return {
+            results,
+            blocked,
+            block_reason: blockReason,
+            modified_input: modifiedInput,
+            system_messages: systemMessages,
+        };
+    }
+    /**
+     * 执行单个 Hook
+     */
+    async executeSingle(hook, input) {
+        const hookId = `${hook.matcher.event}:${hook.hook.type}`;
+        const startTime = Date.now();
+        try {
+            let output;
+            if (hook.hook.type === 'function') {
+                output = await this.executeFunction(hook.hook, input);
+            }
+            else if (hook.hook.type === 'command') {
+                output = await this.executeCommand(hook.hook, input);
+            }
+            else {
+                const unknownHook = hook.hook;
+                return {
+                    hook_id: hookId,
+                    success: false,
+                    error: `Unknown hook type: ${unknownHook.type}`,
+                    duration_ms: Date.now() - startTime,
+                };
+            }
+            return {
+                hook_id: hookId,
+                success: true,
+                output,
+                duration_ms: Date.now() - startTime,
+            };
+        }
+        catch (e) {
+            if (e instanceof HookCommandError) {
+                // 命令 hook 非零退出 → deny：附带 block 输出让聚合层阻止后续操作；
+                // 被信号杀死（超时）→ 基础设施失败，不阻止，仅记错误。
+                return {
+                    hook_id: hookId,
+                    success: false,
+                    error: e.stderr ? `${e.message}: ${e.stderr}` : e.message,
+                    output: e.block
+                        ? { block: true, block_reason: e.blockReason ?? e.message }
+                        : undefined,
+                    duration_ms: Date.now() - startTime,
+                };
+            }
+            return {
+                hook_id: hookId,
+                success: false,
+                error: String(e),
+                duration_ms: Date.now() - startTime,
+            };
+        }
+    }
+    /**
+     * 执行函数 Hook
+     */
+    async executeFunction(hook, input) {
+        if (!hook.callback)
+            return undefined;
+        // 执行回调（带超时）
+        const timeoutPromise = new Promise((_, reject) => {
+            setTimeout(() => reject(new Error('Timeout')), hook.timeout);
+        });
+        try {
+            const result = await Promise.race([
+                Promise.resolve(hook.callback(input)),
+                timeoutPromise,
+            ]);
+            // 转换结果
+            if (result === undefined || result === null) {
+                return undefined;
+            }
+            else if (typeof result === 'boolean') {
+                return { block: !result };
+            }
+            else if (typeof result === 'object' && 'block' in result) {
+                return result;
+            }
+            return undefined;
+        }
+        catch (e) {
+            throw new Error(`${hook.error_message}: ${e}`);
+        }
+    }
+    /**
+     * 执行命令 Hook
+     */
+    async executeCommand(hook, input) {
+        const env = { ...hook.env };
+        env.HOOK_EVENT = input.event;
+        env.HOOK_SESSION_ID = input.session_id;
+        if (input.tool_name) {
+            env.HOOK_TOOL_NAME = input.tool_name;
+        }
+        const stdinData = JSON.stringify(this.inputToDict(input));
+        return new Promise((resolve, reject) => {
+            const proc = spawn(hook.command, [], {
+                shell: true,
+                env: { ...process.env, ...env },
+                timeout: hook.timeout,
+            });
+            let stdout = '';
+            let stderr = '';
+            proc.stdout.on('data', data => {
+                stdout += data.toString();
+            });
+            proc.stderr.on('data', data => {
+                stderr += data.toString();
+            });
+            proc.on('error', err => {
+                reject(new Error(`Command execution failed: ${err.message}`));
+            });
+            proc.on('close', (code, signal) => {
+                // 被信号杀死（含 timeout 触发的 SIGTERM）：基础设施失败，不是 hook 主动 deny
+                if (signal) {
+                    reject(new HookCommandError(`Command hook killed by signal ${signal}` +
+                        (signal === 'SIGTERM' ? ` (likely timeout after ${hook.timeout}ms)` : ''), stderr.trim(), code, signal, false));
+                    return;
+                }
+                // 非零退出码：hook 主动 deny/block，必须让 block 语义生效而非被当成成功
+                if (code !== 0 && code !== null) {
+                    // 退出码非零时优先解析 stdout 里的结构化 block 输出，缺省则按 deny 处理
+                    let blockReason = stderr.trim() || `Command hook exited with code ${code}`;
+                    if (stdout) {
+                        try {
+                            const parsed = JSON.parse(stdout);
+                            if (parsed.block_reason)
+                                blockReason = parsed.block_reason;
+                        }
+                        catch { /* swallowed: unhandled error */
+                            if (stdout.trim())
+                                blockReason = stdout.trim();
+                        }
+                    }
+                    reject(new HookCommandError(`Command hook exited with non-zero code ${code}`, stderr.trim(), code, null, true, blockReason));
+                    return;
+                }
+                if (stdout) {
+                    try {
+                        const output = JSON.parse(stdout);
+                        resolve(output);
+                    }
+                    catch { /* swallowed: unhandled error */
+                        resolve({ system_message: stdout.trim() });
+                    }
+                }
+                else {
+                    resolve(undefined);
+                }
+            });
+            // 发送 stdin。子进程可能在写入前就退出（如 `exit 0`），stdin 已关闭会抛 EPIPE，
+            // 这里吞掉写错误：退出码/输出由 close 事件负责，stdin 写失败不应让整个 hook 崩溃。
+            proc.stdin?.on('error', () => {
+                /* 子进程提前退出导致的 EPIPE/ECONNRESET，忽略 */
+            });
+            try {
+                proc.stdin?.write(stdinData);
+                proc.stdin?.end();
+            }
+            catch {
+                /* 同步写抛错同样忽略 */
+            }
+        });
+    }
+    /**
+     * 将 HookInput 转换为字典
+     */
+    inputToDict(input) {
+        return {
+            event: input.event,
+            session_id: input.session_id,
+            timestamp: input.timestamp,
+            tool_name: input.tool_name,
+            tool_input: input.tool_input,
+            tool_use_id: input.tool_use_id,
+            tool_result: input.tool_result,
+            error: input.error,
+            agent_id: input.agent_id,
+            agent_name: input.agent_name,
+            task_id: input.task_id,
+            task_subject: input.task_subject,
+            permission_suggestions: input.permission_suggestions,
+            decision: input.decision,
+            compact_type: input.compact_type,
+            tokens_saved: input.tokens_saved,
+            summary: input.summary,
+            old_value: input.old_value,
+            new_value: input.new_value,
+            user_message: input.user_message,
+        };
+    }
+}
+// ─── 便捷函数（仅保留有外部消费者的） ────────────────────────────────────────
+/**
+ * 通用 Hook 执行入口
+ */
+export async function executeHooks(event, sessionId, toolName, partial) {
+    const input = {
+        event,
+        session_id: sessionId,
+        timestamp: Date.now(),
+        ...partial,
+    };
+    const executor = new HookExecutor();
+    return executor.execute(event, input, toolName);
+}
+/**
+ * 执行 Stop Hook
+ */
+export async function executeStop(sessionId, reason) {
+    return executeHooks(HookEvent.STOP, sessionId, undefined, {
+        user_message: reason,
+    });
+}
+/**
+ * 执行 PreCompact Hook
+ */
+export async function executePreCompact(sessionId, compactType = 'auto') {
+    return executeHooks(HookEvent.PRE_COMPACT, sessionId, undefined, {
+        compact_type: compactType,
+    });
+}
+/**
+ * 执行 PostCompact Hook
+ */
+export async function executePostCompact(sessionId, compactType = 'auto', tokensSaved, summary) {
+    return executeHooks(HookEvent.POST_COMPACT, sessionId, undefined, {
+        compact_type: compactType,
+        tokens_saved: tokensSaved,
+        summary: summary,
+    });
+}
+//# sourceMappingURL=executor.js.map

package/dist/core/hooks/executor.js.map

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

package/dist/core/hooks/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Hook 生命周期系统
+ */
+export { HookExecutor, executeHooks, executeStop, executePreCompact, executePostCompact, } from './executor.js';
+export { HookRegistry, getHookRegistry, resetHookRegistry, } from './registry.js';
+export { SessionHookManager, addSessionFunctionHook, clearAllSessionHooks, getSessionHookManager, removeSessionFunctionHook, } from './session_hooks.js';
+export type { AggregatedHookResult, FunctionHook, HookCallback, HookCommand, HookDefinition, HookInput, HookMatcher, HookOutput, HookResult, RegisteredHook, } from './types.js';
+export { HOOK_EVENTS, HookEvent, createHookInput, createHookOutput, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/hooks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/hooks/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,YAAY,EACZ,eAAe,EACf,iBAAiB,GAClB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,oBAAoB,EACpB,qBAAqB,EACrB,yBAAyB,GAC1B,MAAM,oBAAoB,CAAC;AAG5B,YAAY,EACV,oBAAoB,EACpB,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,cAAc,EACd,SAAS,EACT,WAAW,EACX,UAAU,EACV,UAAU,EACV,cAAc,GACf,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,WAAW,EACX,SAAS,EACT,eAAe,EACf,gBAAgB,GACjB,MAAM,YAAY,CAAC"}

package/dist/core/hooks/index.js

@@ -0,0 +1,12 @@
+/**
+ * Hook 生命周期系统
+ */
+// 执行器导出
+export { HookExecutor, executeHooks, executeStop, executePreCompact, executePostCompact, } from './executor.js';
+// 注册表导出
+export { HookRegistry, getHookRegistry, resetHookRegistry, } from './registry.js';
+// 会话级 Hook 导出
+export { SessionHookManager, addSessionFunctionHook, clearAllSessionHooks, getSessionHookManager, removeSessionFunctionHook, } from './session_hooks.js';
+// 运行时导出
+export { HOOK_EVENTS, HookEvent, createHookInput, createHookOutput, } from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/core/hooks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/hooks/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,QAAQ;AACR,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,eAAe,CAAC;AAEvB,QAAQ;AACR,OAAO,EACL,YAAY,EACZ,eAAe,EACf,iBAAiB,GAClB,MAAM,eAAe,CAAC;AAEvB,cAAc;AACd,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,oBAAoB,EACpB,qBAAqB,EACrB,yBAAyB,GAC1B,MAAM,oBAAoB,CAAC;AAgB5B,QAAQ;AACR,OAAO,EACL,WAAW,EACX,SAAS,EACT,eAAe,EACf,gBAAgB,GACjB,MAAM,YAAY,CAAC"}

package/dist/core/hooks/registry.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Hook 注册表
+ */
+import { HookCallback, HookDefinition, HookEvent, RegisteredHook } from './types.js';
+/**
+ * Hook 注册表
+ */
+export declare class HookRegistry {
+    private hooks;
+    private byId;
+    private sessionHooks;
+    private disabled;
+    constructor();
+    /**
+     * 注册一个 Hook
+     */
+    register(event: HookEvent, hook: HookDefinition, matcher?: string, priority?: number, source?: string, hookId?: string): string;
+    /**
+     * 注册一个函数 Hook
+     */
+    registerFunction(event: HookEvent, callback: HookCallback, matcher?: string, priority?: number, timeout?: number, errorMessage?: string): string;
+    /**
+     * 注册一个命令 Hook
+     */
+    registerCommand(event: HookEvent, command: string, matcher?: string, priority?: number, timeout?: number, env?: Record<string, string>): string;
+    /**
+     * 注销一个 Hook
+     */
+    unregister(hookId: string): boolean;
+    /**
+     * 启用 Hook
+     */
+    enable(hookId: string): boolean;
+    /**
+     * 禁用 Hook
+     */
+    disable(hookId: string): boolean;
+    /**
+     * 获取匹配特定事件和工具的 Hook 列表
+     */
+    getHooksForEvent(event: HookEvent, toolName?: string): RegisteredHook[];
+    /**
+     * 检查工具名是否匹配模式
+     */
+    private matchTool;
+    /**
+     * 将 Hook 标记为会话级
+     */
+    registerSessionHook(sessionId: string, hookId: string): void;
+    /**
+     * 清理会话的所有 Hook
+     */
+    clearSessionHooks(sessionId: string): number;
+    /**
+     * 清空所有 Hook
+     */
+    clearAll(): number;
+    /**
+     * 列出 Hook
+     */
+    listHooks(event?: HookEvent, source?: string): Record<string, unknown>[];
+}
+/**
+ * 获取全局 Hook 注册表
+ */
+export declare function getHookRegistry(): HookRegistry;
+/**
+ * 重置全局 Hook 注册表
+ */
+export declare function resetHookRegistry(): void;
+//# sourceMappingURL=registry.d.ts.map

package/dist/core/hooks/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/core/hooks/registry.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAEL,YAAY,EAEZ,cAAc,EACd,SAAS,EAET,cAAc,EACf,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAA+C;IAC5D,OAAO,CAAC,IAAI,CAA0C;IACtD,OAAO,CAAC,YAAY,CAAuC;IAC3D,OAAO,CAAC,QAAQ,CAA0B;;IAS1C;;OAEG;IACH,QAAQ,CACN,KAAK,EAAE,SAAS,EAChB,IAAI,EAAE,cAAc,EACpB,OAAO,SAAM,EACb,QAAQ,SAAI,EACZ,MAAM,SAAS,EACf,MAAM,CAAC,EAAE,MAAM,GACd,MAAM;IAqBT;;OAEG;IACH,gBAAgB,CACd,KAAK,EAAE,SAAS,EAChB,QAAQ,EAAE,YAAY,EACtB,OAAO,SAAM,EACb,QAAQ,SAAI,EACZ,OAAO,SAAO,EACd,YAAY,SAA0B,GACrC,MAAM;IAUT;;OAEG;IACH,eAAe,CACb,KAAK,EAAE,SAAS,EAChB,OAAO,EAAE,MAAM,EACf,OAAO,SAAM,EACb,QAAQ,SAAI,EACZ,OAAO,SAAQ,EACf,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GAC/B,MAAM;IAUT;;OAEG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAqBnC;;OAEG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAU/B;;OAEG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAUhC;;OAEG;IACH,gBAAgB,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,cAAc,EAAE;IAcvE;;OAEG;IACH,OAAO,CAAC,SAAS;IAmBjB;;OAEG;IACH,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAO5D;;OAEG;IACH,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAe5C;;OAEG;IACH,QAAQ,IAAI,MAAM;IAWlB;;OAEG;IACH,SAAS,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE;CAiCzE;AAKD;;GAEG;AACH,wBAAgB,eAAe,IAAI,YAAY,CAK9C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAKxC"}