@yefengr/pi-reach 0.0.0-stage → 0.0.2

package/dist/actions/session_new_bridge.js

@@ -0,0 +1,88 @@
+import { randomUUID } from "node:crypto";
+import { handleSessionNew } from "./handlers.js";
+const DEFAULT_TIMEOUT_MS = 5_000;
+/** Bridges a remote action to Pi's command-only, process-local newSession API. */
+export class SessionNewBridge {
+    options;
+    pending = new Map();
+    timeoutMs = DEFAULT_TIMEOUT_MS;
+    running = false;
+    switchPermit = false;
+    constructor(options) {
+        this.options = options;
+    }
+    dispatch(sender, frame) {
+        const pi = this.options.getPi();
+        if (!pi) {
+            sender.send({ type: "action_error", in_reply_to: frame.id, action: "session_new", error: "session replacement is unavailable" });
+            return;
+        }
+        if (this.running || this.pending.size > 0) {
+            sender.send({ type: "action_error", in_reply_to: frame.id, action: "session_new", error: "session replacement is already in progress" });
+            return;
+        }
+        const token = randomUUID();
+        const pending = {};
+        pending.sender = sender;
+        pending.frame = frame;
+        pending.timer = setTimeout(() => this.fail(token, pending, "session replacement dispatch timed out"), this.timeoutMs);
+        pending.timer.unref();
+        this.pending.set(token, pending);
+        try {
+            void Promise.resolve(pi.sendUserMessage(`/pi-reach internal-session-new ${token}`, { expandPromptTemplates: true }))
+                .catch(() => this.fail(token, pending, "session replacement dispatch failed"));
+        }
+        catch {
+            this.fail(token, pending, "session replacement dispatch failed");
+        }
+    }
+    async run(token, ctx) {
+        const normalized = token.trim();
+        const pending = this.pending.get(normalized);
+        if (!pending || pending.running || this.running)
+            return;
+        clearTimeout(pending.timer);
+        pending.running = true;
+        this.running = true;
+        this.switchPermit = true;
+        this.options.onCommandContext(ctx);
+        const sender = { send: (message) => this.complete(normalized, pending, message) };
+        try {
+            await handleSessionNew(ctx, sender, pending.frame, this.options.onReplaced);
+        }
+        finally {
+            this.switchPermit = false;
+            this.running = false;
+            this.options.onFinished();
+        }
+    }
+    beforeSwitch(reason) {
+        if (!this.running)
+            return undefined;
+        if (reason === "new" && this.switchPermit) {
+            this.switchPermit = false;
+            return undefined;
+        }
+        return { cancel: true };
+    }
+    beforeFork() { return this.running ? { cancel: true } : undefined; }
+    isRunning() { return this.running; }
+    clear(error = "session replacement cancelled") {
+        for (const [token, pending] of [...this.pending])
+            this.fail(token, pending, error);
+    }
+    setTimeoutForTest(timeoutMs) {
+        this.timeoutMs = Number.isFinite(timeoutMs) && timeoutMs > 0 ? timeoutMs : DEFAULT_TIMEOUT_MS;
+    }
+    fail(token, pending, error) {
+        this.complete(token, pending, { type: "action_error", in_reply_to: pending.frame.id, action: "session_new", error });
+    }
+    complete(token, pending, message) {
+        if (this.pending.get(token) !== pending)
+            return;
+        this.pending.delete(token);
+        clearTimeout(pending.timer);
+        pending.sender.send(message);
+    }
+}
+//# sourceMappingURL=session_new_bridge.js.map

package/dist/actions/session_new_bridge.js.map

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

package/dist/commands.d.ts

