@zooique/memora 0.1.0

package/dist/agent/tracer.d.ts

@@ -0,0 +1,122 @@
+/**
+ * Agent 可观测性接口 — 零依赖的轻量 Span/Trace 抽象
+ *
+ * 定义 ITracer 和 ISpan 接口，让宿主项目注入 OpenTelemetry 等实现。
+ * 默认 NoopTracer 静默丢弃所有 span，不引入任何运行时开销。
+ *
+ * 设计约束（详见 ADR-001 · 运行时栈，零依赖原则）：
+ *   - 禁止直接 import OpenTelemetry SDK（违反零依赖原则）
+ *   - Span 收集为 fire-and-forget，不阻塞 AgentLoop 主流程
+ *   - Tracer 未注入时自动降级，不抛异常
+ *
+ * 使用方式：
+ *   // 宿主侧（泊文等）
+ *   const otelTracer = new OpenTelemetryTracer(tracerProvider); // 宿主实现 ITracer
+ *   const agent = new Agent({ ..., tracer: otelTracer });
+ *
+ *   // memora 内部
+ *   const span = this.opts.tracer.startSpan('llm.call', { model: 'gpt-4o' });
+ *   // ... LLM 调用 ...
+ *   span.end();
+ */
+/** Span 属性值类型 */
+type SpanAttributeValue = string | number | boolean;
+/** Span 接口 — 一次可观测操作的基本单元 */
+export interface ISpan {
+    /** 设置 Span 属性（键值对元数据） */
+    setAttribute(key: string, value: SpanAttributeValue): void;
+    /** 标记 Span 结束 */
+    end(): void;
+    /** 记录异常（不中断 span，标记错误状态） */
+    recordException(error: Error): void;
+}
+/** Tracer 接口 — 宿主注入的可观测性实现 */
+export interface ITracer {
+    /**
+     * 开始一个新的 Span
+     *
+     * @param name - Span 名称（如 'llm.call'、'tool.execute'）
+     * @param attributes - 初始属性（可选）
+     * @returns ISpan 实例
+     */
+    startSpan(name: string, attributes?: Record<string, SpanAttributeValue>): ISpan;
+}
+/** NoopTracer 单例（在未注入 tracer 时使用） */
+export declare const NOOP_TRACER: ITracer;
+/**
+ * AgentLoop 关键节点的 Span 名称常量
+ *
+ * 供宿主项目按名称过滤 span 做监控面板。
+ */
+export declare const TRACE_SPANS: {
+    /** 记忆召回阶段 */
+    readonly RECALL: "recall.recall";
+    /** LLM API 调用 */
+    readonly LLM_CALL: "llm.call";
+    /** 工具执行 */
+    readonly TOOL_EXEC: "tool.execute";
+    /** 最终响应生成 */
+    readonly RESPONSE: "response.generate";
+    /** 记忆衰减执行（R-103 新增，补全衰减可观测性缺口） */
+    readonly DECAY: "memory.decay";
+};
+/**
+ * Agent 运行时指标快照
+ *
+ * 由 Agent.getMetrics() 聚合 AgentLoop + Agent 两层指标产出，
+ * 供宿主项目构建监控面板或健康度诊断面板。
+ *
+ * 设计原则：
+ *   - 纯只读快照——调用时不修改任何状态
+ *   - 同步返回——不触发 LLM 或 IO
+ *   - 累计值——指标从 Agent 初始化起累加，close() 后清零
+ *
+ * 分 5 个维度：LLM 调用、记忆召回、工具调用、上下文管理、记忆衰减。
+ */
+export interface AgentMetrics {
+    /** LLM 调用相关指标 */
+    llm: {
+        /** LLM 调用总次数（含重试，每次 provider.chat 调用算一次） */
+        callCount: number;
+        /** 累计输入 token 数（基于 estimateTokens 粗略估算） */
+        totalInputTokens: number;
+        /** 累计输出 token 数（基于 estimateTokens 粗略估算） */
+        totalOutputTokens: number;
+    };
+    /** 记忆召回相关指标 */
+    recall: {
+        /** 召回总次数（每轮对话 processUserInput 算一次） */
+        totalCount: number;
+        /** 命中次数（召回结果非空算命中） */
+        hitCount: number;
+        /** 命中率（0-1，hitCount / totalCount，totalCount 为 0 时返回 0） */
+        hitRate: number;
+    };
+    /** 工具调用相关指标 */
+    tools: {
+        /** 工具调用总次数 */
+        callCount: number;
+        /** 工具调用失败次数（结果以 [ERR 开头） */
+        failureCount: number;
+    };
+    /** 上下文管理指标 */
+    context: {
+        /** 上下文截断次数（messages 超过 maxContextTokens 触发截断的次数） */
+        truncationCount: number;
+        /** 当前工作记忆消息数 */
+        messageCount: number;
+        /** 当前估算 token 数（基于 estimateTokens） */
+        estimatedTokens: number;
+    };
+    /** 记忆衰减指标（由 Agent 层填充，AgentLoop 层此字段为 null） */
+    decay: {
+        /** 衰减执行次数 */
+        runCount: number;
+        /** 累计衰减记忆数（score 被调低的记忆条数） */
+        totalDecayedCount: number;
+        /** 上次衰减时间（ISO 8601，null 表示从未执行过） */
+        lastRunAt: string | null;
+    } | null;
+}
+export {};
+//# sourceMappingURL=tracer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tracer.d.ts","sourceRoot":"","sources":["../../src/agent/tracer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAIH,iBAAiB;AACjB,KAAK,kBAAkB,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAIpD,6BAA6B;AAC7B,MAAM,WAAW,KAAK;IACpB,yBAAyB;IACzB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAC3D,iBAAiB;IACjB,GAAG,IAAI,IAAI,CAAC;IACZ,4BAA4B;IAC5B,eAAe,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACrC;AAID,8BAA8B;AAC9B,MAAM,WAAW,OAAO;IACtB;;;;;;OAMG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,GAAG,KAAK,CAAC;CACjF;AA4BD,qCAAqC;AACrC,eAAO,MAAM,WAAW,EAAE,OAA0B,CAAC;AAIrD;;;;GAIG;AACH,eAAO,MAAM,WAAW;IACtB,aAAa;;IAEb,iBAAiB;;IAEjB,WAAW;;IAEX,aAAa;;IAEb,kCAAkC;;CAE1B,CAAC;AAIX;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,YAAY;IAC3B,iBAAiB;IACjB,GAAG,EAAE;QACH,4CAA4C;QAC5C,SAAS,EAAE,MAAM,CAAC;QAClB,2CAA2C;QAC3C,gBAAgB,EAAE,MAAM,CAAC;QACzB,2CAA2C;QAC3C,iBAAiB,EAAE,MAAM,CAAC;KAC3B,CAAC;IACF,eAAe;IACf,MAAM,EAAE;QACN,uCAAuC;QACvC,UAAU,EAAE,MAAM,CAAC;QACnB,sBAAsB;QACtB,QAAQ,EAAE,MAAM,CAAC;QACjB,0DAA0D;QAC1D,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,eAAe;IACf,KAAK,EAAE;QACL,cAAc;QACd,SAAS,EAAE,MAAM,CAAC;QAClB,4BAA4B;QAC5B,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,cAAc;IACd,OAAO,EAAE;QACP,oDAAoD;QACpD,eAAe,EAAE,MAAM,CAAC;QACxB,gBAAgB;QAChB,YAAY,EAAE,MAAM,CAAC;QACrB,sCAAsC;QACtC,eAAe,EAAE,MAAM,CAAC;KACzB,CAAC;IACF,+CAA+C;IAC/C,KAAK,EAAE;QACL,aAAa;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,8BAA8B;QAC9B,iBAAiB,EAAE,MAAM,CAAC;QAC1B,oCAAoC;QACpC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;KAC1B,GAAG,IAAI,CAAC;CACV"}

