toc-ocra 0.2.0

package/dist/src/runs/run-supervisor.js

@@ -0,0 +1,285 @@
+import { spawn } from 'node:child_process';
+import { realpath } from 'node:fs/promises';
+import { isAbsolute, relative, resolve } from 'node:path';
+import { createInterface } from 'node:readline';
+import { resolveHeadlessProvider } from '../providers/registry.js';
+import { sanitizeTerminalLine } from '../session/terminal-line-sanitizer.js';
+import { TerminalTailBuffer } from '../session/terminal-tail-buffer.js';
+import { killProcessTree } from './process-tree.js';
+/**
+ * Supervises headless CLI turns. One process per turn:
+ *
+ *   spawn -> report started(pid) -> parse stdout (session id, answer)
+ *         -> process exits -> report finished(status, final answer)
+ *
+ * "Done" is the process exit. If the CLI already declared the turn finished
+ * but its process lingers, it is stopped after COMPLETION_EXIT_GRACE_MS, so
+ * a finished turn can never keep the workstation busy. Stop kills the whole
+ * process tree.
+ */
+export const COMPLETION_EXIT_GRACE_MS = 15_000;
+const RECENT_RUN_TTL_MS = 10 * 60_000;
+const MAX_RECENT_RUNS = 100;
+const MAX_ERROR_ROWS = 40;
+export class RunSupervisor {
+    config;
+    logger;
+    reporter;
+    orphans;
+    active = new Map();
+    recent = new Map();
+    /** Run ids whose finish report has not been acknowledged yet. */
+    unreported = new Set();
+    constructor(config, logger, reporter, orphans) {
+        this.config = config;
+        this.logger = logger;
+        this.reporter = reporter;
+        this.orphans = orphans;
+    }
+    get activeCount() {
+        return this.active.size;
+    }
+    /** Runs to list in the heartbeat: still running, or finished but not yet reported. */
+    activeRunIds() {
+        return [...new Set([...this.active.keys(), ...this.unreported])];
+    }
+    markReported(runId) {
+        this.unreported.delete(runId);
+    }
+    recentRuns() {
+        const running = [...this.active.values()].map((run) => ({ runId: run.runId, workstationId: run.workstationId, status: 'running', at: run.startedAt }));
+        const done = [...this.recent.values()].map((run) => ({ runId: run.runId, workstationId: run.workstationId, status: run.status, at: run.finishedAt }));
+        return [...running, ...done].sort((a, b) => b.at - a.at).slice(0, 30);
+    }
+    /**
+     * Starts a turn. Refusals (busy workstation, concurrency limit, bad work
+     * directory, unknown CLI) are reported as a failed run, never thrown.
+     */
+    async start(payload) {
+        if (this.active.has(payload.run_id) || this.recent.has(payload.run_id)) {
+            this.logger.info('run-duplicate-ignored', { runId: payload.run_id });
+            return;
+        }
+        const refuse = async (error) => {
+            this.logger.warn('run-refused', { runId: payload.run_id, error });
+            this.remember({ runId: payload.run_id, workstationId: payload.workstation_id, tail: new TerminalTailBuffer(), finishedAt: Date.now(), status: 'failed' });
+            await this.report(payload.run_id, { status: 'failed', error, duration_ms: 0 });
+        };
+        if ([...this.active.values()].some((run) => run.workstationId === payload.workstation_id)) {
+            return refuse('本机该工位已有任务在运行');
+        }
+        if (this.active.size >= this.config.maxConcurrentRuns) {
+            return refuse(`本机同时运行的任务已达上限（${this.config.maxConcurrentRuns}）`);
+        }
+        let provider;
+        let workdir;
+        try {
+            provider = resolveHeadlessProvider(payload.agent_type);
+            workdir = await this.validateWorkdir(payload.workdir || this.config.allowedRoots[0]);
+        }
+        catch (error) {
+            return refuse(errorMessage(error));
+        }
+        const launch = provider.buildLaunch({
+            prompt: payload.prompt,
+            sessionId: payload.session_id,
+            model: payload.model,
+            reasoningEffort: payload.reasoning_effort,
+            workdir
+        });
+        let child;
+        try {
+            child = spawn(launch.executable, launch.args, {
+                cwd: workdir,
+                env: launch.env,
+                detached: process.platform !== 'win32',
+                shell: false,
+                windowsHide: true,
+                stdio: ['ignore', 'pipe', 'pipe']
+            });
+        }
+        catch (error) {
+            return refuse(`无法启动 ${provider.id}：${errorMessage(error)}`);
+        }
+        const run = {
+            runId: payload.run_id,
+            workstationId: payload.workstation_id,
+            agentType: provider.id,
+            provider,
+            child,
+            pid: child.pid ?? 0,
+            startedAt: Date.now(),
+            sessionId: payload.session_id,
+            finalMessage: '',
+            turnCompleted: false,
+            turnError: '',
+            stderr: [],
+            cancelRequested: false,
+            killedAfterCompletion: false,
+            timedOut: false,
+            tail: new TerminalTailBuffer(),
+            timers: []
+        };
+        this.active.set(run.runId, run);
+        this.unreported.add(run.runId);
+        if (run.pid > 1)
+            this.orphans?.add({ runId: run.runId, pid: run.pid, executable: launch.executable, startedAt: run.startedAt });
+        run.tail.append(`● ${provider.id} 启动于 ${workdir}${payload.session_id ? `（继续会话 ${payload.session_id}）` : ''}\n`);
+        this.logger.info('run-started', { runId: run.runId, agentType: provider.id, pid: run.pid, resume: Boolean(payload.session_id) });
+        let spawnError = '';
+        child.once('error', (error) => {
+            spawnError = error.message;
+        });
+        createInterface({ input: child.stdout }).on('line', (line) => this.onStdout(run, line));
+        createInterface({ input: child.stderr }).on('line', (line) => {
+            const clean = sanitizeTerminalLine(line);
+            if (!clean.trim())
+                return;
+            run.stderr.push(clean);
+            if (run.stderr.length > MAX_ERROR_ROWS)
+                run.stderr.shift();
+            run.tail.append(`${clean}\n`);
+        });
+        child.once('close', (code, signal) => void this.onExit(run, code, signal, spawnError));
+        const maxMs = this.config.maxRunSeconds * 1_000;
+        run.timers.push(setTimeout(() => {
+            run.timedOut = true;
+            run.tail.append(`✗ 超过最长运行时间 ${this.config.maxRunSeconds} 秒，已终止\n`);
+            void killProcessTree(run.pid);
+        }, maxMs));
+        if (run.pid > 0)
+            await this.reporter.started(run.runId, { pid: run.pid }).catch((error) => {
+                this.logger.warn('run-started-report-failed', { runId: run.runId, error: errorMessage(error) });
+            });
+    }
+    onStdout(run, rawLine) {
+        const line = sanitizeTerminalLine(rawLine);
+        const parsed = run.provider.parseLine(line);
+        for (const row of parsed.display)
+            run.tail.append(`${row}\n`);
+        if (parsed.message !== undefined)
+            run.finalMessage = parsed.message;
+        if (parsed.turnError)
+            run.turnError = parsed.turnError;
+        if (parsed.sessionId && parsed.sessionId !== run.sessionId) {
+            run.sessionId = parsed.sessionId;
+            void this.reporter.started(run.runId, { session_id: parsed.sessionId }).catch(() => undefined);
+        }
+        if ((parsed.turnCompleted || parsed.turnError) && !run.turnCompleted) {
+            run.turnCompleted = true;
+            // The turn is over; do not let a lingering process hold the workstation.
+            run.timers.push(setTimeout(() => {
+                if (!this.active.has(run.runId))
+                    return;
+                run.killedAfterCompletion = true;
+                run.tail.append('● 本轮已完成但进程未退出，已结束进程\n');
+                void killProcessTree(run.pid);
+            }, COMPLETION_EXIT_GRACE_MS));
+        }
+    }
+    async onExit(run, code, signal, spawnError) {
+        for (const timer of run.timers)
+            clearTimeout(timer);
+        this.active.delete(run.runId);
+        this.orphans?.remove(run.runId);
+        const durationMs = Date.now() - run.startedAt;
+        let report;
+        if (run.cancelRequested) {
+            report = { status: 'cancelled', duration_ms: durationMs };
+        }
+        else if (spawnError) {
+            report = { status: 'failed', error: `无法启动 ${run.agentType}：${spawnError}`, duration_ms: durationMs };
+        }
+        else if (run.timedOut) {
+            report = { status: 'failed', error: `超过最长运行时间 ${this.config.maxRunSeconds} 秒`, duration_ms: durationMs };
+        }
+        else if (run.turnError) {
+            report = { status: 'failed', error: run.turnError, duration_ms: durationMs };
+        }
+        else if (code === 0 || run.killedAfterCompletion) {
+            report = { status: 'succeeded', duration_ms: durationMs };
+        }
+        else {
+            const detail = run.stderr.slice(-8).join('\n').trim();
+            report = { status: 'failed', error: detail || `${run.agentType} 异常退出${signal ? `（${signal}）` : ''}`, duration_ms: durationMs };
+        }
+        if (code !== null)
+            report.exit_code = code;
+        if (run.sessionId)
+            report.session_id = run.sessionId;
+        if (run.finalMessage)
+            report.final_message = run.finalMessage;
+        run.tail.append(`● 进程已退出：${report.status}${code !== null ? `（exit ${code}）` : ''}\n`);
+        this.remember({ runId: run.runId, workstationId: run.workstationId, tail: run.tail, finishedAt: Date.now(), status: report.status });
+        this.logger.info('run-finished', { runId: run.runId, status: report.status, code, durationMs });
+        await this.report(run.runId, report);
+    }
+    async report(runId, report) {
+        this.unreported.add(runId);
+        await this.reporter.finished(runId, report);
+    }
+    /** Stops a run: the whole process tree, then a `cancelled` report. */
+    async cancel(runId) {
+        const run = this.active.get(runId);
+        if (!run)
+            return false;
+        run.cancelRequested = true;
+        run.tail.append('● 收到停止指令，正在结束进程树\n');
+        this.logger.info('run-cancel', { runId, pid: run.pid });
+        await killProcessTree(run.pid);
+        return true;
+    }
+    tail(query, limit, beforeCursor) {
+        const byId = (id) => (id ? this.active.get(id) ?? this.recent.get(id) : undefined);
+        const byWorkstation = (id) => {
+            if (!id)
+                return undefined;
+            const live = [...this.active.values()].find((run) => run.workstationId === id);
+            if (live)
+                return live;
+            return [...this.recent.values()].filter((run) => run.workstationId === id).sort((a, b) => b.finishedAt - a.finishedAt)[0];
+        };
+        const target = byId(query.runId) ?? byWorkstation(query.workstationId);
+        if (!target) {
+            return { status: 'idle', lines: [], startCursor: 0, nextCursor: 0, oldestCursor: 0, latestCursor: 0, hasMore: false, truncated: false, limited: false, idleMs: undefined };
+        }
+        const read = target.tail.read(beforeCursor === undefined ? { limit } : { limit, beforeCursor });
+        return { ...read, status: this.active.has(target.runId) ? 'running' : 'finished', run_id: target.runId };
+    }
+    async disposeAll() {
+        await Promise.all([...this.active.values()].map((run) => {
+            run.cancelRequested = true;
+            return killProcessTree(run.pid, 1_000);
+        }));
+    }
+    remember(run) {
+        this.recent.set(run.runId, run);
+        const cutoff = Date.now() - RECENT_RUN_TTL_MS;
+        for (const [id, item] of this.recent) {
+            if (item.finishedAt < cutoff || this.recent.size > MAX_RECENT_RUNS)
+                this.recent.delete(id);
+        }
+    }
+    async validateWorkdir(input) {
+        if (!input)
+            throw new Error('没有配置允许的工作目录');
+        let candidate;
+        try {
+            candidate = await realpath(isAbsolute(input) ? input : resolve(input));
+        }
+        catch {
+            throw new Error(`工作目录不存在：${input}`);
+        }
+        for (const root of this.config.allowedRoots) {
+            const allowed = await realpath(root).catch(() => resolve(root));
+            const segment = relative(allowed, candidate);
+            if (segment === '' || (!segment.startsWith('..') && !isAbsolute(segment)))
+                return candidate;
+        }
+        throw new Error(`工作目录不在允许范围内：${input}`);
+    }
+}
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=run-supervisor.js.map

