@ai-zen/cli 0.9.0 → 1.0.0-alpha.10

package/dist/config.js

@@ -15,7 +15,14 @@
  *   ├── mcp-oauth/                ← MCP OAuth token（共享）
  *   └── cli/                      ← CLI 运行时数据
  *       ├── conversations/        ← 对话记录
- *       └── drafts/               ← 草稿
+ *       └── last-session.json     ← 「各 cwd 上一轮会话 id」指针（cwd → id）
+ *
+ *   项目/.ai-zen/                 ← 项目级配置与产物
+ *   ├── skills/                   ← 项目级 Skill
+ *   ├── tools/                    ← 项目级工具
+ *   ├── sub-agents/               ← 项目级子 Agent
+ *   ├── mcp.json                  ← 项目级 MCP 配置
+ *   └── handoffs/                 ← 交接文档（任务交接的落盘产物）
  *
  *   ~/.agents/                    ← 业界通用规范（如 Cursor、Windsurf、Cline）
  *   ├── skills/                   ← 用户级 Skill
@@ -39,8 +46,7 @@
  *     4. ~/.agents/skills/
  */
 import { promises as fs } from "fs";
-import { join } from "path";
-import chalk from "chalk";
+import { dirname, join } from "path";
 import { ConfigManager as SdkConfigManager } from "@ai-zen/agents-sdk";
 // ==================== 根目录 ====================
 export const AI_ZEN_DIR = process.env.AI_ZEN_DIR || join(process.env.HOME || process.env.USERPROFILE || "", ".ai-zen");
