c0de-agent 1.11.0 → 1.12.0

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

@@ -81,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 = {
@@ -121,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

@@ -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 = {

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, performInstall } 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, performInstall } 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

@@ -22,9 +22,14 @@ type HandoffOptions = {
     verify?: (token: string | undefined) => boolean;
     /**
      * 响应发出后退出进程（旧实例完整让渡：主服务与资源已在 onHandoff 中关闭）。
-     * 退出延迟 250ms 保证 HTTP 响应刷出；不设时仅响应不退出（测试用）。
+     * 退出延迟 250ms 保证 HTTP 响应刷出；不设时仅响应不退出（测试用 / 两阶段交接）。
      */
     exitAfterResponse?: boolean;
+    /**
+     * 收到 POST /handoff-confirm 时调用（两阶段交接第二阶段）：
+     * 新实例绑定端口成功后的确认。调用方在此清理定时器并退出进程。
+     */
+    onConfirm?: () => void | Promise<void>;
 };
 /**
  * requestHandoff 抛出的可区分错误（调用方据此分流处理）：
@@ -44,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

@@ -18,7 +18,7 @@ function createHandoffServer(onHandoff, opts = {}) {
     return new Promise((resolve, reject) => {
         const expected = opts.expectedToken && opts.expectedToken.length > 0 ? `Bearer ${opts.expectedToken}` : '';
         const handler = async (req, res) => {
-            if (req.method === 'POST' && req.url === '/handoff') {
+            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
@@ -29,6 +29,24 @@ function createHandoffServer(onHandoff, opts = {}) {
                     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' });
@@ -87,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

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

package/dist/update/snapshot.js

@@ -19,6 +19,7 @@ function toSerializedSession(row) {
         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),
     };
@@ -83,6 +84,7 @@ async function restoreSessions(handle, snapshot) {
             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

@@ -75,6 +75,20 @@ type InstallMethod = {
 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 + P0-2 修订流程）：
  *   1. 序列化当前会话状态到快照文件
@@ -96,4 +110,4 @@ declare function performInstall(opts?: HotUpdateOptions): Promise<InstallOnlyRes
 /** 清理快照临时目录（热更新完成或放弃后调用）。 */
 declare function cleanupSnapshot(snapshotPath: string): Promise<void>;
 export type { HotUpdateOptions, HotUpdateResult, InstallMethod, InstallOnlyResult, SpawnFn };
-export { cleanupSnapshot, detectInstallMethod, manualInstallCommand, performHotUpdate, performInstall, };
+export { cleanupSnapshot, detectInstallMethod, manualInstallCommand, performHandoff, performHotUpdate, performInstall, };

package/dist/update/updater.js

@@ -184,6 +184,48 @@ function buildSpawnArgv(snapshotPath, opts) {
     }
     return argv;
 }
+/**
+ * 把快照写入临时目录（或 opts.snapshotPath），返回实际路径。
+ * 独立成函数供 performHotUpdate（一体流程）与 performHandoff（分阶段流程）共用。
+ */
+async function writeSnapshot(snapshot, opts) {
+    const snapshotPath = opts.snapshotPath ?? join(await mkdtemp(join(tmpdir(), 'c0de-update-')), 'snapshot.json');
+    await writeFile(snapshotPath, JSON.stringify(snapshot), 'utf8');
+    return snapshotPath;
+}
+/** 安装完成后的滚动切换：spawn 新实例（restore 快照 + handoff 端口接管由新实例发起）。 */
+async function spawnAfterInstall(snapshotPath, method, opts) {
+    const spawnNew = opts.spawnNewInstanceFn ?? defaultSpawn;
+    const argv = buildSpawnArgv(snapshotPath, opts);
+    try {
+        await spawnNew(snapshotPath, argv, opts);
+    }
+    catch (error) {
+        return {
+            _tag: 'spawn_failed',
+            error: error instanceof Error ? error.message : String(error),
+            snapshotPath,
+        };
+    }
+    return { _tag: 'success', snapshotPath, installMethod: method.kind };
+}
+/**
+ * 分阶段热更新的第二阶段（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 且无回滚路径——更新失败顺带销毁进行中的工作。
+ */
+async function performHandoff(snapshot, method, opts = {}) {
+    const snapshotPath = await writeSnapshot(snapshot, opts);
+    return spawnAfterInstall(snapshotPath, method, opts);
+}
 /**
  * 执行热更新（spec §18.1-18.2 + P0-2 修订流程）：
  *   1. 序列化当前会话状态到快照文件
@@ -197,9 +239,7 @@ function buildSpawnArgv(snapshotPath, opts) {
  */
 async function performHotUpdate(snapshot, opts = {}) {
     const pkg = opts.packageName ?? DEFAULT_PACKAGE;
-    const dir = await mkdtemp(join(tmpdir(), 'c0de-update-'));
-    const snapshotPath = opts.snapshotPath ?? join(dir, 'snapshot.json');
-    await writeFile(snapshotPath, JSON.stringify(snapshot), 'utf8');
+    const snapshotPath = await writeSnapshot(snapshot, opts);
     // 识别安装方式
     const method = detectInstallMethod();
     // 安装前采集程序文件基线（watch 依赖此判断「变更已发生」）
@@ -246,19 +286,7 @@ async function performHotUpdate(snapshot, opts = {}) {
         }
     }
     // 程序文件已变更（自动安装落盘或用户手动安装完成）→ 滚动切换
-    const spawnNew = opts.spawnNewInstanceFn ?? defaultSpawn;
-    const argv = buildSpawnArgv(snapshotPath, opts);
-    try {
-        await spawnNew(snapshotPath, argv, opts);
-    }
-    catch (error) {
-        return {
-            _tag: 'spawn_failed',
-            error: error instanceof Error ? error.message : String(error),
-            snapshotPath,
-        };
-    }
-    return { _tag: 'success', snapshotPath, installMethod: method.kind };
+    return spawnAfterInstall(snapshotPath, method, opts);
 }
 /**
  * 仅安装新版本（P2-7：无活跃 serve 的 `c0de update --apply`）。
@@ -291,4 +319,4 @@ async function performInstall(opts = {}) {
 async function cleanupSnapshot(snapshotPath) {
     await rm(join(snapshotPath, '..'), { recursive: true, force: true }).catch(() => { });
 }
-export { cleanupSnapshot, detectInstallMethod, manualInstallCommand, performHotUpdate, performInstall, };
+export { cleanupSnapshot, detectInstallMethod, manualInstallCommand, performHandoff, performHotUpdate, performInstall, };

package/drizzle/0008_tranquil_lily_hollister.sql

@@ -0,0 +1 @@
+ALTER TABLE "sessions" ADD COLUMN "deleted_batch_id" uuid;