c0de-agent 1.10.0 → 1.12.0

package/dist/session/types.d.ts

@@ -91,17 +91,27 @@ type ArchiveRef = {
     type: 'archive' | 'squash';
     id: string;
 };
+/** 会话级用量汇总（P0 审查：列表视图此前无法回答「会话花了多少 token/钱」）。
+ *  从 metadata.segments 聚合，零额外查询。 */
+type SessionUsage = {
+    inputTokens: number;
+    outputTokens: number;
+    cacheRead: number;
+    cost: number;
+    calls: number;
+};
 /** A node in the session tree. */
 type SessionTreeNode = {
     session: Session;
     children: SessionTreeNode[];
+    usage: SessionUsage;
 };
 /** A decoded compaction archive row. */
 type CompactionArchive = {
     id: string;
     sessionId: string;
     compactionId: string;
-    archiveType: 'compaction' | 'squash' | 'shake';
+    archiveType: 'compaction' | 'squash' | 'shake' | 'clear';
     originalEntries: SessionEntry[];
     summary: string;
     tokenCount: number;
@@ -121,4 +131,4 @@ type FileSnapshot = {
     mtimeMs?: number;
     createdAt: number;
 };
-export type { ArchiveRef, BranchSummaryEntry, CompactionArchive, CompactionConfig, CompactionEntry, CompactionResult, FileSnapshot, HotFile, MessageInput, SessionEntry, SessionTreeNode, SquashConfig, SquashEntry, SteeringEntry, Summarizer, };
+export type { ArchiveRef, BranchSummaryEntry, CompactionArchive, CompactionConfig, CompactionEntry, CompactionResult, FileSnapshot, HotFile, MessageInput, SessionEntry, SessionTreeNode, SessionUsage, SquashConfig, SquashEntry, SteeringEntry, Summarizer, };

package/dist/shared/types/agent.d.ts

@@ -148,6 +148,20 @@ type AgentEvent = {
     toolCallId: string;
     tool: string;
     input: unknown;
+}
+/** P1-6：权限确认超时（5 分钟）被自动拒绝时通知前端，提供「重新询问」入口。 */
+ | {
+    _tag: 'permission_timeout';
+    toolCallId: string;
+    tool: string;
+    input: unknown;
+}
+/** P0 双层超时：提示后仍无响应，pending 已兜底自动拒绝（run 继续）——前端须清理弹窗状态。 */
+ | {
+    _tag: 'permission_expired';
+    toolCallId: string;
+    tool: string;
+    input: unknown;
 } | {
     _tag: 'error';
     error: AgentError;
@@ -195,6 +209,10 @@ type AgentEvent = {
             status: string;
         }[];
     }[];
+}
+/** SSE 心跳（服务端防前端 90s 静默看门狗误杀长任务）；前端无 UI 变化，直接忽略。 */
+ | {
+    _tag: 'heartbeat';
 } | {
     _tag: 'done';
 };
@@ -245,5 +263,9 @@ type AgentState = {
         remaining: number;
         noTextStreak: number;
     };
+    /** 本次 run 开始时间戳（ms）。暂停持久化 lastRun 时回填 startedAt。 */
+    lastRunStartedAt?: number;
+    /** 暂停状态是否已 yield 给前端（loop 内用，防重复 status_change）。 */
+    pauseYielded?: boolean;
 };
 export type { AgentConfig, AgentError, AgentEvent, AgentState, AgentStatus, LLMCall, LLMSegment, PendingToolCall, SegmentTrigger, TokenBudget, };

package/dist/shared/types/config.d.ts

