c0de-agent 1.9.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/snapshot.d.ts

@@ -1,11 +1,17 @@
 import type { DB } from '../db/client.js';
 import type { FileSnapshot } from './types.js';
-/** Create or update a file snapshot. Always creates a new version. Returns the snapshot id. */
-declare function upsertFileSnapshot(handle: DB, sessionId: string, filePath: string, content: string): Promise<string>;
+/** Create or update a file snapshot. Always creates a new version. Returns the snapshot id.
+ *  未传 mtimeMs 时从同文件已有最新行透传（而非置空）：compaction/squash 等从
+ *  工具结果重建快照的调用点拿不到磁盘 mtime，透传旧值可避免每次压缩后热文件
+ *  被误判过期而多一轮冗余重读（自愈无害但浪费；旧值 ≤ 内容实际新鲜度，
+ *  绝不会掩盖磁盘真实变更）。 */
+declare function upsertFileSnapshot(handle: DB, sessionId: string, filePath: string, content: string, mtimeMs?: number): Promise<string>;
 /** Get all snapshots for a session. */
 declare function getFileSnapshots(handle: DB, sessionId: string): Promise<FileSnapshot[]>;
 /** Get the latest snapshot for a specific file, or null. */
 declare function getLatestFileSnapshot(handle: DB, sessionId: string, filePath: string): Promise<FileSnapshot | null>;
 /** Quick check: return cached file content if a snapshot exists, else null. */
 declare function checkFileSnapshot(handle: DB, sessionId: string, filePath: string): Promise<string | null>;
-export { checkFileSnapshot, getFileSnapshots, getLatestFileSnapshot, upsertFileSnapshot };
+/** 把源会话每个文件的最新快照复制到目标会话（fork 分支用，P1-4）。 */
+declare function copyFileSnapshots(handle: DB, fromSessionId: string, toSessionId: string): Promise<void>;
+export { checkFileSnapshot, copyFileSnapshots, getFileSnapshots, getLatestFileSnapshot, upsertFileSnapshot, };

package/dist/session/snapshot.js

@@ -13,10 +13,15 @@ function rowToSnapshot(row) {
         tokenCount: row.tokenCount ?? 0,
         version: row.version ?? 1,
         createdAt,
+        ...(row.mtimeMs != null ? { mtimeMs: Number(row.mtimeMs) } : {}),
     };
 }
