agent-cli-runtime 0.1.0-alpha.0

package/dist/runs/run-store.js

@@ -0,0 +1,297 @@
+import { AsyncQueue } from "../core/async-queue.js";
+import { createId } from "../core/ids.js";
+import { diagnostic } from "../core/diagnostics.js";
+import { inspectOwner } from "../storage/storage-lease.js";
+export class RunStore {
+    maxEvents;
+    storage;
+    options;
+    runs = new Map();
+    constructor(maxEvents = 2_000, storage, options = {}) {
+        this.maxEvents = maxEvents;
+        this.storage = storage;
+        this.options = options;
+        this.loadFromStorage();
+    }
+    create(input) {
+        const now = Date.now();
+        const run = {
+            id: createId("run"),
+            agentId: input.agentId,
+            cwd: input.cwd,
+            status: "queued",
+            createdAt: now,
+            updatedAt: now,
+            exitCode: null,
+            signal: null,
+            error: null,
+            errorCode: null,
+            diagnostics: [],
+            owner: this.currentOwner(),
+            events: [],
+            subscribers: new Set(),
+            nextEventId: 1,
+        };
+        this.runs.set(run.id, run);
+        this.tryPersistManifest(run);
+        return this.publicRecord(run);
+    }
+    get(runId) {
+        const run = this.runs.get(runId);
+        return run ? this.publicRecord(run) : null;
+    }
+    list(options = {}) {
+        const runs = [...this.runs.values()].map((run) => this.publicRecord(run));
+        if (!options.status)
+            return runs;
+        if (options.status === "active")
+            return runs.filter((run) => !isTerminal(run.status));
+        return runs.filter((run) => run.status === options.status);
+    }
+    setStatus(runId, status, init = {}) {
+        const run = this.mustGet(runId);
+        if (run.persistenceFailed)
+            return;
+        run.status = status;
+        run.updatedAt = Date.now();
+        Object.assign(run, init);
+        this.tryPersistManifest(run);
+    }
+    addDiagnostic(runId, diagnostic) {
+        const run = this.mustGet(runId);
+        run.diagnostics.push(diagnostic);
+        run.updatedAt = Date.now();
+        this.tryPersistManifest(run);
+    }
+    append(runId, event) {
+        const run = this.mustGet(runId);
+        if (run.persistenceFailed)
+            return runReplayRecord(run, event);
+        const record = runReplayRecord(run, event);
+        run.nextEventId += 1;
+        run.events.push(record);
+        if (run.events.length > this.maxEvents)
+            run.events.splice(0, run.events.length - this.maxEvents);
+        run.updatedAt = Date.now();
+        if (!this.tryPersistEvent(run, record) || !this.tryPersistManifest(run)) {
+            for (const subscriber of run.subscribers)
+                subscriber.push(event);
+            this.markPersistenceFailed(run);
+            return record;
+        }
+        for (const subscriber of run.subscribers)
+            subscriber.push(event);
+        if (event.type === "run_finished") {
+            for (const subscriber of run.subscribers)
+                subscriber.end();
+            run.subscribers.clear();
+        }
+        return record;
+    }
+    replay(runId, afterEventId = 0) {
+        const run = this.mustGet(runId);
+        return run.events
+            .filter((event) => event.id > afterEventId)
+            .sort(compareReplayEvents);
+    }
+    events(runId, afterEventId = 0) {
+        const run = this.mustGet(runId);
+        const queue = new AsyncQueue();
+        for (const record of run.events) {
+            if (record.id > afterEventId)
+                queue.push(record.event);
+        }
+        if (isTerminal(run.status)) {
+            queue.end();
+            return queue;
+        }
+        run.subscribers.add(queue);
+        return queue;
+    }
+    hasPersistenceFailed(runId) {
+        return Boolean(this.runs.get(runId)?.persistenceFailed);
+    }
+    heartbeatActive(owner) {
+        for (const run of this.runs.values()) {
+            if (isTerminal(run.status) || run.persistenceFailed)
+                continue;
+            run.owner = { ...owner };
+            run.updatedAt = Date.now();
+            this.tryPersistManifest(run);
+        }
+    }
+    mustGet(runId) {
+        const run = this.runs.get(runId);
+        if (!run)
+            throw new Error(`Unknown run: ${runId}`);
+        return run;
+    }
+    publicRecord(run) {
+        const { events, subscribers, nextEventId, persistenceFailed, ...publicRun } = run;
+        void events;
+        void subscribers;
+        void nextEventId;
+        void persistenceFailed;
+        return { ...publicRun, diagnostics: [...publicRun.diagnostics] };
+    }
+    loadFromStorage() {
+        if (!this.storage)
+            return;
+        for (const snapshot of this.storage.listRuns()) {
+            const run = {
+                ...snapshot.manifest,
+                diagnostics: [...snapshot.manifest.diagnostics],
+                events: snapshot.events,
+                subscribers: new Set(),
+                nextEventId: nextEventId(snapshot.events),
+            };
+            if (snapshot.manifestError && !run.diagnostics.some((item) => item.code === "AGENT_STORE_RECORD_CORRUPT")) {
+                run.diagnostics.push(diagnostic("AGENT_STORE_RECORD_CORRUPT", snapshot.manifestError.message));
+            }
+            if (snapshot.eventsError) {
+                run.diagnostics.push(diagnostic("AGENT_EVENT_LOG_CORRUPT", snapshot.eventsError.message));
+                run.events.push({
+                    id: run.nextEventId++,
+                    sequence: run.nextEventId - 1,
+                    runId: run.id,
+                    timestamp: Date.now(),
+                    event: {
+                        type: "error",
+                        code: "AGENT_EVENT_LOG_CORRUPT",
+                        message: snapshot.eventsError.message,
+                        retryable: false,
+                        timestamp: Date.now(),
+                    },
+                });
+            }
+            this.runs.set(run.id, run);
+            if (!isTerminal(run.status) && this.canRecoverActive(run.owner))
+                this.markInterrupted(run);
+            else if (!snapshot.manifestError)
+                this.tryPersistManifest(run);
+        }
+    }
+    canRecoverActive(owner) {
+        const inspected = inspectOwner(owner, { staleMs: this.options.staleMs });
+        return inspected.status === "missing" || inspected.status === "stale" || inspected.status === "closed" || inspected.status === "invalid";
+    }
+    markInterrupted(run) {
+        run.status = "failed";
+        run.updatedAt = Date.now();
+        run.exitCode = null;
+        run.signal = "RUNTIME_RESTART";
+        run.error = "Run was active when storage was loaded and cannot be resumed.";
+        run.errorCode = "AGENT_RUNTIME_INTERRUPTED";
+        run.owner = this.currentOwner();
+        run.diagnostics.push(diagnostic("AGENT_RUNTIME_INTERRUPTED", run.error, { signal: run.signal }));
+        this.tryPersistManifest(run);
+        this.append(run.id, {
+            type: "error",
+            code: "AGENT_RUNTIME_INTERRUPTED",
+            message: run.error,
+            retryable: false,
+            timestamp: Date.now(),
+        });
+        this.append(run.id, {
+            type: "run_finished",
+            result: "failed",
+            exitCode: null,
+            signal: run.signal,
+            timestamp: Date.now(),
+        });
+    }
+    markPersistenceFailed(run, error, options = {}) {
+        if (run.persistenceFailed)
+            return;
+        const message = `Run event persistence failed: ${errorMessage(error)}`;
+        run.status = "failed";
+        run.updatedAt = Date.now();
+        run.exitCode = null;
+        run.signal = null;
+        run.error = message;
+        run.errorCode = "AGENT_EVENT_PERSIST_FAILED";
+        run.diagnostics.push(diagnostic("AGENT_EVENT_PERSIST_FAILED", message));
+        const errorEvent = {
+            id: run.nextEventId++,
+            sequence: run.nextEventId - 1,
+            runId: run.id,
+            timestamp: Date.now(),
+            event: { type: "error", code: "AGENT_EVENT_PERSIST_FAILED", message, retryable: false, timestamp: Date.now() },
+        };
+        const finishedEvent = {
+            id: run.nextEventId++,
+            sequence: run.nextEventId - 1,
+            runId: run.id,
+            timestamp: Date.now(),
+            event: { type: "run_finished", result: "failed", exitCode: null, signal: null, timestamp: Date.now() },
+        };
+        run.events.push(errorEvent, finishedEvent);
+        for (const subscriber of run.subscribers) {
+            subscriber.push(errorEvent.event);
+            subscriber.push(finishedEvent.event);
+            subscriber.end();
+        }
+        run.subscribers.clear();
+        if (options.persistManifest && this.storage) {
+            try {
+                this.storage.writeRunManifest(this.publicRecord(run));
+            }
+            catch {
+                // The diagnostic remains visible to current callers even if the failed manifest cannot be persisted.
+            }
+        }
+        run.persistenceFailed = true;
+    }
+    tryPersistManifest(run) {
+        if (!this.storage || run.persistenceFailed)
+            return true;
+        try {
+            if (!isTerminal(run.status))
+                run.owner = this.currentOwner();
+            this.storage.writeRunManifest(this.publicRecord(run));
+            return true;
+        }
+        catch (error) {
+            this.markPersistenceFailed(run, error);
+            return false;
+        }
+    }
+    tryPersistEvent(run, record) {
+        if (!this.storage || run.persistenceFailed)
+            return true;
+        try {
+            this.storage.appendRunEvent(run.id, record);
+            return true;
+        }
+        catch (error) {
+            this.markPersistenceFailed(run, error, { persistManifest: true });
+            return false;
+        }
+    }
+    currentOwner() {
+        const owner = this.options.owner?.();
+        return owner ? { ...owner } : undefined;
+    }
+}
+export function isTerminal(status) {
+    return status === "succeeded" || status === "failed" || status === "canceled";
+}
+function nextEventId(events) {
+    return events.reduce((max, event) => Math.max(max, event.id), 0) + 1;
+}
+function runReplayRecord(run, event) {
+    return {
+        id: run.nextEventId,
+        sequence: run.nextEventId,
+        runId: run.id,
+        event,
+        timestamp: Date.now(),
+    };
+}
+function compareReplayEvents(left, right) {
+    return (left.sequence - right.sequence) || (left.id - right.id) || (left.timestamp - right.timestamp);
+}
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=run-store.js.map

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

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

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

