@loompad/cli 0.1.0 → 1.1.1

package/dist/daemon/proof.js

@@ -0,0 +1,172 @@
+/**
+ * Proof, run: check an agent's finished turn (see core/proof.ts for the rules).
+ *
+ * The re-run happens in a clean checkout of exactly what the agent left: a
+ * detached worktree at HEAD, the working tree's tracked changes applied, its
+ * new files copied, and the project's dependency folders linked rather than
+ * reinstalled — so it's the agent's code, not its terminal session, under test.
+ * The verdict lands in the turn's chat as a `proof` event.
+ */
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { randomUUID } from "node:crypto";
+import { promisify } from "node:util";
+import { execFile } from "../core/process.js";
+import { runCommand } from "../core/run-command.js";
+import { detectTestCommand, evidenceFrom, extractClaims, judge, parseCounts } from "../core/proof.js";
+import { loomHome } from "../core/registry.js";
+import { MAIN_CHAT } from "../types.js";
+const exec = promisify(execFile);
+/** Dependency folders a clean checkout borrows from the real one, instead of installing. */
+const DEP_DIRS = ["node_modules", ".venv", "venv", "vendor"];
+export class ProofRunner {
+    host;
+    chain = Promise.resolve();
+    running = new Set();
+    constructor(host) {
+        this.host = host;
+    }
+    /** The newest finished turn in a chat: its agent, final reply, and every event since the request it answered. */
+    turn(chat = MAIN_CHAT, at) {
+        const recent = this.host.list({ chat, limit: 600, ...(at ? { before: at + 1 } : {}) });
+        const doneAt = [...recent].reverse().findIndex((e) => e.kind === "run_complete" && e.agentId);
+        if (doneAt < 0)
+            return null;
+        const di = recent.length - 1 - doneAt;
+        const done = recent[di];
+        const agentId = done.agentId;
+        // the turn starts after the last message that wasn't this agent's reply (the request), or the previous turn's end
+        let start = 0;
+        for (let i = di - 1; i >= 0; i--) {
+            const e = recent[i];
+            if (e.kind === "run_complete" || (e.kind === "message" && !e.agentId)) {
+                start = i + 1;
+                break;
+            }
+        }
+        const events = recent.slice(start, di + 1).filter((e) => !e.agentId || e.agentId === agentId);
+        const reply = [...events].reverse().find((e) => e.kind === "message" && e.agentId === agentId && !e.payload.reasoning && typeof e.payload.text === "string") ?? null;
+        return { agentId, reply, done, events };
+    }
+    /** Should this finished turn be checked without being asked? (Its reply claims something.) */
+    wantsAuto(done) {
+        if ((this.host.config().auto ?? "claims") === "off" || !done.agentId)
+            return false;
+        const t = this.turn(done.chat ?? MAIN_CHAT, done.id);
+        return Boolean(t?.reply && extractClaims(String(t.reply.payload.text)).length);
+    }
+    /** Check the newest finished turn in `chat`. One proof at a time per project; a second ask for the same turn joins the first. */
+    prove(chat = MAIN_CHAT, opts = {}) {
+        this.pending++;
+        const run = this.chain.then(() => this.proveNow(chat, opts));
+        this.chain = run.catch(() => { });
+        void run.finally(() => { this.pending--; }).catch(() => { });
+        return run;
+    }
+    pending = 0;
+    /** A check asked for or running — a Night Shift waits for it before it reports. */
+    get busy() { return this.pending > 0; }
+    async proveNow(chat, opts) {
+        const t = this.turn(chat, opts.at);
+        if (!t)
+            return null;
+        const key = `${chat}:${t.done.id}`;
+        if (this.running.has(key))
+            return null;
+        this.running.add(key);
+        try {
+            const text = t.reply ? String(t.reply.payload.text) : "";
+            const claims = extractClaims(text);
+            const ran = evidenceFrom(t.events);
+            const command = opts.testCommand ?? this.host.config().testCommand ?? detectTestCommand(this.host.dir);
+            const rerun = command ? await this.rerun(command) : null;
+            const result = judge(claims, ran, rerun);
+            const event = this.host.append({ kind: "proof", chat: chat === MAIN_CHAT ? undefined : chat, payload: {
+                    verdict: result.verdict, headline: result.headline, about: t.agentId,
+                    turn: { done: t.done.id, ...(t.reply ? { reply: t.reply.id } : {}) },
+                    claims: result.claims, ran: result.ran.slice(-12),
+                    ...(result.rerun ? { rerun: result.rerun } : {}), ...(opts.auto ? { auto: true } : {}),
+                } });
+            return { ...result, eventId: event.id };
+        }
+        finally {
+            this.running.delete(key);
+        }
+    }
+    /** Run `command` against a clean checkout of the working tree as it is now. */
+    async rerun(command) {
+        const timeoutMs = Math.max(1, this.host.config().timeoutMin ?? 10) * 60_000;
+        const repo = await this.gitRoot();
+        if (!repo) {
+            // not a git checkout: there's no clean copy to make, so it runs where it is (and says so)
+            const r = await runCommand(command, this.host.dir, { timeoutMs, keep: 64_000 });
+            return this.toRerun(command, r, false);
+        }
+        const dir = path.join(loomHome(), "proof", this.host.projectId, randomUUID().slice(0, 8));
+        fs.mkdirSync(path.dirname(dir), { recursive: true });
+        await exec("git", ["worktree", "add", "--detach", "-q", dir, "HEAD"], { cwd: repo });
+        try {
+            await this.copyWorkingTree(repo, dir);
+            for (const dep of DEP_DIRS) {
+                const from = path.join(repo, dep), to = path.join(dir, dep);
+                if (fs.existsSync(from) && !fs.existsSync(to))
+                    fs.symlinkSync(from, to, process.platform === "win32" ? "junction" : "dir");
+            }
+            // where the project sits in the repo, as git sees it — comparing paths ourselves trips on
+            // /private/var vs /var (macOS) and short 8.3 names like RUNNER~1 (Windows)
+            const { stdout: prefix } = await exec("git", ["rev-parse", "--show-prefix"], { cwd: this.host.dir });
+            const sub = prefix.trim().replace(/\/$/, "");
+            const r = await runCommand(command, sub ? path.join(dir, ...sub.split("/")) : dir, { timeoutMs, keep: 64_000 });
+            return this.toRerun(command, r, true);
+        }
+        finally {
+            await exec("git", ["worktree", "remove", "--force", dir], { cwd: repo }).catch(() => fs.rmSync(dir, { recursive: true, force: true }));
+            await exec("git", ["worktree", "prune"], { cwd: repo }).catch(() => { });
+        }
+    }
+    toRerun(command, r, clean) {
+        const counts = parseCounts(r.output);
+        return { command, exitCode: r.exitCode, ok: r.ok, ms: r.ms, tail: r.output.slice(-3000), clean,
+            ...(counts ? { counts } : {}), ...(r.timedOut ? { timedOut: true } : {}) };
+    }
+    async gitRoot() {
+        try {
+            const { stdout } = await exec("git", ["rev-parse", "--show-toplevel"], { cwd: this.host.dir });
+            const root = stdout.trim();
+            return root && (await exec("git", ["rev-parse", "--verify", "HEAD"], { cwd: root }).then(() => true, () => false)) ? root : null;
+        }
+        catch {
+            return null;
+        }
+    }
+    /** The agent's uncommitted work: tracked changes as a patch, new files copied (Loom's own .loom/ excluded). */
+    async copyWorkingTree(repo, dir) {
+        const { stdout: patch } = await exec("git", ["diff", "HEAD", "--binary"], { cwd: repo, maxBuffer: 256 * 1024 * 1024 });
+        if (patch.trim()) {
+            const file = path.join(os.tmpdir(), `loom-proof-${randomUUID().slice(0, 8)}.patch`);
+            fs.writeFileSync(file, patch);
+            try {
+                await exec("git", ["apply", "--binary", "--whitespace=nowarn", file], { cwd: dir });
+            }
+            finally {
+                fs.rmSync(file, { force: true });
+            }
+        }
+        const { stdout: untracked } = await exec("git", ["ls-files", "--others", "--exclude-standard", "-z"], { cwd: repo, maxBuffer: 64 * 1024 * 1024 });
+        for (const rel of untracked.split("\0").filter(Boolean)) {
+            if (rel === ".loom" || rel.startsWith(".loom/"))
+                continue;
+            const from = path.join(repo, rel), to = path.join(dir, rel);
+            const stat = fs.lstatSync(from, { throwIfNoEntry: false });
+            if (!stat)
+                continue;
+            fs.mkdirSync(path.dirname(to), { recursive: true });
+            if (stat.isSymbolicLink())
+                fs.symlinkSync(fs.readlinkSync(from), to);
+            else if (stat.isFile())
+                fs.copyFileSync(from, to);
+        }
+    }
+}
+//# sourceMappingURL=proof.js.map

