@shgroup/dsh-serenity-hooks 1.63.2 → 1.65.0

package/lib/wake-registry.d.ts

@@ -1,7 +1,7 @@
 /**
- * wake-registry.ts — trajectory 唤醒注册表（D58，S142 2026-09-13）
+ * wake-registry.ts — 认知轨迹唤醒注册表（D58，S142 2026-09-13）
  *
- * 需求（用户原话）：一个 CCC 内允许多个 trajectory 任意形态并行；某个 trajectory 可以
+ * 需求（用户原话）：一个 CCC 内允许多个认知轨迹任意形态并行；某个认知轨迹可以
  * **预定未来唤醒自己或别人**，本质上是一次「未来时刻 + 一条 message」的投递；「周期自唤醒」
  * 曾是它的特例（原 ACC autopilot / D59，该机制已于 2026-09-15 整段退场）。协作边界：
  * 互相可见、**无阻塞无等待**。
@@ -24,11 +24,11 @@ type WakeState = 'pending' | 'delivered' | 'missed' | 'cancelled';
 export interface WakeEntry {
     /** 稳定 id（不复用；`w-<当地到分钟>-<4 hex>`） */
     id: string;
-    /** 目标 trajectory：`S###` 或完整 AGENT_SESSIONS 目录名（编码无关，与绑定锚一致） */
+    /** 目标认知轨迹：`S###` 或完整 AGENT_SESSIONS 目录名（编码无关，与绑定锚一致） */
     target: string;
     /** 绝对时刻（当地 RFC3339 带偏移，如 `2026-09-14T09:00:00.000+08:00`） */
     at: string;
-    /** 唤醒 message（投递给目标 trajectory 的正文） */
+    /** 唤醒 message（投递给目标认知轨迹的正文） */
     message: string;
     /** 状态 */
     state: WakeState;
