@loompad/cli 0.1.0

package/dist/adapters/bridges/gui-chat.js

@@ -0,0 +1,498 @@
+/**
+ * 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.
+ */
+import { CdpSession, cdpTargets, cdpUp, chatTargets } from "./cdp.js";
+import { CHATTY, FORBIDDEN_ANCESTORS, GENERIC, profileFor } from "./profiles.js";
+const MARK = "data-loom-composer";
+/**
+ * Every document this target can reach: its own, plus any same-origin child
+ * frame's.
+ *
+ * Kiro is why. Its chat panel is a `vscode-webview` target whose top document
+ * holds eight nodes and an iframe — VS Code nests the extension's real HTML one
+ * frame deeper, and that inner frame is not a CDP target of its own. Searching
+ * only the top document found nothing and reported "the chat panel has no input
+ * in it", which was true of the document I was looking at and false about Kiro.
+ *
+ * Cross-origin frames throw on contentDocument; they're skipped rather than
+ * fataled, because one unreachable ad frame shouldn't hide a chat box.
+ */
+const DOCS = `
+  const docs = [document];
+  for (const f of document.querySelectorAll("iframe, frame")) {
+    try { if (f.contentDocument) docs.push(f.contentDocument); } catch (e) { /* cross-origin */ }
+  }
+  const findIn = (sel) => {
+    for (const d of docs) {
+      let el = null;
+      try { el = d.querySelector(sel); } catch (e) {}
+      if (el) return el;
+    }
+    return null;
+  };
+  const allIn = (sel) => {
+    const out = [];
+    for (const d of docs) {
+      try { out.push(...d.querySelectorAll(sel)); } catch (e) {}
+    }
+    return out;
+  };
+`;
+/**
+ * Find the composer and stamp it.
+ *
+ * Returns a marker attribute rather than an element handle: the page is a live
+ * React/Lexical tree that re-renders between calls, so a handle goes stale while
+ * an attribute we wrote survives.
+ */
+function discoverExpr(p, explicit) {
+    return `(() => {
+  ${DOCS}
+  const MARK = ${JSON.stringify(MARK)};
+  const forbidden = ${JSON.stringify(FORBIDDEN_ANCESTORS)};
+  const vis = (el) => !!(el.offsetParent || el.getClientRects().length);
+  const banned = (el) => forbidden.some((sel) => el.closest(sel));
+  allIn('[' + MARK + ']').forEach((el) => el.removeAttribute(MARK));
+
+  const explicit = ${explicit ? JSON.stringify(explicit) : "null"};
+  if (explicit) {
+    const el = findIn(explicit);
+    if (!el) return { ok: false, reason: "nothing matches the selector you set: " + explicit };
+    if (banned(el)) return { ok: false, reason: "that selector points inside the code editor" };
+    el.setAttribute(MARK, "1");
+    return { ok: true, how: "your selector" };
+  }
+
+  // The composer is only ever looked for inside the chat panel. This is what
+  // keeps the source editor out of reach — it isn't in here.
+  const roots = ${JSON.stringify(p.chatRoots)};
+  let root = null;
+  for (const sel of roots) {
+    root = findIn(sel);
+    if (root) break;
+  }
+  // No named panel anywhere? A webview whose whole document IS the chat has
+  // nothing to scope to — fall back to its body, which is still not the
+  // workbench and so still can't reach Monaco.
+  if (!root && docs.length > 1) root = docs[docs.length - 1].body;
+  if (!root) {
+    return { ok: false, reason: ${JSON.stringify(`no chat panel in ${p.name} — sign in, and open a chat`)} };
+  }
+
+  ${p.signedOut ? `
+  // A signed-out app is the cruellest failure here: the chat renders, the box
+  // takes text, and the send button is disabled forever. Say so plainly.
+  const panel = (root.innerText || "").replace(/\\s+/g, " ");
+  if (new RegExp(${JSON.stringify(p.signedOut.source)}, "i").test(panel)) {
+    return { ok: false, reason: ${JSON.stringify(`${p.name} is signed out — log in from its window, then try again`)} };
+  }` : ""}
+
+  const found = [...root.querySelectorAll(${JSON.stringify(p.composer)})].filter((el) => vis(el) && !banned(el));
+  if (!found.length) {
+    return { ok: false, reason: "the chat panel has no input in it — is a conversation open?" };
+  }
+
+  // Last visible wins: when a page has several, the live composer is the one at
+  // the bottom of the panel. (antigravity_phone_chat takes .at(-1) too.)
+  let pick = found.at(-1);
+
+  // Generic profile only: with no real chat panel to scope to, the box has to
+  // look like a chat box before we'll type in it.
+  const generic = ${JSON.stringify(p.chatRoots)}.length === 1 && ${JSON.stringify(p.chatRoots[0])} === "body";
+  if (generic) {
+    const chatty = new RegExp(${JSON.stringify(CHATTY.source)}, "i");
+    const labelled = found.filter((el) => chatty.test([
+      el.getAttribute("placeholder"),
+      el.getAttribute("data-placeholder"),
+      el.getAttribute("aria-label"),
+      el.getAttribute("title"),
+    ].filter(Boolean).join(" ")));
+    if (labelled.length !== 1) {
+      return {
+        ok: false,
+        reason: labelled.length
+          ? labelled.length + " things look like a chat box; name one with options.selectors.composer"
+          : found.length + " editable areas, none labelled like a chat box; name one with options.selectors.composer",
+      };
+    }
+    pick = labelled[0];
+  }
+
+  pick.setAttribute(MARK, "1");
+  return { ok: true, how: "profile" };
+})()`;
+}
+/**
+ * Focus the composer and select whatever is in it, so the next keystroke
+ * replaces it.
+ *
+ * Selecting the node's *contents* rather than calling execCommand("selectAll")
+ * is deliberate: selectAll acts on whatever the document considers selected,
+ * and if that isn't scoped to the box it's scoped to the page. A range over the
+ * editor's contents can only ever affect the editor. It doubles as the clear —
+ * inserting replaces a selection, so there's nothing to delete first.
+ */
+function focusExpr(p) {
+    return `(() => {
+  ${DOCS}
+  const MARK = ${JSON.stringify(MARK)};
+  const vis = (el) => !!(el && (el.offsetParent || el.getClientRects().length));
+
+  ${p.busy ? `const busy = findIn(${JSON.stringify(p.busy)});
+  if (vis(busy)) return { ok: false, reason: "busy" };` : ""}
+
+  const editor = findIn('[' + MARK + ']');
+  if (!editor) return { ok: false, reason: "the composer went away" };
+
+  editor.scrollIntoView({ block: "center" });
+  editor.focus();
+  try {
+    const range = document.createRange();
+    range.selectNodeContents(editor);
+    const sel = window.getSelection();
+    sel.removeAllRanges();
+    sel.addRange(range);
+  } catch {}
+
+  // Hand back where it is, so a caller that finds focus didn't take can click
+  // it like a person would.
+  const r = editor.getBoundingClientRect();
+  return {
+    ok: true,
+    focused: document.activeElement === editor || editor.contains(document.activeElement),
+    x: Math.round(r.left + r.width / 2),
+    y: Math.round(r.top + r.height / 2),
+  };
+})()`;
+}
+/**
+ * Submit, having typed.
+ *
+ * Also the fallback path: if CDP's typing didn't land (the box is still empty),
+ * try the page's own editing command, and failing that assign and synthesise
+ * the events by hand. Each rung down is less like real typing and less likely
+ * to convince a framework, which is why they're in this order.
+ */
+function submitExpr(p, text, sendSel) {
+    // JSON.stringify handles quotes, newlines, backslashes and unicode. This is a
+    // string being pasted into a program being pasted into a browser; nothing else
+    // is safe enough.
+    const safe = JSON.stringify(text);
+    // Deliberately NOT async, and with no requestAnimationFrame in it.
+    //
+    // This used to await two rAFs to let the framework commit the edit before
+    // clicking submit. rAF does not fire in a window that is occluded or
+    // backgrounded — so against a real Antigravity sitting behind other windows
+    // the promise never settled and Runtime.evaluate hung until it timed out.
+    // Which is the whole use case: the app is in the background and you're on
+    // your phone. The settle wait happens on the Node side now, where a timer is
+    // a timer.
+    return `(() => {
+  ${DOCS}
+  const MARK = ${JSON.stringify(MARK)};
+  const editor = findIn('[' + MARK + ']');
+  if (!editor) return { ok: false, reason: "the composer went away" };
+  const text = ${safe};
+
+  // If the typing didn't land, synthesise the same events by hand — including
+  // beforeinput, which is the one that matters. execCommand("insertText") is
+  // deliberately NOT the fallback: measured here, it fires only \`input\`, so it
+  // fills the box while leaving a beforeinput-driven editor (Lexical, and this
+  // is what Antigravity uses) still believing it's empty. That's worse than
+  // failing, because the box then LOOKS full and every check downstream passes
+  // while the send button quietly does nothing.
+  let how = "typed";
+  if (!(editor.innerText || editor.value || "").trim()) {
+    how = "synthesised";
+    if ("value" in editor) editor.value = text; else editor.textContent = text;
+    editor.dispatchEvent(new InputEvent("beforeinput", { bubbles: true, inputType: "insertText", data: text }));
+    editor.dispatchEvent(new InputEvent("input", { bubbles: true, inputType: "insertText", data: text }));
+  }
+
+  const explicit = ${sendSel ? JSON.stringify(sendSel) : "null"};
+  const candidates = explicit ? [explicit] : ${JSON.stringify(p.send)};
+  let sawDisabled = false;
+  for (const sel of candidates) {
+    const el = findIn(sel);
+    if (!el) continue;
+    const btn = el.closest("button") || (el.tagName === "BUTTON" ? el : null) || el;
+    if (btn.disabled) { sawDisabled = true; continue; }
+    btn.click();
+    return { ok: true, how: how + " → clicked " + sel };
+  }
+
+  // The app's own send button, disabled with text in the box, is the app
+  // telling us it won't send — a dead account, a missing model, a turn already
+  // running. Pressing Enter at that point pretends we didn't hear.
+  if (sawDisabled) {
+    return { ok: false, reason: "the send button is disabled — is it signed in, with a model selected?" };
+  }
+
+  // Most of them submit on Enter anyway.
+  editor.dispatchEvent(new KeyboardEvent("keydown", { bubbles: true, key: "Enter", code: "Enter" }));
+  editor.dispatchEvent(new KeyboardEvent("keyup", { bubbles: true, key: "Enter", code: "Enter" }));
+  return { ok: true, how: how + " → enter" };
+})()`;
+}
+/**
+ * Read the conversation, minus the box you type into.
+ *
+ * The composer lives *inside* the transcript container in Antigravity
+ * (`#conversation` holds both), so a naive innerText includes whatever is
+ * currently typed. The reply is computed as a diff of this text, which meant
+ * the "reply" was your own prompt sitting in the box — every ask returned what
+ * you just said. The composer is cloned out before reading.
+ */
+function transcriptExpr(p, explicit) {
+    const roots = explicit ? [explicit] : p.transcript;
+    return `(() => {
+  ${DOCS}
+  const roots = ${JSON.stringify(roots)};
+  const composerish = ['[data-lexical-editor]', '[contenteditable="true"]', 'textarea', '[data-loom-composer]'];
+  for (const sel of roots) {
+    const el = findIn(sel);
+    if (!el) continue;
+    const doc = el.ownerDocument;
+    const clone = el.cloneNode(true);
+    composerish.forEach((c) => clone.querySelectorAll(c).forEach((n) => n.remove()));
+    // innerText needs layout, which a detached node has none of; attach it
+    // offscreen for the read rather than settling for textContent, which would
+    // glue every word together and make the diff meaningless.
+    clone.style.position = 'fixed';
+    clone.style.left = '-99999px';
+    clone.style.top = '0';
+    doc.body.appendChild(clone);
+    const text = (clone.innerText || "").slice(-20000);
+    clone.remove();
+    return text;
+  }
+  const last = docs[docs.length - 1];
+  return (last.body ? last.body.innerText || "" : "").slice(-20000);
+})()`;
+}
+export class GuiChatDriver {
+    options;
+    profile;
+    appName;
+    /** The target that had the chat last time; tried first, never trusted. */
+    lastTargetId = null;
+    constructor(appName, options, kind) {
+        this.options = options;
+        this.profile = profileFor(kind ?? appName.toLowerCase());
+        // The profile knows the app's real name; "Antigravity" is the other program.
+        this.appName = this.profile === GENERIC ? appName : this.profile.name;
+    }
+    get endpoint() {
+        const host = this.options.host ?? "127.0.0.1";
+        const port = this.options.debugPort ?? this.profile.defaultPort;
+        return `http://${host}:${port}`;
+    }
+    /** How to start this app with a debugger, on this OS. */
+    get launchHint() {
+        const os = process.platform;
+        const how = this.profile.launch[os === "win32" ? "win32" : os === "darwin" ? "darwin" : "linux"];
+        return `${this.appName} isn't listening — ${how}`;
+    }
+    reachable() {
+        return cdpUp(this.endpoint);
+    }
+    /**
+     * 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.
+     */
+    async session() {
+        const targets = chatTargets(await cdpTargets(this.endpoint));
+        if (!targets.length)
+            throw new Error(`${this.appName} is running but has no window to talk to`);
+        const ordered = this.lastTargetId
+            ? [...targets].sort((a, b) => (a.id === this.lastTargetId ? -1 : b.id === this.lastTargetId ? 1 : 0))
+            : targets;
+        let firstReason;
+        for (const target of ordered) {
+            let session;
+            try {
+                session = await CdpSession.open(target, 4000);
+            }
+            catch {
+                continue; // a target that won't attach isn't the one
+            }
+            try {
+                const found = await session.evaluate(discoverExpr(this.profile, this.options.selectors?.composer), 8000);
+                if (found.ok) {
+                    this.lastTargetId = target.id;
+                    return { session, found };
+                }
+                firstReason ??= found.reason;
+            }
+            catch {
+                /* this target can't answer; try the next */
+            }
+            session.close();
+        }
+        throw new Error(firstReason ?? `no chat panel in ${this.appName}`);
+    }
+    /**
+     * 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.
+     */
+    async driveable() {
+        if (!(await this.reachable()))
+            return { ok: false, reason: this.launchHint };
+        let session = null;
+        try {
+            ({ session } = await this.session());
+            return { ok: true };
+        }
+        catch (err) {
+            return { ok: false, reason: err instanceof Error ? err.message : String(err) };
+        }
+        finally {
+            session?.close();
+        }
+    }
+    /**
+     * 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.
+     */
+    async ask(text, onProgress) {
+        // session() finds the target whose chat exists and marks the composer in it
+        const { session } = await this.session();
+        try {
+            const before = await session.evaluate(transcriptExpr(this.profile, this.options.selectors?.transcript));
+            const focused = await session.evaluate(focusExpr(this.profile));
+            if (!focused.ok) {
+                throw new Error(focused.reason === "busy"
+                    ? `${this.appName} is already working on something — let it finish or stop it there`
+                    : `can't focus ${this.appName}'s chat box: ${focused.reason}`);
+            }
+            // focus() is a request, and sometimes the page says no — a re-render, a
+            // framework that owns focus. When it does, click the box like a person
+            // and re-select. This is what made the second ask in a session flaky:
+            // typing went somewhere else, silently.
+            if (!focused.focused && focused.x !== undefined && focused.y !== undefined) {
+                await session.clickAt(focused.x, focused.y);
+                await session.evaluate(focusExpr(this.profile));
+            }
+            // Type through the browser's own input pipeline. This matters more than
+            // it looks: measured in a real Chromium, execCommand("insertText") fires
+            // only `input`, while Input.insertText fires `beforeinput` AND `input` —
+            // which is what a keyboard does, and what an editor like Lexical builds
+            // its model from. Typing with execCommand filled the box visually and
+            // left the app believing it was empty, so the send button did nothing.
+            await session.insertText(text);
+            // Let the framework commit the edit before asking it to submit; without
+            // this the send button is still disabled from when the box was empty.
+            // The wait lives here rather than inside the page because the page may be
+            // in a background window, where rAF never fires and an awaited evaluate
+            // hangs forever. A setTimeout out here always fires.
+            await new Promise((r) => setTimeout(r, 120));
+            const sent = await session.evaluate(submitExpr(this.profile, text, this.options.selectors?.send));
+            if (!sent.ok)
+                throw new Error(`couldn't send to ${this.appName}: ${sent.reason}`);
+            return await this.waitForReply(session, before, onProgress);
+        }
+        finally {
+            session.close();
+        }
+    }
+    /** Poll until the transcript stops changing, or we run out of patience. */
+    async waitForReply(session, before, onProgress) {
+        const timeout = this.options.replyTimeoutMs ?? 300_000;
+        const settle = this.options.settleMs ?? 2500;
+        const deadline = Date.now() + timeout;
+        const expr = transcriptExpr(this.profile, this.options.selectors?.transcript);
+        let last = before;
+        let lastChange = Date.now();
+        while (Date.now() < deadline) {
+            await new Promise((r) => setTimeout(r, 500));
+            let now;
+            try {
+                now = await session.evaluate(expr);
+            }
+            catch {
+                break; // the window went away mid-answer
+            }
+            if (now !== last) {
+                last = now;
+                lastChange = Date.now();
+                onProgress?.(delta(before, now));
+            }
+            else if (last !== before && Date.now() - lastChange > settle) {
+                return delta(before, last);
+            }
+        }
+        const out = delta(before, last);
+        if (out)
+            return out;
+        throw new Error(`${this.appName} didn't answer within ${Math.round(timeout / 1000)}s`);
+    }
+}
+/**
+ * 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 function delta(before, after) {
+    if (after.startsWith(before))
+        return after.slice(before.length).trim();
+    let i = 0;
+    while (i < before.length && i < after.length && before[i] === after[i])
+        i++;
+    return after.slice(i).trim();
+}
+//# sourceMappingURL=gui-chat.js.map

package/dist/adapters/bridges/gui-chat.js.map

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

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

@@ -0,0 +1,19 @@
+/**
+ * Kiro bridge — the same shape as Antigravity, because the situation is the
+ * same shape: an Electron app (a VS Code fork) whose agent lives in a panel and
+ * offers nothing to talk to but its DevTools port.
+ *
+ * The `code` CLI inside Kiro.app is VS Code's, not an agent interface — it
+ * opens files and installs extensions. It cannot ask Kiro anything, so it isn't
+ * used here.
+ *
+ * The Monaco hazard is at its sharpest in this one. Kiro's window is a code
+ * editor first: on launch its only contenteditable IS your source file. The
+ * driver refuses to type into anything under .monaco-editor for exactly this
+ * reason — see gui-chat.ts. Open the Kiro chat panel before expecting this to
+ * find anything.
+ */
+import { AntigravityBridge } from "./antigravity.js";
+export declare class KiroBridge extends AntigravityBridge {
+    constructor(id: string, projectDir: string, options?: Record<string, unknown>);
+}

