@zooique/memora 2.0.3 → 3.0.0

package/dist/index.d.ts

@@ -1,111 +1,101 @@
 /**
- * Memora — 通用 Agent 架构（纯逻辑库）
- *
- * Node.js 专用纯逻辑库（零 native 编译依赖，详见 ADR-002 §定位澄清）。
- * 宿主项目通过注入 IMemoryStorage 实现持久化。
- * CLI 由宿主项目提供（hosts/memora-sprite/）。
- *
- * 设计哲学：万物皆记忆（详见 architecture_philosophy_rules.md §1）
- * 决策追溯：详见 .trae/rules/decisions/ 下的 ADR
- *
- * ─── 类型依赖图 ────────────────────────────────────────────
- *
- * 各模块独立 types.ts，跨模块类型追踪可按以下依赖图定位：
- *
- *   agent/types.ts ─┬─→ llm/provider.ts (LlmProvider, ChatOptions)
- *                   ├─→ memory/vectorStore.ts (IVectorStore, EmbeddingService)
- *                   ├─→ memory/storageInterface.ts (IMemoryStorage)
- *                   ├─→ memory/relationStore.ts (IMemoryRelationStore)
- *                   ├─→ memory/sessionStore.ts (ISessionStore, SessionMessage)
- *                   ├─→ agent/tracer.ts (ITracer, ISpan, AgentMetrics)
- *                   └─→ memory/projectManager.ts (AgentProjectEntry)
- *
- *   memory/types.ts ──→ 纯类型定义（Memory, MemoryRelation, SOURCE_LABELS 等）
- *
- *   llm/types.ts ─────→ 纯类型定义（LlmChunk）
- *
- *   persona/types.ts ─→ 纯类型定义（Persona, PersonaMode）
- *
- *   skill/types.ts ───→ 纯类型定义（SkillEntry, SkillMatch）
- *
- *   eval/evalTypes.ts ─→ 纯类型定义（EvalScenario, EvalResult）
- *
- *   security/pathGuard.ts ─→ AuditEvent 等安全类型（与 agent/types.ts 解耦）
- *
- * 依赖方向（单向）：agent → memory → utils；agent → llm；agent → security
- * 内核不反向依赖宿主，所有宿主交互通过接口注入（ADR-002 §三层架构）
+ * Memora — 通用 Agent 纯逻辑库（Node.js，零 native 依赖）
+ * 公共导出面：宿主项目通过本入口 import 接入；持久化/搜索/会话等宿主能力均经接口注入。
+ * 类型依赖方向单向（agent → memory → utils；agent → llm；agent → security），详见 module-inventory.md。
  */
 export { Agent } from './agent/agent.js';
-export type { AgentChunk, ThinkingPhase, UIMessages, ArchiveMode, RecalledMemorySummary, AgentOptions, AgentContext, AgentProjectEntry } from './agent/types.js';
+export type { AgentChunk, ThinkingPhase, AbortStopReason, LlmErrorCategory, UIMessages, ArchiveMode, AgentOptions, AgentContext, } from './agent/types.js';
+export type { DuplicateCallInterceptor, DuplicateCheckVerdict, DuplicateCheckContext, } from './agent/types.js';
+export { DefaultDuplicateCallInterceptor } from './agent/duplicateInterceptor.js';
 export { AGENT_CONSTANTS, LOOP_CONSTANTS } from './agent/constants.js';
+export { resolveContextWindow } from './agent/budget.js';
+export { estimateOccupancy, type EstimateOccupancyInput } from './agent/budget.js';
+export { estimateTokensMessages, estimateTokensText, type EstimableMessage, } from './agent/contextManager.js';
 export { type AgentForkResult } from './agent/managers/sessionManager.js';
-export type { ToolDefinition, ToolHandler, ToolContext, WriteExtensions } from './agent/toolExecutor.js';
-export type { PersonaMode, Persona } from './persona/types.js';
-export type { MemoryKeywords } from './agent/managers/insightExtractor.js';
-export { RelationBuilder } from './agent/managers/relationBuilder.js';
-export type { ConflictInfo } from './agent/managers/relationBuilder.js';
-export type { MemorySnapshot, WorkingMemorySnapshot, BootstrapSnapshot, ArchiveSnapshot, AgentSearchHit, AgentStats, SuggestOptions, SuggestHit, SourceHealthStatus, SourceHealthEntry, SourceHealthReport, } from './agent/managers/memoryInspector.js';
-export type { DedupPair, DedupVerdict, DedupVerdictSummary, DedupReport, } from './agent/managers/dedupManager.js';
-export type { ConfigSuggestion, ConfigSuggestionHandler } from './agent/managers/configManager.js';
-export type { AutoConfigRefinerOptions } from './agent/managers/autoConfigRefiner.js';
-export type { SessionArchiveResult } from './agent/managers/sessionArchiver.js';
-export type { TimelinessVerdict, TimelinessReport } from './agent/managers/memoryDecayScheduler.js';
-export type { ConflictVerdict, ConflictReport } from './agent/managers/memoryAdvisor.js';
+export type { SessionManager } from './agent/managers/sessionManager.js';
+export type { ToolDefinition, ToolHandler, ToolContext, WriteExtensions, } from './agent/toolExecutor.js';
+export type { IdempotencyLevel, ToolExecutionRecord } from './agent/types.js';
+export { WRITE_PATH_EXTRACTORS } from './agent/toolResultCache.js';
+export { OPAQUE_WRITE_TOOL_NAMES } from './agent/builtinTools.js';
+export type { RolePack, RolePackMeta, RolePackAssembly, RolePackTeam, RolePackCapability, RolePackManifestSkill, BehaviorStrategy, PrepareStrategy, ActStrategy, ReflectStrategy, GlobalStrategy, ToolReadonly, ProviderRouting, MultiStepReasoning, SelfReviewRounds, UserFollowup, ErrorHandling, } from './role-pack/types.js';
+export { DEFAULT_BEHAVIOR_STRATEGY, mergeStrategy, assembleRolePack, } from './role-pack/strategyResolver.js';
+export { BUILTIN_FALLBACK_PACK, MAX_TEAM_MEMBERS } from './role-pack/constants.js';
+export { RolePackManager } from './role-pack/rolePackManager.js';
+export { validateManifest, validateManifestText, checkCompanionContentRedline, } from './role-pack/validator.js';
+export type { RolePackValidationIssue, RolePackValidationResult, RolePackIssueSeverity, } from './role-pack/validator.js';
+export type { MemoryInspector, MemorySnapshot, WorkingMemorySnapshot, BootstrapSnapshot, ArchiveSnapshot, AgentSearchHit, AgentStats, } from './agent/managers/memoryInspector.js';
 export { MemoryGovernance } from './agent/managers/memoryGovernance.js';
