@loompad/cli 0.1.0

package/dist/adapters/bridges/cdp.js

@@ -0,0 +1,222 @@
+/**
+ * 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.
+ */
+import WebSocket from "ws";
+import { fetchJson } from "../base.js";
+/** Is anything listening for CDP at host:port? */
+export async function cdpUp(endpoint, timeoutMs = 2000) {
+    try {
+        await fetchJson(`${endpoint}/json/version`, undefined, timeoutMs);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export async function cdpTargets(endpoint, timeoutMs = 3000) {
+    return fetchJson(`${endpoint}/json`, undefined, timeoutMs).catch(() => []);
+}
+/**
+ * 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 function workbenchTarget(targets) {
+    return chatTargets(targets)[0] ?? 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 function chatTargets(targets) {
+    const usable = targets.filter((t) => {
+        if (!t.webSocketDebuggerUrl)
+            return false;
+        const url = String(t.url ?? "");
+        if (!url || url === "about:blank")
+            return false;
+        if (t.type === "service_worker" || t.type === "worker" || t.type === "shared_worker")
+            return false;
+        return t.type === "page" || t.type === "iframe" || url.includes("webview");
+    });
+    const rank = (t) => {
+        const url = String(t.url ?? "");
+        if (url.startsWith("data:"))
+            return 4; // a splash screen
+        if (url.startsWith("http://") || url.startsWith("https://"))
+            return 3; // probably a Manager
+        if (url.includes("webview"))
+            return 1; // where a panel's chat tends to live
+        return 0;
+    };
+    return [...usable].sort((a, b) => rank(a) - rank(b));
+}
+/** One CDP session against one target. */
+export class CdpSession {
+    url;
+    ws = null;
+    nextId = 1;
+    pending = new Map();
+    constructor(url) {
+        this.url = url;
+    }
+    static async open(target, timeoutMs = 5000) {
+        if (!target.webSocketDebuggerUrl)
+            throw new Error("target has no debugger url");
+        const session = new CdpSession(target.webSocketDebuggerUrl);
+        await session.connect(timeoutMs);
+        return session;
+    }
+    connect(timeoutMs) {
+        return new Promise((resolve, reject) => {
+            const ws = new WebSocket(this.url, { maxPayload: 64 * 1024 * 1024 });
+            this.ws = ws;
+            const timer = setTimeout(() => {
+                ws.terminate();
+                reject(new Error("timed out connecting to the app's debugger"));
+            }, timeoutMs);
+            ws.on("open", () => {
+                clearTimeout(timer);
+                resolve();
+            });
+            ws.on("error", (err) => {
+                clearTimeout(timer);
+                reject(err instanceof Error ? err : new Error(String(err)));
+            });
+            ws.on("message", (raw) => this.onMessage(String(raw)));
+            ws.on("close", () => {
+                // Nothing else is coming; don't leave callers hanging forever.
+                for (const [, p] of this.pending)
+                    p.reject(new Error("debugger connection closed"));
+                this.pending.clear();
+            });
+        });
+    }
+    onMessage(raw) {
+        let msg;
+        try {
+            msg = JSON.parse(raw);
+        }
+        catch {
+            return;
+        }
+        if (typeof msg.id !== "number")
+            return; // an event, not our reply
+        const p = this.pending.get(msg.id);
+        if (!p)
+            return;
+        this.pending.delete(msg.id);
+        if (msg.error)
+            p.reject(new Error(msg.error.message ?? "cdp error"));
+        else
+            p.resolve(msg.result);
+    }
+    send(method, params = {}, timeoutMs = 15_000) {
+        const ws = this.ws;
+        if (!ws || ws.readyState !== WebSocket.OPEN) {
+            return Promise.reject(new Error("debugger not connected"));
+        }
+        const id = this.nextId++;
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                this.pending.delete(id);
+                reject(new Error(`${method} timed out`));
+            }, timeoutMs);
+            this.pending.set(id, {
+                resolve: (v) => {
+                    clearTimeout(timer);
+                    resolve(v);
+                },
+                reject: (e) => {
+                    clearTimeout(timer);
+                    reject(e);
+                },
+            });
+            ws.send(JSON.stringify({ id, method, params }));
+        });
+    }
+    /** Evaluate an expression in the page and return it by value. */
+    async evaluate(expression, timeoutMs = 15_000) {
+        const res = await this.send("Runtime.evaluate", { expression, returnByValue: true, awaitPromise: true }, timeoutMs);
+        if (res.exceptionDetails) {
+            const detail = res.exceptionDetails.exception?.description ?? res.exceptionDetails.text;
+            throw new Error(`page threw: ${String(detail).slice(0, 300)}`);
+        }
+        return res.result?.value;
+    }
+    /** Type text into whatever currently has focus, the way a keyboard would. */
+    async insertText(text) {
+        await this.send("Input.insertText", { text });
+    }
+    /**
+     * 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.
+     */
+    async clickAt(x, y) {
+        const base = { x, y, button: "left", clickCount: 1 };
+        await this.send("Input.dispatchMouseEvent", { ...base, type: "mousePressed" });
+        await this.send("Input.dispatchMouseEvent", { ...base, type: "mouseReleased" });
+    }
+    async pressEnter() {
+        for (const type of ["keyDown", "keyUp"]) {
+            await this.send("Input.dispatchKeyEvent", {
+                type,
+                key: "Enter",
+                code: "Enter",
+                windowsVirtualKeyCode: 13,
+                nativeVirtualKeyCode: 13,
+                text: type === "keyDown" ? "\r" : undefined,
+            });
+        }
+    }
+    close() {
+        const ws = this.ws;
+        this.ws = null;
+        if (!ws)
+            return;
+        try {
+            ws.removeAllListeners();
+            ws.on("error", () => { });
+            ws.terminate();
+        }
+        catch {
+            /* already gone */
+        }
+    }
+}
+//# sourceMappingURL=cdp.js.map

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

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

