@zooique/memora 0.1.0

package/dist/agent/messageHistory.js

@@ -0,0 +1,288 @@
+import { logger } from '../logging/logger.js';
+import { configError } from '../utils/errors.js';
+import { nowIso, todayDate } from '../utils/time.js';
+/**
+ * 消息历史类
+ */
+export class MessageHistory {
+    sessionStore;
+    minWindowRounds;
+    /** 当前日期 YYYY-MM-DD */
+    currentDate;
+    /** 当前会话标识（不含日期前缀） */
+    currentSession;
+    /**
+     * 挂起的归档企划集合，Agent.close() 等待它们完成
+     * 容纳 Promise<void>（fire-and-forget 内部）
+     */
+    pendingArchives = new Set();
+    constructor(
+    /**
+     * 会话存储（可选）
+     * 注入后，消息会持久化到宿主提供的存储实现。
+     * 不注入则仅在内存中保存（AgentLoop.messages[]）。
+     */
+    sessionStore, 
+    /**
+     * 临时记忆最小窗口轮次（记忆减法方案 v1.0 · 排雷修正 L2）
+     *
+     * 上下文压缩时，最少保留的对话轮次。即使上下文利用率 ≥ 85%，
+     * 也不压缩到少于此轮次，保证基本上下文连贯性。
+     * 默认 3 轮，不可在运行时突破。
+     */
+    minWindowRounds = 3, initialDate, initialSession = 'main') {
+        this.sessionStore = sessionStore;
+        this.minWindowRounds = minWindowRounds;
+        this.currentDate = initialDate ?? todayDate();
+        this.currentSession = initialSession;
+    }
+    /**
+     * 获取当前会话名（日期-会话组合名）
+     */
+    get currentSessionName() {
+        return `${this.currentDate}-${this.currentSession}`;
+    }
+    /** 获取当前日期 YYYY-MM-DD（只读，供 agent 层使用） */
+    get currentDateValue() {
+        return this.currentDate;
+    }
+    /** 获取当前会话标识（只读，供 agent 层使用） */
+    get currentSessionValue() {
+        return this.currentSession;
+    }
+    /**
+     * 获取当前会话标识
+     */
+    get session() {
+        return this.currentSession;
+    }
+    /**
+     * 获取最小窗口轮次（记忆减法方案 v1.0）
+     * 上下文压缩时的下限保护
+     */
+    get minWindowRoundsValue() {
+        return this.minWindowRounds;
+    }
+    /**
+     * 切换会话
+     * @param newSession - 新会话标识
+     * @returns 新会话的全名
+     */
+    switchSession(newSession) {
+        this.currentSession = newSession;
+        return this.currentSessionName;
+    }
+    /**
+     * 自动生成分支名
+     *
+     * 算法：扫描已存在会话，找到以 sourceSession-b 为前缀的最大序号，+1
+     *
+     * @param sourceSession - 源会话标识
+     * @returns 自动生成的分支名（如 "main-b1"）
+     */
+    autoBranchName(sourceSession) {
+        if (!this.sessionStore)
+            return `${sourceSession}-b1`;
+        const allSessions = this.sessionStore.listSessions();
+        const prefix = `${sourceSession}-b`;
+        // 提取匹配前缀的序号
+        const existingNumbers = [];
+        for (const fullSession of allSessions) {
+            // fullSession 格式：YYYY-MM-DD-session
+            const parts = fullSession.split('-');
+            if (parts.length >= 4) {
+                const sessionPart = parts.slice(3).join('-');
+                if (sessionPart.startsWith(prefix)) {
+                    const numStr = sessionPart.slice(prefix.length);
+                    const num = parseInt(numStr, 10);
+                    if (!isNaN(num)) {
+                        existingNumbers.push(num);
+                    }
+                }
+            }
+        }
+        const nextNumber = existingNumbers.length > 0 ? Math.max(...existingNumbers) + 1 : 1;
+        return `${prefix}${nextNumber}`;
+    }
+    /**
+     * 分叉当前会话
+     *
+     * 流程：
+     * 1. 从 sessionStore 加载当前会话全部消息
+     * 2. 生成唯一新会话名
+     * 3. 通过 sessionStore.copySession() 复制到新会话
+     * 4. switchSession() 切换当前会话标识到新会话
+     *
+     * @param targetSession - 自定义目标会话名（可选，不传则自动生成）
+     * @returns 分叉结果
+     * @throws 若 sessionStore 未注入、copySession 未实现或当前会话无消息
+     */
+    forkSession(targetSession) {
+        if (!this.sessionStore) {
+            throw configError('无法分叉会话', 'ISessionStore 未注入', [
+                '在创建 Agent 时注入 sessionStore 参数',
+            ]);
+        }
+        if (!this.sessionStore.copySession) {
+            throw configError('无法分叉会话', 'ISessionStore.copySession 未实现', [
+                '升级宿主项目的 ISessionStore 实现，添加 copySession() 方法',
+            ]);
+        }
+        const sourceDate = this.currentDate;
+        const sourceSession = this.currentSession;
+        // 加载源会话消息
+        const messages = this.sessionStore.loadMessages(sourceDate, sourceSession);
+        if (messages.length === 0) {
+            throw configError('无法分叉会话', '当前会话无消息', ['先进行一些对话后再尝试分叉']);
+        }
+        // 生成目标会话名
+        let newSession;
+        if (targetSession) {
+            // 检查目标会话在当天是否已存在
+            const targetFullName = `${todayDate()}-${targetSession}`;
+            const existingSessions = this.sessionStore.listSessions();
+            if (existingSessions.includes(targetFullName)) {
+                throw configError('无法分叉会话', `当天会话 "${targetSession}" 已存在`, [
+                    '使用不同的名称，或不传参数自动生成',
+                ]);
+            }
+            newSession = targetSession;
+        }
+        else {
+            newSession = this.autoBranchName(sourceSession);
+        }
+        // 计算目标日期
+        const targetDate = todayDate();
+        // 原子复制消息
+        this.sessionStore.copySession(sourceDate, sourceSession, targetDate, newSession);
+        // 切换当前会话到新分支
+        this.switchSession(newSession);
+        logger.info({ from: sourceSession, to: newSession, messageCount: messages.length }, '会话分叉完成');
+        return { newSession, date: targetDate, messages };
+    }
+    /**
+     * 追加 user 消息到当前会话
+     * 失败不抛出（消息持久化失败不应阻塞对话）
+     *
+     * 日期使用 todayDate() 动态获取，而非缓存的 this.currentDate，
+     * 确保跨日后消息写入当天目录。
+     */
+    async appendUser(content) {
+        const message = {
+            role: 'user',
+            content,
+            timestamp: nowIso(),
+        };
+        // 使用 ISessionStore 持久化（如果已注入）
+        if (this.sessionStore) {
+            try {
+                // 动态获取当天日期，避免跨日后写入旧日期目录
+                this.sessionStore.appendMessage(todayDate(), this.currentSession, message);
+            }
+            catch (err) {
+                logger.warn({ err, session: this.currentSessionName }, 'appendUser: 会话持久化失败');
+            }
+        }
+        logger.debug({ role: message.role, session: this.currentSessionName }, 'appendUser');
+    }
+    /**
+     * 追加 assistant 消息到当前会话
+     * 失败不抛出
+     *
+     * 日期使用 todayDate() 动态获取，确保跨日后消息写入当天目录。
+     */
+    async appendAssistant(content) {
+        if (!content.trim())
+            return;
+        const message = {
+            role: 'assistant',
+            content,
+            timestamp: nowIso(),
+        };
+        // 使用 ISessionStore 持久化（如果已注入）
+        if (this.sessionStore) {
+            try {
+                // 动态获取当天日期，避免跨日后写入旧日期目录
+                this.sessionStore.appendMessage(todayDate(), this.currentSession, message);
+            }
+            catch (err) {
+                logger.warn({ err, session: this.currentSessionName }, 'appendAssistant: 会话持久化失败');
+            }
+        }
+        logger.debug({ role: message.role, session: this.currentSessionName }, 'appendAssistant');
+    }
+    /**
+     * 列出所有会话标识
+     *
+     * @returns 会话标识列表（格式：YYYY-MM-DD-session），未注入 ISessionStore 则返回空
+     */
+    async listAllSessions() {
+        if (!this.sessionStore) {
+            logger.debug({ hasSessionStore: false }, 'listAllSessions: ISessionStore 未注入，返回空数组');
+            return [];
+        }
+        return this.sessionStore.listSessions();
+    }
+    /**
+     * 从会话存储恢复历史消息
+     * 用于重启后恢复之前的对话
+     *
+     * @param date - 会话日期 YYYY-MM-DD
+     * @param session - 会话标识
+     * @returns 会话中的消息列表，未注入 ISessionStore 则返回空数组
+     */
+    async loadSessionMessages(date, session) {
+        // 更新当前会话为请求的会话（保持状态一致）
+        this.currentDate = date;
+        this.currentSession = session;
+        if (!this.sessionStore) {
+            logger.debug({ date, session }, 'loadSessionMessages: ISessionStore 未注入，返回空数组');
+            return [];
+        }
+        const messages = this.sessionStore.loadMessages(date, session);
+        logger.info({ date, session, count: messages.length }, 'loadSessionMessages');
+        return messages;
+    }
+    /**
+     * 把外部 fire-and-forget 归档注册到 pendingArchives
+     * 供 Agent.chat() 触发 signal 归档时使用
+     */
+    registerPendingArchive(p) {
+        this.pendingArchives.add(p);
+        p.finally(() => {
+            this.pendingArchives.delete(p);
+        });
+    }
+    /**
+     * 等待所有挂起的归档完成（Agent.close() 时调用）
+     * 防止 fire-and-forget 还在写 SQLite 时 db 已被 close
+     *
+     * 重要：会捕获**等待期间新加入**的归档（解决 init() → archiveMissingSessions() 的 race）
+     * 实现：用 50ms 间隔轮询检查新加入的 promise，直到所有归档完成或超时
+     *
+     * @param timeoutMs 单次等待超时（默认 5000ms）
+     * @returns 是否所有归档都完成（false 表示有超时）
+     */
+    async awaitPendingArchives(timeoutMs = 5000) {
+        // 快速路径：无挂起任务时立即返回（避免空轮询浪费 5s）
+        if (this.pendingArchives.size === 0)
+            return true;
+        const deadline = Date.now() + timeoutMs;
+        while (Date.now() < deadline) {
+            const current = Array.from(this.pendingArchives);
+            if (current.length === 0) {
+                // 所有归档已完成
+                return true;
+            }
+            // 有挂起任务 → 等所有 settle
+            const timeout = new Promise((resolve) => setTimeout(resolve, Math.max(50, deadline - Date.now())));
+            await Promise.race([Promise.allSettled(current), timeout]);
+            // 如果所有都清空了 → 完成
+            if (this.pendingArchives.size === 0)
+                return true;
+            // 还有挂起的（可能在等待期间新加入）→ 下一轮继续等
+        }
+        return this.pendingArchives.size === 0;
+    }
+}
+//# sourceMappingURL=messageHistory.js.map

