@loompad/cli 0.1.0

package/dist/adapters/base.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Shared adapter plumbing: event fan-out, busy tracking, memory-file
+ * persistence, and small process/http helpers used by concrete adapters.
+ */
+import type { Adapter, AdapterEvent, AgentCapabilities, Bridge, SendInput } from "../types.js";
+type EventCb = (e: AdapterEvent) => void;
+export declare abstract class AgentBase {
+    readonly id: string;
+    readonly kind: string;
+    protected projectDir: string;
+    private listeners;
+    constructor(id: string, kind: string, projectDir: string);
+    onEvent(cb: EventCb): () => void;
+    protected emit(e: AdapterEvent): void;
+    injectMemory(projection: string): Promise<void>;
+}
+export declare abstract class AdapterBase extends AgentBase implements Adapter {
+    readonly capabilities: AgentCapabilities;
+    protected _busy: boolean;
+    busy(): boolean;
+    abstract available(): Promise<boolean>;
+    abstract start(): Promise<void>;
+    abstract stop(): Promise<void>;
+    abstract send(input: SendInput): Promise<void>;
+    abstract interrupt(): Promise<void>;
+    /** Default diff: `git status --porcelain` in the project dir. */
+    diff(): Promise<string>;
+}
+export declare abstract class BridgeBase extends AgentBase implements Bridge {
+    readonly capabilities: AgentCapabilities;
+    abstract available(): Promise<boolean>;
+    abstract start(): Promise<void>;
+    abstract stop(): Promise<void>;
+}
+/**
+ * Wrap a handoff briefing so a CLI with no system channel still treats it as
+ * authoritative.
+ *
+ * The claude adapter passes the briefing through `--append-system-prompt`, and
+ * grok through `--rules` — both real system channels. Codex and opencode have
+ * no per-turn system field, so the same briefing rides in the prompt. Framed
+ * loosely ("here's some context") a model skims past it; framed as a delimited,
+ * imperative directive block it doesn't. The pointer to the full `.loom/memory`
+ * file is preserved from the briefing itself, so the agent can pull detail on
+ * demand rather than being handed the whole store.
+ */
+export declare function frameBriefing(briefing: string): string;
+/**
+ * Env for spawning agent CLIs. When Loom itself runs inside a Claude Code
+ * session (CLAUDECODE=1), the environment carries session-internal plumbing
+ * (CLAUDE_CODE_*, a session-scoped ANTHROPIC_BASE_URL, …) that breaks nested
+ * agent spawns — strip it so child agents auth like a fresh terminal.
+ */
+export declare function agentEnv(): NodeJS.ProcessEnv;
+/**
+ * Is a CLI on PATH (exit 0 for `--version`)?
+ *
+ * Bounded: this sits in front of HTTP handlers (Tasks probes `gh` on every
+ * request), and a version probe that wedges would otherwise hang that request
+ * forever with no response. A CLI that can't say its own version inside the
+ * timeout is unavailable as far as callers are concerned.
+ */
+export declare function cliAvailable(cmd: string, args?: string[], timeoutMs?: number): Promise<boolean>;
+/** Grab an ephemeral free TCP port. */
+export declare function freePort(): Promise<number>;
+export declare function waitFor(probe: () => Promise<boolean>, { timeoutMs, intervalMs }?: {
+    timeoutMs?: number | undefined;
+    intervalMs?: number | undefined;
+}): Promise<void>;
+export declare function fetchJson<T>(url: string, init?: RequestInit, timeoutMs?: number): Promise<T>;
+export {};

package/dist/adapters/base.js

