@loompad/cli 0.1.0

package/dist/adapters/grok.js

@@ -0,0 +1,217 @@
+/**
+ * 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 { spawn } from "node:child_process";
+import fs from "node:fs";
+import { readProjectState, writeProjectState } from "../core/registry.js";
+import { AdapterBase, agentEnv, cliAvailable } from "./base.js";
+/** grok's own installer puts it here; it isn't always on PATH. */
+const INSTALLED = [`${process.env.HOME ?? ""}/.grok/bin/grok`];
+export function grokBin(override) {
+    if (override)
+        return fs.existsSync(override) ? override : null;
+    for (const p of INSTALLED) {
+        if (fs.existsSync(p))
+            return p;
+    }
+    return "grok"; // let PATH resolution (and cliAvailable) decide
+}
+export class GrokAdapter extends AdapterBase {
+    child = null;
+    options;
+    constructor(id, projectDir, options = {}) {
+        super(id, "grok-code", projectDir);
+        this.options = options;
+    }
+    get sessionId() {
+        const state = readProjectState(this.projectDir);
+        return state.agents[this.id]?.sessionId;
+    }
+    set sessionId(value) {
+        const state = readProjectState(this.projectDir);
+        state.agents[this.id] = { ...state.agents[this.id], sessionId: value };
+        writeProjectState(this.projectDir, state);
+    }
+    async available() {
+        const bin = grokBin(this.options.bin);
+        if (!bin)
+            return false;
+        return cliAvailable(bin);
+    }
+    async start() {
+        this.emit({ kind: "status", payload: { state: "ready", session: this.sessionId ?? null } });
+    }
+    async stop() {
+        await this.interrupt();
+    }
+    async send(input) {
+        if (this._busy)
+            throw new Error(`grok agent "${this.id}" is busy`);
+        const bin = grokBin(this.options.bin);
+        if (!bin)
+            throw new Error("grok CLI not found — install it from x.ai, or set options.bin");
+        this._busy = true;
+        const started = Date.now();
+        // grok's --rules appends to its system prompt — a real system channel — so
+        // the handoff briefing lands there, authoritative, instead of buried in the
+        // user turn where the model might skim it.
+        const args = [
+            "-p",
+            input.text,
+            "--output-format",
+            "json",
+            "--cwd",
+            this.projectDir,
+            "--permission-mode",
+            this.options.permissionMode ?? "bypassPermissions",
+        ];
+        if (input.briefing?.trim()) {
+            args.push("--rules", `Carried-over session memory from Loom, authoritative for this project — honor it and read any .loom/memory file it points to:\n\n${input.briefing.trim()}`);
+        }
+        if (this.sessionId)
+            args.push("-r", this.sessionId);
+        if (this.options.model)
+            args.push("--model", this.options.model);
+        if (this.options.extraArgs)
+            args.push(...this.options.extraArgs);
+        this.emit({ kind: "status", payload: { state: "turn_started", session: this.sessionId ?? null } });
+        try {
+            await new Promise((resolve, reject) => {
+                const child = spawn(bin, args, {
+                    cwd: this.projectDir,
+                    stdio: ["ignore", "pipe", "pipe"],
+                    env: agentEnv(),
+                });
+                this.child = child;
+                let stdout = "";
+                let stderrTail = "";
+                child.stdout.on("data", (d) => (stdout += d.toString()));
+                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;
+                    }
+                    const result = parseGrokJson(stdout);
+                    if (!result) {
+                        this.emit({
+                            kind: "error",
+                            payload: { message: `grok exited ${code} without a parsable answer`, stderr: stderrTail },
+                        });
+                        reject(new Error(`grok exited ${code}: ${stderrTail.slice(0, 200) || stdout.slice(0, 200)}`));
+                        return;
+                    }
+                    if (result.sessionId)
+                        this.sessionId = result.sessionId;
+                    const err = result.error ?? (code !== 0 ? result.message : undefined);
+                    if (err)
+                        this.emit({ kind: "error", payload: { message: String(err) } });
+                    if (result.thought?.trim()) {
+                        this.emit({ kind: "message", payload: { text: result.thought, reasoning: true } });
+                    }
+                    const answer = (result.text ?? "").trim();
+                    if (answer)
+                        this.emit({ kind: "message", payload: { text: result.text } });
+                    // grok reports why it stopped; a turn that ran out of room is not a
+                    // turn that finished, and silently pretending otherwise hides it.
+                    if (result.stopReason && result.stopReason !== "EndTurn") {
+                        this.emit({
+                            kind: "status",
+                            payload: { state: "stopped_early", reason: result.stopReason },
+                        });
+                    }
+                    if (/\?\s*$/.test(answer)) {
+                        this.emit({ kind: "needs_input", payload: { question: answer.slice(-500) } });
+                    }
+                    this.emit({ kind: "run_complete", payload: { durationMs: Date.now() - started } });
+                    resolve();
+                });
+            });
+        }
+        finally {
+            this._busy = false;
+            this.child = null;
+        }
+    }
+    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();
+            });
+        });
+    }
+}
+/**
+ * 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 function parseGrokJson(stdout) {
+    const trimmed = stdout.trim();
+    if (!trimmed)
+        return null;
+    try {
+        return JSON.parse(trimmed);
+    }
+    catch {
+        // fall through: something else printed to stdout too
+    }
+    const start = trimmed.indexOf("{");
+    const end = trimmed.lastIndexOf("}");
+    if (start < 0 || end <= start)
+        return null;
+    try {
+        return JSON.parse(trimmed.slice(start, end + 1));
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=grok.js.map

package/dist/adapters/grok.js.map

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

package/dist/adapters/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Adapter factory — the one place agent kinds are wired up.
+ * Community adapters register here (or via the SDK entry point).
+ */
+import type { AgentConfig, AnyAgent } from "../types.js";
+export type AgentFactory = (cfg: AgentConfig, projectDir: string) => AnyAgent;
+export declare function registerAgentKind(kind: string, factory: AgentFactory): void;
+export declare function createAgent(cfg: AgentConfig, projectDir: string): AnyAgent;
+export declare function knownAgentKinds(): string[];

