@zooique/memora 3.0.0 → 4.0.0

package/dist/index.d.ts

@@ -1,48 +1,47 @@
 /**
  * Memora — 通用 Agent 纯逻辑库（Node.js，零 native 依赖）
  * 公共导出面：宿主项目通过本入口 import 接入；持久化/搜索/会话等宿主能力均经接口注入。
+ * 导出面口径（2026-10-06 收敛定案）：只收「宿主生产/测试消费」或「README / docs/memora-api-reference.md §十六
+ * 明文承诺」的符号；其余一律为内部实现，不挂公共面（新增导出前先过这两条判据）。
+ * 机器对账：publicApiSurfaceGuard.test.ts 双向断言（未登记公开 / 手册幻觉符号均红），挂面动作先过守卫。
  * 类型依赖方向单向（agent → memory → utils；agent → llm；agent → security），详见 module-inventory.md。
  */
 export { Agent } from './agent/agent.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 type { AgentChunk, ThinkingPhase, LlmErrorCategory, UIMessages, ArchiveMode, AgentOptions, AgentContext, } from './agent/types.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 { estimateOccupancy } from './agent/budget.js';
+export { estimateTokensMessages } from './agent/contextManager.js';
 export { type AgentForkResult } from './agent/managers/sessionManager.js';
+export { COMPRESS_TARGET_LABELS, type CompressTarget } from './agent/loop.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 type { RolePackMeta } from './role-pack/types.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 { describeStrategyKeys } from './role-pack/strategyKeys.js';
+export type { StrategyKeyFace } from './role-pack/strategyKeys.js';
+export { validateManifestText } 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, TaskType, ProviderRouter } from './llm/types.js';
+export type { LlmChunk, ProviderRouter } from './llm/types.js';
 export type { Config } from './config/loader.js';
