@zooique/memora 2.0.3 → 3.0.1

package/dist/agent/managers/sessionManager.d.ts

@@ -1,99 +1,328 @@
 /**
- * 会话管理器
- *
- * 从 Agent 类中提取会话管理职责（ADR-010 §Agent 类拆分）。
- * 负责会话切换、分叉、恢复和消息加载，通过回调函数访问 Agent 的当前组件状态，
- * 避免与 Agent 的 history/loop 引用生命周期耦合。
- *
- * Agent 通过组合方式持有 SessionManager 实例，将会话相关操作委托给它。
+ * 会话管理器：从 Agent 拆出的独立会话职责，负责会话切换/分叉/恢复/消息加载。
+ * 通过回调访问 Agent 当前组件状态，避免与 history/loop 引用生命周期耦合。
+ * 不中断工作模型：SessionCheckpoint 为同进程内存态快照（不落盘、无序列化/恢复路径）；SessionStateMachine 管理三态流转。
  */
 import type { AgentLoop } from '../../agent/loop.js';
-import type { MessageHistory } from '../../agent/messageHistory.js';
+import type { MessageHistory, ForkResult } from '../../agent/messageHistory.js';
 import type { SessionMessage } from '../../memory/sessionStore.js';
-import type { ISessionStore } from '../../memory/sessionStore.js';
+import type { ISessionStore, SessionMeta } from '../../memory/sessionStore.js';
+import { type AgentEventName } from '../../utils/eventEmitter.js';
+import type { SessionCheckpoint, SessionStatus, PlanItem, ToolExecutionRecord, PauseMeta, PauseSource } from '../../agent/types.js';
+import type { GoalConsistencyResult } from '../../agent/managers/goalConsistencyChecker.js';
 /**
- * Agent.forkSession() 返回值类型
+ * 分叉操作结果（round-based 模式）
  *
- * 注意：与 MessageHistory.forkSession() 的内部返回类型 ForkResult 不同，
- * Agent 层做了简化封装，只暴露宿主需要的 newSession 和 messageCount。
- */
-export interface AgentForkResult {
-    /** 新分支会话名（不含日期前缀的简短名，可直接传给 switchSession()） */
-    newSession: string;
-    /** 分叉时复制的消息数量 */
-    messageCount: number;
-}
-/**
- * 会话管理器
- *
- * 通过回调函数访问 Agent 的当前组件状态，支持 Agent 重建组件后自动获取最新引用。
+ * 在 MessageHistory 内部 ForkResult（newSession/date/roundIds）之上附加 roundCount，
+ * 基础字段派生复用，不再手写重复声明。
  */