package/dist/agent/messageHistory.js.map

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

package/dist/agent/toolExecutor.d.ts

@@ -0,0 +1,137 @@
+/**
+ * 工具执行器
+ *
+ * 阶段一：1 个工具（read_file）
+ * 阶段二（M-204）：扩展为 4 个工具（read_file / write_file / list_dir / search_memories）
+ * 详见 ADR-006 · 安全采用两级权限 + 工具白名单 + 路径白名单
+ *
+ * QC-R2-10 拆分：内置工具实现 + 路径安全已提取到 BuiltinToolHandlers，
+ * ToolExecutor 聚焦工具注册 / 分发 / 参数校验。
+ */
+import type { SecurityGuard } from '../security/pathGuard.js';
+import type { IMemoryStorage } from '../memory/storageInterface.js';
+import type { WorkProjectionManager } from '../agent/managers/workProjection.js';
+import { type ToolDefinition } from '../agent/builtinTools.js';
+export { BUILTIN_TOOLS } from '../agent/builtinTools.js';
+export type { ToolDefinition } from '../agent/builtinTools.js';
+type ToolResult = string;
+/**
+ * 写入扩展接口
+ *
+ * 用于在 writeFile 之前注入自定义逻辑（如 diff 展示 + 用户确认）。
+ * 当 onBeforeWrite 被提供时，它将替代 SecurityGuard.requestWriteConfirmation 的安全确认流程。
+ */
+export interface WriteExtensions {
+    /**
+     * 写入前回调
+     * @param path 相对路径
+     * @param beforeContent 文件旧内容（null 表示新文件）
+     * @param afterContent 要写入的新内容
+     * @returns true 继续写入，false 拒绝写入
+     */
+    onBeforeWrite?: (path: string, beforeContent: string | null, afterContent: string) => Promise<boolean>;
+}
+/**
+ * 自定义工具的执行上下文
+ *
+ * S-01: 提供安全校验方法，让自定义工具可以（且应该）通过安全层校验路径。
+ * 内置工具（read_file/write_file/list_dir）已内置路径校验，
+ * 自定义工具如需访问文件系统，应调用 ctx.guardPath() 确保路径在白名单内。
+ */
+export interface ToolContext {
+    /**
+     * 校验路径是否在安全白名单内
+     *
+     * @param path 要校验的路径（相对项目根目录或绝对路径）
+     * @throws MemoraError 路径不在白名单内时抛出
+     */
+    guardPath: (path: string) => void;
+}
+/**
+ * 自定义工具的处理器类型
+ *
+ * 宿主项目通过 agent.registerTool() 注册领域工具时，
+ * 需提供此签名的 handler 函数。
+ * handler 接收解析后的参数对象和工具上下文，返回字符串结果。
+ *
+ * S-01: 自定义工具如需访问文件系统，应调用 ctx.guardPath(path) 校验路径。
+ */
+export type ToolHandler = (args: Record<string, unknown>, ctx: ToolContext) => Promise<string>;
+/**
+ * 自定义工具注册条目
+ *
+ * 将工具定义与处理器绑定在一起，
+ * 存入 ToolExecutor 的 customTools Map 中。
+ */
+export interface CustomToolEntry {
+    /** 工具定义（名称、描述、参数 schema） */
+    definition: ToolDefinition;
+    /** 工具执行处理器 */
+    handler: ToolHandler;
+}
+/**
+ * 工具执行器
+ *
+ * 职责：工具注册 + 分发 + 参数校验。
+ * 内置工具实现委托给 BuiltinToolHandlers（QC-R2-10）。
+ */
+export declare class ToolExecutor {
+    /** 自定义工具注册表（宿主项目通过 registerTool 注册领域工具） */
+    private readonly customTools;
+    /** 内置工具处理器（路径安全 + 内置工具实现，QC-R2-10 提取） */
+    private readonly builtinHandlers;
+    constructor(projectPath: string, security: SecurityGuard, memoryIndex: IMemoryStorage, 
+    /** 作品投影管理器（可选，读取文件时自动生成投影） */
+    workProjection?: WorkProjectionManager);
+    /**
+     * 注册自定义工具
+     *
+     * 宿主项目调用此方法注册领域专属工具（如小说创作的 create_chapter）。
+     * 工具名不能与内置工具重复，也不能重复注册。
+     * 注册后工具会出现在 `tools.list` 列表中，
+     * LLM 可通过 tool_call 调用，execute() 会路由到 handler。
+     *
+     * @param definition 工具定义（名称、描述、参数 schema）
+     * @param handler 工具执行处理器
+     * @throws 工具名与内置工具冲突或已注册时抛错
+     */
+    registerTool(definition: ToolDefinition, handler: ToolHandler): void;
+    /**
+     * 获取所有工具定义（IX-02：统一为 getter 风格，与 persona/skill 一致）
+     */
+    get list(): ToolDefinition[];
+    /**
+     * 执行工具调用
+     *
+     * 新增参数类型校验。
+     * LLM 返回的 tool_call 参数可能类型不匹配（如 number 代替 string），
+     * 校验器会根据 ToolDefinition.parameters 自动修正常见类型错误，
+     * 避免后续 `as string` 强转导致的运行时错误。
+     *
+     * @param name 工具名称
+     * @param argsJson 参数 JSON 字符串
+     * @param extensions 写入扩展（可选，用于 diff 确认等）
+     * @returns 工具结果的字符串描述
+     */
+    execute(name: string, argsJson: string, extensions?: WriteExtensions): Promise<ToolResult>;
+    /**
+     * 参数类型校验 + 自动修正
+     *
+     * LLM 返回的 tool_call 参数经常类型不匹配：
+     *   - number → string（如 maxDepth: 2 而非 "2"）
+     *   - boolean → string（如 recursive: true 而非 "true"）
+     *   - 缺少必填参数
+     *
+     * 校验策略：
+     *   1. 自动修正：number/boolean → string（最常见的 LLM 错误）
+     *   2. 缺少必填参数：抛出 toolError
+     *   3. 未知参数：忽略（LLM 可能返回额外参数）
+     *
+     * @param toolName 工具名称（用于错误信息）
+     * @param args LLM 返回的原始参数
+     * @param definition 工具定义（含参数 schema）
+     * @returns 校验/修正后的参数
+     */
+    private validateAndCoerceArgs;
+}
+//# sourceMappingURL=toolExecutor.d.ts.map

