remote-pi 0.1.0

package/dist/session/wizard.js

@@ -0,0 +1,20 @@
+import { listSessions, sessionHasSock } from "./global_config.js";
+const CREATE_SENTINEL = "━━━ Create new session ━━━";
+export async function joinWizard(ui, defaultName) {
+    const sessions = listSessions();
+    const liveSessions = sessions.filter(sessionHasSock);
+    const options = [...liveSessions, CREATE_SENTINEL];
+    const picked = await ui.select(liveSessions.length
+        ? "Choose a session to join, or create a new one"
+        : "No active sessions. Create one?", options);
+    if (!picked)
+        return null;
+    if (picked === CREATE_SENTINEL) {
+        // Caller is expected to follow up with a name prompt via ctx.ui.select
+        // (the Pi SDK input dialog). For non-interactive contexts we return the
+        // default name.
+        return defaultName;
+    }
+    return picked;
+}
+//# sourceMappingURL=wizard.js.map

package/dist/session/wizard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wizard.js","sourceRoot":"","sources":["../../src/session/wizard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAelE,MAAM,eAAe,GAAG,4BAA4B,CAAC;AAErD,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,EAAY,EACZ,WAAmB;IAEnB,MAAM,QAAQ,GAAG,YAAY,EAAE,CAAC;IAChC,MAAM,YAAY,GAAG,QAAQ,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;IACrD,MAAM,OAAO,GAAG,CAAC,GAAG,YAAY,EAAE,eAAe,CAAC,CAAC;IACnD,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,MAAM,CAC5B,YAAY,CAAC,MAAM;QACjB,CAAC,CAAC,+CAA+C;QACjD,CAAC,CAAC,iCAAiC,EACrC,OAAO,CACR,CAAC;IACF,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACzB,IAAI,MAAM,KAAK,eAAe,EAAE,CAAC;QAC/B,uEAAuE;QACvE,wEAAwE;QACxE,gBAAgB;QAChB,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/settings.d.ts

@@ -0,0 +1,15 @@
+export declare const DEFAULT_RELAY_URL = "ws://localhost:3000";
+export interface Settings {
+    relay_url?: string;
+}
+export declare function loadSettings(): Promise<Settings>;
+export declare function saveSettings(settings: Settings): Promise<void>;
+/** Returns saved relay URL, env override, or default. */
+export declare function getRelayUrl(): Promise<string>;
+export declare function setRelayUrl(url: string): Promise<void>;
+export declare function validateRelayUrl(url: string): {
+    ok: true;
+} | {
+    ok: false;
+    reason: string;
+};

package/dist/settings.js

@@ -0,0 +1,52 @@
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+const SETTINGS_PATH = join(homedir(), ".pi", "remote", "settings.json");
+export const DEFAULT_RELAY_URL = "ws://localhost:3000";
+export async function loadSettings() {
+    try {
+        const raw = await readFile(SETTINGS_PATH, "utf8");
+        const parsed = JSON.parse(raw);
+        if (!parsed || typeof parsed !== "object")
+            return {};
+        return parsed;
+    }
+    catch {
+        return {};
+    }
+}
+export async function saveSettings(settings) {
+    await mkdir(dirname(SETTINGS_PATH), { recursive: true });
+    await writeFile(SETTINGS_PATH, JSON.stringify(settings, null, 2));
+}
+/** Returns saved relay URL, env override, or default. */
+export async function getRelayUrl() {
+    const settings = await loadSettings();
+    if (settings.relay_url)
+        return settings.relay_url;
+    const env = process.env["REMOTE_PI_RELAY"];
+    if (env)
+        return env;
+    return DEFAULT_RELAY_URL;
+}
+export async function setRelayUrl(url) {
+    const settings = await loadSettings();
+    settings.relay_url = url;
+    await saveSettings(settings);
+}
+export function validateRelayUrl(url) {
+    if (!url)
+        return { ok: false, reason: "URL is empty" };
+    let parsed;
+    try {
+        parsed = new URL(url);
+    }
+    catch {
+        return { ok: false, reason: "malformed URL" };
+    }
+    if (parsed.protocol !== "ws:" && parsed.protocol !== "wss:") {
+        return { ok: false, reason: `expected ws:// or wss://, got ${parsed.protocol}` };
+    }
+    return { ok: true };
+}
+//# sourceMappingURL=settings.js.map