+export type AgentForkResult = ForkResult & {
+    /** 新会话的 Round ID 数量（问答闭环个数） */
+    roundCount: number;
+};
+/** 会话管理器：经回调访问 Agent 当前组件状态，支持 Agent 重建后自动取最新引用 */
 export declare class SessionManager {
-    /** 获取当前 MessageHistory 实例的回调 */
     private getHistory;
-    /** 获取当前 AgentLoop 实例的回调 */
     private getLoop;
     /** 会话存储（可选，由宿主注入） */
     private sessionStore;
-    /** 检查对话是否繁忙的回调 */
     private isChatBusy;
     /** 发射事件（委托给 Agent 的 TypedEventEmitter） */
     private emitEvent;
-    constructor(getHistory: () => MessageHistory, getLoop: () => AgentLoop, sessionStore: ISessionStore | undefined, isChatBusy: () => boolean, emitEvent: (event: string, data: Record<string, unknown>) => void);
+    /** 会话状态机（三态流转，经有界代理方法访问） */
+    private stateMachine;
+    /** 当前会话检查点（运行时状态快照） */
+    private checkpoint;
+    /** 检查点脏标记（内存态收口）：touchCheckpoint 置位、settleCheckpoint 清理（纯内存态，不落盘） */
+    private checkpointDirty;
+    /** 目标一致性校验器（目标版本一致性校验） */
+    private readonly consistencyChecker;
     /**
-     * 切换当前会话
+     * 连续暂停时间戳数组（防滥用窗口）：每次高风险暂停记录时间戳，窗口（1 小时）内连续 2 次则强制降为低风险暂停。
+     * ⚠ 进程内状态，不入 SessionCheckpoint——重启归零是设计（反滥用卫生状态，非执行状态）；1h 窗口自愈防线，勿引入持久化。
+     */
+    private consecutivePauseTimestamps;
+    /** 连续暂停时间窗口（毫秒），1 小时前的暂停不计入连续计数 */
+    private static readonly CONSECUTIVE_PAUSE_WINDOW_MS;
+    /** 暂停超时检测定时器（只在 paused 状态时运行） */
+    private _pauseTimeoutTimer;
+    /** 暂停超时检测间隔（毫秒），30 秒检查一次心跳 */
+    private static readonly PAUSE_TIMEOUT_CHECK_INTERVAL;
+    constructor(getHistory: () => MessageHistory, getLoop: () => AgentLoop, sessionStore: ISessionStore | undefined, isChatBusy: () => boolean, emitEvent: (event: AgentEventName, data: Record<string, unknown>) => void);
+    /** 会话状态（状态机状态） */
+    get status(): SessionStatus;
+    /** 获取暂停信息（仅 PAUSED 时有效） */
+    get pauseInfo(): {
+        reason: string;
+        source: PauseSource;
+    } | null;
+    /** 获取异常原因（仅 ERROR 时有效） */
+    get errorInfo(): string | null;
+    /** 获取待处理暂停信息（只读，不消费） */
+    get pendingPauseInfo(): {
+        reason: string;
+        source: PauseSource;
+    } | null;
+    /** 检查是否处于暂停态 */
+    isPaused(): boolean;
+    /** 检查是否处于运行态 */
+    isRunning(): boolean;
+    /** 待处理暂停请求是否在等待中 */
+    isPausePending(): boolean;
+    /**
+     * 请求软暂停（仅 RUNNING 状态允许）
      *
-     * 与 forkSession() 对齐：底层 MessageHistory.switchSession 是纯同步操作（字段赋值），
-     * Agent 层不引入无意义的 async 包装。返回新会话名。
+     * 暂存暂停原因和来源，待 loop 边界真正挂起时由 consumePendingPause() 消费。
+     * 与 pause() 不同：pause() 立即翻状态机，requestPause() 仅注册待处理请求。
+     */
+    requestPause(reason: string, source?: PauseSource): boolean;
+    /** 消费待处理暂停请求（在 loop 边界真正挂起时调用） */
+    consumePendingPause(): {
+        reason: string;
+        source: PauseSource;
+    } | null;
+    /** 取消待处理暂停请求 */
+    cancelPendingPause(): void;
+    /**
+     * 会话替换 chokepoint：作废所有会话级派生缓存。
+     * 任何替换 loop 工作记忆（switch/fork/restore）入口都必须经此，新增派生缓存在此注册一处避免"对称的另一半没写完"。
      */
+    private invalidateSessionDerivedState;
+    /** 切换当前会话。底层 MessageHistory.switchSession 为纯同步操作，不引入无意义 async 包装。 */
     switchSession(newSession: string): string;
     /**
-     * 获取当前会话的日期和会话名
-     *
-     * 供宿主在 switchSession 前获取当前会话标识，用于触发 content 类归档。
-     * 返回 null 表示 history 未初始化。
+     * 打开指定会话（新建空/切换已有）= switchSession 的完整版：切换身份后同步 loadSessionMessages + restoreHistory。
+     * 已有会话恢复历史到工作记忆；新建空会话 restoreHistory([]) 清空（保留 system prompt），避免旧会话上下文残留注入首条消息。
+     * 使用正则 /^(\d{4}-\d{2}-\d{2})-(.+)$/ 解析，正确处理包含连字符的会话名（如 2024-01-15-my-session）。
+     * @returns 恢复的消息数（0 表示新建空会话）
      */
+    switchToSession(sessionId: string): Promise<number>;
+    /** 获取当前会话的日期和会话名（供 switchSession 前触发 content 类归档）；history 未初始化返回 null */
     getCurrentSessionInfo(): {
         date: string;
         session: string;
     } | null;
+    /** 读取会话标题元数据：供宿主历史列表展示；未注入 getSessionMeta 时标题层静默失效 */
+    getSessionMeta(sessionId: string): SessionMeta | undefined;
+    /** 手动改名会话：仅写 displayName（用户可改），不改 autoName（LLM 只读）。显示回退：displayName 非空用之，否则用 autoName */
+    renameSession(sessionId: string, title: string): void;
     /**
-     * 分叉当前会话：复制完整消息历史到新分支，切换到新分支继续对话
+     * 从指定 Round 位置分叉当前会话（round-based 模式唯一分叉方式）。
+     *
+     * 分叉后：新会话包含分叉点及之前的所有 Round ID，是完全平等的普通会话。
+     * 原会话完整保留可切回；新会话的问答闭环独立互不干扰。
+     * ⚠ fork 不隔离记忆——分支 A 的 round-summary 会在分支 B 召回中出现。
      *
-     * 分叉后：
-     * - 原会话完整保留，可随时通过 switchSession() 切回（用原会话简短名）
-     * - 新分支拥有独立的消息历史，后续对话互不干扰
-     * - 记忆索引（IMemoryStorage）全局共享，不受分叉影响
+     * @param roundId - 分叉点的 Round ID（可选；不传默认使用最后一个 Round）
+     * @param targetSession - 可选，自定义新会话名；不传则自动生成
+     */
+    forkSession(roundId?: string, targetSession?: string): AgentForkResult;
+    /**
+     * 恢复最近活跃会话：经 ISessionStore 加载最近消息到工作记忆；宿主未注入则返回 0。
+     *
+     * 会话管理纯度：会话一律手动创建（宿主标题条「＋」唯一入口），
+     * 本方法只做「恢复」、绝不隐式创建会话——无按天归档隐式语义
+     * （「今天-main 优先」类规则），也无 preferredSession 参数。最近活跃的唯一时间序真理源 = listSessionMetas[0]（updatedAt 降序）。
+     *
+     * @returns 恢复的消息条数（0 = 无可恢复会话）
+     */
+    restoreMostRecentSession(): Promise<number>;
+    /** 恢复指定会话的对话 */
+    restoreSession(date: string, session: string): Promise<number>;
+    /** 对外暴露的 loadSessionMessages 委托。⚠ 会切换当前会话（更新 currentDate/currentSession），加载后下一条 chat 写入被加载会话 */
+    loadSessionMessages(date: string, session: string): Promise<SessionMessage[]>;
+    /** 将会话消息恢复到 AgentLoop 工作记忆 */
+    private applySessionToLoop;
+    /**
+     * 检查点必需字段默认值工厂（默认值单一真理源）。
+     * 仅 createCheckpoint 新建/合并时使用——反序列化采用严格模式，不做静默补齐。
+     * 必须返回新实例：数组/对象默认值共享引用会让不同检查点互相污染（一个 push 计划任务项另一凭空多出）。
+     */
+    private static checkpointDefaults;
+    /** 从当前运行时状态创建检查点：快照消息历史与会话标识生成 SessionCheckpoint（纯内存态，
+     *  不落盘——中止/断电走中断轮补全，运行时暂停同 turn 内存续跑） */
+    createCheckpoint(mainGoal?: string): SessionCheckpoint;
+    /**
+     * 标记检查点已变更（内存写点统一入口）。刷新心跳并置脏标记。
+     * 所有修改 this.checkpoint 的方法都必须调用本方法，不得直接赋值 lastHeartbeat——否则变更不被后续清脏感知，内存与清脏链路静默分叉。
+     */
+    private touchCheckpoint;
+    /**
+     * 检查点脏标记清理（**纯内存态**）：
+     * `SessionCheckpoint` 不落盘——中止/断电走「中断轮补全为完整 turn」而非跨重启恢复，
+     * 运行时暂停是同 turn 内续跑（内存态），无跨进程载体需求。故本方法仅清理脏标记，
+     * 不再写存储层（保留方法语义边界，避免为纯净化波及 40+ 处调用点）。
+     */
+    private settleCheckpoint;
+    /** 获取当前检查点快照；未创建返回 null */
+    getCheckpoint(): SessionCheckpoint | null;
+    /**
+     * 暂停会话（用户/Agent/系统均可触发）。暂停前自动创建检查点；高风险暂停计入连续计数（防滥用），低风险不计。
+     * @param lowRisk 低风险暂停不计连续计数（默认 false）
+     */
+    pause(reason: string, source?: PauseSource, lowRisk?: boolean): boolean;
+    /** 恢复会话：从 PAUSED 恢复到 RUNNING。超时会话需重新开始，不能恢复 */
+    resume(): boolean;
+    /** 触发异常（仅 RUNNING 态）。异常时自动创建检查点；createCheckpoint 会从状态机投影 status/error，不再手工赋值避免并列真理源 */
+    triggerError(cause: string): boolean;
+    /** 清理过期暂停时间戳（窗口过滤）：移除超过窗口（1 小时）的旧时间戳，仅保留窗口内暂停；每次查询计数时自动调用 */
+    private pruneStalePauseTimestamps;
+    /** 检查连续暂停是否已达上限（防滥用）：先清理窗口外时间戳，再查窗口内暂停≥2 次则强制降为低风险暂停。低风险不计数 */
+    isPauseLimitReached(): boolean;
+    /** 获取当前连续暂停计数：先清理窗口外时间戳，返回窗口内有效暂停数 */
+    getConsecutivePauseCount(): number;
+    /** 重置连续暂停计数（防滥用）：暂停超时处理后调用。与 resume() 分离，防回答前过早清零致防滥用失效 */
+    resetConsecutivePauseCount(): void;
+    /**
+     * 放弃当前暂停检查点（宿主 stop 语义的内核出口）
      *
-     * **注意**：fork 不隔离记忆。分支 A 中提取的 insight 会在分支 B
-     * 的召回中出现，反之亦然。如需要完全独立的记忆空间（如多用户场景），
-     * 应创建独立 Agent 实例 + 独立 dataDir，而非 fork。
+     * 语义 = 用户决定**彻底放弃**暂停执行，不再 resume。清理内容：
+     *   1. 停暂停超时定时器（防止已放弃的 checkpoint 继续被超时清理）
+     *   2. 清内存态 checkpoint + checkpointDirty + pauseMeta
+     *   3. 状态机 resetToRunning（回到 idle 之前的 running 基础态，下次 chat() 正常）
      *
-     * @param targetSession - 自定义新分支名（可选，不传则自动生成）
-     * @returns { newSession, messageCount }
+     * 与 resume() 的区别：resume = 想继续跑暂停点；discardCheckpoint = 不想了，检查点作废。
+     * 与 pause() 的对称：pause 创建检查点；discardCheckpoint 销毁检查点。
+     * @returns true=成功清理；false=无暂停检查点（空闲态调了个空）
      */
-    forkSession(targetSession?: string): AgentForkResult;
+    discardCheckpoint(): boolean;
+    /** 从异常恢复：标记 error.recovered=true 并经 stateMachine.recover 校验。检查点不落盘，恢复仅活在内存态 */
+    recover(): boolean;
     /**
-     * 恢复最近的会话对话
+     * 更新检查点目标版本：递增 goalChangeSeq 触发漂移检测。漂移处置由内核自兜底不依赖宿主：
+     * drift 级内核直接低风险暂停强制确认；minor 级仅发射事件+日志不打断执行。
+     * goalDriftDetected 事件为可观测性出口，宿主可选订阅，不订阅不影响正确性。
+     */
+    updateGoal(newGoal: string): GoalConsistencyResult | null;
+    /** 全量替换计划任务项（与 appendPlanItem 仅追加正交；保留已有任务项 id/status）。唯一生产点：task_table_write mode='replace' */
+    updatePlan(plan: PlanItem[]): void;
+    /** 追加计划任务项：在 plan 末尾追加新任务项，不重排已有 order。rolePack 为会议表层装配角色（可选） */
+    appendPlanItem(description: string, rolePack?: string): number;
+    /**
+     * 写入执行计划（计划写入口唯一分发点）。模式语义：
+     *   'overwrite'：先清空现有 plan 再逐条追加（真重写——LLM task_table_write / 会议预置都依赖此语义，
+     *                 若与 'append' 同分支只追加不清空，则 overwrite 名存实亡）；
+     *   'append'   ：在现有 plan 后逐条追加；
+     *   'replace'  ：全量替换现有 plan（保留已有 id/status/rolePack，仅覆盖 description）。
+     *   其它 mode 兜底 no-op。
+     * 分发逻辑归本类承载，由 sessionCheckpointLifecycle.test.ts 覆盖。
+     */
+    writePlan(mode: 'overwrite' | 'append' | 'replace', items: Array<{
+        description: string;
+        rolePack?: string;
+    }>): PlanItem[];
+    /**
+     * 更新计划任务项状态（plan 任务项状态的唯一写点）。必须经此写点置 checkpointDirty，
+     * 否则状态变更可能丢失标脏，计划变更与标脏在此原子完成。
      *
-     * 通过 ISessionStore 加载最近的会话消息，恢复到 AgentLoop 工作记忆。
-     * 宿主项目需注入 ISessionStore 实现，否则返回 0。
+     * 写完后自动 ensureActivePlanItem：如果变更导致 active 空缺（如把 active 标记为 done/blocked），
+     * 则推进下一个 pending → active。这保证任何时刻 plan 中恰好有一个 active 任务项。
      */
-    restoreMostRecentSession(preferredSession?: string): Promise<number>;
+    updatePlanItemStatus(planItemId: string, status: PlanItem['status']): boolean;
     /**
-     * 恢复指定会话的对话
+     * 确保 plan 中存在且仅存在一个 active 任务项（SSOT 自维护）。
+     *
+     * 三种场景会触发补偿：
+     * 1. 全 pending，无 active → 激活第一个 pending（plan 刚写入时）
+     * 2. 有 active，且刚被标记为 done/blocked → 激活下一个 pending（推进语义）
+     * 3. 无 active 且全 done/blocked → 空操作（plan 已完成）
+     *
+     * 不在 updatePlanItemStatus 外部重复调用——它在每次写点后自动执行。
      */
-    restoreSession(date: string, session: string): Promise<number>;
+    private ensureActivePlanItem;
     /**
-     * 对外暴露的 loadSessionMessages 委托
+     * 是否存在「在途计划」= 有未完成任务项（pending 或 active）。
      *
-     * **注意：此方法会切换当前会话**（更新 currentDate/currentSession）。
-     * 加载后，下一次 chat() 的消息会写入被加载的会话。
+     * SSOT：全库该命题唯一实现。消费方三处——会议骨架预置守卫（prepare，判断续会不重开）、
+     * 任务表 nudge 跳过（loop，已有在途表则不再诱导建表）、canContinueWithoutInput（agent，
+     * 可续跑信号）。禁任一消费方自行内联谓词。
+     *
+     * 口径取 pending||active（非仅 active）：与 ensureActivePlanItem 的补偿语义对齐——
+     * plan 非空时恒有一个 active（见 :826 场景 1/2），全 done/blocked 时无 active（场景 3），
+     * 两种判法在「有未完成任务项」上等价，但本口径直接表达「未完成」而非「借 active 存在性」。
      */
-    loadSessionMessages(date: string, session: string): Promise<SessionMessage[]>;
+    hasInflightPlan(): boolean;
+    /** 完成一个任务项（显式完成原语）：单函数内顺序写任务项状态 + planItemLog + heartbeat 保证原子性。
+     *  消费方 = turn 收尾兜底 concludeActivePlanItemIfPlanFullyReached（LLM 未显式 task_table_update
+     *  的最后一个任务项补标）；迭代边界 onPlanItemBoundary 只走 logPlanItemBoundary 写日志，
+     *  不经本方法推进。 */
+    completePlanItem(options: {
+        planItemId?: string;
+        summary: string;
+    }): void;
+    /** 写 step 边界日志（时间轴投影，不改 plan 状态）。迭代边界
+     *  onPlanItemBoundary 只做本写——plan 状态推进唯一写者 = LLM 的 task_table_update。 */
+    logPlanItemBoundary(options: {
+        planItemId?: string;
+        summary: string;
+    }): void;
     /**
-     * 将会话消息恢复到 AgentLoop 工作记忆
+     * 兜底收尾（「LLM 未显式 update 即收尾」）：turn 正常完成且计划已「全部到达」——
+     * 存在 active 任务项且无 pending 任务项（LLM 已显式完成所有更早任务项、当前项为最后到达的一项）——
+     * 时闭合该 active 任务项（completePlanItem：标 done + planItemLog）。LLM 忘标最后一个任务项时由本兜底补上，
+     * 使计划达到全 done（任务表 turn 内收敛，turn 结束兜底清理）；真实多轮任务（有 pending）不受影响。
+     * 触发点 = seed/orchestrator.act 正常收尾分支（非暂停/中断/失败）。
      */
-    private applySessionToLoop;
+    concludeActivePlanItemIfPlanFullyReached(summary: string): void;
+    /**
+     * 追加任务项日志（completePlanItem / logPlanItemBoundary 共用）。按 planItemId
+     * 分组截断，每任务项最多 3 条——若用全局 FIFO 12 条，5+ 任务项的任务中旧任务项的运行记录会被
+     * 整段截没，用户翻旧已完成任务项的摘要看到「空」。
+     */
+    private appendPlanItemLog;
+    /** 卸载运行态挂载物：任务流结束/转 idle 时清空 plan/planItemLog（SSOT 资源层 vs 状态层模型），回到"空闲=无挂载物"常态；与 updatePlan（运行态维护）正交 */
+    clearPlan(): void;
+    /** 设置暂停元数据；传 undefined 清除。写后必须清脏（清除也清脏，纯内存态无磁盘残留） */
+    setPauseMeta(meta: PauseMeta | undefined): void;
+    /**
+     * 计划是否全部阻塞（预判短路收窄专用判定）：仅全 blocked 视为真停滞。
+     * 全 done / 计划空不视为"需要拦截"——用户主动点「继续」= 要 AI 产出，
+     * 全 done 可能只是本步收尾（还有总结未说出），空计划是普通问答暂停续跑，都应放行调 LLM。
+     * 口径警告：不得把空计划/全 done 判为停滞，否则会误拦正常续跑。
+     */
+    isPlanAllBlocked(): boolean;
+    /** 获取下一个 pending 任务项（只读不推进，供上下文注入） */
+    getNextPendingPlanItem(): PlanItem | null;
+    /** 获取当前 active 任务项 */
+    getActivePlanItem(): PlanItem | null;
+    /**
+     * 记录工具执行：追加到检查点日志（append-only，内存态）。
+     * 标脏策略：仅标脏不即时清脏（completePlanItem step 边界统一清脏、createCheckpoint 暂停/异常强制清脏）。
+     * 检查点纯内存态不落盘：completedToolCalls 仅内存态，回合中途崩溃即整体丢弃、走中断轮补全恢复；
+     * 「工具重跑排重」仅在单进程存活期内有效，无跨重启持久化。
+     */
+    logToolExecution(record: ToolExecutionRecord): void;
+    /** 记录非幂等工具执行（补偿降级后仅日志）：不再逐副作用执行补偿，仅记录事实供宿主/人工排查 */
+    compensateTool(record: ToolExecutionRecord): string;
+    /** 记录所有非幂等工具执行（补偿降级后仅日志）：直接记录所有非幂等工具，每条生成一条日志 */
+    compensateAllNonIdempotent(): string[];
+    /** 发送心跳，防僵尸会话 */
+    heartbeat(): void;
+    /**
+     * 标记会话暂停超时（超时事实唯一写点）。广播式：超时信息经事件载荷传递，多监听器并行消费互不干扰。
+     * 由 checkPauseTimeout 调用（唯一调用点，启动路径无跨重启恢复）。
+     * 会话标识不符 YYYY-MM-DD-<会话名> 时 date/session 缺省但仍发射事件。
+     */
+    private markSessionTimedOut;
+    /** 启动暂停超时检测定时器（仅 paused 态生效）：超时自动清理检查点、重置状态机、发射事件。先 stop 防重复启动 */
+    private startPauseTimeoutTimer;
+    /** 停止暂停超时检测定时器 */
+    private stopPauseTimeoutTimer;
+    /** 检查暂停超时并在超时时自动清理：清理检查点、重置状态机、发射事件并停止定时器 */
+    private checkPauseTimeout;
+    /** 关闭时清脏（纯内存，无落盘）：Agent 关闭、destroy 前调用。检查点不落盘，
+     *  本方法为保留语义边界的 no-op 清脏（无持久化动作） */
+    flushOnShutdown(): void;
+    /** 立即清脏（纯内存，无落盘）：非只读工具完成后调用。⚠️ 检查点不落盘，completedToolCalls 仅内存态——
+     *  「工具重跑排重」仅在单进程存活期内生效，进程崩溃/重启后失效（走中断轮补全）。无落盘设计，
+     *  本方法为保留语义边界的 no-op 清脏 */
+    flushNow(): void;
+    /** 销毁 SessionManager，清理所有定时器（防阻止进程退出或悬空回调） */
+    destroy(): void;
+    /**
+     * 检查暂停是否超时：仅对 paused 态，距离暂停起点（pausedAt，缺失回退 lastHeartbeat）超过 PAUSE_TIMEOUT_MS 视为超时。
+     * pausedAt 与 lastHeartbeat 解耦，避免暂停后 touchCheckpoint 刷新心跳让超时判定被无限推迟。超时会话自动清理不再恢复。
+     */
+    private isPauseTimedOut;
 }
 //# sourceMappingURL=sessionManager.d.ts.map

