agent-gear 2.1.0 → 2.2.0

package/dist/workload-executor.js

@@ -0,0 +1,292 @@
+import { spawn } from 'node:child_process';
+import { homedir } from 'node:os';
+/**
+ * 单条脚本的尾部输出上限（256 KiB），与 cloud-controller 的 `WORKLOAD_LOG_MAX_BYTES` 对齐。
+ */
+export const MAX_OUTPUT_BYTES = 256 * 1024;
+/** 未确认执行结果在内存中的保留上限（重连重放用）。 */
+export const MAX_PENDING_RESULTS = 50;
+/** 空 script（含纯空白）的失败文案。 */
+export const EMPTY_SCRIPT_MESSAGE = '工作负载脚本为空，跳过执行';
+/**
+ * 单条脚本输出的尾部环形截断缓冲：始终保留最近 `limit` 字节。
+ *
+ * 大输出脚本（如构建日志、循环 echo）若不截断会打爆内存与 Mongo，
+ * 契约要求保留尾部 ≤ 256 KiB（尾部通常包含真正的错误信息）。
+ */
+class TailBuffer {
+    limit;
+    chunks = [];
+    size = 0;
+    constructor(limit) {
+        this.limit = limit;
+    }
+    push(chunk) {
+        if (chunk.length === 0)
+            return;
+        this.chunks.push(chunk);
+        this.size += chunk.length;
+        while (this.size > this.limit && this.chunks.length > 0) {
+            const first = this.chunks[0];
+            const excess = this.size - this.limit;
+            if (first.length <= excess) {
+                this.chunks.shift();
+                this.size -= first.length;
+            }
+            else {
+                this.chunks[0] = first.subarray(excess);
+                this.size -= excess;
+            }
+        }
+    }
+    toString() {
+        const buffer = Buffer.concat(this.chunks);
+        // 截断保留尾部时，起始处可能落在多字节 UTF-8 字符的续字节上（0b10xxxxxx），
+        // 直接解码会在日志首字符产生乱码（U+FFFD）；跳过续字节到字符边界再解码
+        // （与服务端 `truncateLogTail` 同一口径）。
+        let start = 0;
+        while (start < buffer.length && (buffer[start] & 0xc0) === 0x80)
+            start += 1;
+        return buffer.subarray(start).toString('utf8');
+    }
+}
+function nowIso() {
+    return new Date().toISOString();
+}
+/**
+ * 工作负载脚本执行器（agent-gear 侧）。
+ *
+ * - 按 `items` 顺序**串行**执行 `bash -c <script>`（`cwd=os.homedir()`，继承进程环境，stdout/stderr 合并捕获）；
+ * - 单条超时或收到新批次时终止整个进程组（`detached: true` + `kill(-pid)`）；
+ * - 非零退出回报 `failed` + `exitCode`，不影响后续条目；
+ * - `post` 批次共享 `budgetMs`：剩余预算耗尽时后续条目直接回报 `timeout`（不启动进程）；
+ * - 未被服务端确认的结果保存在内存（上限 50 条）供重连重放。
+ *
+ * 进程内全局单实例，保证同一时间只跑一个批次（后到的批次打断前一个，用于 post 打断 init）。
+ */
+export class WorkloadExecutor {
+    active = null;
+    activePromise = null;
+    pendingResults = [];
+    /** 当前是否有批次正在执行。 */
+    isRunning() {
+        return this.active !== null;
+    }
+    /** 未确认的执行结果快照（供重连重放读取）。 */
+    getPendingResults() {
+        return [...this.pendingResults];
+    }
+    /** 清空未确认的执行结果。 */
+    clearPendingResults() {
+        this.pendingResults = [];
+    }
+    /**
+     * 重连后重放未确认结果：逐条 emit 后清空缓冲。
+     * 服务端对已进入终态的记录按幂等忽略（契约 §2.9/§2.10）。
+     */
+    replayPendingResults(emit) {
+        const pending = this.getPendingResults();
+        this.clearPendingResults();
+        for (const result of pending) {
+            emit(result);
+        }
+    }
+    /** 等待当前批次结束；无批次时立即返回，超时也返回（不阻塞退出流程）。 */
+    async waitForIdle(timeoutMs) {
+        const promise = this.activePromise;
+        if (!this.active || !promise)
+            return;
+        let timer;
+        const timeout = new Promise((resolve) => {
+            timer = setTimeout(resolve, timeoutMs);
+        });
+        try {
+            await Promise.race([promise.then(() => undefined, () => undefined), timeout]);
+        }
+        finally {
+            if (timer)
+                clearTimeout(timer);
+        }
+    }
+    /**
+     * 执行一个批次。若已有批次在跑，先终止其进程组并停止推进，再执行新批次。
+     */
+    runBatch(payload, onResult) {
+        this.interruptActive();
+        const run = { cancelled: false, child: null };
+        this.active = run;
+        const promise = this.executeBatch(payload, onResult, run).finally(() => {
+            // 仅当自己仍是当前批次时才清空（被打断时 active 已指向新批次）
+            if (this.active === run) {
+                this.active = null;
+                this.activePromise = null;
+            }
+        });
+        this.activePromise = promise;
+        return promise;
+    }
+    async executeBatch(payload, onResult, run) {
+        const items = Array.isArray(payload?.items) ? payload.items : [];
+        if (items.length === 0)
+            return;
+        const budgetMs = typeof payload.budgetMs === 'number' && payload.budgetMs > 0 ? payload.budgetMs : null;
+        const batchStart = Date.now();
+        for (const item of items) {
+            if (run.cancelled)
+                return;
+            let effectiveTimeoutMs = item.timeoutMs;
+            if (budgetMs !== null) {
+                const remaining = budgetMs - (Date.now() - batchStart);
+                if (remaining <= 0) {
+                    // 预算耗尽：后续条目不再启动进程，直接回报 timeout
+                    this.report(onResult, this.emptyResult(item.logId, 'timeout', ''));
+                    continue;
+                }
+                effectiveTimeoutMs = Math.min(item.timeoutMs, remaining);
+            }
+            if (!item.script || item.script.trim().length === 0) {
+                this.report(onResult, this.emptyResult(item.logId, 'failed', EMPTY_SCRIPT_MESSAGE));
+                continue;
+            }
+            const outcome = await this.executeItem(item, effectiveTimeoutMs, run);
+            if (outcome.cancelled)
+                return;
+            if (outcome.result)
+                this.report(onResult, outcome.result);
+        }
+    }
+    report(onResult, result) {
+        this.pendingResults.push(result);
+        while (this.pendingResults.length > MAX_PENDING_RESULTS) {
+            this.pendingResults.shift();
+        }
+        onResult(result);
+    }
+    emptyResult(logId, status, log) {
+        const now = nowIso();
+        return { logId, status, exitCode: null, log, startedAt: now, finishedAt: now };
+    }
+    executeItem(item, timeoutMs, run) {
+        return new Promise((resolve) => {
+            if (run.cancelled) {
+                resolve({ cancelled: true });
+                return;
+            }
+            const startedAt = nowIso();
+            let child;
+            try {
+                child = spawn('bash', ['-c', item.script], {
+                    cwd: homedir(),
+                    detached: true,
+                    env: process.env,
+                });
+            }
+            catch (error) {
+                resolve({
+                    cancelled: false,
+                    result: {
+                        logId: item.logId,
+                        status: 'failed',
+                        exitCode: null,
+                        log: `启动脚本失败: ${error.message}`,
+                        startedAt,
+                        finishedAt: nowIso(),
+                    },
+                });
+                return;
+            }
+            run.child = child;
+            const tail = new TailBuffer(MAX_OUTPUT_BYTES);
+            let settled = false;
+            let timedOut = false;
+            const finish = (outcome) => {
+                if (settled)
+                    return;
+                settled = true;
+                clearTimeout(timer);
+                if (run.child === child)
+                    run.child = null;
+                resolve(outcome);
+            };
+            const timer = setTimeout(() => {
+                timedOut = true;
+                this.killGroup(child);
+            }, Math.max(1, timeoutMs));
+            child.stdout?.on('data', (chunk) => tail.push(chunk));
+            child.stderr?.on('data', (chunk) => tail.push(chunk));
+            child.on('error', (error) => {
+                tail.push(Buffer.from(`\n[执行脚本失败] ${error.message}`));
+                if (run.cancelled) {
+                    finish({ cancelled: true });
+                    return;
+                }
+                finish({
+                    cancelled: false,
+                    result: {
+                        logId: item.logId,
+                        status: 'failed',
+                        exitCode: null,
+                        log: tail.toString(),
+                        startedAt,
+                        finishedAt: nowIso(),
+                    },
+                });
+            });
+            child.on('close', (code, signal) => {
+                if (run.cancelled) {
+                    finish({ cancelled: true });
+                    return;
+                }
+                if (timedOut) {
+                    finish({
+                        cancelled: false,
+                        result: {
+                            logId: item.logId,
+                            status: 'timeout',
+                            exitCode: null,
+                            log: tail.toString(),
+                            startedAt,
+                            finishedAt: nowIso(),
+                        },
+                    });
+                    return;
+                }
+                const exitCode = code ?? (signal ? 1 : 0);
+                finish({
+                    cancelled: false,
+                    result: {
+                        logId: item.logId,
+                        status: exitCode === 0 ? 'success' : 'failed',
+                        exitCode,
+                        log: tail.toString(),
+                        startedAt,
+                        finishedAt: nowIso(),
+                    },
+                });
+            });
+        });
+    }
+    interruptActive() {
+        const run = this.active;
+        if (!run)
+            return;
+        run.cancelled = true;
+        this.killGroup(run.child);
+    }
+    killGroup(child) {
+        if (!child || child.pid == null)
+            return;
+        try {
+            process.kill(-child.pid, 'SIGKILL');
+        }
+        catch {
+            try {
+                child.kill('SIGKILL');
+            }
+            catch {
+                /* process already exited */
+            }
+        }
+    }
+}
+//# sourceMappingURL=workload-executor.js.map

