@zhushanwen/zcode-subagent-cli 0.3.1 → 0.4.0

package/dist/{chunk-I5OX22FU.js → chunk-U56IBQ47.js}

@@ -4,7 +4,6 @@ var ZCODE_ADAPTER_VERSION = "2.0.0";
 var ZCODE_CLI_DEFAULT_PATH = "/Applications/ZCode.app/Contents/Resources/glm/zcode.cjs";
 var ZCODE_V2_CONFIG_PATH_SUFFIX = [".zcode", "v2", "config.json"];
 var ZCODE_FALLBACK_DEFAULT_MODEL = "builtin:bigmodel-coding-plan/GLM-5.3";
-var ZCODE_HOST_DB_SUFFIX = [".zcode", "cli", "db", "db.sqlite"];
 var ZCODE_KILL_GRACE_MS = 5e3;
 var ZCODE_ERROR_TAIL_CHARS = 2e3;
 var ZCODE_APPSERVER_REQUEST_TIMEOUT_MS = 15e3;
@@ -12,8 +11,8 @@ var ZCODE_APPSERVER_STDERR_TAIL_CHARS = 400;
 var ZCODE_APPSERVER_STDERR_TAIL_BUFFER_CHARS = 2048;
 var ZCODE_APPSERVER_TURN_READ_TIMEOUT_MS = 5e3;
 var ZCODE_APPSERVER_TURN_CLOSE_TIMEOUT_MS = 1500;