@@ -0,0 +1,59 @@
+import type { AgentEvent } from "../core/events.js";
+import type { RuntimeDiagnostic } from "../core/diagnostics.js";
+import type { AgentAdapterDef, AgentId, PermissionPolicy } from "../adapters/adapter-types.js";
+import type { RunStatus } from "./run-result.js";
+import type { RuntimeEnvironment, RuntimeOwner } from "../public-types.js";
+export interface RuntimeContextBlock {
+    title: string;
+    body: string;
+    priority?: "required" | "optional";
+}
+export interface RuntimeSessionRef {
+    id?: string;
+    resumeId?: string;
+}
+export interface RuntimeOptions {
+    adapters?: AgentAdapterDef[];
+    env?: RuntimeEnvironment;
+    searchPath?: string[];
+    storageDir?: string;
+    storage?: {
+        durability?: "relaxed" | "fsync";
+    };
+    maxConcurrentTasks?: number;
+}
+export interface RunRequest {
+    agentId: AgentId;
+    cwd: string;
+    prompt: string;
+    systemPrompt?: string;
+    contextBlocks?: RuntimeContextBlock[];
+    model?: string;
+    reasoning?: string;
+    env?: Record<string, string>;
+    extraAllowedDirs?: string[];
+    permissionPolicy?: PermissionPolicy;
+    timeoutMs?: number;
+    inactivityTimeoutMs?: number;
+    signal?: AbortSignal;
+    session?: RuntimeSessionRef;
+}
+export interface RunHandle {
+    runId: string;
+    events: AsyncIterable<AgentEvent>;
+    cancel(reason?: string): Promise<void>;
+}
+export interface RunRecord {
+    id: string;
+    agentId: AgentId;
+    cwd: string;
+    status: RunStatus;
+    createdAt: number;
+    updatedAt: number;
+    exitCode?: number | null;
+    signal?: string | null;
+    error?: string | null;
+    errorCode?: string | null;
+    diagnostics: RuntimeDiagnostic[];
+    owner?: RuntimeOwner;
+}

