agent-cli-runtime 0.1.0-alpha.0

package/dist/parsers/opencode-json.js

@@ -0,0 +1,72 @@
+import { isRecord, LineBuffer, safeJsonParse } from "./line-buffer.js";
+export class OpenCodeJsonParser {
+    lines = new LineBuffer();
+    parse(chunk) {
+        return this.lines.push(chunk).flatMap((line) => this.parseLine(line));
+    }
+    flush() {
+        return this.lines.flush().flatMap((line) => this.parseLine(line));
+    }
+    parseLine(line) {
+        const value = safeJsonParse(line);
+        if (!isRecord(value))
+            return [];
+        const part = isRecord(value.part) ? value.part : {};
+        if (value.type === "step_start")
+            return [{ type: "status", label: "running" }];
+        if (value.type === "text" && typeof part.text === "string")
+            return [{ type: "text_delta", text: part.text }];
+        if (value.type === "tool_use" && typeof part.callID === "string") {
+            const state = isRecord(part.state) ? part.state : {};
+            const events = [];
+            if (typeof part.tool === "string") {
+                events.push({ type: "tool_call", id: part.callID, name: part.tool, input: parseMaybeJson(state.input) });
+            }
+            if (state.status === "completed") {
+                events.push({ type: "tool_result", id: part.callID, output: state.output, isError: false });
+            }
+            return events;
+        }
+        if (value.type === "step_finish") {
+            const usage = usageFrom(isRecord(part.tokens) ? part.tokens : null);
+            return usage ? [{ type: "usage", usage, costUsd: typeof part.cost === "number" ? part.cost : undefined }] : [];
+        }
+        if (value.type === "file" && typeof part.path === "string") {
+            return [{ type: "file_event", path: part.path, action: fileAction(part.action) }];
+        }
+        if (value.type === "error") {
+            return [{ type: "error", code: "AGENT_EXECUTION_FAILED", message: errorMessage(value, "OpenCode error") }];
+        }
+        return [];
+    }
+}
+function parseMaybeJson(value) {
+    if (typeof value !== "string")
+        return value;
+    return safeJsonParse(value) ?? value;
+}
+function usageFrom(tokens) {
+    if (!tokens)
+        return null;
+    const usage = {};
+    if (typeof tokens.input === "number")
+        usage.inputTokens = tokens.input;
+    if (typeof tokens.output === "number")
+        usage.outputTokens = tokens.output;
+    if (typeof tokens.reasoning === "number")
+        usage.thinkingTokens = tokens.reasoning;
+    return Object.keys(usage).length > 0 ? usage : null;
+}
+function errorMessage(value, fallback) {
+    if (typeof value.message === "string" && value.message)
+        return value.message;
+    if (isRecord(value.error) && typeof value.error.message === "string")
+        return value.error.message;
+    if (typeof value.error === "string" && value.error)
+        return value.error;
+    return fallback;
+}
+function fileAction(value) {
+    return value === "created" || value === "updated" || value === "deleted" ? value : "unknown";
+}
+//# sourceMappingURL=opencode-json.js.map

package/dist/parsers/opencode-json.js.map

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

package/dist/parsers/plain-lines.d.ts

@@ -0,0 +1,6 @@
+import type { AgentEventInput } from "../core/events.js";
+import type { StreamParser } from "../adapters/adapter-types.js";
+export declare class PlainLineParser implements StreamParser {
+    parse(chunk: string): AgentEventInput[];
+    flush(): AgentEventInput[];
+}

package/dist/parsers/plain-lines.js

@@ -0,0 +1,9 @@
+export class PlainLineParser {
+    parse(chunk) {
+        return chunk ? [{ type: "text_delta", text: chunk }] : [];
+    }
+    flush() {
+        return [];
+    }
+}
+//# sourceMappingURL=plain-lines.js.map

package/dist/parsers/plain-lines.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plain-lines.js","sourceRoot":"","sources":["../../src/parsers/plain-lines.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,eAAe;IAC1B,KAAK,CAAC,KAAa;QACjB,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5D,CAAC;IAED,KAAK;QACH,OAAO,EAAE,CAAC;IACZ,CAAC;CACF"}

package/dist/public-types.d.ts

