@loompad/cli 0.1.0

package/dist/adapters/codex.js

@@ -0,0 +1,291 @@
+/**
+ * Codex adapter — drives the `codex` CLI headless, one process per turn,
+ * resuming the same thread across turns.
+ *
+ *   codex exec --json --skip-git-repo-check -C <dir> -s <sandbox> "<text>"
+ *   codex exec resume <threadId> --json … "<text>"
+ *
+ * The CLI ships inside the desktop app as well as on PATH, so `available()`
+ * looks in both places — a Mac with Codex.app installed and nothing on PATH is
+ * the common case, and refusing to find it there would be wrong.
+ *
+ * Event surface verified against codex-cli 0.142.4 by running it and reading
+ * what came out, not by guessing:
+ *
+ *   {"type":"thread.started","thread_id":"019f…"}
+ *   {"type":"turn.started"}
+ *   {"type":"item.started","item":{"id":"item_1","type":"command_execution",…}}
+ *   {"type":"item.completed","item":{"id":"item_1","type":"command_execution",
+ *      "command":"/bin/zsh -lc 'echo hi'","aggregated_output":"hi\n","exit_code":0}}
+ *   {"type":"item.completed","item":{"id":"item_2","type":"agent_message","text":"…"}}
+ *   {"type":"item.completed","item":{"id":"item_3","type":"file_change",
+ *      "changes":[{"path":"/abs/note.txt","kind":"add"}]}}
+ *   {"type":"turn.completed","usage":{"input_tokens":52831,"output_tokens":120,…}}
+ *
+ * Note what is NOT in there: money. Codex reports tokens, never a dollar
+ * figure, so this adapter reports tokens and no cost. Inventing a USD number
+ * from a price table we'd have to keep current is how you end up with a fake
+ * $0.001 in the UI presented as fact.
+ */
+import { spawn } from "node:child_process";
+import fs from "node:fs";
+import readline from "node:readline";
+import { readProjectState, writeProjectState } from "../core/registry.js";
+import { AdapterBase, agentEnv, cliAvailable, frameBriefing } from "./base.js";
+/** The CLI bundled inside the desktop app, per platform. */
+const BUNDLED = [
+    "/Applications/Codex.app/Contents/Resources/codex",
+    `${process.env.HOME ?? ""}/Applications/Codex.app/Contents/Resources/codex`,
+];
+/**
+ * Where the codex CLI is on this machine: an explicit override, then PATH,
+ * then inside the app bundle.
+ */
+export function codexBin(override) {
+    if (override)
+        return fs.existsSync(override) ? override : null;
+    for (const p of BUNDLED) {
+        if (fs.existsSync(p))
+            return p;
+    }
+    return "codex"; // let PATH resolution (and cliAvailable) decide
+}
+export class CodexAdapter extends AdapterBase {
+    child = null;
+    options;
+    constructor(id, projectDir, options = {}) {
+        super(id, "codex", projectDir);
+        this.options = options;
+    }
+    /** Codex calls it a thread; loom stores it in the same slot as any session. */
+    get threadId() {
+        const state = readProjectState(this.projectDir);
+        return state.agents[this.id]?.sessionId;
+    }
+    set threadId(value) {
+        const state = readProjectState(this.projectDir);
+        state.agents[this.id] = { ...state.agents[this.id], sessionId: value };
+        writeProjectState(this.projectDir, state);
+    }
+    async available() {
+        const bin = codexBin(this.options.bin);
+        if (!bin)
+            return false;
+        return cliAvailable(bin);
+    }
+    async start() {
+        this.emit({ kind: "status", payload: { state: "ready", session: this.threadId ?? null } });
+    }
+    async stop() {
+        await this.interrupt();
+    }
+    async send(input) {
+        if (this._busy)
+            throw new Error(`codex agent "${this.id}" is busy`);
+        const bin = codexBin(this.options.bin);
+        if (!bin)
+            throw new Error("codex CLI not found — install it or open Codex.app once");
+        this._busy = true;
+        const started = Date.now();
+        // Codex exec has no --append-system-prompt, so the briefing rides in front
+        // of the text — but framed as an unmissable authoritative block (see
+        // frameBriefing), not a loose preamble the model skims past.
+        const text = input.briefing ? `${frameBriefing(input.briefing)}\n\n${input.text}` : input.text;
+        const args = this.threadId
+            ? ["exec", "resume", this.threadId]
+            : ["exec"];
+        args.push("--json", "--skip-git-repo-check", "-C", this.projectDir, "-s", this.options.sandbox ?? "workspace-write");
+        if (this.options.model)
+            args.push("-m", this.options.model);
+        if (this.options.extraArgs)
+            args.push(...this.options.extraArgs);
+        args.push(text);
+        try {
+            await new Promise((resolve, reject) => {
+                const child = spawn(bin, args, {
+                    cwd: this.projectDir,
+                    // stdin closed: with a pipe open, `codex exec` waits on stdin for
+                    // additional input and the turn never starts.
+                    stdio: ["ignore", "pipe", "pipe"],
+                    env: agentEnv(),
+                });
+                this.child = child;
+                let lastMessage = "";
+                let sawTurn = false;
+                let stderrTail = "";
+                const rl = readline.createInterface({ input: child.stdout });
+                rl.on("line", (line) => {
+                    const trimmed = line.trim();
+                    if (!trimmed.startsWith("{"))
+                        return;
+                    let evt;
+                    try {
+                        evt = JSON.parse(trimmed);
+                    }
+                    catch {
+                        return;
+                    }
+                    this.handleEvent(evt, (t) => (lastMessage = t));
+                    if (evt.type === "turn.completed")
+                        sawTurn = true;
+                });
+                child.stderr.on("data", (d) => {
+                    stderrTail = (stderrTail + d.toString()).slice(-2000);
+                });
+                child.on("error", (err) => reject(err));
+                child.on("close", (code, signal) => {
+                    this.child = null;
+                    if (signal) {
+                        this.emit({ kind: "status", payload: { state: "interrupted", signal } });
+                        resolve();
+                        return;
+                    }
+                    if (code !== 0 && !sawTurn) {
+                        this.emit({
+                            kind: "error",
+                            payload: { message: `codex exited ${code}`, stderr: stderrTail },
+                        });
+                        reject(new Error(`codex exited ${code}: ${stderrTail.slice(0, 200)}`));
+                        return;
+                    }
+                    // Same blocked-on-human heuristic the other adapters use: the turn
+                    // ended on a question, so the baton is really with you.
+                    if (/\?\s*$/.test(lastMessage.trim())) {
+                        this.emit({ kind: "needs_input", payload: { question: lastMessage.slice(-500) } });
+                    }
+                    this.emit({ kind: "run_complete", payload: { durationMs: Date.now() - started } });
+                    resolve();
+                });
+            });
+        }
+        finally {
+            this._busy = false;
+            this.child = null;
+        }
+    }
+    handleEvent(evt, setLast) {
+        const type = evt.type;
+        if (type === "thread.started") {
+            const id = evt.thread_id;
+            if (id)
+                this.threadId = id;
+            this.emit({ kind: "status", payload: { state: "turn_started", session: id ?? null } });
+            return;
+        }
+        if (type === "item.completed" || type === "item.started") {
+            const item = (evt.item ?? {});
+            // Only completed items are reported: an in_progress command has no exit
+            // code yet, and a half-written file_change has nothing useful to say.
+            if (type !== "item.completed")
+                return;
+            this.handleItem(item, setLast);
+            return;
+        }
+        if (type === "turn.completed") {
+            const usage = (evt.usage ?? {});
+            this.emit({
+                kind: "status",
+                payload: {
+                    state: "turn_tokens",
+                    inputTokens: usage.input_tokens ?? 0,
+                    cachedInputTokens: usage.cached_input_tokens ?? 0,
+                    outputTokens: usage.output_tokens ?? 0,
+                    reasoningTokens: usage.reasoning_output_tokens ?? 0,
+                },
+            });
+            return;
+        }
+        if (type === "turn.failed" || type === "error") {
+            const err = (evt.error ?? evt);
+            this.emit({ kind: "error", payload: { message: String(err.message ?? "codex failed") } });
+        }
+    }
+    handleItem(item, setLast) {
+        switch (item.type) {
+            case "agent_message": {
+                const text = String(item.text ?? "");
+                if (!text.trim())
+                    return;
+                setLast(text);
+                this.emit({ kind: "message", payload: { text } });
+                return;
+            }
+            case "reasoning": {
+                const text = String(item.text ?? "").trim();
+                if (text)
+                    this.emit({ kind: "message", payload: { text, reasoning: true } });
+                return;
+            }
+            case "command_execution": {
+                const command = String(item.command ?? "");
+                const exit = item.exit_code;
+                this.emit({
+                    kind: "tool_call",
+                    payload: {
+                        tool: "shell",
+                        summary: `shell: ${command.replace(/\s+/g, " ").slice(0, 160)}`,
+                        exitCode: typeof exit === "number" ? exit : null,
+                    },
+                });
+                return;
+            }
+            case "file_change": {
+                const changes = (item.changes ?? []);
+                for (const c of changes) {
+                    if (!c.path)
+                        continue;
+                    this.emit({
+                        kind: "file_edit",
+                        payload: { path: String(c.path), tool: `file_change:${c.kind ?? "edit"}` },
+                    });
+                }
+                return;
+            }
+            case "mcp_tool_call": {
+                this.emit({
+                    kind: "tool_call",
+                    payload: { tool: String(item.tool ?? "mcp"), summary: `mcp: ${String(item.tool ?? "")}` },
+                });
+                return;
+            }
+            case "web_search": {
+                this.emit({
+                    kind: "tool_call",
+                    payload: { tool: "web_search", summary: `search: ${String(item.query ?? "")}`.slice(0, 160) },
+                });
+                return;
+            }
+            case "error": {
+                this.emit({ kind: "error", payload: { message: String(item.message ?? "codex error") } });
+                return;
+            }
+            default:
+                // todo_list and whatever Codex adds next: not every item is worth an
+                // event, and inventing a rendering for one we don't understand is worse
+                // than staying quiet.
+                return;
+        }
+    }
+    async interrupt() {
+        const child = this.child;
+        if (!child)
+            return;
+        child.kill("SIGINT");
+        await new Promise((resolve) => {
+            const t = setTimeout(() => {
+                try {
+                    child.kill("SIGKILL");
+                }
+                catch {
+                    // already gone
+                }
+                resolve();
+            }, 3000);
+            child.on("close", () => {
+                clearTimeout(t);
+                resolve();
+            });
+        });
+    }
+}
+//# sourceMappingURL=codex.js.map

