@lemoncat7/dsh-partner 1.13.0 → 1.14.1

package/README.md

@@ -197,8 +197,8 @@
 - 伙伴从记忆提炼或每日终审中自动新建关注后，会在当前伙伴会话中发出一次创建通知，并同步到对应的微信渠道，方便及时检查或移除
 - 心跳只查询到期挂念，使用独立内存推理作用域观察上次检查后的变化；无到期事项时不会调用模型
 - 心跳根据挂念选择当前可用的安全来源，并在来源内部逐层缩小范围：知识库按“找库→库内搜索→读取条目”，本地按“确定范围→定位文件/内容→读取证据”；发现阶段有独立软截止、单工具超时和整轮安全上限
-- 知识文档明确指定本地核验命令时，心跳可使用作用域内临时注册的受控只读命令工具；它不经过 shell，只接受版本、npm 包版本和少量 Git 状态查询，禁止管道、重定向、脚本、任意程序与任意参数，并记录命令结果或拒绝原因
-- 挂念明确关联 `@文件` 时，伙伴可先读取再以最小修改持续维护该文件；写权限精确限定到已关联的现存文件，不能创建其他文件或触碰伙伴私有存储
+- 关注可使用来源会话已有的 bash 工具完成文档要求的多步检查，保留 DSH 原有审批，不另行实现命令执行或自动授权。
+- `@文件` 仅作为只读依据；记录写权限只覆盖用户在“需要记录的地方”手动选择的现存文件或笔记，不能创建其他文件或触碰伙伴私有存储
 - 发现结果先保存为 Observation，经过去重、相关性、新鲜度、可行动性和近期打扰历史的确定性评分，再决定静默记下、下次顺手一提、进入伙伴动态或主动通知
 - 心跳硬性排除伙伴记忆、挂念数据库、会话归档及其备份，不向无关主题扩散
 - 未送达的重要提醒会保留并安全补发；普通对话开始时只召回与当前消息相关的延迟提及
@@ -324,3 +324,11 @@ ClawHub、LoopHub、SkillHub 是内置公共来源，默认启用且不能删除
 `skillUrl` 可相对索引 URL。市场索引上限 1 MiB、单个 `SKILL.md` 上限 512 KiB；未标记为可信的市场即使声明 `context: inline`，安装后也会强制改为 `fork`。
 
 市场页面的“代理设置”接受不含账号、密码和路径的 `http://host:port`。配置仅保存在当前客户端的伙伴状态中，同时作用于市场索引、Markdown Skill 和 ZIP 安装包下载；测试连接不会先写入配置。需要鉴权的代理应在本地网关侧处理，不要把凭据写进代理 URL。
+
+## 关注依据与记录位置
+
+关注使用后台轻量模型循环，不创建临时 Agent 或向聊天写入过程消息。每条关注独立执行，最多 12 轮工具交互和一轮无工具收尾，不再共用整批总时限或工具调用次数。单次模型请求最多 180 秒，单次工具最多 60 秒（工具自身可有更短限制），收尾有独立请求时间。每条完成立即保存；失败只保留未完成关注等待重试。只提供关联依据与记录目标，按文档完成代理、登录和查询；工具走来源作用域的 DSH 执行和审批，不自动批准。输出截断需按需分页。依据只读，结果仅写指定目标；检查受阻不能当作无变化。工具审计不复制参数正文。任意命令的文件隔离仍依赖 DSH 沙箱，工具名限制不等同文件系统隔离。
+
+“交代一件事”中的 @文件或 @知识文档是只读检查依据；“需要记录的地方”另选现存本地文件或可编辑笔记。没有记录位置时不写文档，旧关注不自动把依据迁移成输出位置。有依据按依据整理，没有依据自主记录核实的现状和进展；笔记使用稳定 ID 绑定，知识库插件需提供 `dshKnowledgeNoteRecording` 宿主接口。心跳的笔记工具只接收 concernId，不允许模型选择其他笔记 ID；本地文件写权限只覆盖用户选择的现存文件。该入口不包含创建、删除、移动或重命名记录目标。首次可初始化已核实现状，后续避免重复追加，写入与通知判断相互独立。
+
+完整核验结果通过 `heartbeat_record_checkpoint` 持久暂存，后台独立同步到记录目标。失败15分钟后仅重试同步，不重新抓取或提醒；实际写入成功才清除任务。详见 [1.14.0 发布说明](docs/releases/1.14.0.md)。

package/docs/architecture.md

@@ -295,3 +295,6 @@ form and save feedback, using the shared companion draft and existing UI tokens.
 - `api/features/pendant-api.ts` 沿用原有 API 同源和写操作校验，只提供固定渲染资源、消息查询和批量已读。前端可见时每 4 秒条件查询（ETag）；无变化不传正文，失败退避至 30 秒，隐藏或卸载时取消请求。
 - 验证：`test/pendant-inbox.test.mjs`、`test/pendant-physics.test.mjs`；构建后设置 `PARTNER_PLAYWRIGHT_MODULE` 并运行 `node scripts/verify-pendant.mjs`，使用隔离假数据检查 WebGL、真实拖拽、拉住停顿后的回弹与反向振荡、休眠、键盘、通知导航、移动端和清理。可设置 `PARTNER_PENDANT_VIDEO_DIR` 保存连续交互录像。
 - 卡面验证：`test/pendant-motion-glare.test.mjs` 覆盖角度往返、固定姿态十秒不漂移、四元数等价、强度边界、减少动态效果和背面关闭；`test/pendant-surface.test.mjs` 覆盖共享 uniform 与背面不变。`scripts/verify-pendant-gloss.mjs` 检查 162 组原色误差、渐变参考对照、不同倾角的光带位移与对比度保护及无额外绘制。浏览器测试覆盖 hover 不改变反光、拖拽改变角度时更新、握持静止高光不循环并正常休眠。
