Open-source AI browser agent for Chrome and Firefox (monorepo) ðŸ§
JavaScript ai-agentai-agentsai-toolsbrowser-aibrowser-automationbrowser-extensionchrome-aichrome-devtoolschrome-extensionchrome-extensionsfirefox-addonfirefox-addonsfirefox-extensionfirefox-extensionsgemmagemma4minimaxoffline-aioffline-llmqwen
docs(newtab): handoff cleanup and retry queue as implemented
Claude63ba066aa1dd
diff --git a/docs/newtab.md b/docs/newtab.mdindex 2c15a6370..b8d536c74 100644--- a/docs/newtab.md+++ b/docs/newtab.md@@ -27,12 +27,18 @@ No search engine is hard-coded and nothing is sent to WebBrain's servers by the2. It then sends `WB_NEWTAB_PANEL_OPENED`. `background.js` accepts it only from theextension's own `newtab/index.html` tab, on Chrome adds the tab to theWebBrain group/`panelTabs` as the install page does. Records that are never claimed- are removed when their tab closes, and any older than three minutes are swept each time- the background starts and on every submit.+ are removed when their tab closes and cleared when the browser starts. There is no+ periodic sweep: storage has no compare-and-delete, so deleting a key from an earlier+ read could take a task written in between. A stale record is simply ignored by the+ panel and replaced by the next submission from that tab (the page's own lock outlasts+ the longest age the panel accepts, so a live task is never replaced).3. `src/ui/newtab-handoff.js` (identical in both extensions) in the side panel claimsthe record for the tab it is showing. It must be ≤ 4000 characters, mode`ask`/`act`, addressed to that tab, and ≤ 30 s old (plus however long the panel's- own startup took, up to two minutes). Claimed and stale records are removed.+ own startup took, up to two minutes). Claimed records are removed; stale ones are left+ for the page to replace (see above). A task the panel has to hand back (a send declined+ after a tab switch) is queued in `wbNewtabHandoff:retry:<tabId>`, which only the panel+ writes, and is delivered when that tab is shown again.Nothing is claimed until the panel has finished restoring its chat (`start()`);after that it is tried on `storage.onChanged`, when the panel becomes visible, aftera tab switch and after the visible-state refresh.diff --git a/test/newtab.mjs b/test/newtab.mjsindex 43531be57..2fedaf49e 100644--- a/test/newtab.mjs+++ b/test/newtab.mjs@@ -1797,5 +1797,6 @@ test('round-53: video detection looks at the lower-cased path of the address', aassert.equal(videoCheck(url), false, url);}const privacy = readFileSync(path.join(root, 'docs/privacy-and-data-flow.md'), 'utf8');+ assert.doesNotMatch(readFileSync(path.join(root, "docs/newtab.md"), "utf8"), /swept each time/);assert.doesNotMatch(privacy, /unclaimed\s+records are removed after about three minutes/);});