package/dist/agent/managers/sessionManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sessionManager.d.ts","sourceRoot":"","sources":["../../../src/agent/managers/sessionManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAG9D;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,+CAA+C;IAC/C,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB;IACjB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;;GAIG;AACH,qBAAa,cAAc;IACzB,gCAAgC;IAChC,OAAO,CAAC,UAAU,CAAuB;IACzC,2BAA2B;IAC3B,OAAO,CAAC,OAAO,CAAkB;IACjC,qBAAqB;IACrB,OAAO,CAAC,YAAY,CAA4B;IAChD,kBAAkB;IAClB,OAAO,CAAC,UAAU,CAAgB;IAClC,0CAA0C;IAC1C,OAAO,CAAC,SAAS,CAAyD;gBAGxE,UAAU,EAAE,MAAM,cAAc,EAChC,OAAO,EAAE,MAAM,SAAS,EACxB,YAAY,EAAE,aAAa,GAAG,SAAS,EACvC,UAAU,EAAE,MAAM,OAAO,EACzB,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI;IASnE;;;;;OAKG;IACH,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;IASzC;;;;;OAKG;IACH,qBAAqB,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAcjE;;;;;;;;;;;;;;OAcG;IACH,WAAW,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,eAAe;IA6BpD;;;;;OAKG;IACG,wBAAwB,CAAC,gBAAgB,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC;IAgD1E;;OAEG;IACG,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAgBpE;;;;;OAKG;IACG,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IASnF;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAS3B"}
+{"version":3,"file":"sessionManager.d.ts","sourceRoot":"","sources":["../../../src/agent/managers/sessionManager.ts"],"names":[],"mappings":"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"}