package/dist/agent/toolExecutor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolExecutor.d.ts","sourceRoot":"","sources":["../../src/agent/toolExecutor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAG7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAChF,OAAO,EAAiB,KAAK,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAE7E,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,YAAY,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAE9D,KAAK,UAAU,GAAG,MAAM,CAAC;AAEzB;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,CACd,IAAI,EAAE,MAAM,EACZ,aAAa,EAAE,MAAM,GAAG,IAAI,EAC5B,YAAY,EAAE,MAAM,KACjB,OAAO,CAAC,OAAO,CAAC,CAAC;CACvB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;;OAKG;IACH,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,WAAW,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAE/F;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,4BAA4B;IAC5B,UAAU,EAAE,cAAc,CAAC;IAC3B,cAAc;IACd,OAAO,EAAE,WAAW,CAAC;CACtB;AAED;;;;;GAKG;AACH,qBAAa,YAAY;IACvB,2CAA2C;IAC3C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAsC;IAClE,yCAAyC;IACzC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAsB;gBAGpD,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,aAAa,EACvB,WAAW,EAAE,cAAc;IAC3B,8BAA8B;IAC9B,cAAc,CAAC,EAAE,qBAAqB;IAYxC;;;;;;;;;;;OAWG;IACH,YAAY,CAAC,UAAU,EAAE,cAAc,EAAE,OAAO,EAAE,WAAW,GAAG,IAAI;IAwBpE;;OAEG;IACH,IAAI,IAAI,IAAI,cAAc,EAAE,CAE3B;IAED;;;;;;;;;;;;OAYG;IACG,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC;IAwGhG;;;;;;;;;;;;;;;;;OAiBG;IACH,OAAO,CAAC,qBAAqB;CAyE9B"}