@@ -0,0 +1,187 @@
+/**
+ * Shared adapter plumbing: event fan-out, busy tracking, memory-file
+ * persistence, and small process/http helpers used by concrete adapters.
+ */
+import { spawn } from "node:child_process";
+import net from "node:net";
+import { writeMemoryFile } from "../core/registry.js";
+export class AgentBase {
+    id;
+    kind;
+    projectDir;
+    listeners = new Set();
+    constructor(id, kind, projectDir) {
+        this.id = id;
+        this.kind = kind;
+        this.projectDir = projectDir;
+    }
+    onEvent(cb) {
+        this.listeners.add(cb);
+        return () => this.listeners.delete(cb);
+    }
+    emit(e) {
+        for (const cb of this.listeners) {
+            try {
+                cb(e);
+            }
+            catch {
+                // A broken subscriber must not break the stream.
+            }
+        }
+    }
+    async injectMemory(projection) {
+        writeMemoryFile(this.projectDir, this.id, projection);
+    }
+}
+export class AdapterBase extends AgentBase {
+    capabilities = {
+        tier: "adapter",
+        send: true,
+        stream: true,
+        injectMemory: true,
+        interrupt: true,
+        diff: true,
+    };
+    _busy = false;
+    busy() {
+        return this._busy;
+    }
+    /** Default diff: `git status --porcelain` in the project dir. */
+    async diff() {
+        return new Promise((resolve) => {
+            const child = spawn("git", ["status", "--porcelain"], { cwd: this.projectDir });
+            let out = "";
+            child.stdout.on("data", (d) => (out += d.toString()));
+            child.on("close", () => resolve(out.trim()));
+            child.on("error", () => resolve(""));
+        });
+    }
+}
+export class BridgeBase extends AgentBase {
+    capabilities = {
+        tier: "bridge",
+        send: false,
+        stream: true,
+        injectMemory: true,
+        interrupt: false,
+        diff: false,
+    };
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Wrap a handoff briefing so a CLI with no system channel still treats it as
+ * authoritative.
+ *
+ * The claude adapter passes the briefing through `--append-system-prompt`, and
+ * grok through `--rules` — both real system channels. Codex and opencode have
+ * no per-turn system field, so the same briefing rides in the prompt. Framed
+ * loosely ("here's some context") a model skims past it; framed as a delimited,
+ * imperative directive block it doesn't. The pointer to the full `.loom/memory`
+ * file is preserved from the briefing itself, so the agent can pull detail on
+ * demand rather than being handed the whole store.
+ */
+export function frameBriefing(briefing) {
+    const b = briefing.trim();
+    if (!b)
+        return "";
+    return [
+        "===== LOOM SESSION MEMORY — read this first; it is authoritative =====",
+        "You are continuing shared work handed to you through Loom. The context",
+        "below carries over from the previous agent(s): decisions, conventions and",
+        "constraints already settled for this project. Treat it as ground truth and",
+        "honor it — do not re-open settled choices. Where it points to a",
+        ".loom/memory file, read that file if you need the detail.",
+        "",
+        b,
+        "===== end session memory — the user's message follows =====",
+    ].join("\n");
+}
+/**
+ * Env for spawning agent CLIs. When Loom itself runs inside a Claude Code
+ * session (CLAUDECODE=1), the environment carries session-internal plumbing
+ * (CLAUDE_CODE_*, a session-scoped ANTHROPIC_BASE_URL, …) that breaks nested
+ * agent spawns — strip it so child agents auth like a fresh terminal.
+ */
+export function agentEnv() {
+    if (!process.env.CLAUDECODE)
+        return process.env;
+    const env = { ...process.env };
+    for (const key of Object.keys(env)) {
+        if (key === "CLAUDECODE" ||
+            key.startsWith("CLAUDE_CODE_") ||
+            key === "CLAUDE_AGENT_SDK_VERSION" ||
+            key === "CLAUDE_EFFORT" ||
+            key === "ANTHROPIC_BASE_URL" ||
+            key === "BAGGAGE" ||
+            key === "AI_AGENT") {
+            delete env[key];
+        }
+    }
+    return env;
+}
+/**
+ * Is a CLI on PATH (exit 0 for `--version`)?
+ *
+ * Bounded: this sits in front of HTTP handlers (Tasks probes `gh` on every
+ * request), and a version probe that wedges would otherwise hang that request
+ * forever with no response. A CLI that can't say its own version inside the
+ * timeout is unavailable as far as callers are concerned.
+ */
+export function cliAvailable(cmd, args = ["--version"], timeoutMs = 5_000) {
+    return new Promise((resolve) => {
+        try {
+            const child = spawn(cmd, args, { stdio: "ignore" });
+            const timer = setTimeout(() => {
+                child.kill("SIGKILL");
+                resolve(false);
+            }, timeoutMs);
+            timer.unref();
+            const done = (v) => {
+                clearTimeout(timer);
+                resolve(v);
+            };
+            child.on("close", (code) => done(code === 0));
+            child.on("error", () => done(false));
+        }
+        catch {
+            resolve(false);
+        }
+    });
+}
+/** Grab an ephemeral free TCP port. */
+export function freePort() {
+    return new Promise((resolve, reject) => {
+        const srv = net.createServer();
+        srv.listen(0, "127.0.0.1", () => {
+            const addr = srv.address();
+            if (addr && typeof addr === "object") {
+                const port = addr.port;
+                srv.close(() => resolve(port));
+            }
+            else {
+                srv.close(() => reject(new Error("no port")));
+            }
+        });
+        srv.on("error", reject);
+    });
+}
+export async function waitFor(probe, { timeoutMs = 30_000, intervalMs = 300 } = {}) {
+    const deadline = Date.now() + timeoutMs;
+    while (Date.now() < deadline) {
+        if (await probe().catch(() => false))
+            return;
+        await new Promise((r) => setTimeout(r, intervalMs));
+    }
+    throw new Error("timed out waiting for condition");
+}
+export async function fetchJson(url, init, timeoutMs = 15_000) {
+    const res = await fetch(url, { ...init, signal: AbortSignal.timeout(timeoutMs) });
+    if (!res.ok) {
+        const body = await res.text().catch(() => "");
+        throw new Error(`${init?.method ?? "GET"} ${url} → ${res.status}: ${body.slice(0, 300)}`);
+    }
+    return (await res.json());
+}
+//# sourceMappingURL=base.js.map

package/dist/adapters/base.js.map

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

package/dist/adapters/bridges/antigravity.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Antigravity bridge — presence, and now a way in.
+ *
+ * Antigravity is an Electron app with no API, no headless mode and no way to
+ * talk to it but the DevTools port it opens when you ask for one. Launched with
+ * --remote-debugging-port it speaks CDP, and CDP is enough to see it, type into
+ * its chat and read what comes back. The approach is the one
+ * krishnakanthb13/antigravity_phone_chat takes to put Antigravity on a phone:
+ * don't touch the provider APIs, don't lift the tokens — drive the app that's
+ * already signed in, exactly as a person would.
+ *
+ * It stays a BRIDGE rather than becoming an adapter, and that isn't timidity:
+ *
+ *   - Antigravity edits the tree on its own schedule and knows nothing about
+ *     Loom's baton. Handing it the baton would be a promise Loom can't keep,
+ *     because nothing stops Antigravity from writing while another agent holds
+ *     it. A bridge never holds the baton, so the lock keeps meaning something.
+ *   - What comes back is the chat panel's text, not the model's response. Good
+ *     enough to read; not something to hand to a router as a result.
+ *
+ * So: send with your own hands, read with your own eyes, from anywhere. What
+ * Loom adds is that the thread and the memory projection stay in one place.
+ */
+import { GuiChatDriver } from "./gui-chat.js";
+import { BridgeBase } from "../base.js";
+export declare class AntigravityBridge extends BridgeBase {
+    /**
+     * Sending is real here, unlike a plain bridge. The baton stays out of reach:
+     * tier is what decides that, and it's still "bridge".
+     */
+    readonly capabilities: {
+        tier: "bridge";
+        send: boolean;
+        stream: boolean;
+        injectMemory: boolean;
+        interrupt: boolean;
+        diff: boolean;
+    };
+    protected driver: GuiChatDriver;
+    private pollTimer;
+    constructor(id: string, projectDir: string, options?: Record<string, unknown>, kind?: string, appName?: string);
+    available(): Promise<boolean>;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    /**
+     * Type into the app's chat and report what the panel gained.
+     *
+     * Not part of the Bridge interface — the runtime won't route turns here, and
+     * that's deliberate. It's reachable through the daemon's bridge endpoint for
+     * a human who wants to drive Antigravity from their phone.
+     */
+    ask(text: string): Promise<string>;
+}

package/dist/adapters/bridges/antigravity.js

@@ -0,0 +1,106 @@
+/**
+ * Antigravity bridge — presence, and now a way in.
+ *
+ * Antigravity is an Electron app with no API, no headless mode and no way to
+ * talk to it but the DevTools port it opens when you ask for one. Launched with
+ * --remote-debugging-port it speaks CDP, and CDP is enough to see it, type into
+ * its chat and read what comes back. The approach is the one
+ * krishnakanthb13/antigravity_phone_chat takes to put Antigravity on a phone:
+ * don't touch the provider APIs, don't lift the tokens — drive the app that's
+ * already signed in, exactly as a person would.
+ *
+ * It stays a BRIDGE rather than becoming an adapter, and that isn't timidity:
+ *
+ *   - Antigravity edits the tree on its own schedule and knows nothing about
+ *     Loom's baton. Handing it the baton would be a promise Loom can't keep,
+ *     because nothing stops Antigravity from writing while another agent holds
+ *     it. A bridge never holds the baton, so the lock keeps meaning something.
+ *   - What comes back is the chat panel's text, not the model's response. Good
+ *     enough to read; not something to hand to a router as a result.
+ *
+ * So: send with your own hands, read with your own eyes, from anywhere. What
+ * Loom adds is that the thread and the memory projection stay in one place.
+ */
+import { GuiChatDriver } from "./gui-chat.js";
+import { BridgeBase } from "../base.js";
+import { cdpTargets } from "./cdp.js";
+export class AntigravityBridge extends BridgeBase {
+    /**
+     * Sending is real here, unlike a plain bridge. The baton stays out of reach:
+     * tier is what decides that, and it's still "bridge".
+     */
+    capabilities = {
+        tier: "bridge",
+        send: true,
+        stream: true,
+        injectMemory: true,
+        interrupt: false,
+        diff: false,
+    };
+    driver;
+    pollTimer = null;
+    constructor(id, projectDir, options = {}, kind = "antigravity", appName = "Antigravity") {
+        super(id, kind, projectDir);
+        // The kind picks the profile — which selectors, and which chat panel to
+        // scope the search to. See bridges/profiles.ts.
+        this.driver = new GuiChatDriver(appName, options, kind);
+    }
+    async available() {
+        return this.driver.reachable();
+    }
+    async start() {
+        if (!(await this.driver.reachable())) {
+            this.emit({ kind: "status", payload: { state: "unreachable", hint: this.driver.launchHint } });
+            return;
+        }
+        const targets = await cdpTargets(this.driver.endpoint);
+        // Reachable and driveable are different questions: a signed-out Antigravity
+        // answers CDP cheerfully and has no chat box in it. Say which one it is.
+        const drive = await this.driver.driveable();
+        this.emit({
+            kind: "status",
+            payload: {
+                state: drive.ok ? "ready" : "observed",
+                canSend: drive.ok,
+                ...(drive.ok ? {} : { hint: drive.reason }),
+                targets: targets.filter((t) => t.type === "page").slice(0, 10).map((t) => ({ title: t.title, type: t.type })),
+            },
+        });
+        this.pollTimer = setInterval(() => {
+            void this.driver.reachable().then((ok) => {
+                if (!ok)
+                    this.emit({ kind: "status", payload: { state: "unreachable" } });
+            });
+        }, 60_000);
+        this.pollTimer.unref?.();
+    }
+    async stop() {
+        if (this.pollTimer)
+            clearInterval(this.pollTimer);
+        this.pollTimer = null;
+    }
+    /**
+     * Type into the app's chat and report what the panel gained.
+     *
+     * Not part of the Bridge interface — the runtime won't route turns here, and
+     * that's deliberate. It's reachable through the daemon's bridge endpoint for
+     * a human who wants to drive Antigravity from their phone.
+     */
+    async ask(text) {
+        const started = Date.now();
+        this.emit({ kind: "status", payload: { state: "turn_started", session: null } });
+        try {
+            const reply = await this.driver.ask(text);
+            if (reply.trim())
+                this.emit({ kind: "message", payload: { text: reply } });
+            this.emit({ kind: "run_complete", payload: { durationMs: Date.now() - started } });
+            return reply;
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            this.emit({ kind: "error", payload: { message } });
+            throw err;
+        }
+    }
+}
+//# sourceMappingURL=antigravity.js.map

package/dist/adapters/bridges/antigravity.js.map

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

package/dist/adapters/bridges/cdp.d.ts

@@ -0,0 +1,82 @@
+/**
+ * A small Chrome DevTools Protocol client — enough to drive an Electron agent
+ * app, and nothing more.
+ *
+ * Antigravity and Kiro are Electron apps. Launched with a debugging port they
+ * speak CDP, which is the only interface either of them offers: no API, no
+ * headless mode, no way in but the one the browser gives us. The approach is
+ * the same one krishnakanthb13/antigravity_phone_chat uses to put Antigravity
+ * on a phone — connect over CDP, read the DOM, drive the real widgets.
+ *
+ * Typing goes through Input.insertText rather than assigning to `.value`.
+ * These UIs are React and Monaco: an assignment updates the DOM and the
+ * framework never hears about it, so the app still believes its composer is
+ * empty and sends nothing. insertText enters through the same pipeline a
+ * keyboard does, so the app cannot tell the difference.
+ */
+export interface CdpTarget {
+    id: string;
+    type: string;
+    title?: string;
+    url?: string;
+    webSocketDebuggerUrl?: string;
+}
+/** Is anything listening for CDP at host:port? */
+export declare function cdpUp(endpoint: string, timeoutMs?: number): Promise<boolean>;
+export declare function cdpTargets(endpoint: string, timeoutMs?: number): Promise<CdpTarget[]>;
+/**
+ * The window that holds the app, not its splash screen.
+ *
+ * Antigravity shows a `data:` URL loader for the first seconds after launch and
+ * the workbench arrives later on a different target; picking the first page
+ * gets you an animated ellipsis with no chat in it.
+ */
+export declare function workbenchTarget(targets: CdpTarget[]): CdpTarget | null;
+/**
+ * Every target that could hold a chat, best first.
+ *
+ * A page is not enough. Kiro keeps its chat in a `vscode-webview` target — a
+ * separate CDP target of type `iframe` — so a page-only filter finds the
+ * workbench, reports "no chat panel", and is wrong about the whole app.
+ * Antigravity keeps its chat in its page. Both have to be reachable, so this
+ * returns candidates and the driver asks each one whether a chat is in it.
+ *
+ * Ordering, not exclusion, is the tool here. AntiGravity-AutoAccept drops
+ * http(s) targets outright, because Antigravity's *Manager* is an https page
+ * behind a sign-in with no chat in it — a real trap, and it cost an afternoon.
+ * But "no chat" is a question the driver already asks, and answering it by URL
+ * scheme also throws away any app that legitimately serves its UI over http.
+ * So the Manager sorts last and eliminates itself by having no composer, which
+ * is both true and non-fatal.
+ *
+ * Workers are dropped for real: there is no DOM in one.
+ */
+export declare function chatTargets(targets: CdpTarget[]): CdpTarget[];
+/** One CDP session against one target. */
+export declare class CdpSession {
+    private readonly url;
+    private ws;
+    private nextId;
+    private pending;
+    private constructor();
+    static open(target: CdpTarget, timeoutMs?: number): Promise<CdpSession>;
+    private connect;
+    private onMessage;
+    send<T = unknown>(method: string, params?: Record<string, unknown>, timeoutMs?: number): Promise<T>;
+    /** Evaluate an expression in the page and return it by value. */
+    evaluate<T>(expression: string, timeoutMs?: number): Promise<T>;
+    /** Type text into whatever currently has focus, the way a keyboard would. */
+    insertText(text: string): Promise<void>;
+    /**
+     * Click where a person would.
+     *
+     * `el.focus()` is a request the page can decline — a re-render, an overlay, a
+     * framework that manages focus itself — and when it's declined, Input.insertText
+     * types into whatever else has focus, which is nowhere useful. A real mouse
+     * event at real coordinates is how a human gets the caret into a box, and it
+     * doesn't ask.
+     */
+    clickAt(x: number, y: number): Promise<void>;
+    pressEnter(): Promise<void>;
+    close(): void;
+}