c0de-agent 1.11.0 → 1.13.0

package/dist/server/routes/auth.js

@@ -10,8 +10,20 @@
 //   GET  /api/auth/pairing           列出待审批配对
 //   POST /api/auth/pairing/approve   审批通过（签发设备 token）
 //   POST /api/auth/pairing/deny      拒绝配对
+//   GET  /api/auth/devices           列出已授权设备
+//   DELETE /api/auth/devices/:id     撤销设备（立即生效）
 import { Hono } from 'hono';
 import { apiError } from '../middleware/error.js';
+/** 尽力而为的请求来源：x-forwarded-for 首跳（反代场景），否则视为本地回环。仅展示/软限流。 */
+function requestSource(c) {
+    const fwd = c.req.header('x-forwarded-for');
+    if (fwd) {
+        const first = fwd.split(',')[0]?.trim();
+        if (first)
+            return first;
+    }
+    return 'local';
+}
 function createAuthRoute(ctx) {
     const app = new Hono();
     // 首设备注册：凭 bootstrap token（URL ?token=）换发设备 token，bootstrap 随即轮换失效。
@@ -23,12 +35,24 @@ function createAuthRoute(ctx) {
         if (!body.token) {
             return apiError(c, 400, 'BAD_REQUEST', 'token is required');
         }
-        const deviceToken = await ctx.authManager.registerFirstDevice(body.token, body.deviceName ?? '设备');
-        if (!deviceToken) {
-            // bootstrap 已失效/已注册过设备 → 引导走配对审批
-            return apiError(c, 403, 'BOOTSTRAP_CONSUMED', 'bootstrap token 已失效（已有设备注册）。请在新设备发起配对，由已授权设备审批。');
+        const result = await ctx.authManager.registerFirstDevice(body.token, body.deviceName ?? '设备');
+        if (!result.ok) {
+            // 区分失败原因给正确的恢复指引：链接过期 → 重启 serve 换新链接；
+            // 已有设备 → 走配对审批；两者补救动作完全不同，不得混用同一文案。
+            if (result.reason === 'ttl_expired') {
+                return apiError(c, 403, 'BOOTSTRAP_EXPIRED', '注册链接已过期（超过安全窗口未使用）。请重启 c0de serve——无已注册设备时' +
+                    '重启会重新生成注册链接，打开启动日志中打印的新 URL 完成首次注册。');
+            }
+            if (result.reason === 'devices_exist') {
+                return apiError(c, 403, 'BOOTSTRAP_CONSUMED', 'bootstrap token 已失效（已有设备注册）。请在新设备发起配对，由已授权设备审批。');
+            }
+            if (result.reason === 'invalid_bootstrap') {
+                return apiError(c, 403, 'BOOTSTRAP_INVALID', 'bootstrap token 无效。');
+            }
+            return apiError(c, 403, 'STATIC_TOKEN_MODE', '静态 token 模式不支持设备注册。');
         }
-        return c.json({ deviceToken });
+        // P1-3：回传注册成功的设备名，前端展示一次性确认（用户可核对注册的是否自己）。
+        return c.json({ deviceToken: result.deviceToken, deviceName: body.deviceName ?? '设备' });
     });
     // 新设备发起配对请求（公开）。
     app.post('/pairing/request', async (c) => {
@@ -36,11 +60,16 @@ function createAuthRoute(ctx) {
             return apiError(c, 400, 'AUTH_DISABLED', '认证未启用');
         }
         const body = (await c.req.json().catch(() => ({})));
-        const result = ctx.authManager.requestPairing(body.deviceName ?? '新设备');
+        const result = ctx.authManager.requestPairing(body.deviceName ?? '新设备', requestSource(c));
         if (!result) {
             return apiError(c, 429, 'PAIRING_LIMIT', '待审批的配对请求过多，请稍后再试');
         }
-        return c.json(result);
+        // L3：零已授权设备时配对审批不可能完成（无人可批准）——前端据此展示
+        // 恢复指引（重启 serve 重新生成 bootstrap 注册链接）而非干等审批。
+        return c.json({
+            ...result,
+            hasAuthorizedDevices: ctx.authManager.listDevices().length > 0,
+        });
     });
     // 新设备轮询配对审批结果（公开）。
     app.get('/pairing/status', (c) => {
@@ -63,7 +92,8 @@ function createAuthRoute(ctx) {
         }
         return c.json({ pairings: ctx.authManager.listPairings() });
     });
-    // 审批通过（需认证）。
+    // 审批通过（需认证）。P2-9：必须携带审批方输入的 6 位配对码（新设备屏幕显示），
+    // 服务端核对匹配才签发——防多请求并存时看错行误批给错设备。
     app.post('/pairing/approve', async (c) => {
         if (!ctx.authManager) {
             return apiError(c, 400, 'AUTH_DISABLED', '认证未启用');
@@ -71,9 +101,18 @@ function createAuthRoute(ctx) {
         const body = (await c.req.json().catch(() => ({})));
         if (!body.pairingId)
             return apiError(c, 400, 'BAD_REQUEST', 'pairingId is required');
-        const ok = ctx.authManager.approvePairing(body.pairingId);
-        if (!ok)
+        if (!body.code)
+            return apiError(c, 400, 'BAD_REQUEST', 'code is required');
+        const result = ctx.authManager.approvePairing(body.pairingId, body.code);
+        if (result === 'code_mismatch') {
+            return apiError(c, 400, 'PAIRING_CODE_MISMATCH', '配对码不匹配：请核对新设备屏幕显示的 6 位配对码后重新输入');
+        }
+        if (result === 'not_found' || result === 'expired') {
             return apiError(c, 404, 'PAIRING_NOT_FOUND', '配对请求不存在或已过期');
+        }
+        if (result === 'already_handled') {
+            return apiError(c, 409, 'PAIRING_ALREADY_HANDLED', '该配对请求已被处理');
+        }
         return c.json({ ok: true });
     });
     // 拒绝配对（需认证）。
@@ -89,6 +128,23 @@ function createAuthRoute(ctx) {
             return apiError(c, 404, 'PAIRING_NOT_FOUND', '配对请求不存在或已过期');
         return c.json({ ok: true });
     });
+    // 列出已授权设备（需认证；设置页「已授权设备」面板）。
+    app.get('/devices', (c) => {
+        if (!ctx.authManager) {
+            return apiError(c, 400, 'AUTH_DISABLED', '认证未启用');
+        }
+        return c.json({ devices: ctx.authManager.listDevices() });
+    });
+    // 撤销设备（需认证）。撤销唯一设备后如需重新注册首设备，请运行 c0de auth reset。
+    app.delete('/devices/:id', async (c) => {
+        if (!ctx.authManager) {
+            return apiError(c, 400, 'AUTH_DISABLED', '认证未启用');
+        }
+        const ok = ctx.authManager.revokeDevice(c.req.param('id'));
+        if (!ok)
+            return apiError(c, 404, 'NOT_FOUND', 'Device not found');
+        return c.json({ ok: true });
+    });
     return app;
 }
 export { createAuthRoute };

package/dist/server/routes/chat.d.ts

@@ -1,4 +1,7 @@
 import { Hono } from 'hono';
+import { type SSEStreamingApi } from 'hono/streaming';
+import type { RegisterChildRun } from '../../core/types.js';
+import type { AgentManager } from '../agent-manager.js';
 import type { ServerContext } from '../types.js';
 /** 按 session.projectId / worktreePath 解析 agent 工作目录：
  *  - 有 projectId → 项目 worktree（缺失/目录失效时抛错，由上层转 409）。
@@ -9,5 +12,23 @@ export declare function resolveAgentCwd(ctx: ServerContext, session: {
     projectId: string | null;
     worktreePath?: string | null;
 }): Promise<string>;
+declare const SSE_HEARTBEAT_INTERVAL_MS = 30000;
+/** 启动心跳定时器；返回停止函数（幂等）。流关闭后写入会被吞掉，安全。 */
+declare function startHeartbeat(stream: SSEStreamingApi): () => void;
+export { SSE_HEARTBEAT_INTERVAL_MS, startHeartbeat };
+/**
+ * 子 agent run 注册桥接：core 的 registerChildRun → agentManager 槽位。
+ * P1：此前子 run（含后台任务）从不注册，暂停/热更新/删除级联/更新影响面
+ * 全部绕过它们；core 无 agentManager 引用，桥接由 Web 宿主注入。
+ * 返回的注销函数幂等（unregister 对不存在的 key 安全）。
+ */
+export declare function childRunBridge(manager: AgentManager): RegisterChildRun;
+/**
+ * 会话「忙」判定统一口径：活跃 run / tryAcquire 占位（starting）/ 工作流运行期
+ * （发起会话无主 run，busy 映射承载）。变更型操作（fork/compact/clear 等）在斜杠与
+ * REST 双入口共用本判定，防止守卫漂移——REST fork 此前只查 get()，漏 starting
+ * 占位窗口与工作流运行期两种态（斜杠守卫早已覆盖）。
+ */
+export declare function hasBusySession(ctx: ServerContext, sessionId: string): 'run' | 'starting' | 'workflow' | null;
 declare function createChatRoute(ctx: ServerContext): Hono;
 export { createChatRoute };