@gird/ccli 2.18.0 → 2.20.0

package/dist/index.js

@@ -18,9 +18,11 @@ import { style } from './cli/style.js';
 import { printConfig } from './config/config.js';
 import { printPlugins, installPlugin, uninstallPlugin, setPluginEnabled, } from './config/plugins.js';
 import { createCcliHarness } from './harness/index.js';
+import { startServer } from './server/index.js';
 import { injectFileReferences } from './cli/file-reference.js';
 import { extractImageReferences, buildUserContent, } from './cli/image-reference.js';
 import { createHarnessEventRenderer } from './cli/run/event-renderer.js';
+import { DockerOS, SshOS } from './agent/os.js';
 const HELP = `${NAME} v${VERSION}
 
 用法:
@@ -29,6 +31,7 @@ const HELP = `${NAME} v${VERSION}
 命令:
   config          打印当前解析出的配置（诊断用，密钥打码）
   plugin          插件包管理：list / install <目录> [--project] / uninstall <名> / enable <名> / disable <名>
+  serve           启动本地 HTTP server（--port <n>，默认 4000），把 Harness 事件流经 SSE 暴露
 
 选项:
   -v, --version        打印版本号
@@ -37,6 +40,11 @@ const HELP = `${NAME} v${VERSION}
   -r, --role <name>    非交互式模式下使用的系统提示词角色（默认 default）
       --no-hooks       禁用所有生命周期钩子（忽略配置中的 hooks）
       --project        插件安装到项目级 .ccli/plugins/（配合 plugin install）
+      --port <n>       本地 server 监听端口（配合 serve，默认 4000）
+      --token <str>    本地 server 鉴权 token（配合 serve，默认随机生成）
+      -H, --host <str> 本地 server 监听地址（配合 serve，默认 127.0.0.1）
+      --docker <name>  使用指定的 Docker 容器作为隔离运行沙箱
+      --remote <url>   使用指定的 SSH URL（如 ssh://user@host）作为远程运行环境
 
 示例:
   ccli                              启动交互式对话
@@ -91,6 +99,23 @@ async function main() {
     if (command === 'config') {
         process.exit(printConfig());
     }
+    if (command === 'serve') {
+        const port = args.port ?? 4000;
+        const host = args.host ?? '127.0.0.1';
+        const token = args.token;
+        try {
+            const srv = await startServer({ port, host, token, noHooks: args.noHooks });
+            console.log(style.success(`CCLI server 已启动：${srv.url}`));
+            console.log(style.success(`访问 Token: ${srv.token}`));
+            console.log(style.success(`🌐 请在浏览器中打开: ${srv.url}/?token=${srv.token}`));
+            console.log(style.muted('Ctrl-C 退出'));
+        }
+        catch (e) {
+            console.error(style.error(`server 启动失败：${e?.message ?? e}`));
+            process.exit(1);
+        }
+        return; // 保持进程存活（监听 socket 会撑住事件循环）
+    }
     if (command === 'plugin' || command === 'plugins') {
         const sub = args.positionals[1];
         const arg = args.positionals[2];
@@ -139,7 +164,14 @@ async function main() {
     const prompt = injectFileReferences(extracted.text, process.cwd());
     // 有 prompt 或 stdin 时，走非交互式单次调用
     if (prompt) {
-        const result = await createCcliHarness({ noHooks: args.noHooks });
+        let os;
+        if (args.docker) {
+            os = new DockerOS(args.docker);
+        }
+        else if (args.remote) {
+            os = new SshOS(args.remote);
+        }
+        const result = await createCcliHarness({ noHooks: args.noHooks, os });
         if (!result.ok) {
             console.error(style.error(result.message));
             process.exit(1);
@@ -197,7 +229,14 @@ async function main() {
         return;
     }
     // 无参数：进入交互式会话循环。
-    await startRepl({ noHooks: args.noHooks });
+    let os;
+    if (args.docker) {
+        os = new DockerOS(args.docker);
+    }
+    else if (args.remote) {
+        os = new SshOS(args.remote);
+    }
+    await startRepl({ noHooks: args.noHooks, os });
 }
 main();
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/server/index.js

@@ -0,0 +1,338 @@
+/**
+ * 本地 HTTP Server —— 把 Harness 的事件流通过 HTTP 暴露出去。
+ *
+ * 这是「从单体 CLI 走向可多端复用的 Agent Core」的第一步：Harness 已经产出结构化
+ * 事件流（HarnessEvent），Server 只是它的**另一个消费者**——不碰 CLI 内部实现。
+ *
+ * 零依赖：只用 node 内置 `http`；事件流走 **SSE**（Server-Sent Events，纯 HTTP 单向
+ * 流），而不是 WebSocket——node 没有内置 WS server，而我们只需要「服务端→客户端」推
+ * 事件 +「客户端→服务端」偶发 POST，SSE + POST 正好够用且不引第三方库。
+ *
+ * 路由：
+ *   GET  /health                       健康检查（JSON）
+ *   POST /prompt                       单次调用：body { prompt, role?, yes? }，响应 SSE 事件流
+ *   POST /sessions                     新建会话
+ *   GET  /sessions                     列出所有会话
+ *   GET  /sessions/:id/stream          SSE 订阅该会话事件流
+ *   POST /sessions/:id/prompts         向会话发 prompt
+ *   POST /sessions/:id/approvals       回执审批（第 116 步新增）
+ */
+import { createServer } from 'node:http';
+import { randomUUID } from 'node:crypto';
+import { NAME, VERSION } from '../version.js';
+import { createCcliHarness } from '../harness/index.js';
+import { SessionManager } from './sessions.js';
+import { getWebUIHtml } from './webui.js';
+/** 请求体最大字节数，避免超大 body 撑爆内存。 */
+const MAX_BODY_BYTES = 1_000_000;
+/** 默认实现：用真实 Harness 跑一次，事件转发给 emit。 */
+const defaultRunPrompt = async ({ req, emit, noHooks }) => {
+    const result = await createCcliHarness({ noHooks });
+    if (!result.ok)
+        return result.message;
+    const { harness } = result;
+    try {
+        const rolePrompt = req.role
+            ? harness.getRolePrompt(req.role)
+            : undefined;
+        const systemPrompt = harness.buildSystemPrompt(rolePrompt ?? harness.roleBasePrompt('default'));
+        // 无状态调用：yes 则放行，否则拒绝（需要审批请使用会话模式）
+        const confirm = async () => req.yes ? 'yes' : 'no';
+        await harness.runOnceWithEvents({
+            prompt: req.prompt,
+            confirm,
+            systemPrompt,
+            emit,
+        });
+        return undefined;
+    }
+    finally {
+        await harness.close();
+    }
+};
+/** 读取整段请求体（带大小上限）。 */
+function readBody(reqm) {
+    return new Promise((resolve, reject) => {
+        let size = 0;
+        const chunks = [];
+        reqm.on('data', (c) => {
+            size += c.length;
+            if (size > MAX_BODY_BYTES) {
+                reject(new Error('请求体过大'));
+                reqm.destroy();
+                return;
+            }
+            chunks.push(c);
+        });
+        reqm.on('end', () => resolve(Buffer.concat(chunks).toString('utf8')));
+        reqm.on('error', reject);
+    });
+}
+/** 发送一条 SSE 事件。 */
+function sse(res, event, data) {
+    res.write(`event: ${event}\ndata: ${JSON.stringify(data)}\n\n`);
+}
+/** 回一段 JSON。 */
+function json(res, status, body) {
+    const s = JSON.stringify(body);
+    res.writeHead(status, {
+        'content-type': 'application/json; charset=utf-8',
+    });
+    res.end(s);
+}
+/**
+ * 启动本地 Server。返回实际端口（port=0 时由系统分配）与 close()。
+ */
+export function startServer(opts) {
+    const run = opts.runPrompt ?? defaultRunPrompt;
+    const host = opts.host ?? '127.0.0.1';
+    const token = opts.token || randomUUID().replace(/-/g, '').slice(0, 16);
+    const sessions = new SessionManager(opts.createBackend, opts.noHooks);
+    const server = createServer((req, res) => {
+        const method = req.method ?? 'GET';
+        const url = (req.url ?? '/').split('?')[0];
+        // 1. GET / serves the Web UI without token validation (UI itself checks token client-side)
+        if (method === 'GET' && (url === '/' || url === '/index.html')) {
+            res.writeHead(200, {
+                'content-type': 'text/html; charset=utf-8',
+            });
+            res.end(getWebUIHtml());
+            return;
+        }
+        // 2. All other routes require token validation
+        const authHeader = req.headers['authorization'];
+        let clientToken = null;
+        if (authHeader && typeof authHeader === 'string' && authHeader.startsWith('Bearer ')) {
+            clientToken = authHeader.substring(7);
+        }
+        else {
+            // Check query param for SSE EventSource compatibility
+            const reqUrl = req.url ?? '';
+            const qIdx = reqUrl.indexOf('?');
+            if (qIdx !== -1) {
+                const params = new URLSearchParams(reqUrl.slice(qIdx + 1));
+                clientToken = params.get('token');
+            }
+        }
+        if (clientToken !== token) {
+            json(res, 401, { ok: false, error: 'Unauthorized: token invalid or missing' });
+            return;
+        }
+        if (method === 'GET' && url === '/health') {
+            json(res, 200, { ok: true, name: NAME, version: VERSION });
+            return;
+        }
+        if (method === 'POST' && url === '/prompt') {
+            void handlePrompt(req, res, run, opts.noHooks);
+            return;
+        }
+        if (method === 'POST' && url === '/sessions') {
+            void handleCreateSession(res, sessions);
+            return;
+        }
+        if (method === 'GET' && url === '/sessions') {
+            json(res, 200, { ok: true, sessions: sessions.list() });
+            return;
+        }
+        // /sessions/:id/stream 、/sessions/:id/prompts 与 /sessions/:id/approvals
+        const m = /^\/sessions\/([^/]+)\/(stream|prompts|approvals)$/.exec(url);
+        if (m) {
+            const [, id, sub] = m;
+            if (method === 'GET' && sub === 'stream') {
+                handleStream(req, res, sessions, id);
+                return;
+            }
+            if (method === 'POST' && sub === 'prompts') {
+                void handleSessionPrompt(req, res, sessions, id);
+                return;
+            }
+            if (method === 'POST' && sub === 'approvals') {
+                void handleApproval(req, res, sessions, id);
+                return;
+            }
+        }
+        json(res, 404, { ok: false, error: `未知路由：${method} ${url}` });
+    });
+    return new Promise((resolve, reject) => {
+        server.once('error', reject);
+        server.listen(opts.port, host, () => {
+            const addr = server.address();
+            const port = typeof addr === 'object' && addr ? addr.port : opts.port;
+            resolve({
+                port,
+                url: `http://${host}:${port}`,
+                token,
+                close: () => new Promise((r) => server.close(() => {
+                    void sessions.closeAll().then(() => r());
+                })),
+            });
+        });
+    });
+}
+/** POST /sessions：新建会话。 */
+async function handleCreateSession(res, sessions) {
+    const made = await sessions.create();
+    if (!made.ok) {
+        json(res, 500, { ok: false, error: made.message });
+        return;
+    }
+    json(res, 201, { ok: true, id: made.id });
+}
+/** GET /sessions/:id/stream：SSE 订阅该会话事件流，直到客户端断开。 */
+function handleStream(req, res, sessions, id) {
+    res.writeHead(200, {
+        'content-type': 'text/event-stream; charset=utf-8',
+        'cache-control': 'no-cache',
+        connection: 'keep-alive',
+    });
+    const unsubscribe = sessions.subscribe(id, (event) => sse(res, event.type, event));
+    if (!unsubscribe) {
+        sse(res, 'error', { error: `会话不存在：${id}` });
+        sse(res, 'done', {});
+        res.end();
+        return;
+    }
+    sse(res, 'ready', { id });
+    req.on('close', () => unsubscribe());
+}
+/**
+ * POST /sessions/:id/prompts：向会话发 prompt，广播事件并回助手文本。
+ *
+ * 如果 body 包含 `yes: true`，则所有破坏性工具自动放行（等价 CLI --yes）。
+ * 否则进入审批回路：
+ *   1. runTurnWithEvents 触发 onPermissionRequest → emit 一个 permission_request 事件
+ *   2. emitFilter 拦截该事件，记下 tool/preview/ruleKey（不广播）
+ *   3. 紧接着 confirm() 被调用：用拦截到的 tool 信息 + 新生成的 approvalId 广播
+ *      带 approvalId 的 permission_request 给所有订阅者
+ *   4. confirm() 阻塞在 requestApproval() 上，等客户端 POST /approvals 回执
+ */
+async function handleSessionPrompt(req, res, sessions, id) {
+    let body;
+    try {
+        body = JSON.parse((await readBody(req)) || '{}');
+    }
+    catch (e) {
+        json(res, 400, { ok: false, error: `请求体无效：${e?.message ?? e}` });
+        return;
+    }
+    if (typeof body.prompt !== 'string' || body.prompt.trim() === '') {
+        json(res, 400, { ok: false, error: 'prompt 必填且非空' });
+        return;
+    }
+    // yes=true → 全自动放行，与旧行为一致（脚本/CI 场景）
+    if (body.yes) {
+        const autoConfirm = async () => 'yes';
+        const r = await sessions.prompt(id, body.prompt, autoConfirm);
+        if (!r.ok) {
+            json(res, r.status, { ok: false, error: r.error });
+            return;
+        }
+        json(res, 200, { ok: true, text: r.text });
+        return;
+    }
+    // 审批模式：拦截 permission_request 事件，改用带 approvalId 的版本广播
+    // lastPermissionInfo 缓存最近一次 onPermissionRequest 的 tool / ruleKey，
+    // 因为 confirm(preview, opts) 不携带 tool 名，需要从事件里获取。
+    let lastPermissionTool = '';
+    const emitFilter = (event) => {
+        if (event.type === 'permission_request') {
+            // 拦截并缓存 tool 名，不广播（由 confirm 回调广播带 approvalId 的版本）
+            lastPermissionTool = event.tool;
+            return false;
+        }
+        return true;
+    };
+    const confirm = async (preview, opts) => {
+        const approvalId = randomUUID();
+        // 广播带 approvalId 的 permission_request 给所有 SSE 订阅者
+        sessions.broadcast(id, {
+            type: 'permission_request',
+            tool: lastPermissionTool,
+            preview,
+            ruleKey: opts?.ruleKey,
+            approvalId,
+        });
+        // 阻塞等待客户端回执
+        return sessions.requestApproval(id, approvalId);
+    };
+    const r = await sessions.prompt(id, body.prompt, confirm, emitFilter);
+    if (!r.ok) {
+        json(res, r.status, { ok: false, error: r.error });
+        return;
+    }
+    json(res, 200, { ok: true, text: r.text });
+}
+/**
+ * POST /sessions/:id/approvals：客户端回执审批请求。
+ *
+ * Body: { approvalId: string, choice: 'yes' | 'no' | 'always' }
+ */
+async function handleApproval(req, res, sessions, id) {
+    let body;
+    try {
+        body = JSON.parse((await readBody(req)) || '{}');
+    }
+    catch (e) {
+        json(res, 400, { ok: false, error: `请求体无效：${e?.message ?? e}` });
+        return;
+    }
+    if (typeof body.approvalId !== 'string' || !body.approvalId) {
+        json(res, 400, { ok: false, error: 'approvalId 必填' });
+        return;
+    }
+    const validChoices = ['yes', 'no', 'always'];
+    if (!body.choice || !validChoices.includes(body.choice)) {
+        json(res, 400, {
+            ok: false,
+            error: `choice 必须为 ${validChoices.join(' | ')}`,
+        });
+        return;
+    }
+    const resolved = sessions.resolveApproval(id, body.approvalId, body.choice);
+    if (!resolved) {
+        json(res, 404, {
+            ok: false,
+            error: '审批请求不存在或已过期',
+        });
+        return;
+    }
+    json(res, 200, { ok: true });
+}
+/** 处理 POST /prompt：解析 body → 开 SSE → 跑 Harness → 转发事件 → done。 */
+async function handlePrompt(req, res, run, noHooks) {
+    let body;
+    try {
+        const raw = await readBody(req);
+        body = JSON.parse(raw || '{}');
+    }
+    catch (e) {
+        json(res, 400, { ok: false, error: `请求体无效：${e?.message ?? e}` });
+        return;
+    }
+    if (typeof body.prompt !== 'string' || body.prompt.trim() === '') {
+        json(res, 400, { ok: false, error: 'prompt 必填且非空' });
+        return;
+    }
+    res.writeHead(200, {
+        'content-type': 'text/event-stream; charset=utf-8',
+        'cache-control': 'no-cache',
+        connection: 'keep-alive',
+    });
+    try {
+        const err = await run({
+            req: body,
+            noHooks,
+            emit: (event) => sse(res, event.type, event),
+        });
+        if (err)
+            sse(res, 'error', { error: err });
+    }
+    catch (e) {
+        sse(res, 'error', { error: e?.message ?? String(e) });
+    }
+    finally {
+        sse(res, 'done', {});
+        res.end();
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/server/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"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"}

package/dist/server/sessions.js

@@ -0,0 +1,181 @@
+/**
+ * 会话管理 —— 让 Server 支持「有状态多轮 + 常驻事件流」。
+ *
+ * 第 114 步的 `/prompt` 是无状态单次调用；本模块给每个会话维护一份**持久历史**与
+ * 一组 **SSE 订阅者**：一次 prompt 触发一个回合，产生的 HarnessEvent 广播给所有订阅
+ * 该会话 stream 的客户端，回合结束把助手文本回给发起方。
+ *
+ * 第 116 步新增「审批回路」：破坏性工具触发 confirm() 时，Server 生成 approvalId
+ * 通过 SSE 推给客户端，再阻塞等待客户端通过 POST /approvals 回执。
+ *
+ * backend 是**注入点**：默认用真实 Harness（每会话一个），测试可换成发假事件的实现，
+ * 从而无需真实 provider 就能验证会话/广播逻辑。
+ */
+import { randomUUID } from 'node:crypto';
+import { createCcliHarness } from '../harness/index.js';
+import { emptyStats } from '../cli/stats/index.js';
+/** 默认后端：真实 Harness，每会话一个。 */
+export const harnessBackend = async (noHooks) => {
+    const result = await createCcliHarness({ noHooks });
+    if (!result.ok)
+        return { ok: false, message: result.message };
+    const harness = result.harness;
+    const systemPrompt = harness.buildSystemPrompt(harness.roleBasePrompt('default'));
+    const stats = emptyStats();
+    const backend = {
+        async runTurn(history, prompt, confirm, emit) {
+            history.push({ role: 'user', content: prompt });
+            await harness.runTurnWithEvents({ history, confirm, stats, emit });
+        },
+        close: () => harness.close(),
+    };
+    return { ok: true, backend, systemPrompt };
+};
+export class SessionManager {
+    createBackend;
+    noHooks;
+    sessions = new Map();
+    constructor(createBackend = harnessBackend, noHooks) {
+        this.createBackend = createBackend;
+        this.noHooks = noHooks;
+    }
+    /** 新建会话：建后端、以 system prompt 起头历史。 */
+    async create() {
+        const made = await this.createBackend(this.noHooks);
+        if (!made.ok)
+            return made;
+        const id = randomUUID();
+        this.sessions.set(id, {
+            id,
+            backend: made.backend,
+            history: [{ role: 'system', content: made.systemPrompt }],
+            subscribers: new Set(),
+            busy: false,
+            pendingApprovals: new Map(),
+        });
+        return { ok: true, id };
+    }
+    has(id) {
+        return this.sessions.has(id);
+    }
+    list() {
+        return [...this.sessions.keys()];
+    }
+    /** 订阅会话事件流；返回退订函数。会话不存在返回 null。 */
+    subscribe(id, onEvent) {
+        const s = this.sessions.get(id);
+        if (!s)
+            return null;
+        s.subscribers.add(onEvent);
+        return () => s.subscribers.delete(onEvent);
+    }
+    /** 向一个会话的所有订阅者广播事件（Server 层用于发带 approvalId 的 permission_request）。 */
+    broadcast(id, event) {
+        const s = this.sessions.get(id);
+        if (!s)
+            return;
+        for (const sub of s.subscribers)
+            sub(event);
+    }
+    /**
+     * 向会话发一个 prompt：跑一个回合，事件广播给订阅者，回合结束返回助手文本。
+     * 会话不存在 → 404；正忙 → 409。
+     *
+     * confirm 回调由调用方构造（Server 层负责阻塞式审批回路）。
+     * emitFilter 可选：在事件广播前拦截/修改事件（如抑制无 approvalId 的 permission_request）。
+     */
+    async prompt(id, prompt, confirm, emitFilter) {
+        const s = this.sessions.get(id);
+        if (!s)
+            return { ok: false, status: 404, error: `会话不存在：${id}` };
+        if (s.busy) {
+            return { ok: false, status: 409, error: '会话正忙，请稍后再试' };
+        }
+        s.busy = true;
+        let text = '';
+        const emit = (event) => {
+            if (event.type === 'text_delta')
+                text += event.text;
+            // 如果有过滤器且返回 false，则不广播此事件
+            if (emitFilter && !emitFilter(event))
+                return;
+            for (const sub of s.subscribers)
+                sub(event);
+        };
+        try {
+            await s.backend.runTurn(s.history, prompt, confirm, emit);
+            return { ok: true, text };
+        }
+        catch (e) {
+            return {
+                ok: false,
+                status: 500,
+                error: e?.message ?? String(e),
+            };
+        }
+        finally {
+            s.busy = false;
+        }
+    }
+    /**
+     * 创建一个审批请求并阻塞等待客户端回执。
+     *
+     * 返回的 Promise 在客户端调用 `resolveApproval()` 或超时后兑现。
+     * 超时默认 5 分钟，自动拒绝并清理。
+     */
+    requestApproval(id, approvalId, timeoutMs = 5 * 60 * 1000) {
+        const s = this.sessions.get(id);
+        if (!s)
+            return Promise.resolve('no');
+        return new Promise((resolve) => {
+            let timer;
+            const done = (choice) => {
+                if (timer)
+                    clearTimeout(timer);
+                s.pendingApprovals.delete(approvalId);
+                resolve(choice);
+            };
+            s.pendingApprovals.set(approvalId, done);
+            // 超时自动拒绝
+            timer = setTimeout(() => {
+                if (s.pendingApprovals.has(approvalId)) {
+                    done('no');
+                }
+            }, timeoutMs);
+        });
+    }
+    /**
+     * 回执一个审批请求，解除 `requestApproval()` 的阻塞。
+     *
+     * 返回 true 表示找到了对应的待审批；false 表示 approvalId 不存在或已超时。
+     */
+    resolveApproval(id, approvalId, choice) {
+        const s = this.sessions.get(id);
+        if (!s)
+            return false;
+        const resolve = s.pendingApprovals.get(approvalId);
+        if (!resolve)
+            return false;
+        resolve(choice);
+        return true;
+    }
+    /** 关闭并移除一个会话。 */
+    async close(id) {
+        const s = this.sessions.get(id);
+        if (!s)
+            return false;
+        // 清理所有挂起的审批（自动拒绝）
+        for (const [, resolve] of s.pendingApprovals)
+            resolve('no');
+        s.pendingApprovals.clear();
+        this.sessions.delete(id);
+        await s.backend.close();
+        return true;
+    }
+    /** 关闭全部会话（server 停机时）。 */
+    async closeAll() {
+        for (const id of [...this.sessions.keys()])
+            await this.close(id);
+    }
+}
+//# sourceMappingURL=sessions.js.map