@@ -0,0 +1,143 @@
+import type { RuntimeDiagnostic } from "./core/diagnostics.js";
+export type RuntimeEnvironment = Record<string, string | undefined>;
+export interface InspectStoreOptions {
+    storageDir?: string;
+}
+export interface RuntimeOwner {
+    runtimeInstanceId: string;
+    pid: number;
+    startedAt: number;
+    heartbeatAt: number;
+    closedAt?: number;
+}
+export type OwnerStatus = "missing" | "live" | "stale" | "closed" | "invalid";
+export interface StorageLockInspection {
+    file: string;
+    status: OwnerStatus;
+    staleMs: number;
+    diagnostics: string[];
+    owner?: RuntimeOwner;
+    ageMs?: number;
+    reason?: string;
+}
+export interface StoreHealthIssue {
+    kind: "run" | "goal";
+    id: string;
+    file: string;
+    line?: number;
+    reason: string;
+    retainedEventCount?: number;
+    corruptLineCount?: number;
+    partialTailDetected?: boolean;
+    lastGoodEventId?: number;
+    lastGoodSequence?: number;
+    repairRecommendation?: "none" | "truncate_partial_tail" | "isolate_corrupt_line" | "manual_review";
+    redactedTailPreview?: string;
+}
+export interface StoreHealthWarning {
+    kind: "run" | "goal";
+    id: string;
+    code: string;
+    message: string;
+    file: string;
+}
+export interface StoreHealthSummary {
+    total: number;
+    byCode: Record<string, number>;
+}
+export interface StoreActiveRecord {
+    kind: "run" | "goal";
+    id: string;
+    status: string;
+    file: string;
+    ownerStatus: OwnerStatus;
+    owner?: RuntimeOwner;
+    ownerAgeMs?: number;
+    reason?: string;
+}
+export interface StoreHealth {
+    schemaVersion: "agent-runtime.storeHealth.v1";
+    ok: boolean;
+    storageDir?: string;
+    checkedAt: number;
+    lock: StorageLockInspection;
+    totals: {
+        runs: number;
+        goals: number;
+        corruptEventLogLines: number;
+        partialEventLogTails: number;
+        activeRecords: number;
+    };
+    corruptManifests: StoreHealthIssue[];
+    corruptEventLogs: StoreHealthIssue[];
+    partialTails: StoreHealthIssue[];
+    activeRecords: StoreActiveRecord[];
+    activeInterrupted: StoreHealthIssue[];
+    warnings: StoreHealthWarning[];
+    storageDiagnostics: RuntimeDiagnostic[];
+    diagnostics: StoreHealthSummary;
+}
+export interface StoreRepairAction {
+    kind: "run" | "goal";
+    id: string;
+    file: string;
+    action: "truncate_partial_tail" | "isolate_corrupt_line" | "manual_review";
+    dryRun: boolean;
+    applied: boolean;
+    backupPath: string | null;
+    line?: number;
+    retainedEventCount: number;
+    removedLineCount: number;
+    truncatedBytes: number;
+    lastGoodEventId?: number;
+    lastGoodSequence?: number;
+    reason: string;
+    redactedTailPreview?: string;
+    diagnostics: RuntimeDiagnostic[];
+}
+export interface StoreRepairReport {
+    schemaVersion: "agent-runtime.storeRepair.v1";
+    storageDir: string;
+    checkedAt: number;
+    dryRun: boolean;
+    applied: boolean;
+    ok: boolean;
+    blockedReason?: string;
+    actions: StoreRepairAction[];
+    diagnostics: StoreHealthSummary;
+}
+export type ExportDiagnosticsRequest = {
+    kind: "run";
+    runId: string;
+    storageDir?: string;
+} | {
+    kind: "goal";
+    goalId: string;
+    storageDir?: string;
+};
+export interface DiagnosticsBundle {
+    schemaVersion: "agent-runtime.diagnostics.v1";
+    exportedAt: number;
+    storageDir?: string;
+    subject: {
+        kind: "run" | "goal";
+        id: string;
+    };
+    manifest: unknown | null;
+    events: {
+        total: number;
+        retained: number;
+        firstEventId?: number;
+        lastEventId?: number;
+        terminalEvent: boolean;
+        eventTypes: Record<string, number>;
+        corrupt?: StoreHealthIssue;
+        partialTail?: StoreHealthIssue;
+    };
+    diagnostics: RuntimeDiagnostic[];
+    storageDiagnostics: RuntimeDiagnostic[];
+    consistencyWarnings: StoreHealthWarning[];
+    attemptEvidence?: unknown[];
+    supervisorSummary: Record<string, unknown>;
+    adapterSummary: Record<string, unknown>;
+}

