@proagentstore/cli 0.2.4 → 0.2.5

package/dist/browser-runner/coding/headless.js

@@ -149,6 +149,7 @@ export class HeadlessSession {
             /* ignore */
         }
         this.run = "idle";
+        this.lastOutputAt = Date.now();
     }
     /** Tear the process down. */
     stop() {

package/dist/browser-runner/coding/runtime.js

@@ -98,6 +98,20 @@ export class CodingRuntime {
             tmuxSession: s.sessionName,
         }));
     }
+    /** Rich diagnostics for every tracked session — the console's transparency view. */
+    diagnostics() {
+        return [...this.sessions.entries()].map(([sessionId, s]) => ({
+            sessionId,
+            tmuxSession: s.sessionName,
+            alive: s.alive,
+            runState: s.alive ? s.runState() : "idle",
+            ready: s.alive ? s.ready : false,
+            paneLines: s.alive ? (s.snapshot().split("\n").length) : 0,
+            clientType: s.config.clientType,
+            workDir: s.config.workDir,
+            takeover: this.takeovers.has(sessionId),
+        }));
+    }
     // ── Human takeover (the "stuck" handoff) ────────────────────────────────
     // A text-frame equivalent of the browser takeover: the console shows the live
     // pane and forwards the human's keystrokes until they Resume.

package/dist/browser-runner/server.js

