frely-cli 0.7.1 → 0.8.3

package/dist/agent/protocol.js

@@ -0,0 +1,195 @@
+/**
+ * frely.agent-host.v1 — wire contract between the CLI (supervisor) and the
+ * Pi Node agent host. See docs/agent-host.md for the public description.
+ */
+import { randomBytes } from "node:crypto";
+export const AGENT_HOST_PROTOCOL = "frely.agent-host.v1";
+export const AGENT_HOST_PROTOCOL_VERSION = 1;
+export const AGENT_HOST_MAX_FRAME_BYTES = 1024 * 1024;
+export const AGENT_HOST_CONNECTION_KEY_ENV = "FRELY_AGENT_HOST_KEY";
+export class AgentHostProtocolError extends Error {
+    code;
+    constructor(code) {
+        super(code);
+        this.code = code;
+        this.name = "AgentHostProtocolError";
+    }
+}
+export function newConnectionKey() {
+    return randomBytes(32).toString("base64url");
+}
+export function isValidTaskId(id) {
+    return /^at_[a-z0-9]{24}$/u.test(id);
+}
+export function newTaskId() {
+    return `at_${randomBytes(12).toString("hex")}`;
+}
+/** Encode one NDJSON frame. */
+export function encodeAgentHostFrame(message) {
+    const line = JSON.stringify(message);
+    if (Buffer.byteLength(line) > AGENT_HOST_MAX_FRAME_BYTES)
+        throw new AgentHostProtocolError("frame_too_large");
+    return `${line}\n`;
+}
+/** Decode one NDJSON frame (without the trailing newline). */
+export function decodeAgentHostFrame(line) {
+    if (Buffer.byteLength(line) > AGENT_HOST_MAX_FRAME_BYTES)
+        throw new AgentHostProtocolError("frame_too_large");
+    let value;
+    try {
+        value = JSON.parse(Buffer.isBuffer(line) ? line.toString("utf8") : line);
+    }
+    catch {
+        throw new AgentHostProtocolError("frame_invalid");
+    }
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        throw new AgentHostProtocolError("frame_invalid");
+    const record = value;
+    if (record.jsonrpc !== "2.0")
+        throw new AgentHostProtocolError("frame_invalid");
+    if ("method" in record) {
+        if (typeof record.method !== "string" || record.method.length === 0)
+            throw new AgentHostProtocolError("frame_invalid");
+        if ("id" in record && record.id !== null && typeof record.id !== "number" && typeof record.id !== "string") {
+            throw new AgentHostProtocolError("frame_invalid");
+        }
+        if ("params" in record && record.params !== undefined && (typeof record.params !== "object" || record.params === null)) {
+            throw new AgentHostProtocolError("frame_invalid");
+        }
+        return value;
+    }
+    if (typeof record.id !== "number" && typeof record.id !== "string")
+        throw new AgentHostProtocolError("frame_invalid");
+    if (!("result" in record) && !("error" in record))
+        throw new AgentHostProtocolError("frame_invalid");
+    if ("error" in record && record.error !== undefined) {
+        const error = record.error;
+        if (!error || typeof error !== "object" || typeof error.code !== "number" || typeof error.message !== "string") {
+            throw new AgentHostProtocolError("frame_invalid");
+        }
+    }
+    return value;
+}
+/** Validate and normalize a `task.event` notification params object. */
+export function decodeTaskEvent(params) {
+    if (!params || typeof params !== "object")
+        throw new AgentHostProtocolError("frame_invalid");
+    const record = params;
+    if (typeof record.taskId !== "string" || !isValidTaskId(record.taskId))
+        throw new AgentHostProtocolError("frame_invalid");
+    const event = record.event;
+    if (!event || typeof event !== "object")
+        throw new AgentHostProtocolError("frame_invalid");
+    const item = event;
+    switch (item.type) {
+        case "status":
+            if (item.status !== "running" && item.status !== "waiting_input" && item.status !== "completed" && item.status !== "failed" && item.status !== "cancelled") {
+                throw new AgentHostProtocolError("frame_invalid");
+            }
+            if (item.detail !== undefined && typeof item.detail !== "string")
+                throw new AgentHostProtocolError("frame_invalid");
+            return { taskId: record.taskId, event: item };
+        case "message":
+            if (item.role !== "assistant" && item.role !== "user" && item.role !== "system")
+                throw new AgentHostProtocolError("frame_invalid");
+            if (typeof item.text !== "string" || item.text.length > 64 * 1024)
+                throw new AgentHostProtocolError("frame_invalid");
+            if (item.partial !== undefined && typeof item.partial !== "boolean")
+                throw new AgentHostProtocolError("frame_invalid");
+            return { taskId: record.taskId, event: item };
+        case "tool_call":
+            if (typeof item.tool !== "string" || typeof item.summary !== "string" || item.summary.length > 2048)
+                throw new AgentHostProtocolError("frame_invalid");
+            if (item.state !== "started" && item.state !== "finished" && item.state !== "failed")
+                throw new AgentHostProtocolError("frame_invalid");
+            return { taskId: record.taskId, event: item };
+        case "usage": {
+            for (const key of ["inputTokens", "outputTokens", "costUsd"]) {
+                const value = item[key];
+                if (typeof value !== "number" || !Number.isFinite(value) || value < 0)
+                    throw new AgentHostProtocolError("frame_invalid");
+            }
+            return { taskId: record.taskId, event: item };
+        }
+        case "log":
+            if (typeof item.text !== "string" || item.text.length > 4096)
+                throw new AgentHostProtocolError("frame_invalid");
+            return { taskId: record.taskId, event: item };
+        default:
+            throw new AgentHostProtocolError("frame_invalid");
+    }
+}
+const TOOL_METHODS = new Set(["tool.read", "tool.write", "tool.edit", "tool.bash", "tool.grep", "tool.find", "tool.ls"]);
+export function isToolMethod(method) {
+    return TOOL_METHODS.has(method);
+}
+/** Validate params of a `tool.*` request from the host. Returns normalized args. */
+export function decodeToolParams(method, params) {
+    if (!params || typeof params !== "object")
+        throw new AgentHostProtocolError("frame_invalid");
+    const record = params;
+    if (typeof record.taskId !== "string" || !isValidTaskId(record.taskId))
+        throw new AgentHostProtocolError("frame_invalid");
+    const { taskId, ...args } = record;
+    switch (method) {
+        case "tool.read":
+            requireString(args, "path");
+            break;
+        case "tool.write":
+            requireString(args, "path");
+            if (typeof args.content !== "string")
+                throw new AgentHostProtocolError("frame_invalid");
+            optionalBoolean(args, "overwrite");
+            break;
+        case "tool.edit":
+            requireString(args, "path");
+            if (!Array.isArray(args.edits) || args.edits.length === 0)
+                throw new AgentHostProtocolError("frame_invalid");
+            break;
+        case "tool.bash":
+            requireString(args, "command");
+            optionalString(args, "cwd");
+            if (args.timeoutMs !== undefined && (typeof args.timeoutMs !== "number" || !Number.isSafeInteger(args.timeoutMs) || args.timeoutMs < 100 || args.timeoutMs > 120_000)) {
+                throw new AgentHostProtocolError("frame_invalid");
+            }
+            break;
+        case "tool.grep":
+            requireString(args, "query");
+            optionalString(args, "path");
+            optionalBoolean(args, "regex");
+            optionalBoolean(args, "caseSensitive");
+            optionalInteger(args, "maxResults", 1, 200);
+            optionalInteger(args, "contextLines", 0, 5);
+            break;
+        case "tool.find":
+            requireString(args, "pattern");
+            optionalString(args, "path");
+            optionalInteger(args, "maxResults", 1, 500);
+            break;
+        case "tool.ls":
+            optionalString(args, "path");
+            break;
+        default:
+            throw new AgentHostProtocolError("frame_invalid");
+    }
+    return { taskId, args };
+}
+function requireString(args, key) {
+    if (typeof args[key] !== "string" || args[key].length === 0)
+        throw new AgentHostProtocolError("frame_invalid");
+}
+function optionalString(args, key) {
+    if (args[key] !== undefined && typeof args[key] !== "string")
+        throw new AgentHostProtocolError("frame_invalid");
+}
+function optionalBoolean(args, key) {
+    if (args[key] !== undefined && typeof args[key] !== "boolean")
+        throw new AgentHostProtocolError("frame_invalid");
+}
+function optionalInteger(args, key, min, max) {
+    const value = args[key];
+    if (value !== undefined && (typeof value !== "number" || !Number.isSafeInteger(value) || value < min || value > max)) {
+        throw new AgentHostProtocolError("frame_invalid");
+    }
+}
+//# sourceMappingURL=protocol.js.map

