c0de-agent 1.13.1 → 1.14.0

package/dist/server/routes/session.js

@@ -3,6 +3,7 @@ import { eq } from 'drizzle-orm';
 import { Hono } from 'hono';
 import { createSummarizer, runCompaction } from '../../core/compact.js';
 import { loadConfigScopes, mergeConfig } from '../../core/config.js';
+import { buildRegistryFromConfig } from '../../core/provider-registry.js';
 import { sessions } from '../../db/schema.js';
 import { buildFallbackChain } from '../../llm/routing.js';
 import { fromDirectory } from '../../project/index.js';
@@ -10,13 +11,14 @@ import { getProject } from '../../project/project.js';
 import { archiveOriginalEntries, listArchives } from '../../session/archive.js';
 import { BranchPointOutOfRangeError, forkSession, getBranches, getTree, } from '../../session/branch.js';
 import { importSessionData } from '../../session/import.js';
-import { deleteEntriesByIds, getMessages, getSteeringAsMessages, insertEntry, } from '../../session/message.js';
+import { getMessages, getSteeringAsMessages, updateEntryContent } from '../../session/message.js';
 import { createSession, emptyTrash, getLLMSegments, getSession, listDeletedSessions, listOrphanDeletedSessions, listSessions, listSessionsByProject, permanentlyDeleteSession, purgeEmptySession, rebindSession, restoreSessionCore, searchSessions, softDeleteSession, touchLastOpened, touchTrashSeen, updateSessionTitle, } from '../../session/session.js';
 import { applyShakeRegions, collectShakeRegions, DEFAULT_SHAKE_CONFIG, toRegionViews, } from '../../session/shake.js';
 import { estimateMessageTokens } from '../../session/token.js';
 import { generateId } from '../../shared/index.js';
+import { isUuid } from '../../shared/utils/string.js';
 import { apiError } from '../middleware/error.js';