@@ -64,6 +64,11 @@ type UpdateConfig = {
     intervalMs: number;
     /** 启动后首次检查的延迟（毫秒），默认 10 秒。 */
     initialDelayMs: number;
+    /** 热更新前暂停活跃 run 的等待超时（毫秒），默认 30 秒。
+     *  暂停会等当前原子操作（工具执行）完成；超时仍未暂停的 run 将被强制中止。 */
+    pauseTimeoutMs?: number;
+    /** 手动安装等待程序文件变更的超时（毫秒），默认 10 分钟。 */
+    manualWaitTimeoutMs?: number;
 };
 /** Server security configuration (spec §24.2)。 */
 type SecurityConfig = {
@@ -76,6 +81,11 @@ type SecurityConfig = {
     token?: string;
     /** 额外允许的 CORS origin（本地回环始终允许；局域网/远程访问需显式添加）。 */
     allowedOrigins: string[];
+    /** 首设备 bootstrap token 有效期（毫秒）。bootstrap 自生成（auth-token 文件
+     *  mtime）起超过此时长即拒绝首设备注册。未设置时默认 5 分钟（auth-manager 内置）；
+     * 无已注册设备时每次 serve 都会重新生成 bootstrap，故重启即可恢复注册。
+     *  用于共享主机等 URL 可能泄漏的场景，缩短「先到先得」竞态窗口。 */
+    firstDeviceTtlMs?: number;
 };
 /** Global application configuration. */
 type Config = {
@@ -116,6 +126,5 @@ type Config = {
     permission: PermissionConfig;
     update: UpdateConfig;
     theme: 'light' | 'dark' | 'system';
-    locale: string;
 };
 export type { AgentsConfig, CompactionConfig, Config, MCPServerConfig, PermissionConfig, SecurityConfig, ToolMetricsConfig, UpdateConfig, WebSearchConfig, };

package/dist/shared/types/kanban.d.ts

@@ -70,6 +70,19 @@ interface KanbanStore {
         columns?: KanbanColumnDef[];
         labels?: KanbanLabelDef[];
     }): Promise<KanbanBoard>;
+    /** 导入/替换整板：列与标签配置 + 全部卡片原子替换（导入数据的落点）。 */
+    replaceBoard(input: {
+        columns: KanbanColumnDef[];
+        labels: KanbanLabelDef[];
+        cards: Array<{
+            title: string;
+            description?: string | null;
+            columnId: string;
+            priority: KanbanPriority;
+            position: number;
+            labels: string[];
+        }>;
+    }): Promise<KanbanBoardWithCards>;
 }
 export type { KanbanBoard, KanbanBoardWithCards, KanbanCard, KanbanColumnDef, KanbanLabelDef, KanbanPriority, KanbanStore, };
 export { DEFAULT_KANBAN_COLUMNS, KANBAN_LABEL_COLORS };

package/dist/shared/types/message.d.ts

@@ -35,9 +35,9 @@ type Message = {
     tokenCount: number;
     createdAt: number;
 };