package/dist/agent/tracer.js

@@ -0,0 +1,64 @@
+/**
+ * Agent 可观测性接口 — 零依赖的轻量 Span/Trace 抽象
+ *
+ * 定义 ITracer 和 ISpan 接口，让宿主项目注入 OpenTelemetry 等实现。
+ * 默认 NoopTracer 静默丢弃所有 span，不引入任何运行时开销。
+ *
+ * 设计约束（详见 ADR-001 · 运行时栈，零依赖原则）：
+ *   - 禁止直接 import OpenTelemetry SDK（违反零依赖原则）
+ *   - Span 收集为 fire-and-forget，不阻塞 AgentLoop 主流程
+ *   - Tracer 未注入时自动降级，不抛异常
+ *
+ * 使用方式：
+ *   // 宿主侧（泊文等）
+ *   const otelTracer = new OpenTelemetryTracer(tracerProvider); // 宿主实现 ITracer
+ *   const agent = new Agent({ ..., tracer: otelTracer });
+ *
+ *   // memora 内部
+ *   const span = this.opts.tracer.startSpan('llm.call', { model: 'gpt-4o' });
+ *   // ... LLM 调用 ...
+ *   span.end();
+ */
+// ─── Noop 实现（默认，零开销）───────────────────────
+/** 空 Span 实现（静默丢弃所有操作） */
+class NoopSpan {
+    setAttribute(_key, _value) {
+        // noop
+    }
+    end() {
+        // noop
+    }
+    recordException(_error) {
+        // noop
+    }
+}
+/** 空 Tracer 实现（始终返回 NoopSpan） */
+class NoopTracer {
+    startSpan(_name, _attributes) {
+        // 共享同一个 NoopSpan 实例，避免分配开销
+        return NOOP_SPAN;
+    }
+}
+/** 共享的 NoopSpan 单例（避免每次 startSpan 分配新对象） */
+const NOOP_SPAN = new NoopSpan();
+/** NoopTracer 单例（在未注入 tracer 时使用） */
+export const NOOP_TRACER = new NoopTracer();
+// ─── AgentLoop 预定义 Span 名称 ─────────────────────
+/**
+ * AgentLoop 关键节点的 Span 名称常量
+ *
+ * 供宿主项目按名称过滤 span 做监控面板。
+ */
+export const TRACE_SPANS = {
+    /** 记忆召回阶段 */
+    RECALL: 'recall.recall',
+    /** LLM API 调用 */
+    LLM_CALL: 'llm.call',
+    /** 工具执行 */
+    TOOL_EXEC: 'tool.execute',
+    /** 最终响应生成 */
+    RESPONSE: 'response.generate',
+    /** 记忆衰减执行（R-103 新增，补全衰减可观测性缺口） */
+    DECAY: 'memory.decay',
+};
+//# sourceMappingURL=tracer.js.map