package/dist/adapters/index.js

@@ -0,0 +1,33 @@
+/**
+ * Adapter factory — the one place agent kinds are wired up.
+ * Community adapters register here (or via the SDK entry point).
+ */
+import { AntigravityBridge } from "./bridges/antigravity.js";
+import { KiroBridge } from "./bridges/kiro.js";
+import { ClaudeCodeAdapter } from "./claude-code.js";
+import { CodexAdapter } from "./codex.js";
+import { EchoAdapter } from "./echo.js";
+import { GrokAdapter } from "./grok.js";
+import { OpenCodeAdapter } from "./opencode.js";
+const factories = new Map();
+export function registerAgentKind(kind, factory) {
+    factories.set(kind, factory);
+}
+registerAgentKind("echo", (cfg, dir) => new EchoAdapter(cfg.id, "echo", dir));
+registerAgentKind("claude-code", (cfg, dir) => new ClaudeCodeAdapter(cfg.id, dir, cfg.options));
+registerAgentKind("codex", (cfg, dir) => new CodexAdapter(cfg.id, dir, cfg.options));
+registerAgentKind("opencode", (cfg, dir) => new OpenCodeAdapter(cfg.id, dir, cfg.options));
+registerAgentKind("grok-code", (cfg, dir) => new GrokAdapter(cfg.id, dir, cfg.options));
+registerAgentKind("antigravity", (cfg, dir) => new AntigravityBridge(cfg.id, dir, cfg.options));
+registerAgentKind("kiro", (cfg, dir) => new KiroBridge(cfg.id, dir, cfg.options));
+export function createAgent(cfg, projectDir) {
+    const factory = factories.get(cfg.kind);
+    if (!factory) {
+        throw new Error(`unknown agent kind "${cfg.kind}" (known: ${[...factories.keys()].join(", ")})`);
+    }
+    return factory(cfg, projectDir);
+}
+export function knownAgentKinds() {
+    return [...factories.keys()];
+}
+//# sourceMappingURL=index.js.map