@@ -48,7 +54,6 @@ export const AI_ZEN_DIR = process.env.AI_ZEN_DIR || join(process.env.HOME || pro
 export const CLI_DIR = join(AI_ZEN_DIR, "cli");
 export const CONFIG_FILE = join(AI_ZEN_DIR, "config.json");
 export const CONVERSATIONS_DIR = join(CLI_DIR, "conversations");
-export const DRAFTS_DIR = join(CLI_DIR, "drafts");
 // ==================== 共享目录 ====================
 export const AGENTS_DIR = join(AI_ZEN_DIR, "agents");
 export const SUB_AGENTS_DIR = join(AI_ZEN_DIR, "sub-agents");
@@ -58,6 +63,13 @@ export const TOOLS_DIR = join(AI_ZEN_DIR, "tools");
 export const PROJECT_SUB_AGENTS_DIR = join(process.cwd(), ".ai-zen", "sub-agents");
 export const PROJECT_SKILLS_DIR = join(process.cwd(), ".ai-zen", "skills");
 export const PROJECT_TOOLS_DIR = join(process.cwd(), ".ai-zen", "tools");
+/**
+ * 交接文档目录（项目级）：`<cwd>/.ai-zen/handoffs/`。
+ *
+ * 交接文档是「人也能直接读」的产物，放在项目内便于随仓库共享/评审；
+ * 目录由交接时的 write 工具或服务落盘时自动创建，无需预先建立。
+ */
+export const PROJECT_HANDOFFS_DIR = join(process.cwd(), ".ai-zen", "handoffs");
 // ==================== 业界通用规范 ~/.agents/ 目录 ====================
 const USER_AGENTS_DIR = join(process.env.HOME || process.env.USERPROFILE || "", ".agents");
 export const USER_AGENTS_SKILLS_DIR = join(USER_AGENTS_DIR, "skills");
@@ -77,14 +89,14 @@ const sdkConfigMgr = new SdkConfigManager(CONFIG_FILE);
  * 确保配置目录和默认文件存在。
  *
  * 共享实体（Agent、SubAgent、Skill 目录等）委托给 SDK 的 ConfigManager.bootstrap()。
- * CLI 自身的运行时目录（conversations/、drafts/）由本函数额外创建。
+ * CLI 自身的运行时目录（conversations/）由本函数额外创建。
  * SDK 的出厂默认配置会自动写入 config.json（如果不存在）。
  */
 export async function ensureConfigDir() {
     // SDK bootstrap：目录 + config.json + default Agent + default SubAgent
     await sdkConfigMgr.bootstrap();
     // CLI 运行时目录
-    const cliDirs = [CLI_DIR, CONVERSATIONS_DIR, DRAFTS_DIR];
+    const cliDirs = [CLI_DIR, CONVERSATIONS_DIR];
     for (const dir of cliDirs) {
         try {
             await fs.access(dir);
@@ -94,7 +106,7 @@ export async function ensureConfigDir() {
                 await fs.mkdir(dir, { recursive: true });
             }
             catch {
-                console.warn(chalk.yellow(`⚠️  无法创建目录: ${dir}`));
+                console.warn(`⚠️  无法创建目录: ${dir}`);
             }
         }
     }
@@ -108,19 +120,23 @@ export async function saveConfig(config) {
     await ensureConfigDir();
     await sdkConfigMgr.write(config);
 }
+/** 作用域对应的 mcp.json 路径 */
+export function mcpConfigPath(scope) {
+    return scope === "project" ? PROJECT_MCP_CONFIG_FILE : MCP_CONFIG_FILE;
+}
 /**
- * 读取全局 ~/.ai-zen/mcp.json，不存在时返回空结构。
+ * 读取指定路径的 mcp.json，不存在 / 解析失败时返回空结构。
  * 采用业界标准 `mcpServers` 顶层字段（与 SDK discoverMcpServers 一致）。
  */
-export async function readMcpConfig() {
+export async function readMcpConfigAt(path) {
     try {
-        await fs.access(MCP_CONFIG_FILE);
+        await fs.access(path);
     }
     catch {
         return { mcpServers: {} };
     }
     try {
-        const raw = JSON.parse(await fs.readFile(MCP_CONFIG_FILE, "utf-8"));
+        const raw = JSON.parse(await fs.readFile(path, "utf-8"));
         // 兼容并归一：以 mcpServers 为准，缺失时回退到空的 mcpServers
         return { mcpServers: raw.mcpServers ?? {} };
     }
@@ -129,27 +145,28 @@ export async function readMcpConfig() {
     }
 }
 /**
- * 原子写入全局 ~/.ai-zen/mcp.json。
+ * 原子写入指定路径的 mcp.json（必要时创建父目录）。
  */
-export async function writeMcpConfig(mcpConfig) {
-    const tmp = MCP_CONFIG_FILE + ".tmp";
+export async function writeMcpConfigAt(path, mcpConfig) {
+    await fs.mkdir(dirname(path), { recursive: true });
+    const tmp = path + ".tmp";
     await fs.writeFile(tmp, JSON.stringify(mcpConfig, null, 2), "utf-8");
-    await fs.rename(tmp, MCP_CONFIG_FILE);
+    await fs.rename(tmp, path);
+}
+/**
+ * 读取某个作用域的 mcp.json（默认全局 ~/.ai-zen/mcp.json）。
+ */
+export async function readMcpConfig(scope = "global") {
+    return readMcpConfigAt(mcpConfigPath(scope));
+}
+/**
+ * 原子写入某个作用域的 mcp.json（默认全局 ~/.ai-zen/mcp.json）。
+ */
+export async function writeMcpConfig(mcpConfig, scope = "global") {
+    await writeMcpConfigAt(mcpConfigPath(scope), mcpConfig);
 }
+/** 读取项目级 <cwd>/.ai-zen/mcp.json（等价于 readMcpConfig("project")） */
 export async function readProjectMcpConfig() {
-    const path = PROJECT_MCP_CONFIG_FILE;
-    try {
-        await fs.access(path);
-    }
-    catch {
-        return { mcpServers: {} };
-    }
-    try {
-        const raw = JSON.parse(await fs.readFile(path, "utf-8"));
-        return { mcpServers: raw.mcpServers ?? {} };
-    }
-    catch {
-        return { mcpServers: {} };
-    }
+    return readMcpConfigAt(PROJECT_MCP_CONFIG_FILE);
 }
 //# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AAEH,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,IAAI,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,aAAa,IAAI,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAGvE,gDAAgD;AAEhD,MAAM,CAAC,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,IAAI,CACtD,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,EAAE,EACjD,SAAS,CACV,CAAC;AAEF,sDAAsD;AAEtD,MAAM,CAAC,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;AAC/C,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;AAC3D,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;AAEhE,iDAAiD;AAEjD,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;AACrD,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;AAC7D,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;AACrD,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;AAEnD,yDAAyD;AAEzD,MAAM,CAAC,MAAM,sBAAsB,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,YAAY,CAAC,CAAC;AACnF,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;AAC3E,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;AACzE;;;;;GAKG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;AAE/E,iEAAiE;AAEjE,MAAM,eAAe,GAAG,IAAI,CAC1B,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,EAAE,EACjD,SAAS,CACV,CAAC;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAAG,IAAI,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAC;AACtE,MAAM,CAAC,MAAM,2BAA2B,GAAG,IAAI,CAAC,eAAe,EAAE,UAAU,CAAC,CAAC;AAE7E,kEAAkE;AAElE,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,CAAC,CAAC;AACjE,MAAM,CAAC,MAAM,yBAAyB,GAAG,IAAI,CAAC,kBAAkB,EAAE,QAAQ,CAAC,CAAC;AAC5E,MAAM,CAAC,MAAM,8BAA8B,GAAG,IAAI,CAAC,kBAAkB,EAAE,UAAU,CAAC,CAAC;AAEnF,mDAAmD;AAEnD,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;AAC5D,MAAM,CAAC,MAAM,uBAAuB,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;AAClF,MAAM,CAAC,MAAM,sBAAsB,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,WAAW,CAAC,CAAC;AAEvE,8DAA8D;AAE9D,MAAM,YAAY,GAAG,IAAI,gBAAgB,CAAC,WAAW,CAAC,CAAC;AAEvD,kDAAkD;AAElD;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe;IACnC,oEAAoE;IACpE,MAAM,YAAY,CAAC,SAAS,EAAE,CAAC;IAE/B,YAAY;IACZ,MAAM,OAAO,GAAG,CAAC,OAAO,EAAE,iBAAiB,CAAC,CAAC;IAC7C,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;QAC1B,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACvB,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,CAAC;gBAAC,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAAC,CAAC;YACjD,MAAM,CAAC;gBAAC,OAAO,CAAC,IAAI,CAAC,eAAe,GAAG,EAAE,CAAC,CAAC;YAAC,CAAC;QAC/C,CAAC;IACH,CAAC;AACH,CAAC;AAED,iDAAiD;AAEjD,MAAM,CAAC,KAAK,UAAU,UAAU;IAC9B,MAAM,eAAe,EAAE,CAAC;IACxB,OAAO,MAAM,YAAY,CAAC,IAAI,EAAE,CAAC;AACnC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,MAAiB;IAChD,MAAM,eAAe,EAAE,CAAC;IACxB,MAAM,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;AACnC,CAAC;AAsCD,yBAAyB;AACzB,MAAM,UAAU,aAAa,CAAC,KAAe;IAC3C,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,eAAe,CAAC;AACzE,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAY;IAChD,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;IAC5B,CAAC;IACD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAuB,CAAC;QAC/E,4CAA4C;QAC5C,OAAO,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,IAAI,EAAE,EAAE,CAAC;IAC9C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;IAC5B,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,IAAY,EAAE,SAAoB;IACvE,MAAM,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACnD,MAAM,GAAG,GAAG,IAAI,GAAG,MAAM,CAAC;IAC1B,MAAM,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IACrE,MAAM,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;AAC7B,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,QAAkB,QAAQ;IAC5D,OAAO,eAAe,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC;AAC/C,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,SAAoB,EAAE,QAAkB,QAAQ;IACnF,MAAM,gBAAgB,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC,CAAC;AAC1D,CAAC;AAED,iEAAiE;AACjE,MAAM,CAAC,KAAK,UAAU,oBAAoB;IACxC,OAAO,eAAe,CAAC,uBAAuB,CAAC,CAAC;AAClD,CAAC"}

package/dist/conversation-commands/registry.d.ts

@@ -1,13 +1,12 @@
 /**
  * 对话命令元数据 — 对话命令清单的唯一来源
  *
- * 命令名、别名与说明集中声明于此，由三类消费方共用：
- *   - 分发：`./index.ts` 按主命令名装配处理函数表，并按别名自动展开
- *   - 帮助：`./help.ts` 渲染 `/help` 输出
- *   - 提示：`../slash-hint-prompt.ts` 渲染输入 `/` 时的实时候选提示
+ * 命令名、别名与说明集中声明于此，由 TUI 层复用：
+ *   - 提示/补全：`src/tui/screens.tsx` 渲染输入 `/` 时的实时候选菜单
+ *   - 帮助：`/help` 命令按本清单渲染
  *
  * 新增、改名或调整说明只需改动本文件。本模块为纯数据与纯函数，
- * 不依赖 inquirer / chalk，可直接单测。
+ * 不依赖 chalk / React 等 UI 依赖，可直接单测。
  */
 /** 单个对话命令的元数据 */
 export interface CommandMeta {

package/dist/conversation-commands/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/conversation-commands/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,iBAAiB;AACjB,MAAM,WAAW,WAAW;IAC1B,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,sBAAsB;IACtB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,YAAY;IACZ,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,wBAAwB;AACxB,eAAO,MAAM,gBAAgB,EAAE,SAAS,WAAW,EASlD,CAAC;AAEF,0CAA0C;AAC1C,MAAM,WAAW,WAAW;IAC1B,gCAAgC;IAChC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,YAAY;IACZ,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,wBAAwB;AACxB,wBAAgB,eAAe,IAAI,WAAW,EAAE,CAS/C;AAED;;;GAGG;AACH,eAAO,MAAM,mBAAmB,QACqC,CAAC;AAEtE;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,EAAE,CAOhE;AAED,+BAA+B;AAC/B,wBAAgB,eAAe,IAAI,MAAM,EAAE,CAM1C"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/conversation-commands/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,iBAAiB;AACjB,MAAM,WAAW,WAAW;IAC1B,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,sBAAsB;IACtB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,YAAY;IACZ,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,wBAAwB;AACxB,eAAO,MAAM,gBAAgB,EAAE,SAAS,WAAW,EAclD,CAAC;AAEF,0CAA0C;AAC1C,MAAM,WAAW,WAAW;IAC1B,gCAAgC;IAChC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,YAAY;IACZ,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,wBAAwB;AACxB,wBAAgB,eAAe,IAAI,WAAW,EAAE,CAS/C;AAED;;;GAGG;AACH,eAAO,MAAM,mBAAmB,QACqC,CAAC;AAEtE;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,EAAE,CAOhE;AAED,+BAA+B;AAC/B,wBAAgB,eAAe,IAAI,MAAM,EAAE,CAM1C"}

package/dist/conversation-commands/registry.js

@@ -1,24 +1,28 @@
 /**
  * 对话命令元数据 — 对话命令清单的唯一来源
  *
- * 命令名、别名与说明集中声明于此，由三类消费方共用：
- *   - 分发：`./index.ts` 按主命令名装配处理函数表，并按别名自动展开
- *   - 帮助：`./help.ts` 渲染 `/help` 输出
- *   - 提示：`../slash-hint-prompt.ts` 渲染输入 `/` 时的实时候选提示
+ * 命令名、别名与说明集中声明于此，由 TUI 层复用：
+ *   - 提示/补全：`src/tui/screens.tsx` 渲染输入 `/` 时的实时候选菜单
+ *   - 帮助：`/help` 命令按本清单渲染
  *
  * 新增、改名或调整说明只需改动本文件。本模块为纯数据与纯函数，
- * 不依赖 inquirer / chalk，可直接单测。
+ * 不依赖 chalk / React 等 UI 依赖，可直接单测。
  */
 /** 命令元数据表（数组顺序即展示顺序） */
 export const COMMAND_REGISTRY = [
-    { name: "exit", aliases: ["quit"], description: "退出对话（会提示是否保存）" },
     { name: "save", description: "保存当前对话" },
+    { name: "load", description: "加载已保存的对话（替换当前会话）" },
     { name: "new", description: "重置会话（清空历史）" },
     { name: "back", description: "撤回消息（可修改后重发）" },
     { name: "editor", description: "使用系统编辑器输入长消息" },
     { name: "clear", description: "清屏" },
-    { name: "migrate", description: "手动任务迁移（生成交接文档并开启新会话）" },
+    { name: "config", description: "打开配置中心（默认模型 / 端点管理）" },
+    { name: "key", description: "设置当前端点的 API Key" },
+    { name: "handoff", description: "编写任务交接文档（不切换会话）" },
+    { name: "migrate", aliases: ["migration"], description: "交接并开启新会话（生成交接文档）" },
     { name: "help", description: "显示此帮助" },
+    // exit 置于末尾：斜杠菜单回车执行高亮项，避免「只输入 / 就回车」直接退出
+    { name: "exit", aliases: ["quit"], description: "退出对话（会提示是否保存）" },
 ];
 /** 展开全部命令为展示条目（别名折叠） */
 export function getCommandHints() {

package/dist/conversation-commands/registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/conversation-commands/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAYH,wBAAwB;AACxB,MAAM,CAAC,MAAM,gBAAgB,GAA2B;IACtD,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,eAAe,EAAE;IACjE,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE;IACvC,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE;IAC1C,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,cAAc,EAAE;IAC7C,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,cAAc,EAAE;IAC/C,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE;IACpC,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,sBAAsB,EAAE;IACxD,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE;CACvC,CAAC;AAYF,wBAAwB;AACxB,MAAM,UAAU,eAAe;IAC7B,OAAO,gBAAgB,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;QACtC,MAAM,KAAK,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC;QACzD,OAAO;YACL,KAAK;YACL,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;YAChD,WAAW,EAAE,OAAO,CAAC,WAAW;SACjC,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAC9B,IAAI,CAAC,GAAG,CAAC,GAAG,eAAe,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC;AAEtE;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAe;IAC/C,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAChD,IAAI,CAAC,UAAU;QAAE,OAAO,eAAe,EAAE,CAAC;IAE1C,OAAO,eAAe,EAAE,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CACvC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CACvD,CAAC;AACJ,CAAC;AAED,+BAA+B;AAC/B,MAAM,UAAU,eAAe;IAC7B,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,KAAK,MAAM,IAAI,IAAI,eAAe,EAAE,EAAE,CAAC;QACrC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK;YAAE,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;AAClC,CAAC"}
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/conversation-commands/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAYH,wBAAwB;AACxB,MAAM,CAAC,MAAM,gBAAgB,GAA2B;IACtD,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE;IACvC,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,kBAAkB,EAAE;IACjD,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE;IAC1C,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,cAAc,EAAE;IAC7C,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,cAAc,EAAE;IAC/C,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE;IACpC,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,qBAAqB,EAAE;IACtD,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE;IAC/C,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,iBAAiB,EAAE;IACnD,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,WAAW,CAAC,EAAE,WAAW,EAAE,kBAAkB,EAAE;IAC5E,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE;IACtC,0CAA0C;IAC1C,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,eAAe,EAAE;CAClE,CAAC;AAYF,wBAAwB;AACxB,MAAM,UAAU,eAAe;IAC7B,OAAO,gBAAgB,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;QACtC,MAAM,KAAK,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC;QACzD,OAAO;YACL,KAAK;YACL,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;YAChD,WAAW,EAAE,OAAO,CAAC,WAAW;SACjC,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAC9B,IAAI,CAAC,GAAG,CAAC,GAAG,eAAe,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC;AAEtE;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAe;IAC/C,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAChD,IAAI,CAAC,UAAU;QAAE,OAAO,eAAe,EAAE,CAAC;IAE1C,OAAO,eAAe,EAAE,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CACvC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CACvD,CAAC;AACJ,CAAC;AAED,+BAA+B;AAC/B,MAAM,UAAU,eAAe;IAC7B,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,KAAK,MAAM,IAAI,IAAI,eAAe,EAAE,EAAE,CAAC;QACrC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK;YAAE,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;AAClC,CAAC"}

package/dist/conversation-persist-plugin.d.ts

@@ -0,0 +1,25 @@
+/**
+ * ConversationPersistPlugin — 会话自动落盘插件。
+ *
+ * 取代原 `DraftPlugin`：不再写单文件草稿，而是每轮内循环结束后把当前
+ * 消息写入该会话文件（`conversations/<id>.json`），并更新「上一轮会话 id」指针。
+ *
+ * 采用「方案 B」：仅在产生实质内容（至少一条用户消息）时落盘，避免留下空会话。
+ * 会话 id 通过 `getId()` 动态获取，以便任务迁移切换新会话后依然落盘到正确的文件。
+ */
+import type { AgentPlugin, SendContext } from "@ai-zen/agents-sdk";
+export interface ConversationPersistPluginOptions {
+    /** 动态返回当前会话 id（迁移切换会话后随之变化） */
+    getId: () => string;
+    agentId: string;
+    modelId: string;
+    cwd?: string;
+    /** 落盘失败时的上报（TUI 走 Ink notice）；默认丢弃 */
+    onError?: (text: string) => void;
+}
+export declare class ConversationPersistPlugin implements AgentPlugin {
+    private options;
+    constructor(options: ConversationPersistPluginOptions);
+    onInnerLoopEnd(ctx: SendContext): Promise<void>;
+}
+//# sourceMappingURL=conversation-persist-plugin.d.ts.map

package/dist/conversation-persist-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-persist-plugin.d.ts","sourceRoot":"","sources":["../src/conversation-persist-plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAKnE,MAAM,WAAW,gCAAgC;IAC/C,+BAA+B;IAC/B,KAAK,EAAE,MAAM,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,sCAAsC;IACtC,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAClC;AAED,qBAAa,yBAA0B,YAAW,WAAW;IAC/C,OAAO,CAAC,OAAO;gBAAP,OAAO,EAAE,gCAAgC;IAEvD,cAAc,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;CAyBtD"}

package/dist/conversation-persist-plugin.js

@@ -0,0 +1,44 @@
+/**
+ * ConversationPersistPlugin — 会话自动落盘插件。
+ *
+ * 取代原 `DraftPlugin`：不再写单文件草稿，而是每轮内循环结束后把当前
+ * 消息写入该会话文件（`conversations/<id>.json`），并更新「上一轮会话 id」指针。
+ *
+ * 采用「方案 B」：仅在产生实质内容（至少一条用户消息）时落盘，避免留下空会话。
+ * 会话 id 通过 `getId()` 动态获取，以便任务迁移切换新会话后依然落盘到正确的文件。
+ */
+import { AgentNS } from "@ai-zen/agents-core";
+import { conversationRepository } from "./conversation-repository.js";
+import { writeLastSession } from "./session-pointer.js";
+export class ConversationPersistPlugin {
+    options;
+    constructor(options) {
+        this.options = options;
+    }
+    async onInnerLoopEnd(ctx) {
+        const { getId, agentId, modelId, cwd, onError } = this.options;
+        const messages = ctx.agent.messages;
+        // 尚无实质内容（没有用户消息）时不落盘，避免产生空会话文件
+        if (!messages.some((m) => m.role === AgentNS.Role.User))
+            return;
+        const id = getId();
+        try {
+            const existing = await conversationRepository.read(id);
+            const now = new Date().toISOString();
+            await conversationRepository.write({
+                id,
+                agentId,
+                modelId,
+                messages,
+                cwd,
+                createdAt: existing?.createdAt ?? now,
+                updatedAt: now,
+            });
+            await writeLastSession(cwd ?? process.cwd(), id);
+        }
+        catch (err) {
+            onError?.(`⚠️ 会话落盘失败：${err?.message ?? err}`);
+        }
+    }
+}
+//# sourceMappingURL=conversation-persist-plugin.js.map

package/dist/conversation-persist-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-persist-plugin.js","sourceRoot":"","sources":["../src/conversation-persist-plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAYxD,MAAM,OAAO,yBAAyB;IAChB;IAApB,YAAoB,OAAyC;QAAzC,YAAO,GAAP,OAAO,CAAkC;IAAG,CAAC;IAEjE,KAAK,CAAC,cAAc,CAAC,GAAgB;QACnC,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC;QAC/D,MAAM,QAAQ,GAAG,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC;QAEpC,+BAA+B;QAC/B,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,OAAO;QAEhE,MAAM,EAAE,GAAG,KAAK,EAAE,CAAC;QACnB,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,sBAAsB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACvD,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YACrC,MAAM,sBAAsB,CAAC,KAAK,CAAC;gBACjC,EAAE;gBACF,OAAO;gBACP,OAAO;gBACP,QAAQ;gBACR,GAAG;gBACH,SAAS,EAAE,QAAQ,EAAE,SAAS,IAAI,GAAG;gBACrC,SAAS,EAAE,GAAG;aACf,CAAC,CAAC;YACH,MAAM,gBAAgB,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC;QACnD,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAClB,OAAO,EAAE,CAAC,aAAa,GAAG,EAAE,OAAO,IAAI,GAAG,EAAE,CAAC,CAAC;QAChD,CAAC;IACH,CAAC;CACF"}

package/dist/conversation-repository.d.ts

@@ -3,6 +3,8 @@
  *
  * 会话是 CLI 的产品数据，由 CLI 自己维护（SDK 只负责驱动与能力）。
  * 复用 SDK 的 EntityRepository，按 id 一个 JSON 文件（${conversationsDir}/${id}.json）。
+ *
+ * 「上一轮会话 id」指针（session-pointer.ts）随每次落盘更新，供下次启动续接。
  */
 import { EntityRepository } from "@ai-zen/agents-sdk";
 import type { AgentNS } from "@ai-zen/agents-core";
@@ -20,8 +22,23 @@ export interface Conversation {
 /** 会话仓储：每个会话一个 JSON 文件（${conversationsDir}/${id}.json） */
 export declare const conversationRepository: EntityRepository<Conversation>;
 /**
- * 保存当前对话到 conversations 目录。
- * 迁移前落盘旧会话（onBeforeMigrate）、错误时自动保存等场景共同调用，保证 id 计算一致。
+ * 生成文件名安全的会话 id（语义化中文时间戳，天然不含非法字符）。
+ * 形如 `对话_2025年07月01日14时30分00秒`。
+ */
+export declare function generateConversationId(date?: Date): string;
+/**
+ * 保存当前对话到 conversations 目录，并更新「上一轮会话 id」指针。
+ * 迁移前落盘旧会话（onBeforeMigrate）、手动 /save 等场景共同调用，保证 id 计算一致。
  */
 export declare function saveConversation(ctx: ConversationContext): Promise<string>;
+/**
+ * 列出已保存的会话（仅读文件名与 mtime，不解析 JSON 内容，快），按更新时间倒序。
+ * 供对话内 `/load` 选择器使用。
+ */
+export declare function listConversations(): Promise<Array<{
+    id: string;
+    name: string;
+    updatedAt: string;
+    size: number;
+}>>;
 //# sourceMappingURL=conversation-repository.d.ts.map

package/dist/conversation-repository.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"conversation-repository.d.ts","sourceRoot":"","sources":["../src/conversation-repository.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAEnD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC;IAC5B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,0DAA0D;AAC1D,eAAO,MAAM,sBAAsB,gCAAwD,CAAC;AAE5F;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,CAWhF"}
+{"version":3,"file":"conversation-repository.d.ts","sourceRoot":"","sources":["../src/conversation-repository.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAInD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC;IAC5B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,0DAA0D;AAC1D,eAAO,MAAM,sBAAsB,gCAAwD,CAAC;AAE5F;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,GAAE,IAAiB,GAAG,MAAM,CAEtE;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,CAchF;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAChD,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CACrE,CAmBA"}

package/dist/conversation-repository.js

@@ -3,25 +3,68 @@
  *
  * 会话是 CLI 的产品数据，由 CLI 自己维护（SDK 只负责驱动与能力）。
  * 复用 SDK 的 EntityRepository，按 id 一个 JSON 文件（${conversationsDir}/${id}.json）。
+ *
+ * 「上一轮会话 id」指针（session-pointer.ts）随每次落盘更新，供下次启动续接。
  */
+import { promises as fs } from "node:fs";
+import { join } from "node:path";
 import { EntityRepository } from "@ai-zen/agents-sdk";
 import { CONVERSATIONS_DIR } from "./config.js";
+import { formatShortTime } from "./format-time.js";
+import { writeLastSession } from "./session-pointer.js";
 /** 会话仓储：每个会话一个 JSON 文件（${conversationsDir}/${id}.json） */
 export const conversationRepository = new EntityRepository(CONVERSATIONS_DIR);
 /**
- * 保存当前对话到 conversations 目录。
- * 迁移前落盘旧会话（onBeforeMigrate）、错误时自动保存等场景共同调用，保证 id 计算一致。
+ * 生成文件名安全的会话 id（语义化中文时间戳，天然不含非法字符）。
+ * 形如 `对话_2025年07月01日14时30分00秒`。
+ */
+export function generateConversationId(date = new Date()) {
+    return `对话_${formatShortTime(date.toISOString())}`.replace(/[\\/:*?"<>|]/g, "_");
+}
+/**
+ * 保存当前对话到 conversations 目录，并更新「上一轮会话 id」指针。
+ * 迁移前落盘旧会话（onBeforeMigrate）、手动 /save 等场景共同调用，保证 id 计算一致。
  */
 export async function saveConversation(ctx) {
-    const id = ctx.currentId || ctx.currentName.replace(/[\\/:*?"<>|]/g, "_");
+    const id = ctx.currentId || generateConversationId();
+    const existing = await conversationRepository.read(id);
+    const now = new Date().toISOString();
     await conversationRepository.write({
         id,
         agentId: ctx.agentId || "default",
         modelId: ctx.modelId,
         messages: ctx.agent.messages,
-        createdAt: new Date().toISOString(),
-        updatedAt: new Date().toISOString(),
+        createdAt: existing?.createdAt ?? now,
+        updatedAt: now,
     });
+    await writeLastSession(process.cwd(), id);
     return id;
 }
+/**
+ * 列出已保存的会话（仅读文件名与 mtime，不解析 JSON 内容，快），按更新时间倒序。
+ * 供对话内 `/load` 选择器使用。
+ */
+export async function listConversations() {
+    try {
+        await fs.access(CONVERSATIONS_DIR);
+    }
+    catch {
+        return [];
+    }
+    const files = await fs.readdir(CONVERSATIONS_DIR);
+    const result = [];
+    for (const file of files) {
+        if (!file.endsWith(".json"))
+            continue;
+        const id = file.replace(/\.json$/, "");
+        try {
+            const st = await fs.stat(join(CONVERSATIONS_DIR, file));
+            result.push({ id, name: id, updatedAt: st.mtime.toISOString(), size: st.size });
+        }
+        catch {
+            /* 跳过读取失败的条目 */
+        }
+    }
+    return result.sort((a, b) => new Date(b.updatedAt).getTime() - new Date(a.updatedAt).getTime());
+}
 //# sourceMappingURL=conversation-repository.js.map

package/dist/conversation-repository.js.map

@@ -1 +1 @@
-{"version":3,"file":"conversation-repository.js","sourceRoot":"","sources":["../src/conversation-repository.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAchD,0DAA0D;AAC1D,MAAM,CAAC,MAAM,sBAAsB,GAAG,IAAI,gBAAgB,CAAe,iBAAiB,CAAC,CAAC;AAE5F;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,GAAwB;IAC7D,MAAM,EAAE,GAAG,GAAG,CAAC,SAAS,IAAI,GAAG,CAAC,WAAW,CAAC,OAAO,CAAC,eAAe,EAAE,GAAG,CAAC,CAAC;IAC1E,MAAM,sBAAsB,CAAC,KAAK,CAAC;QACjC,EAAE;QACF,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,SAAS;QACjC,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,QAAQ,EAAE,GAAG,CAAC,KAAK,CAAC,QAAQ;QAC5B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC,CAAC;IACH,OAAO,EAAE,CAAC;AACZ,CAAC"}
+{"version":3,"file":"conversation-repository.js","sourceRoot":"","sources":["../src/conversation-repository.ts"],"names":[],"mappings":"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"}

package/dist/format-time.d.ts

@@ -2,7 +2,7 @@
  * 统一时间格式化工具
  *
  * 所有用户可见的时间文案统一使用 dayjs + zh-cn locale，
- * 确保各种场景（主菜单、对话列表、Agent 列表、草稿保存等）显示一致。
+ * 确保各种场景（会话列表、会话标签等）显示一致。
  */
 import "dayjs/locale/zh-cn.js";
 /**
@@ -26,7 +26,7 @@ export declare function formatFullTime(isoString: string): string;
  */
 export declare function formatShortTime(isoString: string): string;
 /**
- * 格式化消息数量+时间（用于主菜单草稿提示）
+ * 格式化消息数量+时间（用于会话标签；当前暂无调用点，保留供 P1 主菜单复用）
  * 例：12 条消息, 今天 14:30
  */
 export declare function formatMessageTime(messageCount: number, isoString: string): string;

package/dist/format-time.js

@@ -2,7 +2,7 @@
  * 统一时间格式化工具
  *
  * 所有用户可见的时间文案统一使用 dayjs + zh-cn locale，
- * 确保各种场景（主菜单、对话列表、Agent 列表、草稿保存等）显示一致。
+ * 确保各种场景（会话列表、会话标签等）显示一致。
  */
 import dayjs from "dayjs";
 import "dayjs/locale/zh-cn.js";
@@ -46,7 +46,7 @@ export function formatShortTime(isoString) {
     return dayjs(isoString).format("YYYY年MM月DD日HH时mm分ss秒");
 }
 /**
- * 格式化消息数量+时间（用于主菜单草稿提示）
+ * 格式化消息数量+时间（用于会话标签；当前暂无调用点，保留供 P1 主菜单复用）
  * 例：12 条消息, 今天 14:30
  */
 export function formatMessageTime(messageCount, isoString) {

package/dist/handoff-service.d.ts

@@ -0,0 +1,19 @@
+import { HandoffService, type HandoffMode } from "@ai-zen/agents-sdk";
+import type { ConversationContext } from "./types.js";
+/** 执行者的中文名（供提示文案使用） */
+export declare function describeMode(mode: HandoffMode): string;
+/**
+ * 创建 CLI 交接服务实例（自动迁移与 `/migrate` / `/handoff` 共用同一个实例）。
+ *
+ * 分工：
+ *   - **SDK**：`handoff()`（停工 → 写文档 → 校验 → 失败降级）与 `migrate()`（+ 清历史、注入断点）；
+ *   - **CLI（本函数）**：只补产品侧副作用——进度提示、旧会话存档、新会话落盘与指针更新。
+ *
+ * @param ctx 当前会话上下文（先建后回填 handoffService；钩子直接引用该对象）
+ */
+export declare function createHandoffService(ctx: ConversationContext, options?: {
+    log?: (text: string) => void;
+    /** 交接文档目录；默认项目级 `<cwd>/.ai-zen/handoffs`（测试/多工作区可覆盖） */
+    handoffDir?: string;
+}): HandoffService;
+//# sourceMappingURL=handoff-service.d.ts.map

package/dist/handoff-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handoff-service.d.ts","sourceRoot":"","sources":["../src/handoff-service.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EAEd,KAAK,WAAW,EACjB,MAAM,oBAAoB,CAAC;AAS5B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD,uBAAuB;AACvB,wBAAgB,YAAY,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAEtD;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,mBAAmB,EACxB,OAAO,GAAE;IACP,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,wDAAwD;IACxD,UAAU,CAAC,EAAE,MAAM,CAAC;CAChB,GACL,cAAc,CAwEhB"}

package/dist/handoff-service.js

@@ -0,0 +1,87 @@
+import { HandoffService, } from "@ai-zen/agents-sdk";
+import { saveConversation, conversationRepository, generateConversationId, } from "./conversation-repository.js";
+import { writeLastSession } from "./session-pointer.js";
+import { PROJECT_HANDOFFS_DIR } from "./config.js";
+import { listSkillDirs } from "./agent-creator.js";
+/** 执行者的中文名（供提示文案使用） */
+export function describeMode(mode) {
+    return mode === "self" ? "原 agent 自交接" : "独立摘要";
+}
+/**
+ * 创建 CLI 交接服务实例（自动迁移与 `/migrate` / `/handoff` 共用同一个实例）。
+ *
+ * 分工：
+ *   - **SDK**：`handoff()`（停工 → 写文档 → 校验 → 失败降级）与 `migrate()`（+ 清历史、注入断点）；
+ *   - **CLI（本函数）**：只补产品侧副作用——进度提示、旧会话存档、新会话落盘与指针更新。
+ *
+ * @param ctx 当前会话上下文（先建后回填 handoffService；钩子直接引用该对象）
+ */
+export function createHandoffService(ctx, options = {}) {
+    // 进度/结果一律经 `log` 上报（TUI 走 Ink notice 块），不直接 console.log 污染画面
+    const log = options.log ?? (() => { });
+    return new HandoffService({
+        // 交接文档落在项目内，便于随仓库共享与评审
+        handoffDir: options.handoffDir ?? PROJECT_HANDOFFS_DIR,
+        // CLI 采用物理剔除模式：迁移后不保留历史消息，仅保留系统提示 + 交接断点
+        strategy: "prune",
+        // 交接模板的唯一真相源：磁盘上的 handoff Skill（出厂随 SDK 释放，可被项目级覆盖）
+        skillDirs: listSkillDirs(),
+        onBeforeHandoff: (hctx) => {
+            const isAuto = hctx.promptTokens != null && hctx.maxTokens != null;
+            if (isAuto) {
+                log(`📋 检测到上下文即将超限（${hctx.promptTokens}/${hctx.maxTokens} tokens），正在交接（${describeMode(hctx.requestedMode)}）…`);
+            }
+            else {
+                log(`📋 正在编写任务交接文档（${describeMode(hctx.requestedMode)}）…`);
+            }
+        },
+        onHandoff: async (hctx) => {
+            // 降级时告知用户：请求的执行者与实际执行者不一致
+            if (hctx.mode !== hctx.requestedMode) {
+                log(`⚠️ ${describeMode(hctx.requestedMode)}未能产出文档，已降级为${describeMode(hctx.mode)}`);
+            }
+            log(`📄 交接文档：${hctx.handoffPath}`);
+            // 迁移前（历史尚未剔除）保存旧对话：此时已包含交接回合，可完整审计
+            if (hctx.migrating) {
+                await saveConversation(ctx);
+                log(`✅ 原对话已保存：${ctx.currentName}`);
+            }
+        },
+        onMigrated: async (hctx) => {
+            // 清空「最近一次用量」：prune 已把上下文物理重置（仅留系统提示 + 交接断点），
+            // 但 lastUsage 仍是迁移前/交接回合的 prompt_tokens。若不清理，下一次发送时
+            // ContextGuardPlugin（`onInnerLoopStart` 以 maxTokens × ratio 为硬上限）会拿这个
+            // 陈旧值判定，立即抛出「上下文严重超限」而中断——用户表现为「迁移完成后第一条
+            // 消息就被总上下文保护插件拦截」。置空后护栏首轮无据可查而放行，待下一次响应
+            // 以真实（已大幅缩小的）用量回填。
+            hctx.agent.lastUsage = undefined;
+            // 迁移开启新会话：分配新的会话 id 与名称
+            const id = generateConversationId();
+            ctx.currentId = id;
+            ctx.currentName = id;
+            log(`🚀 任务迁移完成，已开启新会话（共 ${hctx.agent.messages.length} 条消息）`);
+            log("💡 新助手会先读取交接文档，随后即可继续推进任务。");
+            // 迁移后立即把新开场白落盘为独立会话文件，并更新「上一轮会话 id」指针，
+            // 避免迁移发生在 onAfterSend（ConversationPersistPlugin 的 onInnerLoopEnd
+            // 已不再触发）导致迁移后的新对话未被及时落盘、用户中途退出时丢失。
+            try {
+                const existing = await conversationRepository.read(id);
+                const now = new Date().toISOString();
+                await conversationRepository.write({
+                    id,
+                    agentId: ctx.agentId || "default",
+                    modelId: ctx.modelId,
+                    messages: hctx.agent.messages,
+                    cwd: process.cwd(),
+                    createdAt: existing?.createdAt ?? now,
+                    updatedAt: now,
+                });
+                await writeLastSession(process.cwd(), id);
+            }
+            catch (err) {
+                log(`⚠️ 迁移后会话落盘失败：${err?.message ?? err}`);
+            }
+        },
+    });
+}
+//# sourceMappingURL=handoff-service.js.map

package/dist/handoff-service.js.map

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

package/dist/hook.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hook.d.ts","sourceRoot":"","sources":["../src/hook.ts"],"names":[],"mappings":"AA0CA,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAgBjD;AAED,wBAAsB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAuCnD"}
+{"version":3,"file":"hook.d.ts","sourceRoot":"","sources":["../src/hook.ts"],"names":[],"mappings":"AA8DA,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CA4BjD;AAED,wBAAsB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAuBnD"}