package/dist/adapters/bridges/gui-chat.d.ts

@@ -0,0 +1,113 @@
+/**
+ * Driving a GUI agent's chat box over CDP.
+ *
+ * Shared by the Antigravity and Kiro bridges, because the problem is identical:
+ * an Electron app with a chat panel, no API, and a DOM we can reach.
+ *
+ * The approach — and most of the hard-won detail — comes from two projects that
+ * do this for real every day: krishnakanthb13/antigravity_phone_chat for the
+ * shape of the chat, yazanbaker94/AntiGravity-AutoAccept for how to attach.
+ * Both MIT. Connect over CDP, find the composer inside the chat panel, type
+ * through the browser's own input pipeline, click the app's own submit button.
+ * Never touch the provider APIs, never lift a token: drive the app that's
+ * already signed in, the way a person would.
+ *
+ * ## Why Input.insertText and not `el.textContent = …`
+ *
+ * Antigravity's composer is a Lexical editor; Kiro's is React. Both keep their
+ * own model of the text and only update it when the browser tells them about an
+ * edit. Assigning to the DOM changes what you see and nothing else — the app
+ * still believes the box is empty and submits nothing.
+ *
+ * CDP's `Input.insertText` is what's used, and the choice was measured rather
+ * than assumed. In a real Chromium:
+ *
+ *   document.execCommand("insertText")  → fires `input` only
+ *   Input.insertText (CDP)              → fires `beforeinput` AND `input`
+ *
+ * `beforeinput` is the one an editor builds its model from, so execCommand is
+ * the worse tool despite being the obvious one — it fills the box while leaving
+ * the app convinced it's empty, which then looks like a send bug. It survives
+ * only as a fallback, after synthesising the events by hand.
+ *
+ * ## Why it refuses
+ *
+ * Both apps are VS Code family, and Monaco — the editor holding YOUR SOURCE
+ * FILE — is a `contenteditable`. A driver that hunts the document for something
+ * editable will eventually find that one, type a prompt into your code and press
+ * Enter. No error message repairs that afterwards.
+ *
+ * So the composer is only ever looked for *inside* the chat panel
+ * (profiles.ts), never in the document at large; anything under `.monaco-editor`
+ * is excluded even then; and no match, or an ambiguous one, is a refusal that
+ * names the fix. Not sending is a bad outcome. Sending into the wrong box is a
+ * worse one.
+ */
+export interface GuiChatSelectors {
+    /** CSS selector for the chat input. Set this when discovery can't. */
+    composer?: string;
+    /** CSS selector for the submit button. Falls back to pressing Enter. */
+    send?: string;
+    /** CSS selector for the transcript container, to read replies from. */
+    transcript?: string;
+}
+export interface GuiChatOptions {
+    host?: string;
+    debugPort?: number;
+    selectors?: GuiChatSelectors;
+    /** How long a reply may take before we stop waiting. */
+    replyTimeoutMs?: number;
+    /** Quiet time that means "it stopped typing". */
+    settleMs?: number;
+}
+export declare class GuiChatDriver {
+    private readonly options;
+    private profile;
+    private readonly appName;
+    /** The target that had the chat last time; tried first, never trusted. */
+    private lastTargetId;
+    constructor(appName: string, options: GuiChatOptions, kind?: string);
+    get endpoint(): string;
+    /** How to start this app with a debugger, on this OS. */
+    get launchHint(): string;
+    reachable(): Promise<boolean>;
+    /**
+     * A session on the target that actually has the chat in it.
+     *
+     * There is usually more than one candidate and the right one isn't
+     * predictable from the app: Antigravity's chat is in its page, Kiro's is in a
+     * webview target. So every candidate is asked "is there a composer here?" and
+     * the first that says yes wins. The answer is remembered — the targets don't
+     * move around between two calls a second apart — but it's re-derived whenever
+     * that target has gone.
+     */
+    private session;
+    /**
+     * Can we actually drive it right now? Reachable is not enough: a signed-out
+     * Antigravity answers CDP happily and has no chat in it at all.
+     */
+    driveable(): Promise<{
+        ok: boolean;
+        reason?: string;
+    }>;
+    /**
+     * Type a prompt into the app, submit it, and wait for the panel to stop
+     * growing.
+     *
+     * What comes back is the panel's text, not the model's response object —
+     * these apps render their conversation, they don't hand it out. Same trade
+     * the phone-chat project makes: mirror what's on screen rather than pretend
+     * to have something structured.
+     */
+    ask(text: string, onProgress?: (partial: string) => void): Promise<string>;
+    /** Poll until the transcript stops changing, or we run out of patience. */
+    private waitForReply;
+}
+/**
+ * What the panel gained.
+ *
+ * Not a real diff: the transcript is a rendered panel that scrolls, collapses
+ * and reflows. When `after` simply grew, the tail is the new part; when it
+ * changed shape, the common prefix is the best we can honestly do.
+ */
+export declare function delta(before: string, after: string): string;