@zooique/memora 0.3.0 → 2.0.0

package/dist/agent/types.js

@@ -14,6 +14,44 @@
  *
  * error 事件：流式过程中发生错误（如 LLM 超时、连接断开），
  * 替代裸 throw 让宿主能优雅展示错误并清理 UI（避免未处理 rejection 静默卡死）。
+ *
+ * ─── agent/ 模块依赖图（最后更新：2026-07-16） ─────────────────
+ * 如需精确依赖关系，请阅读各文件 import 语句。本图仅展示高层模块关系。
+ *
+ *   agent.ts（门面，Agent 类）
+ *     ├─ assembler.ts（组件装配，init 阶段）
+ *     ├─ loop.ts（主循环，chat 阶段）
+ *     │    ├─ toolExecutor.ts（工具执行）
+ *     │    ├─ contextManager.ts（上下文窗口管理）
+ *     │    ├─ messageHistory.ts（历史消息存储）
+ *     │    ├─ guardrail.ts（护栏规则）
+ *     │    └─ tracer.ts（可观测性 span）
+ *     ├─ personaMatcher.ts（LLM 角色匹配，从 persona 迁入）
+ *     ├─ userFactExtractor.ts（用户事实提取，纯函数）
+ *     ├─ builtinToolHandlers.ts（内置工具处理器）
+ *     └─ managers/（12 个专职 Manager）
+ *          ├─ chatLockManager.ts（并发锁，token 机制）
+ *          ├─ configManager.ts（配置加载）
+ *          ├─ contextManager.ts（上下文管理）
+ *          ├─ insightExtractor.ts（LLM 提炼，prompt 独立函数）
+ *          ├─ memoryInspector.ts（记忆读写统一入口，ADR-014）
+ *          ├─ memoryDecayScheduler.ts（记忆衰减调度）
+ *          ├─ memoryAdvisor.ts（记忆建议）
+ *          ├─ relationBuilder.ts（记忆关系构建，ADR-014 侧车）
+ *          ├─ archiveCoordinator.ts（归档协调，emit archiveFailed）
+ *          ├─ sessionArchiver.ts（会话归档）
+ *          ├─ sessionManager.ts（会话状态）
+ *          ├─ textPolishManager.ts（文本润色）
+ *          ├─ autoConfigRefiner.ts（配置自动优化）
+ *          └─ workProjection.ts（作品投影）
+ *
+ * 分层依赖方向（ADR-008）：
+ *   agent/ → memory/ → storage/（不可反向）
+ *   agent/ → persona/（不可反向，persona 不调 LLM）
+ *   agent/ → llm/（provider 注入）
+ *   agent/ → skill/（技能加载）
+ *   agent/ → config/（配置加载）
+ * ──────────────────────────────────────────────────────────
  */
 export {};
 //# sourceMappingURL=types.js.map

package/dist/agent/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/agent/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/agent/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG"}

package/dist/config/loader.d.ts