package/dist/daemon/proof.js.map

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

package/dist/daemon/push.d.ts

@@ -15,8 +15,26 @@ export interface PushMessage {
     body: string;
     data?: Record<string, unknown>;
 }
+/**
+ * What a push is about — the kinds a phone can switch on and off:
+ *   questions  an agent (or a goal, or a crew) is waiting on your answer
+ *   approvals  a tool call is waiting on Allow / Deny, or a crew's plan on approval
+ *   done       an agent finished a turn in a chat of yours
+ *   goals      an Orchestra run, race, crew goal or route finished, failed or needs you
+ *   updates    a new Loom release is out (LoomDaemon.watchReleases)
+ */
+export type PushCategory = "questions" | "approvals" | "done" | "goals" | "updates";
+export declare const PUSH_CATEGORIES: PushCategory[];
 /** Kinds that reach the phone. run_complete is filtered upstream during routes. */
 export declare const PUSH_KINDS: Set<string>;
-export declare function pushContent(projectName: string, event: LoomEvent): PushMessage;
+/** Which category this event pushes under, or null when it doesn't buzz the phone. */
+export declare function pushCategory(event: LoomEvent): PushCategory | null;
+/** May this device get this category? A device that never chose gets them all. */
+export declare function wantsPush(kinds: string[] | undefined, category: PushCategory): boolean;
+/** Does this event buzz the phone? */
+export declare function shouldPush(event: LoomEvent): boolean;
+export declare function pushContent(projectName: string, event: LoomEvent, extra?: {
+    reply?: string;
+}): PushMessage;
 /** Send one message to many devices in a single Expo batch call. Best-effort. */
 export declare function sendExpoPush(tokens: string[], message: PushMessage): Promise<void>;

