@loompad/cli 0.1.0 → 1.1.2

package/dist/core/registry.d.ts

@@ -9,8 +9,21 @@ export declare function loomHome(): string;
 export declare function ensureLoomHome(): string;
 export declare function newId(bytes?: number): string;
 export declare function listProjects(): ProjectInfo[];
+/**
+ * A directory as the filesystem knows it: absolute, with symlinks resolved.
+ *
+ * Comparing `path.resolve` strings registered one folder twice whenever it was
+ * reached through a symlink — on macOS every temp dir is (/var → /private/var),
+ * and a shell's cwd reports the resolved side. Two registry rows then meant two
+ * runtimes over ONE .loom/: two engines appending to the same log, each blind
+ * to the other's in-memory state. Found by an orchestra run whose reply landed
+ * in the twin.
+ */
+export declare function canonicalDir(dir: string): string;
 export declare function findProject(idOrDirOrName: string): ProjectInfo | undefined;
 export declare function registerProject(dir: string, name: string): ProjectInfo;
+/** Rename a project's label. The id — what tokens and state key on — never moves. */
+export declare function renameProject(id: string, name: string): ProjectInfo | null;
 export declare function unregisterProject(id: string): void;
 export declare function projectLoomDir(projectDir: string): string;
 export declare function readProjectConfig(projectDir: string): ProjectConfig | null;
@@ -29,8 +42,24 @@ export interface ProjectState {
      * and haven't said anything in yet, still exists.
      */
     chats?: ChatInfo[];
+    /** Work-in-progress limits per board column; a column over its limit warns. */
+    boardLimits?: Record<string, number>;
     /** Task cards you wrote yourself. See BoardTask. */
     tasks?: BoardTask[];
+    /** Per-agent spend budgets in USD/day, set from the Observatory burn-rate panel. */
+    budgets?: Record<string, number>;
+    /**
+     * Agents paused by a firing alert (self-heal). Keyed by agent id; the value
+     * records why, when, and who to hand the baton back to once the alert
+     * resolves — so the loop can retry the original agent, not just fail over.
+     */
+    quarantine?: Record<string, {
+        reason: string;
+        since: number;
+        displaced: boolean;
+    }>;
+    /** Chats brought in from an agent's own history: "<source>:<session id>" → the Loom chat it became. */
+    imports?: Record<string, string>;
 }
 /**
  * A card you made, as opposed to the ones the board derives from live agents
@@ -44,6 +73,21 @@ export interface BoardTask {
     column: string;
     /** Optional agent this is meant for. */
     agent?: string;
+    /**
+     * Tasks this one cannot start before. A card with an unfinished blocker is
+     * refused dispatch — an agent picking up work whose prerequisite isn't done
+     * produces work that has to be thrown away, which is worse than waiting.
+     */
+    blockedBy?: string[];
+    /** How much it matters, when you've said. */
+    priority?: "high" | "medium" | "low";
+    /** When it's due, as a local date: YYYY-MM-DD. */
+    due?: string;
+    /** A crew card (core/crew.ts): the crew, its goal, where it is, and which teammate holds it. */
+    crew?: string;
+    goal?: string;
+    stage?: string;
+    claimedBy?: string;
     createdAt: number;
 }
 export declare function readProjectState(projectDir: string): ProjectState;