package/dist/adapters/codex.js.map

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

package/dist/adapters/echo.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Echo adapter — a deterministic in-process agent used by tests and demos.
+ * It behaves like a full-duplex adapter: streams a message, then completes.
+ *
+ * Prompt tricks (for exercising the machinery without a real model):
+ *   - text containing "make a plan"  → replies in planner voice ("plan is complete")
+ *   - text containing "sleep:<ms>"   → stays busy that long (interrupt testing)
+ *   - text containing "ask: <q>"     → asks the human (needs_input; route pausing)
+ *   - text containing "write:<path>" → writes a small file (turn_diff testing)
+ */
+import type { SendInput } from "../types.js";
+import { AdapterBase } from "./base.js";
+export declare class EchoAdapter extends AdapterBase {
+    private aborted;
+    available(): Promise<boolean>;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    send(input: SendInput): Promise<void>;
+    interrupt(): Promise<void>;
+}

package/dist/adapters/echo.js

@@ -0,0 +1,79 @@
+/**
+ * Echo adapter — a deterministic in-process agent used by tests and demos.
+ * It behaves like a full-duplex adapter: streams a message, then completes.
+ *
+ * Prompt tricks (for exercising the machinery without a real model):
+ *   - text containing "make a plan"  → replies in planner voice ("plan is complete")
+ *   - text containing "sleep:<ms>"   → stays busy that long (interrupt testing)
+ *   - text containing "ask: <q>"     → asks the human (needs_input; route pausing)
+ *   - text containing "write:<path>" → writes a small file (turn_diff testing)
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { AdapterBase } from "./base.js";
+export class EchoAdapter extends AdapterBase {
+    aborted = false;
+    async available() {
+        return true;
+    }
+    async start() {
+        this.emit({ kind: "status", payload: { state: "started" } });
+    }
+    async stop() {
+        this.emit({ kind: "status", payload: { state: "stopped" } });
+    }
+    async send(input) {
+        if (this._busy)
+            throw new Error(`echo agent "${this.id}" is busy`);
+        this._busy = true;
+        this.aborted = false;
+        const started = Date.now();
+        try {
+            const sleepMatch = input.text.match(/sleep:(\d+)/);
+            if (sleepMatch) {
+                const ms = Math.min(Number(sleepMatch[1]), 60_000);
+                const deadline = Date.now() + ms;
+                while (Date.now() < deadline && !this.aborted) {
+                    await new Promise((r) => setTimeout(r, 20));
+                }
+            }
+            else {
+                await new Promise((r) => setTimeout(r, 25));
+            }
+            if (this.aborted) {
+                this.emit({ kind: "status", payload: { state: "interrupted" } });
+                return;
+            }
+            const writeMatch = input.text.match(/write:([\w./-]+)/);
+            if (writeMatch && !writeMatch[1].includes("..")) {
+                const target = path.join(this.projectDir, writeMatch[1]);
+                fs.mkdirSync(path.dirname(target), { recursive: true });
+                fs.writeFileSync(target, `echo(${this.id}) wrote this\n`);
+                this.emit({ kind: "file_edit", payload: { path: writeMatch[1] } });
+            }
+            const briefingNote = input.briefing ? ` (briefed: ${input.briefing.length} chars)` : "";
+            const text = /make a plan/i.test(input.text)
+                ? `Here is the approach. 1) analyze 2) implement 3) verify. The plan is complete and ready to execute.${briefingNote}`
+                : `echo(${this.id}): ${input.text}${briefingNote}`;
+            this.emit({ kind: "message", payload: { text } });
+            // Lookbehind so "Task:" (…t-ask:) doesn't read as a question.
+            const askMatch = input.text.match(/(?<![a-z])ask:\s*([^\n]+)/i);
+            if (askMatch) {
+                this.emit({ kind: "needs_input", payload: { question: askMatch[1].trim() } });
+            }
+            // Deterministic fake cost so telemetry is exercisable without a model.
+            this.emit({ kind: "status", payload: { state: "turn_cost", costUsd: 0.001 } });
+            this.emit({
+                kind: "run_complete",
+                payload: { durationMs: Date.now() - started, costUsd: 0.001 },
+            });
+        }
+        finally {
+            this._busy = false;
+        }
+    }
+    async interrupt() {
+        this.aborted = true;
+    }
+}
+//# sourceMappingURL=echo.js.map

package/dist/adapters/echo.js.map

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

package/dist/adapters/grok.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Grok Code adapter — drives the `grok` CLI single-turn, resuming the same
+ * session across turns.
+ *
+ *   grok -p "<text>" --output-format json --cwd <dir>
+ *        --permission-mode acceptEdits [-r <sessionId>]
+ *
+ * Surface verified against grok 0.2.54 by running it:
+ *
+ *   {"text":"ok","stopReason":"EndTurn","sessionId":"019f…",
+ *    "requestId":"02a6…","thought":"The user wants me to…"}
+ *
+ * ## What this adapter cannot show you
+ *
+ * Grok's turn is a black box with an answer at the end. `--output-format
+ * streaming-json` sounds like it would help and doesn't: it emits `thought` and
+ * `text` token deltas and a final `end`, and nothing else — no tool calls, no
+ * file edits, not even when the turn demonstrably ran `echo` and wrote a file.
+ * The steps simply aren't reported by the CLI.
+ *
+ * So Loom shows grok's answer and its reasoning, and no tool_call or file_edit
+ * events, because there are none to be had. The alternative — inferring edits by
+ * diffing the tree and attributing them to grok — would put guesses in the event
+ * log wearing the same clothes as facts. The thread stays honest instead: with
+ * grok you see what it said, and `git status` tells you what changed.
+ *
+ * Streaming deltas are deliberately not used. Every Loom message is an event on
+ * a persisted log; one event per token would turn a paragraph into 200 rows.
+ */
+import type { SendInput } from "../types.js";
+import { AdapterBase } from "./base.js";
+export declare function grokBin(override?: string): string | null;
+interface GrokResult {
+    text?: string;
+    thought?: string;
+    stopReason?: string;
+    sessionId?: string;
+    error?: string;
+    message?: string;
+}
+export declare class GrokAdapter extends AdapterBase {
+    private child;
+    private options;
+    constructor(id: string, projectDir: string, options?: Record<string, unknown>);
+    private get sessionId();
+    private set sessionId(value);
+    available(): Promise<boolean>;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    send(input: SendInput): Promise<void>;
+    interrupt(): Promise<void>;
+}
+/**
+ * Pull grok's result object out of stdout.
+ *
+ * It pretty-prints one JSON object, but anything the CLI decides to log first
+ * lands on the same stream, so the object is found rather than assumed: last
+ * balanced `{…}` wins.
+ */
+export declare function parseGrokJson(stdout: string): GrokResult | null;
+export {};