-var ZCODE_TURN_IDLE_TIMEOUT_ENV = "XYZ_ZCODE_TURN_IDLE_TIMEOUT_MS";
-var ZCODE_TURN_MAX_TIMEOUT_ENV = "XYZ_ZCODE_TURN_MAX_TIMEOUT_MS";
+var ZCODE_TURN_IDLE_TIMEOUT_ENV = "TAIJI_ZCODE_TURN_IDLE_TIMEOUT_MS";
+var ZCODE_TURN_MAX_TIMEOUT_ENV = "TAIJI_ZCODE_TURN_MAX_TIMEOUT_MS";
 var ZCODE_TURN_IDLE_TIMEOUT_MS = 18e5;
 var ZCODE_TURN_MAX_TIMEOUT_MS = 36e5;
 function parseZcodeTurnTimeoutEnv(raw) {
@@ -24,6 +23,14 @@ function parseZcodeTurnTimeoutEnv(raw) {
 }
 var ZCODE_APPSERVER_STOP_TIMEOUT_MS = 3e3;
 var ZCODE_APPSERVER_ABORT_GRACE_MS = 3e3;
+var ZCODE_APPSERVER_STOP_TIMEOUT_ENV = "TAIJI_ZCODE_TEST_STOP_TIMEOUT_MS";
+var ZCODE_APPSERVER_ABORT_GRACE_ENV = "TAIJI_ZCODE_TEST_ABORT_GRACE_MS";
+function parseZcodePositiveMsEnv(raw) {
+  if (raw === void 0 || raw === "") return { state: "unset" };
+  const parsed = Number(raw);
+  if (!Number.isFinite(parsed) || parsed <= 0) return { state: "invalid" };
+  return { state: "valid", ms: parsed };
+}
 var ZCODE_APPSERVER_ERR_MODEL_CONFIG_MISSING = -32603;
 var ZCODE_APPSERVER_ERR_BUSY_SESSION = -32010;
 var ZCODE_APPSERVER_HARVEST_GRACE_MS = 1e3;
@@ -37,8 +44,12 @@ var ZCODE_SESSION_SWEEP_DEFER_MS = 50;
 // src/db-path.ts
 import * as os from "os";
 import * as path from "path";
+import {
+  ZCODE_HOST_DB_SUFFIX,
+  ZCODE_ISOLATED_DB_SEGMENTS
+} from "@zhushanwen/subagent-engine-sdk";
 function zcodeSessionDbPath(engineDataDir) {
-  return path.join(engineDataDir, "engines", "zcode", "session-db", "db.sqlite");
+  return path.join(engineDataDir, ...ZCODE_ISOLATED_DB_SEGMENTS);
 }
 function hostZcodeDbPath() {
   return path.join(os.homedir(), ...ZCODE_HOST_DB_SUFFIX);
@@ -90,26 +101,40 @@ function usageFromStepFinish(part) {
     cacheWrite: finiteOr(cache.write, 0)
   };
 }
-function toolFromPart(part) {
-  const toolName = typeof part.tool === "string" ? part.tool : "unknown";
-  let state;
+function stateFromString(raw) {
+  try {
+    const v = JSON.parse(raw);
+    return typeof v === "object" && v !== null && !Array.isArray(v) ? v : void 0;
+  } catch {
+    return void 0;
+  }
+}
+function stateFromPart(part) {
+  if (typeof part.state === "object" && part.state !== null && !Array.isArray(part.state)) {
+    return part.state;
+  }
   if (typeof part.state === "string") {
-    try {
-      const v = JSON.parse(part.state);
-      state = typeof v === "object" && v !== null ? v : void 0;
-    } catch {
-      state = void 0;
-    }
+    return stateFromString(part.state);
   }
+  return void 0;
+}
+function toolResultFromOutput(errorText, output) {
+  if (errorText !== void 0) return { content: [errorText] };
+  if (typeof output === "string") return { content: [output] };
+  if (typeof output === "object" && output !== null) return { details: output };
+  return void 0;
+}
+function toolFromPart(part) {
+  const toolName = typeof part.tool === "string" ? part.tool : "unknown";
+  const state = stateFromPart(part);
   const status = typeof state?.status === "string" ? state.status : "unknown";
   const output = state?.output;
+  const errorText = status !== "completed" && typeof state?.error === "string" ? state.error : void 0;
+  const result = toolResultFromOutput(errorText, output);
   return {
     toolName,
     ...state?.input !== void 0 ? { args: state.input } : {},
-    // 输出形态（实测）：string（内容）或 object（结构化）——分别映射到 pi ToolCallResult
-    // 的 content[] / details，不发明第二形状
-    ...typeof output === "string" ? { result: { content: [output] } } : {},
-    ...typeof output === "object" && output !== null ? { result: { details: output } } : {},
+    ...result !== void 0 ? { result } : {},
     ...status !== "completed" ? { isError: true } : {}
   };
 }
@@ -573,8 +598,63 @@ if (text !== null) {
   };
 }
 
-// \u4EE5\u539F argv \u5F62\u6001\u542F\u52A8 zcode.cjs\uFF08argv[0]=node, argv[1]=\u672C wrapper\uFF0Cargv[2]=app-server\u2014\u2014
-// zcode.cjs \u7684 includes('app-server') \u5224\u5B9A\u4E0D\u53D7\u5F71\u54CD\uFF09\u3002import() \u517C\u5BB9 CJS/ESM \u5165\u53E3\u3002
+// \u5185\u5EFA provider \u914D\u7F6E\u5B9A\u4F4D\uFF08\u6F02\u79FB\u9762\u2461\uFF09\uFF1A3.12.x \u8D77\u914D\u7F6E\u6587\u4EF6\u632A\u4F4D + CLI \u4F9D\u8D56\u5BBF\u4E3B\u6CE8\u5165
+// ZCODE_BUILTIN_PROVIDER_CONFIG_FILE \u76F4\u63A5\u5B9A\u4F4D\uFF1BZCode \u684C\u9762 spawn \u94FE\u81EA\u5E26\u8BE5\u952E\uFF0C
+// \u672C wrapper \u94FE\u9700\u81EA\u7ED9\u3002\u663E\u5F0F\u4F20\u5165\u4F18\u5148 \u2192 v2 runtime \u76EE\u5F55\u4E0B\u5E73\u53F0\u76EE\u5F55\uFF08\u7CBE\u786E
+// <plat>-<arch> \u4F18\u5148\uFF0CRust arch \u53D8\u4F53\u5982 darwin-aarch64 \u5B57\u5178\u5E8F\u8DDF\u540E\uFF09\xD7 \u7248\u672C\u76EE\u5F55
+// \uFF08semver \u6700\u5927\uFF09\u7684 endpoint-*/zcode-builtin.json \u2192 \u90FD\u627E\u4E0D\u5230\u5219\u4E0D\u8BBE\u952E\uFF0C\u8BA9 CLI
+// \u539F\u751F\u62A5\u9519\u900F\u51FA\uFF08\u9519\u8BEF\u6587\u6848\u542B\u6062\u590D\u6307\u5F15\uFF09\u3002
+if (!process.env.ZCODE_BUILTIN_PROVIDER_CONFIG_FILE) {
+  let located = null;
+  try {
+    const providerRoot = path.join(os.homedir(), '.zcode', 'v2', 'runtime', 'provider');
+    // \u5E73\u53F0\u76EE\u5F55\u53CC\u547D\u540D\uFF1ANode \u5F62\u6001 <plat>-<arch>\uFF08darwin-arm64\uFF09\u4E0E\u684C\u9762 app \u7684 Rust
+    // arch \u547D\u540D\uFF08darwin-aarch64/linux-x86_64\uFF09\u5E76\u5B58\u2014\u2014\u6309\u5E73\u53F0\u524D\u7F00\u6536\u96C6\u5B50\u76EE\u5F55\uFF0C
+    // \u7CBE\u786E\u5F62\u6001\u6392\u6700\u5148\uFF08\u5411\u540E\u517C\u5BB9\u81EA\u5EFA\u5E03\u5C40\uFF09\uFF0CRust \u53D8\u4F53\u6309\u5B57\u5178\u5E8F\u8DDF\u540E\u9010\u4E2A\u5C1D\u8BD5
+    const exact = process.platform + '-' + process.arch;
+    const platDirs = fs.readdirSync(providerRoot, { withFileTypes: true })
+      .filter((d) => d.isDirectory() && d.name.startsWith(process.platform + '-'))
+      .map((d) => d.name)
+      .sort((a, b) => {
+        if ((a === exact) !== (b === exact)) return a === exact ? -1 : 1;
+        return a < b ? -1 : a > b ? 1 : 0;
+      });
+    const byVerDesc = (a, b) => {
+      const pa = a.split('.'), pb = b.split('.');
+      for (let i = 0; i < 3; i++) {
+        const na = parseInt(pa[i], 10) || 0, nb = parseInt(pb[i], 10) || 0;
+        if (na !== nb) return nb - na;
+      }
+      return 0;
+    };
+    for (const plat of platDirs) {
+      const rtRoot = path.join(providerRoot, plat);
+      let vers = [];
+      try { vers = fs.readdirSync(rtRoot).filter((v) => /^\\d+\\.\\d+/.test(v)).sort(byVerDesc); } catch { /* \u5E73\u53F0\u76EE\u5F55\u4E0D\u53EF\u8BFB \u2192 \u8BD5\u4E0B\u4E00\u4E2A */ }
+      for (const ver of vers) {
+        const verDir = path.join(rtRoot, ver);
+        let endpoints = [];
+        try { endpoints = fs.readdirSync(verDir).filter((e) => e.startsWith('endpoint-')).sort(); } catch { /* \u7248\u672C\u76EE\u5F55\u4E0D\u53EF\u8BFB \u2192 \u8DF3\u8FC7 */ }
+        for (const ep of endpoints) {
+          const candidate = path.join(verDir, ep, 'zcode-builtin.json');
+          if (fs.existsSync(candidate)) { located = candidate; break; }
+        }
+        if (located) break;
+      }
+      if (located) break;
+    }
+  } catch { /* provider \u76EE\u5F55\u7F3A\u5931/\u4E0D\u53EF\u8BFB \u2192 \u4E0D\u8BBE\u952E */ }
+  if (located) process.env.ZCODE_BUILTIN_PROVIDER_CONFIG_FILE = located;
+}
+
+// \u4E0A\u6E38 provider bootstrap \u4EE5 argv[1] \u4E3A\u5165\u53E3\u951A\uFF0C\u4ECE\u8BE5\u8DEF\u5F84\u90BB\u8FD1\u5B9A\u4F4D CLI \u5185\u5EFA
+// provider \u914D\u7F6E\u2014\u2014wrapper \u5F62\u6001\u4E0B argv[1] = \u672C wrapper \u843D\u76D8\u8DEF\u5F84\uFF0Cbootstrap \u4F1A\u5728
+// wrapper \u90BB\u57DF\u627E provider \u914D\u7F6E\u800C\u5931\u8D25\uFF08\u771F\u673A\u62A5\u300C\u65E0\u6CD5\u5B9A\u4F4D CLI ZCode Built-in Provider
+// Config\u300D\u542F\u52A8\u5373\u9000\uFF09\u3002import \u524D\u628A argv[1] \u6539\u5199\u4E3A CLI_PATH\uFF1ACLI \u770B\u5230\u7684 argv \u5E8F\u5217\u4E0E
+// \u65E0 wrapper \u76F4\u8DD1\uFF08node <cliPath> app-server ...\uFF09\u9010\u4F4D\u4E00\u81F4\uFF0Cargv[0]=node\u3001
+// argv[2]='app-server' \u4E0D\u53D8\uFF0Cincludes('app-server') \u5B50\u547D\u4EE4\u5224\u5B9A\u4E0D\u53D7\u5F71\u54CD\u3002
+// import() \u517C\u5BB9 CJS/ESM \u5165\u53E3\u3002
+process.argv[1] = CLI_PATH;
 import(CLI_PATH).catch((err) => {
   process.stderr.write('[zcode-launcher] zcode.cjs \u52A0\u8F7D\u5931\u8D25: ' + (err && err.message || err) + '\\n');
   process.exit(3);
@@ -846,10 +926,10 @@ var AppServerConnection = class {
       command: this.nodeBin,
       args: [script, "app-server", "--cwd", this.cwd],
       env: buildEngineChildEnv(this.env, {
-        // L0 XYZ_AGENT_DATA_DIR 缺省链：显式传参 > 宿主注入 env > tmpdir 占位
+        // L0 TAIJI_AGENT_DATA_DIR 缺省链：显式传参 > 宿主注入 env > tmpdir 占位
         //（app-server 不消费该键，占位仅满足 L0 必注入契约；生产调用方
         // zcode-engine.ensureAppServerRuntime 恒传 engineDataDir）。
-        dataDir: this.dataDir ?? process.env["XYZ_AGENT_DATA_DIR"] ?? tmpdir(),
+        dataDir: this.dataDir ?? process.env["TAIJI_AGENT_DATA_DIR"] ?? tmpdir(),
         envPrefixes: ["ZCODE_"]
       }),
       stdout: "pipe",
@@ -1345,7 +1425,8 @@ var SessionChannel = class {
    * session/resume 读通道（[U6 / §3.2.6 要点 3，P-1 探针实证]）：应答自带完整
    * 双向 messages 历史（user/assistant 全量、tokens、parts）——zcode 续聊选型的
    * 历史来源（读通道成立；原地 resume 续写被 -32031 卡死，写通道不可用）。错误
-   * 原样上抛（调用方决定降级形态——引擎侧 warn 后无历史前缀开新会话）。
+   * 原样上抛（调用方决定降级形态——引擎侧 warn 后注入锚失效声明段继续执行，
+   * run 不失败，[U3]）。
    * 经 conn.request 惰性启动连接（resume 是 run 的**首个**请求——调用时点连接
    * 可能尚未启动，与 readBestEffort 的「已死跳过」判据不同场景，不做 alive 守卫）。
    */
@@ -1893,8 +1974,9 @@ var ZcodeEngine = class {
       personaInjection: "prompt",
       // app-server 推送流实时流出（session/event payload.delta → text_delta）
       eventGranularity: "stream",
-      // 首期未接 worktree 隔离（公共层 worktree-manager 接入后升 emulated）
-      sandbox: "none",
+      // 无 OS sandbox；worktree 隔离由公共层 worktree-manager 承担（引擎侧仅消费
+      // task.cwd → session/create 的 workspacePath）= emulated（pi 同款声明语义）
+      sandbox: "emulated",
       // sqlite 三级 JOIN 完整重建 turns（reader 实测）
       sessionRead: "full",
       // --resume 冷启动可用（实测）
@@ -1978,8 +2060,9 @@ var ZcodeEngine = class {
     if (ctx.signal?.aborted === true) {
       return this.abortedAppServerRun(task, ctx, startedAt);
     }
-    const modelRef = resolveZcodeModelRef(task.model, this.deps.sources);
-    this.warnIgnoredCtxModel(task, ctx, modelRef);
+    const requestedModel = task.model?.trim();
+    const modelRef = requestedModel !== void 0 && requestedModel !== "" ? resolveZcodeModelRef(requestedModel, this.deps.sources) : void 0;
+    this.warnIgnoredCtxModel(task, ctx);
     this.warnThoughtLevelUncommon(task, ctx);
     const cwd = task.cwd ?? process.cwd();
     const schema = isPlainObject(task.schema) ? task.schema : void 0;
@@ -2080,8 +2163,7 @@ var ZcodeEngine = class {
    */
   async attemptAppServerTurn(task, ctx, modelRef, cwd, prompt, opts = {}) {
     const rt = this.ensureAppServerRuntime();
-    const { providerId, modelId } = splitZcodeModelRef(modelRef);
-    const createParams = buildAppServerCreateParams(task, providerId, modelId, cwd);
+    const createParams = buildAppServerCreateParams(task, modelRef, cwd);
     let currentSessionId;
     let signalSessionCreated;
     const sessionCreated = new Promise((resolve2) => {
@@ -2164,8 +2246,7 @@ var ZcodeEngine = class {
     });
   }
   /**
-   * 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 全序：
@@ -2190,7 +2271,7 @@ var ZcodeEngine = class {
           () => true,
           () => true
         ),
-        delayResolved(ZCODE_APPSERVER_ABORT_GRACE_MS, false)
+        delayResolved(abortGraceMs(), false)
       ]);
       if (settled) return "settled-in-grace";
       logger4.warn(
@@ -2202,7 +2283,7 @@ var ZcodeEngine = class {
     };
     let sessionId = getSessionId();
     if (sessionId === void 0) {
-      await Promise.race([sessionCreated, delayResolved(ZCODE_APPSERVER_STOP_TIMEOUT_MS, void 0)]);
+      await Promise.race([sessionCreated, delayResolved(stopTimeoutMs(), void 0)]);
       sessionId = getSessionId();
       if (sessionId === void 0) {
         if (entry.escalateOn === "stop-outcome") return "no-session";
@@ -2214,7 +2295,7 @@ var ZcodeEngine = class {
       return graceRaceThenKill();
     }
     try {
-      await rt.conn.request("session/stop", { sessionId }, { timeoutMs: ZCODE_APPSERVER_STOP_TIMEOUT_MS });
+      await rt.conn.request("session/stop", { sessionId }, { timeoutMs: stopTimeoutMs() });
     } catch (err) {
       if (entry.escalateOn === "stop-outcome") {
         if (isAppServerRpcError(err)) {
@@ -2403,10 +2484,17 @@ var ZcodeEngine = class {
   }
   /**
    * [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) {
     return { canonicalRef: resolveZcodeModelRef(modelRef, this.deps.sources) };
@@ -2490,30 +2578,33 @@ var ZcodeEngine = class {
   }
   /**
    * [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 非空早退处
+   * 返回），无第三形态。
    */
-  warnIgnoredCtxModel(task, ctx, modelRef) {
+  warnIgnoredCtxModel(task, ctx) {
     if (ctx.ctxModel === void 0) return;
     const requested = task.model?.trim();
     if (requested !== void 0 && requested !== "") return;
     logger4.warn(
-      `[zcode-engine] ctx.ctxModel\uFF08${ctx.ctxModel.id}\uFF09\u88AB\u5FFD\u7565\u2014\u2014ctxModel \u662F pi \u94FE\u8DEF\u515C\u5E95\uFF0Czcode \u4E0D\u6D88\u8D39\uFF1Btask.model \u672A\u663E\u5F0F\u6307\u5B9A\uFF0C\u5B9E\u9645\u4F7F\u7528\u5F15\u64CE\u7F3A\u7701\u6A21\u578B ${modelRef}`,
+      `[zcode-engine] ctx.ctxModel\uFF08${ctx.ctxModel.id}\uFF09\u88AB\u5FFD\u7565\u2014\u2014ctxModel \u662F pi \u94FE\u8DEF\u515C\u5E95\uFF0Czcode \u4E0D\u6D88\u8D39\uFF1Btask.model \u672A\u663E\u5F0F\u6307\u5B9A\uFF0Ccreate \u4E0D\u643A\u5E26 model \u952E\uFF0C\u7F3A\u7701\u6A21\u578B\u7531 zcode \u81EA\u8EAB\u89E3\u6790\uFF08\u7528\u6237 defaultModelSelection \u4F18\u5148\uFF09`,
       { taskId: ctx.taskId }
     );
   }
   /**
    * [U6 / §3.2.6 要点 3] resume 锚 → 历史前缀（interact-resume 的读半段）。
    *
-   * 无锚 / 非 zcode 锚形态 → undefined（行为不变）。读通道失败（条目被 TTL 清 /
-   * 会话失效 / 控制面错误）= 宿主侧锚判据通过后、引擎派发前的窄竞态窗——降级为
-   * **无历史前缀的新会话**（warn 留痕；宿主 reopen 摘要承担主降级面），不炸轮：
-   * 续聊消息本身仍可送达（模型缺历史上下文，比整轮失败可用性高，与 reopen 降级
-   * 的「带摘要重开」语义同族）。
+   * 无锚 / 非 zcode 锚形态 → undefined（行为不变）。读通道失败（会话失效 / 控制
+   * 面错误）= 锚真失效的权威信号——宿主侧库投影预检查已退役（app-server 落库滞后
+   * 于 create 应答，分钟级窗 + 部分行永不落库，预检查系统性误判；resume 走
+   * app-server resident 内存态才是真实活性判据），因此此处不再静默降级为无前缀
+   * 裸跑，而是返回锚失效声明段：让模型知情「延续但无历史」，基于最新消息独立
+   * 续推，而非在缺上下文时臆测连续性。用户消息照常执行，不炸轮。
    */
   async buildResumeHistoryPrefix(ctx) {
     const anchor = zcodeResumeAnchorOf(ctx, this.deps.engineDataDir());
@@ -2527,10 +2618,10 @@ var ZcodeEngine = class {
       tokens = extractResumeTotalTokens(result);
     } catch (err) {
       logger4.warn(
-        `[zcode-engine] session/resume \u8BFB\u5386\u53F2\u5931\u8D25\uFF08\u951A ${anchor.sessionId}\uFF09\u2014\u2014\u964D\u7EA7\u4E3A\u65E0\u5386\u53F2\u524D\u7F00\u7684\u65B0\u4F1A\u8BDD: ${errMessage3(err)}`,
+        `[zcode-engine] session/resume \u8BFB\u5386\u53F2\u5931\u8D25\uFF08\u951A ${anchor.sessionId}\uFF09\u2014\u2014\u5224\u5B9A\u951A\u771F\u5931\u6548\uFF0C\u6CE8\u5165\u951A\u5931\u6548\u58F0\u660E\u6BB5\u7EE7\u7EED\u6267\u884C: ${errMessage3(err)}`,
         { taskId: ctx.taskId }
       );
-      return void 0;
+      return buildResumeUnavailableNoticeSegment();
     }
     if (history.length === 0) return void 0;
     return buildResumeInjectionSegment(history, anchor.sessionId, tokens);
@@ -2580,6 +2671,9 @@ ${omissionNote}${kept.join("\n")}
 
 `;
 }
+function buildResumeUnavailableNoticeSegment() {
+  return "[\u4F1A\u8BDD\u5EF6\u7EED\u63D0\u793A] \u672C\u6D88\u606F\u662F\u540C\u4E00\u4EFB\u52A1\u7684\u5EF6\u7EED\u4F1A\u8BDD\uFF0C\u4F46\u4E0A\u4E00\u4F1A\u8BDD\u7684\u5386\u53F2\u8BB0\u5F55\u4E0D\u53EF\u6062\u590D\uFF08\u539F\u59CB\u4F1A\u8BDD\u5DF2\u5931\u6548\uFF09\u3002\n\u6CA1\u6709\u66F4\u65E9\u7684\u5BF9\u8BDD\u4E0A\u4E0B\u6587\u53EF\u5F15\u7528\u2014\u2014\u8BF7\u57FA\u4E8E\u4E0B\u65B9\u6700\u65B0\u6D88\u606F\u72EC\u7ACB\u5224\u65AD\u5E76\u7EE7\u7EED\u63A8\u8FDB\u4EFB\u52A1\u3002\n\n";
+}
 var ZCODE_TURN_RETRY_MIN_BUDGET_MS = 3e5;
 function resolveTransientRetryBudget(totalBudgetMs, consumedMs) {
   if (totalBudgetMs === void 0) return { state: "unbounded" };
@@ -2596,6 +2690,31 @@ function isPlainObject(v) {
 function errMessage3(err) {
   return toErrorMessage(err);
 }
+function resolveAppserverTimingMs(envName, fallbackMs, label) {
+  const raw = process.env[envName];
+  const parsed = parseZcodePositiveMsEnv(raw);
+  if (parsed.state === "valid") return parsed.ms;
+  if (parsed.state === "invalid") {
+    logger4.warn(
+      `[zcode-engine] ${envName}="${raw}" \u975E\u6CD5\uFF08\u5E94\u4E3A\u6B63\u6BEB\u79D2\u6570\u5B57\uFF09\u2014\u2014\u56DE\u843D\u9ED8\u8BA4 ${fallbackMs}ms\uFF08${label}\uFF09`
+    );
+  }
+  return fallbackMs;
+}
+function stopTimeoutMs() {
+  return resolveAppserverTimingMs(
+    ZCODE_APPSERVER_STOP_TIMEOUT_ENV,
+    ZCODE_APPSERVER_STOP_TIMEOUT_MS,
+    "stop \u63A7\u5236\u9762\u8D85\u65F6"
+  );
+}
+function abortGraceMs() {
+  return resolveAppserverTimingMs(
+    ZCODE_APPSERVER_ABORT_GRACE_ENV,
+    ZCODE_APPSERVER_ABORT_GRACE_MS,
+    "abort grace \u7A97\u53E3"
+  );
+}
 function delayResolved(ms, value) {
   return new Promise((resolve2) => {
     const t = setTimeout(() => resolve2(value), ms);
@@ -2610,7 +2729,7 @@ function abortedAppServerAttempt(ctx) {
   return {
     kind: "aborted",
     output: syntheticAppServerOutput(null),
-    abortMessage: `engine_run_failed: zcode \u4EFB\u52A1\u88AB\u4E2D\u6B62\uFF08app-server abort \u94FE\uFF1Asession/stop \u2192 ${ZCODE_APPSERVER_ABORT_GRACE_MS}ms grace \u786E\u8BA4 \u2192 \u8D85\u65F6 killChain SIGTERM\u2192${ZCODE_KILL_GRACE_MS}ms\u2192SIGKILL \u6536\u5272\u5171\u4EAB\u8FDB\u7A0B\uFF0C\u5728\u9014\u4EFB\u52A1\u8D70\u5D29\u6E83\u8DEF\u5F84\uFF09\u3002`
+    abortMessage: `engine_run_failed: zcode \u4EFB\u52A1\u88AB\u4E2D\u6B62\uFF08app-server abort \u94FE\uFF1Asession/stop \u2192 ${abortGraceMs()}ms grace \u786E\u8BA4 \u2192 \u8D85\u65F6 killChain SIGTERM\u2192${ZCODE_KILL_GRACE_MS}ms\u2192SIGKILL \u6536\u5272\u5171\u4EAB\u8FDB\u7A0B\uFF0C\u5728\u9014\u4EFB\u52A1\u8D70\u5D29\u6E83\u8DEF\u5F84\uFF09\u3002`
   };
 }
 function turnResultToPayload(r) {
@@ -2651,15 +2770,16 @@ function appendSchemaRetryDirective(basePrompt, validationError) {
 Your previous answer failed schema validation: ${validationError}
 Answer again. Output ONLY the JSON value conforming to the schema above \u2014 no prose, no markdown fences, no extra text.`;
 }
-function buildAppServerCreateParams(task, providerId, modelId, cwd) {
+function buildAppServerCreateParams(task, modelRef, cwd) {
   const denyTools = (task.denyTools ?? []).filter((t) => typeof t === "string" && t.trim() !== "");
   const thoughtLevel = task.thinkingLevel?.trim();
+  const model = modelRef !== void 0 && modelRef !== "" ? splitZcodeModelRef(modelRef) : void 0;
   return {
     workspacePath: cwd,
     mode: "yolo",
-    // per-session model（G3）：create 参数透传（A.2 ① strict 对象）——同进程任务
-    // 各用各的模型，互不干扰
-    model: { providerId, modelId },
+    // per-session model（G3）：显式指定时 create 参数透传（A.2 ① strict 对象）——同进程任务
+    // 各用各的模型，互不干扰；缺席不设键（zcode 自身缺省解析）
+    ...model !== void 0 ? { model } : {},
     ...thoughtLevel !== void 0 && thoughtLevel !== "" ? { thoughtLevel } : {},
     ...denyTools.length > 0 ? { toolDenylist: denyTools } : {}
   };
@@ -2792,7 +2912,7 @@ function createZcodeEngine(deps) {
 function createDefaultZcodeEngine() {
   return createZcodeEngine({
     engineDataDir: defaultEngineDataDir,
-    ...process.env["XYZ_ZCODE_CLI"] !== void 0 ? { cliPath: process.env["XYZ_ZCODE_CLI"] } : {}
+    ...process.env["TAIJI_ZCODE_CLI"] !== void 0 ? { cliPath: process.env["TAIJI_ZCODE_CLI"] } : {}
   });
 }
 
@@ -2915,7 +3035,11 @@ var EngineProtocolServer = class {
     const controller = new AbortController();
     const active = { controller, seq: 0 };
     this.activeRuns.set(runId, active);
-    const fullTask = { ...task, ...ctx.model !== void 0 ? { model: ctx.model } : {} };
+    const fullTask = {
+      ...task,
+      ...ctx.model !== void 0 ? { model: ctx.model } : {},
+      ...ctx.cwd !== void 0 ? { cwd: ctx.cwd } : {}
+    };
     const ctxModel = parseCtxModel(ctx.ctxModel);
     const stream = ctx.streamMode === "stream" ? { onDelta: (delta) => {
       void this.reverseRequestInternal("host/streamDelta", { runId, delta });