package/dist/settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.js","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE1C,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,eAAe,CAAC,CAAC;AAExE,MAAM,CAAC,MAAM,iBAAiB,GAAG,qBAAqB,CAAC;AAMvD,MAAM,CAAC,KAAK,UAAU,YAAY;IAChC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;QAClD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAY,CAAC;QAC1C,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ;YAAE,OAAO,EAAE,CAAC;QACrD,OAAO,MAAkB,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,QAAkB;IACnD,MAAM,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACzD,MAAM,SAAS,CAAC,aAAa,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AACpE,CAAC;AAED,yDAAyD;AACzD,MAAM,CAAC,KAAK,UAAU,WAAW;IAC/B,MAAM,QAAQ,GAAG,MAAM,YAAY,EAAE,CAAC;IACtC,IAAI,QAAQ,CAAC,SAAS;QAAE,OAAO,QAAQ,CAAC,SAAS,CAAC;IAClD,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;IAC3C,IAAI,GAAG;QAAE,OAAO,GAAG,CAAC;IACpB,OAAO,iBAAiB,CAAC;AAC3B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,GAAW;IAC3C,MAAM,QAAQ,GAAG,MAAM,YAAY,EAAE,CAAC;IACtC,QAAQ,CAAC,SAAS,GAAG,GAAG,CAAC;IACzB,MAAM,YAAY,CAAC,QAAQ,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC;IACvD,IAAI,MAAW,CAAC;IAChB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IACxB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC;IAChD,CAAC;IACD,IAAI,MAAM,CAAC,QAAQ,KAAK,KAAK,IAAI,MAAM,CAAC,QAAQ,KAAK,MAAM,EAAE,CAAC;QAC5D,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,iCAAiC,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC;IACnF,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;AACtB,CAAC"}

package/dist/transport/peer_channel.d.ts

@@ -0,0 +1,37 @@
+import type { ClientMessage, ServerMessage } from "../protocol/types.js";
+import type { RelayClient } from "./relay_client.js";
+/** Sink for ServerMessage outbound to the remote app. */
+export interface PeerChannel {
+    send(msg: ServerMessage): void;
+}
+/**
+ * Plaintext PeerChannel backed by a RelayClient WebSocket.
+ *
+ * Usage (after pair_request handshake completes):
+ *   const channel = new PlainPeerChannel(relay, appPeerId, myRoomId, onMsg)
+ *   channel.send(serverMessage)          // base64-encodes JSON, routes via relay
+ *   // incoming relay messages destined for appPeerId are auto-decoded
+ *   // and delivered via onMessage callback
+ *
+ * `myRoomId` is the *local* Pi's room id — sent on every outbound envelope
+ * so the app can correlate which Pi sent it (multi-pi support, plano 17).
+ */
+export declare class PlainPeerChannel implements PeerChannel {
+    private readonly relay;
+    private readonly remotePeerId;
+    private readonly onMessage;
+    private readonly _unsubscribe;
+    constructor(relay: RelayClient, remotePeerId: string, 
+    /**
+     * This Pi's room id. Currently NOT injected in the outer envelope
+     * (defensive — relay/app not yet ready). Kept in the constructor for
+     * forward-compat so callers don't need to change again when we re-enable.
+     */
+    myRoomId: string | undefined, onMessage: (msg: ClientMessage) => void, 
+    /** Called when this specific peer connection is considered lost. */
+    _onDisconnect?: () => void);
+    send(msg: ServerMessage): void;
+    /** Detaches from relay (does not close the relay itself). */
+    detach(): void;
+    private _onLine;
+}

package/dist/transport/peer_channel.js