@@ -56,9 +100,19 @@ export interface PairedClient {
     name: string;
     token: string;
     createdAt: number;
+    /** When this device last made a request (written at most every 10 min). */
+    lastSeen?: number;
     /** Expo push token, when the device registered for notifications. */
     pushToken?: string;
     platform?: string;
+    /** Which push categories this device wants (questions, approvals, done, goals); absent means all. */
+    pushKinds?: string[];
+    /**
+     * Project ids this token may touch. Absent means all — which keeps every
+     * client paired before scoping existed exactly as powerful as it was.
+     * Pairing a phone for one project used to hand over the whole daemon.
+     */
+    projects?: string[];
 }
 export interface DaemonConfig {
     host: string;

package/dist/core/registry.js

@@ -59,23 +59,63 @@ function registryFile() {
 export function listProjects() {
     return readJson(registryFile(), { projects: [] }).projects;
 }
+/**
+ * A directory as the filesystem knows it: absolute, with symlinks resolved.
+ *
+ * Comparing `path.resolve` strings registered one folder twice whenever it was
+ * reached through a symlink — on macOS every temp dir is (/var → /private/var),
+ * and a shell's cwd reports the resolved side. Two registry rows then meant two
+ * runtimes over ONE .loom/: two engines appending to the same log, each blind
+ * to the other's in-memory state. Found by an orchestra run whose reply landed
+ * in the twin.
+ */
+export function canonicalDir(dir) {
+    const abs = path.resolve(dir);
+    try {
+        return fs.realpathSync(abs);
+    }
+    catch {
+        return abs;
+    }
+}
 export function findProject(idOrDirOrName) {
     const projects = listProjects();
-    const dir = path.resolve(idOrDirOrName);
-    return projects.find((p) => p.id === idOrDirOrName || p.name === idOrDirOrName || path.resolve(p.dir) === dir);
+    const byKey = projects.find((p) => p.id === idOrDirOrName || p.name === idOrDirOrName);
+    if (byKey)
+        return byKey;
+    const dir = canonicalDir(idOrDirOrName);
+    return projects.find((p) => canonicalDir(p.dir) === dir);
 }
 export function registerProject(dir, name) {
     ensureLoomHome();
     const reg = readJson(registryFile(), { projects: [] });
     const resolved = path.resolve(dir);
-    const existing = reg.projects.find((p) => path.resolve(p.dir) === resolved);
+    const canonical = canonicalDir(dir);
+    const existing = reg.projects.find((p) => canonicalDir(p.dir) === canonical);
     if (existing)
         return existing;
-    const info = { id: newId(), name, dir: resolved };
+    // The signature says string and every caller is typed, but the name usually
+    // originates in a JSON file read through an unchecked cast — so "required"
+    // is a claim about the code, not about the bytes on disk. A registry row with
+    // no name is unfixable from the UI (nothing to click) and leaks into every
+    // surface that prints a project. Fall back to the directory, which is what
+    // the caller would have chosen anyway.
+    const label = String(name ?? "").trim() || path.basename(resolved);
+    const info = { id: newId(), name: label, dir: resolved };
     reg.projects.push(info);
     writeJson(registryFile(), reg);
     return info;
 }
+/** Rename a project's label. The id — what tokens and state key on — never moves. */
+export function renameProject(id, name) {
+    const reg = readJson(registryFile(), { projects: [] });
+    const info = reg.projects.find((p) => p.id === id);
+    if (!info)
+        return null;
+    info.name = name;
+    writeJson(registryFile(), reg);
+    return info;
+}
 export function unregisterProject(id) {
     const reg = readJson(registryFile(), { projects: [] });
     reg.projects = reg.projects.filter((p) => p.id !== id);
@@ -94,7 +134,24 @@ export function readProjectConfig(projectDir) {
     return readJson(file, { name: path.basename(projectDir), agents: [] });
 }
 export function writeProjectConfig(projectDir, cfg) {
-    writeJson(path.join(projectLoomDir(projectDir), "config.json"), cfg);
+    const dir = projectLoomDir(projectDir), file = path.join(dir, "config.json");
+    fs.mkdirSync(dir, { recursive: true });
+    const temporary = path.join(dir, `.config-${crypto.randomUUID()}.tmp`);
+    const fd = fs.openSync(temporary, "wx", fs.existsSync(file) ? fs.statSync(file).mode & 0o777 : 0o600);
+    try {
+        try {
+            fs.writeFileSync(fd, JSON.stringify(cfg, null, 2) + "\n");
+            fs.fsyncSync(fd);
+        }
+        finally {
+            fs.closeSync(fd);
+        }
+        fs.renameSync(temporary, file);
+    }
+    finally {
+        if (fs.existsSync(temporary))
+            fs.unlinkSync(temporary);
+    }
 }
 export function readProjectState(projectDir) {
     return readJson(path.join(projectLoomDir(projectDir), "state.json"), {

package/dist/core/registry.js.map

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

package/dist/core/relay-client.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Loom Cloud — the client end of the relay (phone, CLI, tests).
+ *
+ * Gives a remote client the two things a direct connection gives it: `request`
+ * (an HTTP call to the daemon) and `stream` (the /ws event feed), carried as
+ * encrypted envelopes over a broadcast transport. Dependency-free apart from
+ * relay-protocol.ts, so the Expo app runs this exact file (app/src/relay-client.ts
+ * is a copy — keep them in step).
+ *
+ * Reconnection follows T3 Code's connection supervisor (github.com/pingdotgg/
+ * t3code, MIT): capped backoff, a liveness ping, and a forced fresh stream
+ * after the app has been in the background — mobile OSes kill sockets without
+ * telling anyone.
+ */
+import { type RelayCredentials, type RelayTransport } from "./relay-protocol.js";
+export interface RelayResult {
+    status: number;
+    body: unknown;
+}
+export interface StreamHandlers {
+    onFrame: (frame: unknown) => void;
+    onState?: (open: boolean, code?: number) => void;
+}
+export declare class RelayClient {
+    private transport;
+    readonly id: string;
+    private key;
+    private decoder;
+    private pending;
+    private pongs;
+    private stream;
+    private streamOpen;
+    private retryTimer;
+    private closed;
+    daemon: {
+        version: string;
+        name: string;
+    } | null;
+    constructor(transport: RelayTransport, creds: RelayCredentials, opts?: {
+        clientId?: string;
+    });
+    private send;
+    private handle;
+    /** An HTTP call to the daemon, through the relay. */
+    request(method: string, path: string, opts?: {
+        auth?: string;
+        body?: unknown;
+        timeoutMs?: number;
+    }): Promise<RelayResult>;
+    /** Round-trip time to the daemon in ms, or null when it doesn't answer. */
+    ping(timeoutMs?: number): Promise<number | null>;
+    /** Open the live event feed (the /ws frames). Replaces any previous one. */
+    openStream(auth: string, handlers: StreamHandlers, project?: string): void;
+    /** Force a fresh stream — call when the app returns to the foreground. */
+    refresh(): void;
+    isStreaming(): boolean;
+    closeStream(): void;
+    private resubscribe;
+    private scheduleResubscribe;
+    close(): Promise<void>;
+}
+/** Parse the cloud part of a pairing link fragment (`relay=…&sb=…&sbk=…`). */
+export declare function parseCloudFragment(fragment: string): {
+    relay: string;
+    supabaseUrl: string;
+    anonKey: string;
+} | null;

package/dist/core/relay-client.js

@@ -0,0 +1,184 @@
+/**
+ * Loom Cloud — the client end of the relay (phone, CLI, tests).
+ *
+ * Gives a remote client the two things a direct connection gives it: `request`
+ * (an HTTP call to the daemon) and `stream` (the /ws event feed), carried as
+ * encrypted envelopes over a broadcast transport. Dependency-free apart from
+ * relay-protocol.ts, so the Expo app runs this exact file (app/src/relay-client.ts
+ * is a copy — keep them in step).
+ *
+ * Reconnection follows T3 Code's connection supervisor (github.com/pingdotgg/
+ * t3code, MIT): capped backoff, a liveness ping, and a forced fresh stream
+ * after the app has been in the background — mobile OSes kill sockets without
+ * telling anyone.
+ */
+import { encodeMessage, fromB64, RelayDecoder, toB64, } from "./relay-protocol.js";
+const RETRY_MS = [1000, 3000, 8000, 16000];
+function randomId() {
+    const b = new Uint8Array(12);
+    globalThis.crypto.getRandomValues(b);
+    return toB64(b);
+}
+export class RelayClient {
+    transport;
+    id;
+    key;
+    decoder;
+    pending = new Map();
+    pongs = new Map();
+    stream = null;
+    streamOpen = false;
+    retryTimer = null;
+    closed = false;
+    daemon = null;
+    constructor(transport, creds, opts = {}) {
+        this.transport = transport;
+        this.id = opts.clientId ?? randomId();
+        this.key = fromB64(creds.key);
+        this.decoder = new RelayDecoder(this.key, "d");
+        transport.onEnvelope((env) => {
+            const msg = this.decoder.push(env);
+            if (msg)
+                this.handle(msg);
+        });
+    }
+    async send(msg) {
+        for (const env of encodeMessage(this.key, "c", msg))
+            await this.transport.send(env);
+    }
+    handle(msg) {
+        if (msg.t === "res" && msg.to === this.id) {
+            const p = this.pending.get(msg.id);
+            if (!p)
+                return;
+            clearTimeout(p.timer);
+            this.pending.delete(msg.id);
+            p.resolve({ status: msg.status, body: msg.body });
+        }
+        else if (msg.t === "pong" && msg.to === this.id) {
+            this.daemon = msg.daemon;
+            const cb = this.pongs.get(msg.ts);
+            this.pongs.delete(msg.ts);
+            cb?.(Date.now() - msg.ts);
+        }
+        else if (msg.t === "evs" && msg.to === this.id) {
+            for (const f of msg.frames)
+                this.stream?.handlers.onFrame(f);
+        }
+        else if (msg.t === "stream" && msg.to === this.id) {
+            this.streamOpen = msg.open;
+            this.stream?.handlers.onState?.(msg.open, msg.code);
+            if (msg.open && this.stream)
+                this.stream.attempt = 0;
+            // 4401 = the token was refused: retrying would only be refused again.
+            if (!msg.open && this.stream && msg.code !== 4401 && !this.closed)
+                this.scheduleResubscribe();
+        }
+    }
+    /** An HTTP call to the daemon, through the relay. */
+    request(method, path, opts = {}) {
+        const id = randomId();
+        return new Promise((resolve) => {
+            const timer = setTimeout(() => {
+                this.pending.delete(id);
+                resolve({ status: 504, body: { error: "the daemon did not answer through Loom Cloud — is it running?" } });
+            }, opts.timeoutMs ?? 30_000);
+            this.pending.set(id, { resolve, timer });
+            void this.send({
+                t: "req",
+                id,
+                from: this.id,
+                method,
+                path,
+                ts: Date.now(),
+                ...(opts.auth ? { auth: opts.auth } : {}),
+                ...(opts.body !== undefined ? { body: opts.body } : {}),
+            }).catch((err) => {
+                clearTimeout(timer);
+                this.pending.delete(id);
+                resolve({ status: 503, body: { error: `relay send failed: ${err.message}` } });
+            });
+        });
+    }
+    /** Round-trip time to the daemon in ms, or null when it doesn't answer. */
+    ping(timeoutMs = 8000) {
+        const ts = Date.now() + Math.random();
+        return new Promise((resolve) => {
+            const timer = setTimeout(() => {
+                this.pongs.delete(ts);
+                resolve(null);
+            }, timeoutMs);
+            this.pongs.set(ts, (ms) => {
+                clearTimeout(timer);
+                resolve(ms);
+            });
+            void this.send({ t: "ping", from: this.id, ts }).catch(() => resolve(null));
+        });
+    }
+    /** Open the live event feed (the /ws frames). Replaces any previous one. */
+    openStream(auth, handlers, project) {
+        this.stream = { auth, handlers, attempt: 0, ...(project ? { project } : {}) };
+        void this.resubscribe();
+    }
+    /** Force a fresh stream — call when the app returns to the foreground. */
+    refresh() {
+        if (this.stream)
+            void this.resubscribe();
+    }
+    isStreaming() {
+        return this.streamOpen;
+    }
+    closeStream() {
+        this.stream = null;
+        this.streamOpen = false;
+        if (this.retryTimer)
+            clearTimeout(this.retryTimer);
+        void this.send({ t: "unsub", from: this.id }).catch(() => { });
+    }
+    async resubscribe() {
+        if (!this.stream || this.closed)
+            return;
+        await this.send({
+            t: "sub",
+            from: this.id,
+            auth: this.stream.auth,
+            ...(this.stream.project ? { project: this.stream.project } : {}),
+        }).catch(() => this.scheduleResubscribe());
+    }
+    scheduleResubscribe() {
+        if (!this.stream || this.retryTimer)
+            return;
+        const delay = RETRY_MS[Math.min(this.stream.attempt, RETRY_MS.length - 1)];
+        this.stream.attempt++;
+        this.retryTimer = setTimeout(() => {
+            this.retryTimer = null;
+            void this.resubscribe();
+        }, delay);
+    }
+    async close() {
+        this.closed = true;
+        if (this.retryTimer)
+            clearTimeout(this.retryTimer);
+        for (const p of this.pending.values())
+            clearTimeout(p.timer);
+        this.pending.clear();
+        await this.transport.close();
+    }
+}
+/** Parse the cloud part of a pairing link fragment (`relay=…&sb=…&sbk=…`). */
+export function parseCloudFragment(fragment) {
+    const params = new URLSearchParams(fragment.replace(/^#/, ""));
+    const relay = params.get("relay");
+    const sb = params.get("sb");
+    const sbk = params.get("sbk");
+    if (!relay || !sb || !sbk)
+        return null;
+    const dec = new TextDecoder();
+    try {
+        return { relay, supabaseUrl: dec.decode(fromB64(sb)), anonKey: dec.decode(fromB64(sbk)) };
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=relay-client.js.map

package/dist/core/relay-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"relay-client.js","sourceRoot":"","sources":["../../src/core/relay-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EACL,aAAa,EACb,OAAO,EACP,YAAY,EACZ,KAAK,GAIN,MAAM,qBAAqB,CAAC;AAY7B,MAAM,QAAQ,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;AAE3C,SAAS,QAAQ;IACf,MAAM,CAAC,GAAG,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC;IAC7B,UAAU,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;IACrC,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,OAAO,WAAW;IAaZ;IAZD,EAAE,CAAS;IACZ,GAAG,CAAa;IAChB,OAAO,CAAe;IACtB,OAAO,GAAG,IAAI,GAAG,EAAuF,CAAC;IACzG,KAAK,GAAG,IAAI,GAAG,EAAgC,CAAC;IAChD,MAAM,GAAyF,IAAI,CAAC;IACpG,UAAU,GAAG,KAAK,CAAC;IACnB,UAAU,GAAyC,IAAI,CAAC;IACxD,MAAM,GAAG,KAAK,CAAC;IACvB,MAAM,GAA6C,IAAI,CAAC;IAExD,YACU,SAAyB,EACjC,KAAuB,EACvB,OAA8B,EAAE;QAFxB,cAAS,GAAT,SAAS,CAAgB;QAIjC,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,QAAQ,IAAI,QAAQ,EAAE,CAAC;QACtC,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC9B,IAAI,CAAC,OAAO,GAAG,IAAI,YAAY,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QAC/C,SAAS,CAAC,UAAU,CAAC,CAAC,GAAG,EAAE,EAAE;YAC3B,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACnC,IAAI,GAAG;gBAAE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC5B,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,KAAK,CAAC,IAAI,CAAC,GAAiB;QAClC,KAAK,MAAM,GAAG,IAAI,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC;YAAE,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACtF,CAAC;IAEO,MAAM,CAAC,GAAiB;QAC9B,IAAI,GAAG,CAAC,CAAC,KAAK,KAAK,IAAI,GAAG,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,EAAE,CAAC;YAC1C,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACnC,IAAI,CAAC,CAAC;gBAAE,OAAO;YACf,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;YACtB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC5B,CAAC,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;QACpD,CAAC;aAAM,IAAI,GAAG,CAAC,CAAC,KAAK,MAAM,IAAI,GAAG,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,EAAE,CAAC;YAClD,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;YACzB,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAClC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC1B,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,GAAG,CAAC,EAAE,CAAC,CAAC;QAC5B,CAAC;aAAM,IAAI,GAAG,CAAC,CAAC,KAAK,KAAK,IAAI,GAAG,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,EAAE,CAAC;YACjD,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,MAAM;gBAAE,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAC/D,CAAC;aAAM,IAAI,GAAG,CAAC,CAAC,KAAK,QAAQ,IAAI,GAAG,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,EAAE,CAAC;YACpD,IAAI,CAAC,UAAU,GAAG,GAAG,CAAC,IAAI,CAAC;YAC3B,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;YACpD,IAAI,GAAG,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM;gBAAE,IAAI,CAAC,MAAM,CAAC,OAAO,GAAG,CAAC,CAAC;YACrD,sEAAsE;YACtE,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,IAAI,GAAG,CAAC,IAAI,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM;gBAAE,IAAI,CAAC,mBAAmB,EAAE,CAAC;QAChG,CAAC;IACH,CAAC;IAED,qDAAqD;IACrD,OAAO,CAAC,MAAc,EAAE,IAAY,EAAE,OAA8D,EAAE;QACpG,MAAM,EAAE,GAAG,QAAQ,EAAE,CAAC;QACtB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YAC7B,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC5B,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;gBACxB,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,+DAA+D,EAAE,EAAE,CAAC,CAAC;YAC7G,CAAC,EAAE,IAAI,CAAC,SAAS,IAAI,MAAM,CAAC,CAAC;YAC7B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;YACzC,KAAK,IAAI,CAAC,IAAI,CAAC;gBACb,CAAC,EAAE,KAAK;gBACR,EAAE;gBACF,IAAI,EAAE,IAAI,CAAC,EAAE;gBACb,MAAM;gBACN,IAAI;gBACJ,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE;gBACd,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACzC,GAAG,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACxD,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;gBACf,YAAY,CAAC,KAAK,CAAC,CAAC;gBACpB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;gBACxB,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,sBAAuB,GAAa,CAAC,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;YAC5F,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED,2EAA2E;IAC3E,IAAI,CAAC,SAAS,GAAG,IAAI;QACnB,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QACtC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YAC7B,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC5B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;gBACtB,OAAO,CAAC,IAAI,CAAC,CAAC;YAChB,CAAC,EAAE,SAAS,CAAC,CAAC;YACd,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE;gBACxB,YAAY,CAAC,KAAK,CAAC,CAAC;gBACpB,OAAO,CAAC,EAAE,CAAC,CAAC;YACd,CAAC,CAAC,CAAC;YACH,KAAK,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QAC9E,CAAC,CAAC,CAAC;IACL,CAAC;IAED,4EAA4E;IAC5E,UAAU,CAAC,IAAY,EAAE,QAAwB,EAAE,OAAgB;QACjE,IAAI,CAAC,MAAM,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;QAC9E,KAAK,IAAI,CAAC,WAAW,EAAE,CAAC;IAC1B,CAAC;IAED,0EAA0E;IAC1E,OAAO;QACL,IAAI,IAAI,CAAC,MAAM;YAAE,KAAK,IAAI,CAAC,WAAW,EAAE,CAAC;IAC3C,CAAC;IAED,WAAW;QACT,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED,WAAW;QACT,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;QACxB,IAAI,IAAI,CAAC,UAAU;YAAE,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACnD,KAAK,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IAChE,CAAC;IAEO,KAAK,CAAC,WAAW;QACvB,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO;QACxC,MAAM,IAAI,CAAC,IAAI,CAAC;YACd,CAAC,EAAE,KAAK;YACR,IAAI,EAAE,IAAI,CAAC,EAAE;YACb,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI;YACtB,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACjE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,mBAAmB,EAAE,CAAC,CAAC;IAC7C,CAAC;IAEO,mBAAmB;QACzB,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,UAAU;YAAE,OAAO;QAC5C,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAE,CAAC;QAC5E,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACtB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC,GAAG,EAAE;YAChC,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;YACvB,KAAK,IAAI,CAAC,WAAW,EAAE,CAAC;QAC1B,CAAC,EAAE,KAAK,CAAC,CAAC;IACZ,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,IAAI,IAAI,CAAC,UAAU;YAAE,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACnD,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE;YAAE,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QAC7D,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACrB,MAAM,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;IAC/B,CAAC;CACF;AAED,8EAA8E;AAC9E,MAAM,UAAU,kBAAkB,CAAC,QAAgB;IACjD,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC;IAC/D,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAClC,MAAM,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC5B,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAC9B,IAAI,CAAC,KAAK,IAAI,CAAC,EAAE,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IACvC,MAAM,GAAG,GAAG,IAAI,WAAW,EAAE,CAAC;IAC9B,IAAI,CAAC;QACH,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;IAC5F,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/core/relay-protocol.d.ts

@@ -0,0 +1,140 @@
+/**
+ * Loom Cloud relay — the wire format.
+ *
+ * Reaching your daemon from a phone on another network without a VPN: both
+ * ends join one Supabase Realtime broadcast channel and pass encrypted
+ * envelopes through it. The daemon turns each request into an ordinary local
+ * HTTP call (or WebSocket) against itself, with the phone's own paired token,
+ * so every auth and scope rule is the one the LAN path already enforces.
+ *
+ * **Supabase sees only ciphertext.** The channel name and the 32-byte key are
+ * minted by the daemon and travel only inside the pairing QR / link fragment.
+ * Every envelope is XChaCha20-Poly1305 with a fresh random nonce; a message
+ * that doesn't authenticate is dropped. The relay can't read your code, your
+ * prompts or your tokens, and it can't forge a request.
+ *
+ * Pattern credits: the pairing token rides the URL *fragment* (never sent to a
+ * server) and clients resume a stream from a sequence number — both from
+ * T3 Code (github.com/pingdotgg/t3code, MIT).
+ *
+ * This file is dependency-light on purpose (only @noble/ciphers): the Expo app
+ * carries a copy (app/src/relay-protocol.ts) and the two must stay in step.
+ */
+export declare const RELAY_PROTOCOL = 1;
+/** Supabase's default broadcast payload cap is 256 KB; stay well under after base64. */
+export declare const MAX_CHUNK: number;
+/** A request from a client, executed by the daemon against itself. */
+export interface RelayRequest {
+    t: "req";
+    id: string;
+    from: string;
+    method: string;
+    path: string;
+    auth?: string;
+    body?: unknown;
+    /**
+     * When the client sent it (ms). Inside the sealed envelope, so nobody on the
+     * relay can change it: the daemon refuses a request stamped too far from
+     * now, and remembers the ids it has run — a captured request can't be sent
+     * again. Absent from clients older than this field.
+     */
+    ts?: number;
+}
+export interface RelayResponse {
+    t: "res";
+    id: string;
+    to: string;
+    status: number;
+    body: unknown;
+}
+/** Open (or replace) a live event stream for a client — a remote WebSocket. */
+export interface RelaySubscribe {
+    t: "sub";
+    from: string;
+    auth: string;
+    project?: string;
+}
+export interface RelayUnsubscribe {
+    t: "unsub";
+    from: string;
+}
+/** Live frames for one client, batched. Each frame is exactly a /ws frame. */
+export interface RelayEvents {
+    t: "evs";
+    to: string;
+    frames: unknown[];
+}
+/** Stream state for one client: open, or closed with the /ws close code. */
+export interface RelayStreamState {
+    t: "stream";
+    to: string;
+    open: boolean;
+    code?: number;
+}
+export interface RelayPing {
+    t: "ping";
+    from: string;
+    ts: number;
+}
+export interface RelayPong {
+    t: "pong";
+    to: string;
+    ts: number;
+    daemon: {
+        version: string;
+        name: string;
+    };
+}
+export type RelayMessage = RelayRequest | RelayResponse | RelaySubscribe | RelayUnsubscribe | RelayEvents | RelayStreamState | RelayPing | RelayPong;
+/** What actually crosses Supabase. `p` is set when a message spans parts. */
+export interface RelayEnvelope {
+    v: number;
+    /** direction: c = client→daemon, d = daemon→client. Each side ignores its own. */
+    d: "c" | "d";
+    /** base64 of nonce‖ciphertext */
+    x: string;
+    /** multipart: [messageId, index, count] */
+    p?: [string, number, number];
+}
+export declare function toB64(bytes: Uint8Array): string;
+export declare function fromB64(s: string): Uint8Array;
+export interface RelayCredentials {
+    /** Channel id — also unguessable, but secrecy rests on the key. */
+    channel: string;
+    /** 32-byte key, base64url. */
+    key: string;
+}
+export declare function newRelayCredentials(): RelayCredentials;
+/** The Supabase channel topic for a credential set. */
+export declare function relayTopic(channel: string): string;
+/** `channel.key` — the compact form carried in a pairing link. */
+export declare function packCredentials(c: RelayCredentials): string;
+export declare function unpackCredentials(s: string): RelayCredentials | null;
+export declare function seal(key: Uint8Array, plaintext: Uint8Array): string;
+/** Null when the envelope doesn't authenticate — never throws on hostile input. */
+export declare function open(key: Uint8Array, sealed: string): Uint8Array | null;
+/** Encode a message into one or more envelopes (split when large). */
+export declare function encodeMessage(key: Uint8Array, dir: "c" | "d", msg: RelayMessage): RelayEnvelope[];
+/**
+ * Reassembles multipart messages and decrypts. Feed every envelope from the
+ * other side; it yields each complete message once.
+ */
+export declare class RelayDecoder {
+    private key;
+    /** Which direction this side reads: the daemon reads "c", the client "d". */
+    private reads;
+    private parts;
+    constructor(key: Uint8Array, 
+    /** Which direction this side reads: the daemon reads "c", the client "d". */
+    reads: "c" | "d");
+    push(env: unknown): RelayMessage | null;
+    private gc;
+}
+/** Where envelopes go: Supabase in production, an in-memory bus in tests. */
+export interface RelayTransport {
+    send(env: RelayEnvelope): Promise<void>;
+    onEnvelope(cb: (env: unknown) => void): void;
+    /** Resolves once the transport is joined and can send. */
+    ready(): Promise<void>;
+    close(): Promise<void>;
+}