-export { TypedEventEmitter, AGENT_EVENTS } from './utils/eventEmitter.js';
+export { TypedEventEmitter } 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, SUMMARY_TYPES } from './memory/types.js';
-export type { Memory, SummaryType } from './memory/types.js';
+export type { Memory } from './memory/types.js';
 /**
  * 记忆解析器（宿主读档复用内核校验，避免宿主另写一份字段白名单）
  * 白名单构造：剥离未知字段（旧档 score 等），见 src/memory/types.ts
@@ -55,15 +54,14 @@ export { InMemoryStorage } from './memory/inMemoryStorage.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 { IEnvironmentProvider, HostEnvironmentInfo } from './agent/types.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';
@@ -73,16 +71,16 @@ export type { ISessionStore, SessionMessage, SessionMeta } from './memory/sessio
 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 { 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 { SessionCheckpoint } from './agent/types.js';
+export type { BackgroundTask } from './agent/backgroundTasks.js';
+export { BACKGROUND_TASK_STATUS_LABELS } from './agent/backgroundTasks.js';
+export { resolveShellCommand } from './skill/skillScriptRunner.js';
 export type { ForkResult } from './agent/messageHistory.js';
 export type { ILogger } from './logging/loggerInterface.js';
 export { setLogger, logger } from './logging/logger.js';
@@ -96,6 +94,6 @@ 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, isValidConfigName, parseConfigId, MAX_CONFIG_NAME_LENGTH, } from './utils/strings.js';
+export { truncate } from './utils/strings.js';
 export { formatDateKey, todayDate } from './utils/time.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,21 +1,26 @@
 /**
  * Memora — 通用 Agent 纯逻辑库（Node.js，零 native 依赖）
  * 公共导出面：宿主项目通过本入口 import 接入；持久化/搜索/会话等宿主能力均经接口注入。
+ * 导出面口径（2026-10-06 收敛定案）：只收「宿主生产/测试消费」或「README / docs/memora-api-reference.md §十六
+ * 明文承诺」的符号；其余一律为内部实现，不挂公共面（新增导出前先过这两条判据）。
+ * 机器对账：publicApiSurfaceGuard.test.ts 双向断言（未登记公开 / 手册幻觉符号均红），挂面动作先过守卫。
  * 类型依赖方向单向（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';
 // 上下文窗口解析（单一真理源公式）：宿主在构造 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';
+// token 估算（CJK 感知，零状态纯函数）：消息序列口径（先累计后取整，与运行时 prepare 同源），
+// 宿主历史会话重算占用用它；单段文本估算 estimateTokensText 为内部实现，不挂公共面
+export { estimateTokensMessages } from './agent/contextManager.js';
+// 第二级压缩的中文标签（宿主 notice 文案真源）：
+// 宿主**不得**自己写 target→文案映射——三元/else 在枚举增补时会把新值静默落到旧标签上
+// （对用户说谎），而 `Record<CompressTarget, string>` 穷尽键在增补时编译期报错。
+export { COMPRESS_TARGET_LABELS } from './agent/loop.js';
 // WRITE_PATH_EXTRACTORS：「按 args.path 改盘的工具」清单的**单一真理源**（loop 同路径写串行闸的判据）。
 // 宿主改动追踪（fileChangeTracker）据其 keys 派生触发集合，禁并列维护第二份清单——
 // 内核新增按 path 的写工具时宿主自动跟随，防「内核进串行闸、宿主不知情」的静默少报。
@@ -24,25 +29,27 @@ export { WRITE_PATH_EXTRACTORS } from './agent/toolResultCache.js';
 // 宿主改动可视化对其做「执行前后目录快照 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';
+// UI 键面唯一来源：宿主角色编辑 UI 从这里取键名/控件形态/值域，禁自维护键清单副本
+export { describeStrategyKeys } from './role-pack/strategyKeys.js';
+// 角色包格式校验器（文本形态入口）：manifest.json 唯一核心控制文件 + companion 内容红线检测
+// （宿主持有文件文本，经 validateManifestText 保存前校验，宿主不重写判据——
+//   方案-角色包编辑UI / role-pack-validation-flow 承诺面；内存对象形态 validateManifest
+//   为内核内部实现，随签名推导可用）
+export { validateManifestText } 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';
+// 记忆即摘要架构：轮次摘要生成器为内核内部组件（Agent init 装配），不挂公共面
 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 { TypedEventEmitter, AGENT_EVENTS } from './utils/eventEmitter.js';
+// 事件系统（事件名常量表 AGENT_EVENTS 为内核内部实现，订阅用字符串字面量或 AgentEventName 类型）
+export { TypedEventEmitter } 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';
@@ -55,12 +62,11 @@ export { SOURCE_LABELS, SUMMARY_TYPES } from './memory/types.js';
 export { parseMemory } from './memory/types.js';
 export { escapeLike, escapeLikeSnippet, validateSource } from './memory/sourceValidation.js';
 export { InMemoryStorage } from './memory/inMemoryStorage.js';
-// FetchWebSearchProvider：默认搜索实现（零依赖开箱即用）；safeSearch：带超时保护的搜索包装（宿主可复用）
+// 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';
@@ -68,8 +74,6 @@ export { safeFetch } from './web-fetch/webFetchProvider.js';
 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';
@@ -79,20 +83,23 @@ export { ProjectRegistry } from './memory/projectRegistry.js';
 export { LockManager } from './memory/lockManager.js';
 // 会话显示名回退单一真理源（displayName→autoName），宿主从内核取，避免重复实现
 export { getSessionDisplayName } from './memory/sessionStore.js';
-// Round 辅助函数
-export { generateRoundId, generateMessageId, createPendingRound, completeRound, 
-// 「轮是否已收场」判据单一收口点：宿主与内核共用（禁止各端自写 status === 'complete'，
-// 否则中断轮会被静默排除出会话视图与 LLM 历史）
-isRoundSettled, } from './memory/roundStore.js';
+// Round 辅助函数：仅 isRoundSettled 挂公共面（「轮是否已收场」判据单一收口点：宿主与内核共用，
+// 禁止各端自写 status === 'complete'，否则中断轮会被静默排除出会话视图与 LLM 历史）；
+// ID 生成/轮创建/收场流转为内核内部实现
+export { isRoundSettled } from './memory/roundStore.js';
 // 通用会话视图加载器实现（宿主注入存储后直接委托；非仅测试/开发用）
 export { InMemorySessionViewLoader } from './memory/inMemorySessionViewLoader.js';
-// 内存版实现（用于测试和开发）
-export { InMemoryRoundStore } from './memory/inMemoryRoundStore.js';
+// 内存版实现：InMemorySessionStore 承诺面（README「ISessionStore → InMemorySessionStore」+ API 参考）；
+// InMemoryRoundStore 为内核内部测试实现，不挂公共面
 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';
+// 后台任务状态中文词表（宿主 UI 直接消费，禁自建第二套；Record 穷尽键 = 加状态忘补文案编译期红）
+export { BACKGROUND_TASK_STATUS_LABELS } from './agent/backgroundTasks.js';
+// 命令派发 shell 映射（「命令实际派发到哪个 shell」的唯一真源）：宿主环境快照的 shell 字段
+// 经本函数派生（environmentProvider），禁自写平台三元副本——两侧映射漂移 = 对模型说假话
+// （模型按 A shell 语法写命令却在 B shell 下执行，每次必败）。
+export { resolveShellCommand } from './skill/skillScriptRunner.js';
 export { setLogger, logger } from './logging/logger.js';
 // ─── 工具导出 ────────────────────────────────────────────
 // 以下工具供宿主复用（分词/类型守卫/Frontmatter/安全定时器）；宿主按需接入，非强依赖
@@ -109,7 +116,8 @@ export { MemoraError, ToolErrorCode, isRetryableErrorCode } from './utils/errors
 // toError 独立导出：浏览器端可直接 import 而不引入 logging/ 模块
 export { toError } from './utils/toError.js';
 // ─── 通用工具导出 ────────────────────────────────────────
-// 通用工具供宿主复用：主进程可直接 import 本入口（渲染进程因浏览器环境保留 shared 副本）
-export { truncate, isValidConfigName, parseConfigId, MAX_CONFIG_NAME_LENGTH, } from './utils/strings.js';
+// 通用工具供宿主复用：主进程可直接 import 本入口（渲染进程因浏览器环境保留 shared 副本）；
+// isValidConfigName / parseConfigId / MAX_CONFIG_NAME_LENGTH 为配置名内部校验，不挂公共面
+export { truncate } from './utils/strings.js';
 export { formatDateKey, todayDate } from './utils/time.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,iDAAiD;AACjD,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAUzC,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACvE,2DAA2D;AAC3D,iDAAiD;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,qDAAqD;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,0DAA0D;AAC1D,qDAAqD;AACrD,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAEnE,8BAA8B;AAC9B,sDAAsD;AACtD,2DAA2D;AAC3D,OAAO,EAAE,sBAAsB,EAAuB,MAAM,iBAAiB,CAAC;AAQ9E,0EAA0E;AAC1E,uDAAuD;AACvD,+CAA+C;AAC/C,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,qEAAqE;AACrE,0EAA0E;AAC1E,kCAAkC;AAClC,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAIlE,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACnF,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACjE,+CAA+C;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAEnE,6DAA6D;AAC7D,mDAAmD;AACnD,uEAAuE;AACvE,qBAAqB;AACrB,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAUhE,OAAO,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAIxE,uDAAuD;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AAGzE,8CAA8C;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,sDAAsD;AACtD,uEAAuE;AACvE,uEAAuE;AACvE,kEAAkE;AAClE,OAAO,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAO/E,iEAAiE;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAE5D,iEAAiE;AACjE,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAIjE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAE7D,uDAAuD;AACvD,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGjE;;;GAGG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAI7F,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAU9D,kEAAkE;AAClE,OAAO,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AAChF,sEAAsE;AACtE,gEAAgE;AAChE,OAAO,EACL,oBAAoB,GAErB,MAAM,wCAAwC,CAAC;AAKhD,oEAAoE;AACpE,OAAO,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAC7E,OAAO,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAC;AAS5D,oCAAoC;AACpC,OAAO,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AAkBvE,mEAAmE;AACnE,OAAO,EACL,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,2CAA2C,CAAC;AACnD,qFAAqF;AACrF,yDAAyD;AACzD,OAAO,EAAE,6BAA6B,EAAE,MAAM,yBAAyB,CAAC;AACxE,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACnE,+CAA+C;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAE9D,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAGtD,mDAAmD;AACnD,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAcjE,4DAA4D;AAC5D,0DAA0D;AAC1D,wBAAwB;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAWxD,oCAAoC;AACpC,OAAO,EAAE,yBAAyB,EAAE,MAAM,uCAAuC,CAAC;AAElF,wFAAwF;AACxF,qCAAqC;AACrC,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AACxE,uBAAuB;AACvB,OAAO,EAAE,YAAY,IAAI,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAMvF,yDAAyD;AACzD,OAAO,EAAE,6BAA6B,EAAE,MAAM,4BAA4B,CAAC;AAC3E,yDAAyD;AACzD,yDAAyD;AACzD,0CAA0C;AAC1C,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAQnE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAExD,wDAAwD;AACxD,mDAAmD;AACnD,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAChF,4DAA4D;AAC5D,OAAO,EACL,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,sBAAsB,CAAC;AAa9B,2EAA2E;AAC3E,8DAA8D;AAC9D,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAElE,sDAAsD;AACtD,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACrF,+CAA+C;AAC/C,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAG7C,sDAAsD;AACtD,uDAAuD;AACvD,4EAA4E;AAC5E,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/memory/roundStore.d.ts

@@ -1,42 +1,27 @@
 /**
  * 问答闭环（Round）存储接口 —— Memora 会话管理的 SSOT
  *
- * 设计理念：
- * - 问答闭环（Round）是独立的、全局唯一的实体
- * - 会话（Session）只是问答闭环 ID 的有序列表
- * - 分叉只是复制 ID 列表（指针复制），不复制数据
- *
- * 核心优势：
- * 1. 保持记忆系统的真理源设定（每个 roundId 对应唯一摘要）
- * 2. 保持会话的独立性（所有会话在存储层平等）
- * 3. 简洁的分叉实现（只需操作 ID 列表）
+ * 设计：Round 是独立全局唯一实体；Session 只是 roundId 的有序列表；
+ * 分叉只复制 ID 列表（指针复制，不复制数据）⇒ 每个 roundId 恒对应唯一摘要、
+ * 所有会话在存储层平等。
  */
 import type { MessageRole } from '../memory/types.js';
 import type { AbortStopReason, LlmErrorCategory } from '../agent/types.js';
 /**
- * 问答闭环消息：与 LLM Message 兼容，包含持久化所需的时间戳信息
- *
- * 对齐现有结构：
- * - Message.role（'user' | 'assistant' | 'tool' | 'system'）
- * - Message.content（消息内容）
- * - Message.roundId（轮次标识，此处由 Round 本身承载）
+ * 问答闭环消息：与 LLM Message 兼容，额外带持久化所需时间戳。
+ * roundId 不在此处——由所属 Round 本身承载。
  */
 export interface RoundMessage {
     /** 消息唯一标识（格式：msg-{uuid}） */
     id: string;
-    /** 消息角色 */
     role: MessageRole;
-    /** 消息内容 */
     content: string;
     /** 时间戳（ISO 8601，持久化用） */
     timestamp: string;
     /** 消息来源名称（可选，对齐 LLM Message.name） */
     name?: string;
-    /** Token 用量统计（可选） */
     tokenUsage?: {
-        /** 输入 token 数 */
         input: number;
-        /** 输出 token 数 */
         output: number;
     };
 }