+export { WorkProjectionManager } from './agent/managers/workProjection.js';
 export type { WorkProjectionEntry } from './agent/managers/workProjection.js';
+export { accumulateStream } from './agent/managers/streamAccumulator.js';
 export type { PolishResult } from './agent/managers/textPolishManager.js';
+export { RoundSummaryGenerator } from './agent/managers/roundSummaryGenerator.js';
 export { loadConfig } from './config/loader.js';
 export { createLlmProvider, createProviderFromConfig } from './llm/factory.js';
 export type { ProviderConfig } from './llm/factory.js';
 export type { LlmProvider, ChatOptions } from './llm/provider.js';
-export type { LlmChunk } from './llm/types.js';
-export { OpenAICompatibleProvider } from './llm/openaiCompatible.js';
-export type { OpenAICompatibleConfig } from './llm/openaiCompatible.js';
+export type { LlmChunk, TaskType, ProviderRouter } from './llm/types.js';
 export type { Config } from './config/loader.js';
-export { TypedEventEmitter } from './utils/eventEmitter.js';
+export { TypedEventEmitter, AGENT_EVENTS } from './utils/eventEmitter.js';
 export type { AgentEventMap, AgentEventName, AgentEventHandler } from './utils/eventEmitter.js';
+export { buildSessionId, splitSessionId } from './utils/time.js';
 export type { ITracer, ISpan, AgentMetrics } from './agent/tracer.js';
 export { NOOP_TRACER, TRACE_SPANS } from './agent/tracer.js';
-export { SOURCE_LABELS } from './memory/types.js';
-export type { Memory } from './memory/types.js';
-export { inferSource, escapeLike, validateSource } from './memory/sourceValidation.js';
+export { SOURCE_LABELS, SUMMARY_TYPES } from './memory/types.js';
+export type { Memory, SummaryType } from './memory/types.js';
+/**
+ * 记忆解析器（宿主读档复用内核校验，避免宿主另写一份字段白名单）
+ * 白名单构造：剥离未知字段（旧档 score 等），见 src/memory/types.ts
+ */
+export { parseMemory } from './memory/types.js';
+export { escapeLike, escapeLikeSnippet, validateSource } from './memory/sourceValidation.js';
 export type { SourceValidationSeverity } from './memory/sourceValidation.js';
-export { RELATION_TYPES, RELATION_WEIGHTS } from './memory/types.js';
-export type { MemoryRelation, RelationDirection, RelationPath, RelationNeighbor } from './memory/types.js';
 export type { IMemoryStorage } from './memory/storageInterface.js';
 export { InMemoryStorage } from './memory/inMemoryStorage.js';
-export { BOOST_INCREMENT, SCORE_CEILING, DECAY_FLOOR, DECAY_AGE_DAYS, DECAY_AMOUNT } from './memory/governance.js';
-export type { IMemoryRelationStore } from './memory/relationStore.js';
-export { InMemoryRelationStore } from './memory/inMemoryRelationStore.js';
+export type { IWebSearchProvider, SearchResult, WebSearchOptions, SearchEndpoint, } from './web-search/types.js';
+export { FetchWebSearchProvider } from './web-search/fetchWebSearchProvider.js';
+export { buildSearchEndpoints, type SearchEngineName, } from './web-search/fetchWebSearchProvider.js';
+export { safeSearch } from './web-search/webSearchProvider.js';
+export type { IFetchProvider, FetchedPage, FetchOptions } from './web-fetch/types.js';
+export { FetchWebFetchProvider } from './web-fetch/fetchWebFetchProvider.js';
+export { safeFetch } from './web-fetch/webFetchProvider.js';
+export type { ICodeExecutionProvider, CodeExecutionResult, CodeExecutionOptions, } from './code-exec/types.js';
+export { safeExecuteCode } from './code-exec/codeExecutionProvider.js';
+export type { IProjectSearchProvider, ProjectFileMatch, ProjectFileSearchOptions, ProjectFileSearchResult, ProjectTextMatch, ProjectTextSearchOptions, ProjectTextSearchResult, } from './project-search/types.js';
+export { safeSearchProjectFiles, safeSearchProjectText, } from './project-search/projectSearchProvider.js';
+export { SEARCH_PROJECT_TOOL } from './agent/builtinTools.js';
+export { PROJECT_SEARCH_RESULT_MAX_LEN } from './agent/toolExecutor.js';
+export { IGNORED_DIR_NAMES } from './agent/builtinToolHandlers.js';
 export { ProjectRegistry } from './memory/projectRegistry.js';
 export type { ProjectEntry } from './memory/projectRegistry.js';
 export { LockManager } from './memory/lockManager.js';