package/dist/public-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=public-types.js.map

package/dist/public-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-types.js","sourceRoot":"","sources":["../src/public-types.ts"],"names":[],"mappings":""}

package/dist/runs/process-runner.d.ts

@@ -0,0 +1,35 @@
+import { type ChildProcessWithoutNullStreams } from "node:child_process";
+import { EventEmitter } from "node:events";
+export interface SpawnRequest {
+    command: string;
+    args: string[];
+    cwd: string;
+    env: NodeJS.ProcessEnv;
+    stdinData?: string;
+}
+export interface ProcessClose {
+    exitCode: number | null;
+    signal: NodeJS.Signals | null;
+    error?: NodeJS.ErrnoException;
+    stdinError?: Error;
+}
+export interface KillReport {
+    softSignal: NodeJS.Signals;
+    hardSignal?: NodeJS.Signals;
+    escalated: boolean;
+    errors: string[];
+}
+export declare class RunningProcess extends EventEmitter {
+    private readonly child;
+    private cancelPromise?;
+    constructor(child: ChildProcessWithoutNullStreams);
+    get pid(): number | undefined;
+    cancel(graceMs?: number): Promise<KillReport>;
+    private cancelOnce;
+    private kill;
+}
+export declare function spawnProcess(request: SpawnRequest): {
+    child: ChildProcessWithoutNullStreams;
+    running: RunningProcess;
+    close: Promise<ProcessClose>;
+};

package/dist/runs/process-runner.js

@@ -0,0 +1,97 @@
+import { spawn } from "node:child_process";
+import { EventEmitter } from "node:events";
+export class RunningProcess extends EventEmitter {
+    child;
+    cancelPromise;
+    constructor(child) {
+        super();
+        this.child = child;
+    }
+    get pid() {
+        return this.child.pid;
+    }
+    async cancel(graceMs = 750) {
+        if (this.cancelPromise)
+            return this.cancelPromise;
+        this.cancelPromise = this.cancelOnce(graceMs);
+        return this.cancelPromise;
+    }
+    async cancelOnce(graceMs) {
+        const report = { softSignal: "SIGTERM", escalated: false, errors: [] };
+        if (this.child.exitCode !== null || this.child.signalCode !== null)
+            return report;
+        this.kill("SIGTERM", report);
+        await new Promise((resolve) => {
+            const timer = setTimeout(resolve, graceMs);
+            timer.unref?.();
+            this.child.once("close", () => {
+                clearTimeout(timer);
+                resolve();
+            });
+        });
+        if (this.child.exitCode === null && this.child.signalCode === null) {
+            report.escalated = true;
+            report.hardSignal = "SIGKILL";
+            this.kill("SIGKILL", report);
+        }
+        return report;
+    }
+    kill(signal, report) {
+        try {
+            if (process.platform !== "win32" && typeof this.child.pid === "number") {
+                process.kill(-this.child.pid, signal);
+                return;
+            }
+        }
+        catch (error) {
+            report.errors.push(errorMessage(error));
+            // Fall through to direct child signal.
+        }
+        try {
+            this.child.kill(signal);
+        }
+        catch (error) {
+            report.errors.push(errorMessage(error));
+            // best effort
+        }
+    }
+}
+export function spawnProcess(request) {
+    const child = spawn(request.command, request.args, {
+        cwd: request.cwd,
+        env: request.env,
+        detached: process.platform !== "win32",
+        stdio: ["pipe", "pipe", "pipe"],
+    });
+    let stdinError;
+    child.stdin.once("error", (error) => {
+        stdinError = error;
+    });
+    try {
+        if (request.stdinData !== undefined) {
+            child.stdin.end(request.stdinData);
+        }
+        else {
+            child.stdin.end();
+        }
+    }
+    catch (error) {
+        stdinError = error instanceof Error ? error : new Error(String(error));
+    }
+    const close = new Promise((resolve) => {
+        let settled = false;
+        const settle = (value) => {
+            if (settled)
+                return;
+            settled = true;
+            resolve({ ...value, stdinError });
+        };
+        child.once("error", (error) => settle({ exitCode: null, signal: null, error }));
+        child.once("close", (exitCode, signal) => settle({ exitCode, signal, stdinError }));
+    });
+    return { child, running: new RunningProcess(child), close };
+}
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=process-runner.js.map

