@zhushanwen/zcode-subagent-cli 0.3.1 → 0.4.0

package/dist/index.d.cts

@@ -158,8 +158,7 @@ declare class ZcodeEngine implements EnginePort {
      */
     private awaitConnFinalized;
     /**
-     * D3 abort 链执行体（双入口分岔，P0-1 U2 参数化——设计
-     * timeout-zcode-turn-and-settled-watchdog.md §6 D3 v1.1）：
+     * D3 abort 链执行体（双入口分岔，P0-1 U2 参数化，D3 v1.1）：
      * - **用户取消入口**（`escalateOn: "turn-settled"`，现状语义零改动；fire-and-forget——
      *   与 turn promise 并行推进）：stop 帧（超时 ZCODE_APPSERVER_STOP_TIMEOUT_MS）→
      *   grace 窗口内 turn 落定即止（不杀共享进程）→ 超窗 killChain（conn.shutdown 全序：
@@ -232,10 +231,17 @@ declare class ZcodeEngine implements EnginePort {
     }>;
     /**
      * [u-h2 D2-2] 派发同步期 model 校验：委托 resolveZcodeModelRef（与 run prepare 期
-     * 同一函数——canonicalRef 归一化、短名缺省 provider、凭据与清单校验单一权威，无双实现）。
-     * modelRef undefined = 返回引擎缺省模型 canonical 全名（ZCODE_FALLBACK_DEFAULT_MODEL，
-     * D2-1 ctxModel 不透传的承接面）。校验失败原样抛 ZcodePrepareError，由编排层
+     * 显式路径同一函数——canonicalRef 归一化、短名缺省 provider、凭据与清单校验单一
+     * 权威，无双实现）。校验失败原样抛 ZcodePrepareError，由编排层
      * （engine/model-validation.ts）包装成「引擎与模型不配套」文案。
+     *
+     * [R4/D6-②] 缺席语义：本实现是进程内形态 + 协议诊断面（宿主 cli 形态消费的是
+     * RemoteEngine 的 manifest 本地判定，不经本方法——SDK protocol methods.ts 明示
+     * validateModel 为诊断面）。缺席 modelRef 时返回 ZCODE_FALLBACK_DEFAULT_MODEL
+     * canonical 全名作为「引擎缺省模型」的呈现值（诊断面只读不 create，不参与
+     * create 缺席不携带的 G3 行为链）。帧应答形态维持 {canonicalRef: string}（SDK
+     * port-contract 契约必填——「帧字段缺席」的 optional 对齐需放宽 SDK 契约与
+     * server handler 签名，非本包单方面可完成）。
      */
     validateModel(modelRef: string | undefined): {
         canonicalRef: string;
@@ -266,22 +272,25 @@ declare class ZcodeEngine implements EnginePort {
     private warnThoughtLevelUncommon;
     /**
      * [F16b] ctxModel 忽略留痕：ctxModel 是 pi 链路的第三层兜底（port.ts 契约——
-     * 依赖 pi resolveModel 链的引擎才消费它），zcode 自带 provider 体系与缺省模型
-     * （resolveZcodeModelRef：requested > ZCODE_FALLBACK_DEFAULT_MODEL），不消费
-     * ctxModel。「调用方给了 ctxModel 但 task.model 未显式指定」时出声一行，说明
-     * 实际落引擎缺省模型（含实际 model id）——防静默降档无据可查。只在「ctx 有模型
-     * 但被忽略」场景输出：显式 task.model 走正常解析链、ctx 本就无模型属预期缺省，
-     * 均不出声（避免噪音）。
+     * 依赖 pi resolveModel 链的引擎才消费它），zcode 不消费。「调用方给了 ctxModel 但
+     * task.model 未显式指定」时出声一行。只在「ctx 有模型但被忽略」场景输出：显式
+     * task.model 走正常解析链、ctx 本就无模型属预期缺省，均不出声（避免噪音）。
+     * [R4/G3] 文案更新：缺席 model 时 create 不携带 model 键（缺省模型由 zcode 自身
+     * 解析——用户 defaultModelSelection 优先），不再声称「实际使用引擎缺省模型
+     * <fallback>」（恒传时代的表述，与缺席不携带的新行为不符）。modelRef 参数已随
+     * R4 条件携带移除——warn 可达即缺席态（显式 task.model 在 requested 非空早退处
+     * 返回），无第三形态。
      */
     private warnIgnoredCtxModel;
     /**
      * [U6 / §3.2.6 要点 3] resume 锚 → 历史前缀（interact-resume 的读半段）。
      *
-     * 无锚 / 非 zcode 锚形态 → undefined（行为不变）。读通道失败（条目被 TTL 清 /
-     * 会话失效 / 控制面错误）= 宿主侧锚判据通过后、引擎派发前的窄竞态窗——降级为
-     * **无历史前缀的新会话**（warn 留痕；宿主 reopen 摘要承担主降级面），不炸轮：
-     * 续聊消息本身仍可送达（模型缺历史上下文，比整轮失败可用性高，与 reopen 降级
-     * 的「带摘要重开」语义同族）。
+     * 无锚 / 非 zcode 锚形态 → undefined（行为不变）。读通道失败（会话失效 / 控制
+     * 面错误）= 锚真失效的权威信号——宿主侧库投影预检查已退役（app-server 落库滞后
+     * 于 create 应答，分钟级窗 + 部分行永不落库，预检查系统性误判；resume 走
+     * app-server resident 内存态才是真实活性判据），因此此处不再静默降级为无前缀
+     * 裸跑，而是返回锚失效声明段：让模型知情「延续但无历史」，基于最新消息独立
+     * 续推，而非在缺上下文时臆测连续性。用户消息照常执行，不炸轮。
      */
     private buildResumeHistoryPrefix;
     /**
@@ -303,7 +312,7 @@ declare function defaultEngineDataDir(): string;
 /** 构造 ZcodeEngine（DI 工厂——测试/宿主注入 deps）。 */
 declare function createZcodeEngine(deps: ZcodeEngineDeps): ZcodeEngine;
 /**
- * 缺省 deps 组合：engineDataDir 走 env 解析，cliPath 支持 XYZ_ZCODE_CLI 覆盖
+ * 缺省 deps 组合：engineDataDir 走 env 解析，cliPath 支持 TAIJI_ZCODE_CLI 覆盖
  * （spawn-env-contract 出站白名单既有条目，随包迁移锚点改指本包——W12 回写项）。
  */
 declare function createDefaultZcodeEngine(): ZcodeEngine;

package/dist/index.d.ts

@@ -158,8 +158,7 @@ declare class ZcodeEngine implements EnginePort {
      */
     private awaitConnFinalized;
     /**
-     * D3 abort 链执行体（双入口分岔，P0-1 U2 参数化——设计
-     * timeout-zcode-turn-and-settled-watchdog.md §6 D3 v1.1）：
+     * D3 abort 链执行体（双入口分岔，P0-1 U2 参数化，D3 v1.1）：
      * - **用户取消入口**（`escalateOn: "turn-settled"`，现状语义零改动；fire-and-forget——
      *   与 turn promise 并行推进）：stop 帧（超时 ZCODE_APPSERVER_STOP_TIMEOUT_MS）→
      *   grace 窗口内 turn 落定即止（不杀共享进程）→ 超窗 killChain（conn.shutdown 全序：
@@ -232,10 +231,17 @@ declare class ZcodeEngine implements EnginePort {
     }>;
     /**
      * [u-h2 D2-2] 派发同步期 model 校验：委托 resolveZcodeModelRef（与 run prepare 期
-     * 同一函数——canonicalRef 归一化、短名缺省 provider、凭据与清单校验单一权威，无双实现）。
-     * modelRef undefined = 返回引擎缺省模型 canonical 全名（ZCODE_FALLBACK_DEFAULT_MODEL，
-     * D2-1 ctxModel 不透传的承接面）。校验失败原样抛 ZcodePrepareError，由编排层
+     * 显式路径同一函数——canonicalRef 归一化、短名缺省 provider、凭据与清单校验单一
+     * 权威，无双实现）。校验失败原样抛 ZcodePrepareError，由编排层
      * （engine/model-validation.ts）包装成「引擎与模型不配套」文案。
+     *
+     * [R4/D6-②] 缺席语义：本实现是进程内形态 + 协议诊断面（宿主 cli 形态消费的是
+     * RemoteEngine 的 manifest 本地判定，不经本方法——SDK protocol methods.ts 明示
+     * validateModel 为诊断面）。缺席 modelRef 时返回 ZCODE_FALLBACK_DEFAULT_MODEL
+     * canonical 全名作为「引擎缺省模型」的呈现值（诊断面只读不 create，不参与
+     * create 缺席不携带的 G3 行为链）。帧应答形态维持 {canonicalRef: string}（SDK
+     * port-contract 契约必填——「帧字段缺席」的 optional 对齐需放宽 SDK 契约与
+     * server handler 签名，非本包单方面可完成）。
      */
     validateModel(modelRef: string | undefined): {
         canonicalRef: string;
@@ -266,22 +272,25 @@ declare class ZcodeEngine implements EnginePort {
     private warnThoughtLevelUncommon;
     /**
      * [F16b] ctxModel 忽略留痕：ctxModel 是 pi 链路的第三层兜底（port.ts 契约——
-     * 依赖 pi resolveModel 链的引擎才消费它），zcode 自带 provider 体系与缺省模型
-     * （resolveZcodeModelRef：requested > ZCODE_FALLBACK_DEFAULT_MODEL），不消费
-     * ctxModel。「调用方给了 ctxModel 但 task.model 未显式指定」时出声一行，说明
-     * 实际落引擎缺省模型（含实际 model id）——防静默降档无据可查。只在「ctx 有模型
-     * 但被忽略」场景输出：显式 task.model 走正常解析链、ctx 本就无模型属预期缺省，
-     * 均不出声（避免噪音）。
+     * 依赖 pi resolveModel 链的引擎才消费它），zcode 不消费。「调用方给了 ctxModel 但
+     * task.model 未显式指定」时出声一行。只在「ctx 有模型但被忽略」场景输出：显式
+     * task.model 走正常解析链、ctx 本就无模型属预期缺省，均不出声（避免噪音）。
+     * [R4/G3] 文案更新：缺席 model 时 create 不携带 model 键（缺省模型由 zcode 自身
+     * 解析——用户 defaultModelSelection 优先），不再声称「实际使用引擎缺省模型
+     * <fallback>」（恒传时代的表述，与缺席不携带的新行为不符）。modelRef 参数已随
+     * R4 条件携带移除——warn 可达即缺席态（显式 task.model 在 requested 非空早退处
+     * 返回），无第三形态。
      */
     private warnIgnoredCtxModel;
     /**
      * [U6 / §3.2.6 要点 3] resume 锚 → 历史前缀（interact-resume 的读半段）。
      *
-     * 无锚 / 非 zcode 锚形态 → undefined（行为不变）。读通道失败（条目被 TTL 清 /
-     * 会话失效 / 控制面错误）= 宿主侧锚判据通过后、引擎派发前的窄竞态窗——降级为
-     * **无历史前缀的新会话**（warn 留痕；宿主 reopen 摘要承担主降级面），不炸轮：
-     * 续聊消息本身仍可送达（模型缺历史上下文，比整轮失败可用性高，与 reopen 降级
-     * 的「带摘要重开」语义同族）。
+     * 无锚 / 非 zcode 锚形态 → undefined（行为不变）。读通道失败（会话失效 / 控制
+     * 面错误）= 锚真失效的权威信号——宿主侧库投影预检查已退役（app-server 落库滞后
+     * 于 create 应答，分钟级窗 + 部分行永不落库，预检查系统性误判；resume 走
+     * app-server resident 内存态才是真实活性判据），因此此处不再静默降级为无前缀
+     * 裸跑，而是返回锚失效声明段：让模型知情「延续但无历史」，基于最新消息独立
+     * 续推，而非在缺上下文时臆测连续性。用户消息照常执行，不炸轮。
      */
     private buildResumeHistoryPrefix;
     /**
@@ -303,7 +312,7 @@ declare function defaultEngineDataDir(): string;
 /** 构造 ZcodeEngine（DI 工厂——测试/宿主注入 deps）。 */
 declare function createZcodeEngine(deps: ZcodeEngineDeps): ZcodeEngine;
 /**
- * 缺省 deps 组合：engineDataDir 走 env 解析，cliPath 支持 XYZ_ZCODE_CLI 覆盖
+ * 缺省 deps 组合：engineDataDir 走 env 解析，cliPath 支持 TAIJI_ZCODE_CLI 覆盖
  * （spawn-env-contract 出站白名单既有条目，随包迁移锚点改指本包——W12 回写项）。
  */
 declare function createDefaultZcodeEngine(): ZcodeEngine;

package/dist/index.js

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