@@ -79,7 +79,7 @@ export declare function parseWakeAt(input: string, nowMs: number): {
 /**
  * 登记一条唤醒。
  * @param root CCC 根
- * @param input 目标 trajectory / 时刻串 / message / 发起者 / 当前时刻
+ * @param input 目标认知轨迹 / 时刻串 / message / 发起者 / 当前时刻
  * @returns 成功返回条目，失败返回稳定错误文案（不抛错）
  */
 export declare function addWake(root: string, input: {

package/lib/wake-scheduler.d.ts

@@ -1,8 +1,8 @@
 /**
- * wake-scheduler.ts — trajectory 唤醒调度器（D58/D59/D60；S142 2026-09-13）
+ * wake-scheduler.ts — 认知轨迹唤醒调度器（D58/D59/D60；S142 2026-09-13）
  *
  * 一个**中心调度器**（5min tick，复用 autopilot 的节律常量），处理 CCC 唤醒注册表里
- * 到期的条目：把「未来时刻 + 一条 message」投递给目标 trajectory，**fire-and-forget**
+ * 到期的条目：把「未来时刻 + 一条 message」投递给目标认知轨迹，**fire-and-forget**
  * （无阻塞、无等待、无回执——发起方不 await，调度器不替模型结果负责）。
  *
  * 与 autopilot 的关系（D59）：**两个 tick 各自独立**。autopilot 是每 CCC 单例的
@@ -100,7 +100,7 @@ export declare function deliverWake(ctx: unknown, root: string, entry: WakeEntry
  */
 export declare function buildSendText(target: WakeTarget, message: string, sender: string): string;
 /**
- * 即时投递（`container_trajectory send-now`）——与 `send-later`（预约）**共用取用通路**（`acquireWakeAgent`），
+ * 即时投递（`cognitive_trajectory send-now`）——与 `send-later`（预约）**共用取用通路**（`acquireWakeAgent`），
  * 区别只在**时刻**（现在 vs 未来）与**回执**（有 vs 无）：
  *   · `send-later`（原 `wake-later`）：未来时刻 + 一条 message → 落注册表 → 本文件的调度器到点投递（**fire-and-forget，无回执**）
  *   · `send-now`（原 `send-message`）：**此刻**把一条 message 递给目标 → **同步回执** → **不落注册表**
@@ -127,7 +127,7 @@ export declare function buildSendText(target: WakeTarget, message: string, sende
  * 预约的本职是"到点唤起"，且在跑时排队不打断是它被实证验收过的行为，不顺手动它。
  *
  * **归属**：本函数放在调度器侧而非工具侧 —— "怎么把一句话送到一条轨迹"是**调度器的知识**，
- * 工具只该知道"有这个动作"。这样 `trajectory.ts` 完全不碰调度器内部（v1.35.0 硬约束①：
+ * 工具只该知道"有这个动作"。这样 `cognitive-trajectory.ts` 完全不碰调度器内部（v1.35.0 硬约束①：
  * `send-later` 链路**一行为不动**，本次改动 = **纯新增**）。
  *
  * @param ctx 插件上下文
@@ -137,7 +137,7 @@ export declare function buildSendText(target: WakeTarget, message: string, sende
  * @param sender 发起者轨迹标识
  * @returns 投递结果（**同步**返回给调用方）
  */
-export declare function sendToTrajectory(ctx: unknown, root: string, target: string, message: string, sender: string): Promise<WakeDeliveryResult>;
+export declare function sendToCognitiveTrajectory(ctx: unknown, root: string, target: string, message: string, sender: string): Promise<WakeDeliveryResult>;
 /**
  * CRO 唤起消息正文（**刻意不复用** {@link buildWakeText} / {@link buildSendText}）。
  *

package/lib/weixin-bridge.d.ts

@@ -21,7 +21,7 @@
  * `human-channel.ts`（机器级机制；本文件只接线）。这是"微信桥上移 ACC 层"的第一步。
  *
  * 外部面纯净（D9/D11 延续）：微信桥会话 = 外部面——session/prompt 走
- * includeTrajectory:false（对外不返回轨迹）；skiff 角色白名单即授权（G9）。
+ * includeCognitiveTrajectory:false（对外不返回轨迹）；skiff 角色白名单即授权（G9）。
  */
 import type { Context } from 'cordis';
 import { type WeixinAccountCredential } from './weixin-route.js';

package/lib/{weixin-route-Aheyq3fN.js → weixin-route-BoSC-uPp.js}

@@ -1,6 +1,6 @@
 import { t as __exportAll } from "./rolldown-runtime-8H4AJuhK.js";
-import { s as loadSerenityConfig, t as DEFAULT_SERENITY_CONFIG_PATHS } from "./ccc-B0ZGL9lx.js";
-import { c as unsetEntry, l as writeEntry, r as getEntry } from "./localstore-ops-DMs_ovHo.js";
+import { s as loadSerenityConfig, t as DEFAULT_SERENITY_CONFIG_PATHS } from "./ccc-C33QWoWZ.js";
+import { c as unsetEntry, l as writeEntry, r as getEntry } from "./localstore-ops-ylQoPz1Q.js";
 import { join, resolve } from "node:path";
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { createHash } from "node:crypto";

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@shgroup/dsh-serenity-hooks",
-  "version": "1.63.2",
-  "description": "宁静号 ACC harness（Native Cordis 插件）——给 DeepSeek Harness 装一个「AI 工作区」：14 个工具（container_fs/container_trajectory/dashboard/container_git/msm/praxis/ontology/serenity-skill-creator/cheap-worker/localstore/container_admin；另三个 im-bridge/acc-diag/diagram 按配置条件出现）+ 机械约束（安全模式/工作区围墙/密钥守卫/对外输出守卫）+ 工作日志与原地重建 + 网页登录入口/微信桥/子角色/官方 ACP 面/trajectory 唤醒注册表。适配 DSH 0.1.7-rc.1 / 0.2.0-rc.1 / 0.2.1-rc.1（三档）。",
+  "version": "1.65.0",
+  "description": "宁静号 ACC harness（Native Cordis 插件）——给 DeepSeek Harness 装一个「AI 工作区」：14 个工具（container_fs/cognitive_trajectory/dashboard/container_git/msm/praxis/ontology/serenity-skill-creator/cheap-worker/localstore/container_admin；另三个 im-bridge/acc-diag/diagram 按配置条件出现）+ 机械约束（安全模式/工作区围墙/密钥守卫/对外输出守卫）+ 认知轨迹日志与原地重建 + 网页登录入口/微信桥/子角色/官方 ACP 面/认知轨迹唤醒注册表。适配 DSH 0.1.7-rc.1 / 0.2.0-rc.1 / 0.2.1-rc.1（三档）。",
   "license": "MIT",
   "repository": {
     "type": "git",

package/lib/unattended-ops.d.ts

@@ -1,249 +0,0 @@
-/**
- * unattended-ops.ts — 无人值守代理回复（unattended proxy）机制层（S142 **D77**，owner 2026-09-23 提案）
- *
- * ## 这东西用来干什么（白话）
- *
- * 用户发个任务就走开。现在模型干完一段就停下来等回话，用户不在 ⇒ **会话挂在那儿不动**。
- * 本机制 = 用户走开后，系统**代替用户说一句"继续"**：让它自己跑完；干完了用一个**验证码**报告；
- * 卡住了先自己想办法；真不能定的**写下来等用户回来**。
- *
- * ## 归属（D23：ACC 管机制与数据，CCC 管措辞与纪律）
- *
- * | 面 | 归谁 | 内容 |
- * |---|---|---|
- * | **机制** | 🔴 **ACC（本模块）** | 触发判定 / 验证码 / 四选一结构 / 轮上限 / 流水 |
- * | **不可代批的*具体内容*** | **CCC 纪律** | ACC 只给**通用下限**（{@link UNATTENDED_BLOCKED_FLOOR}），CCC 可加严 |
- *
- * 🔵 下限之所以落在 ACC（而不是"完全交给 CCC"）：**没有这张清单，"自行解决"＝把所有把关点自动放行**。
- * 最终内容仍待 owner 一句（设计 §13-5）——本版先给**保守下限**，CCC 只能在其上加严、不得放宽。
- *
- * ## 🔴 核心原则：单一续驱者（single-driver）
- *
- * > **一个会话同一时刻只应有一个"续驱者"：用户 ／ CRO ／ 自排绳 ／ 无人值守代理。**
- *
- * 口径（owner 2026-09-23 19:1x 裁决）= **窄口径：只排除「有 CRO 程序的轨迹」**。
- * 原「宽口径」（任何自排唤醒都排除）**作废** —— 它会让本机制**永远够不着靠续接绳活着的会话**，
- * 等于**放弃"代替旧机制"**（绳因此退化为**长周期保险丝**：6–12h 一条）。
- *
- * ## 🔴 铁律（与 `cro.ts` / `cro-log.ts` 同族，勿破）
- *
- * **本模块的每个导出函数都不抛错**：写盘 / 解析 / 裁剪失败一律返回结构化失败。
- * ⇒ 代理机制的任何问题**不影响 turn 收尾**、不影响既有链路（唤醒投递 / 输出守卫 / rebuild）。
- *
- * ## 🔴 为什么不构成第二真相源（勿删此论证）
- *
- * | 载体 | 谁写 | 主语 | 回答 |
- * |---|---|---|---|
- * | `<轨迹目录>/unattended-log.json`（**本模块**） | **ACC** | ACC | 「**我注入了什么、判了什么、放过没有**」 |
- * | `<轨迹目录>/SESSION.md` | **LLM（CCC）** | CCC | 「**这轮发生了什么、为什么这么定**」 |
- *
- * **内容不重叠**：本模块只记**机械事实**（轮次 / 验证码 / 判定理由码 / 是否放过），**不写散文**；
- * LLM 侧的散文与理由归 SESSION.md。完整审计 = 两者合看（本模块 = 注入面｜SESSION.md = 判断面）。
- *
- * ## 🔴 验证码形态（禁用 4 位字母码）
- *
- * 注入文本**自带**"请回复 ABCD" ⇒ 模型**复述指令**即**假完成**（高概率，不是小概率）
- * ⇒ 用**每轮新生成**的 nonce ＋ **包装 ＋ 独占一行**（`[[UNATTENDED-DONE:<hex>]]`），
- * 明写「**旧码作废**」，校验**只认当前轮**（防上下文里的旧码复活）。
- * 先例 = `cheap-worker` background 的 `SERENITY_CHEAP_WORKER_DONE_<16hex>`（同族实现）。
- */
-/** 完成码包装前缀（**独占一行**才有意义；见文件头"禁用 4 位字母码"） */
-export declare const UNATTENDED_DONE_PREFIX = "[[UNATTENDED-DONE:";
-/** 完成码包装后缀 */
-export declare const UNATTENDED_DONE_SUFFIX = "]]";
-/** 注入消息的**首行标记**（幂等可辨：模型与事后审计都能一眼看出这是代理消息，不是用户消息） */
-export declare const UNATTENDED_PROXY_MARK = "[[UNATTENDED-PROXY v1]]";
-/** 🔴 合成消息**固定身份句**（owner 已裁：「形如用户消息，但首句自报身份与权限边界」） */
-export declare const UNATTENDED_IDENTITY_LINE = "\u65E0\u4EBA\u503C\u5B88\u4EE3\u7406 \u00B7 \u975E\u672C\u4EBA";
-/** nonce 字节数 ⇒ 16 个 hex 字符（与 cheap-worker 同量级；够长到不可能被复述猜中） */
-export declare const UNATTENDED_NONCE_BYTES = 8;
-/** 生成一枚新 nonce（**每轮一枚**；旧码作废由调用方在文本里声明） */
-export declare function newNonce(): string;
-/** 完成码全文（注入文本展示用；校验走 {@link hasDoneToken}） */
-export declare function doneToken(nonce: string): string;
-/**
- * 出现过的完成码 nonce 列表（按出现顺序、去重；**小写归一**）。
- * 容忍 8–64 位 hex（模型可能手抄多/少几个字符 ⇒ 那就不匹配，属预期：只认本轮那枚）。
- */
-export declare function parseDoneNonces(text: string): string[];
-/** 本轮收尾文本里是否出现过**当前轮**那枚码（唯一合法收束判据） */
-export declare function hasDoneToken(text: string, nonce: string): boolean;
-/** 单个会话在一个"代理段"内的**轮次上限**（设计建议 10–20；取 15——远小于 cheap-worker 的 100） */
-export declare const UNATTENDED_MAX_ROUNDS = 15;
-/** 一个"代理段"的**墙钟上限**（自第一次注入起算；跨轮累计，防"轮次没到但烧了一天"） */
-export declare const UNATTENDED_MAX_WALL_MS: number;
-/** 触及即停（写待办/交接，**不循环**）——**CCC 的纪律更严则从严** */
-export declare const UNATTENDED_BLOCKED_FLOOR: readonly string[];
-/** 注入消息装配输入 */
-export interface ProxyMessageInput {
-    /** 本轮轮次号（1 起） */
-    round: number;
-    /** 轮上限（写进文本让模型知道还剩几轮） */
-    maxRounds: number;
-    /** 本轮 nonce */
-    nonce: string;
-    /** 不可代批清单（缺省 = {@link UNATTENDED_BLOCKED_FLOOR}） */
-    blocked?: readonly string[];
-}
-/** 组装一次代理注入消息（**形如用户消息，但首句自报身份与权限边界**） */
-export declare function buildProxyMessage(input: ProxyMessageInput): string;
-/**
- * 组装一次**假完成打回**消息（设计 §7 的机械核验分支：声称已通知用户，但本轮无发送记录）。
- *
- * ⚠️ 同样带**新 nonce**：它是一次"再来一轮"，不是"放过"。
- */
-export declare function buildFalseNotifyRebuke(input: ProxyMessageInput): string;
-/** 收尾文本是否**声称**已联系用户（见 {@link NOTIFY_CLAIM_PATTERNS} 的误判方向说明） */
-export declare function claimsUserNotification(text: string): boolean;
-/**
- * **不许开**的会话（设计 §3 的"建议写死"，本版**确实写死**）：
- * `skiff-`（F4 问答 / **微信桥会话也是这个前缀** —— 桥那侧的"用户"是**家人**，
- * 代理替家人说话 = **冒充**）｜ `acp-`（对外程序化面 —— ⚠️ **2026-10-15 起已成死判据**：
- * 该前缀从无生产者且面 E 已退役；理由与"为何保留"见 `output-guard-seam.ts` 文件头）｜
- * `cheap-worker-`（自主 worker，已有自己的完成码循环）。
- *
- * ⚠️ **`rebuild-` 不在排除面**（与 `output-guard-seam.ts` 的取向**刻意不同**）：重建会话是
- * **同一轨迹的载体**（内部维护面），不是对外面；把它排除会让"重建后就没人推了"。
- */
-export declare function isProxyExcludedSessionId(sessionId: string): boolean;
-/** 判定所需事实（**全部由 seam 取好**，本函数不做任何 I/O、不读时钟） */
-export interface UnattendedFacts {
-    /** 总闸（settings `unattendedEnabled`，缺省关） */
-    enabled: boolean;
-    /** 本会话所属 CCC 根；null = 不在任何 CCC 内 */
-    root: string | null;
-    /** 是 CCC 内**主会话**（`delegationDepth === 0`；子代理/无头运行不算） */
-    isMainSession: boolean;
-    /** 会话 id 在排除面（{@link isProxyExcludedSessionId}） */
-    sessionIdExcluded: boolean;
-    /** **本轮由真实用户消息发起**（`agent/inbox/claimed` + source.kind === 'user'） */
-    userInitiated: boolean;
-    /** 该轨迹**有 CRO 程序**（窄口径的唯一排除项） */
-    hasCroProgram: boolean;
-    /** 该会话当前的代理段状态；null = 尚未开始 */
-    run: ProxyRun | null;
-    /** 当前时刻（epoch ms，由调用方注入 ⇒ 用例可穷举时间边界） */
-    nowMs: number;
-    /** 收尾文本里出现的当前轮候选码（{@link parseDoneNonces} 的首个；无 ⇒ null） */
-    doneNonce: string | null;
-    /** 收尾文本**声称**已通知用户（{@link claimsUserNotification}） */
-    claimsNotify: boolean;
-    /** 本轮窗口内 ACC 侧**确实**发出过消息（{@link hasOutboundSendSince}） */
-    outboundSeen: boolean;
-}
-/** 判定结论（`reason` 是**机器可读理由码**：写进流水，便于事后 grep 归因） */
-export interface UnattendedVerdict {
-    action: 'skip' | 'accept' | 'inject' | 'cap';
-    reason: string;
-    /** 轮次号：`inject` = **即将注入**的那一轮；`accept` / `cap` = 当前轮；`skip` = 0 */
-    round: number;
-}
-/**
- * 一次判定的**唯一入口**（纯函数）。
- *
- * 顺序即语义（R↓，勿随意调换）：
- *  1. **闸/空间/会话资格**（关着、不在 CCC、非主会话、排除面）⇒ skip；
- *  2. **单一续驱者**：用户刚发起 ⇒ skip（人就在场）；该轨迹有 CRO ⇒ skip（程序在驱动）；
- *  3. **合法收束优先于轮上限** —— 最后一轮交的码必须算数（否则等于永远收不了尾）；
- *  4. 交码 ＋ 声称已通知 ＋ **无发送记录** ⇒ 假完成，走下一轮（reason=`false-notify`）；
- *  5. 墙钟 / 轮上限 ⇒ cap（**停下不动**，退回改造前的行为，不产生新风险）；
- *  6. 其余 ⇒ inject 下一轮。
- */
-export declare function decideUnattendedAction(f: UnattendedFacts): UnattendedVerdict;
-/** 一个会话的"代理段"状态（自第一次注入起算，直到 放过 / 上限 / 用户回来） */
-export interface ProxyRun {
-    /** 已注入到第几轮 */
-    round: number;
-    /** **当前轮**的 nonce（校验只认它） */
-    nonce: string;
-    /** 第一次注入的时刻（墙钟上限的起算点，**跨轮累计**） */
-    startedAt: number;
-}
-/** 取该会话的代理段（无 ⇒ null） */
-export declare function getProxyRun(sessionId: string): ProxyRun | null;
-/** 开始 / 推进一段代理（`startedAt` 由调用方给出 ⇒ 跨轮保留首次值） */
-export declare function setProxyRun(sessionId: string, run: ProxyRun): void;
-/** 结束该会话的代理段（放过 / 上限 / 用户回来 / 载体销毁） */
-export declare function clearProxyRun(sessionId: string): void;
-/** 当前在代理的会话 id（诊断 / 测试用） */
-export declare function proxyRunSessionIds(): string[];
-/** 当前代理中、已注入轮数的合计（`acc-diag` 观测面用） */
-export declare function activeProxyRoundTotal(): number;
-/** 记下"这个载体的这一轮是真实用户发起的" */
-export declare function noteUserTurn(sessionId: string, turn: number): void;
-/** 该载体的这一轮是否由真实用户发起（判据 = `noteUserTurn` 写入的最新一条） */
-export declare function isUserTurn(sessionId: string, turn: number | null | undefined): boolean;
-/** 清掉该载体的用户轮次记录（载体销毁时） */
-export declare function clearUserTurn(sessionId: string): void;
-/** 清空全部进程内运行态（disposer；**不碰磁盘**） */
-export declare function clearUnattendedState(): void;
-/** 测试辅助：复位（生产零调用） */
-export declare function __resetUnattendedForTest(): void;
-/** 每个 CCC 保留的最近发送条数（环形裁剪 ⇒ 表大小有界） */
-export declare const UNATTENDED_OUTBOUND_KEEP = 20;
-/** 发送记录保留窗（超出即丢：它只服务"这一轮到底发没发"这个瞬时问题） */
-export declare const UNATTENDED_OUTBOUND_TTL_MS: number;
-/**
- * 记一次**成功的**出站发送（`im-bridge` 工具面在通道返回成功后调用）。
- *
- * ⚠️ **覆盖边界（诚实标注）**：只覆盖 **ACC 自己这条通道**（`im-bridge` 的 send / send-file）。
- * CCC 自有的发送通道（如 `mail-tool` MSM）**ACC 看不见** ⇒ 那类"已通知"落到
- * {@link hasOutboundSendSince} = false ⇒ 会被判成假完成。⇒ 本版口径：**代理模式下"联系用户"
- * 只认 ACC 通道**；这与设计 §7 的原话（im-bridge 记日志）一致，边界写在此处以免误读。
- */
-export declare function noteOutboundSend(root: string, atMs?: number): void;
-/** 自 `sinceMs` 起该 CCC 是否有过成功出站发送（**只读，不清表**——清理归写入侧的裁剪） */
-export declare function hasOutboundSendSince(root: string, sinceMs: number, nowMs?: number): boolean;
-/** 发送记录表大小（诊断 / 测试用） */
-export declare function outboundSendRoots(): string[];
-/** 固定文件名（与 `cro-wake-log.json` 并排、主语分明：那份记"我叫了什么"，这份记"我代说了什么"） */
-export declare const UNATTENDED_LOG_FILENAME = "unattended-log.json";
-/** 保留窗 = 2 日（与 CRO 流水同值；**常量** ⇒ 无需人工清理动作） */
-export declare const UNATTENDED_LOG_RETENTION_MS: number;
-/** 一条代理流水（**成功与失败都记**，与 CRO 流水同规格） */
-export interface UnattendedLogEntry {
-    /** 时刻（当地 RFC3339 带偏移，遵 D67） */
-    at: string;
-    /** 事件：inject（注入了一轮）/ accept（交码放过）/ cap（撞上限停下）/ yield（用户回来、让位） */
-    event: 'inject' | 'accept' | 'cap' | 'yield';
-    /** 轮次号 */
-    round: number;
-    /** 该轮 nonce（yield / cap 时 = 停下时的当前码；无 ⇒ null，**不留空白**） */
-    nonce: string | null;
-    /** 机器可读理由码（判定函数的 `reason`） */
-    reason: string;
-    /** 载体 dsh 会话 id（多载体轨迹可分辨） */
-    sessionId: string;
-}
-/** 文件形态（与 `wake-registry.json` / `cro-wake-log.json` 同款：`{version, entries}`） */
-export interface UnattendedLog {
-    version: number;
-    entries: UnattendedLogEntry[];
-}
-/** 日志绝对路径 */
-export declare function unattendedLogPath(root: string, dirName: string): string;
-/** 读取流水（**永不抛**；读坏 ⇒ 当作空档 + 返回 error 文本） */
-export declare function loadUnattendedLog(root: string, dirName: string): {
-    log: UnattendedLog;
-    error: string | null;
-};
-/**
- * 按窗裁剪（**纯函数** ⇒ 可穷举测试）。
- * 🔴 `at` 不可解析者**一律丢弃**并在返回值里报数（`dropped`）——**不静默吞掉**（同 `cro-log.ts` 纪律）。
- */
-export declare function pruneUnattendedLogEntries(entries: UnattendedLogEntry[], nowMs: number, windowMs?: number): {
-    kept: UnattendedLogEntry[];
-    pruned: number;
-    dropped: number;
-};
-/**
- * 追加一条流水并按窗裁剪（**本模块的落盘入口；永不抛**）。
- *
- * 顺序 = 读 → 追加 → 裁剪 → **原子写**（tmp + rename）。任一步失败 ⇒ `{ok:false, error}`，**不抛**
- * ——调用方只记一行 console 日志 ⇒ **代理机制的问题绝不影响 turn 收尾**。
- */
-export declare function appendUnattendedLog(root: string, dirName: string, entry: Omit<UnattendedLogEntry, 'at'>, nowMs?: number): {
-    ok: boolean;
-    error: string | null;
-    kept: number;
-};

package/lib/unattended-seam.d.ts

@@ -1,49 +0,0 @@
-/**
- * unattended-seam.ts — 无人值守代理回复的**拦截缝**（S142 **D77**，owner 2026-09-23 令「我需要的是一个机制」）
- *
- * ## 停在哪、怎么接（设计 §4 的裁决：**A 的通道 ＋ B 的措辞**）
- *
- * 复用的是**已验证过的**通道——`agent/turn-stopping`（serial）里 `agent.steer()`：
- * 宿主语义 = "**listener 反对就打回**，机器重读 inbox：有新 steer ⇒ 再跑一步，没有 ⇒ 关轮"
- * （`host/contract.ts` 的 `HOST_EVENTS` 原文）。因此：
- * · **轮不结束**（语义正是"有人打回"）⇒ **零新机械**；
- * · 文本**写成代理用户的话**（B 的措辞）+ **首句自报身份**（owner 已裁）。
- *
- * 模板 = `output-guard-seam.ts`（同一缝位、同一 `createUserMessage + PLUGIN_SOURCE` 形态）。
- *
- * ## 🔴「这轮是不是真实用户发起的」怎么判（本机制**唯一**的新机械；2026-09-23 取证）
- *
- * 交接块把它列为"动手前必须先查清的一件事"，取证结论（读宿主类型面，非猜测）：
- *
- * | 事实 | 出处 |
- * |---|---|
- * | 每条进入 inbox 的消息都发 `agent/inbox/inserted { agent, message }`；**在轮内离开 inbox 时**发 `agent/inbox/claimed { agent, message, turn }` | `@deepseek-ai/dsh-agent` README（Inbox 段）＋ `runtime-types.d.ts` |
- * | `claimed.turn` = **拥有该消息的那一轮**；`turn-stopping.turn` = **即将关闭的那一轮** ⇒ 两者同编号可直接比对 | `runtime-types.d.ts` 同一文件两处 `turn` 声明 |
- * | 消息来源可辨：`MessageSourceMap` 里**真实用户** = `kind: 'user'`（`user` ／ `user-rpc` 两种形态**同 kind**）；**ACC 自己注入**的一律 `kind: 'plugin:dsh-serenity-hooks'`（v1.47.0 改；旧值 = `'plugin'`） | `@deepseek-ai/dsh-llm` `src/message.ts` 的 `MessageSourceMap`（合并和类型）＋ 本仓 `message-source.ts`（**唯一**声明处与常量处） |
- *
- * ⇒ **判据 = 「这一轮 claim 到的消息里，有没有 `source.kind === 'user'`」**。
- * 没有现成信号时本可退化为"记账法"（我们知道自己投过什么），**但不必**：宿主已给出一手信号。
- *
- * ## 🔴 为什么"用户发起的轮"要跳过（这是设计 §3-③ 的本意，别当成漏洞）
- *
- * 用户**刚说完话**⇒ 人就在跟前，代理插话既是冒充也是浪费。**"用户说完走开"那种情形**
- * 由**绳（长周期保险丝）／其它非用户发起的唤醒**覆盖：那条轮**不是**用户发起的 ⇒ 代理接手，
- * 一路推进到**合法收束**。⇒ 两个机制合起来才等于"用户走开后会话还能自己跑完"。
- *
- * ## 🔴 铁律（与 `unattended-ops.ts` 同族）
- *
- * **本模块的任何失败都不得影响 turn 收尾**：所有 handler 包 try/catch，异常只记一行 console。
- */
-import type { Context } from 'cordis';
-import type { Agent } from '@deepseek-ai/dsh-agent';
-/**
- * 装配无人值守代理缝（`index.ts` apply 调用）。
- *
- * 订阅三个事件（**都已在 `host/contract.ts` 白名单里**，新增的 `agent/inbox/claimed` 同批登记）：
- * · `agent/inbox/claimed` —— 记「真实用户发起的轮次」；用户回来时**让位**（清代理段 + 记流水）;
- * · `agent/turn-stopping` —— 判定 + 注入（本机制主体）；
- * · `agent/disposed` / `session/disposed` —— 载体销毁清表（**本容器栽过 5 次"只增不清"**）。
- */
-export declare function registerUnattendedSeam(ctx: Context): void;
-/** 类型再导出（调用方少一处 import） */
-export type { Agent as UnattendedAgent };