c0de-agent 1.10.0 → 1.11.0

package/dist/session/session.d.ts

@@ -6,13 +6,33 @@ import type { LastRun, Session } from '../shared/types/message.js';
 /** Convert a DB row (with Date timestamps) to the shared Session type (with number timestamps). */
 export declare function rowToSession(row: typeof sessions.$inferSelect): Session;
 /** Create a new root session. */
-declare function createSession(handle: DB, title: string, projectId?: string, agentType?: string): Promise<Session>;
+declare function createSession(handle: DB, title: string, projectId?: string, agentType?: string, source?: 'web' | 'cli'): Promise<Session>;
 /** Get a session by id, or null if not found. */
 declare function getSession(handle: DB, id: string): Promise<Session | null>;
-/** List all sessions. */
+/** List all active sessions (未软删除、非 CLI 来源；source 为 NULL 的旧数据视为 web). */
 declare function listSessions(handle: DB): Promise<Session[]>;
-/** Delete a session (cascades to entries, archives, snapshots via FK). */
-declare function deleteSession(handle: DB, id: string): Promise<void>;
+/** 列出所有未软删除会话（含 CLI 来源；供 ACP/CLI 等非 Web 消费者使用）。 */
+declare function listAllSessions(handle: DB): Promise<Session[]>;
+/** List soft-deleted sessions (回收站). */
+declare function listDeletedSessions(handle: DB): Promise<Session[]>;
+/**
+ * 软删除会话（级联其所有 fork 后代）。设置 deletedAt = now；
+ * 30 天后由 purgeDeletedSessions 物理清除。
+ * 会话不存在或已在回收站 → 返回 false（调用方按 404 处理）。
+ */
+declare function softDeleteSession(handle: DB, id: string): Promise<boolean>;
+/**
+ * 从回收站恢复会话：默认连带恢复其已软删除的祖先链——
+ * 否则恢复的会话因父仍在回收站而游离于会话树之外（P2-1：UI 不可达）。
+ * 祖先中未删除的（活跃）节点不需要也不应该被改动。
+ */
+declare function restoreSession(handle: DB, id: string): Promise<boolean>;
+/**
+ * 物理清除回收站中超过保留期（默认 30 天）的会话。
+ * 子会话先于父会话删除（自引用 FK 要求）。
+ * 返回清除数量。启动时与每日定时调用。
+ */
+declare function purgeDeletedSessions(handle: DB, retentionMs?: number): Promise<number>;
 /** Update a session's title. */
 declare function updateSessionTitle(handle: DB, id: string, title: string): Promise<void>;
 /** Bump updatedAt to now (used after appending messages). */