-export type { UserProfileEntry, ProfileCategory, ExtractedFact } from './memory/userProfile.js';
-export { JsonVectorStore } from './memory/vectorStore.js';
-export type { IVectorStore, EmbeddingService } from './memory/vectorStore.js';
-export { EmbeddingProvider } from './llm/embedding.js';
-export type { EmbeddingConfig, EmbeddingResult } from './llm/embedding.js';
-export type { EmbeddingOptions } from './llm/embedding.js';
-export type { ISessionStore, SessionMessage } from './memory/sessionStore.js';
+export type { ISessionStore, SessionMessage, SessionMeta } from './memory/sessionStore.js';
+export { getSessionDisplayName } from './memory/sessionStore.js';
+export type { Round, RoundMessage, RoundStatus, IRoundStore } from './memory/roundStore.js';
+export type { InteractiveInputKind } from './memory/roundStore.js';
+export type { RoundEvidenceEvent } from './memory/roundStore.js';
+export type { ProcessEvent, ProcessThinkingPhase, ProcessMetaPayload, ProcessMetricsPayload, } from './memory/roundStore.js';
+export { generateRoundId, generateMessageId, createPendingRound, completeRound, isRoundSettled, } from './memory/roundStore.js';
+export type { ISessionViewLoader, SessionView, SessionSummary, } from './memory/sessionViewLoader.js';
+export { InMemorySessionViewLoader } from './memory/inMemorySessionViewLoader.js';
+export { InMemoryRoundStore } from './memory/inMemoryRoundStore.js';
+export { InMemorySessionStore } from './memory/inMemorySessionStore.js';
+export { defaultTitle as defaultSessionTitle } from './agent/managers/sessionNamer.js';
+export { TRACE_SUMMARY_TOOL } from './agent/builtinTools.js';
+export type { SessionCheckpoint, PauseMeta, PlanItemOutcome, PlanItem } from './agent/types.js';
 export type { ForkResult } from './agent/messageHistory.js';
-export { recall, extractKeywords } from './memory/recall.js';
-export type { RecallOptions } from './memory/recall.js';
 export type { ILogger } from './logging/loggerInterface.js';
 export { setLogger, logger } from './logging/logger.js';
 export { segmentText, segmentLower } from './utils/segmenter.js';
 export { isPlainObject } from './utils/objects.js';
 export { parseFrontmatter, serializeFrontmatter } from './utils/frontmatter.js';
-export { safeSetTimeout, safeSetInterval, clearSafeTimeout, clearSafeInterval } from './utils/safeTimer.js';
-export type { SkillEntry, SkillMatch } from './skill/types.js';
+export { safeSetTimeout, safeSetInterval, clearSafeTimeout, clearSafeInterval, } from './utils/safeTimer.js';
+export type { SkillEntry } from './skill/types.js';
 export type { AuditEvent, AuditListener, Permission, WriteDecision, WriteConfirmationInfo, WriteConfirmationRequest, } from './security/pathGuard.js';
+export { MAX_DIFF_CONTENT_LENGTH } from './security/pathGuard.js';
 export { MemoraError, ToolErrorCode, isRetryableErrorCode } from './utils/errors.js';
 export { toError } from './utils/toError.js';
 export type { ToolErrorCodeValue } from './utils/errors.js';
-export { truncate } from './utils/strings.js';
+export { truncate, isValidConfigName, parseConfigId, MAX_CONFIG_NAME_LENGTH, } from './utils/strings.js';
 export { formatDateKey, todayDate } from './utils/time.js';