package/dist/agent/tracer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracer.js","sourceRoot":"","sources":["../../src/agent/tracer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAiCH,6CAA6C;AAE7C,0BAA0B;AAC1B,MAAM,QAAQ;IACZ,YAAY,CAAC,IAAY,EAAE,MAA0B;QACnD,OAAO;IACT,CAAC;IACD,GAAG;QACD,OAAO;IACT,CAAC;IACD,eAAe,CAAC,MAAa;QAC3B,OAAO;IACT,CAAC;CACF;AAED,iCAAiC;AACjC,MAAM,UAAU;IACd,SAAS,CAAC,KAAa,EAAE,WAAgD;QACvE,2BAA2B;QAC3B,OAAO,SAAS,CAAC;IACnB,CAAC;CACF;AAED,4CAA4C;AAC5C,MAAM,SAAS,GAAG,IAAI,QAAQ,EAAE,CAAC;AAEjC,qCAAqC;AACrC,MAAM,CAAC,MAAM,WAAW,GAAY,IAAI,UAAU,EAAE,CAAC;AAErD,kDAAkD;AAElD;;;;GAIG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,aAAa;IACb,MAAM,EAAE,eAAe;IACvB,iBAAiB;IACjB,QAAQ,EAAE,UAAU;IACpB,WAAW;IACX,SAAS,EAAE,cAAc;IACzB,aAAa;IACb,QAAQ,EAAE,mBAAmB;IAC7B,kCAAkC;IAClC,KAAK,EAAE,cAAc;CACb,CAAC"}