@@ -0,0 +1,85 @@
+/**
+ * Plaintext PeerChannel backed by a RelayClient WebSocket.
+ *
+ * Usage (after pair_request handshake completes):
+ *   const channel = new PlainPeerChannel(relay, appPeerId, myRoomId, onMsg)
+ *   channel.send(serverMessage)          // base64-encodes JSON, routes via relay
+ *   // incoming relay messages destined for appPeerId are auto-decoded
+ *   // and delivered via onMessage callback
+ *
+ * `myRoomId` is the *local* Pi's room id — sent on every outbound envelope
+ * so the app can correlate which Pi sent it (multi-pi support, plano 17).
+ */
+export class PlainPeerChannel {
+    relay;
+    remotePeerId;
+    onMessage;
+    _unsubscribe;
+    constructor(relay, remotePeerId, 
+    /**
+     * This Pi's room id. Currently NOT injected in the outer envelope
+     * (defensive — relay/app not yet ready). Kept in the constructor for
+     * forward-compat so callers don't need to change again when we re-enable.
+     */
+    myRoomId, onMessage, 
+    /** Called when this specific peer connection is considered lost. */
+    _onDisconnect) {
+        this.relay = relay;
+        this.remotePeerId = remotePeerId;
+        this.onMessage = onMessage;
+        const listener = (line) => this._onLine(line);
+        relay.on("message", listener);
+        this._unsubscribe = () => relay.off("message", listener);
+        void _onDisconnect;
+        void myRoomId; // intentionally unused — see send() comment
+    }
+    // ── PeerChannel interface ──────────────────────────────────────────────────
+    send(msg) {
+        const ct = Buffer.from(JSON.stringify(msg)).toString("base64");
+        // NOTE: `room` removed from the outer envelope until relay (W1.A) + app
+        // (W1.C) accept the field. Multi-Pi multiplexing already works via
+        // `room_id`/`room_meta` in the WS-level `hello` — outer routing stays by
+        // `peer` alone. Re-add the field once downstream is ready.
+        const outer = { peer: this.remotePeerId, ct };
+        this.relay.send(JSON.stringify(outer));
+    }
+    /** Detaches from relay (does not close the relay itself). */
+    detach() {
+        this._unsubscribe();
+    }
+    // ── Incoming line from relay ────────────────────────────────────────────────
+    _onLine(line) {
+        let outer;
+        try {
+            outer = JSON.parse(line);
+        }
+        catch {
+            return; // malformed line
+        }
+        if (outer.peer !== this.remotePeerId)
+            return;
+        if (!outer.ct)
+            return;
+        let plaintext;
+        try {
+            plaintext = Buffer.from(outer.ct, "base64").toString("utf8");
+        }
+        catch {
+            return;
+        }
+        let msg;
+        try {
+            msg = JSON.parse(plaintext);
+        }
+        catch {
+            return;
+        }
+        if (!msg ||
+            typeof msg !== "object" ||
+            typeof msg.type !== "string") {
+            return;
+        }
+        this.onMessage(msg);
+    }
+}
+//# sourceMappingURL=peer_channel.js.map

package/dist/transport/peer_channel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"peer_channel.js","sourceRoot":"","sources":["../../src/transport/peer_channel.ts"],"names":[],"mappings":"AAyBA;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,gBAAgB;IAIR;IACA;IAOA;IAXF,YAAY,CAAa;IAE1C,YACmB,KAAkB,EAClB,YAAoB;IACrC;;;;OAIG;IACH,QAA4B,EACX,SAAuC;IACxD,oEAAoE;IACpE,aAA0B;QAVT,UAAK,GAAL,KAAK,CAAa;QAClB,iBAAY,GAAZ,YAAY,CAAQ;QAOpB,cAAS,GAAT,SAAS,CAA8B;QAIxD,MAAM,QAAQ,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACtD,KAAK,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAC9B,IAAI,CAAC,YAAY,GAAG,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QACzD,KAAK,aAAa,CAAC;QACnB,KAAK,QAAQ,CAAC,CAAE,4CAA4C;IAC9D,CAAC;IAED,8EAA8E;IAE9E,IAAI,CAAC,GAAkB;QACrB,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAC/D,wEAAwE;QACxE,mEAAmE;QACnE,yEAAyE;QACzE,2DAA2D;QAC3D,MAAM,KAAK,GAAkB,EAAE,IAAI,EAAE,IAAI,CAAC,YAAY,EAAE,EAAE,EAAE,CAAC;QAC7D,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;IACzC,CAAC;IAED,6DAA6D;IAC7D,MAAM;QACJ,IAAI,CAAC,YAAY,EAAE,CAAC;IACtB,CAAC;IAED,+EAA+E;IAEvE,OAAO,CAAC,IAAY;QAC1B,IAAI,KAAoB,CAAC;QACzB,IAAI,CAAC;YACH,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAkB,CAAC;QAC5C,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,CAAC,iBAAiB;QAC3B,CAAC;QAED,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,YAAY;YAAE,OAAO;QAC7C,IAAI,CAAC,KAAK,CAAC,EAAE;YAAE,OAAO;QAEtB,IAAI,SAAiB,CAAC;QACtB,IAAI,CAAC;YACH,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC/D,CAAC;QAAC,MAAM,CAAC;YACP,OAAO;QACT,CAAC;QAED,IAAI,GAAY,CAAC;QACjB,IAAI,CAAC;YACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAC9B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO;QACT,CAAC;QAED,IACE,CAAC,GAAG;YACJ,OAAO,GAAG,KAAK,QAAQ;YACvB,OAAQ,GAA+B,CAAC,IAAI,KAAK,QAAQ,EACzD,CAAC;YACD,OAAO;QACT,CAAC;QAED,IAAI,CAAC,SAAS,CAAC,GAAoB,CAAC,CAAC;IACvC,CAAC;CACF"}

