esque-bridge 0.6.13 → 0.6.14

package/index.js

@@ -191,6 +191,47 @@ function clearCliSessionId(agent, esqueSessionId) {
   saveSessions();
 }
 
+// --- Handoff log ----------------------------------------------------------
+// A running, on-disk record of each turn (prompt + what the agent did), kept in
+// the project folder. Its whole purpose is to survive a lost CLI session: if
+// the agent's conversation memory is ever GC'd, the fresh session is told to
+// read this file and recover the project's context — so a memory reset doesn't
+// mean starting from zero. Best-effort; bounded so it stays readable.
+const HANDOFF_MAX = 48 * 1024;
+function handoffRel(esqueSessionId) {
+  const short = String(esqueSessionId || 'default').replace(/[^a-zA-Z0-9_-]/g, '').slice(0, 16) || 'default';
+  return `.esque/handoff-${short}.md`;
+}
+function handoffPath(esqueSessionId) {
+  return path.join(WORKDIR, handoffRel(esqueSessionId));
+}
+function appendHandoff(esqueSessionId, prompt, replyText) {
+  if (!esqueSessionId) return;
+  try {
+    fs.mkdirSync(path.join(WORKDIR, '.esque'), { recursive: true });
+    const file = handoffPath(esqueSessionId);
+    const header = fs.existsSync(file)
+      ? ''
+      : "# Esque handoff log\n\n> A running record of this project's work so your AI agent can recover context if its session is ever reset. Safe to delete (or add `.esque/` to .gitignore).\n\n";
+    const reply = String(replyText || '').trim().replace(/\n{3,}/g, '\n\n').slice(0, 1200);
+    const stamp = new Date().toISOString();
+    fs.appendFileSync(
+      file,
+      `${header}## ${stamp}\n\n**Prompt:** ${String(prompt || '').slice(0, 600)}\n\n**Agent:** ${reply || '(no output)'}\n\n---\n\n`,
+    );
+    // Keep it bounded: on overflow, retain the most recent entries (trim to a
+    // clean entry boundary so the recovered context reads cleanly).
+    const buf = fs.readFileSync(file, 'utf8');
+    if (buf.length > HANDOFF_MAX) {
+      const tail = buf.slice(buf.length - HANDOFF_MAX);
+      const cut = tail.indexOf('\n## ');
+      fs.writeFileSync(file, '# Esque handoff log (older entries trimmed)\n\n' + (cut >= 0 ? tail.slice(cut + 1) : tail));
+    }
+  } catch {
+    /* best-effort — never let handoff bookkeeping break a turn */
+  }
+}
+
 // --- Adapters -------------------------------------------------------------
 // Each adapter describes how to invoke a CLI for a single prompt. The
 // runner is identical across adapters; only argv-building and stdout
@@ -542,7 +583,23 @@ async function runAgentResilient(prompt, esqueSessionId) {
     if (prevId && RESUME_FAIL_RE.test(String(err && err.message))) {
       console.warn('[bridge] stored CLI session is gone — retrying as a fresh session');
       clearCliSessionId(AGENT_TYPE, esqueSessionId);
-      return runAgent(prompt, esqueSessionId);
+      // The agent lost its memory. If we've been keeping a handoff log, point
+      // the fresh session at it FIRST so it recovers the project's context
+      // instead of starting from zero.
+      let recovered = prompt;
+      try {
+        if (fs.existsSync(handoffPath(esqueSessionId))) {
+          recovered =
+            `[Esque session recovery] Your previous conversation in this project was reset and its in-memory context was lost. ` +
+            `BEFORE anything else, read the file \`${handoffRel(esqueSessionId)}\` in this folder — a running log of everything done in this project so far — and use it to reconstruct context. Then carry out this request:\n\n${prompt}`;
+        }
+      } catch {
+        /* fall back to the bare prompt */
+      }
+      const fresh = await runAgent(recovered, esqueSessionId);
+      // Tell the phone the agent's memory was reset (it ignores the field if
+      // unknown). Older bridges never set it.
+      return { ...fresh, sessionReset: true };
     }
     throw err;
   }
@@ -1284,11 +1341,13 @@ async function executeHandler(req, res) {
         jobs.set(jobId, {
           status: result.isError ? 'blocked' : 'finished',
           text: result.text,
+          sessionReset: !!result.sessionReset,
           createdAt: Date.now(),
         });
         console.log(
           `[bridge] done  job=${jobId}  ${result.isError ? 'blocked' : 'finished'}`,
         );
+        if (!result.isError) appendHandoff(esqueSessionId, prompt, result.text);
         const ok = !result.isError;
         sendExpoPush(
           pushToken,
@@ -1335,9 +1394,11 @@ async function executeHandler(req, res) {
 
   try {
     const result = await enqueueRun(prompt, esqueSessionId);
+    if (!result.isError) appendHandoff(esqueSessionId, prompt, result.text);
     finish({
       text: result.text,
       status: result.isError ? 'blocked' : 'finished',
+      sessionReset: !!result.sessionReset,
     });
   } catch (err) {
     console.error('[bridge] error:', err.message);
@@ -1355,7 +1416,7 @@ function resultHandler(req, res) {
       text: 'That task is no longer available — the bridge may have restarted.',
     });
   }
-  res.json({ status: job.status, text: job.text });
+  res.json({ status: job.status, text: job.text, sessionReset: !!job.sessionReset });
 }
 
 // Single-flight wrapper for reviving the saved preview: GET /preview and the

package/package.json

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