-export type { EvalScenario, EvalExpectation, EvalResult } from './eval/evalTypes.js';
-export { collectAgentChunks, evaluateResult } from './eval/evalTypes.js';
-export { EVAL_SCENARIOS } from './eval/scenarios.js';
-export { EvalRunner } from './eval/evalRunner.js';
-export type { EvalRunnerOptions, EvalSummary } from './eval/evalRunner.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -1,94 +1,115 @@
 /**
- * Memora — 通用 Agent 架构（纯逻辑库）
- *
- * Node.js 专用纯逻辑库（零 native 编译依赖，详见 ADR-002 §定位澄清）。
- * 宿主项目通过注入 IMemoryStorage 实现持久化。
- * CLI 由宿主项目提供（hosts/memora-sprite/）。
- *
- * 设计哲学：万物皆记忆（详见 architecture_philosophy_rules.md §1）
- * 决策追溯：详见 .trae/rules/decisions/ 下的 ADR
- *
- * ─── 类型依赖图 ────────────────────────────────────────────
- *
- * 各模块独立 types.ts，跨模块类型追踪可按以下依赖图定位：
- *
- *   agent/types.ts ─┬─→ llm/provider.ts (LlmProvider, ChatOptions)
- *                   ├─→ memory/vectorStore.ts (IVectorStore, EmbeddingService)
- *                   ├─→ memory/storageInterface.ts (IMemoryStorage)
- *                   ├─→ memory/relationStore.ts (IMemoryRelationStore)
- *                   ├─→ memory/sessionStore.ts (ISessionStore, SessionMessage)
- *                   ├─→ agent/tracer.ts (ITracer, ISpan, AgentMetrics)
- *                   └─→ memory/projectManager.ts (AgentProjectEntry)
- *
- *   memory/types.ts ──→ 纯类型定义（Memory, MemoryRelation, SOURCE_LABELS 等）
- *
- *   llm/types.ts ─────→ 纯类型定义（LlmChunk）
- *
- *   persona/types.ts ─→ 纯类型定义（Persona, PersonaMode）
- *
- *   skill/types.ts ───→ 纯类型定义（SkillEntry, SkillMatch）
- *
- *   eval/evalTypes.ts ─→ 纯类型定义（EvalScenario, EvalResult）
- *
- *   security/pathGuard.ts ─→ AuditEvent 等安全类型（与 agent/types.ts 解耦）
- *
- * 依赖方向（单向）：agent → memory → utils；agent → llm；agent → security
- * 内核不反向依赖宿主，所有宿主交互通过接口注入（ADR-002 §三层架构）
+ * Memora — 通用 Agent 纯逻辑库（Node.js，零 native 依赖）
+ * 公共导出面：宿主项目通过本入口 import 接入；持久化/搜索/会话等宿主能力均经接口注入。
+ * 类型依赖方向单向（agent → memory → utils；agent → llm；agent → security），详见 module-inventory.md。
  */
 // ─── 库导出：供宿主项目 import 接入 ──────────────────────
 export { Agent } from './agent/agent.js';
+export { DefaultDuplicateCallInterceptor } from './agent/duplicateInterceptor.js';
 export { AGENT_CONSTANTS, LOOP_CONSTANTS } from './agent/constants.js';
-// RelationBuilder 从 InsightExtractor 提取，封装 ADR-014 关系构建逻辑
-export { RelationBuilder } from './agent/managers/relationBuilder.js';
-// 记忆治理统一门面
+// 上下文窗口解析（单一真理源公式）：宿主在构造 Agent 前将 provider.contextWindow 与
+// 用户全局上限解析为单一 maxContextTokens 数字，避免跨宿主镜像 min 逻辑
+export { resolveContextWindow } from './agent/budget.js';
+// 上下文占用快照组装（SSOT 单点）：宿主历史会话重算占用时与内核 prepare 共用同一收敛口径
+export { estimateOccupancy } from './agent/budget.js';
+// token 估算（CJK 感知，零状态纯函数）：
+//   estimateTokensMessages = 消息序列（先累计后取整，与运行时 prepare 同口径，历史会话重算用它）
+//   estimateTokensText     = 单段文本（逐条场景；用于消息序列会放大取整误差）
+export { estimateTokensMessages, estimateTokensText, } from './agent/contextManager.js';
+// WRITE_PATH_EXTRACTORS：「按 args.path 改盘的工具」清单的**单一真理源**（loop 同路径写串行闸的判据）。
+// 宿主改动追踪（fileChangeTracker）据其 keys 派生触发集合，禁并列维护第二份清单——
+// 内核新增按 path 的写工具时宿主自动跟随，防「内核进串行闸、宿主不知情」的静默少报。
+export { WRITE_PATH_EXTRACTORS } from './agent/toolResultCache.js';
+// OPAQUE_WRITE_TOOL_NAMES：目标不可静态定位的写工具（脚本/内部索引类，diskWrite:'opaque'）。
+// 宿主改动可视化对其做「执行前后目录快照 diff」收口（见 fileChangeTracker.noteExternalMutations），
+// 禁并列维护第二份清单（两份必漂移 = 脚本类改动静默不追踪）。
+export { OPAQUE_WRITE_TOOL_NAMES } from './agent/builtinTools.js';
+export { DEFAULT_BEHAVIOR_STRATEGY, mergeStrategy, assembleRolePack, } from './role-pack/strategyResolver.js';
+export { BUILTIN_FALLBACK_PACK, MAX_TEAM_MEMBERS } from './role-pack/constants.js';
+export { RolePackManager } from './role-pack/rolePackManager.js';
+// 角色包格式校验器：manifest.json 唯一核心控制文件 + companion 内容红线检测
+export { validateManifest, validateManifestText, checkCompanionContentRedline, } from './role-pack/validator.js';
 export { MemoryGovernance } from './agent/managers/memoryGovernance.js';
+export { WorkProjectionManager } from './agent/managers/workProjection.js';
+// accumulateStream: 宿主可复用的 LLM 流式响应累积工具（用于生成标题、描述等短文本）
+export { accumulateStream } from './agent/managers/streamAccumulator.js';
+// 记忆即摘要架构：轮次摘要生成器
+export { RoundSummaryGenerator } from './agent/managers/roundSummaryGenerator.js';
 export { loadConfig } from './config/loader.js';
+// LLM Provider 构造（边界：provider 选择/默认值归宿主，内核只做实例构造与校验）：
+//   createProviderFromConfig —— 【规范入口】宿主传入 baseUrl+model+apiKey，校验后创建；
+//   createLlmProvider —— 【配置驱动便利】从完整 Config 读 llm.active 解析激活 provider
+//     （选择策略在内核侧），仅当你把整份 Config 托管给内核时使用，边界守法的宿主应自建 provider 后调前者。
 export { createLlmProvider, createProviderFromConfig } from './llm/factory.js';
-export { OpenAICompatibleProvider } from './llm/openaiCompatible.js';
 // 事件系统