package/dist/transport/relay_client.d.ts

@@ -0,0 +1,81 @@
+import { EventEmitter } from "node:events";
+import type { Ed25519Keypair } from "../pairing/crypto.js";
+export interface RoomMeta {
+    name: string;
+    cwd: string;
+    /** Friendly model name (e.g. "claude-sonnet-4.5"). Optional — pi-ext sends
+     *  when `ExtensionContext.model` is available; relay/app tolerate absence. */
+    model?: string;
+}
+/** Control frame sent to relay (not routed to app peer). */
+export interface RoomMetaUpdateFrame {
+    type: "room_meta_update";
+    room_id: string;
+    meta: {
+        model?: string;
+    };
+}
+export interface ConnectOptions {
+    roomId?: string;
+    roomMeta?: RoomMeta;
+}
+/** Relay rejected hello because another peer already holds (pubkey, room_id). */
+export declare class RoomAlreadyOpenError extends Error {
+    readonly roomId: string | undefined;
+    constructor(roomId: string | undefined);
+}
+export interface RelayClientEvents {
+    /** A single JSONL line delivered by the relay (outer envelope). */
+    message: [line: string];
+    close: [];
+    error: [err: Error];
+}
+/**
+ * Thin WebSocket client for the Remote Pi relay.
+ *
+ * Lifecycle:
+ *   const relay = new RelayClient(url, ed25519Keypair)
+ *   await relay.connect()          // opens WS + runs Ed25519 challenge-response
+ *   relay.on("message", line => …) // outer envelopes: { peer, ct }
+ *   relay.send(jsonLine)           // write to relay
+ *   relay.close()
+ *
+ * Auth sequence (pairing.md §Challenge-response):
+ *   → { type:"hello",     pubkey: "<Ed25519 pubkey base64>" }
+ *   ← { type:"challenge", nonce:  "<32 bytes base64>" }
+ *   → { type:"auth",      sig:    "<Ed25519 sig base64>" }
+ */
+export declare class RelayClient extends EventEmitter {
+    private readonly url;
+    private readonly keypair;
+    private ws;
+    constructor(url: string, keypair: Ed25519Keypair);
+    /**
+     * Connects and completes Ed25519 auth.  Resolves when relay is ready.
+     *
+     * `options.roomId` (12-char id derived from cwd, see `src/rooms.ts`) is
+     * included in the hello so the relay can multiplex N concurrent peers
+     * with the same Ed25519 pubkey but different rooms (one pi-ext per cwd).
+     * Omitting `roomId` is backward-compat with old relays (treated as the
+     * default "main" room server-side).
+     *
+     * Throws `RoomAlreadyOpenError` if the relay rejects the hello because
+     * another peer already holds the (pubkey, room_id) tuple. Caller (e.g.
+     * `_cmdStart`) maps that to a clearer UI message.
+     */
+    connect(options?: ConnectOptions): Promise<void>;
+    /** Sends a raw line to the relay (caller is responsible for framing). */
+    send(line: string): void;
+    /**
+     * Sends a control frame to the relay (not routed to app peer). Used for
+     * out-of-band metadata updates like `room_meta_update`. Silently no-ops if
+     * the WS isn't open (best-effort: control frames are observational; we
+     * don't want them throwing inside SDK event callbacks).
+     */
+    sendControl(frame: object): void;
+    close(): void;
+    private _authenticate;
+    /** Waits for the next single WS message with a timeout. */
+    private _nextMsg;
+    private _rawSend;
+}

package/dist/transport/relay_client.js