package/dist/agent/protocol.js.map

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

package/dist/agent/supervisor.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Agent host supervisor: spawns the capsule agent host with a duplex fd3
+ * protocol pipe, performs the frely.agent-host.v1 handshake, forwards tool
+ * requests, and owns idle shutdown / crash handling.
+ */
+import { type ChildProcess } from "node:child_process";
+import { type DiagnosticLog } from "../runtime/diagnostics.js";
+import { type AgentHostTaskEvent, type JsonRpcId } from "./protocol.js";
+import { type CapsuleFacts, type AppInstall } from "./app-install.js";
+export declare const AGENT_HOST_IDLE_TIMEOUT_MS: number;
+export declare const AGENT_HOST_HANDSHAKE_TIMEOUT_MS = 15000;
+export type AgentHostStatus = "stopped" | "starting" | "running" | "failed";
+export type HostRequest = {
+    id: JsonRpcId;
+    method: string;
+    params: unknown;
+};
+/** JSON-RPC peer over the fd3 pipe of a spawned agent host. */
+export declare class AgentHostConnection {
+    readonly process: ChildProcess;
+    private readonly duplex;
+    private readonly log?;
+    private nextId;
+    private readonly pending;
+    private writeClosed;
+    private closeListeners;
+    private constructor();
+    static start(facts: CapsuleFacts, options: {
+        log?: DiagnosticLog | undefined;
+        onEvent?: (taskId: string, event: AgentHostTaskEvent) => void;
+        onToolRequest?: (request: HostRequest, args: Record<string, unknown>, taskId: string) => Promise<unknown>;
+    }): Promise<AgentHostConnection>;
+    private onEvent?;
+    private onToolRequest?;
+    private handshake;
+    request(method: string, params: Record<string, unknown>, timeoutMs?: number): Promise<unknown>;
+    notify(method: string, params: Record<string, unknown>): void;
+    respond(id: JsonRpcId, result: unknown): void;
+    respondError(id: JsonRpcId, code: number, message: string): void;
+    shutdown(graceMs?: number): Promise<void>;
+    kill(): void;
+    onClose(listener: (error?: Error) => void): void;
+    private write;
+    private handleLine;
+    private handleNotification;
+    private handleHostRequest;
+    private closed;
+    private close;
+}
+export declare function cliVersion(): string;
+/** Owns the single agent host process across tasks. */
+export declare class AgentHostSupervisor {
+    private readonly deps;
+    private connection;
+    private starting;
+    private idleTimer;
+    private state;
+    private lastError;
+    private integrityVerified;
+    private lastActivityAt;
+    constructor(deps: {
+        resolveFacts: () => Promise<CapsuleFacts>;
+        onEvent: (taskId: string, event: AgentHostTaskEvent) => void;
+        onToolRequest: (request: HostRequest, args: Record<string, unknown>, taskId: string) => Promise<unknown>;
+        onHostLost: (error?: Error) => void;
+        isIdle: () => boolean | Promise<boolean>;
+        log?: DiagnosticLog | undefined;
+        fullIntegrityVerification?: boolean;
+        appInstall?: (() => Promise<AppInstall>) | undefined;
+    });
+    status(): {
+        state: AgentHostStatus;
+        hostVersion: string | null;
+        lastError: string | null;
+    };
+    ensureHost(): Promise<AgentHostConnection>;
+    stop(): Promise<void>;
+    private armIdleTimer;
+    private disarmIdleTimer;
+}