package/dist/daemon/push.js

@@ -10,16 +10,77 @@
  * (used by tests to point at a mock).
  */
 const EXPO_PUSH_URL = "https://exp.host/--/api/v2/push/send";
+export const PUSH_CATEGORIES = ["questions", "approvals", "done", "goals", "updates"];
 /** Kinds that reach the phone. run_complete is filtered upstream during routes. */
 export const PUSH_KINDS = new Set(["needs_input", "run_complete", "route_completed", "route_failed"]);
-export function pushContent(projectName, event) {
+/** Which category this event pushes under, or null when it doesn't buzz the phone. */
+export function pushCategory(event) {
+    const p = event.payload ?? {};
+    switch (event.kind) {
+        case "needs_input": return "questions";
+        case "run_complete": return "done";
+        // a "done" that didn't hold is news; a verified one repeats the done push
+        case "proof": return p.verdict === "contradicted" ? "done" : null;
+        case "route_completed":
+        case "route_failed": return "goals";
+        // an agent out of quota: the work changed hands, or waits for the reset
+        // an agent out of quota: the work changed hands, or waits for the reset; an agent going in circles needs you
+        case "status": return p.state === "quota_relay" || p.state === "quota_limit" ? "done" : p.state === "loop_detected" || p.state === "shield_tripped" ? "questions" : null;
+        case "approval": return p.phase === "requested" ? "approvals" : null;
+        // the morning report: a night shift's work, done
+        case "shift": return p.phase === "report" ? "goals" : null;
+        case "orchestra":
+            if (p.phase === "alert" || p.phase === "completed" || p.phase === "failed" || p.phase === "aborted")
+                return "goals";
+            return p.phase === "waiting" ? "questions" : null;
+        case "crew":
+            if (p.phase === "paused" || p.phase === "team_hold" || p.phase === "race_ready")
+                return "questions";
+            if (p.phase === "request_received")
+                return "approvals";
+            if (p.phase === "completed" || p.phase === "failed")
+                return "goals";
+            if (p.phase === "asks")
+                return "questions";
+            return p.phase === "planned" && p.awaitingApproval ? "approvals" : null;
+        default: return null;
+    }
+}
+/** May this device get this category? A device that never chose gets them all. */
+export function wantsPush(kinds, category) {
+    return !kinds || kinds.includes(category);
+}
+/** Does this event buzz the phone? */
+export function shouldPush(event) {
+    return pushCategory(event) !== null;
+}
+const clip = (s, n) => String(s ?? "").replace(/\s+/g, " ").trim().slice(0, n);
+export function pushContent(projectName, event, extra = {}) {
     const title = `Loom · ${projectName}`;
     const p = event.payload;
     switch (event.kind) {
         case "needs_input":
-            return { title, body: `${event.agentId} asks: ${String(p.question ?? "").slice(0, 140)}` };
+            return { title: `${event.agentId ?? "An agent"} needs you · ${projectName}`, body: clip(p.question, 160) || "it's waiting on your answer" };
+        case "status":
+            if (p.state === "quota_relay" || p.state === "quota_limit")
+                return { title: `${String(p.from ?? event.agentId ?? "An agent")} ran out of quota · ${projectName}`, body: clip(p.text, 160) };
+            if (p.state === "shield_tripped")
+                return { title: `⛔ ${event.agentId ?? "An agent"} ran ${clip(p.what, 50)} · ${projectName}`,
+                    body: `${clip(p.command, 110)}${p.stopped ? " — Loom stopped the turn" : ""}` };
+            if (p.state === "loop_detected")
+                return { title: `${event.agentId ?? "An agent"} is going in circles · ${projectName}`,
+                    body: `${clip(p.text, 140)}${p.nudged ? " — Loom stopped it and asked it to step back" : " — Stop, Nudge or hand it off"}` };
+            return { title, body: clip(p.text ?? p.state, 160) };
+        case "proof":
+            return { title: `⚠ ${String(p.about ?? "An agent")}'s “done” didn't hold · ${projectName}`, body: clip(p.headline, 160) };
         case "run_complete":
-            return { title, body: `${event.agentId} finished its turn` };
+            return { title: `${event.agentId ?? "An agent"} is done · ${projectName}`, body: extra.reply ? clip(extra.reply, 160) : "finished its turn" };
+        case "approval":
+            return { title: `${event.agentId ?? "An agent"} wants to use ${clip(p.tool, 40)} · ${projectName}`, body: clip(p.input, 140) || "Allow or deny it" };
+        case "shift":
+            if (p.phase === "report")
+                return { title: `🌙 Night shift done · ${projectName}`, body: `${clip(p.summary, 140)}${p.stopped ? ` — stopped: ${clip(p.stopped, 60)}` : ""}` };
+            return { title, body: "night shift started" };
         case "route_completed":
             return { title, body: `✔ route complete (${Number(p.steps ?? 0)} steps)` };
         case "route_failed":
@@ -27,6 +88,32 @@ export function pushContent(projectName, event) {
                 title,
                 body: `${p.aborted ? "⊘ route stopped" : "✗ route failed"}: ${String(p.reason ?? "").slice(0, 120)}`,
             };
+        case "orchestra":
+            if (p.phase === "completed")
+                return { title: `Goal done · ${projectName}`, body: clip(p.summary ?? p.goal, 160) || "the run finished" };
+            if (p.phase === "failed" || p.phase === "aborted")
+                return { title: `Goal ${p.phase} · ${projectName}`, body: clip(p.error ?? p.goal, 160) };
+            if (p.phase === "waiting")
+                return { title: `A goal needs you · ${projectName}`, body: clip(p.question, 160) };
+            return { title, body: String(p.text ?? "a goal needs you").slice(0, 160) };
+        case "crew":
+            if (p.phase === "paused")
+                return { title: `Crew paused · ${projectName}`, body: clip(p.reason, 160) || "Review its budget and resume when ready" };
+            if (p.phase === "team_hold")
+                return { title: `Crew held · ${projectName}`, body: clip(p.hold?.reason, 160) || "Review the overlapping card before continuing" };
+            if (p.phase === "race_ready")
+                return { title: `Choose a crew result · ${projectName}`, body: "The race results are ready for your review" };
+            if (p.phase === "request_received")
+                return { title: `Crew request · ${projectName}`, body: `${clip(p.from, 40)} requests ${clip(p.teammate, 40)}. Accept or decline in Crew.` };
+            if (p.phase === "completed")
+                return { title: `${clip(p.crew, 40) || "Crew"} finished · ${projectName}`, body: clip(p.summary ?? p.text, 160) || "the goal is done — apply it when you're ready" };
+            if (p.phase === "failed")
+                return { title: `${clip(p.crew, 40) || "Crew"} stopped · ${projectName}`, body: clip(p.error, 160) || "the goal failed" };
+            if (p.phase === "asks")
+                return { title: `${clip(p.teammate, 30) || "A teammate"} asks · ${projectName}`, body: clip(p.question, 160) };
+            if (p.phase === "planned")
+                return { title: `${clip(p.crew, 40) || "Crew"} has a plan · ${projectName}`, body: "approve it to start building" };
+            return { title, body: String(p.phase ?? "crew") };
         default:
             return { title, body: event.kind };
     }

package/dist/daemon/push.js.map

@@ -1 +1 @@
-{"version":3,"file":"push.js","sourceRoot":"","sources":["../../src/daemon/push.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,MAAM,aAAa,GAAG,sCAAsC,CAAC;AAQ7D,mFAAmF;AACnF,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,CAAC,aAAa,EAAE,cAAc,EAAE,iBAAiB,EAAE,cAAc,CAAC,CAAC,CAAC;AAEtG,MAAM,UAAU,WAAW,CAAC,WAAmB,EAAE,KAAgB;IAC/D,MAAM,KAAK,GAAG,UAAU,WAAW,EAAE,CAAC;IACtC,MAAM,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC;IACxB,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,aAAa;YAChB,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC,OAAO,UAAU,MAAM,CAAC,CAAC,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC;QAC7F,KAAK,cAAc;YACjB,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC,OAAO,oBAAoB,EAAE,CAAC;QAC/D,KAAK,iBAAiB;YACpB,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,qBAAqB,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,SAAS,EAAE,CAAC;QAC7E,KAAK,cAAc;YACjB,OAAO;gBACL,KAAK;gBACL,IAAI,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,gBAAgB,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE;aACrG,CAAC;QACJ;YACE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;IACvC,CAAC;AACH,CAAC;AAED,iFAAiF;AACjF,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,MAAgB,EAAE,OAAoB;IACvE,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY;QAAE,OAAO;IACvD,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,aAAa,CAAC;IAC5D,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QAChC,EAAE;QACF,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,KAAK,EAAE,SAAS;QAChB,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAChD,CAAC,CAAC,CAAC;IACJ,IAAI,CAAC;QACH,MAAM,KAAK,CAAC,GAAG,EAAE;YACf,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,EAAE,kBAAkB,EAAE;YAC3E,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;YAC3B,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC;SACpC,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,4EAA4E;IAC9E,CAAC;AACH,CAAC"}
+{"version":3,"file":"push.js","sourceRoot":"","sources":["../../src/daemon/push.ts"],"names":[],"mappings":"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"}

package/dist/daemon/relay.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Loom Cloud — the daemon end of the relay.
+ *
+ * Tailscale reaches your machine when the phone is on your tailnet. Loom Cloud
+ * reaches it from anywhere: the daemon joins a Supabase Realtime channel and
+ * answers encrypted requests that arrive there. See core/relay-protocol.ts for
+ * the wire format and why Supabase never sees plaintext.
+ *
+ * The bridge is deliberately dumb. It does not re-implement the API — each
+ * relayed request becomes a real HTTP call against this daemon on loopback,
+ * carrying the phone's own bearer token, and each live stream is a real /ws
+ * connection opened with that token. So pairing, scopes, admin-only routes and
+ * every future endpoint behave identically over the relay and over the LAN.
+ */
+import { type RelayCredentials, type RelayTransport } from "../core/relay-protocol.js";
+export interface CloudSettings {
+    enabled: boolean;
+    channel?: string;
+    key?: string;
+    /** Supabase project; env LOOM_SUPABASE_URL / LOOM_SUPABASE_ANON_KEY win. */
+    supabaseUrl?: string;
+    anonKey?: string;
+}
+export declare function readCloudSettings(): CloudSettings;
+export declare function writeCloudSettings(s: CloudSettings): void;
+/** The Supabase project in effect: env first, then saved settings. */
+export declare function supabaseTarget(s?: CloudSettings): {
+    url: string;
+    anonKey: string;
+} | null;
+export declare function ensureCredentials(s: CloudSettings): RelayCredentials;
+/** Supabase Realtime broadcast — the production transport. */
+export declare function supabaseTransport(url: string, anonKey: string, channel: string): Promise<RelayTransport>;
+/**
+ * An in-process broadcast bus with Supabase's semantics (everyone but the
+ * sender receives, asynchronously, JSON round-tripped). For tests and demos.
+ */
+export declare class MemoryRelayBus {
+    private members;
+    /** Every envelope that crossed the bus, as the relay operator would see it. */
+    readonly wire: unknown[];
+    connect(): RelayTransport;
+}
+export interface RelayBridgeOptions {
+    transport: RelayTransport;
+    key: string;
+    /** http://127.0.0.1:<port> — where relayed requests are executed. */
+    localBase: () => string;
+    identity: () => {
+        version: string;
+        name: string;
+    };
+}
+export declare class RelayBridge {
+    private opts;
+    private key;
+    private decoder;
+    private clients;
+    private sweeper;
+    private closed;
+    /** "<client>:<request id>" → when it was first run (see RelayRequest.ts). */
+    private seen;
+    stats: {
+        requests: number;
+        rejected: number;
+        frames: number;
+        replayed: number;
+    };
+    constructor(opts: RelayBridgeOptions);
+    clientCount(): number;
+    private client;
+    private send;
+    private handle;
+    private request;
+    private forgetSeen;
+    private subscribe;
+    private flush;
+    private unsubscribe;
+    /** A phone that stopped pinging is gone; don't hold a socket open for it. */
+    private sweep;
+    close(): Promise<void>;
+}