@@ -0,0 +1,154 @@
+import { EventEmitter } from "node:events";
+import WebSocket from "ws";
+import { ed25519Sign } from "../pairing/crypto.js";
+const AUTH_TIMEOUT_MS = 5_000;
+/** Relay rejected hello because another peer already holds (pubkey, room_id). */
+export class RoomAlreadyOpenError extends Error {
+    roomId;
+    constructor(roomId) {
+        super(roomId
+            ? `relay rejected hello: room ${roomId} already open for this peer`
+            : "relay rejected hello: peer already connected");
+        this.roomId = roomId;
+        this.name = "RoomAlreadyOpenError";
+    }
+}
+/**
+ * Thin WebSocket client for the Remote Pi relay.
+ *
+ * Lifecycle:
+ *   const relay = new RelayClient(url, ed25519Keypair)
+ *   await relay.connect()          // opens WS + runs Ed25519 challenge-response
+ *   relay.on("message", line => …) // outer envelopes: { peer, ct }
+ *   relay.send(jsonLine)           // write to relay
+ *   relay.close()
+ *
+ * Auth sequence (pairing.md §Challenge-response):
+ *   → { type:"hello",     pubkey: "<Ed25519 pubkey base64>" }
+ *   ← { type:"challenge", nonce:  "<32 bytes base64>" }
+ *   → { type:"auth",      sig:    "<Ed25519 sig base64>" }
+ */
+export class RelayClient extends EventEmitter {
+    url;
+    keypair;
+    ws = null;
+    constructor(url, keypair) {
+        super();
+        this.url = url;
+        this.keypair = keypair;
+    }
+    // ── Public API ──────────────────────────────────────────────────────────────
+    /**
+     * Connects and completes Ed25519 auth.  Resolves when relay is ready.
+     *
+     * `options.roomId` (12-char id derived from cwd, see `src/rooms.ts`) is
+     * included in the hello so the relay can multiplex N concurrent peers
+     * with the same Ed25519 pubkey but different rooms (one pi-ext per cwd).
+     * Omitting `roomId` is backward-compat with old relays (treated as the
+     * default "main" room server-side).
+     *
+     * Throws `RoomAlreadyOpenError` if the relay rejects the hello because
+     * another peer already holds the (pubkey, room_id) tuple. Caller (e.g.
+     * `_cmdStart`) maps that to a clearer UI message.
+     */
+    async connect(options = {}) {
+        return new Promise((resolve, reject) => {
+            const ws = new WebSocket(this.url);
+            this.ws = ws;
+            ws.on("error", (err) => reject(err));
+            ws.on("open", async () => {
+                try {
+                    await this._authenticate(ws, options);
+                    // Auth done — wire persistent message handler
+                    ws.on("message", (raw) => {
+                        const text = Buffer.isBuffer(raw) ? raw.toString() : String(raw);
+                        for (const line of text.split("\n")) {
+                            const trimmed = line.trim();
+                            if (trimmed)
+                                this.emit("message", trimmed);
+                        }
+                    });
+                    ws.on("close", () => this.emit("close"));
+                    resolve();
+                }
+                catch (err) {
+                    ws.terminate();
+                    reject(err);
+                }
+            });
+        });
+    }
+    /** Sends a raw line to the relay (caller is responsible for framing). */
+    send(line) {
+        if (!this.ws || this.ws.readyState !== WebSocket.OPEN) {
+            throw new Error("relay: not connected");
+        }
+        this.ws.send(line);
+    }
+    /**
+     * Sends a control frame to the relay (not routed to app peer). Used for
+     * out-of-band metadata updates like `room_meta_update`. Silently no-ops if
+     * the WS isn't open (best-effort: control frames are observational; we
+     * don't want them throwing inside SDK event callbacks).
+     */
+    sendControl(frame) {
+        if (!this.ws || this.ws.readyState !== WebSocket.OPEN)
+            return;
+        this.ws.send(JSON.stringify(frame));
+    }
+    close() {
+        this.ws?.close();
+        this.ws = null;
+    }
+    // ── Auth ────────────────────────────────────────────────────────────────────
+    async _authenticate(ws, opts) {
+        const pubkeyB64 = Buffer.from(this.keypair.publicKey).toString("base64");
+        const hello = { type: "hello", pubkey: pubkeyB64 };
+        if (opts.roomId)
+            hello.room_id = opts.roomId;
+        if (opts.roomMeta)
+            hello.room_meta = opts.roomMeta;
+        this._rawSend(ws, JSON.stringify(hello));
+        const challengeRaw = await this._nextMsg(ws);
+        let challenge;
+        try {
+            challenge = JSON.parse(challengeRaw);
+        }
+        catch {
+            throw new Error(`relay auth_failed: not JSON: ${challengeRaw}`);
+        }
+        if (challenge.type === "error") {
+            const code = challenge.code ?? "";
+            if (code === "room_already_open") {
+                throw new RoomAlreadyOpenError(opts.roomId);
+            }
+            throw new Error(`relay rejected hello: ${code || challenge.message || "unknown"}`);
+        }
+        if (challenge.type !== "challenge" || !challenge.nonce) {
+            throw new Error(`relay auth_failed: expected challenge, got ${challengeRaw}`);
+        }
+        const nonce = Buffer.from(challenge.nonce, "base64");
+        const sig = ed25519Sign(this.keypair.secretKey, nonce);
+        const auth = {
+            type: "auth",
+            sig: Buffer.from(sig).toString("base64"),
+        };
+        this._rawSend(ws, JSON.stringify(auth));
+        // Relay does not send an explicit "ok" — it simply starts routing.
+        // Proceed immediately after sending auth.
+    }
+    /** Waits for the next single WS message with a timeout. */
+    _nextMsg(ws) {
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => reject(new Error("relay auth timeout")), AUTH_TIMEOUT_MS);
+            ws.once("message", (raw) => {
+                clearTimeout(timer);
+                resolve(Buffer.isBuffer(raw) ? raw.toString() : String(raw));
+            });
+        });
+    }
+    _rawSend(ws, data) {
+        ws.send(data);
+    }
+}
+//# sourceMappingURL=relay_client.js.map

