@zooique/memora 2.0.3 → 3.0.1

package/dist/agent/seed/prepare.js

@@ -0,0 +1,107 @@
+/**
+ * 回答前（Prepare）— 种子闭环第一阶段
+ *
+ * 编排骨架：策略装配 → 角色 → 上下文装配 → roundId
+ * → appendUser → 会话命名。会议机制：任务项表层装配视角经本模块读取并驱动前缀刷新。
+ *
+ * 设计原则：
+ *   - 叶子逻辑（assembleContext → 上下文装配：预算派生 + 对话层注入 + 占用快照）在
+ *     ContextPreparer 唯一实现，本模块只保留编排骨架（与 ContextPreparer 文档一致）。
+ */
+import { backgroundTask } from '../../utils/backgroundTask.js';
+import { resolveL2Strategy, resolveActiveStrategy } from '../../role-pack/strategyResolver.js';
+/**
+ * 回答前阶段执行器
+ *
+ * 一次输入 → 装配上下文（角色 + 技能 + 用户消息入史），供回答中消费。
+ * @remarks 异步生成器：运行期 yield AgentChunk（thinking 各阶段），返回 SeedPrepareResult。
+ */
+export class SeedPrepare {
+    /** 依赖注入（门面稳定能力窄面） */
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    /**
+     * 执行回答前：策略装配 → 角色 → 上下文装配 → 技能注入 → roundId → 用户消息入史 → 会话命名。
+     *
+     * @param input 用户输入
+     * @param signal 中止信号（回答前中断则在技能注入前返回 aborted）
+     * @returns 回答前结果（input + aborted；round 归属见 SeedPrepareResult）
+     */
+    async *run(input, signal) {
+        const { loop, history, sessionManager, rolePackManager, contextPreparer, sessionNamer } = this.deps.getParts();
+        // 每次回答前先清临时 system 消息（技能/最近对话 prompt 是当轮注入，不跨轮累积）
+        loop.cleanTemporarySystemMessages();
+        // 会议机制：读取当前 active 任务项声明的 rolePack，按本轮表层装配刷新前缀（范围校验 + 回落）
+        const checkpoint = sessionManager?.getCheckpoint();
+        const activePlanItem = checkpoint?.plan.find((s) => s.status === 'active');
+        refreshAssemblyForRolePack(this.deps, activePlanItem?.rolePack);
+        // 会议机制实施前提②：组/成员清单暴露给 LLM（防编造角色名）——仅当 activePack 是某组组长时注入
+        const teamContext = rolePackManager?.buildTeamContextBlock() ?? '';
+        if (teamContext) {
+            loop.injectSystemMessage(teamContext);
+        }
+        // 会议机制骨架预置（「最小受控起点」）。
+        // 与 buildTeamContextBlock 文案互补：骨架补首轮确定性（顶部任务板可见 + PlanItem.rolePack 装配钩子），
+        // 文案约束 LLM 后续推进走 task_table 单通道。守卫语义：
+        //   已有未完成计划（pending/active 存在）→ 跳过骨架预置 = 续会语义：第二轮「继续小组会议」等输入
+        //   交给 LLM 按既有任务表推进，不再重开/叠加会议任务项；无在途计划时的「小组会议」输入 = 新会议 → overwrite 预置。
+        //   重开已推进会议需显式手段（宿主清空任务表 / LLM task_table_write），非自然语言自动触发。
+        // 在途判定经 SessionManager.hasInflightPlan 单点（SSOT）：与 loop 侧「已有在途任务表则跳过
+        // nudge」共用同一命题口径，禁此处再内联谓词另起一份判定。
+        const hasInflightPlan = sessionManager?.hasInflightPlan() ?? false;
+        const meetingPlanItems = hasInflightPlan
+            ? null
+            : (rolePackManager?.tryBuildMeetingPlan?.(input) ?? null);
+        if (meetingPlanItems && sessionManager) {
+            // 骨架预置：overwrite = 真重写，新会议替换一切旧计划
+            sessionManager.writePlan('overwrite', meetingPlanItems);
+        }
+        const strategy = resolveActiveStrategy(rolePackManager, this.deps.strategyOverride);
+        // 单一 setStrategy 聚合 L2 策略（工具权限/步数/错误处理/路由/预算/推理/只读/审批/自审查）
+        loop.setStrategy(resolveL2Strategy(strategy));
+        // 换角色 → 按激活角色包的 capabilities 应用工具暴露面（toolMode=block 全禁与此正交）
+        // 会议机制：工具面恒为 activePack（组员只"说"不执行，需完整能力应手动切换）——此处不走 roundAssemblyRole
+        this.deps.applyRolePackToolExposure();
+        yield { type: 'thinking', phase: 'assembling' };
+        // 上下文装配（无自动记忆召回，仅细则预算 + 对话层注入，见 memory-tool-recall-design §4）
+        await contextPreparer.assembleContext(input);
+        if (signal.aborted) {
+            return { input, aborted: true };
+        }
+        // 技能按渐进披露 L1 清单常驻 system prompt，正文由模型按需 read_skill，回答前不预注入
+        yield { type: 'thinking', phase: 'processing' };
+        const roundId = loop.allocRoundId();
+        loop.setCurrentRoundId(roundId);
+        await history.appendUser(input, roundId);
+        // 会话标题自动命名（fire-and-forget）：仅新建会话首次问答触发（以"会话无标题"判定，不覆盖手动改名）
+        if (sessionNamer) {
+            backgroundTask('session-title', () => sessionNamer.ensureSessionTitle(history.currentDateValue, history.currentSessionValue, input));
+        }
+        return { input, aborted: false };
+    }
+}
+/**
+ * 会议机制：按给定任务项 rolePack 刷新本轮表层装配视角。
+ *
+ * 装配逻辑单一真理源。两个调用入口共用本函数，避免双写：
+ *   - prepare.run（turn 开头：按首个 active 任务项的 rolePack 设一次）
+ *   - 任务表每轮注入（assembler.getTaskTable → hooks.applyActivePlanItemAssembly → agent.applyActivePlanItemAssemblyIfChanged，
+ *     随 active 任务项推进逐项换角色，防重见 agent 实现）
+ * 内部动作：
+ *   - resolveRoundAssemblyRole：范围校验（∈ 组长∪组员，越界/缺员→null+warning，防 LLM 幻觉角色名）
+ *   - setRoundAssemblyRole：skills 加载跟随装配视角
+ *   - refreshRolePackPrefixForRound：重建 loop 前缀（persona/rules/skills 换，键恒 activePack）
+ * rolePack 未声明/越界/缺员 → null → 回落 activePack 前缀（组长视角，工具面不变）。
+ *
+ * @param deps 种子依赖（取 rolePackManager + 刷新前缀能力）
+ * @param rolePack 任务项声明的角色包（无声明 = 非会议，回落 activePack）
+ */
+export function refreshAssemblyForRolePack(deps, rolePack) {
+    const rolePackManager = deps.getParts().rolePackManager;
+    const assembly = rolePackManager?.resolveRoundAssemblyRole(rolePack) ?? null;
+    rolePackManager?.setRoundAssemblyRole(assembly);
+    deps.refreshRolePackPrefixForRound?.(assembly);
+}
+//# sourceMappingURL=prepare.js.map