+## 轻量关注执行
+
+`observation-loop.ts` 维护私有消息缓冲，继承来源工具作用域，不启动 Agent turn 或新会话。按需暴露检查工具和指定记录工具，保留 DSH guard/审批。`heartbeat.ts` 逐条调用并立即持久化结果，单条失败不终止后续关注。每条独享 12 轮检查和一轮无工具收尾；模型请求 180 秒、工具执行 60 秒分别计时，无整批总时限和共享调用次数限制。重试退避从执行结束计算，已完成关注按自身 nextCheckAt 调度。结束必须给出 completed/blocked，失败不写成无变化。来源知识挂载沿用原 session，无需临时知识映射。记录内容不回写依据。

package/docs/releases/1.14.0.md

@@ -0,0 +1,24 @@
+# 1.14.0
+
+## 持续关注与记录
+
+- 轻量后台检查继承来源会话权限，不创建临时 Agent 对话；检查与无工具收尾分阶段计时，保留逐轮耗时及脱敏诊断。
+- 核验结果可通过检查点持久保存，记录同步单独执行。同步失败15分钟后重试，不重新调查来源或发送变化通知。
+- 只写用户手动指定的现存笔记或文件，不通过知识文档引用推导写入目标。同步先读再合并，笔记使用版本校验；更换目标取消旧目标的待同步数据。
+- 支持编辑关注说明、依据和记录位置，查看归档配置及确认删除。删除关注不删除关联文档。
+- 手动检查异步返回，界面查询执行状态，避免长请求等待。
+
+## 记忆与稳定性
+
+- 同一联系人任务连续失败3次后，退避期间允许后续任务整理；失败任务仍保留并重试。
+- 旧轮次补处理不覆盖较新的同主题记忆或日摘要。
+- 展示完整积压数量、上次失败原因；模型错误保留脱敏错误码与HTTP状态。
+- 会话恢复仅在确认持久化会话不存在时回退创建，避免重复会话错误。
+
+## 升级说明
+
+保留现有配置和数据，SQLite字段增量迁移。升级前建议备份伙伴数据。
+旧轮次若没有完整结果快照，不能仅凭变化摘要补建文档，需重新核验。
+同步写入仍需要有效权限和模型正常返回；外部写入与本地队列不是跨系统原子事务，不承诺严格一次执行。
+
+验证：341项自动化测试通过；部署已确认独立笔记同步成功。

package/docs/releases/1.14.1.md

@@ -0,0 +1,11 @@
+# 1.14.1
+
+正式版，适配 DSH **0.1.2-rc.1**；需要 Node.js 22.19+ 或 24+。
+
+- 心跳逐条执行关注，每条独享 12 轮检查与一轮无工具收尾，移除整批 180 秒总时限和共享 24 次工具调用额度。
+- 单次模型请求限时 180 秒，单次工具限时 60 秒；工具自身可设置更短时限，原有权限与审批保留。
+- 每条完成立即保存，单条失败不阻止后续关注；重试仅检查仍到期的关注，已保存通知支持补发。
+- 重试退避从执行结束计算，避免长检查结束后立即再次触发。
+- 更新诊断与架构说明；不修改界面、用户配置或知识内容。
+
+验证：342 项自动化测试通过。保留现有数据，无新增迁移。

package/lib/agent-runtime.d.ts