package/dist/src/runs/run-supervisor.js.map

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

package/dist/src/runtime/agent-runtime.d.ts

@@ -0,0 +1,68 @@
+import type { AgentConfig } from '../config.js';
+import type { HealthSnapshot } from '../health/server.js';
+import { type DiagnosticLogger } from '../logging/diagnostic-log.js';
+import type { CliDetectionSnapshot } from '../shared/cli-detection-types.js';
+/**
+ * The agent's main loop, with no persistent connection:
+ *   - heartbeat every `heartbeatInterval` seconds (liveness + reconciliation)
+ *   - long-poll for commands, handling each one concurrently
+ *   - run reports retried until the server acknowledges them
+ */
+export declare class AgentRuntime {
+    private readonly config;
+    private readonly version;
+    private readonly logger;
+    private readonly client;
+    private readonly runs;
+    private readonly orphans;
+    private readonly workspaces;
+    private readonly stopController;
+    private readonly startedAt;
+    private detection?;
+    private policy;
+    private heartbeatInterval;
+    private pollWait;
+    private lastHeartbeatOk;
+    private lastError;
+    /** The server rejected the device token (revoked or unpaired). */
+    private unauthorized;
+    private readonly ownsLogger;
+    private deviceName;
+    /** Finish reports not yet acknowledged; retried on every heartbeat. */
+    private readonly pendingReports;
+    /** Model catalogs of the installed CLIs; re-read in the background. */
+    private readonly models;
+    private catalogReport;
+    private catalogRefresh;
+    /** Hash of the catalogs the server has stored (from its heartbeat reply). */
+    private serverCatalogHash;
+    constructor(config: AgentConfig, version: string, logger?: DiagnosticLogger);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    /** Current state, for the local dashboard and the plugin. */
+    snapshot(): HealthSnapshot & {
+        unauthorized: boolean;
+        activeRunIds: string[];
+    };
+    /** Re-detects installed CLIs and pushes the change with the next heartbeat. */
+    refreshDetection(): Promise<CliDetectionSnapshot>;
+    private heartbeatLoop;
+    private heartbeat;
+    /** Re-reads catalogs whose sources changed; concurrent calls share one run. */
+    private refreshCatalogs;
+    private capabilitySummary;
+    private noteFailure;
+    private pollLoop;
+    private handle;
+    private execute;
+    /**
+     * Script / SQL run only when the server policy allows it and the local
+     * owner has not switched it off. The policy attached to the command was
+     * checked by the server at enqueue time, so it wins over the (up to one
+     * heartbeat old) cached copy. New policy fields (read-only SQL,
+     * allowlists) are enforced here.
+     */
+    private checkPolicy;
+    private flushReport;
+    private retry;
+}