package/dist/workload-executor.js.map

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

package/dist/workload-executor.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=workload-executor.test.d.ts.map

package/dist/workload-executor.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workload-executor.test.d.ts","sourceRoot":"","sources":["../src/workload-executor.test.ts"],"names":[],"mappings":""}

package/dist/workload-executor.test.js

@@ -0,0 +1,214 @@
+import { describe, it, expect, afterEach } from 'vitest';
+import { mkdtemp, mkdir, rm, access } from 'node:fs/promises';
+import { join } from 'node:path';
+import { setTimeout as delay } from 'node:timers/promises';
+import { WorkloadExecutor, MAX_OUTPUT_BYTES, MAX_PENDING_RESULTS, EMPTY_SCRIPT_MESSAGE, } from './workload-executor.js';
+const TMP_BASE = '/tmp/opencode';
+function collect() {
+    const results = [];
+    return { results, sink: (result) => results.push(result) };
+}
+async function makeTmpDir() {
+    await mkdir(TMP_BASE, { recursive: true });
+    return mkdtemp(join(TMP_BASE, 'we-'));
+}
+async function fileExists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+describe('WorkloadExecutor', () => {
+    const dirs = [];
+    afterEach(async () => {
+        await Promise.all(dirs.splice(0).map((dir) => rm(dir, { recursive: true, force: true })));
+    });
+    it('T-WE1 runs items serially, merges stdout+stderr and reports success in item order', async () => {
+        const executor = new WorkloadExecutor();
+        const { results, sink } = collect();
+        await executor.runBatch({
+            phase: 'init',
+            items: [
+                { logId: 'a', workloadName: 'A', script: 'echo out-a; echo err-a >&2', timeoutMs: 5000 },
+                { logId: 'b', workloadName: 'B', script: 'echo out-b', timeoutMs: 5000 },
+            ],
+        }, sink);
+        expect(results.map((r) => r.logId)).toEqual(['a', 'b']);
+        expect(results[0]).toMatchObject({ status: 'success', exitCode: 0 });
+        expect(results[0].log).toContain('out-a');
+        expect(results[0].log).toContain('err-a');
+        expect(results[1]).toMatchObject({ status: 'success', exitCode: 0 });
+        expect(results[1].log).toContain('out-b');
+        expect(results[0].startedAt).toMatch(/^\d{4}-\d{2}-\d{2}T/);
+        expect(results[0].finishedAt).toMatch(/^\d{4}-\d{2}-\d{2}T/);
+    });
+    it('T-WE2 reports failed with exitCode on non-zero exit and continues the batch', async () => {
+        const executor = new WorkloadExecutor();
+        const { results, sink } = collect();
+        await executor.runBatch({
+            phase: 'init',
+            items: [
+                { logId: 'fail', workloadName: 'F', script: 'echo boom >&2; exit 3', timeoutMs: 5000 },
+                { logId: 'ok', workloadName: 'O', script: 'echo ok', timeoutMs: 5000 },
+            ],
+        }, sink);
+        expect(results[0]).toMatchObject({ logId: 'fail', status: 'failed', exitCode: 3 });
+        expect(results[0].log).toContain('boom');
+        expect(results[1]).toMatchObject({ logId: 'ok', status: 'success' });
+    });
+    it('T-WE3 kills the whole process group on per-item timeout and continues', async () => {
+        const dir = await makeTmpDir();
+        dirs.push(dir);
+        const marker = join(dir, 'leaked.txt');
+        const executor = new WorkloadExecutor();
+        const { results, sink } = collect();
+        const started = Date.now();
+        await executor.runBatch({
+            phase: 'init',
+            items: [
+                { logId: 'slow', workloadName: 'S', script: `( sleep 1.5; echo leaked > ${marker} ) & sleep 30`, timeoutMs: 300 },
+                { logId: 'next', workloadName: 'N', script: 'echo next', timeoutMs: 5000 },
+            ],
+        }, sink);
+        const elapsed = Date.now() - started;
+        expect(elapsed).toBeLessThan(5000);
+        expect(results[0]).toMatchObject({ logId: 'slow', status: 'timeout', exitCode: null });
+        expect(results[1]).toMatchObject({ logId: 'next', status: 'success' });
+        // the backgrounded child would write the marker at 1.5s if the group was not killed
+        await delay(2000);
+        expect(await fileExists(marker)).toBe(false);
+    }, 15000);
+    it('T-WE4 truncates oversized output keeping the tail <= 256 KiB', async () => {
+        const executor = new WorkloadExecutor();
+        const { results, sink } = collect();
+        await executor.runBatch({
+            phase: 'init',
+            items: [{ logId: 'big', workloadName: 'Big', script: "yes A | head -c 300000; printf 'ENDMARK'", timeoutMs: 10000 }],
+        }, sink);
+        expect(results).toHaveLength(1);
+        expect(results[0].status).toBe('success');
+        expect(Buffer.byteLength(results[0].log, 'utf8')).toBeLessThanOrEqual(MAX_OUTPUT_BYTES);
+        expect(results[0].log.endsWith('ENDMARK')).toBe(true);
+    }, 15000);
+    it('T-WE4b: skips a leading split UTF-8 continuation byte when truncating the tail', async () => {
+        const executor = new WorkloadExecutor();
+        const { results, sink } = collect();
+        // 总长 262145 字节（3 字节「中」+ 262142 个 A），尾部保留 262144 字节 => 起点落在
+        // 「中」的第 2 个字节（续字节）上；截断后必须跳过续字节到字符边界，首字符不得是乱码。
+        await executor.runBatch({
+            phase: 'init',
+            items: [
+                {
+                    logId: 'utf8',
+                    workloadName: 'Utf8',
+                    script: "printf '中'; head -c 262142 /dev/zero | tr '\\0' 'A'",
+                    timeoutMs: 10000,
+                },
+            ],
+        }, sink);
+        expect(results).toHaveLength(1);
+        const log = results[0].log;
+        expect(log.includes('\uFFFD')).toBe(false);
+        expect(log).toBe('A'.repeat(262142));
+        expect(Buffer.byteLength(log, 'utf8')).toBeLessThanOrEqual(MAX_OUTPUT_BYTES);
+    }, 15000);
+    it('T-WE5 shares the post budget and reports timeout without starting later items', async () => {
+        const executor = new WorkloadExecutor();
+        const { results, sink } = collect();
+        const started = Date.now();
+        await executor.runBatch({
+            phase: 'post',
+            budgetMs: 300,
+            items: [
+                { logId: 'p1', workloadName: 'P1', script: 'sleep 2', timeoutMs: 10000 },
+                { logId: 'p2', workloadName: 'P2', script: 'echo should-not-run', timeoutMs: 10000 },
+            ],
+        }, sink);
+        const elapsed = Date.now() - started;
+        expect(elapsed).toBeLessThan(5000);
+        expect(results.map((r) => r.logId)).toEqual(['p1', 'p2']);
+        expect(results[0]).toMatchObject({ status: 'timeout', exitCode: null });
+        expect(results[1]).toMatchObject({ status: 'timeout', exitCode: null });
+        expect(results[1].log).not.toContain('should-not-run');
+    }, 15000);
+    it('T-WE6 buffers unconfirmed results and replays then clears on reconnect', async () => {
+        const executor = new WorkloadExecutor();
+        await executor.runBatch({
+            phase: 'init',
+            items: [
+                { logId: 'r1', workloadName: 'R1', script: 'echo one', timeoutMs: 5000 },
+                { logId: 'r2', workloadName: 'R2', script: 'echo two', timeoutMs: 5000 },
+            ],
+        }, () => { });
+        expect(executor.getPendingResults().map((r) => r.logId)).toEqual(['r1', 'r2']);
+        const replayed = [];
+        executor.replayPendingResults((result) => replayed.push(result));
+        expect(replayed.map((r) => r.logId)).toEqual(['r1', 'r2']);
+        expect(executor.getPendingResults()).toHaveLength(0);
+    });
+    it('T-WE6b caps the replay buffer at 50 results', async () => {
+        const executor = new WorkloadExecutor();
+        const items = Array.from({ length: MAX_PENDING_RESULTS + 5 }, (_, i) => ({
+            logId: `x${i}`,
+            workloadName: `X${i}`,
+            script: ':',
+            timeoutMs: 5000,
+        }));
+        await executor.runBatch({ phase: 'init', items }, () => { });
+        const pending = executor.getPendingResults();
+        expect(pending).toHaveLength(MAX_PENDING_RESULTS);
+        expect(pending[pending.length - 1].logId).toBe(`x${MAX_PENDING_RESULTS + 4}`);
+    }, 30000);
+    it('T-WE7 terminates the running init batch when a new post batch arrives', async () => {
+        const dir = await makeTmpDir();
+        dirs.push(dir);
+        const startedFile = join(dir, 'init-started');
+        const executor = new WorkloadExecutor();
+        const initResults = [];
+        const initBatch = executor.runBatch({
+            phase: 'init',
+            items: [{ logId: 'init-1', workloadName: 'Init', script: `touch ${startedFile}; sleep 30`, timeoutMs: 60000 }],
+        }, (result) => initResults.push(result));
+        // wait until the init child process has actually started
+        const deadline = Date.now() + 5000;
+        let startedFlag = false;
+        while (Date.now() < deadline) {
+            if (await fileExists(startedFile)) {
+                startedFlag = true;
+                break;
+            }
+            await delay(25);
+        }
+        expect(startedFlag).toBe(true);
+        const postResults = [];
+        await executor.runBatch({ phase: 'post', items: [{ logId: 'post-1', workloadName: 'Post', script: 'echo post-ok', timeoutMs: 5000 }] }, (result) => postResults.push(result));
+        await initBatch;
+        expect(postResults.map((r) => r.logId)).toEqual(['post-1']);
+        expect(postResults[0].status).toBe('success');
+        // the interrupted init item is not reported; the server marks it TIMEOUT
+        expect(initResults).toHaveLength(0);
+    }, 20000);
+    it('T-WE8 reports failed for an empty script and does nothing for empty items', async () => {
+        const executor = new WorkloadExecutor();
+        const { results, sink } = collect();
+        await executor.runBatch({ phase: 'init', items: [{ logId: 'empty', workloadName: 'Empty', script: '   ', timeoutMs: 5000 }] }, sink);
+        expect(results).toHaveLength(1);
+        expect(results[0]).toMatchObject({ logId: 'empty', status: 'failed', exitCode: null, log: EMPTY_SCRIPT_MESSAGE });
+        const empty = collect();
+        await executor.runBatch({ phase: 'init', items: [] }, empty.sink);
+        expect(empty.results).toHaveLength(0);
+    });
+    it('T-WE9 exposes running state and waitForIdle resolves after the batch completes', async () => {
+        const executor = new WorkloadExecutor();
+        expect(executor.isRunning()).toBe(false);
+        const batch = executor.runBatch({ phase: 'post', items: [{ logId: 'w', workloadName: 'W', script: 'sleep 0.4', timeoutMs: 5000 }] }, () => { });
+        expect(executor.isRunning()).toBe(true);
+        await executor.waitForIdle(2000);
+        expect(executor.isRunning()).toBe(false);
+        await batch;
+    }, 10000);
+});
+//# sourceMappingURL=workload-executor.test.js.map