package/dist/runs/run-types.js

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

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

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

package/dist/smoke/parser-samples.d.ts

@@ -0,0 +1,17 @@
+import type { AgentEventInput } from "../core/events.js";
+export interface ParserFixtureCase {
+    agentId: "codex" | "claude" | "opencode";
+    name: string;
+    chunks: string[];
+    expectedTypes: AgentEventInput["type"][];
+}
+export interface ParserFixtureResult {
+    agentId: string;
+    name: string;
+    ok: boolean;
+    eventTypes: string[];
+    expectedTypes: string[];
+    eventCount: number;
+}
+export declare const parserFixtureCases: ParserFixtureCase[];
+export declare function runParserFixtureCases(agentId?: string): ParserFixtureResult[];

package/dist/smoke/parser-samples.js

@@ -0,0 +1,186 @@
+import { ClaudeStreamJsonParser } from "../parsers/claude-stream-json.js";
+import { CodexJsonParser } from "../parsers/codex-json.js";
+import { OpenCodeJsonParser } from "../parsers/opencode-json.js";
+export const parserFixtureCases = [
+    {
+        agentId: "codex",
+        name: "normal output",
+        chunks: ['{"type":"thread.started"}\n{"type":"item.completed","item":{"type":"agent_message","text":"ok"}}\n'],
+        expectedTypes: ["status", "text_delta"],
+    },
+    {
+        agentId: "codex",
+        name: "structured error",
+        chunks: ['{"type":"error","message":"boom"}\n'],
+        expectedTypes: ["error"],
+    },
+    {
+        agentId: "codex",
+        name: "usage",
+        chunks: ['{"type":"turn.completed","usage":{"input_tokens":1,"output_tokens":2,"reasoning_tokens":3}}\n'],
+        expectedTypes: ["usage"],
+    },
+    {
+        agentId: "codex",
+        name: "tool and file event",
+        chunks: [
+            '{"type":"exec_command.begin","call_id":"cmd_1","command":"pwd"}\n',
+            '{"type":"exec_command.end","call_id":"cmd_1","stdout":"/tmp","exit_code":0}\n',
+            '{"type":"item.completed","item":{"type":"file_event","path":"README.md","action":"updated"}}\n',
+        ],
+        expectedTypes: ["tool_call", "tool_result", "file_event"],
+    },
+    {
+        agentId: "codex",
+        name: "partial line",
+        chunks: ['{"type":"item.completed","item":{"type":"agent_message","text":"hel', 'lo"}}\n'],
+        expectedTypes: ["text_delta"],
+    },
+    {
+        agentId: "codex",
+        name: "warning log noise",
+        chunks: ['WARN reconnecting without json\n{"level":"warn","message":"ignore me"}\n'],
+        expectedTypes: [],
+    },
+    {
+        agentId: "codex",
+        name: "corrupt line noise",
+        chunks: ['{"type":"item.completed","item":{"type":"agent_message","text":"unterminated"\n'],
+        expectedTypes: [],
+    },
+    {
+        agentId: "codex",
+        name: "unknown event",
+        chunks: ['{"type":"new.future.event","payload":true}\n'],
+        expectedTypes: [],
+    },
+    {
+        agentId: "claude",
+        name: "normal output",
+        chunks: ['{"type":"system"}\n{"type":"assistant","message":{"content":[{"type":"text","text":"ok"}]}}\n'],
+        expectedTypes: ["status", "text_delta"],
+    },
+    {
+        agentId: "claude",
+        name: "structured error",
+        chunks: ['{"type":"error","error":{"message":"auth required"}}\n'],
+        expectedTypes: ["error"],
+    },
+    {
+        agentId: "claude",
+        name: "usage",
+        chunks: ['{"type":"result","usage":{"input_tokens":1,"output_tokens":2,"cache_read_input_tokens":3}}\n'],
+        expectedTypes: ["usage"],
+    },
+    {
+        agentId: "claude",
+        name: "tool and file event",
+        chunks: [
+            '{"type":"assistant","message":{"content":[{"type":"tool_use","id":"tool_1","name":"Read","input":{"file_path":"README.md"}},{"type":"tool_result","tool_use_id":"tool_1","content":"ok"},{"type":"file_event","path":"README.md","action":"updated"}]}}\n',
+        ],
+        expectedTypes: ["tool_call", "tool_result", "file_event"],
+    },
+    {
+        agentId: "claude",
+        name: "partial line",
+        chunks: ['{"type":"stream_event","event":{"type":"content_block_delta","delta":{"type":"text_delta","text":"hel', 'lo"}}}\n'],
+        expectedTypes: ["text_delta"],
+    },
+    {
+        agentId: "claude",
+        name: "warning log noise",
+        chunks: ['Warning: using cached settings\n{"level":"warn","message":"ignore me"}\n'],
+        expectedTypes: [],
+    },
+    {
+        agentId: "claude",
+        name: "corrupt line noise",
+        chunks: ['{"type":"assistant","message":{"content":[{"type":"text","text":"unterminated"}]}\n'],
+        expectedTypes: [],
+    },
+    {
+        agentId: "claude",
+        name: "unknown event",
+        chunks: ['{"type":"future","event":{"type":"new"}}\n'],
+        expectedTypes: [],
+    },
+    {
+        agentId: "opencode",
+        name: "normal output",
+        chunks: ['{"type":"step_start"}\n{"type":"text","part":{"text":"ok"}}\n'],
+        expectedTypes: ["status", "text_delta"],
+    },
+    {
+        agentId: "opencode",
+        name: "structured error",
+        chunks: ['{"type":"error","error":"bad request"}\n'],
+        expectedTypes: ["error"],
+    },
+    {
+        agentId: "opencode",
+        name: "usage",
+        chunks: ['{"type":"step_finish","part":{"tokens":{"input":1,"output":2,"reasoning":3},"cost":0.01}}\n'],
+        expectedTypes: ["usage"],
+    },
+    {
+        agentId: "opencode",
+        name: "tool and file event",
+        chunks: [
+            '{"type":"tool_use","part":{"callID":"call_1","tool":"bash","state":{"input":"{\\"cmd\\":\\"pwd\\"}","status":"completed","output":"ok"}}}\n',
+            '{"type":"file","part":{"path":"README.md","action":"updated"}}\n',
+        ],
+        expectedTypes: ["tool_call", "tool_result", "file_event"],
+    },
+    {
+        agentId: "opencode",
+        name: "partial line",
+        chunks: ['{"type":"text","part":{"text":"hel', 'lo"}}\n'],
+        expectedTypes: ["text_delta"],
+    },
+    {
+        agentId: "opencode",
+        name: "warning log noise",
+        chunks: ['INFO starting opencode\n{"level":"warn","message":"ignore me"}\n'],
+        expectedTypes: [],
+    },
+    {
+        agentId: "opencode",
+        name: "corrupt line noise",
+        chunks: ['{"type":"text","part":{"text":"unterminated"}\n'],
+        expectedTypes: [],
+    },
+    {
+        agentId: "opencode",
+        name: "unknown event",
+        chunks: ['{"type":"future","part":{}}\n'],
+        expectedTypes: [],
+    },
+];
+export function runParserFixtureCases(agentId) {
+    return parserFixtureCases
+        .filter((fixture) => !agentId || agentId === "all" || fixture.agentId === agentId)
+        .map((fixture) => {
+        const parser = createParser(fixture.agentId);
+        const events = fixture.chunks.flatMap((chunk) => parser.parse(chunk)).concat(parser.flush());
+        const eventTypes = events.map((event) => event.type);
+        return {
+            agentId: fixture.agentId,
+            name: fixture.name,
+            ok: arraysEqual(eventTypes, fixture.expectedTypes),
+            eventTypes,
+            expectedTypes: fixture.expectedTypes,
+            eventCount: events.length,
+        };
+    });
+}
+function createParser(agentId) {
+    if (agentId === "codex")
+        return new CodexJsonParser();
+    if (agentId === "claude")
+        return new ClaudeStreamJsonParser();
+    return new OpenCodeJsonParser();
+}
+function arraysEqual(left, right) {
+    return left.length === right.length && left.every((value, index) => value === right[index]);
+}
+//# sourceMappingURL=parser-samples.js.map