package/dist/runs/process-runner.js.map

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

package/dist/runs/prompt-transport.d.ts

@@ -0,0 +1,10 @@
+import type { PromptTransport } from "../adapters/adapter-types.js";
+import type { RunRequest } from "./run-types.js";
+export interface PreparedPrompt {
+    prompt: string;
+    promptFilePath?: string;
+    stdinData?: string;
+    cleanup(): Promise<void>;
+}
+export declare function composePrompt(request: Pick<RunRequest, "systemPrompt" | "contextBlocks" | "prompt">): string;
+export declare function preparePromptTransport(transport: PromptTransport, prompt: string): Promise<PreparedPrompt>;

package/dist/runs/prompt-transport.js

@@ -0,0 +1,43 @@
+import { mkdtemp, writeFile } from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+export function composePrompt(request) {
+    const chunks = [];
+    if (request.systemPrompt?.trim())
+        chunks.push(request.systemPrompt.trim());
+    for (const block of request.contextBlocks ?? []) {
+        chunks.push(`## ${block.title}\n\n${block.body}`);
+    }
+    chunks.push(request.prompt);
+    return chunks.join("\n\n");
+}
+export async function preparePromptTransport(transport, prompt) {
+    if (transport.kind === "stdin") {
+        return {
+            prompt,
+            stdinData: transport.inputFormat === "jsonl" ? `${JSON.stringify({ type: "user", message: { role: "user", content: [{ type: "text", text: prompt }] } })}\n` : prompt,
+            cleanup: async () => { },
+        };
+    }
+    if (transport.kind === "file") {
+        const dir = await mkdtemp(path.join(os.tmpdir(), "agent-runtime-prompt-"));
+        const promptFilePath = path.join(dir, "prompt.txt");
+        await writeFile(promptFilePath, prompt, "utf8");
+        return {
+            prompt,
+            promptFilePath,
+            cleanup: async () => {
+                const { rm } = await import("node:fs/promises");
+                await rm(dir, { recursive: true, force: true });
+            },
+        };
+    }
+    const bytes = Buffer.byteLength(prompt, "utf8");
+    if (bytes > transport.maxBytes) {
+        const error = new Error(`Prompt is ${bytes} bytes; argv transport limit is ${transport.maxBytes}`);
+        error.name = "AGENT_PROMPT_TOO_LARGE";
+        throw error;
+    }
+    return { prompt, cleanup: async () => { } };
+}
+//# sourceMappingURL=prompt-transport.js.map

package/dist/runs/prompt-transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-transport.js","sourceRoot":"","sources":["../../src/runs/prompt-transport.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAW7B,MAAM,UAAU,aAAa,CAAC,OAAsE;IAClG,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,OAAO,CAAC,YAAY,EAAE,IAAI,EAAE;QAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,CAAC;IAC3E,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,aAAa,IAAI,EAAE,EAAE,CAAC;QAChD,MAAM,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,KAAK,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IACpD,CAAC;IACD,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5B,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,SAA0B,EAAE,MAAc;IACrF,IAAI,SAAS,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC/B,OAAO;YACL,MAAM;YACN,SAAS,EAAE,SAAS,CAAC,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM;YACrK,OAAO,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;SACxB,CAAC;IACJ,CAAC;IACD,IAAI,SAAS,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC9B,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,uBAAuB,CAAC,CAAC,CAAC;QAC3E,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;QACpD,MAAM,SAAS,CAAC,cAAc,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QAChD,OAAO;YACL,MAAM;YACN,cAAc;YACd,OAAO,EAAE,KAAK,IAAI,EAAE;gBAClB,MAAM,EAAE,EAAE,EAAE,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAC;gBAChD,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YAClD,CAAC;SACF,CAAC;IACJ,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChD,IAAI,KAAK,GAAG,SAAS,CAAC,QAAQ,EAAE,CAAC;QAC/B,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,aAAa,KAAK,mCAAmC,SAAS,CAAC,QAAQ,EAAE,CAAC,CAAC;QACnG,KAAK,CAAC,IAAI,GAAG,wBAAwB,CAAC;QACtC,MAAM,KAAK,CAAC;IACd,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC,EAAE,CAAC;AAC7C,CAAC"}