-export { TypedEventEmitter } from './utils/eventEmitter.js';
+export { TypedEventEmitter, AGENT_EVENTS } from './utils/eventEmitter.js';
+// 会话标识格式契约（SSOT 单点）：date/session 双向转换唯一真理源，宿主导入后不再手写 slice/split
+export { buildSessionId, splitSessionId } from './utils/time.js';
 export { NOOP_TRACER, TRACE_SPANS } from './agent/tracer.js';
 // ─── 记忆层导出 ──────────────────────────────────────────
-export { SOURCE_LABELS } from './memory/types.js';
-// Source 校验工具（从 types.ts 拆分到 sourceValidation.ts，公共 API 不变）
-export { inferSource, escapeLike, validateSource } from './memory/sourceValidation.js';
-// 记忆关系图谱（ADR-014 侧车模型）
-export { RELATION_TYPES, RELATION_WEIGHTS } from './memory/types.js';
+export { SOURCE_LABELS, SUMMARY_TYPES } from './memory/types.js';
+/**
+ * 记忆解析器（宿主读档复用内核校验，避免宿主另写一份字段白名单）
+ * 白名单构造：剥离未知字段（旧档 score 等），见 src/memory/types.ts
+ */
+export { parseMemory } from './memory/types.js';
+export { escapeLike, escapeLikeSnippet, validateSource } from './memory/sourceValidation.js';
 export { InMemoryStorage } from './memory/inMemoryStorage.js';
-// 治理共享常量（MIND2-L3：宿主 SqliteStorage incrementScore/setScore 实现需要 clamp 边界）
-// 衰减常量同步导出：宿主 SqliteStorage.decayScores 与核心库 recall.ts 共用同一真理源（v2 神木回天 REPEAT-3 闭环）
-export { BOOST_INCREMENT, SCORE_CEILING, DECAY_FLOOR, DECAY_AGE_DAYS, DECAY_AMOUNT } from './memory/governance.js';
-export { InMemoryRelationStore } from './memory/inMemoryRelationStore.js';
-// 项目注册表 + 锁文件管理（从 ProjectManager 提取）
-// 宿主可直接使用 ProjectRegistry/LockManager 管理多项目，或通过 ProjectManager 间接委托
+// FetchWebSearchProvider：默认搜索实现（零依赖开箱即用）；safeSearch：带超时保护的搜索包装（宿主可复用）
+export { FetchWebSearchProvider } from './web-search/fetchWebSearchProvider.js';
+// buildSearchEndpoints：构建搜索端点降级链。入参为「内核预设名 | 宿主自定义 SearchEndpoint」混排；
+//   主推宿主接入——生产环境宿主自建 SearchEndpoint[]（自带 URL+解析）注入，内核预设仅作零配置保底。
+export { buildSearchEndpoints, } from './web-search/fetchWebSearchProvider.js';
+export { safeSearch } from './web-search/webSearchProvider.js';
+// FetchWebFetchProvider：默认抓取实现（零依赖开箱即用）；safeFetch：带超时保护的抓取包装（宿主可复用）
+export { FetchWebFetchProvider } from './web-fetch/fetchWebFetchProvider.js';
+export { safeFetch } from './web-fetch/webFetchProvider.js';
+// safeExecuteCode：带超时保护的执行包装（宿主可复用）
+export { safeExecuteCode } from './code-exec/codeExecutionProvider.js';
+// safeSearchProjectFiles/safeSearchProjectText：带超时保护的项目搜索包装（宿主可复用）
+export { safeSearchProjectFiles, safeSearchProjectText, } from './project-search/projectSearchProvider.js';
+// SEARCH_PROJECT_TOOL：条件性工具定义（宿主注入 IProjectSearchProvider 后暴露给 LLM）
+export { SEARCH_PROJECT_TOOL } from './agent/builtinTools.js';
+// PROJECT_SEARCH_RESULT_MAX_LEN / IGNORED_DIR_NAMES：search_project 调用面与宿主实现方共享的单一真理源
+// （宿主 projectSearchProvider import 对齐，避免结果上限 / 忽略目录数值漂移）
+export { PROJECT_SEARCH_RESULT_MAX_LEN } from './agent/toolExecutor.js';
+export { IGNORED_DIR_NAMES } from './agent/builtinToolHandlers.js';
+// 项目注册表 + 锁文件管理：宿主可直接使用或通过 ProjectManager 间接委托
 export { ProjectRegistry } from './memory/projectRegistry.js';
 export { LockManager } from './memory/lockManager.js';
