@ai-zen/cli 1.0.0-alpha.2 → 1.0.0-alpha.22

package/dist/sdk-log.js

@@ -0,0 +1,91 @@
+/**
+ * SDK 全局日志接管 —— 把库的日志引到独立文件。
+ *
+ * 背景：SDK 的 `getLogger()` 接口本身没问题，问题在**默认实现**是
+ * `console.log / console.warn / console.error`（`@ai-zen/agents-sdk` 的 `shared/logger.ts`）。
+ * 对通用库来说这是合理兜底，对 Ink TUI 却是灾难 —— 直接写 stdout 会穿到渲染区外面
+ * 把界面撕成乱码（例如 `load_mcp` 的 `log.info(JSON.stringify(manifest, null, 2))`
+ * 会把整份 tools / resources 清单砸在界面上）。
+ *
+ * 所以 TUI 启动时用 `setLogger()` 把 SDK 的日志出口换成**落盘实现**：
+ *   - 日志一律进 `~/.ai-zen/logs/sdk.log`，界面上一个字都不出现；
+ *   - 单文件 2MB 上限，超出轮转为 `sdk.log.1`，不会无限膨胀；
+ *   - 写失败一律吞掉，磁盘满 / 权限不足绝不能拖垮 TUI。
+ *
+ * 用法：
+ *   aiz                            → 追加写到 ~/.ai-zen/logs/sdk.log（默认开）
+ *   AIZ_DEBUG_SDK=0 aiz            → 完全静默
+ *   AIZ_SDK_LOG_FILE=/path aiz     → 写到指定文件
+ *
+ * 与 `key-debug.ts` 同一套约定（环境变量开关 + 固定日志文件），免得排查时记两套。
+ *
+ * ⚠️ 本模块只解决「日志往哪写」。SDK 内部若有地方绕过 `getLogger()` 直接抓 `console`
+ * （模块顶层 `const log = getLogger()` 这类快照），换 logger 是救不回来的 —— 那属于
+ * SDK 侧的接线问题，须在 SDK 里改为运行时取 logger，见对应 commit。
+ *
+ * 注意 stdio 模式不需要本模块：`stdio-runner.ts` 已把日志改道 stderr —— 那里 stdout
+ * 只留给结果，日志本身是有用的。本模块只服务「界面被占用」的 TUI。
+ */
+import { appendFileSync, mkdirSync, renameSync, statSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { setLogger } from "@ai-zen/agents-sdk";
+/** 共享根目录 `~/.ai-zen`（与 config.ts 的 AI_ZEN_DIR 同一约定） */
+const AI_ZEN_DIR = process.env.AI_ZEN_DIR ||
+    join(process.env.HOME || process.env.USERPROFILE || "", ".ai-zen");
+/** 是否把 SDK 日志落盘（默认开启，`AIZ_DEBUG_SDK=0` 关闭） */
+export const SDK_LOG_ENABLED = process.env.AIZ_DEBUG_SDK !== "0";
+/** 日志落盘路径（测试与用户都可能改写，故导出常量） */
+export const SDK_LOG_FILE = process.env.AIZ_SDK_LOG_FILE || join(AI_ZEN_DIR, "logs", "sdk.log");
+/** 单文件上限 2MB；超出后轮转为 `<file>.1`（只保留上一份，总量有界） */
+export const MAX_LOG_BYTES = 2 * 1024 * 1024;
+/** 单行日志格式：`<ISO 时间> [level] message` */
+export function formatSdkLogLine(level, message, at = new Date()) {
+    return `${at.toISOString()} [${level}] ${message}`;
+}
+/** 大小超限时把当前文件挪成 `.1`，让下一次写入从空文件开始 */
+function rotateIfNeeded(file) {
+    try {
+        if (statSync(file).size < MAX_LOG_BYTES)
+            return;
+        renameSync(file, `${file}.1`);
+    }
+    catch {
+        /* 文件还不存在：首次写入，无需轮转 */
+    }
+}
+/**
+ * 落盘版日志器。
+ *
+ * 写失败要吞掉：日志是旁路能力，磁盘满 / 权限不足时绝不能把 TUI 拖垮。
+ */
+export function createFileLogger(file) {
+    const write = (level) => (message) => {
+        try {
+            mkdirSync(dirname(file), { recursive: true });
+            rotateIfNeeded(file);
+            appendFileSync(file, `${formatSdkLogLine(level, message)}\n`);
+        }
+        catch {
+            /* 诊断失败绝不能影响主流程 */
+        }
+    };
+    return { info: write("info"), warn: write("warn"), error: write("error") };
+}
+/** 全静默日志器（`AIZ_DEBUG_SDK=0` 时使用） */
+export function createSilentLogger() {
+    const noop = () => { };
+    return { info: noop, warn: noop, error: noop };
+}
+/**
+ * 接管 SDK 全局日志：默认落盘，`AIZ_DEBUG_SDK=0` 静默。
+ *
+ * 返回实际安装的日志器，便于测试断言 / 上层复用。
+ */
+export function installSdkLogger(options = {}) {
+    const enabled = options.enabled ?? SDK_LOG_ENABLED;
+    const file = options.file ?? SDK_LOG_FILE;
+    const logger = enabled ? createFileLogger(file) : createSilentLogger();
+    setLogger(logger);
+    return logger;
+}
+//# sourceMappingURL=sdk-log.js.map

package/dist/sdk-log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk-log.js","sourceRoot":"","sources":["../src/sdk-log.ts"],"names":[],"mappings":"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"}

package/dist/session-pointer.d.ts

@@ -1,22 +1,35 @@
 /**
- * CLI 会话指针 — 记录「上一轮会话 id」。
+ * CLI 会话指针 — 按「工作目录（cwd）」记录各自的「上一轮会话 id」。
  *
  * 取代原草稿机制：不再维护单独的单文件草稿（`drafts/_current.json`），
  * 而是让每个会话直接落盘为 `conversations/<id>.json`，再用本指针记住
- * 「最近活动的会话 id」，供下次启动自动续接。
+ * 「每个目录最近活动的会话 id」，供下次在该目录启动时自动续接。
  *
- * 存储位置：`$AI_ZEN_DIR/cli/last-session.json`。
+ * 存储位置：`$AI_ZEN_DIR/cli/last-session.json`，结构为 cwd → 续接记录的 map：
+ *
+ *   {
+ *     "version": 1,
+ *     "sessions": {
+ *       "/abs/path/to/proj-a": { "id": "对话_...", "updatedAt": "..." },
+ *       "/abs/path/to/proj-b": { "id": "对话_...", "updatedAt": "..." }
+ *     }
+ *   }
+ *
+ * 以 `process.cwd()` 的**精确字符串**为键：不同目录各记各的，互不干扰。
+ * 旧版单指针文件（顶层 `{ id, updatedAt }`）无法归属到具体目录，一律视为
+ * 「无记录」——宁可丢一次续接，也不把别的目录的历史错认到当前目录。
  */
+/** 单个工作目录的续接记录 */
 export interface SessionPointer {
     /** 上一轮（最近活动）会话 id */
     id: string;
     /** 最后活动时间（ISO 字符串） */
     updatedAt: string;
 }
-/** 读取「上一轮会话 id」；文件不存在或内容损坏时返回 null */
-export declare function readLastSession(): Promise<SessionPointer | null>;
-/** 更新「上一轮会话 id」（原子写，避免中断产生半截文件） */
-export declare function writeLastSession(id: string): Promise<void>;
-/** 清除指针（会话被删除等场景使用） */
-export declare function clearLastSession(): Promise<void>;
+/** 读取指定工作目录的「上一轮会话 id」；无记录时返回 null */
+export declare function readLastSession(cwd: string): Promise<SessionPointer | null>;
+/** 更新指定工作目录的「上一轮会话 id」（保留其它目录的记录，原子写） */
+export declare function writeLastSession(cwd: string, id: string): Promise<void>;
+/** 清除指定工作目录的指针（会话被删除等场景使用） */
+export declare function clearLastSession(cwd: string): Promise<void>;
 //# sourceMappingURL=session-pointer.d.ts.map

package/dist/session-pointer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-pointer.d.ts","sourceRoot":"","sources":["../src/session-pointer.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAQH,MAAM,WAAW,cAAc;IAC7B,qBAAqB;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,sBAAsB;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,sCAAsC;AACtC,wBAAsB,eAAe,IAAI,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAStE;AAED,mCAAmC;AACnC,wBAAsB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAUhE;AAED,uBAAuB;AACvB,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAMtD"}
+{"version":3,"file":"session-pointer.d.ts","sourceRoot":"","sources":["../src/session-pointer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AASH,kBAAkB;AAClB,MAAM,WAAW,cAAc;IAC7B,qBAAqB;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,sBAAsB;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB;AA2CD,sCAAsC;AACtC,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAGjF;AAED,yCAAyC;AACzC,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAI7E;AAED,8BAA8B;AAC9B,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAKjE"}

package/dist/session-pointer.js

@@ -1,49 +1,81 @@
 /**
- * CLI 会话指针 — 记录「上一轮会话 id」。
+ * CLI 会话指针 — 按「工作目录（cwd）」记录各自的「上一轮会话 id」。
  *
  * 取代原草稿机制：不再维护单独的单文件草稿（`drafts/_current.json`），
  * 而是让每个会话直接落盘为 `conversations/<id>.json`，再用本指针记住
- * 「最近活动的会话 id」，供下次启动自动续接。
+ * 「每个目录最近活动的会话 id」，供下次在该目录启动时自动续接。
  *
- * 存储位置：`$AI_ZEN_DIR/cli/last-session.json`。
+ * 存储位置：`$AI_ZEN_DIR/cli/last-session.json`，结构为 cwd → 续接记录的 map：
+ *
+ *   {
+ *     "version": 1,
+ *     "sessions": {
+ *       "/abs/path/to/proj-a": { "id": "对话_...", "updatedAt": "..." },
+ *       "/abs/path/to/proj-b": { "id": "对话_...", "updatedAt": "..." }
+ *     }
+ *   }
+ *
+ * 以 `process.cwd()` 的**精确字符串**为键：不同目录各记各的，互不干扰。
+ * 旧版单指针文件（顶层 `{ id, updatedAt }`）无法归属到具体目录，一律视为
+ * 「无记录」——宁可丢一次续接，也不把别的目录的历史错认到当前目录。
  */
 import { promises as fs } from "node:fs";
 import { join } from "node:path";
 import { CLI_DIR } from "./config.js";
 const POINTER_FILE = join(CLI_DIR, "last-session.json");
-/** 读取「上一轮会话 id」；文件不存在或内容损坏时返回 null */
-export async function readLastSession() {
+const FILE_VERSION = 1;
+/** 读取整份指针文件；不存在 / 损坏 / 旧版格式时返回空结构 */
+async function readPointerFile() {
+    const empty = { version: FILE_VERSION, sessions: {} };
+    let parsed;
     try {
-        const raw = await fs.readFile(POINTER_FILE, "utf-8");
-        const parsed = JSON.parse(raw);
-        if (typeof parsed?.id !== "string" || !parsed.id)
-            return null;
-        return { id: parsed.id, updatedAt: parsed.updatedAt ?? "" };
+        parsed = JSON.parse(await fs.readFile(POINTER_FILE, "utf-8"));
     }
     catch {
-        return null;
+        return empty;
+    }
+    // 仅接受新版 map 结构；旧版单指针（顶层 id）或其它形状一律视为空。
+    if (!parsed || typeof parsed !== "object" || typeof parsed.sessions !== "object" || parsed.sessions === null) {
+        return empty;
     }
+    const sessions = {};
+    for (const [cwd, entry] of Object.entries(parsed.sessions)) {
+        const e = entry;
+        if (e && typeof e === "object" && typeof e.id === "string" && e.id) {
+            sessions[cwd] = { id: e.id, updatedAt: typeof e.updatedAt === "string" ? e.updatedAt : "" };
+        }
+    }
+    return { version: FILE_VERSION, sessions };
 }
-/** 更新「上一轮会话 id」（原子写，避免中断产生半截文件） */
-export async function writeLastSession(id) {
+/** 原子写入整份指针文件（必要时创建目录，tmp + rename 避免半截文件） */
+async function writePointerFile(file) {
     try {
         await fs.access(CLI_DIR);
     }
     catch {
         await fs.mkdir(CLI_DIR, { recursive: true });
     }
-    const pointer = { id, updatedAt: new Date().toISOString() };
     const tmp = `${POINTER_FILE}.tmp`;
-    await fs.writeFile(tmp, JSON.stringify(pointer, null, 2), "utf-8");
+    await fs.writeFile(tmp, JSON.stringify(file, null, 2), "utf-8");
     await fs.rename(tmp, POINTER_FILE);
 }
-/** 清除指针（会话被删除等场景使用） */
-export async function clearLastSession() {
-    try {
-        await fs.unlink(POINTER_FILE);
-    }
-    catch {
-        /* 不存在则忽略 */
-    }
+/** 读取指定工作目录的「上一轮会话 id」；无记录时返回 null */
+export async function readLastSession(cwd) {
+    const file = await readPointerFile();
+    return file.sessions[cwd] ?? null;
+}
+/** 更新指定工作目录的「上一轮会话 id」（保留其它目录的记录，原子写） */
+export async function writeLastSession(cwd, id) {
+    const file = await readPointerFile();
+    file.sessions[cwd] = { id, updatedAt: new Date().toISOString() };
+    await writePointerFile(file);
+}
+/** 清除指定工作目录的指针（会话被删除等场景使用） */
+export async function clearLastSession(cwd) {
+    const file = await readPointerFile();
+    if (!(cwd in file.sessions))
+        return;
+    delete file.sessions[cwd];
+    await writePointerFile(file);
 }
 //# sourceMappingURL=session-pointer.js.map

package/dist/session-pointer.js.map

@@ -1 +1 @@
-{"version":3,"file":"session-pointer.js","sourceRoot":"","sources":["../src/session-pointer.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEtC,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,EAAE,mBAAmB,CAAC,CAAC;AASxD,sCAAsC;AACtC,MAAM,CAAC,KAAK,UAAU,eAAe;IACnC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QACrD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAA4B,CAAC;QAC1D,IAAI,OAAO,MAAM,EAAE,EAAE,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,EAAE;YAAE,OAAO,IAAI,CAAC;QAC9D,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,EAAE,EAAE,CAAC;IAC9D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,mCAAmC;AACnC,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,EAAU;IAC/C,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/C,CAAC;IACD,MAAM,OAAO,GAAmB,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC;IAC5E,MAAM,GAAG,GAAG,GAAG,YAAY,MAAM,CAAC;IAClC,MAAM,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IACnE,MAAM,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;AACrC,CAAC;AAED,uBAAuB;AACvB,MAAM,CAAC,KAAK,UAAU,gBAAgB;IACpC,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACP,YAAY;IACd,CAAC;AACH,CAAC"}
+{"version":3,"file":"session-pointer.js","sourceRoot":"","sources":["../src/session-pointer.ts"],"names":[],"mappings":"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"}

package/dist/stdio-runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stdio-runner.d.ts","sourceRoot":"","sources":["../src/stdio-runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAa9C,MAAM,WAAW,eAAe;IAC9B,qCAAqC;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,6BAA6B;IAC7B,IAAI,EAAE,OAAO,CAAC;CACf;AAOD;;;GAGG;AACH,wBAAsB,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,CAWjD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAMtE;AAED,oCAAoC;AACpC,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,CAAC,cAAc,GAAG,SAAS,GAAG,MAAM,CAY/E;AAoCD,6BAA6B;AAC7B,wBAAsB,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAuExE"}
+{"version":3,"file":"stdio-runner.d.ts","sourceRoot":"","sources":["../src/stdio-runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAc9C,MAAM,WAAW,eAAe;IAC9B,qCAAqC;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,6BAA6B;IAC7B,IAAI,EAAE,OAAO,CAAC;CACf;AAOD;;;GAGG;AACH,wBAAsB,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,CAWjD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAMtE;AAED,oCAAoC;AACpC,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,CAAC,cAAc,GAAG,SAAS,GAAG,MAAM,CAY/E;AAwCD,6BAA6B;AAC7B,wBAAsB,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAwExE"}

package/dist/stdio-runner.js

@@ -10,13 +10,12 @@
  * 该模式不落盘（不写草稿 / 对话存档），仅当显式 `--save` 时保存对话存档。
  */
 import { AgentNS } from "@ai-zen/agents-core";
-import { AutoRefreshToolsPlugin, ContextGuardPlugin, setLogger, } from "@ai-zen/agents-sdk";
+import { AgentRepository, AutoRefreshToolsPlugin, ContextGuardPlugin, setLogger, } from "@ai-zen/agents-sdk";
 import { createAgent } from "./agent-creator.js";
-import { readConfig } from "./config.js";
+import { AGENTS_DIR, readConfig } from "./config.js";
 import { CwdTrackerPlugin } from "./cwd-tracker-plugin.js";
 import { SubAgentGuardInstallerPlugin } from "./sub-agent-guard-plugin.js";
-import { conversationRepository } from "./conversation-repository.js";
-import { formatShortTime } from "./format-time.js";
+import { generateConversationId, persistConversation } from "./conversation-repository.js";
 /** 向 stderr 写一行（stdlib 日志统一出口） */
 function logStderr(line) {
     process.stderr.write(line.endsWith("\n") ? line : line + "\n");
@@ -64,9 +63,9 @@ export function extractText(content) {
         if (section.type === "text")
             parts.push(section.text);
         else if (section.type === "image_url")
-            parts.push(`[图片: ${section.image_url.url}]`);
+            parts.push(`[Image: ${section.image_url.url}]`);
         else if (section.type === "file")
-            parts.push(`[文件: ${section.file_id ?? section.filename ?? "内联文件"}]`);
+            parts.push(`[File: ${section.file_id ?? section.filename ?? "inline file"}]`);
     }
     return parts.join("\n");
 }
@@ -76,21 +75,23 @@ export function extractText(content) {
  */
 async function resolveTarget() {
     const config = await readConfig();
-    const modelId = config.defaultModel ?? config.models[0]?.id;
-    if (!modelId)
-        throw new Error("没有可用的模型，请先运行 `ai` 完成配置");
+    const agentId = config.defaultAgent ?? "default";
+    const definition = await new AgentRepository(AGENTS_DIR).read(agentId);
+    const modelId = definition?.modelId;
+    if (!modelId) {
+        throw new Error(`Agent "${agentId}" has no model bound — run \`ai\` and pick one under /config`);
+    }
     const model = config.models.find((m) => m.id === modelId);
     if (!model)
-        throw new Error(`默认模型 ${modelId} 不存在`);
+        throw new Error(`The model "${modelId}" bound to the agent does not exist`);
     const endpoint = config.endpoints.find((e) => e.id === model.endpointId);
     if (!endpoint)
-        throw new Error(`模型 ${modelId} 引用的端点 ${model.endpointId} 不存在`);
+        throw new Error(`Model "${modelId}" references endpoint "${model.endpointId}", which does not exist`);
     if (!endpoint.apiKey) {
-        throw new Error(`端点 "${endpoint.name}" 的 API Key 未设置，请先运行 \`ai\` 进入交互界面配置`);
+        throw new Error(`Endpoint "${endpoint.name}" has no API key yet — run \`ai\` to configure it in the interactive UI`);
     }
-    const maxTokens = model.maxContextTokens ??
-        (model.maxContextChars ? Math.floor(model.maxContextChars / 4) : undefined);
-    return { modelId, agentId: config.defaultAgent ?? "default", maxTokens };
+    // 阈值由配置直接给出（旧字段已在 SDK 的 ConfigManager.read() 里迁移过）
+    return { modelId, agentId, tokenThresholds: model.tokenThresholds };
 }
 /** 运行一次纯 stdio 对话，返回进程退出码 */
 export async function runStdio(options) {
@@ -98,22 +99,24 @@ export async function runStdio(options) {
     const stdinText = await readStdin();
     const prompt = mergePrompt(instruction, stdinText);
     if (!prompt.trim()) {
-        logStderr("ai: 没有输入内容（请提供参数，或通过管道传入文本）");
+        logStderr("ai: no input (pass an argument or pipe text in)");
         return 2;
     }
-    // 保持 stdout 纯净：SDK 全局日志与 console.log 统一改道 stderr
+    // 保持 stdout 纯净：SDK 全局日志走 setLogger 改道，
+    // 但 SDK（及第三方依赖）内部仍有**直接调用 console.log** 的地方，不经我们的 logger；
+    // 管道模式下那会把日志混进模型输出，所以这里连 console.log 一起改道。
     const stderrLogger = (message) => logStderr(message);
     setLogger({ info: stderrLogger, warn: stderrLogger, error: stderrLogger });
     const originalLog = console.log;
     console.log = (...args) => logStderr(args.map((a) => String(a)).join(" "));
     try {
-        const { modelId, agentId, maxTokens } = await resolveTarget();
+        const { modelId, agentId, tokenThresholds } = await resolveTarget();
         const agent = await createAgent({ agentId });
         agent.use(new CwdTrackerPlugin());
         agent.use(new AutoRefreshToolsPlugin());
-        if (maxTokens && maxTokens > 0) {
-            agent.use(new ContextGuardPlugin({ maxTokens }));
-            agent.use(new SubAgentGuardInstallerPlugin({ maxTokens }));
+        if (tokenThresholds) {
+            agent.use(new ContextGuardPlugin({ guardTokens: tokenThresholds.guard }));
+            agent.use(new SubAgentGuardInstallerPlugin({ guardTokens: tokenThresholds.guard }));
         }
         await agent.init();
         const messages = await agent.send(prompt);
@@ -121,22 +124,21 @@ export async function runStdio(options) {
             .reverse()
             .find((m) => m.role === AgentNS.Role.Assistant);
         if (!lastAssistant || lastAssistant.status === AgentNS.MessageStatus.Error) {
-            logStderr("ai: 模型返回错误");
+            logStderr("ai: the model returned an error");
             return 1;
         }
         if (save) {
-            const name = `对话_${formatShortTime(new Date().toISOString())}`;
-            const now = new Date().toISOString();
-            await conversationRepository.write({
-                id: name.replace(/[\\/:*?"<>|]/g, "_"),
+            // 会话名与 TUI 同源（避免两处拼接各自漂移）
+            const name = await persistConversation({
+                id: generateConversationId(),
                 agentId,
-                modelId,
                 messages: agent.messages,
                 cwd: process.cwd(),
-                createdAt: now,
-                updatedAt: now,
+                // 一次性管道调用只归档，不改「本目录上一轮会话」指针：
+                // 否则连跑几条 `cat … | ai --save` 后，下次 `ai` 会续接到最后一条管道结果上
+                setAsLastSession: false,
             });
-            logStderr(`已保存对话: ${name}`);
+            logStderr(`Saved conversation: ${name}`);
         }
         // 结果：仅此一处写入 stdout
         const text = extractText(lastAssistant.content);

package/dist/stdio-runner.js.map

@@ -1 +1 @@
-{"version":3,"file":"stdio-runner.js","sourceRoot":"","sources":["../src/stdio-runner.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"stdio-runner.js","sourceRoot":"","sources":["../src/stdio-runner.ts"],"names":[],"mappings":"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"}

package/dist/sub-agent-guard-plugin.d.ts

@@ -12,8 +12,8 @@
  * init）。
  *
  * 约束口径（与主 Agent 一致，仅此一项）：把主 Agent 同款的 `ContextGuardPlugin` 装到子 Agent 上
- * —— 同一 `maxTokens`（当前模型 `maxContextTokens`）、同样不传 ratio（沿用 SDK 默认 1.5），
- * 使「上下文 token 超过 maxTokens × 1.5 即中断」对子 Agent 同样成立。
+ * —— 同一个 `guardTokens`（当前模型的 `tokenThresholds.guard`），使「请求前用量超过硬线即中断」
+ * 对子 Agent 同样成立。
  * **不设**轮次上限，**不设**工具调用次数上限。
  *
  * 中断语义：抛错即结束子 Agent 的 run；异常经 `AgentTool` 的 finally（分发 onSubAgentEnd）
@@ -27,8 +27,8 @@
 import type { AgentPlugin } from "@ai-zen/agents-sdk";
 import type { SubAgentContext } from "@ai-zen/agents-core";
 export interface SubAgentGuardOptions {
-    /** 子 Agent 的上下文 token 阈值；与主 Agent 同源（当前模型的 `maxContextTokens`） */
-    maxTokens: number;
+    /** 强行阻断阈值；与主 Agent 同源（当前模型的 `tokenThresholds.guard`） */
+    guardTokens: number;
 }
 /**
  * 子 Agent 护栏安装器（装在**宿主 Agent** 上）。
@@ -38,7 +38,7 @@ export interface SubAgentGuardOptions {
  * 由 `ContextGuardPlugin` 按阈值决定。
  */
 export declare class SubAgentGuardInstallerPlugin implements AgentPlugin {
-    private readonly maxTokens;
+    private readonly guardTokens;
     constructor(options: SubAgentGuardOptions);
     onSubAgentStart({ subAgent }: SubAgentContext): void;
 }

package/dist/sub-agent-guard-plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sub-agent-guard-plugin.d.ts","sourceRoot":"","sources":["../src/sub-agent-guard-plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D,MAAM,WAAW,oBAAoB;IACnC,kEAAkE;IAClE,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;GAMG;AACH,qBAAa,4BAA6B,YAAW,WAAW;IAC9D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,OAAO,EAAE,oBAAoB;IAIzC,eAAe,CAAC,EAAE,QAAQ,EAAE,EAAE,eAAe,GAAG,IAAI;CASrD"}
+{"version":3,"file":"sub-agent-guard-plugin.d.ts","sourceRoot":"","sources":["../src/sub-agent-guard-plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D,MAAM,WAAW,oBAAoB;IACnC,wDAAwD;IACxD,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;GAMG;AACH,qBAAa,4BAA6B,YAAW,WAAW;IAC9D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;gBAEzB,OAAO,EAAE,oBAAoB;IAIzC,eAAe,CAAC,EAAE,QAAQ,EAAE,EAAE,eAAe,GAAG,IAAI;CASrD"}

package/dist/sub-agent-guard-plugin.js

@@ -12,8 +12,8 @@
  * init）。
  *
  * 约束口径（与主 Agent 一致，仅此一项）：把主 Agent 同款的 `ContextGuardPlugin` 装到子 Agent 上
- * —— 同一 `maxTokens`（当前模型 `maxContextTokens`）、同样不传 ratio（沿用 SDK 默认 1.5），
- * 使「上下文 token 超过 maxTokens × 1.5 即中断」对子 Agent 同样成立。
+ * —— 同一个 `guardTokens`（当前模型的 `tokenThresholds.guard`），使「请求前用量超过硬线即中断」
+ * 对子 Agent 同样成立。
  * **不设**轮次上限，**不设**工具调用次数上限。
  *
  * 中断语义：抛错即结束子 Agent 的 run；异常经 `AgentTool` 的 finally（分发 onSubAgentEnd）
@@ -33,15 +33,15 @@ import { ContextGuardPlugin } from "@ai-zen/agents-sdk";
  * 由 `ContextGuardPlugin` 按阈值决定。
  */
 export class SubAgentGuardInstallerPlugin {
-    maxTokens;
+    guardTokens;
     constructor(options) {
-        this.maxTokens = options.maxTokens;
+        this.guardTokens = options.guardTokens;
     }
     onSubAgentStart({ subAgent }) {
-        // 与主 Agent 完全同款：同一 maxTokens，不传 ratio（沿用 ContextGuardPlugin 默认 1.5）
-        subAgent.use(new ContextGuardPlugin({ maxTokens: this.maxTokens }));
+        // 与主 Agent 完全同款：同一个 guardTokens 绝对阈值
+        subAgent.use(new ContextGuardPlugin({ guardTokens: this.guardTokens }));
         // 传染到孙级：子 Agent 若再委派，其子 Agent 同样被安插
-        subAgent.use(new SubAgentGuardInstallerPlugin({ maxTokens: this.maxTokens }));
+        subAgent.use(new SubAgentGuardInstallerPlugin({ guardTokens: this.guardTokens }));
     }
 }
 //# sourceMappingURL=sub-agent-guard-plugin.js.map

package/dist/sub-agent-guard-plugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"sub-agent-guard-plugin.js","sourceRoot":"","sources":["../src/sub-agent-guard-plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AASxD;;;;;;GAMG;AACH,MAAM,OAAO,4BAA4B;IACtB,SAAS,CAAS;IAEnC,YAAY,OAA6B;QACvC,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;IACrC,CAAC;IAED,eAAe,CAAC,EAAE,QAAQ,EAAmB;QAC3C,oEAAoE;QACpE,QAAQ,CAAC,GAAG,CAAC,IAAI,kBAAkB,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;QAEpE,oCAAoC;QACpC,QAAQ,CAAC,GAAG,CACV,IAAI,4BAA4B,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAChE,CAAC;IACJ,CAAC;CACF"}
+{"version":3,"file":"sub-agent-guard-plugin.js","sourceRoot":"","sources":["../src/sub-agent-guard-plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AASxD;;;;;;GAMG;AACH,MAAM,OAAO,4BAA4B;IACtB,WAAW,CAAS;IAErC,YAAY,OAA6B;QACvC,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;IACzC,CAAC;IAED,eAAe,CAAC,EAAE,QAAQ,EAAmB;QAC3C,qCAAqC;QACrC,QAAQ,CAAC,GAAG,CAAC,IAAI,kBAAkB,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;QAExE,oCAAoC;QACpC,QAAQ,CAAC,GAAG,CACV,IAAI,4BAA4B,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CACpE,CAAC;IACJ,CAAC;CACF"}