@zhushanwen/zcode-subagent-cli 0.2.0 → 0.3.0

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { EnginePort, ReverseRequestClock, EngineCapabilities, ProbeReport, EngineAgentCallOpts, RunContext, EngineRunResult, EngineHandle, InteractAction, InteractResult, SessionView } from '@zhushanwen/subagent-engine-sdk';
+import { EnginePort, ReverseRequestClock, EngineCapabilities, ProbeReport, EngineAgentCallOpts, RunContext, EngineRunResult, EngineHandle, SessionView } from '@zhushanwen/subagent-engine-sdk';
 
 /** 出站帧写入面（main.ts 注入 process.stdout；测试注入内存缓冲）。 */
 type FrameWriter = (frame: unknown) => void;
@@ -30,17 +30,16 @@ declare class EngineProtocolServer {
     constructor(opts: EngineProtocolServerOptions);
     /** 入站帧消费（请求帧 + 反向请求应答帧；main.ts 的行解析器拆行后喂入）。 */
     handleFrame(frame: unknown): void;
-    /** 10 正向方法分发（表驱动：method → 处理器；未知方法 → engine_protocol_unknown_method）。 */
+    /** 9 正向方法分发（表驱动：method → 处理器；未知方法 → engine_protocol_unknown_method）。 */
     private dispatch;
     /**
-     * 10 正向方法 → 处理器映射（每个处理器消费原始 params 并自行收敛类型——
+     * 9 正向方法 → 处理器映射（每个处理器消费原始 params 并自行收敛类型——
      * 与原 switch case 表达式一一对应）。
      */
     private readonly methodHandlers;
     private initialize;
     private run;
     private cancel;
-    private interact;
     private read;
     private validateModel;
     private emitEvent;
@@ -111,8 +110,8 @@ declare class ZcodeEngine implements EnginePort {
     /**
      * 常驻路径主编排：模型解析（v2 单源校验）→ 惰性连接 + runTurn（事件时序前移：
      * text_delta 流式、终态后 message_end/turn_end）→ schema 仿真重试 → outcome/handle。
-     * poolKey 固定 'shared'（共享宿主 HOME，无池），onPoolResolved 在 prepare 期、
-     * onHandleReady 在 create 应答后（§3.4 不变量 3）。
+     * onHandleReady 在 create 应答后（§3.4 不变量 3；原 onPoolResolved prepare 期
+     * 声明已随 [池抽象降级 2026-09-13] poolKey 协议面退役删除）。
      */
     private runViaAppServer;
     /** pre-aborted 短路收口：合成中止 outcome + 'shared' 锚定 handle。 */
@@ -214,17 +213,6 @@ declare class ZcodeEngine implements EnginePort {
      * ensureAppServerRuntime 自动重建（与崩溃重建同一代码路径，不变量 4）。
      */
     dispose(): Promise<void>;
-    /**
-     * [u7a D5] 引擎在途只读快照：activeSessions 非空才算在途——poolKey 'shared' 的
-     * app-server **空闲常驻进程恒活，禁止按进程存在判定**（进程在 ≠ 在途，否则推迟
-     * 判定恒真、30min 上限从兜底变常态路径，设计 §3.3 D5 显式排除）。计数权威 =
-     * activeSessions（attempt 入 create 应答后 add / finally settle 后 delete，与
-     * dispose 的 close 帧目标集同一状态源，无双记账）。运行时未初始化（从未 run /
-     * 已 dispose）→ 恒 0。
-     */
-    inFlightSnapshot(): {
-        inFlight: number;
-    };
     /** 终态合成（extension-conventions 函数 80 行上限，从 run 提取）：aborted / run-failed / parsed 三分支。 */
     private finalizeOutcome;
     /** abort 合成终态：exitCode=null（record 正常收尾，不留僵尸）。 */
@@ -237,11 +225,6 @@ declare class ZcodeEngine implements EnginePort {
     private applyRunFailedOutcome;
     /** parsed 合成终态：content/sessionId/usage 落位 + schema 校验分流 + coarse 事件。 */
     private applyParsedOutcome;
-    /**
-     * D1 可选面：zcode 首期不支持 conversation（capabilities 声明）——同步拒绝、
-     * 不创建进程，文案给可操作建议（A11）。
-     */
-    interact(_handle: EngineHandle, _action: InteractAction): Promise<InteractResult>;
     /** [U7] 模型可发现性：v2 桌面登录态聚合（带凭据 provider × models），失败安全返回清单本身可能为空。 */
     listModels(): Array<{
         id: string;
@@ -263,8 +246,12 @@ declare class ZcodeEngine implements EnginePort {
      * sessionId 缺失（解析失败的 run 无法定位 session）跳过①级；②级依赖
      * handle.journalPath（宿主 run 后回填）。dbPath：新 handle 恒为隔离库绝对路径
      * （zcodeSessionDbPath(engineDataDir)，tier1 白名单集合见方法体——宿主路径仅
-     * 「共享 HOME 时代」存量兼容）；旧 records（池时代）的相对路径仍按 poolKey
-     * 锚定解析（read 兼容旧数据，池目录不存在时自然落②级 journal 降级）。
+     * 「共享 HOME 时代」存量兼容）；旧 records（池时代）的相对路径仍按池目录锚定
+     * 解析（read 兼容旧数据，池目录不存在时自然落②级 journal 降级）。[池抽象降级
+     * 2026-09-13] 锚定 key 用常量 SHARED_POOL_KEY 承载——协议面 poolKey 已删，池
+     * 时代真实池 key 不再随 handle 传输；若旧 record 的池目录恰为 shared 布局则①级
+     * 仍可达，其余池 key 的旧 record 直接走②级 journal 降级（30 天 TTL 同尺度衰减，
+     * 行为安全）。
      */
     read(handle: EngineHandle): Promise<SessionView>;
     /**
@@ -287,6 +274,16 @@ declare class ZcodeEngine implements EnginePort {
      * 均不出声（避免噪音）。
      */
     private warnIgnoredCtxModel;
+    /**
+     * [U6 / §3.2.6 要点 3] resume 锚 → 历史前缀（interact-resume 的读半段）。
+     *
+     * 无锚 / 非 zcode 锚形态 → undefined（行为不变）。读通道失败（条目被 TTL 清 /
+     * 会话失效 / 控制面错误）= 宿主侧锚判据通过后、引擎派发前的窄竞态窗——降级为
+     * **无历史前缀的新会话**（warn 留痕；宿主 reopen 摘要承担主降级面），不炸轮：
+     * 续聊消息本身仍可送达（模型缺历史上下文，比整轮失败可用性高，与 reopen 降级
+     * 的「带摘要重开」语义同族）。
+     */
+    private buildResumeHistoryPrefix;
     /**
      * persona 拼接后的完整 prompt（personaInjection: 'prompt'——zcode 无 flag 通道）：
      * appendSystemPrompt 段在前（人设/约束语境——D6 合流后 persona≡skillPath+
@@ -315,11 +312,12 @@ declare function createDefaultZcodeEngine(): ZcodeEngine;
  * 隔离会话库绝对路径（单一构造函数，唯一权威）：
  * `<engineDataDir>/engines/zcode/session-db/db.sqlite`。
  *
- * 选址在池目录之外（不落 `engines/zcode/shared/`——那是 journal 池目录，被
- * `deletePoolNativeState` 覆盖，设计 D1/F11）；journal 路径不变（仍
- * `engines/zcode/shared/journal-<taskId>.jsonl`）。`cleanupExpiredPoolRefs` 会把
- * `engines/<engineId>/` 下每个子目录当池枚举，`session-db/` 中的 `db.sqlite*`
- * 不匹配任何删除条件（池 GC 守卫 = 验收场景 A9）。
+ * 选址在 journal 分组目录之外（不落 `engines/zcode/shared/`——[池抽象降级
+ * 2026-09-13] 后那是 journal 固定分组目录，清理机制 = `cleanupExpiredJournals`
+ * 的 mtime TTL，refs 计数/deletePoolNativeState 已删，设计 D1/F11）；journal
+ * 路径不变（仍 `engines/zcode/shared/journal-<taskId>.jsonl`）。
+ * `cleanupExpiredJournals` 会把 `engines/<engineId>/` 下每个子目录枚举，
+ * `session-db/` 中的 `db.sqlite*` 不匹配任何删除条件（GC 守卫 = 验收场景 A9）。
  *
  * @param engineDataDir 引擎数据目录（`deps.engineDataDir()`；禁硬编码，一律由入参推导）
  */

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { EnginePort, ReverseRequestClock, EngineCapabilities, ProbeReport, EngineAgentCallOpts, RunContext, EngineRunResult, EngineHandle, InteractAction, InteractResult, SessionView } from '@zhushanwen/subagent-engine-sdk';
+import { EnginePort, ReverseRequestClock, EngineCapabilities, ProbeReport, EngineAgentCallOpts, RunContext, EngineRunResult, EngineHandle, SessionView } from '@zhushanwen/subagent-engine-sdk';
 
 /** 出站帧写入面（main.ts 注入 process.stdout；测试注入内存缓冲）。 */
 type FrameWriter = (frame: unknown) => void;
@@ -30,17 +30,16 @@ declare class EngineProtocolServer {
     constructor(opts: EngineProtocolServerOptions);
     /** 入站帧消费（请求帧 + 反向请求应答帧；main.ts 的行解析器拆行后喂入）。 */
     handleFrame(frame: unknown): void;
-    /** 10 正向方法分发（表驱动：method → 处理器；未知方法 → engine_protocol_unknown_method）。 */
+    /** 9 正向方法分发（表驱动：method → 处理器；未知方法 → engine_protocol_unknown_method）。 */
     private dispatch;
     /**
-     * 10 正向方法 → 处理器映射（每个处理器消费原始 params 并自行收敛类型——
+     * 9 正向方法 → 处理器映射（每个处理器消费原始 params 并自行收敛类型——
      * 与原 switch case 表达式一一对应）。
      */
     private readonly methodHandlers;
     private initialize;
     private run;
     private cancel;
-    private interact;
     private read;
     private validateModel;
     private emitEvent;
@@ -111,8 +110,8 @@ declare class ZcodeEngine implements EnginePort {
     /**
      * 常驻路径主编排：模型解析（v2 单源校验）→ 惰性连接 + runTurn（事件时序前移：
      * text_delta 流式、终态后 message_end/turn_end）→ schema 仿真重试 → outcome/handle。
-     * poolKey 固定 'shared'（共享宿主 HOME，无池），onPoolResolved 在 prepare 期、
-     * onHandleReady 在 create 应答后（§3.4 不变量 3）。
+     * onHandleReady 在 create 应答后（§3.4 不变量 3；原 onPoolResolved prepare 期
+     * 声明已随 [池抽象降级 2026-09-13] poolKey 协议面退役删除）。
      */
     private runViaAppServer;
     /** pre-aborted 短路收口：合成中止 outcome + 'shared' 锚定 handle。 */
@@ -214,17 +213,6 @@ declare class ZcodeEngine implements EnginePort {
      * ensureAppServerRuntime 自动重建（与崩溃重建同一代码路径，不变量 4）。
      */
     dispose(): Promise<void>;
-    /**
-     * [u7a D5] 引擎在途只读快照：activeSessions 非空才算在途——poolKey 'shared' 的
-     * app-server **空闲常驻进程恒活，禁止按进程存在判定**（进程在 ≠ 在途，否则推迟
-     * 判定恒真、30min 上限从兜底变常态路径，设计 §3.3 D5 显式排除）。计数权威 =
-     * activeSessions（attempt 入 create 应答后 add / finally settle 后 delete，与
-     * dispose 的 close 帧目标集同一状态源，无双记账）。运行时未初始化（从未 run /
-     * 已 dispose）→ 恒 0。
-     */
-    inFlightSnapshot(): {
-        inFlight: number;
-    };
     /** 终态合成（extension-conventions 函数 80 行上限，从 run 提取）：aborted / run-failed / parsed 三分支。 */
     private finalizeOutcome;
     /** abort 合成终态：exitCode=null（record 正常收尾，不留僵尸）。 */
@@ -237,11 +225,6 @@ declare class ZcodeEngine implements EnginePort {
     private applyRunFailedOutcome;
     /** parsed 合成终态：content/sessionId/usage 落位 + schema 校验分流 + coarse 事件。 */
     private applyParsedOutcome;
-    /**
-     * D1 可选面：zcode 首期不支持 conversation（capabilities 声明）——同步拒绝、
-     * 不创建进程，文案给可操作建议（A11）。
-     */
-    interact(_handle: EngineHandle, _action: InteractAction): Promise<InteractResult>;
     /** [U7] 模型可发现性：v2 桌面登录态聚合（带凭据 provider × models），失败安全返回清单本身可能为空。 */
     listModels(): Array<{
         id: string;
@@ -263,8 +246,12 @@ declare class ZcodeEngine implements EnginePort {
      * sessionId 缺失（解析失败的 run 无法定位 session）跳过①级；②级依赖
      * handle.journalPath（宿主 run 后回填）。dbPath：新 handle 恒为隔离库绝对路径
      * （zcodeSessionDbPath(engineDataDir)，tier1 白名单集合见方法体——宿主路径仅
-     * 「共享 HOME 时代」存量兼容）；旧 records（池时代）的相对路径仍按 poolKey
-     * 锚定解析（read 兼容旧数据，池目录不存在时自然落②级 journal 降级）。
+     * 「共享 HOME 时代」存量兼容）；旧 records（池时代）的相对路径仍按池目录锚定
+     * 解析（read 兼容旧数据，池目录不存在时自然落②级 journal 降级）。[池抽象降级
+     * 2026-09-13] 锚定 key 用常量 SHARED_POOL_KEY 承载——协议面 poolKey 已删，池
+     * 时代真实池 key 不再随 handle 传输；若旧 record 的池目录恰为 shared 布局则①级
+     * 仍可达，其余池 key 的旧 record 直接走②级 journal 降级（30 天 TTL 同尺度衰减，
+     * 行为安全）。
      */
     read(handle: EngineHandle): Promise<SessionView>;
     /**
@@ -287,6 +274,16 @@ declare class ZcodeEngine implements EnginePort {
      * 均不出声（避免噪音）。
      */
     private warnIgnoredCtxModel;
+    /**
+     * [U6 / §3.2.6 要点 3] resume 锚 → 历史前缀（interact-resume 的读半段）。
+     *
+     * 无锚 / 非 zcode 锚形态 → undefined（行为不变）。读通道失败（条目被 TTL 清 /
+     * 会话失效 / 控制面错误）= 宿主侧锚判据通过后、引擎派发前的窄竞态窗——降级为
+     * **无历史前缀的新会话**（warn 留痕；宿主 reopen 摘要承担主降级面），不炸轮：
+     * 续聊消息本身仍可送达（模型缺历史上下文，比整轮失败可用性高，与 reopen 降级
+     * 的「带摘要重开」语义同族）。
+     */
+    private buildResumeHistoryPrefix;
     /**
      * persona 拼接后的完整 prompt（personaInjection: 'prompt'——zcode 无 flag 通道）：
      * appendSystemPrompt 段在前（人设/约束语境——D6 合流后 persona≡skillPath+
@@ -315,11 +312,12 @@ declare function createDefaultZcodeEngine(): ZcodeEngine;
  * 隔离会话库绝对路径（单一构造函数，唯一权威）：
  * `<engineDataDir>/engines/zcode/session-db/db.sqlite`。
  *
- * 选址在池目录之外（不落 `engines/zcode/shared/`——那是 journal 池目录，被
- * `deletePoolNativeState` 覆盖，设计 D1/F11）；journal 路径不变（仍
- * `engines/zcode/shared/journal-<taskId>.jsonl`）。`cleanupExpiredPoolRefs` 会把
- * `engines/<engineId>/` 下每个子目录当池枚举，`session-db/` 中的 `db.sqlite*`
- * 不匹配任何删除条件（池 GC 守卫 = 验收场景 A9）。
+ * 选址在 journal 分组目录之外（不落 `engines/zcode/shared/`——[池抽象降级
+ * 2026-09-13] 后那是 journal 固定分组目录，清理机制 = `cleanupExpiredJournals`
+ * 的 mtime TTL，refs 计数/deletePoolNativeState 已删，设计 D1/F11）；journal
+ * 路径不变（仍 `engines/zcode/shared/journal-<taskId>.jsonl`）。
+ * `cleanupExpiredJournals` 会把 `engines/<engineId>/` 下每个子目录枚举，
+ * `session-db/` 中的 `db.sqlite*` 不匹配任何删除条件（GC 守卫 = 验收场景 A9）。
  *
  * @param engineDataDir 引擎数据目录（`deps.engineDataDir()`；禁硬编码，一律由入参推导）
  */

package/dist/index.js

@@ -10,7 +10,7 @@ import {
   readZcodeSessionView,
   zcodeDbPathAllowlist,
   zcodeSessionDbPath
-} from "./chunk-36VY2TNC.js";
+} from "./chunk-DMHXNYG2.js";
 
 // src/golden-sample.ts
 var ZCODE_APPSERVER_GOLDEN = {