-// 向量存储：宿主注入 EmbeddingService 后创建 JsonVectorStore，传入 AgentOptions 启用语义搜索
-// 宿主也可实现 IVectorStore 接口注入自定义向量库（如 SqliteVectorStore / LanceDBVectorStore）
-export { JsonVectorStore } from './memory/vectorStore.js';
-// Embedding Provider：OpenAI 兼容 /embeddings 端点实现（满足 EmbeddingService 接口）
-export { EmbeddingProvider } from './llm/embedding.js';
-// 召回函数：简化关键词搜索
-export { recall, extractKeywords } from './memory/recall.js';
+// 会话显示名回退单一真理源（displayName→autoName），宿主从内核取，避免重复实现
+export { getSessionDisplayName } from './memory/sessionStore.js';
+// Round 辅助函数
+export { generateRoundId, generateMessageId, createPendingRound, completeRound, 
+// 「轮是否已收场」判据单一收口点：宿主与内核共用（禁止各端自写 status === 'complete'，
+// 否则中断轮会被静默排除出会话视图与 LLM 历史）
+isRoundSettled, } from './memory/roundStore.js';
+// 通用会话视图加载器实现（宿主注入存储后直接委托；非仅测试/开发用）
+export { InMemorySessionViewLoader } from './memory/inMemorySessionViewLoader.js';
+// 内存版实现（用于测试和开发）
+export { InMemoryRoundStore } from './memory/inMemoryRoundStore.js';
+export { InMemorySessionStore } from './memory/inMemorySessionStore.js';
+// 会话占位标题单一真理源，避免宿主重复实现
+export { defaultTitle as defaultSessionTitle } from './agent/managers/sessionNamer.js';
+// 宿主可条件性控制 trace_summary 工具的可见性
+export { TRACE_SUMMARY_TOOL } from './agent/builtinTools.js';
 export { setLogger, logger } from './logging/logger.js';
 // ─── 工具导出 ────────────────────────────────────────────
-// 分词工具：宿主项目（如 SqliteStorage）依赖
+// 以下工具供宿主复用（分词/类型守卫/Frontmatter/安全定时器）；宿主按需接入，非强依赖
 export { segmentText, segmentLower } from './utils/segmenter.js';
-// 对象类型守卫：宿主项目（如 spriteConfig）依赖，校验 JSON.parse 结果
 export { isPlainObject } from './utils/objects.js';
-// Frontmatter 解析/序列化：宿主项目（如 skillInstaller）依赖
 export { parseFrontmatter, serializeFrontmatter } from './utils/frontmatter.js';
-// 安全定时器：宿主主进程统一使用 safeSetTimeout/safeSetInterval 跟踪清理
-export { safeSetTimeout, safeSetInterval, clearSafeTimeout, clearSafeInterval } from './utils/safeTimer.js';
+// 安全定时器工具：供宿主主进程复用，统一跟踪清理定时器（防原生 setTimeout/setInterval 泄漏）
+export { safeSetTimeout, safeSetInterval, clearSafeTimeout, clearSafeInterval, } from './utils/safeTimer.js';
+// MAX_DIFF_CONTENT_LENGTH：diff 内容上限的**单一真理源**，宿主 UI 展示阈值 import 对齐（防数值漂移）。
+// ⚠️ 两侧超限行为不同：内核 = 截断后追加「已截断」标记照常展示；宿主 = 跳过对比只提示——只统一数值，不统一行为
+export { MAX_DIFF_CONTENT_LENGTH } from './security/pathGuard.js';
 // ─── 错误类型导出 ────────────────────────────────────────
 export { MemoraError, ToolErrorCode, isRetryableErrorCode } from './utils/errors.js';
-// toError 独立导出，浏览器端可直接 import 而不引入 logging（pino）依赖
+// toError 独立导出：浏览器端可直接 import 而不引入 logging/ 模块
 export { toError } from './utils/toError.js';
 // ─── 通用工具导出 ────────────────────────────────────────
-// 宿主主进程统一从 'memora' 导入，消除 shared/ 跨层副本（渲染进程因浏览器环境保留副本）
-export { truncate } from './utils/strings.js';
+// 通用工具供宿主复用：主进程可直接 import 本入口（渲染进程因浏览器环境保留 shared 副本）
+export { truncate, isValidConfigName, parseConfigId, MAX_CONFIG_NAME_LENGTH, } from './utils/strings.js';
 export { formatDateKey, todayDate } from './utils/time.js';
-export { collectAgentChunks, evaluateResult } from './eval/evalTypes.js';
-export { EVAL_SCENARIOS } from './eval/scenarios.js';
-export { EvalRunner } from './eval/evalRunner.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH,iDAAiD;AACjD,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAGzC,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAMvE,0DAA0D;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AA8BtE,WAAW;AACX,OAAO,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAKxE,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAI/E,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAGrE,OAAO;AACP,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAK5D,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAE7D,uDAAuD;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD,4DAA4D;AAC5D,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAEvF,uBAAuB;AACvB,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAIrE,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,0EAA0E;AAC1E,oFAAoF;AACpF,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,WAAW,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAGnH,OAAO,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAC1E,qCAAqC;AACrC,oEAAoE;AACpE,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAE9D,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAGtD,wEAAwE;AACxE,2EAA2E;AAC3E,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE1D,wEAAwE;AACxE,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAQvD,eAAe;AACf,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAK7D,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAExD,wDAAwD;AACxD,+BAA+B;AAC/B,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACjE,iDAAiD;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,8CAA8C;AAC9C,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAChF,sDAAsD;AACtD,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAc5G,sDAAsD;AACtD,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACrF,mDAAmD;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAG7C,sDAAsD;AACtD,uDAAuD;AACvD,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAM3D,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACzE,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/llm/abortSignal.d.ts

@@ -1,8 +1,7 @@
 /**
  * AbortSignal 合并工具
  *
- * 从 openaiCompatible.ts 和 embedding.ts 提取的公共"外部信号 + 超时信号"合并逻辑
- * （ADR-017 枝叶层 2 次提取原则，embedding.ts 原注释已自证"与 openaiCompatible.ts 同构"）。
+ * 从 openaiCompatible.ts 提取的公共"外部信号 + 超时信号"合并逻辑。
  *
  * 确保用户取消（optsSignal）和请求超时都能中断 fetch 和流读取。
  */