@@ -40,6 +40,18 @@ export interface HeartbeatToolTrace {
     status: 'completed' | 'failed';
 }
 export interface HeartbeatExecution {
+    recording?: Array<{
+        concernId: string;
+        state: 'synced' | 'pending';
+    }>;
+    rounds?: Array<{
+        round: number;
+        phase: 'check' | 'final';
+        modelMs: number;
+        outputChars: number;
+    }>;
+    blocked?: string[];
+    blockedReasons?: Record<string, string>;
     concerns: PartnerConcern[];
     candidates: ConcernObservationCandidate[];
     observations?: ConcernObservation[];
@@ -73,6 +85,7 @@ export declare class PartnerAgentRuntime {
     private readonly preparedTurns;
     private readonly observationJobs;
     private readonly agentSetupJobs;
+    private readonly sessionRecoveryJobs;
     private closed;
     private questionAnswerer;
     constructor(ctx: RuntimeContext, store: PartnerStore, defaultCwd: string, memory?: PartnerMemoryStore | undefined, reflection?: MemoryReflectionService | undefined, concerns?: PartnerConcernStore | undefined, composer?: PartnerAgentComposer | undefined);
@@ -99,14 +112,22 @@ export declare class PartnerAgentRuntime {
     isArchived(route: ChannelSession): boolean;
     renewSession(routeId: string): Promise<ChannelSession>;
     heartbeat(companion: Companion, route: ChannelSession, concerns: PartnerConcern[]): Promise<HeartbeatExecution>;
-    persistKnowledgeObservations(companion: Companion, route: ChannelSession, concerns: PartnerConcern[], observations: ConcernObservation[]): Promise<void>;
     concernSources(companion: Companion, query?: string): Promise<ConcernSource[]>;
+    recordingSources(companion: Companion, query?: string): Promise<({
+        kind: "file";
+        locator: string;
+        label: string;
+    } | {
+        kind: "note";
+        locator: string;
+        label: string;
+    })[]>;
+    validateRecordingTarget(companion: Companion, raw: unknown): Promise<PartnerConcern['recordTarget']>;
     private runHeartbeatWhenIdle;
     observeSessionEvent(session: Session, event: SessionEvent): Promise<void>;
     private processSessionEvent;
     recordConcernCreatedNotice(companion: Companion, scopeId: string, concerns: PartnerConcern[]): Promise<boolean>;
     private driveScopedHeartbeat;
-    private driveEphemeralHeartbeat;
     recordHeartbeatActivity(companion: Companion, route: ChannelSession, execution: HeartbeatExecution, outcome: HeartbeatOutcome, deliveryError?: string): Promise<void>;
     resetCompanion(companionId: string): Promise<void>;
     removeCompanionWorkspace(companionId: string): Promise<void>;

package/lib/agent-runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-runtime.d.ts","sourceRoot":"","sources":["../src/agent-runtime.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"agent-runtime.d.ts","sourceRoot":"","sources":["../src/agent-runtime.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,KAAK,EAAE,KAAK,EAAe,MAAM,wBAAwB,CAAA;AAChE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAA;AACnF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAA;AAIlE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAA;AACzD,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AACrE,OAAO,KAAK,EAAa,iBAAiB,EAAE,MAAM,4BAA4B,CAAA;AAC9E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AAEzD,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAKzC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAC3D,OAAO,KAAK,EAAE,uBAAuB,EAA2C,MAAM,oBAAoB,CAAA;AAC1G,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAA;AAErE,OAAO,EAA8B,KAAK,kBAAkB,EAAE,KAAK,2BAA2B,EAAE,KAAK,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAChJ,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAElD,OAAO,KAAK,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAE/E,OAAO,EAA0B,KAAK,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAOjF,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAA;AACzE,OAAO,EAAE,kBAAkB,EAAE,0BAA0B,IAAI,mBAAmB,EAAE,MAAM,8BAA8B,CAAA;AAEpH,KAAK,cAAc,GAAG,OAAO,GAAG;IAC9B,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAA;IACzB,iBAAiB,EAAE,uBAAuB,CAAA;IAC1C,YAAY,EAAE,YAAY,CAAA;IAC1B,iBAAiB,EAAE,iBAAiB,CAAA;IACpC,KAAK,EAAE,WAAW,CAAA;CACnB,CAAA;AASD,MAAM,WAAW,oBAAoB;IACnC,OAAO,CAAC,GAAG,EAAE,OAAO,GAAG;QAAE,KAAK,EAAE,WAAW,CAAA;KAAE,EAAE,SAAS,EAAE,SAAS,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC,CAAA;CACzG;AAED,MAAM,MAAM,uBAAuB,GAAG,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,cAAc,KAAK,MAAM,IAAI,CAAA;AAgBzF,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,WAAW,GAAG,QAAQ,CAAA;CAC/B;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,CAAC,EAAE,KAAK,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,QAAQ,GAAG,SAAS,CAAA;KAAC,CAAC,CAAA;IACnE,MAAM,CAAC,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAC,CAAC,CAAA;IAC/F,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACvC,QAAQ,EAAE,cAAc,EAAE,CAAA;IAC1B,UAAU,EAAE,2BAA2B,EAAE,CAAA;IACzC,YAAY,CAAC,EAAE,kBAAkB,EAAE,CAAA;IACnC,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,kBAAkB,EAAE,CAAA;CAC5B;AAED,MAAM,MAAM,gBAAgB,GAAG,UAAU,GAAG,OAAO,GAAG,QAAQ,CAAA;AAE9D,qBAAa,mBAAmB;IAqB5B,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;IACxB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC;IAC5B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;IA1B5B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiC;IACzD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmC;IAC1D,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAiD;IACjF,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAmC;IAC9D,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAmC;IAClE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAwC;IACnE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA4B;IAC5D,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAA6E;IAClH,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAAmC;IAC3E,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAY;IACjD,OAAO,CAAC,QAAQ,CAAC,4BAA4B,CAAY;IACzD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA2B;IAC1D,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA+B;IAC7D,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA4B;IAC5D,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA4B;IAC3D,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAmC;IACvE,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,gBAAgB,CAAqC;gBAG1C,GAAG,EAAE,cAAc,EACnB,KAAK,EAAE,YAAY,EACnB,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,kBAAkB,YAAA,EAC3B,UAAU,CAAC,EAAE,uBAAuB,YAAA,EACpC,QAAQ,CAAC,EAAE,mBAAmB,YAAA,EAC9B,QAAQ,CAAC,EAAE,oBAAoB,YAAA;IAmBlD,mBAAmB,CAAC,QAAQ,EAAE,uBAAuB,GAAG,IAAI;IAItD,KAAK,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,YAAY,CAAC;IASrH,KAAK,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,OAAO,CAAC;YASxG,eAAe;IAyBvB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IASxD,wBAAwB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IA2BtE,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAQhE,kBAAkB,CAAC,IAAI,EAAE,SAAS,EAAE,cAAc,EAAE,SAAS,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAwCvF,WAAW,CAAC,KAAK,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,SAAS,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,eAAe,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,GAAG,EAAE;YAAE,EAAE,EAAE,MAAM,CAAA;SAAE,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAuCtL,UAAU,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO;IAIpC,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IActD,SAAS,CAAC,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAS/G,cAAc,CAAC,SAAS,EAAE,SAAS,EAAE,KAAK,SAAK,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAqB1E,gBAAgB,CAAC,SAAS,EAAE,SAAS,EAAE,KAAK,SAAK;;;;;;;;;IAQjD,uBAAuB,CAAC,SAAS,EAAE,SAAS,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,cAAc,CAAC,cAAc,CAAC,CAAC;YAS5F,oBAAoB;IAa5B,mBAAmB,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;YAUjE,mBAAmB;IAuC3B,0BAA0B,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC;YAevG,oBAAoB;IAK5B,uBAAuB,CAC3B,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,cAAc,EACrB,SAAS,EAAE,kBAAkB,EAC7B,OAAO,EAAE,gBAAgB,EACzB,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,IAAI,CAAC;IAcV,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKlD,wBAAwB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOlE,OAAO,CAAC,oBAAoB;IAUtB,0BAA0B,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI9D,wBAAwB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5D,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMzD,kFAAkF;IAC5E,gBAAgB,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBtF,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;YAK/B,gBAAgB;IAWxB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAY9C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAiBd,0BAA0B;YAQ1B,KAAK;YAgCL,cAAc;YAwBd,aAAa;YAqBb,WAAW;YAQX,gBAAgB;YAkDhB,oBAAoB;IAuClC,OAAO,CAAC,mBAAmB;YAWb,aAAa;CAS5B;AAUD,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,SAAS,cAAc,EAAE,EACjC,gBAAgB,EAAE,MAAM,GAAG,SAAS,EACpC,QAAQ,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,OAAO,GAC3C,cAAc,GAAG,SAAS,CAM5B;AAMD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,EAAE,GAAG,EAAE,OAAO,CAAC,YAAY,EAAE;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,CAAC,GAAG,SAAS,YAAY,EAAE,CAY9I;AAED,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAAoC;AAW1G,wBAAgB,YAAY,CAAC,OAAO,EAAE,WAAW,CAAC,OAAO,CAAC,UAAU,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,WAAW,GAAE,uBAAuB,EAAO,EAAE,MAAM,GAAE,OAAO,uBAAuB,EAAE,SAAS,EAAO,EAAE,OAAO,GAAE,OAAO,oBAAoB,EAAE,mBAAmB,CAAC,SAAS,CAAM,GAAG,MAAM,CAkB9R;AA0BD,wBAAgB,eAAe,CAAC,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,EAAE,kBAAkB,EAAE,SAAS,SAAS,EAAE,GAAG,OAAO,CAE7H;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,cAAc,EAAE,GAAG,SAAa,GAAG,cAAc,CAOzF;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAEpE;AAED,UAAU,mBAAmB;IAC3B,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;CACrB;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,cAAc,EAAE,EAAE,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,mBAAmB,CAMhH;AAED,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,2BAA2B,EAAE,CA8B5G;AAMD,UAAU,mBAAmB;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;CACtB;AAoBD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,mBAAmB,GAAG,MAAM,GAAG,SAAS,CAgB3H;AAoBD,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,kBAAkB,EAC7B,OAAO,EAAE,gBAAgB,EACzB,aAAa,CAAC,EAAE,MAAM,GACrB,MAAM,CA2BR"}

package/lib/agent-runtime.js

@@ -1,33 +1,23 @@
 import { createHash, randomUUID } from 'node:crypto';
 import { mkdir, realpath, stat, writeFile } from 'node:fs/promises';
 import { isAbsolute, join, relative, resolve, sep } from 'node:path';
-import { BlockAssembler, createToolResultMessage, createUserMessage } from '@deepseek-ai/dsh-llm';
-import { createScope, scopeOf, scopeParentOf } from '@deepseek-ai/dsh-scope';
+import { createUserMessage } from '@deepseek-ai/dsh-llm';
+import { scopeOf, scopeParentOf } from '@deepseek-ai/dsh-scope';
 import { SessionConfigurationIndex } from './companions/session-configuration.js';
+import { isMissingSession, SessionRecoveryJobs } from './companions/session-recovery.js';
 import { removeOwnedWorkspace } from './companions/workspace-cleanup.js';
 import { assertOwnedDirectory, removeOwnedDirectory } from './companions/directory-cleanup.js';
-import { concernObservationPrompt } from './autonomy.js';
 import { boundedConcernCheckMinutes } from './concern-domain.js';
 import { taskWorkContext } from './tasks/context.js';
 import { PARTNER_MEDIA_MAX_BYTES, safeMediaName } from './channel-message.js';
 import { listConcernFileSources } from './concern-sources.js';
 import { CONCERN_CREATED_NOTICE, renderConcernCreatedNotice } from './concern-notification.js';
-import { HEARTBEAT_LOCAL_COMMAND, heartbeatLocalCommandTool } from './heartbeat-command.js';
+import { executeObservationLoop } from './observation-loop.js';
 import { assistantTextAfter, renderPartnerPersona, renderToolProtocol, resolvePartnerAgentOptions as resolveAgentOptions } from './execution/agent-support.js';
 import { channelReplyPartsAfter } from './channels/delivery-policy.js';
 import { prepareChannelReply } from './channels/outbound-media.js';
 export { extractOutboundAttachments } from './channels/outbound-media.js';
 export { renderToolProtocol, resolvePartnerAgentOptions as resolveAgentOptions } from './execution/agent-support.js';
-const HEARTBEAT_TIMEOUT_MS = 115_000;
-const HEARTBEAT_DISCOVERY_BUDGET_MS = 72_000;
-const HEARTBEAT_TOOL_TIMEOUT_MS = 18_000;
-const HEARTBEAT_WEB_TOOL_TIMEOUT_MS = 30_000;
-const HEARTBEAT_TOOL_RESULT_LIMIT = 5_000;
-const HEARTBEAT_KNOWLEDGE_RESULT_LIMIT = 8_000;
-const HEARTBEAT_WEB_FETCH_RESULT_LIMIT = 40_000;
-const HEARTBEAT_WEB_SOURCE_RESULT_LIMIT = 125_000;
-const HEARTBEAT_AUDIT_INPUT_LIMIT = 320;
-const HEARTBEAT_AUDIT_OUTPUT_LIMIT = 520;
 const PARTNER_TASK_TIMEOUT_MS = 30 * 60_000;
 const HEARTBEAT_READ_ONLY_TOOLS = new Set([
     'knowledge_base_search',
@@ -41,8 +31,6 @@ const HEARTBEAT_READ_ONLY_TOOLS = new Set([
     'read',
 ]);
 const HEARTBEAT_FILE_UPDATE_TOOLS = new Set(['write', 'edit', 'str_replace_editor']);
-const HEARTBEAT_TOOLS = new Set([...HEARTBEAT_READ_ONLY_TOOLS, ...HEARTBEAT_FILE_UPDATE_TOOLS]);
-HEARTBEAT_TOOLS.add(HEARTBEAT_LOCAL_COMMAND);
 export class PartnerAgentRuntime {
     ctx;
     store;
@@ -66,6 +54,7 @@ export class PartnerAgentRuntime {
     preparedTurns = new WeakMap();
     observationJobs = new Map();
     agentSetupJobs = new Map();
+    sessionRecoveryJobs = new SessionRecoveryJobs();
     closed = false;
     questionAnswerer;
     constructor(ctx, store, defaultCwd, memory, reflection, concerns, composer) {
@@ -328,44 +317,6 @@ export class PartnerAgentRuntime {
                 this.heartbeatQueues.delete(key);
         }
     }
-    async persistKnowledgeObservations(companion, route, concerns, observations) {
-        const service = this.ctx.get('dshKnowledgeTracking');
-        if (service === undefined || observations.length === 0)
-            return;
-        const agent = await this.ensureAgent(companion, route);
-        const byId = new Map(concerns.map(item => [item.id, item]));
-        const controller = new AbortController();
-        const timeout = setTimeout(() => controller.abort(new Error('知识库观察记录超时')), 30_000);
-        timeout.unref?.();
-        try {
-            for (const observation of observations) {
-                if (observation.decision === 'drop')
-                    continue;
-                const concern = byId.get(observation.concernId);
-                if (concern === undefined)
-                    continue;
-                const references = concern.resources.filter(item => item.kind === 'knowledge').map(item => item.locator).slice(0, 4);
-                if (references.length === 0 && concern.watchKind !== 'knowledge')
-                    continue;
-                for (const reference of references.length > 0 ? references : [undefined]) {
-                    await service.record(agent, {
-                        id: observation.id,
-                        subject: concern.subject,
-                        event: observation.event,
-                        evidence: observation.evidence,
-                        source: observation.source,
-                        ...(reference === undefined ? {} : { reference }),
-                        at: observation.createdAt,
-                    }, controller.signal).catch(error => {
-                        this.ctx.logger.warn(`dsh-partner: knowledge observation fell back to local storage: ${errorMessage(error)}`);
-                    });
-                }
-            }
-        }
-        finally {
-            clearTimeout(timeout);
-        }
-    }
     async concernSources(companion, query = '') {
         const routes = this.store.snapshot().sessions
             .filter(item => item.companionId === companion.id)
@@ -390,6 +341,24 @@ export class PartnerAgentRuntime {
             clearTimeout(timeout);
         }
     }
+    async recordingSources(companion, query = '') {
+        const route = this.store.snapshot().sessions.filter(item => item.companionId === companion.id).sort((a, b) => b.lastMessageAt - a.lastMessageAt)[0];
+        const files = await listConcernFileSources(route?.cwd ?? partnerCwd(this.defaultCwd, companion.id), query, 24);
+        const bridge = this.ctx.get('dshKnowledgeNoteRecording');
+        const notes = bridge?.version === 1 ? await bridge.list(query, AbortSignal.timeout(8000)) : [];
+        return [...files.map(file => ({ kind: 'file', locator: file.label, label: file.label })), ...notes.map(note => ({ kind: 'note', locator: note.id, label: note.name }))];
+    }
+    async validateRecordingTarget(companion, raw) {
+        if (raw === undefined || raw === null)
+            return undefined;
+        if (!isRecord(raw) || typeof raw.locator !== 'string' || typeof raw.label !== 'string')
+            throw new Error('记录位置无效，请重新选择');
+        const choices = await this.recordingSources(companion, raw.kind === 'file' ? raw.locator : raw.label);
+        const selected = choices.find(item => item.kind === raw.kind && item.locator === raw.locator);
+        if (!selected)
+            throw new Error('记录位置已不存在或不可写，请重新选择');
+        return selected;
+    }
     async runHeartbeatWhenIdle(key, companion, route, concerns) {
         for (;;) {
             await this.queues.get(key)?.catch(() => { });
@@ -486,38 +455,9 @@ export class PartnerAgentRuntime {
         return true;
     }
     async driveScopedHeartbeat(conversation, companion, concerns) {
-        const scope = await createHeartbeatScope(this.ctx, conversation, concerns);
-        try {
-            return await this.driveEphemeralHeartbeat(scope.agent, companion, concerns);
-        }
-        finally {
-            await scope.dispose();
-        }
-    }
-    async driveEphemeralHeartbeat(agent, companion, concerns) {
-        const controller = new AbortController();
-        const timeout = setTimeout(() => controller.abort(new Error('伙伴心跳超过安全时限')), HEARTBEAT_TIMEOUT_MS);
-        timeout.unref?.();
-        try {
-            const execution = await runHeartbeatInference(this.ctx, agent, companion, concerns, controller.signal);
-            return controller.signal.aborted
-                ? { ...execution, error: '伙伴心跳超过安全时限，已收束并终止' }
-                : execution;
-        }
-        catch (error) {
-            const now = Date.now();
-            return {
-                concerns,
-                candidates: [],
-                startedAt: now,
-                completedAt: now,
-                tools: [],
-                error: controller.signal.aborted ? '伙伴心跳超过安全时限，已收束并终止' : errorMessage(error),
-            };
-        }
-        finally {
-            clearTimeout(timeout);
-        }
+        const access = await resolveHeartbeatFileAccess(conversation.session.header.cwd, concerns);
+        return executeObservationLoop({ ctx: this.ctx, conversation, companion, concerns, guard: (name, args) => heartbeatToolDenial(name, args, access), parse: parseConcernObservations, checkpoint: async (item, snapshot) => { if (!this.concerns)
+                throw new Error('关注存储不可用'); await this.concerns.checkpointRecording(item, snapshot); } });
     }
     async recordHeartbeatActivity(companion, route, execution, outcome, deliveryError) {
         const conversation = await this.ensureAgent(companion, route);
@@ -734,7 +674,7 @@ export class PartnerAgentRuntime {
         const id = companion.id;
         this.agentSetupJobs.set(id, (this.agentSetupJobs.get(id) ?? 0) + 1);
         try {
-            return await this.ensureAgentReady(companion, route);
+            return await this.sessionRecoveryJobs.run(route.sessionId, () => this.ensureAgentReady(companion, route));
         }
         finally {
             const left = (this.agentSetupJobs.get(id) ?? 1) - 1;
@@ -779,7 +719,10 @@ export class PartnerAgentRuntime {
                 setup,
             });
         }
-        catch {
+        catch (error) {
+            // Never turn a preset/loading/permission failure into a duplicate create.
+            if (!isMissingSession(error, route.sessionId))
+                throw error;
             handle = await this.ctx.agents.create({
                 sessionId: route.sessionId,
                 meta: {
@@ -960,123 +903,13 @@ export function renewedSession(previous, now = Date.now()) {
 export function partnerCwd(root, companionId) {
     return join(root, 'partners', companionId);
 }
-async function createHeartbeatScope(ctx, conversation, concerns) {
-    const parent = scopeOf(conversation.ctx);
-    if (parent === undefined)
-        throw new Error('伙伴心跳无法解析当前 Agent 作用域');
-    const availableTools = [...HEARTBEAT_TOOLS].filter(name => ctx.tools.get(name, conversation) !== undefined);
-    const policy = heartbeatToolPolicy(concerns, availableTools);
-    const allowedTools = [...policy.allowed];
-    const cwd = conversation.session.header.cwd;
-    if (!cwd)
-        throw new Error('伙伴心跳缺少当前伙伴工作目录');
-    const fileAccess = await resolveHeartbeatFileAccess(cwd, concerns);
-    const agent = {};
-    const scope = createScope(ctx, agent, { parent });
-    const agentCtx = scope.ctx.extend({ agent });
-    Object.assign(agent, {
-        id: conversation.id,
-        options: conversation.options,
-        session: conversation.session,
-        inbox: conversation.inbox,
-        status: 'idle',
-        ctx: agentCtx,
-        cancel: () => { },
-        whenIdle: async () => { },
-        runMaintenance: async (job) => job(new AbortController().signal),
-        send: () => { throw new Error('心跳作用域不接受会话消息'); },
-        followup: () => { throw new Error('心跳作用域不接受会话消息'); },
-        steer: () => { throw new Error('心跳作用域不接受会话消息'); },
-        inject: () => { throw new Error('心跳作用域不接受会话消息'); },
-    });
-    agentCtx.tools.presentAs('native');
-    agentCtx.tools.register(heartbeatLocalCommandTool(cwd));
-    if (allowedTools.length > 0)
-        agentCtx.tools.restrict({ allow: allowedTools });
-    agentCtx.tools.guard(exec => {
-        if (exec.name !== HEARTBEAT_LOCAL_COMMAND && !policy.allowed.has(exec.name))
-            return `当前挂念的来源策略不允许调用 ${exec.name}`;
-        return heartbeatToolDenial(exec.name, exec.arguments, fileAccess);
-    });
-    return { agent, dispose: () => scope.dispose() };
-}
 export function heartbeatToolPolicy(concerns, available) {
     const installed = new Set(available);
-    const hasLinkedFile = concerns.some(item => item.resources?.some(resource => resource.kind === 'file') === true);
+    const hasLinkedFile = concerns.some(item => item.recordTarget?.kind === 'file');
     return {
         allowed: new Set([...installed].filter(name => HEARTBEAT_READ_ONLY_TOOLS.has(name) || (hasLinkedFile && HEARTBEAT_FILE_UPDATE_TOOLS.has(name)))),
     };
 }
-async function runHeartbeatInference(ctx, agent, companion, concerns, signal) {
-    const startedAt = Date.now();
-    const traces = [];
-    const discoveryDeadline = startedAt + HEARTBEAT_DISCOVERY_BUDGET_MS;
-    try {
-        const selection = resolveAgentOptions(ctx.agentDefaultModel, companion);
-        if (!selection.provider || !selection.model)
-            throw new Error('伙伴心跳没有可用的模型路由');
-        const tools = ctx.tools.schemas(agent).filter(tool => HEARTBEAT_TOOLS.has(tool.name));
-        if (tools.length === 0)
-            throw new Error('伙伴心跳没有可用的只读发现工具');
-        const messages = [createUserMessage({
-                content: [{ type: 'text', text: concernObservationPrompt(concerns, agent.session.header.cwd) }],
-                source: { kind: 'plugin', plugin: '@lemoncat7/dsh-partner', form: 'notice', summary: '伙伴观察挂念变化' },
-            })];
-        for (;;) {
-            const discoveryOpen = Date.now() < discoveryDeadline;
-            const prepared = await ctx.llm.prepareCall(selection, signal);
-            const assembler = new BlockAssembler();
-            for await (const chunk of prepared.stream({
-                ...prepared.config,
-                messages,
-                system: renderPartnerPersona(companion, 'heartbeat'),
-                tools: discoveryOpen ? tools : [],
-                signal,
-            }))
-                assembler.push(chunk);
-            const finish = assembler.finish;
-            if (finish.kind === 'error' || finish.kind === 'aborted') {
-                throw new Error(`伙伴心跳模型调用失败：${finish.failure.message}`);
-            }
-            const response = assembler.message({ kind: 'model', provider: prepared.config.provider, model: prepared.config.model });
-            messages.push(response);
-            const pending = response.content.filter((block) => block.type === 'tool-call');
-            if (pending.length === 0) {
-                const output = textContent(response.content);
-                return {
-                    concerns,
-                    candidates: parseConcernObservations(output, new Set(concerns.map(item => item.id))),
-                    startedAt,
-                    completedAt: Date.now(),
-                    output,
-                    tools: traces,
-                };
-            }
-            for (const call of pending) {
-                const argumentsValue = boundHeartbeatToolArguments(call.name, parseHeartbeatToolArguments(call));
-                const toolStartedAt = Date.now();
-                const remainingDiscoveryMs = discoveryDeadline - toolStartedAt;
-                const result = remainingDiscoveryMs <= 0
-                    ? { isError: true, content: [{ type: 'text', text: '本轮发现阶段的时间预算已用完，请根据已有结果立即输出最终 Observation JSON。' }] }
-                    : await executeHeartbeatTool(ctx, agent, call, argumentsValue, signal, remainingDiscoveryMs);
-                const toolCompletedAt = Date.now();
-                const visibleContent = heartbeatToolContent(call.name, result.content);
-                traces.push({
-                    name: call.name,
-                    input: auditValue(argumentsValue, HEARTBEAT_AUDIT_INPUT_LIMIT),
-                    output: auditText(textContent(visibleContent) || '工具返回了非文本结果', HEARTBEAT_AUDIT_OUTPUT_LIMIT),
-                    startedAt: toolStartedAt,
-                    completedAt: toolCompletedAt,
-                    status: result.isError ? 'failed' : 'completed',
-                });
-                messages.push(createToolResultMessage({ callId: call.id, content: visibleContent, isError: result.isError }));
-            }
-        }
-    }
-    catch (error) {
-        return { concerns, candidates: [], startedAt, completedAt: Date.now(), tools: traces, error: errorMessage(error) };
-    }
-}
 export function parseConcernObservations(raw, allowedIds) {
     const match = raw.trim().match(/\{[\s\S]*\}/);
     if (!match)
@@ -1115,18 +948,10 @@ export function parseConcernObservations(raw, allowedIds) {
 function boundedScore(value) {
     return typeof value === 'number' && Number.isFinite(value) ? Math.min(1, Math.max(0, value)) : .5;
 }
-function parseHeartbeatToolArguments(call) {
-    try {
-        return JSON.parse(call.arguments);
-    }
-    catch {
-        return { __invalidArguments: call.arguments };
-    }
-}
 async function resolveHeartbeatFileAccess(cwd, concerns) {
     const root = await realpath(cwd);
     const writable = new Set();
-    const locators = concerns.flatMap(item => item.resources ?? []).filter(item => item.kind === 'file').map(item => item.locator);
+    const locators = concerns.flatMap(item => item.recordTarget?.kind === 'file' ? [item.recordTarget.locator] : []);
     for (const locator of new Set(locators)) {
         const lexical = resolve(root, locator);
         if (!pathInside(root, lexical) || isPartnerMemoryPath(relative(root, lexical)))
@@ -1144,6 +969,8 @@ async function resolveHeartbeatFileAccess(cwd, concerns) {
     return { root, writable };
 }
 export function heartbeatToolDenial(name, argumentsValue, access) {
+    if (['knowledge_note_references', 'knowledge_note_read', 'knowledge_note_update'].includes(name))
+        return '关注不处理依据中的笔记引用；记录仅使用手动配置的 recordTarget 和专用记录工具。';
     if (!isRecord(argumentsValue))
         return undefined;
     const isRead = ['glob', 'grep', 'read'].includes(name);
@@ -1165,70 +992,10 @@ export function heartbeatToolDenial(name, argumentsValue, access) {
     }
     return undefined;
 }
-async function executeHeartbeatTool(ctx, agent, call, argumentsValue, signal, remainingDiscoveryMs) {
-    const configuredTimeoutMs = call.name === 'web_fetch' || call.name === 'web_source' ? HEARTBEAT_WEB_TOOL_TIMEOUT_MS : HEARTBEAT_TOOL_TIMEOUT_MS;
-    const timeoutMs = Math.max(1, Math.min(configuredTimeoutMs, remainingDiscoveryMs));
-    const timeoutSignal = AbortSignal.timeout(timeoutMs);
-    const toolSignal = AbortSignal.any([signal, timeoutSignal]);
-    try {
-        return await ctx.tools.execute({ callId: call.id, name: call.name, arguments: argumentsValue, agent, signal: toolSignal });
-    }
-    catch (error) {
-        const message = timeoutSignal.aborted && !signal.aborted
-            ? `工具 ${call.name} 超过 ${timeoutMs / 1_000} 秒，已跳过；请按既有规则判断来源不可用，或根据已有结果收束。`
-            : `工具 ${call.name} 调用失败：${errorMessage(error)}`;
-        return { isError: true, content: [{ type: 'text', text: message }] };
-    }
-}
 function pathInside(root, target) {
     const value = relative(root, target);
     return value === '' || (value !== '..' && !value.startsWith(`..${sep}`) && !isAbsolute(value));
 }
-function boundHeartbeatToolArguments(name, value) {
-    if (!isRecord(value))
-        return value;
-    const bounded = { ...value };
-    if (name === 'knowledge_base_search' || name === 'knowledge_search')
-        bounded.limit = boundedInteger(value.limit, 4);
-    if (name === 'knowledge_read')
-        bounded.maxChars = boundedInteger(value.maxChars, HEARTBEAT_KNOWLEDGE_RESULT_LIMIT);
-    if (name === 'web_source')
-        bounded.max_chars = boundedInteger(value.max_chars, 120_000);
-    if (name === 'read')
-        bounded.limit = boundedInteger(value.limit, 80);
-    return bounded;
-}
-function heartbeatToolContent(name, content) {
-    let remaining = heartbeatToolResultLimit(name);
-    const bounded = [];
-    for (const block of content) {
-        if (remaining <= 0)
-            break;
-        if (block.type !== 'text') {
-            bounded.push(block);
-            continue;
-        }
-        const sanitized = name === 'glob'
-            ? block.text.split('\n').filter(line => !isPartnerMemoryPath(line.trim())).join('\n')
-            : block.text;
-        const text = sanitized.length <= remaining ? sanitized : `${sanitized.slice(0, Math.max(0, remaining - 1))}…`;
-        if (text)
-            bounded.push({ ...block, text });
-        remaining -= text.length;
-    }
-    if (bounded.length === 0 && name === 'glob')
-        return [{ type: 'text', text: '未发现可供心跳检查的普通工作文件；伙伴记忆与会话归档已从结果中排除。' }];
-    return bounded;
-}
-function heartbeatToolResultLimit(name) {
-    if (name === 'knowledge_read')
-        return HEARTBEAT_KNOWLEDGE_RESULT_LIMIT;
-    if (name === 'web_fetch')
-        return HEARTBEAT_WEB_FETCH_RESULT_LIMIT;
-    if (name === 'web_source')
-        return HEARTBEAT_WEB_SOURCE_RESULT_LIMIT;
-    return HEARTBEAT_TOOL_RESULT_LIMIT;
-}
 function isPartnerMemoryPath(value) {
     const normalized = value.replaceAll('\\', '/').replace(/^\.\//, '/');
     return /(?:^|\/)(?:memory(?:\/|-backup(?:-|\/)|$)|concerns(?:\/|$))/i.test(normalized);
@@ -1240,45 +1007,41 @@ function isRecord(value) {
     return typeof value === 'object' && value !== null && !Array.isArray(value);
 }
 export function renderHeartbeatActivity(execution, outcome, deliveryError) {
-    const status = outcome === 'notified' ? '已通过微信提醒' : outcome === 'quiet' ? '无需主动提醒' : '执行失败';
+    const status = execution.blocked?.length ? '检查受阻' : outcome === 'notified' ? '已通过微信提醒' : outcome === 'quiet' ? '检查完成，无需主动提醒' : '执行失败';
     const lines = [
         `状态：${status}`,
         `本轮挂念：${execution.concerns.map(item => item.subject).join('；')}`,
         `用时：${formatDuration(execution.completedAt - execution.startedAt)}`,
         `工具：${execution.tools.length > 0 ? `${execution.tools.length} 次调用` : '未调用'}`,
+        ...(execution.recording ?? []).map(item => `记录同步：${execution.concerns.find(concern => concern.id === item.concernId)?.subject ?? item.concernId} · ${item.state === 'synced' ? '已写入手动指定位置' : '待同步（本轮未完成写入，下轮继续处理）'}`),
+        ...(execution.rounds?.length ? [`模型轮次：${execution.rounds.map(item => `${item.round}${item.phase === 'final' ? '（收尾）' : ''} / ${(item.modelMs / 1000).toFixed(1)}秒 / ${item.outputChars}字`).join('；')}`] : []),
     ];
     execution.tools.forEach((trace, index) => {
         lines.push('', `${index + 1}. ${trace.name} · ${trace.status === 'completed' ? '完成' : '失败'} · ${formatDuration(trace.completedAt - trace.startedAt)}`, `输入：${trace.input}`, `结果：${trace.output}`);
     });
+    for (const id of execution.blocked ?? [])
+        lines.push(`受阻事项：${execution.concerns.find(item => item.id === id)?.subject ?? id}；${execution.blockedReasons?.[id] ?? '目标数据尚未核实'}`);
     const changed = execution.observations ?? [];
     const conclusion = execution.error || deliveryError
         ? `失败原因：${deliveryError ?? execution.error}`
         : changed.length > 0
             ? `新变化：\n${changed.map(item => `- ${item.event}（${decisionLabel(item.decision)} · ${Math.round(item.interruptScore * 100)}）`).join('\n')}`
-            : '最终结论：本轮没有发现经过校验的新变化。';
+            : execution.concerns.some(item => item.recordingSnapshot) ? '最终结论：本轮仅执行记录同步，未抓取来源或发送变化提醒。' : '最终结论：本轮没有发现经过校验的新变化。';
     lines.push('', conclusion);
     return lines.join('\n');
 }
 function decisionLabel(value) {
     return value === 'notify' ? '已提醒' : value === 'feed' ? '伙伴动态' : value === 'defer' ? '顺手一提' : value === 'remember' ? '静默记下' : '忽略';
 }
-function auditValue(value, limit) {
-    try {
-        return auditText(JSON.stringify(value), limit);
-    }
-    catch {
-        return auditText(String(value), limit);
-    }
-}
-function auditText(value, limit) {
-    const text = value.trim().replace(/\n{3,}/g, '\n\n');
-    return text.length <= limit ? text : `${text.slice(0, limit - 1)}…`;
-}
 function formatDuration(milliseconds) {
     if (milliseconds < 1_000)
         return `${Math.max(0, milliseconds)} ms`;
     return `${(milliseconds / 1_000).toFixed(milliseconds < 10_000 ? 1 : 0)} 秒`;
 }
+function auditText(value, limit) {
+    const text = value.trim().replace(/\n{3,}/g, '\n\n');
+    return text.length <= limit ? text : `${text.slice(0, limit - 1)}…`;
+}
 function errorMessage(error) { return error instanceof Error ? error.message : String(error); }
 function textContent(content) {
     return content.filter((block) => block.type === 'text' && typeof block.text === 'string')