package/dist/agent/seed/prepare.js.map

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

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

@@ -0,0 +1,115 @@
+/**
+ * 种子 turn 契约类型 — turn（问答闭环，含回答前/中/后）的类型定义
+ *
+ * 种子哲学（turn = 最小单元，单一真理源）：一次触发 → 回答前 → 回答中 → 回答后。
+ * 本文件定义这三阶段的输入/输出契约，以及 seed 模块所需的依赖接口。
+ *
+ * 设计纪律：
+ *   - getParts() 以「快照 getter」形式提供当前组件引用——switchProject/rebuildComponents
+ *     会更换 loop/history/sessionManager，seed 每次运行经 getParts() 取最新引用，
+ *     否则 rebuild 后 seed 将残留陈旧组件引用（关键正确性约束）。
+ *   - consumeExecutionStream 是「统一流收口协议」，物理实现仍在门面（Agent），
+ *     本处仅声明类型，回答中阶段经依赖注入消费（方案的流收口协议归门面）。
+ */
+import type { AgentLoop } from '../../agent/loop.js';
+import type { MessageHistory } from '../../agent/messageHistory.js';
+import type { AgentChunk, ArchiveMode, UIMessages } from '../../agent/types.js';
+import type { ContextPreparer } from '../../agent/contextPreparer.js';
+import type { SessionManager } from '../../agent/managers/sessionManager.js';
+import type { RoundSummaryGenerator } from '../../agent/managers/roundSummaryGenerator.js';
+import type { SessionNamer } from '../../agent/managers/sessionNamer.js';
+import type { RolePackManager } from '../../role-pack/rolePackManager.js';
+import type { LlmProvider } from '../../llm/provider.js';
+import type { ITracer } from '../../agent/tracer.js';
+import type { BehaviorStrategy } from '../../role-pack/types.js';
+/**
+ * 流消费结果（consumeExecutionStream 的返回约定）
+ *
+ * content = 累积的文本；aborted = 是否被中断（用户取消/超时）；paused = 是否在 step 边界
+ * 软暂停挂起（回合未完成，摘要应推迟到续跑最终轮，保摘要 1:1）；failed = 是否执行出错
+ * （错误 chunk 已 yield 给调用方）。
+ *
+ * aborted 与 failed **同属「本轮未正常完成」**：act() 对二者走同一收尾收口
+ * （appendInterrupted → Round 落 complete），差异仅在返回值里保留各自的布尔位，
+ * 供调用方决定后续动作（如是否触发续跑）。见 orchestrator.act 的 SSOT 收口注释。
+ */
+export interface StreamConsumeResult {
+    content: string;
+    aborted: boolean;
+    paused: boolean;
+    failed: boolean;
+}
+/**
+ * 种子三阶段运行所需的组件快照（getParts 的返回值）
+ *
+ * 各 field 对应门面当前持有的组件实例；null 表示尚未创建（如 sessionNamer 在
+ * createPostInitComponents 才创建）。seed 只读不持有，全部由门面提供。
+ */
+export interface SeedParts {
+    loop: AgentLoop;
+    history: MessageHistory;
+    sessionManager: SessionManager | null;
+    rolePackManager: RolePackManager | null;
+    contextPreparer: ContextPreparer;
+    sessionNamer: SessionNamer | null;
+    roundSummaryGenerator: RoundSummaryGenerator | null;
+}
+/**
+ * 种子模块的依赖注入接口（门面稳定能力的窄面）
+ *
+ * 与 ContextPreparerDeps / AgentHooks 同构：只传稳定能力，不传可变私有状态。
+ * getParts() 惰性取当前组件（见文件头设计纪律）；applyRolePackToolExposure 与
+ * consumeExecutionStream 是门面私有能力，经回调注入 seed（物理实现仍在门面）。
+ */
+export interface SeedDeps {
+    /** 取当前组件快照（rebuild 后仍为最新引用） */
+    getParts(): SeedParts;
+    /** 可观测性 Tracer（缺省 Noop，reflect 阶段 span 用） */
+    tracer: ITracer | null;
+    /** 归档模式（reflect 阶段 span 标注用） */
+    archiveMode: ArchiveMode;
+    /** 界面文案（中断标记 / 用户中断提示，缺省用内置默认） */
+    messages?: UIMessages;
+    /** 门面能力：应用当前角色包的工具暴露面（回答前换角色后工具集切换） */
+    applyRolePackToolExposure(): void;
+    /**
+     * 门面能力：按本轮表层装配视角刷新 loop 前缀（会议机制）。
+     * roundRole=null（日常态）→ 回落 activePack 前缀；roundRole 为任务项角色 → 该角色 persona/rules/skills。
+     * 键（strategy/ChatOptions）恒为 activePack，不随视角变。缺省 no-op（纯工厂单测）。
+     */
+    refreshRolePackPrefixForRound?(roundRole: string | null): void;
+    /** 门面能力：统一流收口协议（消费 loop 执行流 → AgentChunk；物理实现在 Agent）。
+     *  signal 透传：consumeExecutionStream 据此区分「宿主/插话真取消」（signal.aborted）
+     *  与「provider/网络内部中断」（signal 未 abort 却抛 AbortError）——避免连接中断谎报为用户取消 */
+    consumeExecutionStream(source: AsyncGenerator<AgentChunk, void, unknown>, signal?: AbortSignal): AsyncGenerator<AgentChunk, StreamConsumeResult, unknown>;
+    /**
+     * 后台 Provider（难度分级等「回答前视图」轻量判定用；运行时可变，故取函数式）；
+     * 为 null 表示后台不可用 → 判定降级为 unknown，不影响主回答。
+     */
+    getBackgroundProvider(): LlmProvider | null;
+    /**
+     * 宿主装配级策略覆盖（可选）：经 resolveActiveStrategy 压过角色包声明，表达宿主产品能力边界。
+     *（v0.13 后无内置示例键；机制保留供宿主能力边界使用）
+     */
+    strategyOverride?: Partial<BehaviorStrategy>;
+    /**
+     * 门面事件发射回调（可选，默认 no-op）。种子编排器在摘要生成完成后触发 roundSummaryGenerated，
+     * 让宿主感知后台任务收口、解锁 UI 生命周期（删除/分叉按钮解禁）。
+     * 接口设计同 assembler 的 AgentHooks.emit——门面层桥接 TypedEventEmitter。
+     */
+    emit?: (event: string, payload: unknown) => void;
+}
+/**
+ * 回答前（Prepare）运行结果
+ *
+ * input = 原始输入；aborted = 回答前阶段已中断（调用方应 yield aborted chunk 并返回，不进回答中）；
+ * roundId 不在此结果中——round 归属以 loop 的 currentRoundId 为单一真理源。
+ *
+ * 注：不设 recalledMemories 之类恒空占位字段（占位符的存在本身即在宣称一件不存在的事）。
+ * 记忆检索唯一入口 = LLM 经 `search_memories` 工具主动触发（见 memory-tool-recall-design §3/§4）。
+ */
+export interface SeedPrepareResult {
+    input: string;
+    aborted: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/agent/seed/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC5E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2CAA2C,CAAC;AACvF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D;;;;;;;;;;GAUG;AACH,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;;;;GAKG;AACH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,cAAc,CAAC;IACxB,cAAc,EAAE,cAAc,GAAG,IAAI,CAAC;IACtC,eAAe,EAAE,eAAe,GAAG,IAAI,CAAC;IACxC,eAAe,EAAE,eAAe,CAAC;IACjC,YAAY,EAAE,YAAY,GAAG,IAAI,CAAC;IAClC,qBAAqB,EAAE,qBAAqB,GAAG,IAAI,CAAC;CACrD;AAED;;;;;;GAMG;AACH,MAAM,WAAW,QAAQ;IACvB,+BAA+B;IAC/B,QAAQ,IAAI,SAAS,CAAC;IACtB,6CAA6C;IAC7C,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;IACvB,gCAAgC;IAChC,WAAW,EAAE,WAAW,CAAC;IACzB,kCAAkC;IAClC,QAAQ,CAAC,EAAE,UAAU,CAAC;IACtB,uCAAuC;IACvC,yBAAyB,IAAI,IAAI,CAAC;IAClC;;;;OAIG;IACH,6BAA6B,CAAC,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;IAC/D;;0EAEsE;IACtE,sBAAsB,CACpB,MAAM,EAAE,cAAc,CAAC,UAAU,EAAE,IAAI,EAAE,OAAO,CAAC,EACjD,MAAM,CAAC,EAAE,WAAW,GACnB,cAAc,CAAC,UAAU,EAAE,mBAAmB,EAAE,OAAO,CAAC,CAAC;IAC5D;;;OAGG;IACH,qBAAqB,IAAI,WAAW,GAAG,IAAI,CAAC;IAC5C;;;OAGG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC7C;;;;OAIG;IACH,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;CAClD;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;CAClB"}

package/dist/agent/seed/types.js

@@ -0,0 +1,15 @@
+/**
+ * 种子 turn 契约类型 — turn（问答闭环，含回答前/中/后）的类型定义
+ *
+ * 种子哲学（turn = 最小单元，单一真理源）：一次触发 → 回答前 → 回答中 → 回答后。
+ * 本文件定义这三阶段的输入/输出契约，以及 seed 模块所需的依赖接口。
+ *
+ * 设计纪律：
+ *   - getParts() 以「快照 getter」形式提供当前组件引用——switchProject/rebuildComponents
+ *     会更换 loop/history/sessionManager，seed 每次运行经 getParts() 取最新引用，
+ *     否则 rebuild 后 seed 将残留陈旧组件引用（关键正确性约束）。
+ *   - consumeExecutionStream 是「统一流收口协议」，物理实现仍在门面（Agent），
+ *     本处仅声明类型，回答中阶段经依赖注入消费（方案的流收口协议归门面）。
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/agent/seed/types.js.map

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

package/dist/agent/sessionStateMachine.d.ts

@@ -0,0 +1,78 @@
+/**
+ * 会话状态机 —— 不中断工作模型的核心状态流转。
+ * 三态迁移契约：
+ *   RUNNING→PAUSED（用户/Agent/系统双向暂停）；PAUSED→RUNNING（恢复，无阻塞条件时）；
+ *   RUNNING→ERROR（异常：LLM 超时/工具失败/连接断开）；ERROR→RUNNING（恢复：须 error.recovered===true 且 cause 已解除）。
+ * 非法转换：PAUSED→ERROR、ERROR→PAUSED 均不允许。
+ * 设计意图：ERROR 态语义 =「崩溃残留 → 恢复前强制校验」。
+ *   ⚠ 当前产品流中 ERROR 态无自动产生者：重启一律以 running 起（否则宿主无 recover()
+ *     入口会把用户钉死在 error 态），运行时失败也不翻状态机。ERROR 保留为公开 API
+ *     triggerError() 可达的预留态，待与 `Round.error` 无真实产生路径合并评估。
+ * 生产运行时异常走 `yield { type:'error' }` 事件流（agent.ts），不翻状态机。若要让运行时异常自动翻状态机，需在 yield error 处接线 triggerError（行为变更，需产品决策）。
+ * 单实例事件队列串行处理，无并发写路径。
+ */
+import type { SessionCheckpoint, StatusTransition, SessionStatus, PauseSource } from '../agent/types.js';
+/**
+ * 会话状态机：管理三态流转确保转换合法且可追溯，实例绑定单会话由 SessionManager 持有。
+ * PauseSource 定义于 agent/types.ts（PauseMeta.source 同源共用，类型级单一真源）。
+ */
+export declare class SessionStateMachine {
+    /** 当前状态 */
+    private currentStatus;
+    /** 暂停原因（仅 PAUSED 有效） */
+    private pauseReason;
+    /** 暂停来源（仅 PAUSED 有效） */
+    private pauseSource;
+    /** 异常原因（仅 ERROR 有效） */
+    private errorCause;
+    /** 待处理暂停原因（软暂停申请，loop 边界挂起后消费；由状态机唯一持有） */
+    private pendingPauseReason?;
+    /** 待处理暂停来源（仅 pendingPauseReason 有值时有效） */
+    private pendingPauseSource;
+    /** @param initialStatus 初始状态，默认 'running' */
+    constructor(initialStatus?: SessionStatus);
+    /** 当前状态 */
+    get status(): SessionStatus;
+    /** 暂停原因/来源（仅 PAUSED 有效，否则 null） */
+    get pauseInfo(): {
+        reason: string;
+        source: PauseSource;
+    } | null;
+    /** 异常原因（仅 ERROR 有效，否则 null） */
+    get errorInfo(): string | null;
+    /** 暂停会话（用户/Agent/系统双向触发）；仅 RUNNING 可暂停 */
+    pause(reason: string, source?: PauseSource): StatusTransition;
+    /** 恢复会话；仅 PAUSED 可恢复，恢复前确认无阻塞条件（如无未完成工具调用） */
+    resume(): StatusTransition;
+    /** 触发异常；仅 RUNNING 可触发。PAUSED 不允许产生新异常，ERROR 不允许叠加（保留第一个 cause） */
+    triggerError(cause: string): StatusTransition;
+    /** 从异常恢复；仅 ERROR 可恢复，须 error.recovered===true 且 cause 已解除（外部条件由调用方恢复前确认） */
+    recover(checkpoint: SessionCheckpoint): StatusTransition;
+    /** 当前是否可暂停（仅 RUNNING） */
+    canPause(): boolean;
+    /** 当前是否可恢复（仅 PAUSED） */
+    canResume(): boolean;
+    /** 当前是否处于异常状态 */
+    isError(): boolean;
+    /** 强制重置到 running（跳过所有转换校验，用于暂停超时等强制清理；正常应走 pause/resume/triggerError/recover） */
+    resetToRunning(): void;
+    /** 「是否存在在途暂停申请」唯一判据；requestPause 与 isPausePending 共用，保证同一命题单一套判定（不因 error 态等场景出现两套判据） */
+    private hasPendingPause;
+    /** 待处理暂停信息（只读不消费）；供 close() 清理残留暂停 / 暂停收口核对原因来源时读取 */
+    get pendingPauseInfo(): {
+        reason: string;
+        source: PauseSource;
+    } | null;
+    /** 请求软暂停（仅 RUNNING）；暂存暂停数据，待 loop 边界真正挂起时 consume 消费。true=已注册，false=不接受（非 RUNNING 或已有在途申请） */
+    requestPause(reason: string, source?: PauseSource): boolean;
+    /** 消费待处理暂停请求（loop 边界真正挂起时调用）；返回并清除，与 cancelPendingPause 互斥 */
+    consumePendingPause(): {
+        reason: string;
+        source: PauseSource;
+    } | null;
+    /** 取消待处理暂停请求（用户主动取消暂停时调用）；清除 pending，与 consumePendingPause 互斥 */
+    cancelPendingPause(): void;
+    /** 是否存在在途暂停申请（状态机仍 running 且未真正挂起）；供宿主三态按钮判断 */
+    isPausePending(): boolean;
+}
+//# sourceMappingURL=sessionStateMachine.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sessionStateMachine.d.ts","sourceRoot":"","sources":["../../src/agent/sessionStateMachine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EACV,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,EACb,WAAW,EACZ,MAAM,kBAAkB,CAAC;AAE1B;;;GAGG;AACH,qBAAa,mBAAmB;IAC9B,WAAW;IACX,OAAO,CAAC,aAAa,CAAgB;IACrC,wBAAwB;IACxB,OAAO,CAAC,WAAW,CAAuB;IAC1C,wBAAwB;IACxB,OAAO,CAAC,WAAW,CAA4B;IAC/C,uBAAuB;IACvB,OAAO,CAAC,UAAU,CAAuB;IACzC,2CAA2C;IAC3C,OAAO,CAAC,kBAAkB,CAAC,CAAS;IACpC,0CAA0C;IAC1C,OAAO,CAAC,kBAAkB,CAAuB;IAEjD,6CAA6C;gBACjC,aAAa,GAAE,aAAyB;IAIpD,WAAW;IACX,IAAI,MAAM,IAAI,aAAa,CAE1B;IAED,mCAAmC;IACnC,IAAI,SAAS,IAAI;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,WAAW,CAAA;KAAE,GAAG,IAAI,CAG9D;IAED,+BAA+B;IAC/B,IAAI,SAAS,IAAI,MAAM,GAAG,IAAI,CAE7B;IAED,0CAA0C;IAC1C,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,GAAE,WAAoB,GAAG,gBAAgB;IAgBrE,8CAA8C;IAC9C,MAAM,IAAI,gBAAgB;IAgB1B,kEAAkE;IAClE,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB;IAe7C,4EAA4E;IAC5E,OAAO,CAAC,UAAU,EAAE,iBAAiB,GAAG,gBAAgB;IAoCxD,yBAAyB;IACzB,QAAQ,IAAI,OAAO;IAInB,wBAAwB;IACxB,SAAS,IAAI,OAAO;IAIpB,iBAAiB;IACjB,OAAO,IAAI,OAAO;IAIlB,iFAAiF;IACjF,cAAc,IAAI,IAAI;IAatB,yFAAyF;IACzF,OAAO,CAAC,eAAe;IAIvB,sDAAsD;IACtD,IAAI,gBAAgB,IAAI;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,WAAW,CAAA;KAAE,GAAG,IAAI,CAGrE;IAED,8FAA8F;IAC9F,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,GAAE,WAAoB,GAAG,OAAO;IAQnE,8DAA8D;IAC9D,mBAAmB,IAAI;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,WAAW,CAAA;KAAE,GAAG,IAAI;IAQrE,iEAAiE;IACjE,kBAAkB,IAAI,IAAI;IAK1B,gDAAgD;IAChD,cAAc,IAAI,OAAO;CAG1B"}

package/dist/agent/sessionStateMachine.js

@@ -0,0 +1,182 @@
+/**
+ * 会话状态机：管理三态流转确保转换合法且可追溯，实例绑定单会话由 SessionManager 持有。
+ * PauseSource 定义于 agent/types.ts（PauseMeta.source 同源共用，类型级单一真源）。
+ */
+export class SessionStateMachine {
+    /** 当前状态 */
+    currentStatus;
+    /** 暂停原因（仅 PAUSED 有效） */
+    pauseReason = null;
+    /** 暂停来源（仅 PAUSED 有效） */
+    pauseSource = null;
+    /** 异常原因（仅 ERROR 有效） */
+    errorCause = null;
+    /** 待处理暂停原因（软暂停申请，loop 边界挂起后消费；由状态机唯一持有） */
+    pendingPauseReason;
+    /** 待处理暂停来源（仅 pendingPauseReason 有值时有效） */
+    pendingPauseSource = 'user';
+    /** @param initialStatus 初始状态，默认 'running' */
+    constructor(initialStatus = 'running') {
+        this.currentStatus = initialStatus;
+    }
+    /** 当前状态 */
+    get status() {
+        return this.currentStatus;
+    }
+    /** 暂停原因/来源（仅 PAUSED 有效，否则 null） */
+    get pauseInfo() {
+        if (this.currentStatus !== 'paused')
+            return null;
+        return { reason: this.pauseReason, source: this.pauseSource };
+    }
+    /** 异常原因（仅 ERROR 有效，否则 null） */
+    get errorInfo() {
+        return this.currentStatus === 'error' ? this.errorCause : null;
+    }
+    /** 暂停会话（用户/Agent/系统双向触发）；仅 RUNNING 可暂停 */
+    pause(reason, source = 'user') {
+        const from = this.currentStatus;
+        if (from !== 'running') {
+            return {
+                from,
+                to: 'paused',
+                reason: `无法暂停：当前状态为 ${from}，仅 RUNNING 状态可暂停`,
+                allowed: false,
+            };
+        }
+        this.currentStatus = 'paused';
+        this.pauseReason = reason;
+        this.pauseSource = source;
+        return { from: 'running', to: 'paused', reason: `${source} 暂停：${reason}`, allowed: true };
+    }
+    /** 恢复会话；仅 PAUSED 可恢复，恢复前确认无阻塞条件（如无未完成工具调用） */
+    resume() {
+        const from = this.currentStatus;
+        if (from !== 'paused') {
+            return {
+                from,
+                to: 'running',
+                reason: `无法恢复：当前状态为 ${from}，仅 PAUSED 状态可恢复`,
+                allowed: false,
+            };
+        }
+        this.currentStatus = 'running';
+        this.pauseReason = null;
+        this.pauseSource = null;
+        return { from: 'paused', to: 'running', reason: '恢复会话', allowed: true };
+    }
+    /** 触发异常；仅 RUNNING 可触发。PAUSED 不允许产生新异常，ERROR 不允许叠加（保留第一个 cause） */
+    triggerError(cause) {
+        const from = this.currentStatus;
+        if (from !== 'running') {
+            return {
+                from,
+                to: 'error',
+                reason: `无法触发异常：当前状态为 ${from}，仅 RUNNING 状态可触发异常`,
+                allowed: false,
+            };
+        }
+        this.currentStatus = 'error';
+        this.errorCause = cause;
+        return { from: 'running', to: 'error', reason: `异常：${cause}`, allowed: true };
+    }
+    /** 从异常恢复；仅 ERROR 可恢复，须 error.recovered===true 且 cause 已解除（外部条件由调用方恢复前确认） */
+    recover(checkpoint) {
+        const from = this.currentStatus;
+        if (from !== 'error') {
+            return {
+                from,
+                to: 'running',
+                reason: `无法恢复：当前状态为 ${from}，仅 ERROR 状态可恢复`,
+                allowed: false,
+            };
+        }
+        if (!checkpoint.error?.recovered) {
+            return {
+                from: 'error',
+                to: 'running',
+                reason: `无法恢复：异常尚未标记为已恢复（error.recovered !== true），异常原因：${checkpoint.error?.cause ?? '未知'}`,
+                allowed: false,
+            };
+        }
+        if (!checkpoint.error.cause) {
+            return {
+                from: 'error',
+                to: 'running',
+                reason: '无法恢复：异常原因缺失，无法确认 cause 已解除',
+                allowed: false,
+            };
+        }
+        this.currentStatus = 'running';
+        this.errorCause = null;
+        return {
+            from: 'error',
+            to: 'running',
+            reason: `恢复完成：异常原因 "${checkpoint.error.cause}" 已解除`,
+            allowed: true,
+        };
+    }
+    /** 当前是否可暂停（仅 RUNNING） */
+    canPause() {
+        return this.currentStatus === 'running';
+    }
+    /** 当前是否可恢复（仅 PAUSED） */
+    canResume() {
+        return this.currentStatus === 'paused';
+    }
+    /** 当前是否处于异常状态 */
+    isError() {
+        return this.currentStatus === 'error';
+    }
+    /** 强制重置到 running（跳过所有转换校验，用于暂停超时等强制清理；正常应走 pause/resume/triggerError/recover） */
+    resetToRunning() {
+        this.currentStatus = 'running';
+        this.pauseReason = null;
+        this.pauseSource = null;
+        this.errorCause = null;
+        // 强制重置同时清在途暂停申请：残留会让 hasPendingPause() 恒 true、requestPause 幂等检查
+        // 永久拒绝后续暂停（暂停按钮全失效）。清理由本方法收口，调用方无需再配对 cancelPendingPause。
+        this.pendingPauseReason = undefined;
+        this.pendingPauseSource = 'user';
+    }
+    // ─── pending 暂停请求管理（SSOT 收口） ────────────────
+    /** 「是否存在在途暂停申请」唯一判据；requestPause 与 isPausePending 共用，保证同一命题单一套判定（不因 error 态等场景出现两套判据） */
+    hasPendingPause() {
+        return this.pendingPauseReason !== undefined;
+    }
+    /** 待处理暂停信息（只读不消费）；供 close() 清理残留暂停 / 暂停收口核对原因来源时读取 */
+    get pendingPauseInfo() {
+        if (this.pendingPauseReason === undefined)
+            return null;
+        return { reason: this.pendingPauseReason, source: this.pendingPauseSource };
+    }
+    /** 请求软暂停（仅 RUNNING）；暂存暂停数据，待 loop 边界真正挂起时 consume 消费。true=已注册，false=不接受（非 RUNNING 或已有在途申请） */
+    requestPause(reason, source = 'user') {
+        if (this.currentStatus !== 'running')
+            return false;
+        if (this.hasPendingPause())
+            return false; // 幂等：已有在途申请
+        this.pendingPauseReason = reason;
+        this.pendingPauseSource = source;
+        return true;
+    }
+    /** 消费待处理暂停请求（loop 边界真正挂起时调用）；返回并清除，与 cancelPendingPause 互斥 */
+    consumePendingPause() {
+        if (this.pendingPauseReason === undefined)
+            return null;
+        const result = { reason: this.pendingPauseReason, source: this.pendingPauseSource };
+        this.pendingPauseReason = undefined;
+        this.pendingPauseSource = 'user';
+        return result;
+    }
+    /** 取消待处理暂停请求（用户主动取消暂停时调用）；清除 pending，与 consumePendingPause 互斥 */
+    cancelPendingPause() {
+        this.pendingPauseReason = undefined;
+        this.pendingPauseSource = 'user';
+    }
+    /** 是否存在在途暂停申请（状态机仍 running 且未真正挂起）；供宿主三态按钮判断 */
+    isPausePending() {
+        return this.hasPendingPause() && this.currentStatus !== 'paused';
+    }
+}
+//# sourceMappingURL=sessionStateMachine.js.map

package/dist/agent/sessionStateMachine.js.map

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

package/dist/agent/taskTableRenderer.d.ts

@@ -0,0 +1,51 @@
+/**
+ * 任务表渲染器（渲染函数）
+ *
+ * 纯函数，将计划任务项列表和任务项推进日志渲染为 LLM 可读的格式化文本。
+ * 输出标「以下为状态/历史信息，非当前指令」防 LLM 误执行。
+ *
+ * 排版：无装饰列表。本函数唯一读者是 LLM（装配点 assembler.ts 注入上下文；宿主零消费、
+ * 不解析本文本）；ASCII 方框类装饰字符对 LLM 零语义价值却占近半 tokens，且硬编码列宽
+ * 在 CJK 描述下从不齐——无装饰列表省 token 且根除对齐缺陷（无需列宽计算）。
+ *
+ * 契约（不可变）：首行恒为 `[任务进度: ...]` —— loop 替换式注入靠该前缀移除上一份任务表
+ * （见 loop.ts「特征前缀 [任务进度:」），任何在其前加内容的改动都会让上下文堆积多份任务表。
+ *
+ * @module taskTableRenderer
+ */
+import type { PlanItem, PlanItemOutcome } from './types.js';
+/**
+ * 任务项描述最大字符数（超出截断为「前 PLAN_ITEM_DESC_MAX_CHARS-3 字符 + '...'」）。
+ * 作用 = 防超长描述撑爆上下文；与渲染列宽无关，勿据列宽回改。
+ */
+export declare const PLAN_ITEM_DESC_MAX_CHARS = 38;
+/**
+ * 渲染任务表（含进度行）
+ *
+ * 渲染为无装饰列表，供注入 LLM 上下文（格式抉择与「为什么没有方框」见模块头）。
+ * 输出以「非当前指令」标记开头，防止 LLM 将状态信息误认为指令。
+ *
+ * @param plan - 计划任务项列表
+ * @param planItemLog - 可选任务项推进日志（截断不在本函数：真源见 SessionManager.appendPlanItemLog
+ *   的「每任务项上限 3 条」（completePlanItem / logPlanItemBoundary 共用，按 planItemId
+ *   截断而非全局 FIFO）
+ * @returns 格式化后的任务表文本（空计划返回空字符串）
+ */
+export declare function renderTaskTable(plan: PlanItem[], planItemLog?: PlanItemOutcome[]): string;
+/**
+ * 收尾验证提示（Claude Code TodoWrite nudge 同款）
+ *
+ * LLM 把任务表全部任务项标记 done（宣称任务完成）但列表里没有任何执行性验证任务项时，
+ * 返回一段提示文案引导它补一个验证任务项（task_table_write append），再收尾。
+ *
+ * 触发条件全部确定性：① 计划 ≥3 个任务项（太短不值得打断）；② 全部 done（刚被宣称完成）；
+ * ③ 无执行性验证任务项。命中返回提示文本，否则返回 null（零打扰）。
+ *
+ * 挂载点：task_table_update 把最后一个任务项标 done 的成功路径（assembler.updatePlanItem 回调），
+ * 作为工具结果附文返回——LLM 必读工具结果，nudge 有生效窗口（它可 append 验证任务项再执行）。
+ *
+ * @param plan 更新后的计划任务项列表
+ * @returns 命中返回提示文案（含换行前导，便于追加到工具结果）；未命中返回 null
+ */
+export declare function buildCompletionVerifyNudge(plan: PlanItem[]): string | null;
+//# sourceMappingURL=taskTableRenderer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"taskTableRenderer.d.ts","sourceRoot":"","sources":["../../src/agent/taskTableRenderer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE5D;;;GAGG;AACH,eAAO,MAAM,wBAAwB,KAAK,CAAC;AAE3C;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE,WAAW,CAAC,EAAE,eAAe,EAAE,GAAG,MAAM,CAqCzF;AA2BD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,QAAQ,EAAE,GAAG,MAAM,GAAG,IAAI,CAS1E"}