-/** 上次 agent run 的持久化状态（服务重启后检测中断用）。 */
+/** 上次 agent run 的持久化状态（服务重启后检测中断/恢复用）。 */
 type LastRun = {
-    status: 'running' | 'completed';
+    status: 'running' | 'completed' | 'paused';
     agentName?: string;
     provider?: string;
     model?: string;
@@ -54,6 +54,15 @@ type SessionMetadata = {
     lastRun?: LastRun;
     /** 上次打开时间戳（ms），用于会话列表按最近打开排序。 */
     lastOpenedAt?: number;
+    /** P2：会话级授权模式覆盖（'auto'/'default'），跨重启持久化。 */
+    permissionMode?: 'auto' | 'default';
+    /** 回收站条目首次被用户看到的时间戳（ms）。回收站保留期自此起算，而非删除时间——
+     *  避免「删除后长期不开服务，重启即被静默物理清除、从未见过倒计时」的墙钟缺陷。
+     *  只标记一次（touchTrashSeen 不重置），保证倒计时稳定可预期。 */
+    trashSeenAt?: number;
+    /** 回收站条目已到期、进入物理清除宽限期的时间戳（ms）。
+     *  到期先标记，宽限期（默认 7 天）内可在 UI 恢复；期满后由 purgeDeletedSessions 物理清除。 */
+    purgePendingAt?: number;
 };
 /** A conversation session (may have a parent for branching). */
 type Session = {
@@ -67,6 +76,10 @@ type Session = {
     agentType: string | null;
     /** 隔离 worktree 路径（null=共享父 cwd）。 */
     worktreePath: string | null;
+    /** 会话来源：'web'（Web UI）/ 'cli'（CLI print 模式）；null=旧数据视为 web。 */
+    source: 'web' | 'cli' | null;
+    /** 软删除时间戳（ms）；null=未删除。 */
+    deletedAt: number | null;
     createdAt: number;
     updatedAt: number;
 };

package/dist/tools/index.js

@@ -75,8 +75,7 @@ export function createDefaultRegistry(config = DEFAULT_CONFIG) {
 export function resolveEnabledToolNames(registry, config, explicit) {
     const all = listTools(registry).map((t) => t.name);
     const disabled = new Set(config.tools?.disabled ?? []);
-    const base = explicit ?? (config.tools?.enabled && config.tools.enabled.length > 0
-        ? config.tools.enabled
-        : all);
+    const base = explicit ??
+        (config.tools?.enabled && config.tools.enabled.length > 0 ? config.tools.enabled : all);
     return base.filter((n) => all.includes(n) && !disabled.has(n));
 }

package/dist/tools/websearch/index.js

@@ -1,3 +1,4 @@
+import { decryptSecret } from '../../core/secret.js';
 import { createFetch } from './fetch.js';
 import { braveProvider } from './providers/brave.js';
 import { duckduckgoProvider } from './providers/duckduckgo.js';
@@ -8,11 +9,13 @@ const PROVIDERS = {
     tavily: tavilyProvider,
     brave: braveProvider,
 };
-/** 环境变量名 → config key 字段映射。环境变量优先于 config。 */
+/** 环境变量名 → config key 字段映射。环境变量优先于 config。
+ *  config 值落盘时已加密（enc: 前缀），此处解密后使用（明文兼容透传）。 */
 function resolveKeys(config) {
+    const decrypt = (v) => (v ? decryptSecret(v) : v);
     return {
-        tavily: process.env.TAVILY_API_KEY ?? config.tavilyApiKey,
-        brave: process.env.BRAVE_API_KEY ?? config.braveApiKey,
+        tavily: process.env.TAVILY_API_KEY ?? decrypt(config.tavilyApiKey),
+        brave: process.env.BRAVE_API_KEY ?? decrypt(config.braveApiKey),
     };
 }
 /** 按 preference + key 可用性解析目标 provider。auto 优先级：tavily > brave > duckduckgo。 */

package/dist/update/index.d.ts

@@ -1,10 +1,10 @@
 export type { HandoffServer } from './ipc.js';
-export { createHandoffServer, requestHandoff } from './ipc.js';
+export { confirmHandoff, createHandoffServer, requestHandoff } from './ipc.js';
 export type { UpdateScheduler, UpdateSchedulerOptions } from './scheduler.js';
 export { createUpdateScheduler } from './scheduler.js';
 export type { SerializedEntry, SerializedSession, SessionSnapshot } from './snapshot.js';
 export { orderSessionsByParent, restoreSessions, serializeSessions } from './snapshot.js';
-export type { HotUpdateOptions, HotUpdateResult, SpawnFn } from './updater.js';
-export { cleanupSnapshot, performHotUpdate } from './updater.js';
+export type { HotUpdateOptions, HotUpdateResult, InstallMethod, InstallOnlyResult, SpawnFn, } from './updater.js';
+export { cleanupSnapshot, manualInstallCommand, performHandoff, performHotUpdate, performInstall, } from './updater.js';
 export type { UpdateCheckResult } from './version.js';
 export { checkForUpdate, compareSemver, getCurrentVersion } from './version.js';

package/dist/update/index.js

@@ -1,6 +1,6 @@
 // 热更新 + 会话迁移包（spec §18）。
-export { createHandoffServer, requestHandoff } from './ipc.js';
+export { confirmHandoff, createHandoffServer, requestHandoff } from './ipc.js';
 export { createUpdateScheduler } from './scheduler.js';
 export { orderSessionsByParent, restoreSessions, serializeSessions } from './snapshot.js';
-export { cleanupSnapshot, performHotUpdate } from './updater.js';
+export { cleanupSnapshot, manualInstallCommand, performHandoff, performHotUpdate, performInstall, } from './updater.js';
 export { checkForUpdate, compareSemver, getCurrentVersion } from './version.js';

package/dist/update/ipc.d.ts

@@ -14,11 +14,22 @@ type HandoffOptions = {
      * 旧实例与新实例读同一 auth-token 文件（或同一 config token），天然匹配。
      */
     expectedToken?: string;
+    /**
+     * 自定义校验函数（P2-16：token 轮换后新旧实例 bootstrap 可能不同，
+     * 用 authManager.verifyHandoff 接受当前/历史 bootstrap 与设备 token）。
+     * 提供时优先于 expectedToken。
+     */
+    verify?: (token: string | undefined) => boolean;
     /**
      * 响应发出后退出进程（旧实例完整让渡：主服务与资源已在 onHandoff 中关闭）。
-     * 退出延迟 250ms 保证 HTTP 响应刷出；不设时仅响应不退出（测试用）。
+     * 退出延迟 250ms 保证 HTTP 响应刷出；不设时仅响应不退出（测试用 / 两阶段交接）。
      */
     exitAfterResponse?: boolean;
+    /**
+     * 收到 POST /handoff-confirm 时调用（两阶段交接第二阶段）：
+     * 新实例绑定端口成功后的确认。调用方在此清理定时器并退出进程。
+     */
+    onConfirm?: () => void | Promise<void>;
 };
 /**
  * requestHandoff 抛出的可区分错误（调用方据此分流处理）：
@@ -38,5 +49,11 @@ type HandoffError = Error & {
 declare function createHandoffServer(onHandoff: () => Promise<void>, opts?: HandoffOptions): Promise<HandoffServer>;
 /** 新实例请求旧实例让出端口（graceful shutdown）。失败抛可区分的 HandoffError。 */
 declare function requestHandoff(port: number, host?: string, token?: string): Promise<void>;
+/**
+ * 两阶段交接第二阶段（P3 回滚修复）：新实例绑定端口成功后 POST /handoff-confirm，
+ * 旧实例收到才退出进程。连接失败/旧实例已退出时静默——确认是尽力而为，
+ * 超时兜底由旧实例的复活窗口负责（端口占用状态是最终裁判）。
+ */
+declare function confirmHandoff(port: number, host?: string, token?: string): Promise<void>;
 export type { HandoffError, HandoffOptions, HandoffServer };
-export { createHandoffServer, requestHandoff };
+export { confirmHandoff, createHandoffServer, requestHandoff };

package/dist/update/ipc.js

@@ -16,16 +16,37 @@ function authHeaderMatches(actual, expected) {
  */
 function createHandoffServer(onHandoff, opts = {}) {
     return new Promise((resolve, reject) => {
-        const expected = opts.expectedToken && opts.expectedToken.length > 0
-            ? `Bearer ${opts.expectedToken}`
-            : '';
+        const expected = opts.expectedToken && opts.expectedToken.length > 0 ? `Bearer ${opts.expectedToken}` : '';
         const handler = async (req, res) => {
-            if (req.method === 'POST' && req.url === '/handoff') {
-                if (expected && !authHeaderMatches(req.headers.authorization, expected)) {
+            if (req.method === 'POST' && (req.url === '/handoff' || req.url === '/handoff-confirm')) {
+                const authorized = opts.verify
+                    ? opts.verify(req.headers.authorization?.replace(/^Bearer\s+/i, ''))
+                    : expected.length > 0
+                        ? authHeaderMatches(req.headers.authorization, expected)
+                        : true;
+                if (!authorized) {
                     res.writeHead(401, { 'content-type': 'application/json' });
                     res.end(JSON.stringify({ ok: false, error: 'unauthorized' }));
                     return;
                 }
+                if (req.url === '/handoff-confirm') {
+                    // 两阶段交接第二阶段：新实例绑定成功后的确认。响应后由 onConfirm
+                    // 调度退出；不设 onConfirm 时直接退出（与 exitAfterResponse 独立）。
+                    try {
+                        res.writeHead(200, { 'content-type': 'application/json' });
+                        res.end(JSON.stringify({ ok: true }));
+                        if (opts.onConfirm) {
+                            await opts.onConfirm();
+                        }
+                        else {
+                            setTimeout(() => process.exit(0), 250);
+                        }
+                    }
+                    catch (error) {
+                        console.error('[handoff] confirm handler failed:', error);
+                    }
+                    return;
+                }
                 try {
                     await onHandoff();
                     res.writeHead(200, { 'content-type': 'application/json' });
@@ -84,4 +105,20 @@ async function requestHandoff(port, host = '127.0.0.1', token) {
         throw error;
     }
 }
-export { createHandoffServer, requestHandoff };
+/**
+ * 两阶段交接第二阶段（P3 回滚修复）：新实例绑定端口成功后 POST /handoff-confirm，
+ * 旧实例收到才退出进程。连接失败/旧实例已退出时静默——确认是尽力而为，
+ * 超时兜底由旧实例的复活窗口负责（端口占用状态是最终裁判）。
+ */
+async function confirmHandoff(port, host = '127.0.0.1', token) {
+    try {
+        await fetch(`http://${host}:${port}/handoff-confirm`, {
+            method: 'POST',
+            ...(token ? { headers: { Authorization: `Bearer ${token}` } } : {}),
+        });
+    }
+    catch {
+        // 旧实例已退出或不可达：无确认对象，忽略。
+    }
+}
+export { confirmHandoff, createHandoffServer, requestHandoff };

package/dist/update/snapshot.d.ts

@@ -7,6 +7,11 @@ type SerializedSession = {
     projectId: string | null;
     branchPoint: number | null;
     metadata: unknown;
+    agentType: string | null;
+    worktreePath: string | null;
+    source: string | null;
+    deletedAt: number | null;
+    deletedBatchId: string | null;
     createdAt: number;
     updatedAt: number;
 };

package/dist/update/snapshot.js

@@ -15,6 +15,11 @@ function toSerializedSession(row) {
         projectId: row.projectId,
         branchPoint: row.branchPoint,
         metadata: row.metadata,
+        agentType: row.agentType,
+        worktreePath: row.worktreePath,
+        source: row.source,
+        deletedAt: row.deletedAt ? toDateMs(row.deletedAt) : null,
+        deletedBatchId: row.deletedBatchId ?? null,
         createdAt: toDateMs(row.createdAt),
         updatedAt: toDateMs(row.updatedAt),
     };
@@ -75,6 +80,11 @@ async function restoreSessions(handle, snapshot) {
             projectId: s.projectId,
             branchPoint: s.branchPoint,
             metadata: s.metadata,
+            agentType: s.agentType,
+            worktreePath: s.worktreePath,
+            source: s.source,
+            deletedAt: s.deletedAt != null ? new Date(s.deletedAt) : null,
+            deletedBatchId: s.deletedBatchId ?? null,
             createdAt: new Date(s.createdAt),
             updatedAt: new Date(s.updatedAt),
         })

package/dist/update/updater.d.ts

@@ -3,6 +3,7 @@ import type { SessionSnapshot } from './snapshot.js';
 type HotUpdateResult = {
     _tag: 'success';
     snapshotPath: string;
+    installMethod: string;
 } | {
     _tag: 'install_failed';
     error: string;
@@ -11,6 +12,23 @@ type HotUpdateResult = {
     _tag: 'spawn_failed';
     error: string;
     snapshotPath: string;
+} | {
+    _tag: 'manual_install_required';
+    error: string;
+    snapshotPath: string;
+    command: string;
+};
+/** 仅安装结果（无活跃 serve 的 CLI `c0de update --apply` 使用；不 spawn 新实例）。 */
+type InstallOnlyResult = {
+    _tag: 'success';
+    installMethod: string;
+} | {
+    _tag: 'install_failed';
+    error: string;
+} | {
+    _tag: 'manual_install_required';
+    error: string;
+    command: string;
 };
 /**
  * 启动新实例的函数签名。
@@ -20,8 +38,8 @@ type HotUpdateResult = {
  */
 type SpawnFn = (snapshotPath: string, argv: string[], opts?: HotUpdateOptions) => Promise<void>;
 type HotUpdateOptions = {
-    /** 自更新安装函数；默认 `npm install -g <pkg>`。 */
-    installFn?: (pkg: string) => Promise<void>;
+    /** 自更新安装函数；默认按检测到的安装方式（npm/pnpm）执行。 */
+    installFn?: (pkg: string, method: InstallMethod) => Promise<void>;
     /** 启动新实例的函数；默认 detached spawn 当前进程入口。 */
     spawnNewInstanceFn?: SpawnFn;
     packageName?: string;
@@ -35,18 +53,61 @@ type HotUpdateOptions = {
     port?: number;
     /** 传给新实例的认证 token（经环境变量 C0DE_AUTH_TOKEN），保证新旧实例握手同 token。 */
     authToken?: string;
+    /** 手动安装等待程序文件变更的超时（ms）；默认 10 分钟，超时放弃等待。 */
+    manualWaitTimeoutMs?: number;
 };
+/** 安装方式（P0-2：识别当前进程安装器；unknown = 不自动安装，提示手动更新）。 */
+type InstallMethod = {
+    kind: 'npm';
+} | {
+    kind: 'pnpm';
+} | {
+    kind: 'unknown';
+    hint: string;
+};
+/**
+ * 识别当前进程的安装方式：
+ * - 入口脚本 realpath 含 node_modules/.pnpm → pnpm
+ * - 含 node_modules（非 .pnpm）→ npm
+ * - 否则 unknown（npx 缓存、源码 dev、其他）→ 不自动安装
+ * 检测不到时返回 unknown，由上层提示用户手动安装。
+ */
+declare function detectInstallMethod(): InstallMethod;
+/** 手动安装提示命令（unknown 安装方式时返回给前端展示）。 */
+declare function manualInstallCommand(pkg: string): string;
+/**
+ * 分阶段热更新的第二阶段（P0 修复：install 与 pause 解耦）。
+ *
+ * 调用方（/api/update/apply）顺序：
+ *   1. checkNow → hasUpdate
+ *   2. performInstall（仅安装；失败时**尚未暂停任何会话**，直接 409 可操作错误）
+ *   3. 安装成功 → pauseAll（暂停活跃 run 至安全点）
+ *   4. serializeSessions → performHandoff（本函数：写快照 + spawn 新实例）
+ *   5. spawn 失败 → 调用方 resumeAll 回滚暂停的会话
+ *
+ * 对比旧流程（pause → 序列化 → performHotUpdate 内含 install）：install 失败时
+ * 会话已被 pause/forcedAbort 且无回滚路径——更新失败顺带销毁进行中的工作。
+ */
+declare function performHandoff(snapshot: SessionSnapshot, method: InstallMethod, opts?: HotUpdateOptions): Promise<HotUpdateResult>;
 /**
- * 执行热更新（spec §18.1-18.2 流程）：
+ * 执行热更新（spec §18.1-18.2 + P0-2 修订流程）：
  *   1. 序列化当前会话状态到快照文件
- *   2. 全局自更新（npm install -g）
- *   3. detached 启动新版本实例，传入快照路径（新实例 restore + 端口接管）
+ *   2. 识别当前进程安装方式（npm/pnpm/unknown）
+ *   3. 已知方式 → 自动安装；unknown → 不安装，等待用户手动安装
+ *   4. watch 当前执行程序文件变更 → 触发滚动切换
+ *      （detached 启动新实例 + restore 快照 + handoff 端口接管）
  *
  * 注：旧实例的 graceful shutdown / 端口让渡由新实例启动后通过 IPC 协调
- * （见 ipc.ts），本函数只负责"序列化 + 安装 + 接力"。
+ * （见 ipc.ts），本函数只负责"序列化 + 安装 + 等待程序变更 + 接力"。
  */
 declare function performHotUpdate(snapshot: SessionSnapshot, opts?: HotUpdateOptions): Promise<HotUpdateResult>;
+/**
+ * 仅安装新版本（P2-7：无活跃 serve 的 `c0de update --apply`）。
+ * 不序列化快照、不 spawn `serve`——此前独立 CLI 执行会拉起一个用户未请求的常驻服务。
+ * 运行中的 serve 由 `/api/update/apply` 走 performHotUpdate 热更新路径。
+ */
+declare function performInstall(opts?: HotUpdateOptions): Promise<InstallOnlyResult>;
 /** 清理快照临时目录（热更新完成或放弃后调用）。 */
 declare function cleanupSnapshot(snapshotPath: string): Promise<void>;
-export type { HotUpdateOptions, HotUpdateResult, SpawnFn };
-export { cleanupSnapshot, performHotUpdate };
+export type { HotUpdateOptions, HotUpdateResult, InstallMethod, InstallOnlyResult, SpawnFn };
+export { cleanupSnapshot, detectInstallMethod, manualInstallCommand, performHandoff, performHotUpdate, performInstall, };