@@ -36,4 +56,4 @@ export declare function saveLLMSegments(handle: DB, id: string, segments: LLMSeg
 /** 更新会话 metadata.lastRun（agent run 开始/结束时写入；重启后检测中断用）。 */
 declare function updateSessionLastRun(handle: DB, id: string, lastRun: LastRun): Promise<void>;
 declare function listSessionsByProject(handle: DB, projectId: string): Promise<Session[]>;
-export { createSession, deleteSession, getSession, listSessions, listSessionsByProject, touchLastOpened, touchSession, updateSessionLastRun, updateSessionTitle, };
+export { createSession, getSession, listAllSessions, listDeletedSessions, listSessions, listSessionsByProject, purgeDeletedSessions, restoreSession, softDeleteSession, touchLastOpened, touchSession, updateSessionLastRun, updateSessionTitle, };

package/dist/session/session.js

@@ -1,10 +1,15 @@
-import { eq } from 'drizzle-orm';
+import { and, eq, gt, inArray, isNull, lt, ne, or } from 'drizzle-orm';
 import { sessions } from '../db/schema.js';
 import { generateId } from '../shared/index.js';
 /** Convert a DB row (with Date timestamps) to the shared Session type (with number timestamps). */
 export function rowToSession(row) {
     const created = row.createdAt instanceof Date ? row.createdAt.getTime() : new Date(row.createdAt).getTime();
     const updated = row.updatedAt instanceof Date ? row.updatedAt.getTime() : new Date(row.updatedAt).getTime();
+    const deleted = row.deletedAt
+        ? row.deletedAt instanceof Date
+            ? row.deletedAt.getTime()
+            : new Date(row.deletedAt).getTime()
+        : null;
     return {
         id: row.id,
         title: row.title,
@@ -14,15 +19,22 @@ export function rowToSession(row) {
         metadata: (row.metadata ?? {}),
         agentType: row.agentType ?? null,
         worktreePath: row.worktreePath ?? null,
+        source: row.source === 'web' || row.source === 'cli' ? row.source : null,
+        deletedAt: deleted,
         createdAt: created,
         updatedAt: updated,
     };
 }
 /** Create a new root session. */
-async function createSession(handle, title, projectId, agentType) {
+async function createSession(handle, title, projectId, agentType, source) {
     const [row] = await handle.db
         .insert(sessions)
-        .values({ title, projectId: projectId ?? null, agentType: agentType ?? null })
+        .values({
+        title,
+        projectId: projectId ?? null,
+        agentType: agentType ?? null,
+        source: source ?? null,
+    })
         .returning();
     if (!row)
         throw new Error('Failed to insert session');
@@ -33,14 +45,118 @@ async function getSession(handle, id) {
     const [row] = await handle.db.select().from(sessions).where(eq(sessions.id, id));
     return row ? rowToSession(row) : null;
 }
-/** List all sessions. */
+/** List all active sessions (未软删除、非 CLI 来源；source 为 NULL 的旧数据视为 web). */
 async function listSessions(handle) {
-    const rows = await handle.db.select().from(sessions);
+    const rows = await handle.db
+        .select()
+        .from(sessions)
+        .where(and(isNull(sessions.deletedAt), or(isNull(sessions.source), ne(sessions.source, 'cli'))));
     return rows.map(rowToSession);
 }
-/** Delete a session (cascades to entries, archives, snapshots via FK). */
-async function deleteSession(handle, id) {
-    await handle.db.delete(sessions).where(eq(sessions.id, id));
+/** 列出所有未软删除会话（含 CLI 来源；供 ACP/CLI 等非 Web 消费者使用）。 */
+async function listAllSessions(handle) {
+    const rows = await handle.db.select().from(sessions).where(isNull(sessions.deletedAt));
+    return rows.map(rowToSession);
+}
+/** List soft-deleted sessions (回收站). */
+async function listDeletedSessions(handle) {
+    const rows = await handle.db
+        .select()
+        .from(sessions)
+        .where(gt(sessions.deletedAt, new Date(0)));
+    return rows.map(rowToSession);
+}
+/**
+ * 软删除会话（级联其所有 fork 后代）。设置 deletedAt = now；
+ * 30 天后由 purgeDeletedSessions 物理清除。
+ * 会话不存在或已在回收站 → 返回 false（调用方按 404 处理）。
+ */
+async function softDeleteSession(handle, id) {
+    const [row] = await handle.db
+        .select({ id: sessions.id, deletedAt: sessions.deletedAt })
+        .from(sessions)
+        .where(eq(sessions.id, id));
+    if (!row || row.deletedAt)
+        return false;
+    const ids = new Set([id]);
+    let frontier = [id];
+    while (frontier.length > 0) {
+        // 用 parentId 过滤：收集下一层子会话
+        const children = await handle.db
+            .select({ id: sessions.id })
+            .from(sessions)
+            .where(and(isNull(sessions.deletedAt), inArray(sessions.parentId, frontier)));
+        frontier = children.map((r) => r.id).filter((cid) => !ids.has(cid));
+        for (const r of children)
+            ids.add(r.id);
+    }
+    const now = new Date();
+    for (const sid of ids) {
+        await handle.db.update(sessions).set({ deletedAt: now }).where(eq(sessions.id, sid));
+    }
+    return true;
+}
+/**
+ * 从回收站恢复会话：默认连带恢复其已软删除的祖先链——
+ * 否则恢复的会话因父仍在回收站而游离于会话树之外（P2-1：UI 不可达）。
+ * 祖先中未删除的（活跃）节点不需要也不应该被改动。
+ */
+async function restoreSession(handle, id) {
+    const [row] = await handle.db.select().from(sessions).where(eq(sessions.id, id));
+    if (!row || !row.deletedAt)
+        return false;
+    const ids = new Set([id]);
+    let parentId = row.parentId;
+    while (parentId) {
+        const [parent] = await handle.db.select().from(sessions).where(eq(sessions.id, parentId));
+        if (!parent)
+            break;
+        if (parent.deletedAt)
+            ids.add(parent.id);
+        parentId = parent.parentId;
+    }
+    for (const sid of ids) {
+        await handle.db.update(sessions).set({ deletedAt: null }).where(eq(sessions.id, sid));
+    }
+    return true;
+}
+/**
+ * 物理清除回收站中超过保留期（默认 30 天）的会话。
+ * 子会话先于父会话删除（自引用 FK 要求）。
+ * 返回清除数量。启动时与每日定时调用。
+ */
+async function purgeDeletedSessions(handle, retentionMs = 30 * 24 * 60 * 60 * 1000) {
+    const cutoff = new Date(Date.now() - retentionMs);
+    const rows = await handle.db
+        .select({ id: sessions.id, parentId: sessions.parentId })
+        .from(sessions)
+        .where(lt(sessions.deletedAt, cutoff));
+    if (rows.length === 0)
+        return 0;
+    // 拓扑序：无子会话的先删
+    const remaining = new Set(rows.map((r) => r.id));
+    let deleted = 0;
+    while (remaining.size > 0) {
+        const hasChildParent = new Set(rows.filter((r) => r.parentId && remaining.has(r.parentId)).map((r) => r.parentId));
+        const leaves = rows
+            .filter((r) => remaining.has(r.id) && !hasChildParent.has(r.id))
+            .map((r) => r.id);
+        if (leaves.length === 0) {
+            // 循环引用兜底：强制按 id 逐个删除（自引用环数据异常场景）
+            for (const id of Array.from(remaining)) {
+                await handle.db.delete(sessions).where(eq(sessions.id, id));
+                remaining.delete(id);
+                deleted += 1;
+            }
+            break;
+        }
+        for (const id of leaves) {
+            await handle.db.delete(sessions).where(eq(sessions.id, id));
+            remaining.delete(id);
+            deleted += 1;
+        }
+    }
+    return deleted;
 }
 /** Update a session's title. */
 async function updateSessionTitle(handle, id, title) {
@@ -149,7 +265,10 @@ async function updateSessionLastRun(handle, id, lastRun) {
         .where(eq(sessions.id, id));
 }
 async function listSessionsByProject(handle, projectId) {
-    const rows = await handle.db.select().from(sessions).where(eq(sessions.projectId, projectId));
+    const rows = await handle.db
+        .select()
+        .from(sessions)
+        .where(and(eq(sessions.projectId, projectId), isNull(sessions.deletedAt), or(isNull(sessions.source), ne(sessions.source, 'cli'))));
     return rows.map(rowToSession);
 }
-export { createSession, deleteSession, getSession, listSessions, listSessionsByProject, touchLastOpened, touchSession, updateSessionLastRun, updateSessionTitle, };
+export { createSession, getSession, listAllSessions, listDeletedSessions, listSessions, listSessionsByProject, purgeDeletedSessions, restoreSession, softDeleteSession, touchLastOpened, touchSession, updateSessionLastRun, updateSessionTitle, };

package/dist/session/types.d.ts

@@ -101,7 +101,7 @@ type CompactionArchive = {
     id: string;
     sessionId: string;
     compactionId: string;
-    archiveType: 'compaction' | 'squash' | 'shake';
+    archiveType: 'compaction' | 'squash' | 'shake' | 'clear';
     originalEntries: SessionEntry[];
     summary: string;
     tokenCount: number;

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

@@ -148,6 +148,13 @@ type AgentEvent = {
     toolCallId: string;
     tool: string;
     input: unknown;
+}
+/** P1-6：权限确认超时（5 分钟）被自动拒绝时通知前端，提供「重新询问」入口。 */
+ | {
+    _tag: 'permission_timeout';
+    toolCallId: string;
+    tool: string;
+    input: unknown;
 } | {
     _tag: 'error';
     error: AgentError;
@@ -245,5 +252,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 = {

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;
@@ -67,6 +67,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/update/index.d.ts

@@ -5,6 +5,6 @@ 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 { cleanupSnapshot, performHotUpdate, performInstall } from './updater.js';
 export type { UpdateCheckResult } from './version.js';
 export { checkForUpdate, compareSemver, getCurrentVersion } from './version.js';

package/dist/update/index.js

@@ -2,5 +2,5 @@
 export { 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, performHotUpdate, performInstall } from './updater.js';
 export { checkForUpdate, compareSemver, getCurrentVersion } from './version.js';

package/dist/update/ipc.d.ts

@@ -14,6 +14,12 @@ 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 响应刷出；不设时仅响应不退出（测试用）。

package/dist/update/ipc.js

@@ -16,12 +16,15 @@ 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)) {
+                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;

package/dist/update/snapshot.d.ts

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

package/dist/update/snapshot.js

@@ -15,6 +15,10 @@ 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,
         createdAt: toDateMs(row.createdAt),
         updatedAt: toDateMs(row.updatedAt),
     };
@@ -75,6 +79,10 @@ 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,
             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,47 @@ 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;
 };
 /**
- * 执行热更新（spec §18.1-18.2 流程）：
+ * 识别当前进程的安装方式：
+ * - 入口脚本 realpath 含 node_modules/.pnpm → pnpm
+ * - 含 node_modules（非 .pnpm）→ npm
+ * - 否则 unknown（npx 缓存、源码 dev、其他）→ 不自动安装
+ * 检测不到时返回 unknown，由上层提示用户手动安装。
+ */
+declare function detectInstallMethod(): InstallMethod;
+/** 手动安装提示命令（unknown 安装方式时返回给前端展示）。 */
+declare function manualInstallCommand(pkg: string): string;
+/**
+ * 执行热更新（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, performHotUpdate, performInstall, };