package/dist/agent/supervisor.js

@@ -0,0 +1,278 @@
+/**
+ * Agent host supervisor: spawns the capsule agent host with a duplex fd3
+ * protocol pipe, performs the frely.agent-host.v1 handshake, forwards tool
+ * requests, and owns idle shutdown / crash handling.
+ */
+import { spawn } from "node:child_process";
+import { createInterface } from "node:readline";
+import { diagnostic } from "../runtime/diagnostics.js";
+import { VERSION } from "../version.js";
+import { AGENT_HOST_CONNECTION_KEY_ENV, AGENT_HOST_PROTOCOL_VERSION, AgentHostProtocolError, decodeAgentHostFrame, decodeTaskEvent, decodeToolParams, encodeAgentHostFrame, isToolMethod, newConnectionKey, } from "./protocol.js";
+export const AGENT_HOST_IDLE_TIMEOUT_MS = 15 * 60 * 1000;
+export const AGENT_HOST_HANDSHAKE_TIMEOUT_MS = 15_000;
+/** JSON-RPC peer over the fd3 pipe of a spawned agent host. */
+export class AgentHostConnection {
+    process;
+    duplex;
+    log;
+    nextId = 1;
+    pending = new Map();
+    writeClosed = false;
+    closeListeners = [];
+    constructor(process, duplex, log) {
+        this.process = process;
+        this.duplex = duplex;
+        this.log = log;
+        const lines = createInterface({ input: duplex, crlfDelay: Infinity });
+        lines.on("line", (line) => this.handleLine(line));
+        this.duplex.on("error", (error) => this.close(error));
+        this.duplex.on("close", () => this.close());
+        this.process.once("exit", (code, signal) => this.close(new Error(`Agent host exited (code=${code} signal=${signal}).`)));
+    }
+    static async start(facts, options) {
+        const key = newConnectionKey();
+        const child = spawn(facts.nodeExecutable, [facts.agentHostEntrypoint], {
+            stdio: ["ignore", "ignore", "ignore", "pipe"],
+            env: { ...process.env, [AGENT_HOST_CONNECTION_KEY_ENV]: key },
+            windowsHide: true,
+        });
+        const duplex = child.stdio[3];
+        if (!duplex) {
+            child.kill();
+            throw new AgentHostProtocolError("unexpected_frame");
+        }
+        const connection = new AgentHostConnection(child, duplex, options.log);
+        try {
+            await connection.handshake(key);
+        }
+        catch (error) {
+            connection.kill();
+            throw error;
+        }
+        connection.onEvent = options.onEvent;
+        connection.onToolRequest = options.onToolRequest ?? null;
+        return connection;
+    }
+    onEvent;
+    onToolRequest;
+    async handshake(connectionKey) {
+        const result = (await this.request("initialize", { protocolVersion: AGENT_HOST_PROTOCOL_VERSION, cliVersion: cliVersion(), connectionKey, capabilities: ["tasks", "tools"] }, AGENT_HOST_HANDSHAKE_TIMEOUT_MS));
+        if (!result || result.protocolVersion !== AGENT_HOST_PROTOCOL_VERSION) {
+            throw new AgentHostProtocolError("handshake_rejected");
+        }
+        this.notify("initialized", {});
+    }
+    request(method, params, timeoutMs = 120_000) {
+        if (this.writeClosed)
+            return Promise.reject(new Error("Agent host connection is closed."));
+        const id = this.nextId++;
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                this.pending.delete(id);
+                reject(new Error(`Agent host request timed out: ${method}`));
+            }, timeoutMs);
+            timer.unref?.();
+            this.pending.set(id, { resolve, reject, method, timer });
+            this.write({ jsonrpc: "2.0", id, method, params });
+        });
+    }
+    notify(method, params) {
+        if (this.writeClosed)
+            return;
+        this.write({ jsonrpc: "2.0", method, params });
+    }
+    respond(id, result) {
+        if (this.writeClosed)
+            return;
+        this.write({ jsonrpc: "2.0", id, result });
+    }
+    respondError(id, code, message) {
+        if (this.writeClosed)
+            return;
+        this.write({ jsonrpc: "2.0", id, error: { code, message } });
+    }
+    async shutdown(graceMs = 5_000) {
+        try {
+            await this.request("host.shutdown", {}, graceMs).catch(() => undefined);
+        }
+        finally {
+            this.kill();
+        }
+    }
+    kill() {
+        this.writeClosed = true;
+        this.process.kill();
+    }
+    onClose(listener) {
+        this.closeListeners.push(listener);
+    }
+    write(message) {
+        this.duplex.write(encodeAgentHostFrame(message), (error) => {
+            if (error)
+                this.close(error instanceof Error ? error : new Error(String(error)));
+        });
+    }
+    handleLine(line) {
+        let message;
+        try {
+            message = decodeAgentHostFrame(line);
+        }
+        catch (error) {
+            diagnostic(this.log, "agent.host.frame_invalid", {}, error);
+            this.close(error instanceof Error ? error : new Error("invalid frame"));
+            return;
+        }
+        if ("method" in message) {
+            if ("id" in message && message.id !== undefined)
+                void this.handleHostRequest(message);
+            else
+                this.handleNotification(message.method, message.params);
+            return;
+        }
+        const pending = this.pending.get(message.id);
+        if (!pending)
+            return;
+        this.pending.delete(message.id);
+        clearTimeout(pending.timer);
+        if ("error" in message && message.error)
+            pending.reject(new Error(`${pending.method}: ${message.error.message}`));
+        else
+            pending.resolve(message.result);
+    }
+    handleNotification(method, params) {
+        if (method !== "task.event") {
+            diagnostic(this.log, "agent.host.unexpected_notification", { method });
+            return;
+        }
+        try {
+            const { taskId, event } = decodeTaskEvent(params);
+            this.onEvent?.(taskId, event);
+        }
+        catch (error) {
+            diagnostic(this.log, "agent.host.event_invalid", {}, error);
+        }
+    }
+    async handleHostRequest(request) {
+        if (!isToolMethod(request.method)) {
+            this.respondError(request.id, -32601, `Unknown method: ${request.method}`);
+            return;
+        }
+        if (!this.onToolRequest) {
+            this.respondError(request.id, -32000, "No tool executor attached.");
+            return;
+        }
+        try {
+            const { taskId, args } = decodeToolParams(request.method, request.params);
+            const result = await this.onToolRequest({ id: request.id, method: request.method, params: request.params }, args, taskId);
+            this.respond(request.id, { ok: true, result });
+        }
+        catch (error) {
+            this.respond(request.id, { ok: false, error: { code: "tool_failed", message: error instanceof Error ? error.message.slice(0, 512) : "tool failed" } });
+        }
+    }
+    closed = false;
+    close(error) {
+        if (this.closed)
+            return;
+        this.closed = true;
+        this.writeClosed = true;
+        for (const pending of this.pending.values()) {
+            clearTimeout(pending.timer);
+            pending.reject(error ?? new Error("Agent host connection closed."));
+        }
+        this.pending.clear();
+        for (const listener of [...this.closeListeners])
+            listener(error);
+        this.closeListeners = [];
+    }
+}
+export function cliVersion() {
+    return process.env.FRELY_CLI_VERSION_OVERRIDE ?? VERSION;
+}
+/** Owns the single agent host process across tasks. */
+export class AgentHostSupervisor {
+    deps;
+    connection = null;
+    starting = null;
+    idleTimer = null;
+    state = "stopped";
+    lastError = null;
+    integrityVerified = false;
+    lastActivityAt = 0;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    status() {
+        return { state: this.state, hostVersion: null, lastError: this.lastError };
+    }
+    async ensureHost() {
+        if (this.connection)
+            return this.connection;
+        if (this.starting)
+            return this.starting;
+        this.starting = (async () => {
+            this.state = "starting";
+            const facts = await this.deps.resolveFacts();
+            if (this.deps.fullIntegrityVerification && !this.integrityVerified) {
+                const { verifyCapsuleIntegrity } = await import("./app-install.js");
+                const install = this.deps.appInstall ? await this.deps.appInstall() : null;
+                if (install)
+                    await verifyCapsuleIntegrity(install);
+                this.integrityVerified = true;
+            }
+            const connection = await AgentHostConnection.start(facts, {
+                log: this.deps.log,
+                onEvent: (taskId, event) => {
+                    this.lastActivityAt = Date.now();
+                    this.deps.onEvent(taskId, event);
+                },
+                onToolRequest: (request, args, taskId) => {
+                    this.lastActivityAt = Date.now();
+                    return this.deps.onToolRequest(request, args, taskId);
+                },
+            });
+            connection.onClose((error) => {
+                this.connection = null;
+                this.state = "stopped";
+                this.lastError = error ? error.message : null;
+                this.deps.onHostLost(error);
+            });
+            this.connection = connection;
+            this.state = "running";
+            this.lastError = null;
+            this.armIdleTimer();
+            return connection;
+        })();
+        try {
+            return await this.starting;
+        }
+        finally {
+            this.starting = null;
+        }
+    }
+    async stop() {
+        this.disarmIdleTimer();
+        const connection = this.connection;
+        this.connection = null;
+        this.state = "stopped";
+        if (connection)
+            await connection.shutdown();
+    }
+    armIdleTimer() {
+        this.disarmIdleTimer();
+        this.lastActivityAt = Date.now();
+        this.idleTimer = setInterval(() => {
+            void Promise.resolve(this.deps.isIdle()).then((idle) => {
+                if (idle && Date.now() - this.lastActivityAt >= AGENT_HOST_IDLE_TIMEOUT_MS)
+                    void this.stop();
+            });
+        }, 30_000);
+        this.idleTimer.unref?.();
+    }
+    disarmIdleTimer() {
+        if (this.idleTimer)
+            clearInterval(this.idleTimer);
+        this.idleTimer = null;
+    }
+}
+//# sourceMappingURL=supervisor.js.map