@@ -16,7 +15,7 @@
  *
  * @param optsSignal 外部传入的 AbortSignal（可选，用户取消信号）
  * @param timeoutMs 超时毫秒数
- * @param timeoutErrorName 超时错误名称（如 'LLM 请求超时' / 'Embedding 请求超时'）
+ * @param timeoutErrorName 超时错误名称（如 'LLM 请求超时'）
  * @returns { signal, clearTimer, dispose } 合并后的 signal 和清理函数
  */
 export declare function mergeAbortSignals(optsSignal: AbortSignal | undefined, timeoutMs: number, timeoutErrorName: string): {

package/dist/llm/abortSignal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"abortSignal.d.ts","sourceRoot":"","sources":["../../src/llm/abortSignal.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,WAAW,GAAG,SAAS,EACnC,SAAS,EAAE,MAAM,EACjB,gBAAgB,EAAE,MAAM,GACvB;IACD,MAAM,EAAE,WAAW,CAAC;IACpB,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB,CAwBA"}
+{"version":3,"file":"abortSignal.d.ts","sourceRoot":"","sources":["../../src/llm/abortSignal.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,WAAW,GAAG,SAAS,EACnC,SAAS,EAAE,MAAM,EACjB,gBAAgB,EAAE,MAAM,GACvB;IACD,MAAM,EAAE,WAAW,CAAC;IACpB,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB,CAwBA"}

package/dist/llm/abortSignal.js

@@ -1,8 +1,7 @@
 /**
  * AbortSignal 合并工具
  *
- * 从 openaiCompatible.ts 和 embedding.ts 提取的公共"外部信号 + 超时信号"合并逻辑
- * （ADR-017 枝叶层 2 次提取原则，embedding.ts 原注释已自证"与 openaiCompatible.ts 同构"）。
+ * 从 openaiCompatible.ts 提取的公共"外部信号 + 超时信号"合并逻辑。
  *
  * 确保用户取消（optsSignal）和请求超时都能中断 fetch 和流读取。
  */
@@ -16,7 +15,7 @@
  *
  * @param optsSignal 外部传入的 AbortSignal（可选，用户取消信号）
  * @param timeoutMs 超时毫秒数
- * @param timeoutErrorName 超时错误名称（如 'LLM 请求超时' / 'Embedding 请求超时'）
+ * @param timeoutErrorName 超时错误名称（如 'LLM 请求超时'）
  * @returns { signal, clearTimer, dispose } 合并后的 signal 和清理函数
  */
 export function mergeAbortSignals(optsSignal, timeoutMs, timeoutErrorName) {

package/dist/llm/abortSignal.js.map

@@ -1 +1 @@
-{"version":3,"file":"abortSignal.js","sourceRoot":"","sources":["../../src/llm/abortSignal.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,iBAAiB,CAC/B,UAAmC,EACnC,SAAiB,EACjB,gBAAwB;IAMxB,MAAM,eAAe,GAAG,IAAI,eAAe,EAAE,CAAC;IAC9C,MAAM,SAAS,GAAG,UAAU,CAC1B,GAAG,EAAE,CAAC,eAAe,CAAC,KAAK,CAAC,IAAI,YAAY,CAAC,gBAAgB,EAAE,cAAc,CAAC,CAAC,EAC/E,SAAS,CACV,CAAC;IACF,MAAM,WAAW,GAAG,GAAG,EAAE,CAAC,eAAe,CAAC,KAAK,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IACpE,IAAI,UAAU,EAAE,CAAC;QACf,IAAI,UAAU,CAAC,OAAO,EAAE,CAAC;YACvB,eAAe,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QAC3C,CAAC;aAAM,CAAC;YACN,UAAU,CAAC,gBAAgB,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACpE,CAAC;IACH,CAAC;IAED,+CAA+C;IAC/C,MAAM,UAAU,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;IACjD,iDAAiD;IACjD,MAAM,OAAO,GAAG,GAAG,EAAE;QACnB,YAAY,CAAC,SAAS,CAAC,CAAC;QACxB,IAAI,UAAU;YAAE,UAAU,CAAC,mBAAmB,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IACvE,CAAC,CAAC;IAEF,OAAO,EAAE,MAAM,EAAE,eAAe,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC;AACjE,CAAC"}
+{"version":3,"file":"abortSignal.js","sourceRoot":"","sources":["../../src/llm/abortSignal.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,iBAAiB,CAC/B,UAAmC,EACnC,SAAiB,EACjB,gBAAwB;IAMxB,MAAM,eAAe,GAAG,IAAI,eAAe,EAAE,CAAC;IAC9C,MAAM,SAAS,GAAG,UAAU,CAC1B,GAAG,EAAE,CAAC,eAAe,CAAC,KAAK,CAAC,IAAI,YAAY,CAAC,gBAAgB,EAAE,cAAc,CAAC,CAAC,EAC/E,SAAS,CACV,CAAC;IACF,MAAM,WAAW,GAAG,GAAG,EAAE,CAAC,eAAe,CAAC,KAAK,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IACpE,IAAI,UAAU,EAAE,CAAC;QACf,IAAI,UAAU,CAAC,OAAO,EAAE,CAAC;YACvB,eAAe,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QAC3C,CAAC;aAAM,CAAC;YACN,UAAU,CAAC,gBAAgB,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACpE,CAAC;IACH,CAAC;IAED,+CAA+C;IAC/C,MAAM,UAAU,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;IACjD,iDAAiD;IACjD,MAAM,OAAO,GAAG,GAAG,EAAE;QACnB,YAAY,CAAC,SAAS,CAAC,CAAC;QACxB,IAAI,UAAU;YAAE,UAAU,CAAC,mBAAmB,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IACvE,CAAC,CAAC;IAEF,OAAO,EAAE,MAAM,EAAE,eAAe,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC;AACjE,CAAC"}

package/dist/llm/factory.d.ts

@@ -1,21 +1,18 @@
 /**
- * LLM Provider 工厂
- * 根据配置创建 LLM Provider 实例
- * 详见 ADR-003
+ * LLM Provider 工厂：根据配置创建 Provider 实例
+ * 内核只接收 baseUrl+model+apiKey 三板斧创建实例；不做 provider 名 → URL/模型 映射（宿主层职责）；
+ * 不验证 apiKey（是否必需是下游 LLM 服务的决策，内核只是透传管道）
  *
- * 内核职责（明确定界）：
- * - 接收 baseUrl + model + apiKey 三板斧，创建 OpenAICompatibleProvider
- * - 不负责 provider 名称 → URL/模型 的映射（预设是宿主层职责）
- * - 不验证 apiKey（是否必需是下游 LLM 服务的决���，内核只是透传管道）
+ * 边界澄清：
+ *   - createProviderFromConfig —— 【规范入口】宿主传入单个 provider 的 baseUrl+model+apiKey，内核校验后
+ *     创建 OpenAICompatibleProvider。provider 选择/默认值策略全在宿主侧，内核不代劳。
+ *   - createLlmProvider —— 【配置驱动便利】从完整 Config 读 llm.active 解析激活 provider（选择在内核侧）。
+ *     仅适用于把整份 Config 托管给内核的场景；边界守法的宿主应自建 provider 后调 createProviderFromConfig，
+ *     避免把"哪个 provider 激活"这一宿主策略委托给内核。
  */
 import type { Config } from '../config/loader.js';
 import { LlmProvider } from '../llm/provider.js';
-/**
- * 单个 Provider 配置（用于 createProviderFromConfig）
- *
- * baseUrl 为可选：内核在 createProviderFromConfig 内部会做空值检查，
- * 缺失时抛出 configError。这样 BackgroundConfig.baseUrl?: string 可以直接传入。
- */
+/** 单个 Provider 配置（createProviderFromConfig 入参）：baseUrl 可选，缺失时内部抛 configError */
 export interface ProviderConfig {
     /** API 基础 URL（可选——内核在 createProviderFromConfig 内部做空值检查并报错） */
     baseUrl?: string;
@@ -25,29 +22,22 @@ export interface ProviderConfig {
     apiKey?: string;
     /** Provider 标识（仅用于日志，不影响路由） */
     provider?: string;
+    /**
+     * 是否支持原生工具调用（OpenAI Function Calling tools 协议）。
+     *
+     * 本地运行时（Ollama/LM Studio 等）是否支持原生 FC 无法从 baseUrl 推断，须宿主显式置 false；
+     * 未填（undefined）→ OpenAICompatibleProvider 内回落 true（保留存量云 LLM 工具行为，
+     * 互斥双能力位）。
+     */
+    supportsToolCalling?: boolean;
+    /** 是否支持结构化输出（response_format / JSON mode）；未填 → 回落 false */
+    supportsStructuredOutput?: boolean;
 }
-/**
- * 从单个 Provider 配置创建 LlmProvider 实例
- *
- * 与 createLlmProvider 逻辑相同，但接收的是单个 Provider 配置而非完整 Config。
- * 用于多 Provider 管理场景：Agent 为 providers 映射表中的每个条目调用此函数。
- *
- * @param name - Provider 别名（仅用于日志标识）
- * @param providerConfig - 单个 Provider 的配置（baseUrl + model 必填）
- * @returns LlmProvider 实例
- */
+/** 从单个 Provider 配置创建 LlmProvider 实例（多 Provider 管理场景：为 providers 映射表中每个条目调用） */
 export declare function createProviderFromConfig(name: string, providerConfig: ProviderConfig): LlmProvider;
 /**
  * 创建 LLM Provider（从完整 Config）
- *
- * 兼容两种配置格式：
- *   1. 新格式：llm.providers + llm.active → 使用指定 Provider
- *   2. 旧格式：llm.provider + llm.model + ... → 单 Provider 扁平字段
- *
- * 调用方（宿主）应确保 baseUrl + model 已在配置中显式设置。
- *
- * @param config 完整配置
- * @returns 当前激活的 LlmProvider 实例
+ * 唯一配置格式：providers 映射表 + active，宿主应确保 baseUrl+model 已显式设置
  */
 export declare function createLlmProvider(config: Config): LlmProvider;
 //# sourceMappingURL=factory.d.ts.map

package/dist/llm/factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/llm/factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAMhD;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,8DAA8D;IAC9D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iBAAiB;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,MAAM,EACZ,cAAc,EAAE,cAAc,GAC7B,WAAW,CAmCb;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,CA2B7D"}
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/llm/factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAMhD,gFAAgF;AAChF,MAAM,WAAW,cAAc;IAC7B,8DAA8D;IAC9D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iBAAiB;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;;OAMG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,2DAA2D;IAC3D,wBAAwB,CAAC,EAAE,OAAO,CAAC;CACpC;AAED,+EAA+E;AAC/E,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,MAAM,EACZ,cAAc,EAAE,cAAc,GAC7B,WAAW,CAmCb;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,CAsB7D"}