package/dist/adapters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAOhD,MAAM,SAAS,GAAG,IAAI,GAAG,EAAwB,CAAC;AAElD,MAAM,UAAU,iBAAiB,CAAC,IAAY,EAAE,OAAqB;IACnE,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAC/B,CAAC;AAED,iBAAiB,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,IAAI,WAAW,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;AAC9E,iBAAiB,CAAC,aAAa,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,IAAI,iBAAiB,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;AAChG,iBAAiB,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,IAAI,YAAY,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;AACrF,iBAAiB,CAAC,UAAU,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,IAAI,eAAe,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;AAC3F,iBAAiB,CAAC,WAAW,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,IAAI,WAAW,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;AACxF,iBAAiB,CAAC,aAAa,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,IAAI,iBAAiB,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;AAChG,iBAAiB,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,IAAI,UAAU,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;AAElF,MAAM,UAAU,WAAW,CAAC,GAAgB,EAAE,UAAkB;IAC9D,MAAM,OAAO,GAAG,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACxC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,uBAAuB,GAAG,CAAC,IAAI,aAAa,CAAC,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAChF,CAAC;IACJ,CAAC;IACD,OAAO,OAAO,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,OAAO,CAAC,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC;AAC/B,CAAC"}

package/dist/adapters/opencode.d.ts

@@ -0,0 +1,64 @@
+/**
+ * OpenCode adapter — manages an `opencode serve` process per project and
+ * speaks its HTTP + SSE API.
+ *
+ *   create session : POST /api/session            → { data: { id: "ses…" } }
+ *   send prompt    : POST /api/session/:id/prompt { prompt: { text } }
+ *   wait for idle  : POST /api/session/:id/wait
+ *   interrupt      : POST /api/session/:id/interrupt
+ *   live events    : GET  /event   (SSE)
+ *
+ * Surface verified against opencode 1.17.20 — see docs/integration-notes.md.
+ */
+import type { SendInput } from "../types.js";
+import { AdapterBase } from "./base.js";
+/** "providerID/modelID" → ModelRef body for session create ({providerID, id}). */
+export declare function parseModelRef(model: string): {
+    providerID: string;
+    id: string;
+} | null;
+export declare class OpenCodeAdapter extends AdapterBase {
+    private child;
+    private baseUrl;
+    private sseAbort;
+    private options;
+    private started;
+    /** text parts per in-flight assistant message */
+    private textParts;
+    private roles;
+    /** assistant messages whose text already went to the log (SSE path) */
+    private emittedText;
+    constructor(id: string, projectDir: string, options?: Record<string, unknown>);
+    private get sessionId();
+    private set sessionId(value);
+    available(): Promise<boolean>;
+    /** Kill a serve child left behind by a previous daemon (verified by cmdline). */
+    private reapOrphanServe;
+    private recordServePid;
+    start(): Promise<void>;
+    private get sessionModel();
+    private set sessionModel(value);
+    /**
+     * A session whose model can't be resolved is a silent trap: opencode
+     * "admits" prompts and never runs them (ModelUnavailableError only shows
+     * in server logs). Validate against /api/model — the list of models the
+     * server can actually run — and fail loudly with suggestions instead.
+     */
+    private assertModelAvailable;
+    private ensureSession;
+    private startSse;
+    private handleSse;
+    /** All messages in the session, oldest first (info objects). */
+    private listMessages;
+    /**
+     * Wait until the TURN is over — not just the first assistant message.
+     * opencode runs a turn as a sequence of assistant messages (one per step),
+     * so completion = the newest message is a completed assistant AND that
+     * fact holds across two consecutive polls (nothing new started).
+     * `/wait` is tried first but returns 503 on 1.17.
+     */
+    private waitForTurn;
+    send(input: SendInput): Promise<void>;
+    interrupt(): Promise<void>;
+    stop(): Promise<void>;
+}