package/dist/agent/toolExecutor.js

@@ -0,0 +1,209 @@
+import { toolError, configError, MemoraError, ToolErrorCode, toError } from '../utils/errors.js';
+import { logger } from '../logging/logger.js';
+import { BUILTIN_TOOLS } from '../agent/builtinTools.js';
+import { BuiltinToolHandlers } from '../agent/builtinToolHandlers.js';
+export { BUILTIN_TOOLS } from '../agent/builtinTools.js';
+/**
+ * 工具执行器
+ *
+ * 职责：工具注册 + 分发 + 参数校验。
+ * 内置工具实现委托给 BuiltinToolHandlers（QC-R2-10）。
+ */
+export class ToolExecutor {
+    /** 自定义工具注册表（宿主项目通过 registerTool 注册领域工具） */
+    customTools = new Map();
+    /** 内置工具处理器（路径安全 + 内置工具实现，QC-R2-10 提取） */
+    builtinHandlers;
+    constructor(projectPath, security, memoryIndex, 
+    /** 作品投影管理器（可选，读取文件时自动生成投影） */
+    workProjection) {
+        // QC-R2-10：内置工具实现 + 路径安全委托给 BuiltinToolHandlers
+        // 构造参数仅用于初始化 BuiltinToolHandlers，ToolExecutor 自身不再持有这些引用
+        this.builtinHandlers = new BuiltinToolHandlers(projectPath, security, memoryIndex, workProjection);
+    }
+    /**
+     * 注册自定义工具
+     *
+     * 宿主项目调用此方法注册领域专属工具（如小说创作的 create_chapter）。
+     * 工具名不能与内置工具重复，也不能重复注册。
+     * 注册后工具会出现在 `tools.list` 列表中，
+     * LLM 可通过 tool_call 调用，execute() 会路由到 handler。
+     *
+     * @param definition 工具定义（名称、描述、参数 schema）
+     * @param handler 工具执行处理器
+     * @throws 工具名与内置工具冲突或已注册时抛错
+     */
+    registerTool(definition, handler) {
+        if (!definition.name || !/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(definition.name)) {
+            throw configError(`工具名无效："${definition.name}"`, '必须以字母/下划线开头，只含字母/数字/下划线', ['请检查工具名称是否符合命名规范']);
+        }
+        // 不允许覆盖内置工具
+        if (BUILTIN_TOOLS.some((t) => t.name === definition.name)) {
+            throw configError(`不能覆盖内置工具：${definition.name}`, undefined, [
+                '请使用不同的工具名称',
+            ]);
+        }
+        // 不允许重复注册
+        if (this.customTools.has(definition.name)) {
+            throw configError(`工具已注册：${definition.name}`, undefined, [
+                '请使用不同的工具名称，或先注销已有工具',
+            ]);
+        }
+        this.customTools.set(definition.name, { definition, handler });
+        logger.info({ tool: definition.name }, '自定义工具已注册');
+    }
+    /**
+     * 获取所有工具定义（IX-02：统一为 getter 风格，与 persona/skill 一致）
+     */
+    get list() {
+        return [...BUILTIN_TOOLS, ...[...this.customTools.values()].map((e) => e.definition)];
+    }
+    /**
+     * 执行工具调用
+     *
+     * 新增参数类型校验。
+     * LLM 返回的 tool_call 参数可能类型不匹配（如 number 代替 string），
+     * 校验器会根据 ToolDefinition.parameters 自动修正常见类型错误，
+     * 避免后续 `as string` 强转导致的运行时错误。
+     *
+     * @param name 工具名称
+     * @param argsJson 参数 JSON 字符串
+     * @param extensions 写入扩展（可选，用于 diff 确认等）
+     * @returns 工具结果的字符串描述
+     */
+    async execute(name, argsJson, extensions) {
+        let args;
+        try {
+            args = JSON.parse(argsJson);
+        }
+        catch (err) {
+            const e = toError(err);
+            throw toolError('工具参数解析失败', `args JSON 无效：${e.message}`, ['检查 LLM 输出的工具调用格式', '确认 args 是合法 JSON'], e, ToolErrorCode.ARGUMENT_ERROR);
+        }
+        // 参数类型校验 + 自动修正
+        // LLM 经常返回 number 代替 string（如 maxDepth: 2 而非 "2"），
+        // 校验器根据 ToolDefinition 自动转换，避免后续 as string 出错
+        const definition = this.list.find((t) => t.name === name);
+        if (definition) {
+            args = this.validateAndCoerceArgs(name, args, definition);
+        }
+        const safeArgs = Object.fromEntries(Object.entries(args).map(([k, v]) => [
+            k,
+            typeof v === 'string' && v.length > 200 ? `${v.slice(0, 200)}...` : v,
+        ]));
+        logger.info({ tool: name, args: safeArgs }, '执行工具');
+        // 运行时类型安全：从 args 中提取字符串参数，避免不安全的 as string 断言
+        const strArg = (key, fallback) => {
+            const val = args[key];
+            return typeof val === 'string' ? val : (fallback ?? '');
+        };
+        // QC-R2-10：内置工具调用委托给 BuiltinToolHandlers
+        switch (name) {
+            case 'read_file':
+                return this.builtinHandlers.readFile(strArg('path'));
+            case 'write_file':
+                return this.builtinHandlers.writeFile(strArg('path'), strArg('content'), extensions, strArg('mode', 'overwrite'), strArg('insert_line') || undefined);
+            case 'list_dir':
+                return this.builtinHandlers.listDir(strArg('path', '.'), strArg('recursive', 'false'), strArg('maxDepth', '2'));
+            case 'search_memories':
+                return this.builtinHandlers.searchMemories(strArg('query'), strArg('limit', '10'), strArg('mode', 'match'));
+            default: {
+                // 自定义工具 fallback：查找 customTools Map
+                const custom = this.customTools.get(name);
+                if (custom) {
+                    // S-01: 传入 ToolContext，提供 guardPath 安全校验方法
+                    // QC-R2-10: 路径安全委托给 BuiltinToolHandlers
+                    const ctx = {
+                        guardPath: (path) => {
+                            const absolutePath = this.builtinHandlers.resolveSafePath(path);
+                            this.builtinHandlers.guardPathOrThrow(absolutePath, name, 'custom');
+                        },
+                    };
+                    try {
+                        return await custom.handler(args, ctx);
+                    }
+                    catch (err) {
+                        // 统一包装为 MemoraError，保持错误处理一致性
+                        if (err instanceof MemoraError)
+                            throw err;
+                        const e = toError(err);
+                        throw toolError('自定义工具执行失败', `${name}: ${e.message}`, ['检查工具参数是否正确', '检查工具 handler 实现是否有 bug'], e, ToolErrorCode.CUSTOM_TOOL_FAILED);
+                    }
+                }
+                throw toolError('未知工具', `agent 调用了未注册的工具：${name}`, [
+                    `已注册工具：${this.list
+                        .map((t) => t.name)
+                        .join(', ')}`,
+                    '检查 personality.md 是否限制了工具集',
+                ], undefined, ToolErrorCode.UNKNOWN_TOOL);
+            }
+        }
+    }
+    /**
+     * 参数类型校验 + 自动修正
+     *
+     * LLM 返回的 tool_call 参数经常类型不匹配：
+     *   - number → string（如 maxDepth: 2 而非 "2"）
+     *   - boolean → string（如 recursive: true 而非 "true"）
+     *   - 缺少必填参数
+     *
+     * 校验策略：
+     *   1. 自动修正：number/boolean → string（最常见的 LLM 错误）
+     *   2. 缺少必填参数：抛出 toolError
+     *   3. 未知参数：忽略（LLM 可能返回额外参数）
+     *
+     * @param toolName 工具名称（用于错误信息）
+     * @param args LLM 返回的原始参数
+     * @param definition 工具定义（含参数 schema）
+     * @returns 校验/修正后的参数
+     */
+    validateAndCoerceArgs(toolName, args, definition) {
+        const props = definition.parameters.properties;
+        const required = definition.parameters.required;
+        const result = { ...args };
+        // 检查必填参数
+        for (const req of required) {
+            if (result[req] === undefined || result[req] === null) {
+                throw toolError('工具参数缺失', `${toolName}: 缺少必填参数 "${req}"`, [`参数 "${req}" 类型应为 ${props[req]?.type ?? 'unknown'}`], undefined, ToolErrorCode.ARGUMENT_ERROR);
+            }
+        }
+        // 类型修正：根据 schema 中的 type 字段自动转换
+        for (const [key, schema] of Object.entries(props)) {
+            const value = result[key];
+            if (value === undefined || value === null)
+                continue; // 可选参数未传，跳过
+            const expectedType = schema.type;
+            const actualType = typeof value;
+            // string 类型修正：number / boolean → string
+            if (expectedType === 'string' && actualType !== 'string') {
+                result[key] = String(value);
+                logger.debug({ tool: toolName, param: key, from: actualType, to: 'string' }, '参数类型自动修正');
+            }
+            // number 类型修正：string → number
+            else if (expectedType === 'number' && actualType === 'string') {
+                const num = Number(value);
+                if (!Number.isNaN(num)) {
+                    result[key] = num;
+                    logger.debug({ tool: toolName, param: key, from: 'string', to: 'number' }, '参数类型自动修正');
+                }
+            }
+            // boolean 类型修正：string → boolean
+            else if (expectedType === 'boolean' && actualType === 'string') {
+                if (value === 'true' || value === '1') {
+                    result[key] = true;
+                }
+                else if (value === 'false' || value === '0') {
+                    result[key] = false;
+                }
+                logger.debug({ tool: toolName, param: key, from: 'string', to: 'boolean' }, '参数类型自动修正');
+            }
+            // array 类型修正：单值 → 数组
+            else if (expectedType === 'array' && !Array.isArray(value)) {
+                result[key] = [value];
+                logger.debug({ tool: toolName, param: key, from: actualType, to: 'array' }, '参数类型自动修正');
+            }
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=toolExecutor.js.map

package/dist/agent/toolExecutor.js.map

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