package/dist/agent/types.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Agent 流式输出事件类型
+ *
+ * 核心库向上层 emit 结构化事件，让 CLI/Web/TUI 等宿主项目
+ * 能区分"思考中"、"输出文本"、"调用工具"等阶段，给用户实时反馈。
+ *
+ * 自然生长原则：这是核心库的"机制"——所有宿主项目都需要进度反馈，
+ * 不是 demo 的"策略"。
+ *
+ * thinking 事件的 phase 取值：
+ * - 'recalling'：正在召回会话记忆（recall 双通道：语义 + 关键词）
+ * - 'processing'：正在写入历史/注入技能 prompt
+ * - 'archiving'：正在归档用户画像/匹配角色/匹配技能
+ *
+ * error 事件：流式过程中发生错误（如 LLM 超时、连接断开），
+ * 替代裸 throw 让宿主能优雅展示错误并清理 UI（避免未处理 rejection 静默卡死）。
+ */
+/** thinking 事件的阶段标识 */
+export type ThinkingPhase = 'recalling' | 'processing' | 'archiving';
+/**
+ * 召回记忆摘要（用于 UI 展示"召回透明度"）
+ *
+ * 仅暴露 UI 展示所需字段，不包含 content（避免向 UI 层泄露完整记忆内容）。
+ * - name：可读名称，点击跳转记忆详情
+ * - score：相似度分数（0-1），展示召回质量
+ * - source：来源标签，可选展示（如 rule/insight/profile）
+ */
+export interface RecalledMemorySummary {
+    /** 记忆可读名称（点击跳转记忆详情用） */
+    name: string;
+    /** 相似度分数（0-1） */
+    score: number;
+    /** 来源标签（开放字符串，如 'rule'、'insight'、'profile'） */
+    source: string;
+}
+export type AgentChunk = {
+    type: 'recall';
+    memories: RecalledMemorySummary[];
+} | {
+    type: 'thinking';
+    phase: ThinkingPhase;
+} | {
+    type: 'text';
+    content: string;
+} | {
+    type: 'tool_start';
+    toolCallId: string;
+    name: string;
+    args?: string;
+} | {
+    type: 'tool_result';
+    toolCallId: string;
+    name: string;
+    ok: boolean;
+    summary?: string;
+} | {
+    type: 'aborted';
+    reason: string;
+} | {
+    type: 'error';
+    message: string;
+} | {
+    type: 'done';
+};
+/**
+ * 宿主可覆盖的 UI 消息文本
+ *
+ * 核心库内置英文默认值，宿主可通过 AgentOptions.messages
+ * 覆盖为任意语言（中文/日文/自定义）。
+ *
+ * 遵循领域无关原则：核心库不耦合特定语言。
+ */
+export interface UIMessages {
+    /** 对话取消提示（默认 "User cancelled the conversation"） */
+    abortedByUser?: string;
+    /** 达到最大迭代次数提示（默认 "\n\n[Max iterations reached]"） */
+    maxIterationsReached?: string;
+    /**
+     * 上下文窗口截断提示生成函数
+     * @param skipped 被裁剪的消息数
+     * @param kept 保留的消息数
+     * @returns 系统消息内容
+     */
+    contextTruncated?: (skipped: number, kept: number) => string;
+    /** 最近对话标签（默认 "[Recent conversation]"） */
+    recentConversationLabel?: string;
+    /** 用户角色标签（默认 "User"） */
+    userLabel?: string;
+    /** 助手角色标签（默认 "Assistant"） */
+    assistantLabel?: string;
+    /** 护栏阻断提示模板（{rule} 会被替换为规则名） */
+    inputBlockedByGuard?: (rule: string) => string;
+    /** 护栏警告前缀（默认 "[Guardrail Warning]"） */
+    guardrailWarningPrefix?: string;
+    /** 输出被护栏阻断提示模板 */
+    outputBlockedByGuard?: (rule: string) => string;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/agent/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,uBAAuB;AACvB,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,YAAY,GAAG,WAAW,CAAC;AAErE;;;;;;;GAOG;AACH,MAAM,WAAW,qBAAqB;IACpC,wBAAwB;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,iBAAiB;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,UAAU,GAClB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,EAAE,qBAAqB,EAAE,CAAA;CAAE,GACrD;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,aAAa,CAAA;CAAE,GAC1C;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GACvE;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GACxF;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAIrB;;;;;;;GAOG;AACH,MAAM,WAAW,UAAU;IACzB,mDAAmD;IACnD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oDAAoD;IACpD,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IAC7D,yCAAyC;IACzC,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,wBAAwB;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6BAA6B;IAC7B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gCAAgC;IAChC,mBAAmB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IAC/C,uCAAuC;IACvC,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,kBAAkB;IAClB,oBAAoB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;CACjD"}

package/dist/agent/types.js

@@ -0,0 +1,19 @@
+/**
+ * Agent 流式输出事件类型
+ *
+ * 核心库向上层 emit 结构化事件，让 CLI/Web/TUI 等宿主项目
+ * 能区分"思考中"、"输出文本"、"调用工具"等阶段，给用户实时反馈。
+ *
+ * 自然生长原则：这是核心库的"机制"——所有宿主项目都需要进度反馈，
+ * 不是 demo 的"策略"。
+ *
+ * thinking 事件的 phase 取值：
+ * - 'recalling'：正在召回会话记忆（recall 双通道：语义 + 关键词）
+ * - 'processing'：正在写入历史/注入技能 prompt
+ * - 'archiving'：正在归档用户画像/匹配角色/匹配技能
+ *
+ * error 事件：流式过程中发生错误（如 LLM 超时、连接断开），
+ * 替代裸 throw 让宿主能优雅展示错误并清理 UI（避免未处理 rejection 静默卡死）。
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/agent/types.js.map

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

package/dist/config/loader.d.ts

@@ -0,0 +1,229 @@
+import { z } from 'zod';
+declare const ConfigSchema: z.ZodObject<{
+    llm: z.ZodObject<{
+        provider: z.ZodDefault<z.ZodString>;
+        model: z.ZodDefault<z.ZodString>;
+        baseUrl: z.ZodOptional<z.ZodString>;
+        apiKey: z.ZodOptional<z.ZodString>;
+        temperature: z.ZodDefault<z.ZodNumber>;
+        /**
+         * 多 Provider 映射表
+         *
+         * key 为 Provider 别名（如 "deepseek"、"openai"），value 为 Provider 配置。
+         * 配置后，旧扁平字段（provider/model/baseUrl/apiKey）被忽略。
+         * 不配置时回退到旧的单 provider 行为——完全向后兼容。
+         */
+        providers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+            provider: z.ZodString;
+            model: z.ZodString;
+            baseUrl: z.ZodOptional<z.ZodString>;
+            apiKey: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            model: string;
+            provider: string;
+            apiKey?: string | undefined;
+            baseUrl?: string | undefined;
+        }, {
+            model: string;
+            provider: string;
+            apiKey?: string | undefined;
+            baseUrl?: string | undefined;
+        }>>>;
+        /**
+         * 当前激活的 Provider 别名
+         *
+         * 必须与 providers 中的某个 key 一致。
+         * 不配置时默认使用 providers 的第一个 key。
+         */
+        active: z.ZodOptional<z.ZodString>;
+        /**
+         * 后台通道配置（多 Provider 路由预留）
+         *
+         * 不配时所有消费者复用前台（llm）配置——零破坏性，完全向后兼容。
+         * 配置后，归档/投影/画像等后台操作使用此通道，降低成本。
+         * 详见接入指南 §九
+         */
+        background: z.ZodOptional<z.ZodObject<{
+            provider: z.ZodString;
+            model: z.ZodString;
+            baseUrl: z.ZodOptional<z.ZodString>;
+            apiKey: z.ZodOptional<z.ZodString>;
+            temperature: z.ZodDefault<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            temperature: number;
+            model: string;
+            provider: string;
+            apiKey?: string | undefined;
+            baseUrl?: string | undefined;
+        }, {
+            model: string;
+            provider: string;
+            apiKey?: string | undefined;
+            temperature?: number | undefined;
+            baseUrl?: string | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        temperature: number;
+        model: string;
+        provider: string;
+        background?: {
+            temperature: number;
+            model: string;
+            provider: string;
+            apiKey?: string | undefined;
+            baseUrl?: string | undefined;
+        } | undefined;
+        apiKey?: string | undefined;
+        baseUrl?: string | undefined;
+        providers?: Record<string, {
+            model: string;
+            provider: string;
+            apiKey?: string | undefined;
+            baseUrl?: string | undefined;
+        }> | undefined;
+        active?: string | undefined;
+    }, {
+        background?: {
+            model: string;
+            provider: string;
+            apiKey?: string | undefined;
+            temperature?: number | undefined;
+            baseUrl?: string | undefined;
+        } | undefined;
+        apiKey?: string | undefined;
+        temperature?: number | undefined;
+        model?: string | undefined;
+        provider?: string | undefined;
+        baseUrl?: string | undefined;
+        providers?: Record<string, {
+            model: string;
+            provider: string;
+            apiKey?: string | undefined;
+            baseUrl?: string | undefined;
+        }> | undefined;
+        active?: string | undefined;
+    }>;
+    memory: z.ZodObject<{
+        dataDir: z.ZodDefault<z.ZodString>;
+        maxContextTokens: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        maxContextTokens: number;
+        dataDir: string;
+    }, {
+        maxContextTokens?: number | undefined;
+        dataDir?: string | undefined;
+    }>;
+    security: z.ZodObject<{
+        permission: z.ZodDefault<z.ZodEnum<["owner", "guest"]>>;
+        confirmWrites: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        permission: "owner" | "guest";
+        confirmWrites: boolean;
+    }, {
+        permission?: "owner" | "guest" | undefined;
+        confirmWrites?: boolean | undefined;
+    }>;
+    allowedPaths: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    persona: z.ZodOptional<z.ZodString>;
+    /**
+     * Embedding 配置（可选，配置后启用向量语义召回）
+     *
+     * 复用 OpenAI 兼容协议的 /embeddings 端点。
+     * 不配置时降级为纯关键词召回（当前行为）。
+     */
+    embedding: z.ZodOptional<z.ZodObject<{
+        model: z.ZodString;
+        baseUrl: z.ZodOptional<z.ZodString>;
+        apiKey: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        model: string;
+        apiKey?: string | undefined;
+        baseUrl?: string | undefined;
+    }, {
+        model: string;
+        apiKey?: string | undefined;
+        baseUrl?: string | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    llm: {
+        temperature: number;
+        model: string;
+        provider: string;
+        background?: {
+            temperature: number;
+            model: string;
+            provider: string;
+            apiKey?: string | undefined;
+            baseUrl?: string | undefined;
+        } | undefined;
+        apiKey?: string | undefined;
+        baseUrl?: string | undefined;
+        providers?: Record<string, {
+            model: string;
+            provider: string;
+            apiKey?: string | undefined;
+            baseUrl?: string | undefined;
+        }> | undefined;
+        active?: string | undefined;
+    };
+    security: {
+        permission: "owner" | "guest";
+        confirmWrites: boolean;
+    };
+    memory: {
+        maxContextTokens: number;
+        dataDir: string;
+    };
+    allowedPaths: string[];
+    persona?: string | undefined;
+    embedding?: {
+        model: string;
+        apiKey?: string | undefined;
+        baseUrl?: string | undefined;
+    } | undefined;
+}, {
+    llm: {
+        background?: {
+            model: string;
+            provider: string;
+            apiKey?: string | undefined;
+            temperature?: number | undefined;
+            baseUrl?: string | undefined;
+        } | undefined;
+        apiKey?: string | undefined;
+        temperature?: number | undefined;
+        model?: string | undefined;
+        provider?: string | undefined;
+        baseUrl?: string | undefined;
+        providers?: Record<string, {
+            model: string;
+            provider: string;
+            apiKey?: string | undefined;
+            baseUrl?: string | undefined;
+        }> | undefined;
+        active?: string | undefined;
+    };
+    security: {
+        permission?: "owner" | "guest" | undefined;
+        confirmWrites?: boolean | undefined;
+    };
+    memory: {
+        maxContextTokens?: number | undefined;
+        dataDir?: string | undefined;
+    };
+    persona?: string | undefined;
+    allowedPaths?: string[] | undefined;
+    embedding?: {
+        model: string;
+        apiKey?: string | undefined;
+        baseUrl?: string | undefined;
+    } | undefined;
+}>;
+export type Config = z.infer<typeof ConfigSchema>;
+/**
+ * 加载配置
+ * @param configPath 显式指定的配置文件路径
+ */
+export declare function loadConfig(configPath?: string): Promise<Config>;
+export {};
+//# sourceMappingURL=loader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/config/loader.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAcxB,QAAA,MAAM,YAAY;;;;;;;QAQd;;;;;;WAMG;;;;;;;;;;;;;;;;;QAEH;;;;;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"}