@@ -161,6 +161,20 @@ async function route(runner, req, res) {
     if (req.method === "GET" && path === "/coding/sessions") {
         return json(res, 200, { sessions: runner.coding.list() });
     }
+    if (req.method === "GET" && path === "/coding/diagnostics") {
+        const { listSessions: tmuxList } = await import("./coding/tmux.js");
+        const allTmux = tmuxList();
+        const pagsTmux = allTmux.filter((n) => n.startsWith("pags-"));
+        const tracked = runner.coding.diagnostics();
+        const trackedNames = new Set(tracked.map((s) => s.tmuxSession));
+        const orphanedTmux = pagsTmux.filter((n) => !trackedNames.has(n));
+        return json(res, 200, {
+            tracked,
+            orphanedTmux,
+            tmuxTotal: allTmux.length,
+            pagsTmuxTotal: pagsTmux.length,
+        });
+    }
     if (req.method === "POST" && path === "/coding/event") {
         // Brain progress events — recorded by PAGS, ignored locally. Accept + ack.
         return json(res, 200, { ok: true });

package/dist/index.js

@@ -905,6 +905,98 @@ function responseErrorMessage(data, text, statusText) {
 function collectCapability(value, previous = []) {
   return [...previous, value];
 }
+async function connectViaRelay(instanceIds, localUrl, runnerToken, opts) {
+  const apiBase = pagsApiBase(opts.apiBase).replace(/^http/, "ws");
+  const pagsToken = clean(opts.pagsToken) || clean(process.env.PAGS_TOKEN) || clean(loadSession()?.token);
+  if (!pagsToken) throw new Error("PAGS token required for WebSocket relay");
+  const capabilities = await requestRunner("GET", "/capabilities", { url: localUrl, token: runnerToken, instanceId: instanceIds[0] });
+  const caps = Array.isArray(capabilities.capabilities) ? capabilities.capabilities.filter((item) => typeof item === "string") : [];
+  for (const id of instanceIds) {
+    await requestPags("POST", `/v1/instances/${apiPathSegment(id)}/runtime`, opts, {
+      endpointUrl: localUrl,
+      token: runnerToken,
+      placement: "local",
+      capabilities: caps,
+      runnerVersion: ""
+    }).catch((e) => writeError(`register ${id.slice(0, 8)}\u2026 failed: ${e instanceof Error ? e.message : String(e)}`));
+  }
+  for (const id of instanceIds) {
+    openRelaySocket(id, apiBase, pagsToken, localUrl, runnerToken);
+  }
+  writeLine("Runtime registered with PAGS \u2713");
+  writeLine("");
+  writeLine("\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550");
+  writeLine("  \u2705 CONNECTED \u2014 WebSocket relay (no tunnel)");
+  writeLine(`  Agents:   ${instanceIds.length} instance${instanceIds.length === 1 ? "" : "s"}`);
+  writeLine("  No cloudflared needed. Ctrl+C to disconnect.");
+  writeLine("\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550");
+  let stopped = false;
+  const heartbeatLoop = async () => {
+    while (!stopped) {
+      await new Promise((r) => setTimeout(r, 3e4));
+      if (stopped) break;
+      for (const id of instanceIds) {
+        await requestPags("POST", `/v1/instances/${apiPathSegment(id)}/runtime/heartbeat`, opts, {}).catch(() => void 0);
+      }
+    }
+  };
+  void heartbeatLoop();
+  process.once("beforeExit", () => {
+    stopped = true;
+  });
+}
+function openRelaySocket(instanceId, wsBase, pagsToken, localUrl, runnerToken) {
+  let backoffMs = 1e3;
+  let reconnecting = false;
+  const connect = () => {
+    const url = `${wsBase}/v1/relay/${encodeURIComponent(instanceId)}/connect?token=${encodeURIComponent(pagsToken)}`;
+    const ws = new WebSocket(url);
+    ws.onopen = () => {
+      backoffMs = 1e3;
+      writeLine(`Relay connected: ${instanceId.slice(0, 8)}\u2026`);
+    };
+    ws.onmessage = async (event) => {
+      const text = typeof event.data === "string" ? event.data : String(event.data);
+      let cmd;
+      try {
+        cmd = JSON.parse(text);
+      } catch {
+        return;
+      }
+      if (!cmd.id || !cmd.path) return;
+      const method = (cmd.method || "POST").toUpperCase();
+      const hasBody = method !== "GET" && method !== "HEAD" && cmd.body !== void 0;
+      try {
+        const headers = {};
+        if (hasBody) headers["Content-Type"] = "application/json";
+        if (runnerToken) headers.Authorization = `Bearer ${runnerToken}`;
+        headers["X-PAGS-Instance-Id"] = instanceId;
+        const res = await fetch(`${localUrl}${cmd.path}`, {
+          method,
+          headers,
+          body: hasBody ? JSON.stringify(cmd.body) : void 0
+        });
+        const result = await res.json().catch(() => ({}));
+        ws.send(JSON.stringify({ id: cmd.id, status: res.status, result }));
+      } catch (err) {
+        ws.send(JSON.stringify({ id: cmd.id, status: 500, error: err instanceof Error ? err.message : String(err) }));
+      }
+    };
+    ws.onclose = () => {
+      if (reconnecting) return;
+      reconnecting = true;
+      writeLine(`Relay disconnected: ${instanceId.slice(0, 8)}\u2026 \u2014 reconnecting in ${Math.round(backoffMs / 1e3)}s`);
+      setTimeout(() => {
+        reconnecting = false;
+        connect();
+      }, backoffMs);
+      backoffMs = Math.min(backoffMs * 2, 3e4);
+    };
+    ws.onerror = () => {
+    };
+  };
+  connect();
+}
 function createRunnerCommand() {
   const command = new Command6("runner").description(
     "Manage the local FAGS browser runtime for ProAgentStore agents"
@@ -912,7 +1004,7 @@ function createRunnerCommand() {
   command.command("start").description("Start the local FAGS browser runtime in the foreground").option("--host <host>", "Host to bind", "127.0.0.1").option("--port <port>", "Port to bind", "49171").option("--data-dir <path>", "Runner data directory").option("--token <token>", "Require this bearer token").option("--instance-id <id>", "Bind runner requests to a PAGS instance id").option("--headless", "Run Playwright headless").action(async (opts) => {
     await startRunnerForeground(opts);
   });
-  command.command("connect <instanceIds...>").description("Start ONE local runtime, open a Cloudflare quick tunnel, and register it for every given PAGS instance").option("--host <host>", "Host to bind", "127.0.0.1").option("--port <port>", "Port to bind", "49171").option("--data-dir <path>", "Runner data directory").option("--token <token>", "Runner bearer token. Defaults to PAGS_RUNNER_TOKEN or a generated token").option("--headless", "Run Playwright headless").option("--api-base <url>", "PAGS API base URL").option("--pags-token <token>", "PAGS session token. Defaults to PAGS_TOKEN").option("--cloudflared <path>", "cloudflared executable").option("--runner-version <version>", "Runner version").option("--skip-probe", "Skip PAGS FAGS-runtime probe after registration").action(async (instanceIds, opts) => {
+  command.command("connect <instanceIds...>").description("Start ONE local runtime, open a Cloudflare quick tunnel, and register it for every given PAGS instance").option("--host <host>", "Host to bind", "127.0.0.1").option("--port <port>", "Port to bind", "49171").option("--data-dir <path>", "Runner data directory").option("--token <token>", "Runner bearer token. Defaults to PAGS_RUNNER_TOKEN or a generated token").option("--headless", "Run Playwright headless").option("--api-base <url>", "PAGS API base URL").option("--pags-token <token>", "PAGS session token. Defaults to PAGS_TOKEN").option("--cloudflared <path>", "cloudflared executable").option("--runner-version <version>", "Runner version").option("--skip-probe", "Skip PAGS FAGS-runtime probe after registration").option("--tunnel <mode>", "Tunnel mode: 'ws' (WebSocket relay), 'named' (production), or 'quick' (default)", "quick").action(async (instanceIds, opts) => {
     const runnerToken = clean(opts.token) || clean(process.env.PAGS_RUNNER_TOKEN) || `pags_runner_${randomUUID()}`;
     const host = clean(opts.host) || "127.0.0.1";
     const port = clean(opts.port) || String(await findFreePort2(49171));
@@ -951,6 +1043,77 @@ function createRunnerCommand() {
     try {
       await waitForLocalRunner({ url: localUrl, token: runnerToken, instanceId: primary });
       writeLine(`Local FAGS runtime healthy at ${localUrl}`);
+      if (opts.tunnel === "ws") {
+        await connectViaRelay(instanceIds, localUrl, runnerToken, opts);
+        await new Promise((resolvePromise) => {
+          runner.on("exit", () => resolvePromise());
+        });
+        return;
+      }
+      if (opts.tunnel === "named") {
+        writeLine("Provisioning named tunnel\u2026");
+        const provRes = await requestPags("POST", "/v1/tunnel/provision", opts, {});
+        const prov = provRes;
+        if (!prov.connectorToken) {
+          writeError(`Named tunnel provisioning failed: ${prov.error || "no token returned"}. Falling back to quick tunnel.`);
+        } else {
+          const tunnelUrl2 = prov.endpointUrl || `https://${prov.hostname}`;
+          writeLine(`Named tunnel: ${tunnelUrl2}`);
+          const cloudflaredPath2 = await resolveCloudflaredCommand(opts.cloudflared);
+          const tunnelProc = spawn2(cloudflaredPath2, ["tunnel", "run", "--token", prov.connectorToken], {
+            stdio: ["ignore", "pipe", "pipe"],
+            shell: process.platform === "win32"
+          });
+          tunnel = tunnelProc;
+          tunnelProc.stdout?.on("data", (d2) => {
+            const t = d2.toString("utf-8");
+            if (/registered/.test(t) || /CONNECTED/.test(t)) writeLine("Named tunnel connected \u2713");
+          });
+          tunnelProc.stderr?.on("data", (d2) => {
+            const t = d2.toString("utf-8");
+            if (/registered/.test(t) || /CONNECTED/.test(t)) writeLine("Named tunnel connected \u2713");
+          });
+          await new Promise((r) => setTimeout(r, 4e3));
+          const capabilities = await requestRunner("GET", "/capabilities", { url: localUrl, token: runnerToken, instanceId: primary });
+          const caps = Array.isArray(capabilities.capabilities) ? capabilities.capabilities.filter((item) => typeof item === "string") : [];
+          for (const id of instanceIds) {
+            try {
+              await requestPags("POST", `/v1/instances/${apiPathSegment(id)}/runtime`, opts, {
+                endpointUrl: tunnelUrl2,
+                token: runnerToken,
+                placement: "local",
+                capabilities: caps,
+                runnerVersion: clean(opts.runnerVersion) || ""
+              });
+            } catch (error) {
+              writeError(`register ${id.slice(0, 8)}\u2026 failed (${error instanceof Error ? error.message : String(error)})`);
+            }
+          }
+          writeLine("Runtime registered with PAGS \u2713");
+          writeLine("");
+          writeLine("\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550");
+          writeLine("  \u2705 CONNECTED \u2014 named tunnel (production)");
+          writeLine(`  Agents:   ${instanceIds.length} instance${instanceIds.length === 1 ? "" : "s"}`);
+          writeLine(`  Endpoint: ${tunnelUrl2}`);
+          writeLine("  Stable URL \u2014 no reconnect churn. Ctrl+C to disconnect.");
+          writeLine("\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550");
+          let stopped2 = false;
+          void (async () => {
+            while (!stopped2) {
+              await new Promise((r) => setTimeout(r, 3e4));
+              if (stopped2) break;
+              for (const id of instanceIds) {
+                await requestPags("POST", `/v1/instances/${apiPathSegment(id)}/runtime/heartbeat`, opts, {}).catch(() => void 0);
+              }
+            }
+          })();
+          await new Promise((resolvePromise) => {
+            runner.on("exit", () => resolvePromise());
+          });
+          stopped2 = true;
+          return;
+        }
+      }
       const cloudflaredPath = await resolveCloudflaredCommand(opts.cloudflared);
       const openTunnel = () => new Promise((resolveTunnel, reject) => {
         let output = "";
@@ -1000,11 +1163,15 @@ function createRunnerCommand() {
       writeLine("  Auto-reconnect is on \u2014 keep this terminal open. Ctrl+C to disconnect.");
       writeLine("\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550");
       let stopped = false;
+      let consecutiveFailures = 0;
+      let respawnBackoffMs = 3e4;
+      const PROBE_FAIL_THRESHOLD = 3;
+      const MAX_BACKOFF_MS = 5 * 6e4;
       const probeTunnel = async (url) => {
         try {
           const res = await fetch(`${url.replace(/\/$/, "")}/health`, {
             headers: { Authorization: `Bearer ${runnerToken}`, "X-PAGS-Instance-Id": primary },
-            signal: AbortSignal.timeout(8e3)
+            signal: AbortSignal.timeout(1e4)
           });
           return res.ok;
         } catch {
@@ -1024,13 +1191,21 @@ function createRunnerCommand() {
           await new Promise((r) => setTimeout(r, 3e4));
           if (stopped) break;
           if (await probeTunnel(tunnelUrl)) {
+            consecutiveFailures = 0;
+            respawnBackoffMs = 3e4;
             const beat = await heartbeatAll();
             if (!beat) {
               await registerRuntime(tunnelUrl).then(() => writeLine("\u2705 Re-registered with PAGS")).catch(() => void 0);
             }
             continue;
           }
+          consecutiveFailures++;
+          if (consecutiveFailures < PROBE_FAIL_THRESHOLD) {
+            writeLine(`\u26A0 Tunnel probe failed (${consecutiveFailures}/${PROBE_FAIL_THRESHOLD}) \u2014 will retry`);
+            continue;
+          }
           writeLine("\u26A0 Tunnel unreachable \u2014 reconnecting\u2026");
+          consecutiveFailures = 0;
           try {
             if (tunnel && !tunnel.killed) tunnel.kill("SIGTERM");
           } catch {
@@ -1040,9 +1215,12 @@ function createRunnerCommand() {
             tunnel = next.proc;
             tunnelUrl = next.url;
             await registerRuntime(tunnelUrl);
+            respawnBackoffMs = 3e4;
             writeLine(`\u2705 Reconnected: ${tunnelUrl}`);
           } catch (error) {
-            writeError(`reconnect failed (${error instanceof Error ? error.message : String(error)}); retrying in 30s`);
+            writeError(`reconnect failed (${error instanceof Error ? error.message : String(error)}); retrying in ${Math.round(respawnBackoffMs / 1e3)}s`);
+            await new Promise((r) => setTimeout(r, respawnBackoffMs));
+            respawnBackoffMs = Math.min(respawnBackoffMs * 2, MAX_BACKOFF_MS);
           }
         }
       })();
@@ -1291,7 +1469,7 @@ async function stopRunnerProcesses() {
   }
   return stopped;
 }
-var upCommand = new Command7("up").description("Start the browser runner for all your agent instances").option("--headless", "Run browser in headless mode").option("--instance <id>", "Connect to a specific instance only").action(async (opts) => {
+var upCommand = new Command7("up").description("Start the browser runner for all your agent instances").option("--headless", "Run browser in headless mode").option("--instance <id>", "Connect to a specific instance only").option("--tunnel <mode>", "Tunnel mode: 'ws' (WebSocket relay, recommended), 'named' (production, stable), or 'quick' (default, trycloudflare.com)", "quick").action(async (opts) => {
   const session = requireSession();
   const state = {
     user: session.user.login,
@@ -1338,6 +1516,8 @@ var upCommand = new Command7("up").description("Start the browser runner for all
   const cliPath = process.argv[1];
   const args = [cliPath, "runner", "connect", ...instances.map((i) => i.id)];
   if (opts.headless) args.push("--headless");
+  if (opts.tunnel === "named") args.push("--tunnel", "named");
+  if (opts.tunnel === "ws") args.push("--tunnel", "ws");
   const child = spawn3(process.execPath, args, {
     stdio: ["ignore", "pipe", "pipe"],
     env: { ...process.env, PAGS_TOKEN: session.token }
@@ -1358,6 +1538,21 @@ var upCommand = new Command7("up").description("Start the browser runner for all
         printStatus(state);
         continue;
       }
+      if (trimmed.includes("Relay connected:")) {
+        state.tunnel = "online";
+        state.tunnelUrl = "WebSocket relay";
+        state.lastEvent = "Relay connected";
+        printStatus(state);
+        continue;
+      }
+      if (trimmed.includes("WebSocket relay (no tunnel)")) {
+        state.tunnel = "online";
+        state.tunnelUrl = "WebSocket relay";
+        state.registration = "registered";
+        state.lastEvent = "Connected via WebSocket relay";
+        printStatus(state);
+        continue;
+      }
       if (trimmed.includes("FAGS browser runtime listening")) {
         state.runner = "online";
         state.lastEvent = "Runner started";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@proagentstore/cli",
-  "version": "0.2.4",
+  "version": "0.2.5",
   "description": "CLI for creating, publishing, and running ProAgentStore agents",
   "license": "MIT",
   "type": "module",