@@ -0,0 +1,29 @@
+import type { ExtensionAPI, ExtensionCommandContext, ExtensionContext } from "@earendil-works/pi-coding-agent";
+import { type Ed25519Keypair } from "./pairing/crypto.js";
+import type { InitialRelayResult } from "./runtime/relay_lifecycle.js";
+export type { InitialRelayResult } from "./runtime/relay_lifecycle.js";
+type CommandStartContext = Pick<ExtensionContext, "ui" | "cwd">;
+export interface RemoteCommandDependencies {
+    start(ctx: CommandStartContext): Promise<InitialRelayResult>;
+    waitForInitialRelay(): Promise<InitialRelayResult>;
+    stop(): void;
+    state(): "idle" | "started";
+    relayStatus(): string;
+    relayUrl(): string | null;
+    endpointIdentity(): Readonly<{
+        endpointId: string;
+        runtimeInstanceId: string;
+    }>;
+    activeOwnerCount(): number;
+    isOwnerActive(ownerId: string): boolean;
+    closeOwner(ownerId: string, reason: "peer_stop"): void;
+    updateEndpoint(): Promise<void>;
+    displayName(cwd?: string): string;
+    keypair(): Ed25519Keypair | null;
+    hasRelay(): boolean;
+    publishPairingOffer(code: string, expiresAt: number): boolean;
+    setCommandContext(ctx: ExtensionCommandContext): void;
+    runInternalSessionNew(token: string, ctx: ExtensionCommandContext): Promise<void>;
+}
+export declare function persistModelDefault(provider: string, modelId: string): void;
+export declare function registerCommands(pi: ExtensionAPI, deps: RemoteCommandDependencies): void;

package/dist/commands.js