-import { buildRegistryFromConfig } from '../registry-config.js';
+import { readJsonObject } from '../util/json-body.js';
 import { hasBusySession, resolveAgentCwd } from './chat.js';
 function createSessionRoute(ctx) {
     const app = new Hono();
@@ -119,10 +121,16 @@ function createSessionRoute(ctx) {
     });
     // 创建会话
     app.post('/', async (c) => {
-        const body = (await c.req.json().catch(() => ({})));
-        const title = body.title ?? 'New Session';
-        const directory = body.directory;
-        const explicitProjectId = body.projectId;
+        // 畸形 JSON / null / 非对象 body → 400（此前 null body 在 body.title 处 500）。
+        const parsed = await readJsonObject(c);
+        if (!parsed.ok)
+            return parsed.response;
+        const { body } = parsed;
+        // 非字符串字段（数字 title/directory/projectId）此前经 as 断言进 fromDirectory/
+        // createSession：path.resolve 与 text 列参数对非字符串抛错 → 500。按缺省处理。
+        const title = typeof body.title === 'string' ? body.title : 'New Session';
+        const directory = typeof body.directory === 'string' ? body.directory : undefined;
+        const explicitProjectId = typeof body.projectId === 'string' ? body.projectId : undefined;
         let projectId;
         if (directory) {
             const project = await fromDirectory(ctx.db, directory);
@@ -136,7 +144,17 @@ function createSessionRoute(ctx) {
         if (!projectId) {
             return apiError(c, 400, 'PROJECT_REQUIRED', '创建会话必须指定项目：传 directory（自动解析）或 projectId');
         }
-        const session = await createSession(ctx.db, title, projectId);
+        // 显式 projectId 指向 sessions.projectId 外键：不存在的项目此前直接穿透
+        // createSession 的 insert，PG 侧 FK violation（23503）击穿 500 并回显 SQL
+        // 错误细节——先校验存在性，统一 404（与 kanban guardProject、import/rebind
+        // 的目标项目校验同口径）。directory 路径经 fromDirectory 自动 upsert，恒有效。
+        if (explicitProjectId) {
+            const project = await getProject(ctx.db, explicitProjectId);
+            if (!project) {
+                return apiError(c, 404, 'PROJECT_NOT_FOUND', '目标项目不存在');
+            }
+        }
+        const session = await createSession(ctx.db, title, projectId, undefined, undefined, undefined, undefined, undefined, ctx.hookRunner);
         return c.json(session, 201);
     });
     // 列出会话
@@ -193,6 +211,20 @@ function createSessionRoute(ctx) {
         const count = await emptyTrash(ctx.db, projectId);
         return c.json({ ok: true, deleted: count });
     });
+    // 路径参数 id 是 sessions.id（uuid 列）：非 UUID 直接 404。
+    // 此前非 UUID 经 drizzle 参数化查询在 PG 侧抛 22P02（invalid input syntax for
+    // type uuid），Hono 兜成 500 且把 SQL 错误细节回给客户端；对调用方而言
+    // 「不存在的会话」与「格式非法的 id」同属资源不存在，统一 404。
+    // 必须注册在上方全部静态路径（/import、/tree、/search、/deleted*）之后：
+    // Hono 按注册序分派，静态路由先命中即返回，不会被本守卫拦截。
+    const guardSessionId = async (c, next) => {
+        if (!isUuid(c.req.param('id') ?? '')) {
+            return apiError(c, 404, 'NOT_FOUND', '会话不存在或已删除');
+        }
+        await next();
+    };
+    app.use('/:id', guardSessionId);
+    app.use('/:id/*', guardSessionId);
     // 获取会话详情
     app.get('/:id', async (c) => {
         try {
@@ -209,8 +241,10 @@ function createSessionRoute(ctx) {
     // P2-5：会话重命名（此前标题只能由 LLM 自动生成，用户无法修改）
     app.patch('/:id', async (c) => {
         const id = c.req.param('id');
-        const body = (await c.req.json().catch(() => ({})));
-        const title = typeof body.title === 'string' ? body.title.trim() : '';
+        const parsed = await readJsonObject(c);
+        if (!parsed.ok)
+            return parsed.response;
+        const title = typeof parsed.body.title === 'string' ? parsed.body.title.trim() : '';
         if (!title)
             return apiError(c, 400, 'BAD_REQUEST', 'title is required');
         if (title.length > 120) {
@@ -247,8 +281,11 @@ function createSessionRoute(ctx) {
         if (busy === 'starting') {
             return apiError(c, 409, 'RUN_STARTING', '该会话的对话正在启动，请稍后重试');
         }
-        const body = await c.req.json().catch(() => ({}));
-        let messageIndex = body.messageIndex;
+        const parsed = await readJsonObject(c);
+        if (!parsed.ok)
+            return parsed.response;
+        const rawIndex = parsed.body.messageIndex;
+        let messageIndex = typeof rawIndex === 'number' && Number.isFinite(rawIndex) ? rawIndex : undefined;
         if (messageIndex === undefined || !Number.isFinite(messageIndex)) {
             const messages = await getMessages(ctx.db, id);
             if (messages.length === 0) {
@@ -257,7 +294,7 @@ function createSessionRoute(ctx) {
             messageIndex = messages.length - 1;
         }
         try {
-            const forked = await forkSession(ctx.db, id, messageIndex);
+            const forked = await forkSession(ctx.db, id, messageIndex, ctx.hookRunner);
             return c.json(forked, 201);
         }
         catch (error) {
@@ -393,7 +430,10 @@ function createSessionRoute(ctx) {
     // 显式跳过重建、直接归属到请求项目（用户在确认框中二选一）。
     app.post('/:id/restore', async (c) => {
         const id = c.req.param('id');
-        const body = (await c.req.json().catch(() => ({})));
+        const parsed = await readJsonObject(c);
+        if (!parsed.ok)
+            return parsed.response;
+        const { body } = parsed;
         const requestProjectId = typeof body.projectId === 'string' && body.projectId ? body.projectId : undefined;
         const preferCurrentProject = body.restoreMode === 'current-project';
         const result = await restoreSessionCore(ctx.db, id);
@@ -455,8 +495,12 @@ function createSessionRoute(ctx) {
         if (busy === 'starting') {
             return apiError(c, 409, 'RUN_STARTING', '该会话的对话正在启动，请稍后重试');
         }
-        const body = (await c.req.json().catch(() => ({})));
-        const projectId = typeof body.projectId === 'string' && body.projectId ? body.projectId : '';
+        const parsed = await readJsonObject(c);
+        if (!parsed.ok)
+            return parsed.response;
+        const projectId = typeof parsed.body.projectId === 'string' && parsed.body.projectId
+            ? parsed.body.projectId
+            : '';
         if (!projectId)
             return apiError(c, 400, 'PROJECT_REQUIRED', 'projectId is required');
         const project = await getProject(ctx.db, projectId);
@@ -618,7 +662,15 @@ function createSessionRoute(ctx) {
         }
         if (!session)
             return apiError(c, 404, 'NOT_FOUND', 'Session not found');
-        const body = await c.req.json().catch(() => ({}));
+        const parsed = await readJsonObject(c);
+        if (!parsed.ok)
+            return parsed.response;
+        const { body } = parsed;
+        // regionIds 非数组（字符串等）会让后续 .filter 抛 TypeError 500——
+        // 显式 400（与 regionIds 不匹配同口径）。
+        if (body.regionIds !== undefined && !Array.isArray(body.regionIds)) {
+            return apiError(c, 400, 'INVALID_REGIONS', 'regionIds 必须是数组');
+        }
         const regionIds = body.regionIds ?? [];
         const messages = await getMessages(ctx.db, id);
         const manualConfig = { ...DEFAULT_SHAKE_CONFIG, protectTokens: 0, minSavings: 0 };
@@ -640,19 +692,13 @@ function createSessionRoute(ctx) {
         const totalTokens = selected.reduce((sum, r) => sum + r.tokens, 0);
         await archiveOriginalEntries(ctx.db, id, originalMessages, 'shake', `Shaken ${selected.length} regions, saved ${totalTokens} tokens`, archiveId);
         const shakenMessages = applyShakeRegions(messages, selected);
-        await deleteEntriesByIds(ctx.db, affectedIds);
+        // 就地改写受影响条目（此前「删除 + 原时间戳重插」）：重插的行落到物理末尾，
+        // 时间戳并列的会话（fork 复制/跨机导入的历史数据）里被 shake 的早期消息会
+        // 跳到时间线最后——内容替换不应改变条目位置。
         for (const msg of shakenMessages) {
             if (!affectedIds.includes(msg.id))
                 continue;
-            await insertEntry(ctx.db, {
-                id: msg.id,
-                sessionId: id,
-                tag: 'message',
-                role: msg.role,
-                content: msg.content,
-                tokenCount: estimateMessageTokens(msg.content),
-                createdAt: new Date(msg.createdAt),
-            });
+            await updateEntryContent(ctx.db, msg.id, msg.content, estimateMessageTokens(msg.content));
         }
         return c.json({ shaken: selected.length, archiveId });
     });

package/dist/server/routes/terminal.js

@@ -4,6 +4,7 @@ import { isAbsolute } from 'node:path';
 import { Hono } from 'hono';
 import { getProject } from '../../project/index.js';
 import { apiError } from '../middleware/error.js';
+import { readJsonObject } from '../util/json-body.js';
 /** 允许的 shell 白名单（P2-6：拒绝路径分隔符与任意二进制）。 */
 const ALLOWED_SHELLS = new Set(['bash', 'zsh', 'fish', 'sh']);
 /** 创建终端路由（REST 部分；WebSocket 升级在 server.ts 中处理）。 */
@@ -16,7 +17,11 @@ function createTerminalRoute(ctx) {
     });
     // 创建新 PTY 会话
     app.post('/', async (c) => {
-        const body = await c.req.json().catch(() => ({}));
+        // 畸形 JSON / null / 非对象 body → 400（此前 null body 在 body.projectId 处 500）。
+        const parsed = await readJsonObject(c);
+        if (!parsed.ok)
+            return parsed.response;
+        const { body } = parsed;
         const projectId = typeof body.projectId === 'string' && body.projectId.length > 0 ? body.projectId : undefined;
         // P2-13：未显式传 cwd 且带 projectId 时，默认目录跟随项目 worktree
         // （与 chat 的 resolveAgentCwd 行为一致；项目缺失/目录失效时回退 ctx.cwd）。
@@ -67,7 +72,10 @@ function createTerminalRoute(ctx) {
         const info = mgr.get(id);
         if (!info)
             return apiError(c, 404, 'PTY_NOT_FOUND', 'Terminal not found');
-        const body = await c.req.json().catch(() => ({}));
+        const parsed = await readJsonObject(c);
+        if (!parsed.ok)
+            return parsed.response;
+        const { body } = parsed;
         if (body.cols != null && body.rows != null) {
             const cols = Number(body.cols);
             const rows = Number(body.rows);

package/dist/server/routes/todo.js

@@ -3,7 +3,9 @@ import { Hono } from 'hono';
 import { appendMessage, getMessages } from '../../session/message.js';
 import { getSession } from '../../session/session.js';
 import { generateId } from '../../shared/index.js';
+import { isUuid } from '../../shared/utils/string.js';
 import { formatSummary, getLatestTodoPhasesFromMessages, todoTool, } from '../../tools/builtin/todo.js';
+import { validateInput } from '../../tools/validate.js';
 import { apiError } from '../middleware/error.js';
 /** 构造仅供 todo tool execute 使用的最小 ToolContext。 */
 function makeTodoCtx(phases, abort) {
@@ -22,6 +24,15 @@ function makeTodoCtx(phases, abort) {
 }
 function createTodoRoute(ctx) {
     const app = new Hono();
+    // 路径参数 sessionId 是 sessions.id（uuid 列）：非 UUID 直接 404。
+    // 此前非 UUID 经 drizzle 查询在 PG 侧抛 22P02（invalid input syntax for type
+    // uuid）→ Hono 500 且回显 SQL 错误细节；格式非法与「会话不存在」同属 404。
+    app.use('/:sessionId', async (c, next) => {
+        if (!isUuid(c.req.param('sessionId') ?? '')) {
+            return apiError(c, 404, 'NOT_FOUND', '会话不存在或已删除');
+        }
+        await next();
+    });
     // GET /:sessionId — 获取当前 todo 状态
     app.get('/:sessionId', async (c) => {
         const sessionId = c.req.param('sessionId');
@@ -47,6 +58,13 @@ function createTodoRoute(ctx) {
         if (!session) {
             return apiError(c, 404, 'NOT_FOUND', 'Session not found');
         }
+        // 与工具执行管线同口径校验入参：本路由绕过 executor 直调 todoTool.execute，
+        // 此前畸形 body（list 非数组 → initPhases 对字符串 for-of 后 .map TypeError 500；
+        // items 含非字符串 → 毒化状态原样持久化）无任何校验。非法显式 400 让前端可操作。
+        const validation = validateInput(todoTool.parameters, body);
+        if (!validation.valid) {
+            return apiError(c, 400, 'INVALID_TODO_INPUT', `无效的 todo 操作参数：${validation.error}`);
+        }
         // 恢复当前 phases
         const run = ctx.agentManager.get(sessionId);
         let currentPhases;

package/dist/server/routes/tool.js

@@ -35,8 +35,19 @@ function createToolRoute(ctx) {
     });
     // 确认工具执行权限
     app.post('/confirm', async (c) => {
-        const body = await c.req.json();
-        const ok = ctx.permissionStore.resolve(body.toolCallId, body.approved);
+        // 畸形 JSON / 非对象 body → 400（与其他写端点同口径：.catch + 显式类型校验）。
+        // 此前裸 await c.req.json()：畸形 JSON 击穿 Hono 500，null body 在
+        // body.toolCallId 处 TypeError 500。
+        const body = (await c.req.json().catch(() => null));
+        if (body === null || typeof body !== 'object' || Array.isArray(body)) {
+            return apiError(c, 400, 'BAD_REQUEST', '请求体必须是 JSON 对象');
+        }
+        if (typeof body.toolCallId !== 'string' || body.toolCallId.length === 0) {
+            return apiError(c, 400, 'BAD_REQUEST', 'toolCallId is required');
+        }
+        // 仅显式 true 放行：非布尔（"false" 字符串等 truthy 垃圾）按拒绝处理——
+        // 绝不让客户端序列化缺陷把「拒绝」翻成「放行」。
+        const ok = ctx.permissionStore.resolve(body.toolCallId, body.approved === true);
         if (!ok) {
             return apiError(c, 404, 'NOT_FOUND', 'No pending permission for this tool call');
         }

package/dist/server/routes/update.js

@@ -3,6 +3,7 @@ import { getSession } from '../../session/session.js';
 import { getCurrentVersion, manualInstallCommand, performHandoff, performInstall, serializeSessions, } from '../../update/index.js';
 import { apiError } from '../middleware/error.js';
 import { captureForegroundCommand } from '../terminal/pty-manager.js';
+import { readJsonObject } from '../util/json-body.js';
 /**
  * GET /api/update — 返回后台调度器缓存的版本检查结果（spec §18.1）。
  * 路由本身不触发 npm registry 请求；调度器周期性 checkNow 写入缓存，
@@ -107,7 +108,10 @@ function createUpdateRoute(ctx) {
             return apiError(c, 409, 'HOT_UPDATE_UNAVAILABLE', '热更新仅在独立 serve 进程可用（dev 模式请手动更新）');
         }
         // P3-7：用户勾选「更新后自动重启」的终端 id；命中者在快照中携带前台命令。
-        const body = (await c.req.json().catch(() => ({})));
+        const parsed = await readJsonObject(c);
+        if (!parsed.ok)
+            return parsed.response;
+        const body = parsed.body;
         const rerunIds = new Set(Array.isArray(body.rerunTerminalIds)
             ? body.rerunTerminalIds.filter((x) => typeof x === 'string')
             : []);

package/dist/server/routes/workflows.js

@@ -5,15 +5,18 @@ import { Hono } from 'hono';
 import { streamSSE } from 'hono/streaming';
 import { createAgent } from '../../core/agent.js';
 import { loadConfigScopes, mergeConfig, resolveGlobalConfigDir } from '../../core/config.js';
+import { buildRegistryFromConfig } from '../../core/provider-registry.js';
+import { discoverSkills } from '../../core/skills.js';
 import { discoverWorkflows, executeWorkflow, resolveWorkflow, saveWorkflow, workflowSessionTitle, } from '../../core/workflows/index.js';
 import { reloadRegistry } from '../../core/workflows/registry.js';
+import { createDebugSpawn } from '../../dap/index.js';
 import { getByDirectory, getProject, trustProject } from '../../project/project.js';
 import { enrichProjectRiskWithGlobal, projectTrustCurrent, projectTrustNeeded, } from '../../project/trust.js';
 import { createSession, updateSessionLastRun } from '../../session/session.js';
 import { PROJECT_BOUND_TOOLS, resolveEnabledToolNames } from '../../tools/index.js';
 import { apiError } from '../middleware/error.js';
 import { createInteractivePermissionChecker } from '../permission/interactive.js';
-import { buildRegistryFromConfig } from '../registry-config.js';
+import { readJsonObject } from '../util/json-body.js';
 import { childRunBridge, startHeartbeat } from './chat.js';
 /**
  * 按名字查找运行中的工作流 run：遍历 busy 作用域占位（workflowBusyByScope 的
@@ -108,8 +111,10 @@ function createWorkflowsRoute(ctx) {
         if (!registry) {
             return apiError(c, 500, 'NOT_INITIALIZED', 'Workflow registry not initialized');
         }
-        const body = await c.req.json().catch(() => ({}));
-        const { name, source, target, projectId, overwrite } = body;
+        const parsed = await readJsonObject(c);
+        if (!parsed.ok)
+            return parsed.response;
+        const { name, source, target, projectId, overwrite } = parsed.body;
         if (!name || typeof name !== 'string') {
             return apiError(c, 400, 'BAD_REQUEST', 'Missing required field: name');
         }
@@ -263,8 +268,10 @@ function createWorkflowsRoute(ctx) {
         if (!entry) {
             return apiError(c, 404, 'NOT_FOUND', `Workflow "${name}" not found`);
         }
-        const body = await c.req.json().catch(() => ({}));
-        const args = body.args ?? '';
+        const parsed = await readJsonObject(c);
+        if (!parsed.ok)
+            return parsed.response;
+        const args = typeof parsed.body.args === 'string' ? parsed.body.args : '';
         // 会话级配置：按 agent cwd 解析项目作用域合并（与 chat 路由同口径）；
         // 项目配置含 providers 时构建/复用项目级 LLM 注册表。
         const sessionProjectScope = agentCwd === ctx.cwd ? undefined : loadConfigScopes(agentCwd).project;
@@ -297,7 +304,7 @@ function createWorkflowsRoute(ctx) {
         try {
             session = await createSession(ctx.db, workflowSessionTitle(name), project?.id ?? undefined, 'workflow', undefined, undefined, project?.worktree ?? agentCwd, 
             // 中断恢复指引需要工作流名（重启后会话内无 user 消息可重发）。
-            { workflowName: name });
+            { workflowName: name }, ctx.hookRunner);
         }
         catch (e) {
             ctx.workflowBusyByScope.delete(scopeKey);
@@ -396,6 +403,10 @@ function createWorkflowsRoute(ctx) {
                         cwd: agentCwd,
                         agentRegistry: ctx.agentRegistry,
                         registerChildRun: childRunBridge(ctx.agentManager),
+                        // 技能发现（system prompt ## Loaded Skills 段数据源）。
+                        skills: discoverSkills(agentCwd),
+                        // DAP（spec §21）：与主 chat 通道同口径注入真实适配器 spawn。
+                        debugSpawn: createDebugSpawn(),
                         // 预算护栏：与 chat 路由同口径（金额/token 任一轴 pause/abort 即启用）。
                         ...(sessionConfig.usage?.budgetAction === 'pause' ||
                             sessionConfig.usage?.budgetAction === 'abort' ||

package/dist/server/server.d.ts

@@ -1,8 +1,8 @@
 import type { Hono } from 'hono';
+import { buildRegistryFromConfig, syncRegistryFromConfig } from '../core/provider-registry.js';
 import type { DB } from '../db/client.js';
 import type { Config } from '../shared/types/config.js';
 import { checkForUpdate, createHandoffServer } from '../update/index.js';
-import { buildRegistryFromConfig, syncRegistryFromConfig } from './registry-config.js';
 import type { ServerContext } from './types.js';
 type StartServerOptions = {
     port?: number;

package/dist/server/server.js

@@ -8,9 +8,11 @@ import { serve } from '@hono/node-server';
 import { WebSocketServer } from 'ws';
 import { BUILTIN_AGENTS, createAgentRegistry } from '../core/agents/index.js';
 import { loadConfig, loadConfigScopes } from '../core/config.js';
+import { buildRegistryFromConfig, syncRegistryFromConfig } from '../core/provider-registry.js';
 import { createAndPopulateRegistry } from '../core/workflows/index.js';
 import { createDB, migrateDB } from '../db/index.js';
 import { purgeDeletedKanbanBoards } from '../kanban/index.js';
+import { collectScopedMCPServers, disconnectMCPServer, registerMCPServers } from '../mcp/index.js';
 import { initPlugins } from '../plugins/index.js';
 import { getByDirectory } from '../project/index.js';
 import { projectTrustCurrent } from '../project/trust.js';
@@ -24,7 +26,6 @@ import { createApp } from './app.js';
 import { createAuthManager } from './auth-manager.js';
 import { isAllowedOrigin } from './middleware/cors.js';
 import { createPermissionStore } from './permission/store.js';
-import { buildRegistryFromConfig, syncRegistryFromConfig } from './registry-config.js';
 import { PTYManager } from './terminal/pty-manager.js';
 /** serve 默认端口：避开 node 生态常用端口（3000/4000/5173/8000/8080…），
  * 降低与其他本地服务撞端口的概率。显式 --port 始终优先。 */
@@ -188,13 +189,18 @@ async function buildServerContext(db, opts = {}) {
     catch {
         // 信任状态查询失败 → 保持未信任（宁可少加载插件）
     }
-    const { pluginRegistry, hookRunner } = await initPlugins({
+    const { pluginRegistry, hookRunner, config: resolvedConfig, } = await initPlugins({
         cwd,
         config,
         toolRegistry,
         llmRegistry,
         projectTrusted,
     });
+    // MCP 客户端（spec §6）：把配置中的 MCP 服务器工具适配进 toolRegistry，对 agent
+    // 透明。全局作用域（用户本机显式配置）始终连接；项目作用域（随 git clone 传播的
+    // 任意命令执行面）仅在项目已信任时连接——与插件/工作流同口径。逐台隔离：单台
+    // 失败告警跳过，不拖垮启动。
+    const { sessions: mcpSessions } = await registerMCPServers(toolRegistry, collectScopedMCPServers(loadConfigScopes(cwd), projectTrusted));
     // 工作流注册表：三级发现（builtin → global → project），eager 初始化。
     // 此前是惰性 getter 只注册 builtin，导致项目级 .c0de/workflows/*.js 永远不可见。
     // P0 信任边界：项目级工作流与 .c0de/plugins 同为仓库自带任意代码执行面，
@@ -204,14 +210,15 @@ async function buildServerContext(db, opts = {}) {
     const dataDir = resolveDbDir();
     // 先解析/生成 bootstrap token（落盘），再创建 authManager 读取——
     // 首启时文件由 resolveAuthToken 生成，顺序颠倒会导致 bootstrap 读到空值。
-    const resolvedToken = resolveAuthToken(config, dataDir);
+    // 自 initPlugins 之后一律用 resolvedConfig（config:resolve hook 的产物）。
+    const resolvedToken = resolveAuthToken(resolvedConfig, dataDir);
     const authManager = createAuthManager({
         dataDir,
-        ...(config.security.token && config.security.token.length > 0
-            ? { staticToken: config.security.token }
+        ...(resolvedConfig.security.token && resolvedConfig.security.token.length > 0
+            ? { staticToken: resolvedConfig.security.token }
             : {}),
-        ...(config.security.firstDeviceTtlMs !== undefined
-            ? { firstDeviceTtlMs: config.security.firstDeviceTtlMs }
+        ...(resolvedConfig.security.firstDeviceTtlMs !== undefined
+            ? { firstDeviceTtlMs: resolvedConfig.security.firstDeviceTtlMs }
             : {}),
     });
     const ptyManager = new PTYManager();
@@ -244,7 +251,7 @@ async function buildServerContext(db, opts = {}) {
     }
     const ctx = {
         db,
-        config,
+        config: resolvedConfig,
         toolRegistry,
         llmRegistry,
         urlRegistry,
@@ -254,20 +261,22 @@ async function buildServerContext(db, opts = {}) {
         // P3：权限双层超时可配置（config.permission.timeoutMs/expireGraceMs）；
         // 缺省回退 store 内置默认（5 分钟 + 25 分钟）。
         permissionStore: createPermissionStore({
-            ...(config.permission.timeoutMs !== undefined && config.permission.timeoutMs > 0
-                ? { timeoutMs: config.permission.timeoutMs }
+            ...(resolvedConfig.permission.timeoutMs !== undefined &&
+                resolvedConfig.permission.timeoutMs > 0
+                ? { timeoutMs: resolvedConfig.permission.timeoutMs }
                 : {}),
-            ...(config.permission.expireGraceMs !== undefined && config.permission.expireGraceMs > 0
-                ? { expireGraceMs: config.permission.expireGraceMs }
+            ...(resolvedConfig.permission.expireGraceMs !== undefined &&
+                resolvedConfig.permission.expireGraceMs > 0
+                ? { expireGraceMs: resolvedConfig.permission.expireGraceMs }
                 : {}),
         }),
-        permissionMode: config.permission.defaultMode,
+        permissionMode: resolvedConfig.permission.defaultMode,
         sessionPermissionModes: new Map(),
         sessionAlwaysAllow: new Map(),
         workflowBusyBySession: new Map(),
         workflowBusyByScope: new Map(),
         authToken: resolvedToken,
-        authManager: config.security.authEnabled === false ? undefined : authManager,
+        authManager: resolvedConfig.security.authEnabled === false ? undefined : authManager,
         // Agent 注册表：内置 4 个默认 agent；项目/用户自定义 agent 可在启动后补充加载。
         agentRegistry: (() => {
             const reg = createAgentRegistry();
@@ -279,11 +288,13 @@ async function buildServerContext(db, opts = {}) {
         // spec §18.1 后台版本检查调度器；config.update.enabled 控制是否启动。
         updateScheduler: createUpdateScheduler({
             checkFn: opts.checkForUpdateFn ?? checkForUpdate,
-            intervalMs: config.update.intervalMs,
-            initialDelayMs: config.update.initialDelayMs,
+            intervalMs: resolvedConfig.update.intervalMs,
+            initialDelayMs: resolvedConfig.update.initialDelayMs,
         }),
         cwd,
         ptyManager,
+        // MCP 会话句柄：关闭时统一断开（stdio 子进程由 close 杀死）。
+        ...(mcpSessions.length > 0 ? { mcpSessions } : {}),
     };
     // handoff server 不在此创建：它需要持有主 HTTP server 引用以触发完整关停，
     // 由 startServer 在 serve() 之后创建（dev 模式走 vite，不创建）。
@@ -291,12 +302,15 @@ async function buildServerContext(db, opts = {}) {
         ctx,
         dispose: async () => {
             // dev 重建前调用：中止活跃 run + settle pending permission +
-            // 停 scheduler + 关 devices.json watcher。**不 close db**（调用方持有）。
+            // 停 scheduler + 关 devices.json watcher + 断开 MCP 连接。
+            // **不 close db**（调用方持有）。
             ctx.agentManager.dispose();
             ctx.permissionStore.dispose();
             ctx.updateScheduler.stop();
             ctx.ptyManager.dispose();
             ctx.authManager?.dispose();
+            for (const session of ctx.mcpSessions ?? [])
+                disconnectMCPServer(session);
         },
     };
 }

package/dist/server/terminal/pty-manager.d.ts

@@ -34,6 +34,9 @@ export interface CreatePTYOptions {
  * /etc/passwd（getpwuid），是用户真实登录 shell 的可靠来源。
  */
 export declare function detectShell(): string;
+/** 截断标题到 MAX_TITLE_LEN 内。省略号本身计入上限（此前 slice(100) + '…'
+ *  产出 101 字符，违反上限契约）。切点经 headChars 内收，不拆代理对。 */
+export declare function truncateTitle(title: string): string;
 /** 把 argv 拼回可安全经 shell 重放的命令行（导出便于单测安全转义）。 */
 export declare function argvToCommand(argv: string[]): string;
 /**

package/dist/server/terminal/pty-manager.js

@@ -4,6 +4,7 @@ import { mkdirSync, readFileSync, rmSync, unlinkSync, writeFileSync } from 'node
 import { tmpdir, userInfo } from 'node:os';
 import { basename, join } from 'node:path';
 import { spawn } from 'node-pty';
+import { headChars, tailChars } from '../../shared/utils/string.js';
 /**
  * 为指定 shell 创建 OSC 133 prompt 标记注入脚本。
  *
@@ -93,9 +94,11 @@ const MAX_ROWS = 500;
 const MAX_TITLE_LEN = 100;
 /** scrollback 环形缓冲最大字节数（约 50KB）。 */
 const SCROLLBACK_MAX = 50_000;
-function truncateTitle(title) {
+/** 截断标题到 MAX_TITLE_LEN 内。省略号本身计入上限（此前 slice(100) + '…'
+ *  产出 101 字符，违反上限契约）。切点经 headChars 内收，不拆代理对。 */
+export function truncateTitle(title) {
     const clean = title.replace(/[\r\n]/g, ' ').trim();
-    return clean.length > MAX_TITLE_LEN ? `${clean.slice(0, MAX_TITLE_LEN)}…` : clean;
+    return clean.length > MAX_TITLE_LEN ? `${headChars(clean, MAX_TITLE_LEN - 1)}…` : clean;
 }
 /** POSIX 单引号转义：仅安全字符（字母数字与常见路径/别名符号）原样，否则单引号包裹。 */
 function shellQuote(arg) {
@@ -187,7 +190,9 @@ export class PTYManager {
         pty.onData((data) => {
             entry.scrollback += data;
             if (entry.scrollback.length > SCROLLBACK_MAX) {
-                entry.scrollback = entry.scrollback.slice(-SCROLLBACK_MAX);
+                // tailChars 内收切点：环形缓冲修剪不落在代理对中间——否则回放给新挂载
+                // 终端的历史头部以 U+FFFD 损坏显示（slice(-N) 按 UTF-16 码元硬切）。
+                entry.scrollback = tailChars(entry.scrollback, SCROLLBACK_MAX);
             }
             for (const ws of entry.sockets) {
                 if (ws.readyState === ws.OPEN) {

package/dist/server/types.d.ts

@@ -73,6 +73,8 @@ type ServerContext = {
     cwd: string;
     /** 终端 PTY 管理器（Web 终端面板用）。 */
     ptyManager: PTYManager;
+    /** 已连接的 MCP 会话（spec §6）；dispose 时统一断开。 */
+    mcpSessions?: import('../mcp/types.js').MCPSession[];
     /** 测试注入：覆盖 LLM chat stream。生产环境为 undefined。 */
     chatStream?: typeof chatStreamFn;
 };

package/dist/server/util/json-body.d.ts

@@ -0,0 +1,31 @@
+import type { Context } from 'hono';
+/** readJsonObject 的判别结果：ok=false 时 response 为可直接 return 的 400。 */
+export type JsonObjectResult = {
+    ok: true;
+    body: Record<string, unknown>;
+} | {
+    ok: false;
+    response: Response;
+};
+/**
+ * 读取「必须是 JSON 对象」的请求体。
+ *
+ * 此前各写端点用 `await c.req.json().catch(() => ({}))` 兜底畸形 JSON——但
+ * `JSON.parse('null')` 是合法 JSON，`c.req.json()` 会成功解析出 `null`，
+ * catch 不触发：随后 `body.xxx` 在 null 上取属性直接 TypeError 击穿 Hono 500。
+ * 数组/字符串/数字 body 同型（`body.foo` 静默 undefined，字段被当作缺省，
+ * 与「请求体畸形」应有的显式反馈不符）。
+ *
+ * 口径：
+ *  - 无 body / 空 body（curl -X POST 不带载荷）→ `{}`：这些端点的字段均为可选，
+ *    保持既有契约（既有测试与脚本依赖无载荷 POST）。
+ *  - 畸形 JSON / null / 数组 / 标量 body → 400（此前 null 击穿 500、
+ *    其余静默当空对象）。
+ *  - 合法 JSON 对象 → 原样返回。
+ *
+ * 调用方写法：
+ *   const parsed = await readJsonObject(c)
+ *   if (!parsed.ok) return parsed.response
+ *   const { body } = parsed
+ */
+export declare function readJsonObject(c: Context): Promise<JsonObjectResult>;

package/dist/server/util/json-body.js

@@ -0,0 +1,38 @@
+import { apiError } from '../middleware/error.js';
+/**
+ * 读取「必须是 JSON 对象」的请求体。
+ *
+ * 此前各写端点用 `await c.req.json().catch(() => ({}))` 兜底畸形 JSON——但
+ * `JSON.parse('null')` 是合法 JSON，`c.req.json()` 会成功解析出 `null`，
+ * catch 不触发：随后 `body.xxx` 在 null 上取属性直接 TypeError 击穿 Hono 500。
+ * 数组/字符串/数字 body 同型（`body.foo` 静默 undefined，字段被当作缺省，
+ * 与「请求体畸形」应有的显式反馈不符）。
+ *
+ * 口径：
+ *  - 无 body / 空 body（curl -X POST 不带载荷）→ `{}`：这些端点的字段均为可选，
+ *    保持既有契约（既有测试与脚本依赖无载荷 POST）。
+ *  - 畸形 JSON / null / 数组 / 标量 body → 400（此前 null 击穿 500、
+ *    其余静默当空对象）。
+ *  - 合法 JSON 对象 → 原样返回。
+ *
+ * 调用方写法：
+ *   const parsed = await readJsonObject(c)
+ *   if (!parsed.ok) return parsed.response
+ *   const { body } = parsed
+ */
+export async function readJsonObject(c) {
+    const raw = await c.req.text().catch(() => '');
+    if (raw.trim().length === 0)
+        return { ok: true, body: {} };
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        return { ok: false, response: apiError(c, 400, 'BAD_REQUEST', '请求体必须是合法 JSON') };
+    }
+    if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed)) {
+        return { ok: false, response: apiError(c, 400, 'BAD_REQUEST', '请求体必须是 JSON 对象') };
+    }
+    return { ok: true, body: parsed };
+}