package/dist/runs/run-result.d.ts

@@ -0,0 +1,9 @@
+export type RunResult = "success" | "failed" | "cancelled";
+export type RunStatus = "queued" | "running" | "succeeded" | "failed" | "canceled";
+export declare function runResultFromStatus(status: RunStatus | string | undefined): RunResult;
+export declare function deriveRunErrorCode(status: {
+    status: RunStatus | string;
+    errorCode?: string | null;
+    exitCode?: number | null;
+    signal?: string | null;
+}): string | undefined;

package/dist/runs/run-result.js

@@ -0,0 +1,22 @@
+export function runResultFromStatus(status) {
+    if (status === "succeeded")
+        return "success";
+    if (status === "canceled")
+        return "cancelled";
+    return "failed";
+}
+export function deriveRunErrorCode(status) {
+    const result = runResultFromStatus(status.status);
+    if (result === "success")
+        return undefined;
+    if (result === "cancelled")
+        return status.errorCode ?? undefined;
+    if (status.errorCode)
+        return status.errorCode;
+    if (status.signal)
+        return `AGENT_SIGNAL_${status.signal}`;
+    if (typeof status.exitCode === "number" && status.exitCode !== 0)
+        return `AGENT_EXIT_${status.exitCode}`;
+    return "AGENT_TERMINATED_UNKNOWN";
+}
+//# sourceMappingURL=run-result.js.map

package/dist/runs/run-result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-result.js","sourceRoot":"","sources":["../../src/runs/run-result.ts"],"names":[],"mappings":"AAIA,MAAM,UAAU,mBAAmB,CAAC,MAAsC;IACxE,IAAI,MAAM,KAAK,WAAW;QAAE,OAAO,SAAS,CAAC;IAC7C,IAAI,MAAM,KAAK,UAAU;QAAE,OAAO,WAAW,CAAC;IAC9C,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,MAKlC;IACC,MAAM,MAAM,GAAG,mBAAmB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAClD,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC3C,IAAI,MAAM,KAAK,WAAW;QAAE,OAAO,MAAM,CAAC,SAAS,IAAI,SAAS,CAAC;IACjE,IAAI,MAAM,CAAC,SAAS;QAAE,OAAO,MAAM,CAAC,SAAS,CAAC;IAC9C,IAAI,MAAM,CAAC,MAAM;QAAE,OAAO,gBAAgB,MAAM,CAAC,MAAM,EAAE,CAAC;IAC1D,IAAI,OAAO,MAAM,CAAC,QAAQ,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,KAAK,CAAC;QAAE,OAAO,cAAc,MAAM,CAAC,QAAQ,EAAE,CAAC;IACzG,OAAO,0BAA0B,CAAC;AACpC,CAAC"}

package/dist/runs/run-scheduler.d.ts

@@ -0,0 +1,25 @@
+import type { AdapterRegistry } from "../adapters/registry.js";
+import { RunStore } from "./run-store.js";
+import type { RunHandle, RunRecord, RunRequest } from "./run-types.js";
+export declare class RunScheduler {
+    private readonly registry;
+    private readonly store;
+    private readonly options;
+    private readonly active;
+    constructor(registry: AdapterRegistry, store: RunStore, options?: {
+        env?: NodeJS.ProcessEnv;
+        searchPath?: string[];
+    });
+    startRun(request: RunRequest): Promise<RunHandle>;
+    cancelRun(runId: string, reason?: string): Promise<void>;
+    getRun(runId: string): Promise<RunRecord | null>;
+    shutdown(reason?: string, graceMs?: number): Promise<void>;
+    private execute;
+    private armTimeout;
+    private failBeforeSpawn;
+    private cleanupActive;
+    private emit;
+    private emitError;
+    private addTerminalDiagnostic;
+    private finish;
+}