package/dist/workload-executor.test.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-gear",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "description": "ZeroAsh Agent Gear - Agent controller daemon",
   "repository": {
     "type": "git",

package/src/index.ts

@@ -1,5 +1,6 @@
 #!/usr/bin/env node
 import { Command } from 'commander';
+import { createRequire } from 'node:module';
 import { hostname, platform } from 'os';
 import { resolveKey, resolveEndpoint, saveKeyToConfig, saveEndpointToConfig } from './config.js';
 import { connectToServer } from './socketio-client.js';
@@ -8,12 +9,17 @@ import { startMcpRegistration } from './commands/mcp-proxy.js';
 import { startMcpProxy } from './commands/mcp.js';
 import { processRegistry, isProcessAlive } from './acp/process-registry.js';
 
+// 版本号唯一事实源为 package.json（`--version` 与 npm 发布版本保持一致，避免手工同步漂移）。
+const { version: CLI_VERSION } = createRequire(import.meta.url)('../package.json') as {
+  version: string;
+};
+
 const program = new Command();
 
 program
   .name('agent-gear')
   .description('Agent Controller - manages connection to controller-api')
-  .version('1.0.0')
+  .version(CLI_VERSION)
   .option('-k, --key <key>', 'Controller key')
   .option('-s, --server <endpoint>', 'Server endpoint URL')
   .option('-n, --name <name>', 'Controller name')