@inetafrica/open-claudia 3.5.24 → 3.5.25

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## 3.5.25
+
+The Browser app feels like a browser on the phone and on the web (Sumeet, 10 Oct 08:53 EAT on his phone: "it feels like a browser on my phone… like Google Chrome app", and 09:18: "the web and mobile still need to also feel native… don't forget the website"). A canary build for the Browser canary bot first; the fleet waits for his OK.
+
+- **The bot's tab takes the driver's screen.** With Chrome in its own container, a take (or a `fit` when the screen changes: a turned phone, a resized panel, a keyboard that opens) that carries the driver's screen (`viewport`: CSS size, pixel density, phone layout, touch) fits the bot's tab to it through `core/browser-drive.js`. A phone gets the page's phone layout, full screen and sharp; the web gets a desktop page at the panel's size. Handing back puts the tab back to its own size. The browser's identity (user agent) never changes, so sites signed into stay signed in after the hand back. `GET /api/browser/control` says `fit: true`.
+- **The driver's input goes straight to Chrome,** through the view's own DevTools session, in order. Touches keep their timing, so a swipe flings; typed text is inserted whole (`input_text`, at most 500 characters: accents, emoji, the keyboard's corrections); every point is scaled by the view's density, because Chrome reads input in the drawn picture's pixels. A bot without the view takes `input_text` as key presses.
+- **The page's text fields.** The view reads where the page's text fields are and what kind they are (never a value) and streams them as `fields` events, so the Browser page opens the phone's own keyboard of the right kind the moment a field is tapped.
+- **Pictures.** The view streams its own screencast at the driver's size (at most 1.6 million pixels, 30 a second). `/api/browser/stream` serves it while someone drives, up to 30 fps, and keeps the newest frame while a slow viewer drains instead of dropping it, so the last picture of a scroll always arrives.
+- **A hand back wakes the bot only when it waits for that person:** it sent them an Open Browser card (cards now record `openApp`), or one of its browser commands was refused while they drove (the tool guard marks it). Otherwise the hand back is only logged. On 9 Oct a test hand back set off a 28-minute tangent on the canary.
+- **Correction to 3.5.24:** in container mode, sessions are not pinned to tabs (Agent Space dropped `AGENT_BROWSER_PIN_TAB` in a98f239); a session uses the tab that is open.
+- **Tests:** `test-browser-drive.js` (new), `test-browser-control.js`, `test-web-browser-app.js`.
+
 ## 3.5.24
 
 The Browser app's address bar, and Chrome in its own container (Sumeet, 9 Oct 21:27 EAT on his phone: "I can't change the url on the mobile app"). A canary build for the Browser canary bot first; the fleet waits for his OK.

package/core/browser-control.js

@@ -13,9 +13,15 @@
 //     after the input before them, with the bot's own agent-browser environment and never a
 //     launch flag (core/agent-browser-cli.js: other launch settings would restart the browser).
 //     Only public internet addresses (core/browser-address.js).
+//   - the phone and web view (core/browser-drive.js): a take or a "fit" with the driver's screen
+//     makes the bot's tab take its size, phone layout and touch, and then the driver's input goes
+//     straight to Chrome through that view (typed text too: input_text). Only with Chrome in its
+//     own container; elsewhere the browser keeps its size and input goes through agent-browser.
 //   - hand back (release, a closed panel, or a lock found expired by the 30 s sweeper): the lock
-//     goes, the socket closes, any recording stops, and the bot is woken in the person's own chat
-//     to carry on (C6). A recording stopped at the same time folds into one wake-up.
+//     goes, the view and the socket close, any recording stops, and the bot is woken in the
+//     person's own chat (C6), but only when it waits for them: it sent them an Open Browser card,
+//     or one of its browser commands was refused while they drove. A recording stopped at the
+//     same time folds into one wake-up. Otherwise the hand back is only logged.
 //
 // Every route answers { status, body }; web.js writes it. Agent Space reaches these routes with
 // the control token only.
@@ -25,6 +31,7 @@ const lockFile = require("./browser-lock");
 const view = require("./browser-view");
 const teach = require("./browser-teach");
 const address = require("./browser-address");
+const drive = require("./browser-drive");
 const { runAgentBrowser } = require("./agent-browser-cli");
 
 const LOCK_TTL_MS = lockFile.LOCK_TTL_MS;
@@ -42,6 +49,9 @@ const ID_RE = /^[A-Za-z0-9._:-]{1,100}$/;
 const NAVIGATE_TIMEOUT_MS = 20 * 1000;
 const NAVIGATIONS = new Set(["open", "back", "forward", "reload"]);
 
+// An Open Browser card counts as a request for a person this long.
+const REQUEST_MAX_AGE_MS = 24 * 60 * 60 * 1000;
+
 const HAND_BACK_REASONS = {
   closed: " (they closed the Browser)",
   expired: " (their Browser went quiet for 2 minutes, so control came back on its own)",
@@ -107,6 +117,7 @@ const MOUSE_EVENTS = new Set(["mousePressed", "mouseReleased", "mouseMoved", "mo
 const MOUSE_BUTTONS = new Set(["none", "left", "middle", "right"]);
 const KEY_EVENTS = new Set(["keyDown", "keyUp", "char"]);
 const TOUCH_EVENTS = new Set(["touchStart", "touchMove", "touchEnd", "touchCancel"]);
+const TEXT_MAX = drive.TEXT_MAX;
 
 const isNumber = (v) => typeof v === "number" && Number.isFinite(v);
 const inRange = (v, lo, hi) => isNumber(v) && v >= lo && v <= hi;
@@ -163,11 +174,34 @@ function checkEvent(ev) {
     }
     const out = { type: "input_touch", eventType: ev.eventType, touchPoints };
     if (!optional(out, "modifiers", modifiers)) return null;
+    // When the finger moved, on the driver's device (ms): keeps a swipe's speed (core/browser-drive.js).
+    if (!optional(out, "t", (v) => inRange(v, 0, 1e13))) return null;
     return out;
   }
+  // Text the driver typed (their phone keyboard, a paste), inserted where the page's caret is.
+  if (ev.type === "input_text") {
+    if (typeof ev.text !== "string" || !ev.text || Array.from(ev.text).length > TEXT_MAX) return null;
+    return { type: "input_text", text: ev.text };
+  }
   return null;
 }
 
+// input_text as key presses, for a bot without the driver's view (agent-browser's socket takes
+// no text) and for Teach me, which counts typing from key presses.
+function textAsKeys(text) {
+  const out = [];
+  for (const ch of Array.from(text)) {
+    if (ch === "\n" || ch === "\r") {
+      out.push({ type: "input_keyboard", eventType: "keyDown", key: "Enter", code: "Enter", text: "\r", windowsVirtualKeyCode: 13 });
+      out.push({ type: "input_keyboard", eventType: "keyUp", key: "Enter", code: "Enter", windowsVirtualKeyCode: 13 });
+    } else {
+      out.push({ type: "input_keyboard", eventType: "keyDown", key: ch, text: ch });
+      out.push({ type: "input_keyboard", eventType: "keyUp", key: ch });
+    }
+  }
+  return out;
+}
+
 // ---------------------------------------------------------------------------
 // Input sockets: one per agent-browser session, opened on take (or on the first input after a
 // restart), closed on hand back.
@@ -325,7 +359,23 @@ function wakeChat({ chatId, userId }, prompt, label) {
 
 function handBackLine(name, reason) {
   const who = teach.cleanName(name) || "Someone";
-  return `[Browser] ${who} handed the browser back${HAND_BACK_REASONS[reason] || ""}. If you were waiting on them, check the page first (it may have changed) and carry on; otherwise just note it.`;
+  return `[Browser] ${who} handed the browser back${HAND_BACK_REASONS[reason] || ""}. Check the page first (it may have changed), then carry on with what you were waiting on them for.`;
+}
+
+// Was the bot waiting for this person when they handed back? It asked for them with an Open
+// Browser card in their chat (since the day before they took over), or one of its own browser
+// commands was refused while they drove.
+function botWasWaiting(lock) {
+  let asked = [];
+  try {
+    const since = Date.parse(lock.since);
+    asked = require("./cards").takeBrowserRequests(lock.chatId, (Number.isFinite(since) ? since : deps.now()) - REQUEST_MAX_AGE_MS, deps.now());
+  } catch (e) {
+    console.error(`[browser] reading the bot's Open Browser cards failed: ${e.message}`);
+  }
+  const refused = lockFile.waitedDuring(lock);
+  lockFile.clearWaiting();
+  return asked.length > 0 || refused;
 }
 
 // ---------------------------------------------------------------------------
@@ -335,7 +385,39 @@ function lockBody(lock) {
   return { driving: true, driver: { name: lock.name } };
 }
 
-async function take({ session, who } = {}) {
+// The driver's view on this lock's session: start it (or move it to a new screen) and remember it
+// in the lock, so a restarted bot can bring it back. -> the fit, or null (the browser keeps its size).
+async function startView(lock, viewport) {
+  if (!viewport || !drive.supported()) return null;
+  const info = sessionInfo(lock.session);
+  if (!info) return null;
+  const r = drive.active(lock.session)
+    ? await drive.fit(viewport)
+    : await drive.start({ session: info, viewport, savedBounds: lock.bounds || null });
+  const now = lockFile.readLock();
+  // The lock changed hands (or was handed back) while the view started: undo it.
+  if (!now || now.since !== lock.since || now.userId !== lock.userId) {
+    if (r.ok && drive.active(lock.session)) await drive.stop();
+    return null;
+  }
+  if (!r.ok) return null;
+  now.fit = r.fit;
+  if (r.bounds) now.bounds = r.bounds;
+  lockFile.writeLock(now);
+  return r.fit;
+}
+
+// After a bot restart the lock remembers a view that is no longer live: bring it back. Once at a
+// time, in the background.
+let reviving = null;
+function reviveView(lock) {
+  if (!lock || !lock.fit || reviving || drive.active(lock.session) || !drive.supported()) return;
+  reviving = startView(lock, lock.fit)
+    .catch((e) => console.error(`[browser] bringing the driver's view back failed: ${e.message}`))
+    .finally(() => { reviving = null; });
+}
+
+async function take({ session, who, viewport } = {}) {
   if (!validSession(session) || !validWho(who, { needChat: true })) return reply(400, { error: "bad-request" });
   // A lock that ran out but has not been swept yet is handed back first, the sweeper's way: its
   // driver's chat is woken and their recording stopped, whoever takes over now.
@@ -354,9 +436,25 @@ async function take({ session, who } = {}) {
     since: current && current.session === session ? current.since : iso(now),
     expiresAt: iso(now + LOCK_TTL_MS),
   };
+  // The same person taking again (a reloaded page) keeps the window's size from before their view.
+  if (current && current.session === session && sameUser(current, who) && current.bounds) lock.bounds = current.bounds;
   lockFile.writeLock(lock);
   openInputSocket(session);
-  return reply(200, lockBody(lock));
+  if (!viewport) return reply(200, lockBody(lock));
+  // fit: the driver's view now live, or null (this bot's browser keeps its own size).
+  const fitted = await startView(lock, viewport);
+  return reply(200, { ...lockBody(lock), fit: fitted });
+}
+
+// The driver's screen changed (a turned phone, a resized panel): { session, who, viewport }.
+async function fitView({ session, who, viewport } = {}) {
+  if (!validSession(session) || !validWho(who)) return reply(400, { error: "bad-request" });
+  if (!drive.checkViewport(viewport)) return reply(400, { error: "bad-viewport" });
+  const lock = extendDriverLock(session, who);
+  if (!lock) return reply(409, { driving: false, error: "not-driving" });
+  if (!drive.supported()) return reply(200, { ...lockBody(lock), fit: null });
+  const fitted = await startView(lock, viewport);
+  return reply(200, { ...lockBody(lock), fit: fitted });
 }
 
 function renew({ session, who } = {}) {
@@ -369,7 +467,8 @@ function renew({ session, who } = {}) {
   current.expiresAt = iso(now + LOCK_TTL_MS);
   lockFile.writeLock(current);
   openInputSocket(current.session); // after a restart the socket comes back here
-  return reply(200, lockBody(current));
+  reviveView(current); // and the driver's view
+  return reply(200, current.fit ? { ...lockBody(current), fit: drive.active(current.session) ? current.fit : null } : lockBody(current));
 }
 
 // Hand the browser back: claim the lock (synchronously, so a release and the sweeper never both
@@ -383,6 +482,13 @@ async function handBack(expected, { reason = null } = {}) {
   let stopped = null;
   await runQueued(current.session, 0, async () => {
     closeInputSocket(current.session);
+    // The bot's tab goes back to its own size before the bot carries on.
+    try {
+      if (drive.active(current.session)) await drive.stop();
+      else if (current.bounds) await drive.restoreWindow(info, current.bounds);
+    } catch (e) {
+      console.error(`[browser] ending the driver's view failed: ${e.message}`);
+    }
     try {
       stopped = await teach.stopRecording(current.userId, { session: info });
     } catch (e) {
@@ -390,9 +496,10 @@ async function handBack(expected, { reason = null } = {}) {
     }
   });
   const line = handBackLine(current.name, reason);
+  const waited = botWasWaiting(current);
   if (stopped && !stopped.discarded) wakeChat(current, teach.teachPrompt(stopped, { handBack: line }), "Teach me");
-  else wakeChat(current, line, "Browser");
-  console.log(`[browser] ${current.userId} handed the browser back${reason ? ` (${reason})` : ""}`);
+  else if (waited) wakeChat(current, line, "Browser");
+  console.log(`[browser] ${current.userId} handed the browser back${reason ? ` (${reason})` : ""}${waited || (stopped && !stopped.discarded) ? "" : "; the bot was not waiting for them, so it is not woken"}`);
   return true;
 }
 
@@ -409,10 +516,12 @@ async function control(body = {}) {
   if (body.action === "take") return take(body);
   if (body.action === "renew") return renew(body);
   if (body.action === "release") return release(body);
+  if (body.action === "fit") return fitView(body);
   return reply(400, { error: "bad-action" });
 }
 
-// navigate: true tells the front door this bot has the address bar (POST /api/browser/navigate).
+// navigate: true tells the front door this bot has the address bar (POST /api/browser/navigate);
+// fit: true that a take can bring the driver's view (core/browser-drive.js) and input_text works.
 function status() {
   const lock = lockFile.liveLock(deps.now());
   return reply(200, {
@@ -420,6 +529,7 @@ function status() {
     driver: lock ? { name: lock.name, userId: lock.userId } : null,
     recording: teach.activeSummary(),
     navigate: true,
+    fit: drive.supported(),
   });
 }
 
@@ -436,24 +546,41 @@ async function input({ session, events, who } = {}) {
     messages.push(msg);
   }
   // Every accepted input extends the lock.
-  if (!extendDriverLock(session, who)) return reply(409, { error: "not-driving" });
+  const lock = extendDriverLock(session, who);
+  if (!lock) return reply(409, { error: "not-driving" });
   if (!messages.length) return reply(200, { ok: true, accepted: 0 });
+  if (lock.fit && !drive.active(session)) reviveView(lock);
   const entry = openInputSocket(session);
-  if (!entry) return reply(404, { error: "not-running" });
+  if (!entry && !drive.active(session)) return reply(404, { error: "not-running" });
   const job = runQueued(session, messages.length, async () => {
-    if (!(await socketReady(entry))) return reply(503, { error: "browser-unavailable", accepted: 0 });
     const recorder = teach.recorderFor(session, who.userId);
-    let sent = 0;
-    for (const msg of messages) {
-      if (recorder) {
+    const record = async (msg, frame, info) => {
+      if (!recorder) return;
+      // Teach me counts typing from key presses: typed text is shown to it as keys.
+      for (const ev of msg.type === "input_text" ? textAsKeys(msg.text) : [msg]) {
         try {
-          await recorder.onEvent(msg, { session: { name: entry.name, dir: entry.dir }, frame: entry.frame });
+          await recorder.onEvent(ev, { session: info, frame });
         } catch (e) {
           console.error(`[browser] recording a step failed: ${e.message}`);
         }
       }
+    };
+    // The driver's view: straight to Chrome, in order, without waiting for each answer.
+    if (drive.active(session)) {
+      const info = sessionInfo(session) || { name: session, dir: entry ? entry.dir : null };
+      for (const msg of messages) {
+        await record(msg, drive.lastFrame(), { name: info.name, dir: info.dir });
+        if (drive.dispatch([msg]) < 0) return reply(503, { error: "browser-unavailable" });
+      }
+      return reply(200, { ok: true, accepted: messages.length });
+    }
+    if (!entry || !(await socketReady(entry))) return reply(503, { error: "browser-unavailable", accepted: 0 });
+    let sent = 0;
+    for (const msg of messages) {
+      await record(msg, entry.frame, { name: entry.name, dir: entry.dir });
       if (!entry.open || entry.closed) return reply(503, { error: "browser-unavailable", accepted: sent });
-      entry.ws.send(JSON.stringify(msg));
+      // agent-browser's socket takes no text: typed text goes as key presses.
+      for (const ev of msg.type === "input_text" ? textAsKeys(msg.text) : [msg]) entry.ws.send(JSON.stringify(ev));
       sent += 1;
     }
     return reply(200, { ok: true, accepted: sent });
@@ -602,6 +729,8 @@ function _reset() {
   for (const name of [...sockets.keys()]) closeInputSocket(name);
   queues.clear();
   if (sweepTimer) { clearInterval(sweepTimer); sweepTimer = null; }
+  reviving = null;
+  drive._reset();
   deps = defaultDeps();
 }
 
@@ -613,6 +742,7 @@ module.exports = {
   checkEvent,
   chatOrigin,
   control,
+  fitView,
   handBackLine,
   input,
   navigate,

package/core/browser-drive.js

@@ -0,0 +1,589 @@
+// The Browser app's phone and web view (bot apps v2): while a person drives the bot's browser and
+// Chrome runs in its own container (AGENT_BROWSER_CDP), the bot's tab takes the driver's screen.
+// Its size and pixel density, a phone's page layout and touch on a phone, a desktop's on the web.
+// This module's own DevTools connection then carries the driver's whole session:
+//   - the picture: a screencast at the driver's size, so text is sharp on their screen;
+//   - their input: mouse, keys, touch and typed text, straight to Chrome, in order;
+//   - the page's text fields (where they are, what kind), so the driver's own keyboard opens the
+//     moment they tap one.
+// Handing back (stop) closes the connection. Chrome drops the size, layout and touch with it, and
+// the window goes back to the size it had.
+//
+// Why the window is resized too: Chrome's screencast pictures the window, so a phone-size view in
+// a desktop-size window comes out boxed in a corner after the next page load (proven 10 Oct on
+// Chrome 149). Order matters: the view first, then the window, or the first pictures stay at 1x.
+// The browser's identity (user agent) never changes: sites the bot or the person signed into
+// must see the same browser after the hand back.
+//
+// Only one drive at a time (the driver lock is single). Nothing here decides who may drive:
+// core/browser-control.js does, and calls start / fit / dispatch / stop.
+
+const WebSocket = require("ws");
+const view = require("./browser-view");
+
+const QUALITY = 65;
+const MAX_FPS = 30;
+// A drive's picture is at most this many device pixels (a phone at 2x is about 1.3 million).
+const MAX_PIXELS = 1600000;
+const MIN_SIDE = 240;
+const MAX_SIDE = 1920;
+const MAX_DPR = 3;
+const CALL_TIMEOUT_MS = 4000;
+const CONNECT_TIMEOUT_MS = 3000;
+// The text fields are read this long after the page stops changing (and after a tap).
+const FIELDS_SETTLE_MS = 250;
+const MAX_FIELDS = 60;
+const TEXT_MAX = 500;
+
+function defaultDeps() {
+  return {
+    now: () => Date.now(),
+    endpoint: () => view.cdpEndpoint(),
+    fetchJson: async (url) => {
+      const ctrl = new AbortController();
+      const timer = setTimeout(() => ctrl.abort(), CONNECT_TIMEOUT_MS);
+      if (timer.unref) timer.unref();
+      try {
+        const res = await fetch(url, { signal: ctrl.signal });
+        if (!res.ok) throw new Error(`HTTP ${res.status}`);
+        return await res.json();
+      } finally {
+        clearTimeout(timer);
+      }
+    },
+    connect: (url) => new WebSocket(url, { perMessageDeflate: false }),
+    targetOf: (session) => view.sessionTargetId(session),
+  };
+}
+
+let deps = defaultDeps();
+let current = null;
+
+// ---------------------------------------------------------------------------
+// The driver's screen, checked and capped
+
+function round2(n) {
+  return Math.round(n * 100) / 100;
+}
+
+// { width, height, dpr, mobile, touch } in CSS pixels, or null when it is not a screen.
+function checkViewport(vp) {
+  if (!vp || typeof vp !== "object" || Array.isArray(vp)) return null;
+  const width = Math.round(Number(vp.width));
+  const height = Math.round(Number(vp.height));
+  if (!Number.isFinite(width) || !Number.isFinite(height)) return null;
+  if (width < MIN_SIDE || height < MIN_SIDE || width > MAX_SIDE || height > MAX_SIDE) return null;
+  let dpr = Number(vp.dpr);
+  if (!Number.isFinite(dpr) || dpr < 1) dpr = 1;
+  dpr = Math.min(dpr, MAX_DPR, Math.sqrt(MAX_PIXELS / (width * height)));
+  dpr = Math.max(1, round2(dpr));
+  return { width, height, dpr, mobile: vp.mobile === true, touch: vp.touch === true };
+}
+
+// ---------------------------------------------------------------------------
+// One DevTools connection
+
+async function openConnection() {
+  const endpoint = deps.endpoint();
+  if (!endpoint) throw Object.assign(new Error("Chrome is not in its own container"), { code: "unsupported" });
+  const version = await deps.fetchJson(`${endpoint}/json/version`);
+  const reported = version && typeof version.webSocketDebuggerUrl === "string" ? version.webSocketDebuggerUrl : "";
+  let path;
+  try {
+    path = new URL(reported).pathname;
+  } catch (_) {
+    path = "";
+  }
+  if (!/^\/devtools\/browser\/[A-Za-z0-9-]{1,80}$/.test(path)) throw new Error("Chrome gave no DevTools address");
+  // Loopback only: the address is built from AGENT_BROWSER_CDP, never from what Chrome reports.
+  const ws = deps.connect(`ws://${new URL(endpoint).host}${path}`);
+  const conn = { ws, nextId: 0, calls: new Map(), handlers: [], closed: false };
+  ws.on("message", (data) => {
+    let msg;
+    try { msg = JSON.parse(String(data)); } catch (_) { return; }
+    if (msg && msg.id && conn.calls.has(msg.id)) {
+      const call = conn.calls.get(msg.id);
+      conn.calls.delete(msg.id);
+      clearTimeout(call.timer);
+      if (msg.error) call.reject(new Error(`${call.method}: ${msg.error.message || "failed"}`));
+      else call.resolve(msg.result || {});
+      return;
+    }
+    if (msg && msg.method) for (const fn of conn.handlers) fn(msg);
+  });
+  const fail = () => {
+    if (conn.closed) return;
+    conn.closed = true;
+    for (const call of conn.calls.values()) { clearTimeout(call.timer); call.reject(new Error("DevTools connection closed")); }
+    conn.calls.clear();
+    for (const fn of conn.handlers) fn({ method: "_closed" });
+  };
+  ws.on("close", fail);
+  ws.on("error", fail);
+  await new Promise((resolve, reject) => {
+    const timer = setTimeout(() => reject(new Error("DevTools connection timed out")), CONNECT_TIMEOUT_MS);
+    if (timer.unref) timer.unref();
+    ws.on("open", () => { clearTimeout(timer); resolve(); });
+    ws.on("error", (e) => { clearTimeout(timer); reject(e instanceof Error ? e : new Error("DevTools connection failed")); });
+  });
+  return conn;
+}
+
+// A call that waits for Chrome's answer.
+function call(conn, method, params = {}, sessionId = null) {
+  if (!conn || conn.closed) return Promise.reject(new Error("DevTools connection closed"));
+  const id = ++conn.nextId;
+  return new Promise((resolve, reject) => {
+    const timer = setTimeout(() => {
+      conn.calls.delete(id);
+      reject(new Error(`${method} timed out`));
+    }, CALL_TIMEOUT_MS);
+    if (timer.unref) timer.unref();
+    conn.calls.set(id, { resolve, reject, timer, method });
+    try {
+      conn.ws.send(JSON.stringify({ id, method, params, ...(sessionId ? { sessionId } : {}) }));
+    } catch (e) {
+      clearTimeout(timer);
+      conn.calls.delete(id);
+      reject(e);
+    }
+  });
+}
+
+// A call whose answer nobody waits for (input, frame acks): sent in order, failures only logged.
+function fire(conn, method, params, sessionId) {
+  call(conn, method, params, sessionId).catch((e) => {
+    if (!conn.closed) console.error(`[browser] ${e.message}`);
+  });
+}
+
+function closeConnection(conn) {
+  if (!conn || conn.closed) return;
+  conn.closed = true;
+  for (const c of conn.calls.values()) { clearTimeout(c.timer); c.reject(new Error("DevTools connection closed")); }
+  conn.calls.clear();
+  try { conn.ws.close(); } catch (_) { /* already closed */ }
+}
+
+// ---------------------------------------------------------------------------
+// The page's text fields: where they are on the driver's screen (CSS pixels of the view, after
+// any zoom), what kind, and whether one has the focus. Never a value.
+
+const FIELDS_SCRIPT = `(() => {
+  const vv = window.visualViewport || { offsetLeft: 0, offsetTop: 0, scale: 1, width: innerWidth, height: innerHeight };
+  const sw = vv.width * vv.scale, sh = vv.height * vv.scale;
+  const SKIP = { hidden: 1, checkbox: 1, radio: 1, button: 1, submit: 1, reset: 1, image: 1, file: 1, range: 1, color: 1 };
+  const KINDS = { password: 1, email: 1, number: 1, tel: 1, url: 1, search: 1 };
+  const attr = (el, n, max) => String(el.getAttribute(n) || "").slice(0, max);
+  const out = [];
+  let focused = -1;
+  const active = document.activeElement;
+  const list = document.querySelectorAll('input, textarea, [contenteditable=""], [contenteditable="true"], [role="textbox"], [role="searchbox"], [role="combobox"]');
+  for (const el of list) {
+    if (out.length >= ${MAX_FIELDS}) break;
+    if (el.disabled || el.readOnly) continue;
+    let kind = "text";
+    if (el.tagName === "INPUT") {
+      const t = String(el.type || "text").toLowerCase();
+      if (SKIP[t]) continue;
+      if (KINDS[t]) kind = t;
+    } else if (el.tagName === "TEXTAREA") kind = "multiline";
+    const r = el.getBoundingClientRect();
+    if (r.width < 4 || r.height < 4) continue;
+    const x = (r.left - vv.offsetLeft) * vv.scale, y = (r.top - vv.offsetTop) * vv.scale;
+    const w = r.width * vv.scale, h = r.height * vv.scale;
+    if (x + w < 0 || y + h < 0 || x > sw || y > sh) continue;
+    const st = getComputedStyle(el);
+    if (st.visibility === "hidden" || st.display === "none" || Number(st.opacity) === 0) continue;
+    if (el === active) focused = out.length;
+    out.push({ x: Math.round(x), y: Math.round(y), w: Math.round(w), h: Math.round(h), kind,
+      ac: attr(el, "autocomplete", 40), im: attr(el, "inputmode", 16), enter: attr(el, "enterkeyhint", 10) });
+  }
+  const editable = !!(active && (active.isContentEditable || active.tagName === "TEXTAREA" ||
+    (active.tagName === "INPUT" && !SKIP[String(active.type || "text").toLowerCase()])));
+  return JSON.stringify({ fields: out, focused, editable });
+})()`;
+
+function cleanFields(raw) {
+  let parsed;
+  try { parsed = JSON.parse(String(raw)); } catch (_) { return null; }
+  if (!parsed || !Array.isArray(parsed.fields)) return null;
+  const word = (v, max) => (typeof v === "string" ? v.slice(0, max).replace(/[^\w -]/g, "") : "");
+  const fields = parsed.fields.slice(0, MAX_FIELDS).filter((f) => f && [f.x, f.y, f.w, f.h].every(Number.isFinite)).map((f) => ({
+    x: Math.round(f.x), y: Math.round(f.y), w: Math.round(f.w), h: Math.round(f.h),
+    kind: word(f.kind, 12) || "text", ac: word(f.ac, 40), im: word(f.im, 16), enter: word(f.enter, 10),
+  }));
+  const focused = Number.isInteger(parsed.focused) && parsed.focused >= 0 && parsed.focused < fields.length ? parsed.focused : -1;
+  return { fields, focused, editable: parsed.editable === true };
+}
+
+function scheduleFields(drive, ms = FIELDS_SETTLE_MS) {
+  if (!drive || drive.stopped) return;
+  clearTimeout(drive.fieldsTimer);
+  drive.fieldsTimer = setTimeout(() => readFields(drive), ms);
+  if (drive.fieldsTimer.unref) drive.fieldsTimer.unref();
+}
+
+async function readFields(drive) {
+  if (!drive || drive.stopped) return;
+  try {
+    const res = await call(drive.conn, "Runtime.evaluate", { expression: FIELDS_SCRIPT, returnByValue: true, silent: true }, drive.sid);
+    const value = res && res.result ? res.result.value : null;
+    const fields = cleanFields(value);
+    if (!fields || drive.stopped) return;
+    const key = JSON.stringify(fields);
+    if (key === drive.fieldsKey) return;
+    drive.fieldsKey = key;
+    view.driveFeed.emit("fields", { session: drive.session.name, ...fields });
+  } catch (_) {
+    // a page in the middle of loading: the next frame reads them again
+  }
+}
+
+// ---------------------------------------------------------------------------
+// Frames
+
+function onFrame(drive, params) {
+  if (drive.stopped || !params || typeof params.data !== "string") return;
+  const md = params.metadata || {};
+  const vp = drive.viewport;
+  const frame = {
+    data: params.data,
+    // The driver's page is vp.width x vp.height CSS pixels; the picture is that times vp.dpr.
+    metadata: {
+      deviceWidth: vp.width,
+      deviceHeight: vp.height,
+      pageScaleFactor: Number.isFinite(md.pageScaleFactor) ? md.pageScaleFactor : 1,
+      scrollOffsetX: Number.isFinite(md.scrollOffsetX) ? md.scrollOffsetX : 0,
+      scrollOffsetY: Number.isFinite(md.scrollOffsetY) ? md.scrollOffsetY : 0,
+      timestamp: Number.isFinite(md.timestamp) ? Math.round(md.timestamp * 1000) : deps.now(),
+      fit: true,
+    },
+    seq: ++drive.seq,
+    at: deps.now(),
+  };
+  drive.lastFrame = frame;
+  view.driveFeed.last = { session: drive.session.name, frame };
+  view.driveFeed.emit("frame", { session: drive.session.name, frame });
+  // Chrome sends the next picture after this one is acknowledged: at most MAX_FPS a second.
+  const wait = Math.max(0, drive.lastAckAt + 1000 / MAX_FPS - deps.now());
+  const ack = () => {
+    drive.lastAckAt = deps.now();
+    if (!drive.stopped) fire(drive.conn, "Page.screencastFrameAck", { sessionId: params.sessionId }, drive.sid);
+  };
+  if (wait > 0) {
+    const t = setTimeout(ack, wait);
+    if (t.unref) t.unref();
+  } else ack();
+  scheduleFields(drive);
+}
+
+// ---------------------------------------------------------------------------
+// start / fit / stop
+
+async function applyViewport(drive, vp) {
+  const { conn, sid } = drive;
+  // The view first, then the window (the other way round, the first pictures stay at 1x).
+  await call(conn, "Emulation.setDeviceMetricsOverride", {
+    width: vp.width,
+    height: vp.height,
+    deviceScaleFactor: vp.dpr,
+    mobile: vp.mobile,
+    scale: vp.dpr,
+    screenWidth: vp.width,
+    screenHeight: vp.height,
+  }, sid);
+  await call(conn, "Browser.setWindowBounds", {
+    windowId: drive.windowId,
+    bounds: {
+      width: Math.round(vp.width * vp.dpr) + drive.insets.width,
+      height: Math.round(vp.height * vp.dpr) + drive.insets.height,
+      windowState: "normal",
+    },
+  });
+  await call(conn, "Emulation.setTouchEmulationEnabled", { enabled: vp.touch, ...(vp.touch ? { maxTouchPoints: 5 } : {}) }, sid);
+  drive.viewport = vp;
+  // A new size needs a new screencast: its picture size is fixed when it starts.
+  if (drive.screencasting) await call(conn, "Page.stopScreencast", {}, sid).catch(() => {});
+  await call(conn, "Page.startScreencast", {
+    format: "jpeg",
+    quality: QUALITY,
+    maxWidth: Math.round(vp.width * vp.dpr),
+    maxHeight: Math.round(vp.height * vp.dpr),
+    everyNthFrame: 1,
+  }, sid);
+  drive.screencasting = true;
+}
+
+// session: { name, dir } (an agent-browser session in container mode); viewport: the driver's
+// screen; savedBounds: the window's size before an earlier drive of this same lock (after a bot
+// restart), so the hand back restores that and not the phone size.
+// -> { ok: true, fit, bounds } | { ok: false, error }
+async function start({ session, viewport, savedBounds = null } = {}) {
+  const vp = checkViewport(viewport);
+  if (!vp) return { ok: false, error: "bad-viewport" };
+  if (!session || !session.name) return { ok: false, error: "not-running" };
+  if (!deps.endpoint()) return { ok: false, error: "unsupported" };
+  const targetId = deps.targetOf(session);
+  if (!targetId) return { ok: false, error: "no-tab" };
+  if (current) await stop();
+  let conn;
+  try {
+    conn = await openConnection();
+  } catch (e) {
+    console.error(`[browser] phone/web view unavailable: ${e.message}`);
+    return { ok: false, error: e.code === "unsupported" ? "unsupported" : "browser-unavailable" };
+  }
+  const drive = {
+    session: { name: session.name, dir: session.dir || null },
+    targetId,
+    conn,
+    sid: null,
+    windowId: null,
+    savedBounds: null,
+    insets: { width: 0, height: 0 },
+    viewport: null,
+    screencasting: false,
+    stopped: false,
+    lastFrame: null,
+    lastAckAt: 0,
+    seq: 0,
+    fieldsTimer: null,
+    fieldsKey: "",
+    touchBase: null,
+  };
+  conn.handlers.push((msg) => {
+    if (msg.method === "Page.screencastFrame" && msg.sessionId === drive.sid) onFrame(drive, msg.params);
+    else if (msg.method === "_closed" || (msg.method === "Target.detachedFromTarget" && msg.params && msg.params.sessionId === drive.sid)) {
+      if (!drive.stopped) lost(drive);
+    }
+  });
+  try {
+    const attached = await call(conn, "Target.attachToTarget", { targetId, flatten: true });
+    drive.sid = attached.sessionId;
+    if (!drive.sid) throw new Error("no DevTools session for the tab");
+    await call(conn, "Target.activateTarget", { targetId }).catch(() => {});
+    const win = await call(conn, "Browser.getWindowForTarget", { targetId });
+    drive.windowId = win.windowId;
+    drive.savedBounds = savedBounds && Number.isFinite(savedBounds.width) && Number.isFinite(savedBounds.height)
+      ? { width: Math.round(savedBounds.width), height: Math.round(savedBounds.height) }
+      : { width: win.bounds.width, height: win.bounds.height };
+    // What the window adds around the page (Chrome's own bars, even headless).
+    const sizes = await call(conn, "Runtime.evaluate", {
+      expression: "JSON.stringify([outerWidth - innerWidth, outerHeight - innerHeight])",
+      returnByValue: true,
+      silent: true,
+    }, drive.sid);
+    try {
+      const [w, h] = JSON.parse(sizes.result.value);
+      if (Number.isFinite(w) && w >= 0 && w < 400) drive.insets.width = Math.round(w);
+      if (Number.isFinite(h) && h >= 0 && h < 400) drive.insets.height = Math.round(h);
+    } catch (_) { /* no insets known: none */ }
+    await call(conn, "Page.enable", {}, drive.sid);
+    await applyViewport(drive, vp);
+  } catch (e) {
+    console.error(`[browser] phone/web view failed: ${e.message}`);
+    await restore(drive);
+    return { ok: false, error: "browser-unavailable" };
+  }
+  current = drive;
+  view.driveFeed.active = drive.session.name;
+  view.driveFeed.emit("start", { session: drive.session.name, fit: vp });
+  scheduleFields(drive, 400);
+  console.log(`[browser] driver's view: ${vp.width}x${vp.height} at ${vp.dpr}x${vp.mobile ? ", phone layout" : ""}${vp.touch ? ", touch" : ""}`);
+  return { ok: true, fit: vp, bounds: drive.savedBounds };
+}
+
+// The driver's screen changed size (a turned phone, a resized panel). -> { ok, fit } | { ok: false, error }
+async function fit(viewport) {
+  const drive = current;
+  if (!drive || drive.stopped) return { ok: false, error: "not-driving" };
+  const vp = checkViewport(viewport);
+  if (!vp) return { ok: false, error: "bad-viewport" };
+  try {
+    await applyViewport(drive, vp);
+  } catch (e) {
+    console.error(`[browser] resizing the driver's view failed: ${e.message}`);
+    return { ok: false, error: "browser-unavailable" };
+  }
+  scheduleFields(drive, 400);
+  view.driveFeed.emit("start", { session: drive.session.name, fit: vp });
+  return { ok: true, fit: vp };
+}
+
+// Undo everything this drive changed. The emulation goes with the DevTools session anyway; the
+// window size does not.
+async function restore(drive) {
+  drive.stopped = true;
+  clearTimeout(drive.fieldsTimer);
+  const { conn, sid } = drive;
+  if (conn && !conn.closed) {
+    if (sid && drive.screencasting) await call(conn, "Page.stopScreencast", {}, sid).catch(() => {});
+    if (sid) await call(conn, "Emulation.clearDeviceMetricsOverride", {}, sid).catch(() => {});
+    if (sid) await call(conn, "Emulation.setTouchEmulationEnabled", { enabled: false }, sid).catch(() => {});
+    if (drive.windowId !== null && drive.savedBounds) {
+      await call(conn, "Browser.setWindowBounds", { windowId: drive.windowId, bounds: { ...drive.savedBounds, windowState: "normal" } }).catch(() => {});
+    }
+  }
+  closeConnection(conn);
+}
+
+// The DevTools connection or the tab went away under a drive.
+function lost(drive) {
+  if (current === drive) {
+    current = null;
+    view.driveFeed.active = null;
+    view.driveFeed.last = null;
+  }
+  drive.stopped = true;
+  clearTimeout(drive.fieldsTimer);
+  closeConnection(drive.conn);
+  view.driveFeed.emit("stop", { session: drive.session.name, reason: "lost" });
+  console.error("[browser] the driver's view lost its connection to Chrome");
+}
+
+async function stop() {
+  const drive = current;
+  if (!drive) return false;
+  current = null;
+  view.driveFeed.active = null;
+  view.driveFeed.last = null;
+  await restore(drive);
+  view.driveFeed.emit("stop", { session: drive.session.name, reason: "handed-back" });
+  return true;
+}
+
+// After a bot restart nothing is live, but the window may still be at the driver's size: put it
+// back from the size the lock remembers. Best effort.
+async function restoreWindow(session, bounds) {
+  if (current || !bounds || !Number.isFinite(bounds.width) || !Number.isFinite(bounds.height)) return false;
+  const targetId = session ? deps.targetOf(session) : null;
+  if (!targetId || !deps.endpoint()) return false;
+  let conn;
+  try {
+    conn = await openConnection();
+    const win = await call(conn, "Browser.getWindowForTarget", { targetId });
+    await call(conn, "Browser.setWindowBounds", { windowId: win.windowId, bounds: { width: Math.round(bounds.width), height: Math.round(bounds.height), windowState: "normal" } });
+    return true;
+  } catch (_) {
+    return false;
+  } finally {
+    closeConnection(conn);
+  }
+}
+
+function active(sessionName) {
+  return !!current && !current.stopped && (sessionName === undefined || current.session.name === sessionName);
+}
+
+function lastFrame() {
+  return current && current.lastFrame ? { data: current.lastFrame.data, metadata: current.lastFrame.metadata, at: current.lastFrame.at } : null;
+}
+
+// ---------------------------------------------------------------------------
+// Input: events already checked by core/browser-control.js checkEvent.
+
+// A touch's time on the driver's device (ms, their clock) moved onto this machine's clock, so a
+// swipe's speed (and its fling) survives the trip, in seconds as Chrome wants. A gesture's first
+// touch lands TOUCH_SLACK_MS in the past, so the touches that arrive with it (a batch spans about
+// one round trip) keep their spacing instead of being cut to "now".
+const TOUCH_SLACK_MS = 150;
+function touchTime(drive, ev) {
+  const now = deps.now();
+  if (!Number.isFinite(ev.t)) return now / 1000;
+  if (!drive.touchBase || (ev.eventType === "touchStart" && !drive.touching)) drive.touchBase = { offset: now - TOUCH_SLACK_MS - ev.t };
+  const at = ev.t + drive.touchBase.offset;
+  // Never in the future, never more than a few seconds behind.
+  return Math.min(now, Math.max(now - 5000, at)) / 1000;
+}
+
+// The driver's points are the page's CSS pixels; with the view drawn at its density (Emulation
+// scale), Chrome reads input in the drawn picture's pixels, so every point and scroll is scaled
+// by it (proven 10 Oct on Chrome 149: a tap at CSS (46,143) with scale 2 landed at (23,72)).
+function toCdp(drive, ev) {
+  const k = drive.viewport && drive.viewport.dpr > 0 ? drive.viewport.dpr : 1;
+  const at = (n) => Math.round(n * k * 100) / 100;
+  if (ev.type === "input_mouse") {
+    const p = { type: ev.eventType, x: at(ev.x), y: at(ev.y), button: ev.button || "none", clickCount: ev.clickCount || 0, modifiers: ev.modifiers || 0, pointerType: "mouse" };
+    if (ev.eventType === "mouseWheel") { p.deltaX = at(ev.deltaX || 0); p.deltaY = at(ev.deltaY || 0); }
+    return ["Input.dispatchMouseEvent", p];
+  }
+  if (ev.type === "input_keyboard") {
+    const p = { type: ev.eventType === "keyDown" && !ev.text ? "rawKeyDown" : ev.eventType, modifiers: ev.modifiers || 0 };
+    if (ev.key !== undefined) p.key = ev.key;
+    if (ev.code !== undefined) p.code = ev.code;
+    if (ev.text !== undefined) { p.text = ev.text; p.unmodifiedText = ev.text; }
+    if (ev.windowsVirtualKeyCode !== undefined) { p.windowsVirtualKeyCode = ev.windowsVirtualKeyCode; p.nativeVirtualKeyCode = ev.windowsVirtualKeyCode; }
+    return ["Input.dispatchKeyEvent", p];
+  }
+  if (ev.type === "input_touch") {
+    const ending = ev.eventType === "touchEnd" || ev.eventType === "touchCancel";
+    const p = {
+      type: ev.eventType,
+      // Chrome wants no points on an end or a cancel.
+      touchPoints: ending ? [] : ev.touchPoints.map((t, i) => ({ x: at(t.x), y: at(t.y), id: t.id !== undefined ? t.id : i, radiusX: 1, radiusY: 1, force: 1 })),
+      modifiers: ev.modifiers || 0,
+      timestamp: touchTime(drive, ev),
+    };
+    drive.touching = !ending;
+    return ["Input.dispatchTouchEvent", p];
+  }
+  if (ev.type === "input_text") return ["Input.insertText", { text: String(ev.text).slice(0, TEXT_MAX) }];
+  return null;
+}
+
+// Send a batch to Chrome in order without waiting for each answer. -> number sent
+function dispatch(events) {
+  const drive = current;
+  if (!drive || drive.stopped || drive.conn.closed) return -1;
+  let sent = 0;
+  let tapped = false;
+  for (const ev of events) {
+    const cdp = toCdp(drive, ev);
+    if (!cdp) continue;
+    fire(drive.conn, cdp[0], cdp[1], drive.sid);
+    sent += 1;
+    if (ev.eventType === "touchEnd" || ev.eventType === "mouseReleased" || ev.type === "input_text" || (ev.type === "input_keyboard" && ev.key === "Tab")) tapped = true;
+  }
+  // A tap or a Tab can move the focus: read the fields again soon.
+  if (tapped) scheduleFields(drive, 200);
+  return sent;
+}
+
+function _setDeps(overrides = {}) {
+  deps = { ...deps, ...overrides };
+}
+
+async function _reset() {
+  if (current) {
+    const drive = current;
+    current = null;
+    drive.stopped = true;
+    clearTimeout(drive.fieldsTimer);
+    closeConnection(drive.conn);
+  }
+  view.driveFeed.active = null;
+  view.driveFeed.last = null;
+  view.driveFeed.removeAllListeners();
+  deps = defaultDeps();
+}
+
+module.exports = {
+  FIELDS_SCRIPT,
+  MAX_FPS,
+  MAX_PIXELS,
+  QUALITY,
+  TEXT_MAX,
+  active,
+  checkViewport,
+  cleanFields,
+  dispatch,
+  fit,
+  lastFrame,
+  restoreWindow,
+  start,
+  stop,
+  supported: () => !!deps.endpoint(),
+  _reset,
+  _setDeps,
+};

package/core/browser-lock.js

@@ -4,7 +4,9 @@
 // hook (core/tool-guard.js, C7), which runs as a separate process for every tool call and
 // re-reads it each time, like the tooling-mode switch (core/tooling-mode.js).
 //
-// { session, userId, name, chatId, since, expiresAt }   (ISO times; written atomically, 0600)
+// { session, userId, name, chatId, since, expiresAt, fit?, bounds? }   (ISO times; atomic, 0600)
+// fit: the driver's view (core/browser-drive.js), bounds: the window's size before it, so a
+// restarted bot can bring the view back, and the hand back can put the window back.
 //
 // An expired lock is no lock: it never blocks the bot, and the sweeper in
 // core/browser-control.js hands the browser back.
@@ -48,4 +50,33 @@ function removeLock() {
   try { fs.rmSync(driverFile(), { force: true }); } catch (_) { /* already gone */ }
 }
 
-module.exports = { LOCK_TTL_MS, driverFile, readLock, lockExpiresAt, liveLock, writeLock, removeLock };
+// The bot was told to wait (core/tool-guard.js refused one of its agent-browser commands while
+// this lock was live), so the hand back must wake it. Keyed by the lock's `since`: a marker from
+// an earlier drive never counts. A separate file, because the tool guard runs in its own process
+// and the lock file is rewritten every second while someone drives.
+function waitingFile() {
+  return process.env.OC_BROWSER_WAITING_FILE || path.join(require("../config-dir"), "browser-waiting.json");
+}
+
+function markWaiting(lock) {
+  if (!lock || !lock.since) return;
+  try {
+    atomicWriteFileSync(waitingFile(), `${JSON.stringify({ since: lock.since, at: new Date().toISOString() })}\n`, { mode: 0o600 });
+  } catch (_) { /* best effort: the bot then just is not woken */ }
+}
+
+function waitedDuring(lock) {
+  if (!lock || !lock.since) return false;
+  try {
+    const mark = JSON.parse(fs.readFileSync(waitingFile(), "utf8"));
+    return !!mark && mark.since === lock.since;
+  } catch (_) {
+    return false;
+  }
+}
+
+function clearWaiting() {
+  try { fs.rmSync(waitingFile(), { force: true }); } catch (_) { /* already gone */ }
+}
+
+module.exports = { LOCK_TTL_MS, driverFile, readLock, lockExpiresAt, liveLock, writeLock, removeLock, markWaiting, waitedDuring, clearWaiting };

package/core/browser-view.js

@@ -22,11 +22,22 @@
 const fs = require("fs");
 const os = require("os");
 const path = require("path");
+const { EventEmitter } = require("events");
 const WebSocket = require("ws");
 
 const SESSION_NAME = /^[A-Za-z0-9._-]{1,64}$/;
 const DEFAULT_FPS = 5;
-const MAX_FPS = 10;
+const MAX_FPS = 30;
+
+// The phone and web view (core/browser-drive.js) publishes here while a person drives: "frame",
+// "fields" (the page's text fields) and "start" / "stop", each with the session's name. A viewer
+// of that session gets these instead of agent-browser's own frames, which follow neither the
+// driver's size nor the page's real size. `active` and `last` let a viewer that opens mid-drive
+// start with the picture at once.
+const driveFeed = new EventEmitter();
+driveFeed.setMaxListeners(200);
+driveFeed.active = null;
+driveFeed.last = null;
 const KEEPALIVE_MS = 25000;
 const ACTIVATE_TIMEOUT_MS = 1500;
 const TARGET_ID = /^[A-Za-z0-9]{8,64}$/; // static pages send no frames; comments keep proxies from closing the stream
@@ -213,18 +224,77 @@ function openStream(sessionName, { fps, sessions, connect = (url) => new WebSock
 
 // Server-sent events for one session: "frame" and "url" events, a final "end" event with the
 // reason, and ": ping" comments while the page is still. Every payload also carries its type,
-// for readers that only look at data lines. Frames are skipped, never queued, while a slow
-// viewer's connection is backed up.
-function serveStream(res, sessionName, { fps, sessions, connect, activate, keepaliveMs = KEEPALIVE_MS } = {}) {
+// for readers that only look at data lines. While a slow viewer's connection is backed up,
+// frames are not queued: only the newest waits, and goes out once the connection drains, so the
+// last picture of a scroll is never lost. While a person drives in the phone or web view, the
+// frames are the driver's (core/browser-drive.js), at most `fps` a second, with "fields" events
+// (the page's text fields) and "fit" events (the driver's view started, changed or ended).
+function serveStream(res, sessionName, { fps, sessions, connect, activate, keepaliveMs = KEEPALIVE_MS, feed = driveFeed } = {}) {
   res.writeHead(200, {
     "Content-Type": "text/event-stream",
     "Cache-Control": "no-cache, no-store",
     "Connection": "keep-alive",
     "X-Accel-Buffering": "no",
   });
+  let closed = false;
   const write = (event, obj) => {
+    if (closed) return;
     try { res.write(`event: ${event}\ndata: ${JSON.stringify(obj)}\n\n`); } catch (_) { /* viewer gone */ }
   };
+  const interval = 1000 / clampFps(fps);
+  let lastSent = 0;
+  let pending = null;
+  let slot = null;
+  const flush = () => {
+    if (!pending || closed || res.writableNeedDrain) return;
+    const now = Date.now();
+    const due = lastSent + interval;
+    if (now < due) {
+      if (!slot) {
+        slot = setTimeout(() => { slot = null; flush(); }, due - now);
+        if (slot.unref) slot.unref();
+      }
+      return;
+    }
+    const msg = pending;
+    pending = null;
+    lastSent = now;
+    write("frame", msg);
+  };
+  const offerFrame = (msg) => {
+    pending = msg;
+    flush();
+  };
+  if (typeof res.on === "function") res.on("drain", flush);
+  let driving = feed.active === sessionName;
+  const onDriveFrame = (ev) => {
+    if (ev.session !== sessionName || !driving) return;
+    offerFrame({ type: "frame", seq: ev.frame.seq, data: ev.frame.data, metadata: ev.frame.metadata });
+  };
+  const onDriveFields = (ev) => {
+    if (ev.session !== sessionName || !driving) return;
+    write("fields", { type: "fields", fields: ev.fields, focused: ev.focused, editable: ev.editable });
+  };
+  const onDriveStart = (ev) => {
+    if (ev.session !== sessionName) return;
+    driving = true;
+    write("fit", { type: "fit", fit: ev.fit || null });
+  };
+  const onDriveStop = (ev) => {
+    if (ev.session !== sessionName) return;
+    driving = false;
+    write("fit", { type: "fit", fit: null });
+  };
+  feed.on("frame", onDriveFrame);
+  feed.on("fields", onDriveFields);
+  feed.on("start", onDriveStart);
+  feed.on("stop", onDriveStop);
+  const unsubscribe = () => {
+    feed.removeListener("frame", onDriveFrame);
+    feed.removeListener("fields", onDriveFields);
+    feed.removeListener("start", onDriveStart);
+    feed.removeListener("stop", onDriveStop);
+  };
   const heartbeat = setInterval(() => { try { res.write(": ping\n\n"); } catch (_) { /* viewer gone */ } }, keepaliveMs);
   const stream = openStream(sessionName, {
     fps,
@@ -232,17 +302,30 @@ function serveStream(res, sessionName, { fps, sessions, connect, activate, keepa
     connect,
     ...(activate ? { activate } : {}),
     onMessage: (msg) => {
-      if (msg.type === "frame" && res.writableNeedDrain) return;
+      if (msg.type === "frame") {
+        if (!driving) offerFrame(msg);
+        return;
+      }
       write(msg.type, msg);
     },
     onEnd: (reason) => {
       clearInterval(heartbeat);
+      unsubscribe();
       write("end", { type: "end", reason });
+      closed = true;
       try { res.end(); } catch (_) { /* viewer gone */ }
     },
   });
+  // A viewer that opens while someone drives starts with the driver's picture.
+  if (driving && feed.last && feed.last.session === sessionName) {
+    const f = feed.last.frame;
+    offerFrame({ type: "frame", seq: f.seq, data: f.data, metadata: f.metadata });
+  }
   res.on("close", () => {
+    closed = true;
     clearInterval(heartbeat);
+    if (slot) clearTimeout(slot);
+    unsubscribe();
     stream.close();
   });
 }
@@ -255,10 +338,12 @@ module.exports = {
   cdpEndpoint,
   clampFps,
   describeSessions,
+  driveFeed,
   listSessions,
   openStream,
   processAlive,
   safePageAddress,
   serveStream,
+  sessionTargetId,
   socketDirs,
 };

package/core/cards.js

@@ -83,6 +83,23 @@ function recordSentCard(rec) {
   return cards[String(rec.messageId)];
 }
 
+// Cards with an Open Browser button the bot sent in this chat since `sinceMs` and that no hand
+// back has answered yet: the bot asked for a person in its browser and waits. Each one found is
+// marked answered, so one hand back wakes the bot once.
+function takeBrowserRequests(channelId, sinceMs, now = Date.now()) {
+  if (!channelId) return [];
+  const cards = loadCards();
+  const found = Object.values(cards).filter((c) =>
+    c && c.openApp === "browser" && !c.handedBackAt &&
+    c.origin && String(c.origin.channelId) === String(channelId) &&
+    Date.parse(c.sentAt || 0) >= sinceMs);
+  if (!found.length) return [];
+  const at = new Date(now).toISOString();
+  for (const c of found) cards[c.messageId] = { ...c, handedBackAt: at };
+  saveCards(cards);
+  return found.map((c) => c.messageId);
+}
+
 function getCard(messageId) {
   return loadCards()[String(messageId)] || null;
 }
@@ -647,6 +664,7 @@ module.exports = {
   startDecisionPump,
   DECISIONS_FILE,
   recordSentCard,
+  takeBrowserRequests,
   getCard,
   updateCardRecord,
   noteCardUpdate,

package/core/loopback.js

@@ -215,7 +215,10 @@ async function handleCardKind(res, kind, payload, { channelId, adapterId, adapte
     }
     if (!messageId) return reply(res, 502, { error: "Kazee Chat returned no message id for the card" });
     const wake = ["each", "first", "none"].includes(payload.wake) ? payload.wake : cards.defaultWake(card);
-    cards.recordSentCard({ messageId, title: card.title, kind: card.kind, wake, origin: cardOrigin(caller, payload, own, threadId) });
+    // openApp: a card with an Open <app> button (the bot asking for a person in its Browser):
+    // that person's hand back wakes the bot (core/browser-control.js).
+    const openApp = card.open && typeof card.open === "object" && typeof card.open.app === "string" ? card.open.app.slice(0, 40) : null;
+    cards.recordSentCard({ messageId, title: card.title, kind: card.kind, wake, origin: cardOrigin(caller, payload, own, threadId), ...(openApp ? { openApp } : {}) });
     return reply(res, 200, { ok: true, messageId, wake });
   }
 

package/core/tool-guard.js

@@ -987,6 +987,7 @@ function browserDriverDenial(command, now = Date.now()) {
     return {
       subcommand: String(blocked.sub || "").slice(0, 40),
       message: `${name} is driving the browser right now. Wait for them to hand it back; you will be woken in their chat when they do.`,
+      lock,
     };
   } catch (e) {
     return null;
@@ -1066,6 +1067,8 @@ function runHook(payload) {
     // subcommand is logged: the bot's own fill/type commands can carry text.
     const driving = browserDriverDenial(command);
     if (driving) {
+      // The bot now waits for the hand back: it must be woken then (core/browser-control.js).
+      try { require("./browser-lock").markWaiting(driving.lock); } catch (_) { /* best effort */ }
       logGuardEvent({ kind: "deny", rule: "browser-driver", subcommand: driving.subcommand });
       return { exit: 2, stderr: driving.message };
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inetafrica/open-claudia",
-  "version": "3.5.24",
+  "version": "3.5.25",
   "description": "An always-on, provider-agnostic coding-agent harness for Claude Code and OpenAI Codex via chat",
   "main": "bot.js",
   "bin": {
@@ -11,7 +11,7 @@
     "setup": "node setup.js",
     "start": "node bot.js",
     "pretest": "node test-provider-fixture.js && node test-provider-core-prompt.js && node test-turn-observer.js && node test-provider-prompt-parity.js && node test-provider-env-isolation.js && node test-provider-resume-parity.js && node test-provider-bootstrap.js && node test-provider-registry.js && node test-provider-stream-decoder.js && node test-provider-events.js && node test-provider-claude.js && node test-provider-codex.js && node test-codex-output-schema.js && node test-codex-device-login.js && node test-provider-runner.js && node test-provider-refusal-recovery.js && node test-provider-run-lifecycle.js && node test-provider-gateway.js && node test-provider-side-chat.js && node test-single-runtime.js && node test-provider-migration-backup.js && node test-provider-state-migration.js && node test-provider-session-history.js && node test-provider-session-commands.js && node test-provider-compaction.js && node test-provider-scheduler.js && node test-credential-capture.js && node test-cursor-removal.js && node test-utility-provider-policy.js && node test-provider-subagent.js && node test-provider-recall.js && node test-provider-pack-review.js && node test-memory-mutation-queue.js && node test-provider-dream.js && node test-provider-enforcer.js && node test-provider-tool-hooks.js && node test-provider-boot-matrix.js && node test-provider-capabilities.js && node test-provider-language.js && node test-upgrade-path.js && node test-provider-coupling-audit.js && node test-provider-parity-e2e.js && node test-kazee-channel-health.js && node test-kazee-media-caption.js && node test-kazee-context-media.js && node test-kazee-typing-join.js && node test-kazee-inbound-dedup.js && node test-typing-phase-push.js && node test-socket-reconnect.js && node test-speech-loopback.js && node test-prompt-budget.js && node test-agency-ledger.js && node test-agency-deliberate.js && node test-guardrail.js && node test-group-status-notes.js && node test-spaces-comment-content.js && node test-boot-health.js && node test-lexical-floor.js && node test-safe-mode.js && node test-logout.js && node test-kazee-call-audio.js && node test-kazee-call-janus.js && node test-kazee-call-webrtc.js && node test-kazee-call-speech.js && node test-kazee-call-manager.js && node test-call-speech.js && node test-kazee-call-session.js",
-    "test": "OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node -e \"require('./vault'); console.log('OK')\" && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-runner-watchdog-static.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-usage-accounting.js && node test-codex-rollout.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-recall-engine.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-recall-graph.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-recall-discoverer.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-recall-query.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-walker-score.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-score-gate.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-cokept-warming.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-project-transcripts-smoke.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-transcript-room-scope.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-abilities.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-ability-extraction.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-ability-couse.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-ability-transfer.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-ability-tiers.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-ability-merge-guard.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-learning-e2e.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-pack-nesting.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-pack-search.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-extractive-injection.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-journal-dedupe.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-read-signal.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-tools.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-tool-graph.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-tool-guard.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-read-guard.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-tooling-mode.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-tool-manifest.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-recall-evolution.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-approval-async.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-unified-identity.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-persona-packs.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-speaker-persona.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-persona-pipeline.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-recall-relationship-gate.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-relationship.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-enforcer.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-mandate-hygiene.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-external-rule-scopes.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-approval-cards.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-identity-prune.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-kazee-message-id.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-kazee-group-gate.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-kazee-group-context.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-kazee-threads.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-people-owner-seed.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-delivery-contract.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-run-lock.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-thread-lanes.js && node test-thread-titles.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-thread-stop.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-stop-queue.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-typing-heartbeat.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-web-sessions.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-telegram-poll-recovery.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-telegram-409-grace.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-telegram-conflict-heal-guard.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-single-instance.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-streaming-split.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-stream-preview-purpose.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-spaces-autoenable.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-say-loopback.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-loopback-threads.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-transcript-threads.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-journal-union.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-subst-score.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-section-budgets.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-dedup-adjudicator.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-prospective.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-recall-regressions.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-cost-report.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-speaker-context.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-approval-mining.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-tool-certification.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-apprenticeship.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-speaker-attest.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-run-attest.js && node test-sandbox-probe.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-bot-endpoint.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-tool-gate.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-cli-owner-gates.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-verify-contact.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-loopback-owner-gate.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-watch-check-env.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-intro-adoption.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-grants.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-room-provider-settings.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-store-durability.js && node test-kazee-cards.js && node test-decision-upkeep.js && node test-passive-replies.js && node test-kazee-bot-loops.js && node test-kazee-bot-handoffs.js && node test-placeholder-reply.js && node test-media-speech.js && node test-passive-replies-router.js && node test-loopback-cards.js && node test-task-injection.js && node test-speaker-extras.js && node test-token-diet.js && node test-dream-tasks.js && node test-task-archive.js && node test-cron-tolerance.js && node test-dream-schedule.js && node test-job-failures.js && node test-scheduled-placeholder.js && node test-lessons-since.js && node test-pack-reinject.js && node test-turn-journal.js && node test-usage-limits.js && node test-limit-waits.js && node test-limit-pickup.js && node test-browser-view.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test node test-web-browser-view.js && node test-browser-address.js && node test-browser-control.js && node test-browser-teach.js && node test-kazee-bot-apps.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test node test-web-browser-app.js && node test-safe-filename.js && node test-media-filename-paths.js && node test-router-document-guard.js && OPEN_CLAUDIA_TEST=1 node test-web-dashboard-escape.js && OPEN_CLAUDIA_TEST=1 node test-web-bad-requests.js && OPEN_CLAUDIA_TEST=1 node test-kazee-download-limit.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test node test-web-auth-routes.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test node test-web-otp-link-preview.js"
+    "test": "OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node -e \"require('./vault'); console.log('OK')\" && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-runner-watchdog-static.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-usage-accounting.js && node test-codex-rollout.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-recall-engine.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-recall-graph.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-recall-discoverer.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-recall-query.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-walker-score.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-score-gate.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-cokept-warming.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-project-transcripts-smoke.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-transcript-room-scope.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-abilities.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-ability-extraction.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-ability-couse.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-ability-transfer.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-ability-tiers.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-ability-merge-guard.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-learning-e2e.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-pack-nesting.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-pack-search.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-extractive-injection.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-journal-dedupe.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-read-signal.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-tools.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-tool-graph.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-tool-guard.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-read-guard.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-tooling-mode.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-tool-manifest.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-recall-evolution.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-approval-async.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-unified-identity.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-persona-packs.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-speaker-persona.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-persona-pipeline.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-recall-relationship-gate.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-relationship.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-enforcer.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-mandate-hygiene.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-external-rule-scopes.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-approval-cards.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-identity-prune.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-kazee-message-id.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-kazee-group-gate.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-kazee-group-context.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-kazee-threads.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-people-owner-seed.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-delivery-contract.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-run-lock.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-thread-lanes.js && node test-thread-titles.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-thread-stop.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-stop-queue.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-typing-heartbeat.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-web-sessions.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-telegram-poll-recovery.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-telegram-409-grace.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-telegram-conflict-heal-guard.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-single-instance.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-streaming-split.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-stream-preview-purpose.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-spaces-autoenable.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-say-loopback.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-loopback-threads.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-transcript-threads.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-journal-union.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-subst-score.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-section-budgets.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-dedup-adjudicator.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-prospective.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-recall-regressions.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-cost-report.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-speaker-context.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-approval-mining.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-tool-certification.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-apprenticeship.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-speaker-attest.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-run-attest.js && node test-sandbox-probe.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-bot-endpoint.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-tool-gate.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-cli-owner-gates.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-verify-contact.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-loopback-owner-gate.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-watch-check-env.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-intro-adoption.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-grants.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-room-provider-settings.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-store-durability.js && node test-kazee-cards.js && node test-decision-upkeep.js && node test-passive-replies.js && node test-kazee-bot-loops.js && node test-kazee-bot-handoffs.js && node test-placeholder-reply.js && node test-media-speech.js && node test-passive-replies-router.js && node test-loopback-cards.js && node test-task-injection.js && node test-speaker-extras.js && node test-token-diet.js && node test-dream-tasks.js && node test-task-archive.js && node test-cron-tolerance.js && node test-dream-schedule.js && node test-job-failures.js && node test-scheduled-placeholder.js && node test-lessons-since.js && node test-pack-reinject.js && node test-turn-journal.js && node test-usage-limits.js && node test-limit-waits.js && node test-limit-pickup.js && node test-browser-view.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test node test-web-browser-view.js && node test-browser-address.js && node test-browser-control.js && node test-browser-drive.js && node test-browser-teach.js && node test-kazee-bot-apps.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test node test-web-browser-app.js && node test-safe-filename.js && node test-media-filename-paths.js && node test-router-document-guard.js && OPEN_CLAUDIA_TEST=1 node test-web-dashboard-escape.js && OPEN_CLAUDIA_TEST=1 node test-web-bad-requests.js && OPEN_CLAUDIA_TEST=1 node test-kazee-download-limit.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test node test-web-auth-routes.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test node test-web-otp-link-preview.js"
   },
   "files": [
     "bot.js",

package/test-provider-language.js

@@ -610,7 +610,12 @@ assert.match(pkg.description, /provider-agnostic coding-agent harness/i);
 // app's address bar, agent-browser's settings for the agent, and container mode for Agent
 // Space's browser container. A canary build for the Browser canary bot; the fleet waits
 // for his OK.
-assert.strictEqual(pkg.version, "3.5.24", "release version must remain unchanged without explicit approval");
+// 3.5.25 approved under Sumeet's 2026-10-10 09:18 EAT go-ahead for the phone and web view
+// ("Yeah, but remember the web and mobile still need to also feel native"), after 08:53
+// ("it feels like a browser on my phone… like Google Chrome app"): the bot's tab takes
+// the driver's screen, input straight to Chrome, the page's text fields, hand backs wake
+// only a waiting bot. A canary build for the Browser canary bot; the fleet waits for his OK.
+assert.strictEqual(pkg.version, "3.5.25", "release version must remain unchanged without explicit approval");
 for (const keyword of ["claude", "codex", "coding-agent", "provider-agnostic"]) {
   assert.ok(pkg.keywords.includes(keyword), `package keyword missing: ${keyword}`);
 }