frely-cli 0.6.10 → 0.8.3

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;

package/dist/agent/task-store.js

@@ -0,0 +1,220 @@
+/**
+ * Agent task store: one directory per task under the frely state directory
+ * (`<state>/agent/tasks/<taskId>/`), with `task.json` for the record and
+ * `events.jsonl` for the append-only event log.
+ */
+import { createHash, randomBytes } from "node:crypto";
+import { homedir } from "node:os";
+import { mkdir, readFile, readdir, rename, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { isValidTaskId } from "./protocol.js";
+export const AGENT_TASK_EVENTS_PAGE_SIZE = 100;
+export const AGENT_TASK_MAX_GOAL_BYTES = 64 * 1024;
+export const AGENT_DEFAULT_MAX_COST_USD = 2;
+export const AGENT_MAX_COST_USD_LIMIT = 50;
+export const AGENT_DEFAULT_MAX_CONCURRENT_TASKS = 2;
+export const AGENT_START_RATE_LIMIT_PER_MINUTE = 5;
+export class AgentStoreError extends Error {
+    code;
+    constructor(code) {
+        super(code);
+        this.code = code;
+        this.name = "AgentStoreError";
+    }
+}
+export function agentStateDir(env = process.env) {
+    return join(env.XDG_STATE_HOME || join(homedir(), ".local", "state"), "frely", "agent");
+}
+export function agentConfigPath(env = process.env) {
+    return join(env.XDG_CONFIG_HOME || join(homedir(), ".config"), "frely", "agent.json");
+}
+export function agentDataDir(env = process.env) {
+    return join(env.XDG_DATA_HOME || join(homedir(), ".local", "share"), "frely");
+}
+export function workspaceStorageKey(workspaceRoot) {
+    return createHash("sha256").update(workspaceRoot).digest("hex").slice(0, 16);
+}
+/** Serialize + validate the runtime/merge state machine transitions. */
+export function nextRuntimeStatus(current, event) {
+    if (event.type !== "status")
+        return null;
+    switch (current) {
+        case "queued":
+            // Host events may race ahead of CLI bookkeeping right after task.start,
+            // so any authoritative host status is accepted from queued.
+            return event.status === "running" || event.status === "waiting_input" || event.status === "completed" || event.status === "failed" || event.status === "cancelled"
+                ? event.status
+                : null;
+        case "running":
+            return event.status === "waiting_input" || event.status === "completed" || event.status === "failed" || event.status === "cancelled" || event.status === "running"
+                ? event.status
+                : null;
+        case "waiting_input":
+            return event.status === "running" || event.status === "completed" || event.status === "failed" || event.status === "cancelled" ? event.status : null;
+        default:
+            return null;
+    }
+}
+export function isTerminalStatus(status) {
+    return status === "completed" || status === "failed" || status === "cancelled";
+}
+export class TaskStore {
+    rootDir;
+    constructor(rootDir) {
+        this.rootDir = rootDir;
+    }
+    static open(rootDir, env = process.env) {
+        return new TaskStore(rootDir ?? join(agentStateDir(env), "tasks"));
+    }
+    async create(record) {
+        if (!isValidTaskId(record.id))
+            throw new AgentStoreError("invalid_task");
+        const dir = this.taskDir(record.id);
+        await mkdir(dir, { recursive: true, mode: 0o700 });
+        if (await this.read(record.id).then(() => true, () => false))
+            throw new AgentStoreError("task_exists");
+        await this.persist(record);
+    }
+    async read(id) {
+        if (!isValidTaskId(id))
+            throw new AgentStoreError("invalid_task");
+        let raw;
+        try {
+            raw = await readFile(join(this.taskDir(id), "task.json"), "utf8");
+        }
+        catch {
+            throw new AgentStoreError("task_not_found");
+        }
+        let value;
+        try {
+            value = JSON.parse(raw);
+        }
+        catch {
+            throw new AgentStoreError("store_corrupt");
+        }
+        return validateTaskRecord(value);
+    }
+    async update(id, mutate) {
+        const current = await this.read(id);
+        const next = validateTaskRecord(mutate(structuredClone(current)));
+        if (next.id !== current.id)
+            throw new AgentStoreError("invalid_task");
+        await this.persist(next);
+        return next;
+    }
+    async list() {
+        let entries;
+        try {
+            entries = await readdir(this.rootDir);
+        }
+        catch {
+            return [];
+        }
+        const records = [];
+        for (const entry of entries.sort()) {
+            if (!isValidTaskId(entry))
+                continue;
+            const record = await this.read(entry).catch(() => null);
+            if (record)
+                records.push(record);
+        }
+        return records;
+    }
+    async appendEvent(id, event) {
+        const dir = this.taskDir(id);
+        await mkdir(dir, { recursive: true, mode: 0o700 });
+        const last = await this.lastEventSeq(id);
+        const stored = { ...event, seq: last + 1, at: new Date().toISOString() };
+        const { appendFile } = await import("node:fs/promises");
+        await appendFile(join(dir, "events.jsonl"), `${JSON.stringify(stored)}\n`, { encoding: "utf8", mode: 0o600 });
+        return stored;
+    }
+    async readEvents(id, cursor, limit = AGENT_TASK_EVENTS_PAGE_SIZE) {
+        let raw;
+        try {
+            raw = await readFile(join(this.taskDir(id), "events.jsonl"), "utf8");
+        }
+        catch {
+            if (await this.read(id).then(() => true, () => false))
+                return { events: [], nextCursor: null };
+            throw new AgentStoreError("task_not_found");
+        }
+        const events = [];
+        let nextCursor = null;
+        for (const line of raw.split("\n")) {
+            if (!line)
+                continue;
+            let parsed;
+            try {
+                parsed = JSON.parse(line);
+            }
+            catch {
+                continue;
+            }
+            if (parsed.seq > cursor) {
+                events.push(parsed);
+                if (events.length > limit) {
+                    events.pop();
+                    nextCursor = parsed.seq - 1;
+                    break;
+                }
+            }
+        }
+        return { events, nextCursor };
+    }
+    async lastEventSeq(id) {
+        let raw;
+        try {
+            raw = await readFile(join(this.taskDir(id), "events.jsonl"), "utf8");
+        }
+        catch {
+            return 0;
+        }
+        const lines = raw.trimEnd().split("\n");
+        const last = lines[lines.length - 1];
+        if (!last)
+            return 0;
+        try {
+            const parsed = JSON.parse(last);
+            return typeof parsed.seq === "number" ? parsed.seq : 0;
+        }
+        catch {
+            return 0;
+        }
+    }
+    taskDir(id) {
+        return join(this.rootDir, id);
+    }
+    async persist(record) {
+        record.updatedAt = new Date().toISOString();
+        const dir = this.taskDir(record.id);
+        await mkdir(dir, { recursive: true, mode: 0o700 });
+        const tmp = join(dir, `task.json.${process.pid}.${randomBytes(4).toString("hex")}.tmp`);
+        await writeFile(tmp, `${JSON.stringify(record, null, 2)}\n`, { encoding: "utf8", mode: 0o600 });
+        await rename(tmp, join(dir, "task.json"));
+    }
+}
+export function validateTaskRecord(value) {
+    if (!value || typeof value !== "object")
+        throw new AgentStoreError("store_corrupt");
+    const r = value;
+    const id = r.id;
+    if (typeof id !== "string" || !isValidTaskId(id))
+        throw new AgentStoreError("store_corrupt");
+    const runtimeStatuses = ["queued", "running", "waiting_input", "completed", "failed", "cancelled"];
+    const mergeStatuses = ["none", "merge_requested", "approved", "merged", "merge_conflict", "discarded"];
+    if (!runtimeStatuses.includes(r.status))
+        throw new AgentStoreError("store_corrupt");
+    if (!mergeStatuses.includes(r.mergeStatus))
+        throw new AgentStoreError("store_corrupt");
+    for (const key of ["workspace", "worktreePath", "branch", "baseBranch", "baseCommit", "goal", "createdAt", "updatedAt"]) {
+        if (typeof r[key] !== "string")
+            throw new AgentStoreError("store_corrupt");
+    }
+    for (const key of ["maxCostUsd"]) {
+        if (typeof r[key] !== "number" || !Number.isFinite(r[key]) || r[key] <= 0)
+            throw new AgentStoreError("store_corrupt");
+    }
+    return value;
+}
+//# sourceMappingURL=task-store.js.map

package/dist/agent/task-store.js.map

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

package/dist/agent/tool-executor.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Agent tool executor: executes `tool.*` requests from the agent host inside
+ * the task's worktree through the shared `Workspace` implementation (path
+ * containment + srt sandbox for commands) under a fair read/write scheduler.
+ */
+import { FairRwScheduler } from "../runtime/scheduler.js";
+export type AgentToolResult = {
+    ok: true;
+    result: unknown;
+} | {
+    ok: false;
+    error: {
+        code: "tool_failed" | "not_found" | "invalid_args";
+        message: string;
+    };
+};
+export type AgentToolKind = "read" | "write" | "bash" | "grep" | "find" | "ls" | "edit";
+/** Single active executor per task; created when the task starts running. */
+export declare class AgentToolExecutor {
+    private readonly scheduler;
+    private readonly workspace;
+    private disposed;
+    constructor(worktreeRoot: string, scheduler: FairRwScheduler);
+    execute(kind: AgentToolKind, args: Record<string, unknown>): Promise<AgentToolResult>;
+    private dispatch;
+    dispose(): void;
+}
+export declare function toolKindFromMethod(method: string): AgentToolKind | null;