package/dist/adapters/bridges/kiro.js

@@ -0,0 +1,22 @@
+/**
+ * Kiro bridge — the same shape as Antigravity, because the situation is the
+ * same shape: an Electron app (a VS Code fork) whose agent lives in a panel and
+ * offers nothing to talk to but its DevTools port.
+ *
+ * The `code` CLI inside Kiro.app is VS Code's, not an agent interface — it
+ * opens files and installs extensions. It cannot ask Kiro anything, so it isn't
+ * used here.
+ *
+ * The Monaco hazard is at its sharpest in this one. Kiro's window is a code
+ * editor first: on launch its only contenteditable IS your source file. The
+ * driver refuses to type into anything under .monaco-editor for exactly this
+ * reason — see gui-chat.ts. Open the Kiro chat panel before expecting this to
+ * find anything.
+ */
+import { AntigravityBridge } from "./antigravity.js";
+export class KiroBridge extends AntigravityBridge {
+    constructor(id, projectDir, options = {}) {
+        super(id, projectDir, options, "kiro", "Kiro");
+    }
+}
+//# sourceMappingURL=kiro.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"kiro.js","sourceRoot":"","sources":["../../../src/adapters/bridges/kiro.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAErD,MAAM,OAAO,UAAW,SAAQ,iBAAiB;IAC/C,YAAY,EAAU,EAAE,UAAkB,EAAE,UAAmC,EAAE;QAC/E,KAAK,CAAC,EAAE,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACjD,CAAC;CACF"}

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