package/dist/transport/relay_client.js.map

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

package/dist/ui/footer.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Footer renderer for the Pi TUI. Three status slots + window title.
+ *
+ * Slot keys (intentionally namespaced so other extensions don't collide):
+ *   - remote-pi:session   — current local session + peer count
+ *   - remote-pi:relay     — relay state (off / on / paired)
+ *   - remote-pi:peer-active — active mobile device, if paired
+ */
+export interface FooterContext {
+    ui: {
+        setStatus(key: string, value: string | undefined): void;
+        setTitle(title: string): void;
+    };
+}
+export interface FooterState {
+    session?: string;
+    peerCount?: number;
+    relayOn?: boolean;
+    /** Active device session right now (drives the 📱 slot).
+     *  Independent from `hasPairings` — a device may be paired globally
+     *  in peers.json without being actively connected to THIS Pi process. */
+    devicePaired?: string;
+    /** At least one device has been paired with this machine before
+     *  (peers.json is non-empty). Drives the 🟢/🟡 icon on the relay slot:
+     *  🟢 when true (ready — devices can connect), 🟡 when false (first
+     *  pairing needed). Pairing is per-machine (global), not per-process. */
+    hasPairings?: boolean;
+    /** Assigned agent name in the current session. Becomes the title prefix
+     *  (e.g. "backend · foo · relay") when set. Falls back to "Pi" otherwise. */
+    agentName?: string;
+}
+export declare function updateFooter(ctx: FooterContext, state: FooterState): void;

package/dist/ui/footer.js

@@ -0,0 +1,32 @@
+const K_SESSION = "remote-pi:session";
+const K_RELAY = "remote-pi:relay";
+const K_PEER = "remote-pi:peer-active";
+export function updateFooter(ctx, state) {
+    if (state.session) {
+        const count = state.peerCount ?? 0;
+        ctx.ui.setStatus(K_SESSION, `📡 ${state.session} (${count})`);
+    }
+    else {
+        ctx.ui.setStatus(K_SESSION, undefined);
+    }
+    if (state.relayOn) {
+        ctx.ui.setStatus(K_RELAY, state.hasPairings ? "🟢 relay" : "🟡 relay waiting for pairing");
+    }
+    else {
+        ctx.ui.setStatus(K_RELAY, undefined);
+    }
+    if (state.devicePaired) {
+        ctx.ui.setStatus(K_PEER, `📱 ${state.devicePaired}`);
+    }
+    else {
+        ctx.ui.setStatus(K_PEER, undefined);
+    }
+    const titleParts = [];
+    if (state.session)
+        titleParts.push(state.session);
+    if (state.relayOn)
+        titleParts.push("relay");
+    const prefix = state.agentName?.trim() || "Pi";
+    ctx.ui.setTitle(titleParts.length ? `${prefix} · ${titleParts.join(" · ")}` : prefix);
+}
+//# sourceMappingURL=footer.js.map

package/dist/ui/footer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"footer.js","sourceRoot":"","sources":["../../src/ui/footer.ts"],"names":[],"mappings":"AAiCA,MAAM,SAAS,GAAG,mBAAmB,CAAC;AACtC,MAAM,OAAO,GAAG,iBAAiB,CAAC;AAClC,MAAM,MAAM,GAAG,uBAAuB,CAAC;AAEvC,MAAM,UAAU,YAAY,CAAC,GAAkB,EAAE,KAAkB;IACjE,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QAClB,MAAM,KAAK,GAAG,KAAK,CAAC,SAAS,IAAI,CAAC,CAAC;QACnC,GAAG,CAAC,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,MAAM,KAAK,CAAC,OAAO,KAAK,KAAK,GAAG,CAAC,CAAC;IAChE,CAAC;SAAM,CAAC;QACN,GAAG,CAAC,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IACzC,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QAClB,GAAG,CAAC,EAAE,CAAC,SAAS,CACd,OAAO,EACP,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,8BAA8B,CAChE,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,GAAG,CAAC,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IACvC,CAAC;IAED,IAAI,KAAK,CAAC,YAAY,EAAE,CAAC;QACvB,GAAG,CAAC,EAAE,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,KAAK,CAAC,YAAY,EAAE,CAAC,CAAC;IACvD,CAAC;SAAM,CAAC;QACN,GAAG,CAAC,EAAE,CAAC,SAAS,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACtC,CAAC;IAED,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,IAAI,KAAK,CAAC,OAAO;QAAE,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAClD,IAAI,KAAK,CAAC,OAAO;QAAE,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC5C,MAAM,MAAM,GAAG,KAAK,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC;IAC/C,GAAG,CAAC,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,MAAM,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AACxF,CAAC"}

