esque-bridge 0.6.2 → 0.6.4

package/index.js

@@ -709,22 +709,26 @@ const PREVIEW_RE = /^[ \t>*`-]*ESQUE_PREVIEW:\s*(.+?)\s*@\s*(\d+)\s*`?[ \t]*$/im
 
 // If the agent's reply declares a preview, start it (bridge-owned) and
 // swap the marker line for the public URL the phone can open.
+// Returns { text, buildError }. `buildError` is the short failure summary when
+// the declared preview started but its web bundle didn't compile (else null) —
+// the caller uses it to drive the auto-fix loop.
 async function applyPreview(text) {
-  if (!text) return text;
+  if (!text) return { text, buildError: null };
   const m = text.match(PREVIEW_RE);
-  if (!m) return text;
+  if (!m) return { text, buildError: null };
   const cmd = m[1].trim();
   const port = Number(m[2]);
   let result = null;
   try { result = await startPreview(cmd, port); } catch (e) { console.error('[preview] error:', e.message); }
   let replacement;
+  let buildError = null;
   if (!result) {
     replacement = `(Couldn't auto-start the preview — run \`${cmd}\` in ${WORKDIR} yourself.)`;
   } else if (result.buildError) {
+    buildError = result.buildError;
     // Surface the failure as plain text WITHOUT the URL — the app turns any
     // URL in a message into a "Preview Build" pill, and we don't want a pill
-    // that just opens a blank page. The error tells the user (and the agent,
-    // who sees this reply) exactly what to fix.
+    // that just opens a blank page.
     replacement =
       `⚠️ Preview build failed — the web bundle didn't compile:\n\n` +
       `${result.buildError}\n\n` +
@@ -732,12 +736,35 @@ async function applyPreview(text) {
   } else {
     replacement = `🔗 Live preview: ${result.url}`;
   }
-  return text.replace(PREVIEW_RE, replacement);
+  return { text: text.replace(PREVIEW_RE, replacement), buildError };
 }
 
 async function runAgentWithPreview(prompt, sessionId) {
   const result = await runAgent(prompt, sessionId);
-  if (result && result.text) result.text = await applyPreview(result.text);
+  if (!result || !result.text) return result;
+
+  const applied = await applyPreview(result.text);
+  result.text = applied.text;
+
+  // Auto-fix (one retry): the agent's own session history never saw our
+  // rewritten reply, so if the preview failed to build we hand the error back
+  // to the agent — same session (--resume), so it has full context — and let
+  // it fix the cause and re-emit the marker. Bounded at a single retry so a
+  // stubborn error can't loop.
+  if (applied.buildError) {
+    console.log('[preview] build failed — handing the error back to the agent (1 retry)');
+    const fixPrompt =
+      `The live preview you just started failed to build with this error:\n\n` +
+      `${applied.buildError}\n\n` +
+      `Fix the root cause in the code, then re-emit the ESQUE_PREVIEW marker on ` +
+      `its own line. Keep the explanation brief — make the fix and output the marker.`;
+    let fix = null;
+    try { fix = await runAgent(fixPrompt, sessionId); } catch (e) { console.error('[preview] auto-fix run failed:', e.message); }
+    if (fix && fix.text) {
+      const fixApplied = await applyPreview(fix.text);
+      result.text = `${applied.text}\n\n— Auto-fix attempt —\n${fixApplied.text}`;
+    }
+  }
   return result;
 }
 
@@ -765,10 +792,35 @@ function gcJobs() {
 // never keeps the process alive on its own.
 setInterval(gcJobs, 60_000).unref?.();
 
+// Ping the phone via Expo's push service when a job finishes, so the user is
+// notified even with the app backgrounded or closed (iOS suspends the phone's
+// polling loop). The data payload mirrors the app's local-notification schema
+// so a tapped push lands in the right session. No-op for non-Expo tokens.
+async function sendExpoPush(token, kind, sessionId, title, message) {
+  if (!token || !String(token).startsWith('ExponentPushToken[')) return;
+  try {
+    await fetch('https://exp.host/--/api/v2/push/send', {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json', Accept: 'application/json' },
+      body: JSON.stringify({
+        to: token,
+        title,
+        body: String(message || '').replace(/\s+/g, ' ').trim().slice(0, 178) || 'Tap to review.',
+        sound: 'default',
+        priority: 'high',
+        data: { kind, sessionId },
+      }),
+    });
+  } catch (e) {
+    console.error('[push] send failed:', e.message);
+  }
+}
+
 async function executeHandler(req, res) {
   const body = req.body || {};
   const prompt = String(body.prompt || '');
   const esqueSessionId = body.sessionId ?? null;
+  const pushToken = typeof body.pushToken === 'string' ? body.pushToken : null;
   if (!prompt.trim()) {
     return res.status(400).json({ text: 'Empty prompt.', status: 'blocked' });
   }
@@ -799,6 +851,14 @@ async function executeHandler(req, res) {
         console.log(
           `[bridge] done  job=${jobId}  ${result.isError ? 'blocked' : 'finished'}`,
         );
+        const ok = !result.isError;
+        sendExpoPush(
+          pushToken,
+          ok ? 'finished' : 'blocked',
+          esqueSessionId,
+          ok ? '✅ Step complete' : '⚠️ Agent needs you',
+          result.text,
+        );
       })
       .catch((err) => {
         jobs.set(jobId, {
@@ -807,6 +867,7 @@ async function executeHandler(req, res) {
           createdAt: Date.now(),
         });
         console.error(`[bridge] error  job=${jobId}:`, err.message);
+        sendExpoPush(pushToken, 'blocked', esqueSessionId, '⚠️ Agent hit an error', err.message);
       });
     return;
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "esque-bridge",
-  "version": "0.6.2",
+  "version": "0.6.4",
   "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"