@@ -0,0 +1,82 @@
+/**
+ * What each GUI agent's chat is made of.
+ *
+ * Read off the running apps, with two projects' work behind them:
+ * krishnakanthb13/antigravity_phone_chat for the shape of Antigravity's chat,
+ * and yazanbaker94/AntiGravity-AutoAccept for how to attach to it at all. Both
+ * MIT, both doing this daily against real installs.
+ *
+ * Everything here was then checked against Antigravity IDE 1.107.0 on this
+ * machine, and the checking mattered — two of the borrowed selectors are gone
+ * in this build, and the app that matters isn't the one with the obvious name.
+ *
+ * The scoping is the important idea, and it's from the phone-chat project. The
+ * composer is looked for *inside* `#conversation` — never in the document at
+ * large. These are VS Code-family apps and Monaco, the editor holding your
+ * source file, is a `contenteditable`. Hunt the document and you will
+ * eventually find it and type a prompt into someone's code. Search inside the
+ * chat panel and you cannot.
+ *
+ * Selectors rot; two already did. When they stop matching, the bridge says so
+ * rather than improvising, and `options.selectors` overrides any of it without
+ * waiting for a release.
+ */
+export interface AppProfile {
+    /** For messages. */
+    name: string;
+    /**
+     * The debugging port to expect by default.
+     *
+     * 9333 for Antigravity, not the usual 9222: Antigravity's own Browser Control
+     * (the Chrome button in its toolbar) already uses 9222, and asking for it
+     * gives you EADDRINUSE and an IDE with no debugger. That's the AutoAccept
+     * extension's finding, and it's worth every word of this comment — it cost an
+     * hour here, launching an IDE that silently never got a port while a stale
+     * process held it.
+     */
+    defaultPort: number;
+    /** How to start it with a debugger, per platform. */
+    launch: {
+        darwin: string;
+        win32: string;
+        linux: string;
+    };
+    /**
+     * The chat panel. The composer is only ever looked for inside one of these,
+     * which is what keeps Monaco out of reach.
+     */
+    chatRoots: string[];
+    /** The composer, within the root. */
+    composer: string;
+    /**
+     * The submit control, tried in order. Each is matched then walked up to its
+     * closest button — Antigravity's arrow is an svg inside one.
+     */
+    send: string[];
+    /** Visible ⇒ a turn is already running and the composer isn't yours. */
+    busy?: string;
+    /** Where the conversation is rendered, for reading replies back. */
+    transcript: string[];
+    /**
+     * Text the panel shows when the app is signed out.
+     *
+     * Worth a field of its own, because a signed-out app fails in a way that
+     * mimics a broken driver: the chat renders, the composer takes text happily,
+     * and the send button is simply disabled forever. Without this, the honest
+     * report is "we typed and nothing happened", which sends you debugging the
+     * wrong thing — as it did here for an hour. With it, the report is "log in".
+     */
+    signedOut?: RegExp;
+}
+/** Anything under one of these is never a composer, whatever else it looks like. */
+export declare const FORBIDDEN_ANCESTORS: string[];
+export declare const PROFILES: Record<string, AppProfile>;
+/**
+ * When we don't know the app: no chat root to scope to, so the composer has to
+ * earn it by being labelled like one, and Monaco is excluded explicitly rather
+ * than structurally. Strictly worse than a profile — that's why profiles exist.
+ */
+export declare const GENERIC: AppProfile;
+/** What a chat box calls itself, for the generic path only. */
+export declare const CHATTY: RegExp;
+export declare function profileFor(kind: string): AppProfile;