package/dist/smoke/parser-samples.js.map

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

package/dist/storage/file-storage.d.ts

@@ -0,0 +1,35 @@
+import type { AgentEvent, ReplayEvent, SchedulerEvent } from "../core/events.js";
+import type { GoalRecord } from "../goals/goal-types.js";
+import type { RunRecord } from "../runs/run-types.js";
+import type { FileStorage, StorageDurability, StorageFaultHooks, StorageSyncHooks, StoredGoalSnapshot, StoredRunSnapshot } from "./storage-types.js";
+export interface JsonFileStorageOptions {
+    durability?: StorageDurability;
+    sync?: StorageSyncHooks;
+    faults?: StorageFaultHooks;
+    canWrite?: () => boolean;
+}
+export declare class JsonFileStorage implements FileStorage {
+    private readonly rootDir;
+    private readonly options;
+    private readonly diagnostics;
+    private readonly durability;
+    constructor(rootDir: string, options?: JsonFileStorageOptions);
+    listRuns(): StoredRunSnapshot[];
+    writeRunManifest(record: RunRecord): void;
+    appendRunEvent(runId: string, event: ReplayEvent<AgentEvent>): void;
+    listGoals(): StoredGoalSnapshot[];
+    writeGoalManifest(record: GoalRecord): void;
+    appendGoalEvent(goalId: string, event: ReplayEvent<SchedulerEvent>): void;
+    getDurabilityDiagnostics(): string[];
+    private get runsDir();
+    private get goalsDir();
+    private ensureRunDir;
+    private ensureGoalDir;
+    private runManifestPath;
+    private runEventsPath;
+    private goalManifestPath;
+    private goalEventsPath;
+    private writeOptions;
+    private recordDurabilityDiagnostic;
+    private assertCanWrite;
+}