@@ -156,7 +141,13 @@ export interface ProcessMetricsPayload {
     durationMs: number;
     /** 输入 token 用量（估算口径：每次 LLM 调用请求消息 `estimateTokens` 的**全程累计**，非服务端 usage 实测值；实测值在 actualInputTokens，宿主取证面未消费） */
     tokenIn: number;
-    /** 输出 token 用量（估算口径：各次 LLM 调用**正文**（fullContent）估算的全程累计——**不含 thinking、不含工具轮叙述**（二者不拼入 fullContent，见 llmCaller），推理模型下远小于真实输出预算消耗，勿据它判断「截断是否该发生」；判断输出压力用 maxTokens（生效值）+ truncationRecoveryCount + thinkingChars 佐证） */
+    /**
+     * 输出 token 用量（估算口径：各次 LLM 调用**正文**（fullContent）估算的全程累计——
+     * **不含 thinking、工具轮叙述与工具调用参数**（三者都不进 fullContent）。
+     * 工具密集轮因此**系统性低估**（真机 round-1791449684099：工具参数 9,216 字符 / 44 次调用，
+     * 落盘 tokenOut=646 ≈ 仅最终答复）。这是**有意口径，勿"修"成含参数**（历史数字将不可比），
+     * 读它时按「答复正文量」理解；判断输出压力用 maxTokens + truncationRecoveryCount + thinkingChars 佐证。
+     */
     tokenOut: number;
     /** 工具调用失败次数 */
     toolFailureCount: number;
@@ -191,13 +182,7 @@ export interface ProcessMetricsPayload {
  *
  * 由宿主在 consumeFlow 旁路从 AgentChunk / 主机事件派生，流结束时附到 Round.processEvents
  * 一次性落盘；重放时按 seq 有序重建 UI（运行时与重放共用同一渲染数据源）。
- *
- * 事件类型全量：
- * - meta：每轮首条，该轮回答身份
- * - thinking / memory_added / tool_start / tool_result：过程明细
- * - self_review / text_self_review：自审查过程与输出
- * - aborted：中断标记
- * - metrics：每轮末条，执行汇总
+ * 成员清单即下方联合类型（meta 首条 / metrics 末条，中间为过程明细与终态标记）。
  */
 export type ProcessEvent = {
     type: 'meta';
@@ -244,7 +229,7 @@ export type ProcessEvent = {
         name: string;
         ok: boolean;
         summary?: string;
-        /** 策略拦截：ok=false + blocked=true = 被确定性拒绝未执行（如搜索达硬上限） */
+        /** 主动挡下（B4 口径）：ok=false + blocked=true = 被我们拦下未执行（护栏/执行层闸门/旁路拒绝） */
         blocked?: boolean;
     };
 }
@@ -274,14 +259,11 @@ export type ProcessEvent = {
     };
 }
 /**
- * 模型思考内容流：reasoning_content 增量累积结果。
- * 仅供重放重建「思考」折叠块；展示轨承载，正文轨/记忆轨不消费（CoT 防护）。命名用 thought——
- * 区别于上方既有 `type:'thinking'`（phase 相位事件）与多模型路由任务 `TaskType='reasoning'`，
- * 三者语义分离，避免同 union 判别式重复与跨层双义。
- * payload.content 超长由宿主落盘前截断（MAX_THOUGHT_PAYLOAD_LENGTH，SSOT 常量单点定义于 chatPanel）。
- * payload.stepIndex = 本条思考所属 step（一次 LLM 调用 + 可选工具执行）的轮内序号
- * （内核 loop 打标、随内容同源落盘），「一个 step 一个思考折叠块」的归桶键；
- * 缺省（旧数据）由展示层回落整轮单桶。
+ * 模型思考内容流（reasoning_content 累积）：仅用于重放重建「思考」折叠块，
+ * 正文轨/记忆轨不消费（CoT 防护）。命名 `thought` 以别于同 union 的 `thinking`
+ * （phase 相位事件）与 `TaskType='reasoning'`，三者语义分离。
+ * content 超长由宿主落盘前截断（常量单点定义于 chatPanel）；stepIndex = 所属 step 轮内序号，
+ * 「一个 step 一个思考块」的归桶键，缺省（旧数据）由展示层回落整轮单桶。
  */
  | {
     type: 'thought';
@@ -293,8 +275,7 @@ export type ProcessEvent = {
     };
 }
 /**
- * 任务项级折叠边界：active 任务项推进时由 loop 产，
- * 宿主落盘此事件把后续 narrate/tool/问答归到对应任务项分组。无任务表不产。
+ * 任务项级折叠边界：active 任务项推进时由 loop 产出，把后续 narrate/tool/问答归到该任务项分组。
  */
  | {
     type: 'plan_item_boundary';
@@ -304,6 +285,36 @@ export type ProcessEvent = {
         planItemId?: string;
         title?: string;
     };
+}
+/**
+ * 任务表收尾快照：turn 收尾清空运行时任务表**之前**拍的全量终态；清空前拍 = 中断轮同样拍到。
+ *
+ * 为什么必须有它：任务表是 turn 内瞬态（收尾即清 + 宿主推空看板），本快照是重放恢复
+ * 「任务项完成态」的唯一数据来源；存量历史轮无此事件 = 不显示状态图标（诚实降级，不伪造）。
+ */
+ | {
+    type: 'plan_snapshot';
+    seq: number;
+    ts: string;
+    payload: {
+        items: {
+            planItemId: string;
+            status: 'pending' | 'active' | 'done' | 'blocked';
+        }[];
+    };
+}
+/**
+ * 后台任务收尾报告：turn 终态对存活后台进程**脱管**（不杀，跨轮存活）后由内核产出，
+ * 无存活进程则不产。中断硬关闭路径下上屏 chunk 被丢弃，但 LLM 历史的 system 消息已由
+ * 内核写入（双通道）——本事件承载「上屏通道」的重放真相源。
+ */
+ | {
+    type: 'background_report';
+    seq: number;
+    ts: string;
+    payload: {
+        content: string;
+    };
 } | {
     type: 'aborted';
     seq: number;
@@ -314,15 +325,13 @@ export type ProcessEvent = {
     };
 }
 /**
- * 流式错误（重放可见性）：失败轮在**实时流**里已有 `AgentChunk.error`（宿主据此即时弹
- * 提示条），但该 chunk **不落 processEvents** → 回看历史时原因丢失、只剩 generic「对话已中断」，
- * 用户无法回答「这轮为什么没答完」。本变体把 error 落进重放轨，宿主桥接点 =
- * `chatPanel.consumeFlow` 的 `error` 分支。
+ * 流式错误（重放可见性）：实时流的 `AgentChunk.error` **不落 processEvents** ⇒ 回看历史时
+ * 原因丢失、只剩「对话已中断」。本变体把 error 落进重放轨（宿主桥接 = `chatPanel.consumeFlow`
+ * 的 `error` 分支）。
  *
- * 与 `aborted` 的分工（**禁互相承载**，见 `agent/types.ts` 的 `AbortStopReason` 注释）：`aborted`
- * 由 AbortSignal 触因产生（用户停止 / 锁超时），答「谁让它停的」；本变体答「出了什么错」。
- * 二者在 failed 路径互斥（`signal.aborted === false` 才抛错），故不构成同轮双写。
- * `category` 与 `AgentChunk.error.category` **同源**（`LlmErrorCategory`）——展示面文案映射共用一份。
+ * 与 `aborted` 分工（**禁互相承载**）：`aborted` 答「谁让它停的」（AbortSignal 触因），
+ * 本变体答「出了什么错」；二者在 failed 路径互斥，不构成同轮双写。
+ * `category` 与 `AgentChunk.error.category` **同源**（`LlmErrorCategory`）。
  */
  | {
     type: 'error';
@@ -421,23 +430,16 @@ export type RoundEvidenceEvent = {
 /**
  * 问答闭环（Round）
  *
- * 设计约束：
- * 1. 全局唯一 ID：一个 roundId 在物理存储中只对应一个问答闭环
- * 2. 包含一轮完整的 User + AI 对话
- * 3. 独立于会话存储，可被多个会话引用（分叉场景）
- * 4. Append-only 设计：完成后不可修改，如需"修改"则创建新 Round
+ * 设计约束：全局唯一 ID、包含一轮完整 User+AI 对话、独立于会话存储（可被多会话引用）、
+ * **Append-only**（完成后不可修改，需"修改"则建新 Round）。
  */
 export interface Round {
     /**
      * 全局唯一 ID（格式：round-{uuid}）
      *
-     * 唯一性保证：
-     * - 物理存储层唯一标识
-     * - 记忆溯源的唯一锚点（Memory.roundId 指向此字段）
-     * - 分叉操作的唯一引用
+     * 同时是记忆溯源的唯一锚点（`Memory.roundId` 指向此字段）与分叉操作的唯一引用。
      */
     id: string;
-    /** 用户消息 */
     userMessage: RoundMessage;
     /** AI 消息（pending 状态时可能为空） */
     assistantMessage?: RoundMessage;
@@ -465,27 +467,20 @@ export interface Round {
      * （零冗余：仅在 appendAssistant 重写已存在 assistantMessage 时产生）。
      */
     assistantLog?: RoundMessage[];
-    /** 问答闭环状态 */
     status: RoundStatus;
     /** 创建时间（ISO 8601） */
     createdAt: string;
     /** 完成时间（ISO 8601，仅 complete 状态有值） */
     completedAt?: string;
     /**
-     * 引用计数（被多少个会话引用）
-     *
-     * 用途：
-     * - 分叉时增加引用（新会话引用同一个 Round）
-     * - 删除会话时减少引用
-     * - 引用计数为 0 时可被 GC 清理
+     * 引用计数（被多少个会话引用）：分叉 +1、删除会话 −1、**归零即可被 GC 清理**。
      */
     refCount: number;
     /**
      * 过程事件（每轮 UI 状态重建真相源，可选）
      *
      * 与 assistantMessage 同在闭环完成时刻定型（Write-once），存储于同一 Round 文件——
-     * 删 round 即删事件、分叉即共享、截断即覆盖（v1.5 单文件内聚，见
-     * process-event-log-replay-design.md §3.4）。缺省仅因 pending/error 轮无过程数据。
+     * 删 round 即删事件、分叉即共享、截断即覆盖。缺省仅因 pending/error 轮无过程数据。
      */
     processEvents?: ProcessEvent[];
 }
@@ -571,17 +566,12 @@ export interface IRoundStore {
      * 列出指定日期最近未完成（pending/error）的崩溃残留轮（step 原子落盘）。
      *
      * 用途：崩溃残留轮升级前的**只读中转**——崩溃发生在 appendAssistant 完成前时，该轮
-     * refCount=0、未登记进会话 roundIds，宿主无法从会话列表发现；但其过程已由 step 原子
-     * 检查点落盘到 pending Round。宿主重启后经此口查回，「找到」后由宿主调用收场方法
-     * （MessageHistory.appendInterrupted）**升级为正常 stop turn** 并登记入会话。
+     * refCount=0、未登记进会话 roundIds（宿主无法从会话列表发现），但过程已由 step 检查点
+     * 落盘；宿主重启后经此口查回，再调 `MessageHistory.appendInterrupted` 升级为正常 stop turn。
      *
-     * 语义约束（SSOT）：
-     * - **只读查询**，不登记会话、不改写 Round、不改变 appendAssistant 完成语义；
-     *   升级登记是独立的「收场」动作（§一·五：中断轮 = 正常 stop turn，非半成品草稿）。
-     * - **不污染正式会话 roundIds**——升级登记完成（complete + refCount>0）前，中断轮
-     *   仍是无引用中间态，本接口只处理该短暂窗口的「找到」。
-     * - 中断轮超龄后仍由 GC sweepOrphans 正常回收（refCount=0 孤儿），本接口不改变其生命周期；
-     *   打捞窗口落在启动后的升级动作内（早于 24h 存活保护），不构成误回收。
+     * 语义约束（SSOT）：① **只读**——不登记会话、不改写 Round、不改变 appendAssistant 完成语义；
+     * ② **不污染正式会话 roundIds**（升级登记完成前中断轮仍是无引用中间态）；
+     * ③ 不改变生命周期——超龄仍由 GC sweepOrphans 按 refCount=0 孤儿回收，打捞窗口早于存活保护。
      *
      * @param date - YYYY-MM-DD，按 createdAt 的前缀匹配（ISO 日期头 10 位）
      * @param limit - 最多返回条数，按 createdAt 降序（最新在前）；缺省不截断
@@ -589,11 +579,7 @@ export interface IRoundStore {
      */
     listInterruptedRecent?(date: string, limit?: number): Round[];
 }
-/**
- * 生成 Round ID（格式：round-{uuid}）
- *
- * 使用 crypto.randomUUID() 保证全局唯一性
- */
+/** 生成 Round ID（格式：round-{uuid}） */
 export declare function generateRoundId(): string;
 /**
  * 生成消息 ID（格式：msg-{uuid}）

package/dist/memory/roundStore.d.ts.map

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