package/package.json

@@ -0,0 +1,77 @@
+{
+  "name": "remote-pi",
+  "version": "0.1.0",
+  "description": "Mobile remote control and local agent mesh for the Pi coding agent. Pair your phone via QR over a relay, watch tool calls in real time, run multi-Pi sessions over a local Unix Domain Socket broker, and let agents talk to each other through structured request/reply.",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "dev": "tsx src/index.ts",
+    "test": "vitest run",
+    "pi": "tsc && REMOTE_PI_RELAY=ws://192.168.31.240:3000 pi --no-extensions -e $(pwd)/dist/index.js",
+    "prepublishOnly": "pnpm typecheck && pnpm test && pnpm build"
+  },
+  "keywords": [
+    "pi",
+    "pi-package",
+    "pi-extension",
+    "pi-coding-agent",
+    "remote-control",
+    "mobile",
+    "coding-agent",
+    "agent-mesh",
+    "agent-network",
+    "uds",
+    "broker",
+    "qr-pairing",
+    "websocket"
+  ],
+  "pi": {
+    "extensions": ["./dist"]
+  },
+  "author": "Jacob Moura <jacobmoura7@github>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jacobmoura7/remote-pi.git",
+    "directory": "pi-extension"
+  },
+  "homepage": "https://github.com/jacobmoura7/remote-pi#readme",
+  "bugs": {
+    "url": "https://github.com/jacobmoura7/remote-pi/issues"
+  },
+  "files": [
+    "dist",
+    "skills",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "pnpm": {
+    "onlyBuiltDependencies": [
+      "@google/genai",
+      "esbuild",
+      "koffi",
+      "protobufjs"
+    ]
+  },
+  "devDependencies": {
+    "@types/node": "^25.8.0",
+    "@types/ws": "^8.18.1",
+    "tsx": "^4.22.0",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.6"
+  },
+  "dependencies": {
+    "@mariozechner/pi-coding-agent": "^0.73.1",
+    "@noble/ed25519": "^3.1.0",
+    "keytar": "^7.9.0",
+    "qrcode-terminal": "^0.12.0",
+    "typebox": "^1.1.38",
+    "ws": "^8.20.1"
+  }
+}