@@ -0,0 +1,169 @@
+import { mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { canonicalizeEd25519PublicKey } from "./pairing/crypto.js";
+import { clampPairTtlMs, qrSession, renderQRAscii, PAIRING_INVITE_TTL_MS } from "./pairing/qr.js";
+import { listPeers, removePeer } from "./pairing/storage.js";
+import { isValidRelayUrl, isWebSocketScheme, resolveRelayUrl, saveConfig } from "./config.js";
+const PAIR_WIDGET_KEY = "pi-reach-pair-code";
+function notify(ctx, text, kind = "info") {
+    try {
+        ctx.ui.notify(text, kind);
+    }
+    catch { /* headless or stale context */ }
+}
+async function pair(ctx, args, deps) {
+    const result = deps.state() === "idle" ? await deps.start(ctx) : await deps.waitForInitialRelay();
+    if (result === "cancelled") {
+        notify(ctx, `[pi-reach] Pair requires a Relay connection; current state: ${deps.relayStatus()}.`, "warning");
+        return;
+    }
+    const keypair = deps.keypair();
+    if (!keypair) {
+        notify(ctx, "[pi-reach] Pair requires an available device identity.", "warning");
+        return;
+    }
+    if (!deps.hasRelay()) {
+        notify(ctx, `[pi-reach] Pair requires a Relay connection; current state: ${deps.relayStatus()}.`, "warning");
+        return;
+    }
+    const ttl = /--ttl\s+(\d+)/.exec(args);
+    const ttlMs = ttl ? clampPairTtlMs(Number(ttl[1]) * 1_000) : PAIRING_INVITE_TTL_MS;
+    const invite = qrSession.issueCode(ttlMs);
+    if (!deps.publishPairingOffer(invite.code, invite.expiresAt)) {
+        qrSession.clear();
+        notify(ctx, `[pi-reach] Pair requires a Relay connection; current state: ${deps.relayStatus()}.`, "warning");
+        return;
+    }
+    try {
+        ctx.ui.setWidget(PAIR_WIDGET_KEY, [
+            "Scan to pair:",
+            "",
+            renderQRAscii(invite.code),
+            "",
+            `Pairing code: ${invite.code}`,
+            `Expires at: ${new Date(invite.expiresAt).toLocaleTimeString()}`,
+        ]);
+    }
+    catch { /* headless pairing still has a status message */ }
+    notify(ctx, `[pi-reach] Pairing code ready until ${new Date(invite.expiresAt).toLocaleTimeString()}.`);
+}
+async function listDevices(ctx, deps) {
+    const peers = await listPeers();
+    if (!peers.length) {
+        notify(ctx, "[pi-reach] No paired devices.");
+        return;
+    }
+    notify(ctx, `[pi-reach] Paired devices:\n${peers.map((peer) => `* ${peer.remote_epk.slice(0, 8)} - ${peer.name}${deps.isOwnerActive(peer.remote_epk) ? " online" : ""}`).join("\n")}`);
+}
+async function revoke(args, ctx, deps) {
+    const shortId = args.trim();
+    if (!shortId) {
+        notify(ctx, "[pi-reach] Usage: /pi-reach revoke <shortid>", "warning");
+        return;
+    }
+    const matches = (await listPeers()).filter((peer) => peer.remote_epk.startsWith(shortId));
+    if (matches.length !== 1) {
+        notify(ctx, matches.length ? "[pi-reach] Ambiguous owner id." : "[pi-reach] No matching paired device.", "warning");
+        return;
+    }
+    const peer = matches[0];
+    await removePeer(peer.remote_epk);
+    let ownerId = peer.remote_epk;
+    try {
+        ownerId = canonicalizeEd25519PublicKey(peer.remote_epk, "Owner public key");
+    }
+    catch { /* retain cleanup for corrupt legacy records */ }
+    deps.closeOwner(ownerId, "peer_stop");
+    await deps.updateEndpoint();
+    notify(ctx, `[pi-reach] Revoked: ${peer.name}`);
+}
+function status(ctx, deps) {
+    const url = deps.relayUrl() ?? resolveRelayUrl().url;
+    const identity = deps.endpointIdentity();
+    const detail = deps.state() === "idle"
+        ? "off"
+        : `${deps.relayStatus()}, endpoint=${identity.endpointId}, runtime=${identity.runtimeInstanceId}, owners=${deps.activeOwnerCount()}`;
+    notify(ctx, `[pi-reach] Relay ${detail} (${url})`);
+}
+function setRelay(value, ctx) {
+    const url = value.trim();
+    if (isWebSocketScheme(url)) {
+        notify(ctx, "[pi-reach] Use http:// or https://; it is converted internally.", "warning");
+        return;
+    }
+    if (!isValidRelayUrl(url)) {
+        notify(ctx, "[pi-reach] Invalid Relay URL.", "warning");
+        return;
+    }
+    saveConfig({ relay: url });
+    notify(ctx, `[pi-reach] Relay set to ${url}.`);
+}
+export function persistModelDefault(provider, modelId) {
+    try {
+        const path = join(process.cwd(), ".pi", "settings.json");
+        let config = {};
+        try {
+            config = JSON.parse(readFileSync(path, "utf8"));
+        }
+        catch { /* fresh file */ }
+        config.defaultProvider = provider;
+        config.defaultModel = modelId;
+        mkdirSync(dirname(path), { recursive: true });
+        writeFileSync(path, JSON.stringify(config, null, 2));
+    }
+    catch { /* a live model switch must not fail because persistence failed */ }
+}
+async function command(args, ctx, deps) {
+    deps.setCommandContext(ctx);
+    const [verb, ...rest] = args.trim().split(/\s+/);
+    const value = rest.join(" ");
+    try {
+        switch (verb || "start") {
+            case "start":
+                await deps.start(ctx);
+                return;
+            case "stop":
+                deps.stop();
+                notify(ctx, "[pi-reach] Stopped.");
+                return;
+            case "status":
+                status(ctx, deps);
+                return;
+            case "pair":
+                await pair(ctx, value, deps);
+                return;
+            case "devices":
+                await listDevices(ctx, deps);
+                return;
+            case "revoke":
+                await revoke(value, ctx, deps);
+                return;
+            case "set-relay":
+                setRelay(value, ctx);
+                return;
+            case "config":
+                notify(ctx, `[pi-reach] ${resolveRelayUrl().url}`);
+                return;
+            case "internal-session-new":
+                await deps.runInternalSessionNew(value, ctx);
+                return;
+            default:
+                await deps.start(ctx);
+                return;
+        }
+    }
+    catch (error) {
+        notify(ctx, `[pi-reach] ${verb} failed: ${String(error)}`, "error");
+    }
+}
+export function registerCommands(pi, deps) {
+    const handler = (args, ctx) => command(args, ctx, deps);
+    pi.registerCommand("pi-reach", { description: "Connect this Pi endpoint to Pi Reach", handler });
+    pi.registerCommand("pi-reach start", { description: "Connect this endpoint to Relay", handler: async (_, ctx) => handler("start", ctx) });
+    pi.registerCommand("pi-reach stop", { description: "Disconnect this endpoint", handler: async (_, ctx) => handler("stop", ctx) });
+    pi.registerCommand("pi-reach pair", { description: "Show an endpoint pairing QR", handler: async (args, ctx) => handler(`pair ${args}`, ctx) });
+    pi.registerCommand("pi-reach devices", { description: "List locally paired Owners", handler: async (_, ctx) => handler("devices", ctx) });
+    pi.registerCommand("pi-reach revoke", { description: "Revoke a locally paired Owner", handler: async (args, ctx) => handler(`revoke ${args}`, ctx) });
+    pi.registerCommand("pi-reach set-relay", { description: "Set Relay URL", handler: async (args, ctx) => handler(`set-relay ${args}`, ctx) });
+}
+//# sourceMappingURL=commands.js.map

package/dist/commands.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Default community relay. Stored in canonical http(s):// form — conversion
+ * to ws(s):// happens at the transport layer (see `toWebSocketUrl`). The
+ * community relay's reverse proxy maps `:443 → :3000` (the WS port), so the
+ * URL has no explicit port and the WebSocket upgrade rides on the same TLS
+ * connection as the HTTPS endpoint used by the Relay client.
+ */
+export declare const kDefaultRelayUrl = "https://pi-reach-relay.yefengr.cn";
+export type PiReachConfig = {
+    relay?: string;
+};
+export declare function loadConfig(): PiReachConfig;
+export declare function saveConfig(patch: Partial<PiReachConfig>): void;
+export type RelayResolution = {
+    url: string;
+    source: "env" | "config" | "default";
+};
+/**
+ * Resolves the effective relay URL in **canonical http(s):// form**.
+ *
+ * Precedence:
+ *   1. `PI_REACH_RELAY` env var (ops/CI escape hatch)
+ *   2. `~/.pi/pi-reach/config.json` `relay` field (set via /pi-reach set-relay)
+ *   3. `kDefaultRelayUrl` (community default)
+ *
+ * Any ws(s):// values found in configs or env overrides are coerced
+ * to http(s):// defensively — the canonical form across the codebase is
+ * http(s)://, and the transport layer converts to ws(s):// at WS-open time.
+ */
+export declare function resolveRelayUrl(): RelayResolution;
+/**
+ * Strict validator for **user-provided** relay URLs (via `/pi-reach set-relay`).
+ *
+ * Only accepts `http://` and `https://`. `ws://`/`wss://` are deliberately
+ * **rejected** — the canonical form stored in config is http(s):// and the
+ * extension converts to ws(s):// internally when opening the WebSocket.
+ * Forcing a single scheme at the user boundary avoids two-form drift.
+ */
+export declare function isValidRelayUrl(url: string): boolean;
+/**
+ * Returns true if the URL uses ws:// or wss:// scheme — for emitting a
+ * targeted error message when the user pastes a WebSocket URL by mistake.
+ */
+export declare function isWebSocketScheme(url: string): boolean;
+/**
+ * Converts an http(s):// URL to the corresponding ws(s):// form. Used by
+ * the transport layer right before opening the WebSocket — config storage
+ * and the Relay client both stay on http(s)://.
+ *
+ *   https://host  → wss://host
+ *   http://host   → ws://host
+ *   ws(s)://host  → pass-through (defensive — env overrides or
+ *                   configs may carry ws(s)://)
+ */
+export declare function toWebSocketUrl(url: string): string;
+/**
+ * Inverse of `toWebSocketUrl`. Used by `resolveRelayUrl` to coerce any
+ * ws(s):// values back to canonical http(s):// before returning them to
+ * the rest of the codebase.
+ */
+export declare function toHttpUrl(url: string): string;

package/dist/config.js

@@ -0,0 +1,115 @@
+import fs from "node:fs";
+import path from "node:path";
+import os from "node:os";
+const CONFIG_DIR = path.join(os.homedir(), ".pi", "pi-reach");
+const CONFIG_FILE = path.join(CONFIG_DIR, "config.json");
+/**
+ * Default community relay. Stored in canonical http(s):// form — conversion
+ * to ws(s):// happens at the transport layer (see `toWebSocketUrl`). The
+ * community relay's reverse proxy maps `:443 → :3000` (the WS port), so the
+ * URL has no explicit port and the WebSocket upgrade rides on the same TLS
+ * connection as the HTTPS endpoint used by the Relay client.
+ */
+export const kDefaultRelayUrl = "https://pi-reach-relay.yefengr.cn";
+export function loadConfig() {
+    try {
+        const raw = fs.readFileSync(CONFIG_FILE, "utf8");
+        const parsed = JSON.parse(raw);
+        if (!parsed || typeof parsed !== "object")
+            return {};
+        return parsed;
+    }
+    catch {
+        return {};
+    }
+}
+export function saveConfig(patch) {
+    fs.mkdirSync(CONFIG_DIR, { recursive: true });
+    const current = loadConfig();
+    const next = { ...current, ...patch };
+    fs.writeFileSync(CONFIG_FILE, JSON.stringify(next, null, 2));
+}
+/**
+ * Resolves the effective relay URL in **canonical http(s):// form**.
+ *
+ * Precedence:
+ *   1. `PI_REACH_RELAY` env var (ops/CI escape hatch)
+ *   2. `~/.pi/pi-reach/config.json` `relay` field (set via /pi-reach set-relay)
+ *   3. `kDefaultRelayUrl` (community default)
+ *
+ * Any ws(s):// values found in configs or env overrides are coerced
+ * to http(s):// defensively — the canonical form across the codebase is
+ * http(s)://, and the transport layer converts to ws(s):// at WS-open time.
+ */
+export function resolveRelayUrl() {
+    const env = process.env["PI_REACH_RELAY"];
+    if (env && env.length > 0)
+        return { url: toHttpUrl(env), source: "env" };
+    const cfg = loadConfig();
+    if (cfg.relay && cfg.relay.length > 0) {
+        return { url: toHttpUrl(cfg.relay), source: "config" };
+    }
+    return { url: toHttpUrl(kDefaultRelayUrl), source: "default" };
+}
+/**
+ * Strict validator for **user-provided** relay URLs (via `/pi-reach set-relay`).
+ *
+ * Only accepts `http://` and `https://`. `ws://`/`wss://` are deliberately
+ * **rejected** — the canonical form stored in config is http(s):// and the
+ * extension converts to ws(s):// internally when opening the WebSocket.
+ * Forcing a single scheme at the user boundary avoids two-form drift.
+ */
+export function isValidRelayUrl(url) {
+    if (!url)
+        return false;
+    const lower = url.toLowerCase();
+    if (!lower.startsWith("http://") && !lower.startsWith("https://"))
+        return false;
+    try {
+        new URL(url);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Returns true if the URL uses ws:// or wss:// scheme — for emitting a
+ * targeted error message when the user pastes a WebSocket URL by mistake.
+ */
+export function isWebSocketScheme(url) {
+    const lower = url.toLowerCase();
+    return lower.startsWith("ws://") || lower.startsWith("wss://");
+}
+/**
+ * Converts an http(s):// URL to the corresponding ws(s):// form. Used by
+ * the transport layer right before opening the WebSocket — config storage
+ * and the Relay client both stay on http(s)://.
+ *
+ *   https://host  → wss://host
+ *   http://host   → ws://host
+ *   ws(s)://host  → pass-through (defensive — env overrides or
+ *                   configs may carry ws(s)://)
+ */
+export function toWebSocketUrl(url) {
+    const lower = url.toLowerCase();
+    if (lower.startsWith("https://"))
+        return "wss://" + url.slice("https://".length);
+    if (lower.startsWith("http://"))
+        return "ws://" + url.slice("http://".length);
+    return url;
+}
+/**
+ * Inverse of `toWebSocketUrl`. Used by `resolveRelayUrl` to coerce any
+ * ws(s):// values back to canonical http(s):// before returning them to
+ * the rest of the codebase.
+ */
+export function toHttpUrl(url) {
+    const lower = url.toLowerCase();
+    if (lower.startsWith("wss://"))
+        return "https://" + url.slice("wss://".length);
+    if (lower.startsWith("ws://"))
+        return "http://" + url.slice("ws://".length);
+    return url;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,SAAS,CAAC;AAEzB,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC;AAC9D,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;AAEzD;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,mCAAmC,CAAC;AAIpE,MAAM,UAAU,UAAU;IACxB,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;QACjD,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,MAAuB,CAAC;IACjC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAA6B;IACtD,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9C,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,MAAM,IAAI,GAAG,EAAE,GAAG,OAAO,EAAE,GAAG,KAAK,EAAE,CAAC;IACtC,EAAE,CAAC,aAAa,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AAC/D,CAAC;AAID;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,eAAe;IAC7B,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;IAC1C,IAAI,GAAG,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,EAAE,GAAG,EAAE,SAAS,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IACzE,MAAM,GAAG,GAAG,UAAU,EAAE,CAAC;IACzB,IAAI,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtC,OAAO,EAAE,GAAG,EAAE,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;IACzD,CAAC;IACD,OAAO,EAAE,GAAG,EAAE,SAAS,CAAC,gBAAgB,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;AACjE,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,IAAI,CAAC,GAAG;QAAE,OAAO,KAAK,CAAC;IACvB,MAAM,KAAK,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;IAChC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,UAAU,CAAC;QAAE,OAAO,KAAK,CAAC;IAChF,IAAI,CAAC;QAAC,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;QAAC,OAAO,IAAI,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,KAAK,CAAC;IAAC,CAAC;AAC5D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAW;IAC3C,MAAM,KAAK,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;IAChC,OAAO,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;AACjE,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,MAAM,KAAK,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;IAChC,IAAI,KAAK,CAAC,UAAU,CAAC,UAAU,CAAC;QAAE,OAAO,QAAQ,GAAG,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IACjF,IAAI,KAAK,CAAC,UAAU,CAAC,SAAS,CAAC;QAAG,OAAO,OAAO,GAAI,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAChF,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,GAAW;IACnC,MAAM,KAAK,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;IAChC,IAAI,KAAK,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,UAAU,GAAG,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC/E,IAAI,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC;QAAG,OAAO,SAAS,GAAI,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9E,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,27 @@
+#!/usr/bin/env node
+import type { ExtensionFactory } from "@earendil-works/pi-coding-agent";
+import { type CurrentModelHint } from "./actions/handlers.js";
+export type { RelayConnectivity, RemoteState } from "./runtime/relay_lifecycle.js";
+type ProcessIdentity = Readonly<{
+    endpointId: string;
+    runtimeInstanceId: string;
+}>;
+/** One Pi process owns a fresh endpoint identity; extension reloads reuse it. */
+export declare function processEndpointIdentity(): ProcessIdentity;
+export declare const _getState: () => "idle" | "started" | "paired";
+export declare const _getCachedPublicKeyForTest: () => string | null;
+export declare const _getCurrentTurnIdForTest: () => string | null;
+export declare const _setPiForTest: (value: unknown) => void;
+export declare const _setCurrentModelForTest: (value: CurrentModelHint | undefined) => void;
+export declare const _hasPendingReconnect: () => boolean;
+export declare const _getActivePeerCountForTest: () => number;
+export declare const _hasActivePeerForTest: (ownerId: string) => boolean;
+export declare const _getDisposedForTest: () => boolean;
+export declare const _setDisposedForTest: (value: boolean) => void;
+export declare const _setSessionNewBridgeTimeoutForTest: (timeoutMs: number) => void;
+declare const extension: ExtensionFactory;
+export default extension;
+/** Compatibility seam used by focused extension tests. */
+export declare function _startRelayForTest(ctx: unknown): Promise<void>;
+export declare function _stopForTest(_ctx: unknown): Promise<void>;
+export declare function _connectForTest(ctx: unknown): Promise<void>;