@@ -1,6 +1,6 @@
 import { z } from 'zod';
 declare const ConfigSchema: z.ZodObject<{
-    llm: z.ZodObject<{
+    llm: z.ZodDefault<z.ZodObject<{
         provider: z.ZodDefault<z.ZodString>;
         model: z.ZodDefault<z.ZodString>;
         baseUrl: z.ZodOptional<z.ZodString>;
@@ -20,18 +20,22 @@ declare const ConfigSchema: z.ZodObject<{
             apiKey: z.ZodOptional<z.ZodString>;
             /** 该 Provider 的 temperature，未配置时回退到全局 llm.temperature */
             temperature: z.ZodOptional<z.ZodNumber>;
+            /** 该 Provider 的上下文窗口大小（token 数），未配置时回退到 memory.maxContextTokens */
+            contextWindow: z.ZodOptional<z.ZodNumber>;
         }, "strip", z.ZodTypeAny, {
             model: string;
             provider: string;
             apiKey?: string | undefined;
             temperature?: number | undefined;
             baseUrl?: string | undefined;
+            contextWindow?: number | undefined;
         }, {
             model: string;
             provider: string;
             apiKey?: string | undefined;
             temperature?: number | undefined;
             baseUrl?: string | undefined;
+            contextWindow?: number | undefined;
         }>>>;
         /**
          * 当前激活的 Provider 别名
@@ -70,13 +74,6 @@ declare const ConfigSchema: z.ZodObject<{
         temperature: number;
         model: string;
         provider: string;
-        background?: {
-            temperature: number;
-            model: string;
-            provider: string;
-            apiKey?: string | undefined;
-            baseUrl?: string | undefined;
-        } | undefined;
         apiKey?: string | undefined;
         active?: string | undefined;
         baseUrl?: string | undefined;
@@ -86,15 +83,16 @@ declare const ConfigSchema: z.ZodObject<{
             apiKey?: string | undefined;
             temperature?: number | undefined;
             baseUrl?: string | undefined;
+            contextWindow?: number | undefined;
         }> | undefined;
-    }, {
         background?: {
+            temperature: number;
             model: string;
             provider: string;
             apiKey?: string | undefined;
-            temperature?: number | undefined;
             baseUrl?: string | undefined;
         } | undefined;
+    }, {
         apiKey?: string | undefined;
         temperature?: number | undefined;
         model?: string | undefined;
@@ -107,19 +105,27 @@ declare const ConfigSchema: z.ZodObject<{
             apiKey?: string | undefined;
             temperature?: number | undefined;
             baseUrl?: string | undefined;
+            contextWindow?: number | undefined;
         }> | undefined;
-    }>;
-    memory: z.ZodObject<{
+        background?: {
+            model: string;
+            provider: string;
+            apiKey?: string | undefined;
+            temperature?: number | undefined;
+            baseUrl?: string | undefined;
+        } | undefined;
+    }>>;
+    memory: z.ZodDefault<z.ZodObject<{
         dataDir: z.ZodDefault<z.ZodString>;
         maxContextTokens: z.ZodDefault<z.ZodNumber>;
     }, "strip", z.ZodTypeAny, {
-        maxContextTokens: number;
         dataDir: string;
+        maxContextTokens: number;
     }, {
-        maxContextTokens?: number | undefined;
         dataDir?: string | undefined;
-    }>;
-    security: z.ZodObject<{
+        maxContextTokens?: number | undefined;
+    }>>;
+    security: z.ZodDefault<z.ZodObject<{
         permission: z.ZodDefault<z.ZodEnum<["owner", "guest"]>>;
         confirmWrites: z.ZodDefault<z.ZodBoolean>;
     }, "strip", z.ZodTypeAny, {
@@ -128,7 +134,7 @@ declare const ConfigSchema: z.ZodObject<{
     }, {
         permission?: "owner" | "guest" | undefined;
         confirmWrites?: boolean | undefined;
-    }>;
+    }>>;
     allowedPaths: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
     persona: z.ZodOptional<z.ZodString>;
     /**
@@ -155,13 +161,6 @@ declare const ConfigSchema: z.ZodObject<{
         temperature: number;
         model: string;
         provider: string;
-        background?: {
-            temperature: number;
-            model: string;
-            provider: string;
-            apiKey?: string | undefined;
-            baseUrl?: string | undefined;
-        } | undefined;
         apiKey?: string | undefined;
         active?: string | undefined;
         baseUrl?: string | undefined;
@@ -171,15 +170,23 @@ declare const ConfigSchema: z.ZodObject<{
             apiKey?: string | undefined;
             temperature?: number | undefined;
             baseUrl?: string | undefined;
+            contextWindow?: number | undefined;
         }> | undefined;
+        background?: {
+            temperature: number;
+            model: string;
+            provider: string;
+            apiKey?: string | undefined;
+            baseUrl?: string | undefined;
+        } | undefined;
     };
     security: {
         permission: "owner" | "guest";
         confirmWrites: boolean;
     };
     memory: {
-        maxContextTokens: number;
         dataDir: string;
+        maxContextTokens: number;
     };
     allowedPaths: string[];
     persona?: string | undefined;
@@ -189,14 +196,8 @@ declare const ConfigSchema: z.ZodObject<{
         baseUrl?: string | undefined;
     } | undefined;
 }, {
-    llm: {
-        background?: {
-            model: string;
-            provider: string;
-            apiKey?: string | undefined;
-            temperature?: number | undefined;
-            baseUrl?: string | undefined;
-        } | undefined;
+    persona?: string | undefined;
+    llm?: {
         apiKey?: string | undefined;
         temperature?: number | undefined;
         model?: string | undefined;
@@ -209,17 +210,24 @@ declare const ConfigSchema: z.ZodObject<{
             apiKey?: string | undefined;
             temperature?: number | undefined;
             baseUrl?: string | undefined;
+            contextWindow?: number | undefined;
         }> | undefined;
-    };
-    security: {
+        background?: {
+            model: string;
+            provider: string;
+            apiKey?: string | undefined;
+            temperature?: number | undefined;
+            baseUrl?: string | undefined;
+        } | undefined;
+    } | undefined;
+    security?: {
         permission?: "owner" | "guest" | undefined;
         confirmWrites?: boolean | undefined;
-    };
-    memory: {
-        maxContextTokens?: number | undefined;
+    } | undefined;
+    memory?: {
         dataDir?: string | undefined;
-    };
-    persona?: string | undefined;
+        maxContextTokens?: number | undefined;
+    } | undefined;
     allowedPaths?: string[] | undefined;
     embedding?: {
         model: string;
@@ -230,6 +238,10 @@ declare const ConfigSchema: z.ZodObject<{
 export type Config = z.infer<typeof ConfigSchema>;
 /**
  * 加载配置
+ *
+ * 单一真理源：所有默认值由 ConfigSchema 的 .default() 声明，
+ * 不再维护独立的 DEFAULT_CONFIG 常量（避免两处真理源打架）。
+ *
  * @param configPath 显式指定的配置文件路径
  */
 export declare function loadConfig(configPath?: string): Promise<Config>;

package/dist/config/loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/config/loader.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA0BxB,QAAA,MAAM,YAAY;;;;;;;QAQd;;;;;;WAMG;;;;;;YAtBL,yDAAyD;;;;;;;;;;;;;;;QAwBvD;;;;;WAKG;;QAEH;;;;;;WAMG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAuBL;;;;;OAKG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAQH,CAAC;AAEH,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAqBlD;;;GAGG;AACH,wBAAsB,UAAU,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA2BrE"}
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/config/loader.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAgCxB,QAAA,MAAM,YAAY;;;;;;;QASZ;;;;;;WAMG;;;;;;YA7BP,yDAAyD;;YAEzD,mEAAmE;;;;;;;;;;;;;;;;;QA6B/D;;;;;WAKG;;QAEH;;;;;;WAMG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA4BP;;;;;OAKG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAQH,CAAC;AAEH,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAElD;;;;;;;GAOG;AACH,wBAAsB,UAAU,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA2BrE"}

package/dist/config/loader.js

@@ -35,13 +35,20 @@ const ProviderConfigSchema = z.object({
     apiKey: z.string().optional(),
     /** 该 Provider 的 temperature，未配置时回退到全局 llm.temperature */
     temperature: z.number().min(0).max(2).optional(),
+    /** 该 Provider 的上下文窗口大小（token 数），未配置时回退到 memory.maxContextTokens */
+    contextWindow: z.number().optional(),
 });
 // 配置 schema（运行时校验）
 // provider 允许任意字符串：预设（mock/deepseek/doubao/openai）开箱即用，
 // 自定义 provider（如 mimo、自部署模型）只要显式配 baseUrl + model 即可
 // 详见 ADR-003
+//
+// 单一真理源：所有默认值由 .default() 声明，ConfigSchema.parse({}) 即可得到完整默认配置。
+// 嵌套对象（llm/memory/security）必须用 .default({}) 声明整体默认值，
+// 否则 zod 会在对象缺失时报 "Required" 而非使用内部字段的 default。
 const ConfigSchema = z.object({
-    llm: z.object({
+    llm: z
+        .object({
         // 旧格式：单一 provider 扁平字段（向后兼容，providers 未配置时生效）
         provider: z.string().default('mock'),
         model: z.string().default('deepseek-chat'),
@@ -79,15 +86,20 @@ const ConfigSchema = z.object({
             temperature: z.number().min(0).max(2).default(0.5),
         })
             .optional(),
-    }),
-    memory: z.object({
+    })
+        .default({}),
+    memory: z
+        .object({
         dataDir: z.string().default('~/.memora'),
         maxContextTokens: z.number().default(DEFAULT_MAX_CONTEXT_TOKENS),
-    }),
-    security: z.object({
+    })
+        .default({}),
+    security: z
+        .object({
         permission: z.enum(['owner', 'guest']).default('owner'),
         confirmWrites: z.boolean().default(false),
-    }),
+    })
+        .default({}),
     // 允许的路径白名单（绝对路径）
     allowedPaths: z.array(z.string()).default([]),
     // 默认角色名（对应 personas/*.md）
@@ -106,26 +118,12 @@ const ConfigSchema = z.object({
     })
         .optional(),
 });
-const DEFAULT_CONFIG = {
-    llm: {
-        provider: 'mock',
-        model: 'mock-model',
-        temperature: 0.7,
-    },
-    memory: {
-        dataDir: '~/.memora',
-        maxContextTokens: DEFAULT_MAX_CONTEXT_TOKENS,
-    },
-    security: {
-        permission: 'owner',
-        confirmWrites: false,
-    },
-    allowedPaths: [],
-    persona: undefined,
-    embedding: undefined,
-};
 /**
  * 加载配置
+ *
+ * 单一真理源：所有默认值由 ConfigSchema 的 .default() 声明，
+ * 不再维护独立的 DEFAULT_CONFIG 常量（避免两处真理源打架）。
+ *
  * @param configPath 显式指定的配置文件路径
  */
 export async function loadConfig(configPath) {
@@ -150,10 +148,10 @@ export async function loadConfig(configPath) {
         return expandEnvVars(mergeWithDefaults(config));
     }
     catch {
-        // 用户级不存在，使用默认值
+        // 用户级不存在，使用 schema 默认值（单一真理源）
     }
-    // 4. 内置默认
-    return expandEnvVars(DEFAULT_CONFIG);
+    // 4. 内置默认：ConfigSchema.parse({}) 让 zod 的 .default() 生效
+    return expandEnvVars(ConfigSchema.parse({}));
 }
 /**
  * 读取并解析 JSON 文件
@@ -164,19 +162,23 @@ async function readJsonFile(path) {
 }
 /**
  * 合并用户配置与默认值
+ *
+ * 直接用 ConfigSchema.parse(userConfig)，让 zod 的 .default() 填充缺失字段。
+ * 不再 spread DEFAULT_CONFIG，避免覆盖 schema default。
  */
 function mergeWithDefaults(userConfig) {
-    return ConfigSchema.parse({
-        ...DEFAULT_CONFIG,
-        ...userConfig,
-    });
+    return ConfigSchema.parse(userConfig);
 }
 /**
  * 展开 ${ENV_VAR} 占位符
  * 配置文件可写 "apiKey": "${MEMORA_LLM_API_KEY}"
  * 实际读取时展开为环境变量值
  *
- * 同时展开 providers 映射表中每个 Provider 的 apiKey/baseUrl
+ * 展开范围覆盖所有可能包含敏感信息的通道：
+ *   - llm（前台主通道）：apiKey / baseUrl
+ *   - llm.providers（多 Provider 映射表）：每个 Provider 的 apiKey / baseUrl
+ *   - llm.background（后台通道）：apiKey / baseUrl
+ *   - embedding（向量嵌入通道）：apiKey / baseUrl
  */
 function expandEnvVars(config) {
     const expand = (val) => {
@@ -192,6 +194,22 @@ function expandEnvVars(config) {
             { ...p, apiKey: expand(p.apiKey), baseUrl: expand(p.baseUrl) },
         ]))
         : undefined;
+    // 展开 background 后台通道的环境变量（与前台 llm 通道同模式）
+    const expandedBackground = config.llm.background
+        ? {
+            ...config.llm.background,
+            apiKey: expand(config.llm.background.apiKey),
+            baseUrl: expand(config.llm.background.baseUrl),
+        }
+        : undefined;
+    // 展开 embedding 向量嵌入通道的环境变量
+    const expandedEmbedding = config.embedding
+        ? {
+            ...config.embedding,
+            apiKey: expand(config.embedding.apiKey),
+            baseUrl: expand(config.embedding.baseUrl),
+        }
+        : undefined;
     return {
         ...config,
         llm: {
@@ -199,7 +217,9 @@ function expandEnvVars(config) {
             apiKey: expand(config.llm.apiKey),
             baseUrl: expand(config.llm.baseUrl),
             providers: expandedProviders,
+            background: expandedBackground,
         },
+        embedding: expandedEmbedding,
     };
 }
 //# sourceMappingURL=loader.js.map

package/dist/config/loader.js.map

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

package/dist/eval/evalRunner.d.ts

@@ -0,0 +1,94 @@
+/**
+ * EvalRunner — Agent 行为评估执行器
+ *
+ * 职责：通过 createAgent 工厂构造测试条件 → 执行场景 →
+ *   收集 AgentChunk → 评估结果 → 汇总报告
+ *
+ * 设计要点：
+ *   - 每个场景创建独立 Agent（通过工厂函数），避免状态污染
+ *   - 场景执行后 close()，避免资源泄漏
+ *   - 错误隔离：单个场景失败不中断其他场景
+ *   - 超时保护：scenarioTimeoutMs 防止卡死（Promise.race + AbortController）
+ *
+ * 内核零依赖约束：仅使用 memora 内部模块，不引入新依赖。
+ */
+import type { Agent } from '../agent/agent.js';
+import type { EvalScenario, EvalResult } from './evalTypes.js';
+/**
+ * EvalRunner 构造选项
+ */
+export interface EvalRunnerOptions {
+    /**
+     * Agent 工厂函数（每个场景创建新 Agent）
+     *
+     * 工厂函数负责配置 MockProvider、guardrail 规则、预写入记忆等测试条件。
+     * EvalRunner 负责调用 init() / chat() / close() 管理 Agent 生命周期。
+     */
+    createAgent: () => Agent;
+    /**
+     * 单个场景超时_ms（默认 10000）
+     *
+     * 超时后通过 AbortController 中断 agent.chat，
+     * 返回 passed=false 的 EvalResult。
+     */
+    scenarioTimeoutMs?: number;
+}
+/**
+ * 批量执行汇总报告
+ */
+export interface EvalSummary {
+    /** 每个场景的评估结果（按执行顺序） */
+    results: EvalResult[];
+    /** 通过场景数 */
+    passed: number;
+    /** 失败场景数 */
+    failed: number;
+    /** 场景总数 */
+    total: number;
+    /** 执行总耗时_ms */
+    durationMs: number;
+    /** 失败场景名列表 */
+    failedScenarios: string[];
+}
+/**
+ * Agent 行为评估执行器
+ *
+ * @example
+ * ```ts
+ * const runner = new EvalRunner({
+ *   createAgent: () => new Agent({ projectPath, provider, configDir, dataDir, ... }),
+ *   scenarioTimeoutMs: 15000,
+ * });
+ * const summary = await runner.runScenarios(EVAL_SCENARIOS);
+ * console.log(`通过 ${summary.passed}/${summary.total}，耗时 ${summary.durationMs}ms`);
+ * ```
+ */
+export declare class EvalRunner {
+    #private;
+    constructor(opts: EvalRunnerOptions);
+    /**
+     * 执行单个评估场景
+     *
+     * 流程：创建 Agent → init() → chat(input) → collectAgentChunks → evaluateResult
+     *
+     * 错误隔离：任何异常（超时、Agent 抛错）都返回 passed=false 的 EvalResult，
+     * 不向上抛出，确保 runScenarios 批量执行时单个失败不中断其他场景。
+     *
+     * Agent 生命周期：每个场景执行后 close()，避免资源泄漏（try/finally 保证）。
+     *
+     * @param scenario 评估场景定义
+     * @returns 评估结果（始终返回，不抛异常）
+     */
+    runScenario(scenario: EvalScenario): Promise<EvalResult>;
+    /**
+     * 批量执行评估场景并汇总报告
+     *
+     * 顺序执行（非并行），每个场景创建独立 Agent，避免状态污染。
+     * 错误隔离：单个场景失败不中断其他场景（由 runScenario 保证）。
+     *
+     * @param scenarios 场景列表
+     * @returns 汇总报告
+     */
+    runScenarios(scenarios: readonly EvalScenario[]): Promise<EvalSummary>;
+}
+//# sourceMappingURL=evalRunner.d.ts.map

package/dist/eval/evalRunner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evalRunner.d.ts","sourceRoot":"","sources":["../../src/eval/evalRunner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAG/D;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;;OAKG;IACH,WAAW,EAAE,MAAM,KAAK,CAAC;IAEzB;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,uBAAuB;IACvB,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,YAAY;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,YAAY;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,WAAW;IACX,KAAK,EAAE,MAAM,CAAC;IACd,eAAe;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc;IACd,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAKD;;;;;;;;;;;;GAYG;AACH,qBAAa,UAAU;;gBAMT,IAAI,EAAE,iBAAiB;IAKnC;;;;;;;;;;;;OAYG;IACG,WAAW,CAAC,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC,UAAU,CAAC;IA0B9D;;;;;;;;OAQG;IACG,YAAY,CAAC,SAAS,EAAE,SAAS,YAAY,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC;CA6D7E"}

package/dist/eval/evalRunner.js

@@ -0,0 +1,141 @@
+/**
+ * EvalRunner — Agent 行为评估执行器
+ *
+ * 职责：通过 createAgent 工厂构造测试条件 → 执行场景 →
+ *   收集 AgentChunk → 评估结果 → 汇总报告
+ *
+ * 设计要点：
+ *   - 每个场景创建独立 Agent（通过工厂函数），避免状态污染
+ *   - 场景执行后 close()，避免资源泄漏
+ *   - 错误隔离：单个场景失败不中断其他场景
+ *   - 超时保护：scenarioTimeoutMs 防止卡死（Promise.race + AbortController）
+ *
+ * 内核零依赖约束：仅使用 memora 内部模块，不引入新依赖。
+ */
+import { collectAgentChunks, evaluateResult } from './evalTypes.js';
+/** 默认场景超时_ms */
+const DEFAULT_SCENARIO_TIMEOUT_MS = 10_000;
+/**
+ * Agent 行为评估执行器
+ *
+ * @example
+ * ```ts
+ * const runner = new EvalRunner({
+ *   createAgent: () => new Agent({ projectPath, provider, configDir, dataDir, ... }),
+ *   scenarioTimeoutMs: 15000,
+ * });
+ * const summary = await runner.runScenarios(EVAL_SCENARIOS);
+ * console.log(`通过 ${summary.passed}/${summary.total}，耗时 ${summary.durationMs}ms`);
+ * ```
+ */
+export class EvalRunner {
+    /** Agent 工厂函数 */
+    #createAgent;
+    /** 单场景超时_ms */
+    #scenarioTimeoutMs;
+    constructor(opts) {
+        this.#createAgent = opts.createAgent;
+        this.#scenarioTimeoutMs = opts.scenarioTimeoutMs ?? DEFAULT_SCENARIO_TIMEOUT_MS;
+    }
+    /**
+     * 执行单个评估场景
+     *
+     * 流程：创建 Agent → init() → chat(input) → collectAgentChunks → evaluateResult
+     *
+     * 错误隔离：任何异常（超时、Agent 抛错）都返回 passed=false 的 EvalResult，
+     * 不向上抛出，确保 runScenarios 批量执行时单个失败不中断其他场景。
+     *
+     * Agent 生命周期：每个场景执行后 close()，避免资源泄漏（try/finally 保证）。
+     *
+     * @param scenario 评估场景定义
+     * @returns 评估结果（始终返回，不抛异常）
+     */
+    async runScenario(scenario) {
+        const agent = this.#createAgent();
+        try {
+            await agent.init();
+            const collected = await this.#runWithTimeout(agent, scenario.input);
+            return evaluateResult(scenario.name, collected, scenario.expect);
+        }
+        catch (err) {
+            // 错误隔离：返回 passed=false 的 EvalResult，不向上抛出
+            return {
+                name: scenario.name,
+                passed: false,
+                collected: {
+                    toolsCalled: [],
+                    recallCount: 0,
+                    guardrailBlocked: false,
+                    done: false,
+                },
+                failures: [
+                    `场景执行异常：${err instanceof Error ? err.message : String(err)}`,
+                ],
+            };
+        }
+        finally {
+            await agent.close();
+        }
+    }
+    /**
+     * 批量执行评估场景并汇总报告
+     *
+     * 顺序执行（非并行），每个场景创建独立 Agent，避免状态污染。
+     * 错误隔离：单个场景失败不中断其他场景（由 runScenario 保证）。
+     *
+     * @param scenarios 场景列表
+     * @returns 汇总报告
+     */
+    async runScenarios(scenarios) {
+        const start = Date.now();
+        const results = [];
+        for (const scenario of scenarios) {
+            const result = await this.runScenario(scenario);
+            results.push(result);
+        }
+        const passed = results.filter((r) => r.passed).length;
+        const failed = results.length - passed;
+        return {
+            results,
+            passed,
+            failed,
+            total: results.length,
+            durationMs: Date.now() - start,
+            failedScenarios: results.filter((r) => !r.passed).map((r) => r.name),
+        };
+    }
+    /**
+     * 带超时执行单个场景的 chat
+     *
+     * 使用 Promise.race 实现超时：
+     *   - 正常完成 → 返回 collected 行为数据
+     *   - 超时 → reject Error（被 runScenario 的 catch 捕获）
+     *
+     * 超时后通过 AbortController.abort() 中断 agent.chat，
+     * 避免后台 generator 无限挂起。agent.close() 在 runScenario 的 finally 中调用，
+     * 确保即使超时后资源也被正确清理。
+     */
+    async #runWithTimeout(agent, input) {
+        const controller = new AbortController();
+        let timer;
+        const timeoutPromise = new Promise((_, reject) => {
+            timer = setTimeout(() => {
+                controller.abort();
+                reject(new Error(`场景超时（${this.#scenarioTimeoutMs}ms）`));
+            }, this.#scenarioTimeoutMs);
+        });
+        const runPromise = collectAgentChunks(agent.chat(input, controller.signal));
+        // 抑制超时后 runPromise 可能产生的 unhandled rejection
+        // （超时后 agent.chat 被 abort，collectAgentChunks 可能在后台 resolve/reject，
+        //   但 Promise.race 已通过 timeoutPromise 返回，runPromise 的结果被丢弃）
+        void runPromise.catch(() => { });
+        try {
+            return await Promise.race([runPromise, timeoutPromise]);
+        }
+        finally {
+            if (timer)
+                clearTimeout(timer);
+        }
+    }
+}
+//# sourceMappingURL=evalRunner.js.map