package/dist/agent/supervisor.js.map

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

package/dist/agent/task-store.d.ts

@@ -0,0 +1,82 @@
+import { type AgentHostTaskEvent } from "./protocol.js";
+export type AgentTaskRuntimeStatus = "queued" | "running" | "waiting_input" | "completed" | "failed" | "cancelled";
+export type AgentTaskMergeStatus = "none" | "merge_requested" | "approved" | "merged" | "merge_conflict" | "discarded";
+export type AgentTaskSource = {
+    kind: "gui";
+} | {
+    kind: "web";
+} | {
+    kind: "mcp";
+    authorizationId: string;
+};
+export type AgentTaskUsage = {
+    inputTokens: number;
+    outputTokens: number;
+    costUsd: number;
+};
+export type AgentTaskRecord = {
+    id: string;
+    source: AgentTaskSource;
+    workspace: string;
+    worktreePath: string;
+    branch: string;
+    baseBranch: string;
+    baseCommit: string;
+    goal: string;
+    model: string | null;
+    maxCostUsd: number;
+    status: AgentTaskRuntimeStatus;
+    mergeStatus: AgentTaskMergeStatus;
+    usage: AgentTaskUsage;
+    error: string | null;
+    mergeRequest: {
+        requestedAt: string;
+        note?: string;
+    } | null;
+    approval: {
+        approvedAt: string;
+        approvedBy: "gui" | "web";
+    } | null;
+    createdAt: string;
+    updatedAt: string;
+    settledAt: string | null;
+};
+export type StoredAgentEvent = AgentHostTaskEvent & {
+    seq: number;
+    at: string;
+};
+export declare const AGENT_TASK_EVENTS_PAGE_SIZE = 100;
+export declare const AGENT_TASK_MAX_GOAL_BYTES: number;
+export declare const AGENT_DEFAULT_MAX_COST_USD = 2;
+export declare const AGENT_MAX_COST_USD_LIMIT = 50;
+export declare const AGENT_DEFAULT_MAX_CONCURRENT_TASKS = 2;
+export declare const AGENT_START_RATE_LIMIT_PER_MINUTE = 5;
+export declare class AgentStoreError extends Error {
+    readonly code: "task_not_found" | "task_exists" | "store_corrupt" | "invalid_task";
+    constructor(code: "task_not_found" | "task_exists" | "store_corrupt" | "invalid_task");
+}
+export declare function agentStateDir(env?: NodeJS.ProcessEnv): string;
+export declare function agentConfigPath(env?: NodeJS.ProcessEnv): string;
+export declare function agentDataDir(env?: NodeJS.ProcessEnv): string;
+export declare function workspaceStorageKey(workspaceRoot: string): string;
+/** Serialize + validate the runtime/merge state machine transitions. */
+export declare function nextRuntimeStatus(current: AgentTaskRuntimeStatus, event: AgentHostTaskEvent): AgentTaskRuntimeStatus | null;
+export declare function isTerminalStatus(status: AgentTaskRuntimeStatus): boolean;
+export declare class TaskStore {
+    private readonly rootDir;
+    constructor(rootDir: string);
+    static open(rootDir?: string, env?: NodeJS.ProcessEnv): TaskStore;
+    create(record: AgentTaskRecord): Promise<void>;
+    read(id: string): Promise<AgentTaskRecord>;
+    update(id: string, mutate: (record: AgentTaskRecord) => AgentTaskRecord): Promise<AgentTaskRecord>;
+    list(): Promise<AgentTaskRecord[]>;
+    appendEvent(id: string, event: AgentHostTaskEvent): Promise<StoredAgentEvent>;
+    readEvents(id: string, cursor: number, limit?: number): Promise<{
+        events: StoredAgentEvent[];
+        nextCursor: number | null;
+    }>;
+    private lastEventSeq;
+    private taskDir;
+    private persist;
+}
+export declare function validateTaskRecord(value: unknown): AgentTaskRecord;