esque-bridge 0.6.10 → 0.6.12

package/index.js

@@ -92,6 +92,12 @@ const BIN_OVERRIDE = argv.bin || null;
 const LT_SUBDOMAIN = argv.subdomain || process.env.LT_SUBDOMAIN || undefined;
 const SESSIONS_FILE = path.join(os.homedir(), '.esque-bridge-sessions.json');
 const SECRET_FILE = path.join(os.homedir(), '.esque-bridge-secret');
+// Where to announce the current tunnel URL so the phone can rediscover it
+// after a restart rotates the cloudflared URL. Best-effort — QR pairing works
+// without it. Override for self-hosters via --backend / ESQUE_BACKEND_URL.
+const BACKEND_URL = String(
+  argv.backend || process.env.ESQUE_BACKEND_URL || 'https://esque-backend-production.up.railway.app',
+).replace(/\/+$/, '');
 
 // Pairing secret. Persisted across restarts so a routine bridge restart
 // doesn't silently invalidate the phone's pairing (the #1 real-world
@@ -469,6 +475,26 @@ function runAgent(prompt, esqueSessionId) {
       clearTimers();
       if (truncated) return;
       if (code !== 0) {
+        // A non-zero exit usually still carries the REAL reason. `claude
+        // --print --output-format json` emits a result object with the error
+        // (API overload, usage limit, a refusal) on stdout even when it exits
+        // 1 — surfacing "exited 1" instead throws that away. Parse stdout; if
+        // there's a real message, return it as an error reply (so the phone
+        // shows the cause and the user can just resend) rather than a bare
+        // exit code. Fall back to exit-code + stderr only when stdout is empty.
+        let parsedErr = null;
+        try {
+          const p = adapter.parseOutput(stdout);
+          if (p && p.text && p.text !== '(no output)' && p.text !== '(claude returned no text)') {
+            parsedErr = p;
+          }
+        } catch {
+          /* unparseable stdout — fall through to the generic message */
+        }
+        if (parsedErr) {
+          resolveOnce({ ...parsedErr, isError: true });
+          return;
+        }
         rejectOnce(
           new Error(
             `${adapter.label} exited ${code}${stderr ? `: ${stderr.trim().slice(0, 500)}` : ''}`,
@@ -1457,21 +1483,55 @@ async function main() {
   // after a restart (the app asks GET /preview for the fresh URL).
   if (loadPreviewCmd()) revivePreview();
 
+  // Announce this tunnel URL to the backend, keyed by the persistent secret,
+  // so the phone can rediscover it after a restart rotates the URL — then
+  // refresh on a heartbeat so the mapping never expires while we're alive.
+  // Entirely best-effort: a down/unreachable backend never affects pairing or
+  // prompts (the QR already carries this URL for the current session).
+  const announce = async () => {
+    try {
+      await fetch(`${BACKEND_URL}/v1/bridge/announce`, {
+        method: 'POST',
+        headers: { 'content-type': 'application/json' },
+        body: JSON.stringify({ secret: PAIRING_SECRET, url: tunnel.url, agent: AGENT_TYPE }),
+        signal: AbortSignal.timeout(8000),
+      });
+    } catch {
+      /* best-effort rendezvous */
+    }
+  };
+  announce();
+  const announceTimer = setInterval(announce, 45_000);
+  announceTimer.unref?.();
+
   let shuttingDown = false;
   const shutdown = (signal) => {
     shuttingDown = true;
     console.log(`\n  Received ${signal} — closing tunnel…`);
+    clearInterval(announceTimer);
     // The agent runs detached in its own process group, so the terminal's
     // Ctrl-C does NOT reach it — stop it explicitly or it keeps editing
     // files with no bridge attached.
     try { activeAgentKill && activeAgentKill('SIGTERM'); } catch { /* already gone */ }
     killPreview();
+    // Best-effort deregister so the phone learns we're down right away rather
+    // than after the rendezvous TTL. Fire-and-forget — don't delay exit on it.
+    try {
+      fetch(`${BACKEND_URL}/v1/bridge/forget`, {
+        method: 'POST',
+        headers: { 'content-type': 'application/json' },
+        body: JSON.stringify({ secret: PAIRING_SECRET }),
+        signal: AbortSignal.timeout(2000),
+      }).catch(() => undefined);
+    } catch { /* ignore */ }
     try {
       tunnel.close();
     } catch {
       /* tunnel may already be closed */
     }
-    process.exit(0);
+    // Give the forget() a brief moment to flush, then exit regardless.
+    setTimeout(() => process.exit(0), 250);
+    return;
   };
   process.on('SIGINT', () => shutdown('SIGINT'));
   process.on('SIGTERM', () => shutdown('SIGTERM'));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "esque-bridge",
-  "version": "0.6.10",
+  "version": "0.6.12",
   "description": "Desktop-side receiver for the Esque Agent mobile app. Pairs your phone with a local coding-agent CLI (Claude Code, Codex, Aider, or any custom command) via a tunnel + QR code, so prompts run through your subscription instead of per-token API billing.",
   "bin": {
     "esque-bridge": "index.js"