-/** Create or update a file snapshot. Always creates a new version. Returns the snapshot id. */
-async function upsertFileSnapshot(handle, sessionId, filePath, content) {
+/** Create or update a file snapshot. Always creates a new version. Returns the snapshot id.
+ *  未传 mtimeMs 时从同文件已有最新行透传（而非置空）：compaction/squash 等从
+ *  工具结果重建快照的调用点拿不到磁盘 mtime，透传旧值可避免每次压缩后热文件
+ *  被误判过期而多一轮冗余重读（自愈无害但浪费；旧值 ≤ 内容实际新鲜度，
+ *  绝不会掩盖磁盘真实变更）。 */
+async function upsertFileSnapshot(handle, sessionId, filePath, content, mtimeMs) {
     const contentHash = createHash('sha256').update(content).digest('hex');
     const tokenCount = estimateTokens(content);
     const [existing] = await handle.db
@@ -26,9 +31,20 @@ async function upsertFileSnapshot(handle, sessionId, filePath, content) {
         .orderBy(desc(fileSnapshots.version))
         .limit(1);
     const version = (existing?.version ?? 0) + 1;
+    // mtimeMs 是浮点（stat 返回微秒精度），bigint 列不接受小数；取整存储。
+    // 调用方未显式提供时继承已有行的 mtimeMs（见函数头注释）。
+    const effectiveMtimeMs = mtimeMs ?? (existing?.mtimeMs != null ? Number(existing.mtimeMs) : null);
     const [row] = await handle.db
         .insert(fileSnapshots)
-        .values({ sessionId, filePath, content, contentHash, tokenCount, version })
+        .values({
+        sessionId,
+        filePath,
+        content,
+        contentHash,
+        tokenCount,
+        version,
+        ...(effectiveMtimeMs != null ? { mtimeMs: Math.round(effectiveMtimeMs) } : {}),
+    })
         .returning();
     if (!row)
         throw new Error('Failed to insert file snapshot');
@@ -57,4 +73,29 @@ async function checkFileSnapshot(handle, sessionId, filePath) {
     const snapshot = await getLatestFileSnapshot(handle, sessionId, filePath);
     return snapshot?.content ?? null;
 }
-export { checkFileSnapshot, getFileSnapshots, getLatestFileSnapshot, upsertFileSnapshot };
+/** 把源会话每个文件的最新快照复制到目标会话（fork 分支用，P1-4）。 */
+async function copyFileSnapshots(handle, fromSessionId, toSessionId) {
+    const rows = await handle.db
+        .select()
+        .from(fileSnapshots)
+        .where(eq(fileSnapshots.sessionId, fromSessionId));
+    const latest = new Map();
+    for (const r of rows) {
+        const prev = latest.get(r.filePath);
+        if (!prev || (r.version ?? 0) > (prev.version ?? 0))
+            latest.set(r.filePath, r);
+    }
+    for (const r of latest.values()) {
+        await handle.db.insert(fileSnapshots).values({
+            sessionId: toSessionId,
+            entryId: r.entryId,
+            filePath: r.filePath,
+            content: r.content,
+            contentHash: r.contentHash,
+            tokenCount: r.tokenCount,
+            version: r.version,
+            mtimeMs: r.mtimeMs,
+        });
+    }
+}
+export { checkFileSnapshot, copyFileSnapshots, getFileSnapshots, getLatestFileSnapshot, upsertFileSnapshot, };

package/dist/session/squash.js

@@ -62,6 +62,7 @@ ${history}`;
         if (cfg.preserveFileSnapshots) {
             const hotFiles = extractHotFiles(toSquash);
             for (const file of hotFiles) {
+                // 不传 mtimeMs：由 upsertFileSnapshot 从已有行透传，压缩后热文件不误判过期。
                 const id = await upsertFileSnapshot(txHandle, sessionId, file.path, file.content);
                 fileSnapshotIds.push(id);
             }

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;
@@ -117,6 +117,8 @@ type FileSnapshot = {
     contentHash: string;
     tokenCount: number;
     version: number;
+    /** 快照创建时文件磁盘 mtime（毫秒）；旧行无此字段（迁移前写入） */
+    mtimeMs?: number;
     createdAt: number;
 };
 export type { ArchiveRef, BranchSummaryEntry, CompactionArchive, CompactionConfig, CompactionEntry, CompactionResult, FileSnapshot, HotFile, MessageInput, SessionEntry, SessionTreeNode, SquashConfig, SquashEntry, SteeringEntry, Summarizer, };

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,16 +64,22 @@ type UpdateConfig = {
     intervalMs: number;
     /** 启动后首次检查的延迟（毫秒），默认 10 秒。 */
     initialDelayMs: number;
-    /** 发现新版本后自动应用（无感知），false 则仅前端提示手动确认（默认 false）。 */
-    autoApply: boolean;
+    /** 热更新前暂停活跃 run 的等待超时（毫秒），默认 30 秒。
+     *  暂停会等当前原子操作（工具执行）完成；超时仍未暂停的 run 将被强制中止。 */
+    pauseTimeoutMs?: number;
+    /** 手动安装等待程序文件变更的超时（毫秒），默认 10 分钟。 */
+    manualWaitTimeoutMs?: number;
 };
-/** Server security configuration (spec §24.2). */
+/** Server security configuration (spec §24.2)。 */
 type SecurityConfig = {
-    /** 启用 Bearer token 认证（远程访问场景）。本地开发默认关闭。 */
+    /**
+     * 是否启用 Bearer token 认证（默认 true）。
+     * 关闭为显式选择（可信网络/无人值守场景），会取消一切 API 鉴权。
+     */
     authEnabled: boolean;
-    /** Bearer token；authEnabled 为 true 时必填。 */
+    /** Bearer token；未提供时服务端自动生成并持久化到全局数据目录（跨重启/热更新稳定）。 */
     token?: string;
-    /** 额外允许的 CORS origin（本地回环始终允许）。 */
+    /** 额外允许的 CORS origin（本地回环始终允许；局域网/远程访问需显式添加）。 */
     allowedOrigins: string[];
 };
 /** Global application configuration. */

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/shared/utils/path.d.ts

@@ -5,11 +5,10 @@
  * - `resolve(root, requestPath)` 解析后，若结果不在 root 子树内则返回 null。
  * - 判定逻辑：`relative(root, resolved)` 以 `..` 开头即越界；
  *   再用 `resolve(root, rel) === resolved` 兜底，防止相对段恰好名为 root 的边角情况。
+ * - symlink 防逃逸（P2-5）：root 与目标（或其最近已存在祖先）经 realpath 解析后，
+ *   目标必须仍落在 root 实路径内；否则返回 null。
  *
  * 返回解析后的绝对路径；越界返回 null。
- *
- * 注意：本函数基于 `relative`，不解析符号链接（symlink）。若 root 内存在指向
- * root 外的符号链接，本函数无法阻止经由该链接的逃逸——symlink 逃逸不在本次范围内。
  */
 declare function safeResolve(root: string, requestPath: string): string | null;
 export { safeResolve };

package/dist/shared/utils/path.js

@@ -1,4 +1,5 @@
-import { relative, resolve } from 'node:path';
+import { existsSync, realpathSync } from 'node:fs';
+import { dirname, relative, resolve, sep } from 'node:path';
 /**
  * 安全路径解析：确保 requestPath 解析后落在 root 内，防止路径穿越
  * （如 `../etc/passwd`、绝对路径 `/etc/passwd`）。
@@ -6,11 +7,10 @@ import { relative, resolve } from 'node:path';
  * - `resolve(root, requestPath)` 解析后，若结果不在 root 子树内则返回 null。
  * - 判定逻辑：`relative(root, resolved)` 以 `..` 开头即越界；
  *   再用 `resolve(root, rel) === resolved` 兜底，防止相对段恰好名为 root 的边角情况。
+ * - symlink 防逃逸（P2-5）：root 与目标（或其最近已存在祖先）经 realpath 解析后，
+ *   目标必须仍落在 root 实路径内；否则返回 null。
  *
  * 返回解析后的绝对路径；越界返回 null。
- *
- * 注意：本函数基于 `relative`，不解析符号链接（symlink）。若 root 内存在指向
- * root 外的符号链接，本函数无法阻止经由该链接的逃逸——symlink 逃逸不在本次范围内。
  */
 function safeResolve(root, requestPath) {
     const resolved = resolve(root, requestPath);
@@ -18,6 +18,22 @@ function safeResolve(root, requestPath) {
     if (rel.startsWith('..') || resolve(root, rel) !== resolved) {
         return null;
     }
+    try {
+        const rootReal = realpathSync(root);
+        let probe = resolved;
+        while (!existsSync(probe)) {
+            const parent = dirname(probe);
+            if (parent === probe)
+                break;
+            probe = parent;
+        }
+        const probeReal = realpathSync(probe);
+        if (probeReal !== rootReal && !probeReal.startsWith(rootReal + sep))
+            return null;
+    }
+    catch {
+        // realpath 失败（root 不存在等）：保持原有 relative 判定结果
+    }
     return resolved;
 }
 export { safeResolve };

package/dist/tools/builtin/todo.js

@@ -421,16 +421,17 @@ export function getLatestTodoPhasesFromMessages(messages) {
             continue;
         for (let j = msg.content.length - 1; j >= 0; j--) {
             const part = msg.content[j];
-            if (!part || part._tag !== 'tool_result')
+            if (part?._tag !== 'tool_result')
                 continue;
             if (part.tool !== 'todo')
                 continue;
             const output = part.output;
-            if (!output || output._tag !== 'success')
+            if (output?._tag !== 'success')
                 continue;
             const metadata = output.metadata;
-            if (metadata && Array.isArray(metadata.phases)) {
-                return clonePhases(metadata.phases);
+            const phases = metadata?.phases;
+            if (Array.isArray(phases)) {
+                return clonePhases(phases);
             }
         }
     }

package/dist/tools/index.d.ts

@@ -6,11 +6,11 @@ export { dapTools } from './builtin/dap.js';
 export { editTool } from './builtin/edit.js';
 export { globTool, globToRegex } from './builtin/glob.js';
 export { grepTool } from './builtin/grep.js';
+export { kanbanTool } from './builtin/kanban.js';
 export { readTool } from './builtin/read.js';
 export { createDefaultURLRegistry, createFileResolver, createSkillResolver, } from './builtin/resolvers.js';
-export { kanbanTool } from './builtin/kanban.js';
-export { todoTool } from './builtin/todo.js';
 export type { TodoInput, TodoItem, TodoPhase, TodoStatus } from './builtin/todo.js';
+export { todoTool } from './builtin/todo.js';
 export { writeTool } from './builtin/write.js';
 export { yieldTool } from './builtin/yield.js';
 export { executeTool } from './executor.js';
@@ -23,10 +23,21 @@ export { formatForLLM, resolveProvider, runWebSearch } from './websearch/index.j
 export type { WebSearchProvider, WebSearchProviderId, WebSearchResponse, WebSearchSource, } from './websearch/types.js';
 export { createWebSearchTool } from './websearch/websearch.js';
 import type { Config } from '../shared/types/config.js';
+import type { ToolRegistry } from './types.js';
 /**
  * Create a registry pre-loaded with all builtin tools:
  * read, write, edit, glob, grep, bash, task, websearch, and the debug_* set.
  *
+ * config.tools.disabled 中的工具**不注册**——registry 层过滤保证两个入口
+ * （CLI print / Web chat / /api/tools 列表）统一生效，禁用的工具对 agent 完全不可见。
  * @param config 可选配置；websearch 工具按 config.websearch 构造。省略时用 DEFAULT_CONFIG。
  */
-export declare function createDefaultRegistry(config?: Config): import("./types.js").ToolRegistry;
+export declare function createDefaultRegistry(config?: Config): ToolRegistry;
+/**
+ * 解析本轮启用的工具名列表（P1-1 修复：config.tools.enabled/disabled 双入口统一生效）。
+ *
+ * - explicit（前端显式选择）非 undefined → 以其为准，但过滤掉 disabled 与未注册名。
+ * - 否则 enabled 非空 → enabled ∩ registered；enabled 空 → 全部 registered（空=全部）。
+ * - disabled 恒过滤（registry 已排除，此处兜底）。
+ */
+export declare function resolveEnabledToolNames(registry: ToolRegistry, config: Pick<Config, 'tools'>, explicit?: string[]): string[];

package/dist/tools/index.js

@@ -4,10 +4,10 @@ export { dapTools } from './builtin/dap.js';
 export { editTool } from './builtin/edit.js';
 export { globTool, globToRegex } from './builtin/glob.js';
 export { grepTool } from './builtin/grep.js';
+export { kanbanTool } from './builtin/kanban.js';
 export { readTool } from './builtin/read.js';
 // ── Builtin tools ───────────────────────────────────────────
 export { createDefaultURLRegistry, createFileResolver, createSkillResolver, } from './builtin/resolvers.js';
-export { kanbanTool } from './builtin/kanban.js';
 export { todoTool } from './builtin/todo.js';
 export { writeTool } from './builtin/write.js';
 export { yieldTool } from './builtin/yield.js';
@@ -33,28 +33,49 @@ import { taskTool } from './builtin/task.js';
 import { todoTool } from './builtin/todo.js';
 import { writeTool } from './builtin/write.js';
 import { yieldTool } from './builtin/yield.js';
-import { createToolRegistry, registerTool } from './registry.js';
+import { createToolRegistry, listTools, registerTool } from './registry.js';
 import { createWebSearchTool } from './websearch/websearch.js';
 /**
  * Create a registry pre-loaded with all builtin tools:
  * read, write, edit, glob, grep, bash, task, websearch, and the debug_* set.
  *
+ * config.tools.disabled 中的工具**不注册**——registry 层过滤保证两个入口
+ * （CLI print / Web chat / /api/tools 列表）统一生效，禁用的工具对 agent 完全不可见。
  * @param config 可选配置；websearch 工具按 config.websearch 构造。省略时用 DEFAULT_CONFIG。
  */
 export function createDefaultRegistry(config = DEFAULT_CONFIG) {
     const reg = createToolRegistry();
-    registerTool(reg, readTool);
-    registerTool(reg, writeTool);
-    registerTool(reg, editTool);
-    registerTool(reg, globTool);
-    registerTool(reg, grepTool);
-    registerTool(reg, bashTool);
-    registerTool(reg, kanbanTool);
-    registerTool(reg, taskTool);
-    registerTool(reg, todoTool);
-    registerTool(reg, yieldTool);
-    registerTool(reg, createWebSearchTool(config.websearch));
+    const disabled = new Set(config.tools?.disabled ?? []);
+    const register = (tool) => {
+        if (!disabled.has(tool.name))
+            registerTool(reg, tool);
+    };
+    register(readTool);
+    register(writeTool);
+    register(editTool);
+    register(globTool);
+    register(grepTool);
+    register(bashTool);
+    register(kanbanTool);
+    register(taskTool);
+    register(todoTool);
+    register(yieldTool);
+    register(createWebSearchTool(config.websearch));
     for (const tool of dapTools)
-        registerTool(reg, tool);
+        register(tool);
     return reg;
 }
+/**
+ * 解析本轮启用的工具名列表（P1-1 修复：config.tools.enabled/disabled 双入口统一生效）。
+ *
+ * - explicit（前端显式选择）非 undefined → 以其为准，但过滤掉 disabled 与未注册名。
+ * - 否则 enabled 非空 → enabled ∩ registered；enabled 空 → 全部 registered（空=全部）。
+ * - disabled 恒过滤（registry 已排除，此处兜底）。
+ */
+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);
+    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 } 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 { checkForUpdate, compareSemver } from './version.js';
+export { cleanupSnapshot, performHotUpdate, performInstall } from './updater.js';
+export { checkForUpdate, compareSemver, getCurrentVersion } from './version.js';