@gotcos/glasses-server 6.99.20 → 6.99.25

package/server/web-control/app.js

@@ -133,7 +133,7 @@
   var state = {
     pane: 'today', serverName: '', tailnetUrl: '',
     sessions: [], sessionsMode: 'words', workTasks: [], workOpenStages: { complete: false },
-    stream: null, memoriesLoaded: false, lastLoad: {}, livePoll: null
+    stream: null, lastLoad: {}, livePoll: null
   };
   // Control's order (ActivitySection.visibleSections): Today, then Messages to Dictation. Usage is a
   // view inside Sessions on the Mac; its route stays so old links work, and the rail marks Sessions.
@@ -142,6 +142,53 @@
   // Pane modules (panes/*.js) register here: { load(args, ctx), leave(), up(args) }. A registered
   // pane owns its section; route() only shows it and hands it the hash arguments.
   var PANES = {};
+  // Heavy panes load when first opened, then the rest load quietly once the page is idle.
+  // index.html lists them in #lazy-panes so the server can version each URL (?v=<hash>).
+  // Read on first use, not at parse time: #lazy-panes sits after this script in index.html.
+  var lazyList = null;
+  function LAZY() {
+    if (lazyList) return lazyList;
+    var el = document.getElementById('lazy-panes');
+    if (!el) return {};
+    try { lazyList = JSON.parse(el.textContent || '{}'); } catch (_e) { lazyList = {}; }
+    return lazyList;
+  }
+  var lazyLoads = {};
+  // ensurePane(name, waitMs): the pane's script, loaded once. With waitMs, this caller stops waiting after that
+  // long (the load itself carries on, and a later call reuses it), so a stalled download can never hang a tap.
+  function ensurePane(name, waitMs) {
+    var load = loadPane(name);
+    if (!waitMs) return load;
+    return new Promise(function (resolve, reject) {
+      var timer = setTimeout(function () {
+        var late = new Error('The ' + (TITLES[name] || name) + ' section is taking too long to load. Check the connection to your Mac.');
+        late.code = 'pane_timeout'; reject(late);
+      }, waitMs);
+      load.then(function (v) { clearTimeout(timer); resolve(v); }, function (e) { clearTimeout(timer); reject(e); });
+    });
+  }
+  function loadPane(name) {
+    if (PANES[name] || !LAZY()[name]) return Promise.resolve(PANES[name] || null);
+    if (lazyLoads[name]) return lazyLoads[name];
+    lazyLoads[name] = new Promise(function (resolve, reject) {
+      var s = document.createElement('script');
+      s.src = LAZY()[name];
+      s.async = true;
+      s.onload = function () { if (PANES[name]) resolve(PANES[name]); else { delete lazyLoads[name]; reject(new Error('The ' + (TITLES[name] || name) + ' section did not start.')); } };
+      s.onerror = function () { delete lazyLoads[name]; s.remove(); reject(new Error('Could not load the ' + (TITLES[name] || name) + ' section. Check the connection to your Mac.')); };
+      document.body.appendChild(s);
+    });
+    return lazyLoads[name];
+  }
+  function prefetchPanes() {
+    var names = Object.keys(LAZY()).filter(function (n) { return !PANES[n]; });
+    var idle = window.requestIdleCallback || function (fn) { return setTimeout(fn, 200); };
+    (function next() {
+      var n = names.shift();
+      if (!n) return;
+      idle(function () { ensurePane(n).then(next, next); });
+    })();
+  }
   var routeHooks = [];
   var shellHooks = [];
   var crumbDetail = '';
@@ -157,9 +204,9 @@
     if (location.hash === hash) route(); else location.hash = hash;
   }
   function isPhone() { return !window.matchMedia('(min-width: 600px)').matches; }
-  function route() {
+  function route(forceChanged) {
     var r = parseRoute();
-    var changedPane = r.pane !== state.pane || !document.querySelector('#pane-' + r.pane + ':not(.hidden)');
+    var changedPane = forceChanged === true || r.pane !== state.pane || !document.querySelector('#pane-' + r.pane + ':not(.hidden)');
     if (state.pane !== r.pane && PANES[state.pane] && PANES[state.pane].leave) { try { PANES[state.pane].leave(); } catch (err) { console.error(err); } }
     state.pane = r.pane;
     crumbDetail = '';
@@ -171,7 +218,7 @@
     if (!(r.pane === 'sessions' && r.args.length === 2)) { clearInterval(state.turnPoll); if (state.reading) clearInterval(state.reading.heldTimer); state.reading = null; }
     if (r.pane !== 'meetings' && state.livePoll) { clearInterval(state.livePoll); state.livePoll = null; }
 
-    var reading = r.args.length > 0;
+    var reading = r.args.length > 0 && !isTabRoute(r.args);
     var paneEl = $('pane-' + r.pane);
     if (paneEl) paneEl.classList.toggle('reading', reading);
     var split = paneEl && paneEl.querySelector('.split');
@@ -187,10 +234,31 @@
     $('topbar').classList.remove('tucked');
     onScroll();
 
+    if (!PANES[r.pane] && LAZY()[r.pane]) {
+      var lazyPane = r.pane, lazyEl = $('pane-' + lazyPane), wasEmpty = lazyEl && !lazyEl.getAttribute('data-lazy-ready');
+      if (wasEmpty && lazyEl && !lazyEl.querySelector('.lazy-wait')) lazyEl.insertAdjacentHTML('afterbegin', '<div class="lazy-wait">' + skeletonRows(4) + '</div>');
+      ensurePane(lazyPane, 15000).then(function () {
+        if (lazyEl) { lazyEl.setAttribute('data-lazy-ready', '1'); lazyEl.querySelectorAll('.lazy-wait').forEach(function (n) { n.remove(); }); }
+        // Pass changed=true, the value this pane got on its first open when it loaded at boot. Headless Chrome
+        // probes on 11/06 rendered Work, Meetings, Settings and Speakers with either value; this keeps the old contract.
+        if (state.pane === lazyPane) route(true);
+      }, function (err) {
+        if (!lazyEl) return;
+        lazyEl.querySelectorAll('.lazy-wait').forEach(function (n) { n.remove(); });
+        lazyEl.insertAdjacentHTML('afterbegin', '<div class="lazy-wait"><div class="list"><p class="empty"><strong>' + esc(err.message) + '</strong></p><button type="button" class="btn" data-lazy-retry="' + esc(lazyPane) + '">Try again</button></div></div>');
+        // Only the wait ran out: if the load still finishes, the card clears itself and the pane shows.
+        if (err && err.code === 'pane_timeout') loadPane(lazyPane).then(function () {
+          lazyEl.querySelectorAll('.lazy-wait').forEach(function (n) { n.remove(); });
+          lazyEl.setAttribute('data-lazy-ready', '1');
+          if (state.pane === lazyPane) route(true);
+        }, function () {});
+      });
+      runHooks(routeHooks, r);
+      return;
+    }
     if (PANES[r.pane]) { try { PANES[r.pane].load(r.args, { changed: changedPane }); } catch (err) { console.error(err); } }
     else if (r.pane === 'today') loadToday();
     else if (r.pane === 'sessions') { if (!reading || !state.sessions.length || changedPane) loadSessions(); if (reading) openSession(r.args[0], r.args[1]); }
-    else if (r.pane === 'memories') loadMemories();
     else if (r.pane === 'usage') loadUsage(false);
     state.lastLoad[r.pane] = Date.now();
     runHooks(routeHooks, r);
@@ -202,9 +270,12 @@
     var r = parseRoute();
     var up = PANES[r.pane] && PANES[r.pane].up ? PANES[r.pane].up(r.args) : null;
     if (up) go(r.pane, up);
-    else if (r.args.length) go(r.pane);
+    else if (r.args.length && !isTabRoute(r.args)) go(r.pane);
     else go('today');
   }
+  // '#/<pane>/t/<tab>' is the pane's list on one of its tabs, not a reader: the phone keeps the section switcher and Back
+  // leaves the pane. Memories keeps its tab in the address this way, so a reload or a new browser lands on the same tab.
+  function isTabRoute(args) { return args.length === 2 && args[0] === 't'; }
   // On the closed Duo every vertical pixel counts: the top bar slides away while you scroll
   // down and comes back the moment you scroll up.
   var lastY = 0;
@@ -238,18 +309,209 @@
     loadTailnetUrl();
     runHooks(shellHooks, info);
     route();
+    // Reloaded with Today's overlay open: its history entry is still current. The overlay opens the same thing again
+    // (panes/today-actions.js restore), so Back closes it; if it cannot load, the entry is unmarked.
+    var held = history.state;
+    if (held && held.cosTodayOverlay) {
+      ensurePane('todayActions', 4000).then(function (m) { if (m && m.restore) m.restore(held); },
+        function () { try { history.replaceState(null, ''); } catch (_e) {} });
+    }
+    setTimeout(prefetchPanes, 1500);
+  }
+  document.addEventListener('click', function (e) {
+    var b = e.target && e.target.closest && e.target.closest('[data-lazy-retry]');
+    if (!b) return;
+    var el = $('pane-' + b.getAttribute('data-lazy-retry'));
+    if (el) el.querySelectorAll('.lazy-wait').forEach(function (n) { n.remove(); });
+    route(true);
+  });
+
+  // ── one session list for every pane ────────────────────
+  // /api/agent-sessions walks every session folder and runs a 2-3 s lock probe on the Mac (measured
+  // 11/06 in the browser: 5.1 s on Sessions, 2.1 s on Work). Today, Sessions, Work and the section
+  // stories all asked for it separately. Now there is one copy: a request younger than maxAgeMs is
+  // answered from it, a request already on the wire is shared, and panes can paint the last copy at
+  // once while a fresh one loads (sessionListCached).
+  var SL = { data: null, at: 0, inflight: null };
+  function sessionList(maxAgeMs) {
+    if (SL.data && Date.now() - SL.at < (maxAgeMs || 0)) return Promise.resolve(SL.data);
+    if (SL.inflight) return SL.inflight;
+    SL.inflight = api('/api/agent-sessions?limit=80&sort=updated').then(function (d) {
+      SL.data = d; SL.at = Date.now(); SL.inflight = null; return d;
+    }, function (err) { SL.inflight = null; throw err; });
+    return SL.inflight;
+  }
+  function sessionListCached() { return SL.data ? { data: SL.data, at: SL.at } : null; }
+
+  // ── the session pet (Today) ─────────────────────────────
+  // Same pet and the same pose rule as COS Control (PetSpritePose.resolve): waiting with nothing running
+  // is "waiting", then one, two, three, four or more sessions in play are working, duel, trio, swarm, an open
+  // quiet session is "patrol", none is "idle". Strips come from /api/web-pet, resized and cut for a phone.
+  var PET = { manifest: null, fetchedAt: 0, pose: null, timer: null, frame: 0, token: 0 };
+  // This browser's pet settings (Settings > Pet): which pet, and whether Today shows it. Per browser, like the theme.
+  var PET_KEY = 'cos-web-pet';
+  function petPrefs() {
+    var p = readStore(PET_KEY);
+    var pet = typeof p.pet === 'string' && /^(mac|(shipped|gallery):[a-z0-9][a-z0-9-]{0,80})$/.test(p.pet) ? p.pet : 'mac';
+    return { pet: pet, show: p.show !== false };
+  }
+  function setPetPrefs(next) {
+    var cur = petPrefs();
+    var merged = { pet: next.pet != null ? next.pet : cur.pet, show: next.show != null ? !!next.show : cur.show };
+    writeStore(PET_KEY, merged);
+    // Forget the old pet's manifest and loop; Today repaints with the new choice next time it shows.
+    PET.manifest = null; PET.fetchedAt = 0; PET.pose = null; PET.token++; petStop();
+    var box = $('today-pet');
+    if (box) { box.innerHTML = ''; box.classList.add('hidden'); }
+    if (state.pane === 'today' && state.sessions) renderPet(state.sessions);
+    return merged;
+  }
+  var PET_HEIGHT = 140;
+  function petPose(sessions) {
+    var working = 0, waiting = 0, alive = 0;
+    sessions.forEach(function (s) {
+      var st = sxState(s);
+      // Working is the Running card's own test (running_active), so the caption under the pet never
+      // disagrees with the Running count beside it (11/06: the pet said 3 while the card said 2).
+      if (s.running_active) working++;
+      else if (st === 'waiting') waiting++;
+      if (s.running || s.running_active) alive++;
+    });
+    var pose;
+    if (waiting > 0 && working === 0) pose = 'waiting';
+    else if (working + waiting >= 4) pose = 'swarm';
+    else if (working + waiting === 3) pose = 'trio';
+    else if (working + waiting === 2) pose = 'duel';
+    else if (working + waiting === 1) pose = 'working';
+    else pose = alive > 0 ? 'patrol' : 'idle';
+    return { pose: pose, working: working, waiting: waiting };
+  }
+  function petCaption(c) {
+    var parts = [];
+    if (c.working) parts.push(c.working + ' running');
+    if (c.waiting) parts.push(c.waiting + ' waiting on you');
+    return parts.length ? parts.join(', ') : 'Nothing running';
+  }
+  function petStop() { clearTimeout(PET.timer); PET.timer = null; }
+  function petPaint(el, spec, frame, scale) {
+    var chunk = Math.floor(frame / spec.perChunk), inChunk = frame % spec.perChunk;
+    var count = Math.min(spec.perChunk, spec.frames - chunk * spec.perChunk);
+    el.style.backgroundImage = 'url("' + spec.chunks[chunk] + '")';
+    el.style.backgroundSize = Math.round(count * spec.frameWidth * scale) + 'px ' + PET_HEIGHT + 'px';
+    el.style.backgroundPosition = '-' + Math.round(inChunk * spec.frameWidth * scale) + 'px 0';
+  }
+  function petLoadImages(spec) {
+    return Promise.all(spec.chunks.map(function (url) {
+      return new Promise(function (resolve, reject) { var im = new Image(); im.onload = function () { resolve(im); }; im.onerror = reject; im.src = url; });
+    }));
+  }
+  // Folded (one column) the pet sits above the story. Unfolded (two columns, the same 760px line as
+  // .today-cols in app.css) it moves to the top of the right-hand column, above Needs you (Miles 11/06).
+  var PET_WIDE = window.matchMedia ? window.matchMedia('(min-width: 760px)') : null;
+  function placePet() {
+    var box = $('today-pet'), side = document.querySelector('#pane-today .today-side'), rec = $('today-rec');
+    if (!box || !side || !rec) return;
+    if (PET_WIDE && PET_WIDE.matches) { if (side.firstElementChild !== box) side.insertBefore(box, side.firstElementChild); }
+    else if (rec.previousElementSibling !== box) rec.parentNode.insertBefore(box, rec);
+  }
+  if (PET_WIDE) { if (PET_WIDE.addEventListener) PET_WIDE.addEventListener('change', placePet); else if (PET_WIDE.addListener) PET_WIDE.addListener(placePet); }
+  var PET_CHANGE = '<button type="button" class="pet-change" data-goto="settings/pet">Change pet</button>';
+  // A still pet (a gallery pick, Cloud Puff, or a single image on the Mac): one picture for every state.
+  function renderPetStill(box, m, sessions) {
+    var c = petPose(sessions), label = petCaption(c);
+    petStop(); PET.pose = 'still:' + m.still;
+    var img = box.querySelector('.pet-still');
+    if (!img || img.getAttribute('src') !== m.still) {
+      box.innerHTML = '<button type="button" class="pet-btn" data-goto="sessions"><img class="pet-still" alt="" src="' + esc(m.still) + '"><span class="pet-caption"></span></button>' + PET_CHANGE;
+      img = box.querySelector('.pet-still');
+      img.addEventListener('error', function () { box.classList.add('hidden'); });
+      img.addEventListener('load', function () { img.classList.toggle('pixel', img.naturalHeight > 0 && img.naturalHeight < 140); });
+    }
+    box.querySelector('.pet-caption').textContent = label;
+    box.querySelector('.pet-btn').setAttribute('aria-label', 'Sessions: ' + label);
+    box.classList.remove('hidden');
+  }
+  function renderPet(sessions) {
+    var box = $('today-pet');
+    if (!box) return;
+    placePet();
+    var prefs = petPrefs();
+    if (!prefs.show) { box.classList.add('hidden'); box.innerHTML = ''; petStop(); PET.pose = null; return; }
+    // The session list could not be read: the pet would say "Nothing running" about sessions nobody saw. Hide it.
+    if (state.sessionsUnread) { box.classList.add('hidden'); petStop(); PET.pose = null; return; }
+    var fresh = PET.manifest && PET.manifest.pet === prefs.pet && Date.now() - PET.fetchedAt < 10 * 60000;
+    (fresh ? Promise.resolve(PET.manifest) : api('/api/web-pet?pet=' + encodeURIComponent(prefs.pet)).then(function (m) { PET.manifest = m; PET.fetchedAt = Date.now(); return m; }))
+      .catch(function () { return PET.manifest && PET.manifest.pet === prefs.pet ? PET.manifest : null; })
+      .then(function (m) {
+        // A slow answer for a pet that is no longer chosen (or a pet now switched off) paints nothing.
+        var now = petPrefs();
+        if (!now.show || now.pet !== prefs.pet) return;
+        if (!m || !m.available) { box.classList.add('hidden'); petStop(); return; }
+        if (m.kind === 'still') { renderPetStill(box, m, sessions); return; }
+        var c = petPose(sessions);
+        var pose = m.poses[c.pose] ? c.pose : (m.poses.idle ? 'idle' : Object.keys(m.poses)[0]);
+        var spec = m.poses[pose];
+        var label = petCaption(c);
+        box.classList.remove('hidden');
+        var cap = box.querySelector('.pet-caption');
+        if (cap) cap.textContent = label;
+        var btn = box.querySelector('.pet-btn');
+        if (btn) btn.setAttribute('aria-label', 'Sessions: ' + label);
+        if (PET.pose === pose && PET.timer) return;
+        var token = ++PET.token;
+        petLoadImages(spec).then(function () {
+          if (token !== PET.token) return;
+          petStop();
+          PET.pose = pose; PET.frame = 0;
+          if (!box.querySelector('.pet-sprite')) {
+            box.innerHTML = '<button type="button" class="pet-btn" data-goto="sessions"><span class="pet-sprite" aria-hidden="true"></span><span class="pet-caption"></span></button>' + PET_CHANGE;
+          }
+          box.querySelector('.pet-caption').textContent = label;
+          box.querySelector('.pet-btn').setAttribute('aria-label', 'Sessions: ' + label);
+          var el = box.querySelector('.pet-sprite'), scale = PET_HEIGHT / spec.height;
+          el.style.width = Math.round(spec.frameWidth * scale) + 'px';
+          petPaint(el, spec, 0, scale);
+          var still = window.matchMedia && window.matchMedia('(prefers-reduced-motion: reduce)').matches;
+          if (still || spec.frames < 2) return;
+          var step = function () {
+            // Runs only while Today is on screen: leaving the pane or hiding the page stops the loop.
+            if (token !== PET.token || document.hidden || state.pane !== 'today') { PET.timer = null; return; }
+            PET.frame = (PET.frame + 1) % spec.frames;
+            petPaint(el, spec, PET.frame, scale);
+            PET.timer = setTimeout(step, Math.max(20, spec.interval * 1000));
+          };
+          PET.timer = setTimeout(step, Math.max(20, spec.interval * 1000));
+        }, function () {
+          if (token === PET.token && !box.querySelector('.pet-sprite')) box.classList.add('hidden');
+        });
+      });
   }
 
   // ── Today ───────────────────────────────────────────────
   function loadToday() {
     var now = new Date();
     $('today-date').textContent = now.toLocaleDateString(undefined, { weekday: 'long', month: 'long', day: 'numeric' }) + ', ' + clock(now);
+    var gen = ++TODAY.gen;
+    // Voices and memories answer on their own time (the memories status runs a CLI on the Mac): Today paints what it
+    // has and says it is still reading, then repaints as each one lands.
+    if (Date.now() - TODAY.extraAt > 60000 || TODAY.voices.state === 'failed' || TODAY.memories.state === 'failed') {
+      TODAY.extraAt = Date.now();
+      TODAY.voices = { state: 'pending', groups: [] }; TODAY.memories = { state: 'pending', n: 0 };
+      api('/api/voice/held-groups').then(function (d) {
+        TODAY.voices = { state: 'answered', groups: (d && Array.isArray(d.groups)) ? d.groups : [] };
+      }, function () { TODAY.voices = { state: 'failed', groups: [] }; }).then(function () { paintNeeds(); });
+      api('/api/web-bridge/memories', { method: 'POST', body: { id: 'today-status', op: 'status', args: {} } }).then(function (d) {
+        var n = d && d.details ? d.details.learningToReview : null;
+        TODAY.memories = typeof n === 'number' ? { state: 'answered', n: Math.max(0, n) } : { state: 'failed', n: 0 };
+      }, function () { TODAY.memories = { state: 'failed', n: 0 }; }).then(function () { paintNeeds(); });
+    }
     Promise.all([
-      api('/api/agent-sessions?limit=40&sort=updated').catch(function () { return null; }),
+      sessionList(15000).catch(function () { return null; }),
       api('/api/work-board/your-move').catch(function () { return null; }),
       api('/api/welcome-context').catch(function () { return null; }),
       api('/api/meetings/live-chunks').catch(function () { return null; })
     ]).then(function (res) {
+      if (gen !== TODAY.gen) return;
       var sessions = (res[0] && res[0].sessions) || [];
       state.sessions = sessions;
       var needs = (res[1] && res[1].items) || [];
@@ -259,18 +521,24 @@
       var open = sessions.filter(function (s) { return s.running && !s.running_active; });
       var recent = live.filter(function (s) { return Date.now() - (s.mtimeMs || 0) < LIVE_FRESH_MS; });
       var offline = !res[0] && !res[1];
+      TODAY.needs = needs; TODAY.working = working; TODAY.open = open; TODAY.welcome = welcome; TODAY.offline = offline; TODAY.at = Date.now();
+      // your-move answers {available:false} when the board cannot be read: that is a failed read, not "nothing".
+      TODAY.sessionsState = res[0] ? 'answered' : 'failed';
+      state.sessionsUnread = !res[0];   // the pet reads this (renderPet)
+      TODAY.workState = res[1] && res[1].available !== false ? 'answered' : 'failed';
+      TODAY.recording = false;
 
-      renderStory(needs.length, working.length, open.length, welcome.nextEvent, false, offline);
       renderRunning(working, open);
-      renderNeeds(needs);
+      if (!offline) renderPet(sessions);
+      paintNeeds();
       renderNext(welcome);
       loadTodayIntake();
-      setBadge('today', needs.length > 0);
       setBadge('sessions', working.length > 0);
       liveSession(recent).then(function (rec) {
+        if (gen !== TODAY.gen) return;
         renderRecording(rec);
         setBadge('meetings', !!rec);
-        if (rec) renderStory(needs.length, working.length, open.length, welcome.nextEvent, true, offline);
+        if (rec) { TODAY.recording = true; paintNeeds(); }
       });
     });
   }
@@ -295,37 +563,44 @@
       '<span class="rec-copy"><strong>Recording now</strong><span>' + esc(rec.source + (rec.startTime ? ', ' + span(rec.startTime) + ' so far' : '')) + '</span></span>' +
       '<span class="btn small">Live view</span></button>';
   }
-  function renderStory(needs, working, open, next, recording, offline) {
+  // The headline: COS Control's brief (Models.swift TodayHome.brief) over the same rows Needs you lists.
+  function renderStory(m) {
     var el = $('today-story');
     el.className = 'story';
-    if (offline) { el.textContent = 'COS on ' + state.serverName + ' is not answering right now. Today fills in when it does.'; return; }
-    // Quiet hours (Control 0.5.361, and the rail's line): after 6 PM and at weekends what is
-    // waiting can wait until tomorrow, so Today says so instead of "waiting on you".
-    var nowD = new Date(), quiet = nowD.getDay() === 0 || nowD.getDay() === 6 || nowD.getHours() >= 18;
-    var first = needs > 0
-      ? (quiet ? countWord(needs) + ' ' + plural(needs, 'handoff', 'handoffs') + ' can wait until tomorrow'
-        : countWord(needs) + ' ' + plural(needs, 'handoff is', 'handoffs are') + ' waiting on you')
-      : 'Nothing is waiting on you';
-    var nextBit = '';
-    var nd = next && toDate(next.time);
+    if (TODAY.offline) { el.textContent = 'COS on ' + state.serverName + ' is not answering right now. Today fills in when it does.'; return; }
+    var first = '';
+    if (m.sessionsWaiting > 0) first = countWord(m.sessionsWaiting) + ' ' + plural(m.sessionsWaiting, 'session is', 'sessions are') + ' waiting on you';
+    else if (m.now.length > 0) first = countWord(m.now.length) + ' ' + plural(m.now.length, 'thing needs', 'things need') + ' you' + (m.settled ? '' : ' so far');
+    else if (m.later.length > 0) first = countWord(m.later.length) + ' ' + plural(m.later.length, 'thing', 'things') + ' can wait until tomorrow' + (m.settled ? '' : ' so far');
+    else if (m.settled) first = 'Nothing is waiting on you';
+    var next = TODAY.welcome && TODAY.welcome.nextEvent, nd = next && toDate(next.time);
     if (nd && next.title && (nd.getTime() - Date.now()) < 18 * 3600000 && nd.getTime() > Date.now() - 600000) {
-      var dw = dayWord(nd);
-      nextBit = ', and ' + next.title + ' is at ' + clock(nd) + (dw === 'today' ? '' : ' ' + dw);
+      var dw = dayWord(nd), words = next.title + ' is at ' + clock(nd) + (dw === 'today' ? '' : ' ' + dw);
+      first = first ? first + ', and ' + words : words.charAt(0).toUpperCase() + words.slice(1);
     }
-    var second;
-    if (working > 0) second = countWord(working) + ' ' + plural(working, 'agent is', 'agents are') + ' working' + (open > 0 ? ', with ' + countWord(open, true) + ' more ' + plural(open, 'session', 'sessions') + ' open' : '');
+    var working = TODAY.working.length, open = TODAY.open.length, second;
+    var unread = TODAY.sessionsState === 'failed';
+    // The sessions sentence speaks only about a list that was read (W3-r2: "No agents are running" while two worked).
+    if (unread) second = 'Couldn\u2019t read your sessions';
+    else if (working > 0) second = countWord(working) + ' ' + plural(working, 'agent is', 'agents are') + ' working' + (open > 0 ? ', with ' + countWord(open, true) + ' more ' + plural(open, 'session', 'sessions') + ' open' : '');
     else if (open > 0) second = countWord(open) + ' ' + plural(open, 'session is', 'sessions are') + ' open and quiet';
     else second = 'No agents are running';
-    if (recording) second += (working > 0 || open > 0 ? ', and ' : '. ') + 'COS is recording a meeting';
-    el.textContent = first + nextBit + '. ' + second + '.';
-  }
+    if (TODAY.recording) second += (unread || working > 0 || open > 0 ? ', and ' : '. ') + 'COS is recording a meeting';
+    var out = (first ? first + '. ' : '') + second + '.';
+    var others = m.failed.filter(function (n) { return n !== 'sessions'; });
+    if (!m.settled && !m.now.length && !m.later.length) out += (unread ? others : m.failed).length ? ' Couldn\u2019t read ' + listWords(unread ? others : m.failed) + ', so this may not be everything.' : unread ? ' This may not be everything that needs you.' : ' Still reading what needs you.';
+    else if (unread) out += ' This may not be everything that needs you.';
+    el.textContent = out;
+  }
+  function listWords(names) { return names.length < 2 ? names.join('') : names.slice(0, -1).join(', ') + ' and ' + names[names.length - 1]; }
   function runRow(s, activeNow) {
     var key = splitSessionId(s.provider, s.session_id);
     var meta = activeNow
       ? 'Working for ' + span(s.state_since || s.last_activity_at)
       : 'Open, quiet for ' + span(s.last_activity_at || s.state_since);
     if (s.project && s.project !== usualProject()) meta += ', in ' + String(s.project).replace(/^-Users-[^-]+-/, '');
-    return '<button type="button" class="run-row" data-session="' + esc(key.provider) + '|' + esc(key.id) + '">' +
+    // A tap opens the peek on Today (panes/today-actions.js); it falls back to the reader if the peek cannot load.
+    return '<button type="button" class="run-row" data-today="run" data-key="' + esc(key.provider) + '|' + esc(key.id) + '">' +
       '<span class="run-who">' + badge(key.provider) + (activeNow ? '<span class="pulse" aria-label="working"></span>' : '') + '</span>' +
       '<span class="run-title">' + esc(sessionTitle(s)) + '</span>' +
       '<span class="run-meta">' + esc(meta) + '</span></button>';
@@ -333,6 +608,8 @@
   function renderRunning(working, open) {
     $('run-count').textContent = working.length ? String(working.length) : '';
     var list = $('run-list');
+    // Never "Nothing running" about a list that was not read.
+    if (TODAY.sessionsState === 'failed') { list.innerHTML = '<button type="button" class="run-more run-failed" data-today-needs="retry">Couldn\u2019t read sessions. Try again</button>'; return; }
     var shown = working.slice(0, 3);
     var html = shown.map(function (s) { return runRow(s, true); }).join('');
     if (!shown.length) {
@@ -350,21 +627,121 @@
     if (item.status === 'delivered') return 'Handed to you';
     return 'Needs a look';
   }
-  function renderNeeds(items) {
-    $('needs-count').textContent = items.length ? String(items.length) : '';
-    var list = $('needs-list');
-    if (!items.length) { list.innerHTML = '<p class="card-empty">You are clear. New handoffs from your agents land here.</p>'; return; }
-    // One primary action, on the item that has waited longest for a reply; the rest stay quiet.
-    list.innerHTML = items.slice(0, 6).map(function (it, i) {
-      var key = splitSessionId(it.provider, it.sessionId);
-      var title = it.sessionTitle || it.title || 'Handoff';
+  // ── Needs you (COS Control's TodayHome.things, sourceStates and fold; Models.swift 14291, 14512, 14474) ──
+  // Every source Control's Today reads that the web can: sessions waiting on you (the session list), Work handoffs
+  // (your-move), voices to name (/api/voice/held-groups) and memories to review (the memories bridge's status). One row
+  // per thing. The card's count, the headline and the rail say the same number, from the same rows. "Nothing is
+  // waiting on you" only once every source answered; a source that failed is named instead. Under quiet hours (after
+  // 6 PM, before 6 AM, weekends) everything but a waiting session folds under "can wait until tomorrow".
+  var NEEDS_SHOWN = 6;
+  var NEED_NAMES = { sessions: 'sessions', work: 'Work', voices: 'voices', memories: 'memories' };
+  function quietNowToday(d) { var h = d.getHours(), day = d.getDay(); return day === 0 || day === 6 || h >= 18 || h < 6; }
+  // Control's askedTitle and askedWhy for a session waiting on you.
+  // Control's TodayHome: guarded(title) ?? "A session". Never the workspace path or the session id: this line is shown
+  // on Today and goes into the Today summary sent to the model, which carries no ids.
+  function askedTitle(s) {
+    var t = plain(s.display_label || s.custom_title || '').replace(/\s+/g, ' ').trim() || 'A session';
+    if (sxProvider(s.provider) !== 'claude') return t + ' is waiting for your reply';
+    if (s.waiting_kind === 'plan') return t + ' has a plan for you to approve';
+    if (s.waiting_kind === 'permission') return t + ' wants your permission';
+    if (s.waiting_kind === 'mcp_input') return t + ' needs your input';
+    return t + ' asked you a question';
+  }
+  // Control never shows a bare tool name (TodayHome.toolNames): "AskUserQuestion" says nothing to a person.
+  var TOOL_NAMES = ['AskUserQuestion', 'ExitPlanMode', 'Bash', 'BashOutput', 'KillShell', 'Edit', 'Write', 'Read', 'Grep', 'Glob', 'LS', 'Task', 'Agent',
+    'WebFetch', 'WebSearch', 'TodoWrite', 'NotebookEdit', 'MultiEdit', 'SlashCommand', 'Skill', 'ToolSearch'];
+  function askedWhy(s) {
+    if (s.waiting_kind === 'plan') return 'Has a plan for you to approve';
+    var d = String(s.waiting_detail || '').trim();
+    if (TOOL_NAMES.indexOf(d) >= 0) d = '';
+    if (s.waiting_kind === 'permission' && d) return 'Wants to run ' + (d.length > 80 ? d.slice(0, 79) + '…' : d);
+    if (s.waiting_kind === 'question' && d) return d.length > 160 ? d.slice(0, 159) + '…' : d;
+    return 'Waiting for you' + (sxProvider(s.provider) === 'claude' ? '. Paused until you answer.' : '');
+  }
+  function needsModel() {
+    var states = { sessions: TODAY.sessionsState, work: TODAY.workState, voices: TODAY.voices.state, memories: TODAY.memories.state };
+    var rows = [], seen = {};
+    (state.sessions || []).forEach(function (s) {
+      if (sxKeepWarm(s) || sxState(s) !== 'waiting') return;
+      var k = splitSessionId(s.provider, s.session_id || s.id);
+      seen[k.provider + '|' + String(k.id).toLowerCase()] = 1;
+      rows.push({ kind: 'session', tier: 1, title: askedTitle(s), why: askedWhy(s), since: s.state_since || s.last_activity_at, key: k.provider + '|' + k.id });
+    });
+    (TODAY.needs || []).forEach(function (it) {
+      var k = splitSessionId(it.provider, it.sessionId);
+      if (k.id && seen[k.provider + '|' + String(k.id).toLowerCase()]) return;   // Control: a Work row for a waiting session is the session's row
+      rows.push({ kind: 'work', tier: 3, item: it, key: k.id ? k.provider + '|' + k.id : '' });
+    });
+    var groups = TODAY.voices.groups || [];
+    if (groups.length) {
+      var named = groups.filter(function (g) { return g && g.suggestion && g.suggestion.name; })[0];
+      rows.push({ kind: 'voices', tier: 2, title: groups.length === 1 ? 'Name a held voice' : 'Name ' + groups.length + ' held voices',
+        why: named ? 'One sounds like ' + named.suggestion.name + '.' : 'Held from your recordings until they have a name.' });
+    }
+    if (TODAY.memories.n > 0) {
+      var n = TODAY.memories.n;
+      rows.push({ kind: 'memories', tier: 4, title: n === 1 ? 'Review a memory' : 'Review ' + n + ' memories', why: 'Learned from your meetings and sessions, waiting for a yes or no.' });
+    }
+    var quiet = quietNowToday(new Date());
+    var nowRows = rows.filter(function (r) { return !quiet || r.tier === 1; }), later = rows.filter(function (r) { return quiet && r.tier !== 1; });
+    var failed = Object.keys(states).filter(function (k) { return states[k] === 'failed'; }).map(function (k) { return NEED_NAMES[k]; });
+    var settled = Object.keys(states).every(function (k) { return states[k] === 'answered'; });
+    return { rows: rows, now: nowRows, later: later, failed: failed, settled: settled, states: states,
+      sessionsWaiting: rows.filter(function (r) { return r.kind === 'session'; }).length };
+  }
+  function paintNeeds() {
+    if (!TODAY.at) return;
+    var m = TODAY.model = needsModel();
+    renderStory(m);
+    renderNeeds(m);
+    setBadge('today', m.now.length > 0);
+    if (window.COSWeb && window.COSWeb.setStory) window.COSWeb.setStory('today', todayRailLine(m), m.now.length > 0);
+  }
+  // The rail's Today line, from the same rows (shell.js keeps its own count off Today).
+  function todayRailLine(m) {
+    var n = m.now.length, bits = [];
+    if (n > 0) bits.push(n === 1 ? '1 needs you' : n + ' need you');
+    else if (m.later.length) bits.push(m.later.length + ' can wait until tomorrow');
+    else if (m.settled) bits.push('Nothing needs you');
+    else if (m.failed.length) bits.push('Couldn’t read ' + listWords(m.failed));
+    else bits.push('Reading');
+    if (TODAY.working.length) bits.push(TODAY.working.length + ' running');
+    return bits.join(', ');
+  }
+  function needRowHtml(r, i) {
+    var age = r.since ? ago(r.since) : r.item ? ago(r.item.updatedAt || r.item.createdAt) : '';
+    var top = function (title) { return '<span class="need-top"><span class="need-title">' + esc(title) + '</span>' + (age ? '<span class="need-age">' + esc(age) + '</span>' : '') + '</span>'; };
+    if (r.kind === 'work') {
+      var it = r.item, k = splitSessionId(it.provider, it.sessionId);
       var why = needWhy(it) + (it.domain ? ' in ' + domainLabel(it.domain) : '');
+      // The row opens it in an overlay on Today (panes/today-actions.js); Open session still goes to the reader.
       return '<div class="need-row">' +
-        '<div class="need-top"><span class="need-title">' + esc(title) + '</span><span class="need-age">' + esc(ago(it.updatedAt || it.createdAt)) + '</span></div>' +
-        '<div class="need-foot">' + esc(why) + '</div>' +
-        (key.id ? '<div class="need-actions"><button type="button" class="btn small' + (i === 0 ? ' primary' : '') + '" data-session="' + esc(key.provider) + '|' + esc(key.id) + '">Open session</button></div>' : '') +
-      '</div>';
-    }).join('');
+        '<button type="button" class="need-open" data-today="need" data-key="' + esc(it.id) + '"' + (k.id ? ' data-session-key="' + esc(k.provider) + '|' + esc(k.id) + '"' : '') + '>' +
+        top(it.sessionTitle || it.title || 'Handoff') + '<span class="need-foot">' + esc(why) + '</span></button>' +
+        (k.id ? '<div class="need-actions"><button type="button" class="btn small' + (i === 0 ? ' primary' : '') + '" data-session="' + esc(k.provider) + '|' + esc(k.id) + '">Open session</button></div>' : '') + '</div>';
+    }
+    if (r.kind === 'session') {
+      // The session's question shows in the overlay's peek, with its cards to answer.
+      return '<div class="need-row">' +
+        '<button type="button" class="need-open" data-today="wait" data-key="' + esc(r.key) + '">' + top(r.title) + '<span class="need-foot">' + esc(r.why) + '</span></button>' +
+        '<div class="need-actions"><button type="button" class="btn small' + (i === 0 ? ' primary' : '') + '" data-session="' + esc(r.key) + '">Open session</button></div></div>';
+    }
+    var go2 = r.kind === 'voices' ? 'speakers' : 'memories/view/review', label = r.kind === 'voices' ? 'Name' : 'Review';
+    return '<div class="need-row">' +
+      '<button type="button" class="need-open" data-goto="' + go2 + '">' + top(r.title) + '<span class="need-foot">' + esc(r.why) + '</span></button>' +
+      '<div class="need-actions"><button type="button" class="btn small' + (i === 0 ? ' primary' : '') + '" data-goto="' + go2 + '">' + label + '</button></div></div>';
+  }
+  function renderNeeds(m) {
+    var shown = TODAY.showLater ? m.now.concat(m.later) : m.now;
+    $('needs-count').textContent = m.now.length ? String(m.now.length) : '';
+    var list = $('needs-list');
+    var visible = TODAY.showAllNeeds ? shown : shown.slice(0, NEEDS_SHOWN);
+    var html = visible.map(needRowHtml).join('');
+    if (shown.length > visible.length) html += '<button type="button" class="need-more" data-today-needs="all">Show ' + (shown.length - visible.length) + ' more</button>';
+    if (m.later.length && !TODAY.showLater) html += '<button type="button" class="need-more" data-today-needs="later">' + esc(m.later.length + (m.later.length === 1 ? ' thing can' : ' things can') + ' wait until tomorrow. Show') + '</button>';
+    if (!m.rows.length) html = '<p class="card-empty">' + esc(m.settled ? 'Nothing is waiting on you.' : m.failed.length ? '' : 'Reading sessions, Work, voices and memories.') + '</p>';
+    m.failed.forEach(function (name) { html += '<button type="button" class="need-more need-failed" data-today-needs="retry">' + esc('Couldn’t read ' + name + '. Try again') + '</button>'; });
+    list.innerHTML = html;
   }
   function renderNext(w) {
     var card = $('next-card');
@@ -374,30 +751,73 @@
     var dw = dayWord(d);
     $('next-body').innerHTML = '<span class="when">' + esc(clock(d)) + '</span><span><span class="what">' + esc(n.title) + '</span>' +
       '<span class="sub" style="display:block">' + esc((dw.charAt(0).toUpperCase() + dw.slice(1)) + (weather ? '. Now ' + weather : '')) + '</span></span>';
+    // Control's Next up (todayPrepButtons): Prep me opens the Prep composer in the COS chat (panes/cos-chat.js prepFor),
+    // Open meeting opens Meetings. Without a server to answer, Prep me is not offered.
+    var prep = !TODAY.offline && window.COSWeb && window.COSWeb.cosChat && window.COSWeb.cosChat.prepFor;
+    $('next-actions').innerHTML = (prep ? '<button type="button" class="btn small primary" data-today-next="prep">Prep me</button>' : '') +
+      '<button type="button" class="link-btn" data-goto="meetings">Open meeting</button>';
     card.classList.remove('hidden');
   }
+  function prepNext() {
+    var n = TODAY.welcome && TODAY.welcome.nextEvent, d = n && toDate(n.time), chat = window.COSWeb && window.COSWeb.cosChat;
+    if (!n || !n.title || !chat || !chat.prepFor) return;
+    go('messages', ['cos']);
+    chat.prepFor(n.title, d ? d.toISOString() : null).catch(function (err) { toast((err && err.message) || 'Prep me did not start.'); });
+  }
   // From today's meetings: Work's suggestions from meetings held today. They stay here until
   // midnight, then join Sort in Work; Review opens them in Work's Sort.
   function localDay(d) { return d.getFullYear() + '-' + String(d.getMonth() + 1).padStart(2, '0') + '-' + String(d.getDate()).padStart(2, '0'); }
   function loadTodayIntake() {
-    var card = $('intake-card'); if (!card) return;
-    api('/api/work-intake').then(function (d) {
+    var card = $('intake-card'); if (!card) return Promise.resolve();
+    return api('/api/work-intake').then(function (d) {
       var today = localDay(new Date());
       var items = ((d && d.items) || []).filter(function (it) {
         if (['suggested', 'review', 'ask'].indexOf(it.status) < 0) return false;
         var day = String((it.meeting && (it.meeting.filename || it.meeting.date)) || '').match(/\d{4}-\d{2}-\d{2}/);
         return day && day[0] === today;
       });
-      if (!items.length) { card.classList.add('hidden'); return; }
-      var meetings = {};
-      items.forEach(function (it) { var t = (it.meeting && it.meeting.title) || 'A meeting'; meetings[t] = (meetings[t] || 0) + 1; });
-      $('intake-count').textContent = String(items.length);
-      $('intake-body').innerHTML = Object.keys(meetings).slice(0, 4).map(function (t) {
-        return '<div class="intake-row"><span class="intake-meeting">' + esc(t) + '</span><span class="intake-n">' + meetings[t] + '</span></div>';
-      }).join('') + '<p class="intake-foot">Moves to Work at midnight.</p>';
-      card.classList.remove('hidden');
+      TODAY.intake = items; TODAY.intakeCaps = (d && d.capabilities) || {};
+      // A decision made on Today hides its row at once; a read that no longer lists it ends the hiding.
+      Object.keys(TODAY.gone).forEach(function (id) { if (!items.some(function (it) { return it.id === id; })) delete TODAY.gone[id]; });
+      paintTodayIntake();
     }, function () { card.classList.add('hidden'); });
   }
+  // Today's overlay (panes/today-actions.js) reads what the cards show from here and repaints the intake card after a
+  // decision, so the counts move the moment Work takes it.
+  var TODAY = { needs: [], working: [], open: [], welcome: {}, offline: false, at: 0, intake: null, intakeCaps: {}, gone: {},
+    gen: 0, sessionsState: 'pending', workState: 'pending', voices: { state: 'pending', groups: [] }, memories: { state: 'pending', n: 0 }, extraAt: 0,
+    recording: false, model: null, showAllNeeds: false, showLater: false };
+  function todayIntakeOpen() { return (TODAY.intake || []).filter(function (it) { return !TODAY.gone[it.id]; }); }
+  function paintTodayIntake() {
+    var card = $('intake-card'); if (!card) return;
+    var items = todayIntakeOpen();
+    if (!items.length) { card.classList.add('hidden'); return; }
+    var meetings = {};
+    items.forEach(function (it) { var t = (it.meeting && it.meeting.title) || 'A meeting'; meetings[t] = (meetings[t] || 0) + 1; });
+    $('intake-count').textContent = String(items.length);
+    $('intake-body').innerHTML = Object.keys(meetings).slice(0, 4).map(function (t) {
+      return '<button type="button" class="intake-row" data-today="meeting" data-key="' + esc(t) + '"><span class="intake-meeting">' + esc(t) + '</span><span class="intake-n">' + meetings[t] + '</span></button>';
+    }).join('') + '<p class="intake-foot">Moves to Work at midnight.</p>';
+    card.classList.remove('hidden');
+  }
+  function openTodayAction(t) {
+    var kind = t.getAttribute('data-today'), key = t.getAttribute('data-key') || '';
+    ensurePane('todayActions', 4000).then(function (m) {
+      if (!m || !m.open) throw new Error('The Today overlay did not start.');
+      m.open(kind, key, t);
+    }).catch(function (err) {
+      // Without the overlay, the tap goes where it went before: the session reader, or Sort in Work. Web has no client
+      // log route, so the failure is said on screen and in the console first. An overlay that half opened leaves its
+      // history entry, which the fallback replaces, so Back from there still lands on Today.
+      var s = String(kind === 'run' || kind === 'wait' ? key : t.getAttribute('data-session-key') || '').split('|');
+      var session = (kind === 'run' || kind === 'wait' || kind === 'need') && !!s[1];
+      var dest = session ? ['sessions', s[0], s.slice(1).join('|')] : ['work'].concat(kind === 'need' ? [] : ['sort']);
+      console.error('[today] the overlay did not open (' + kind + '); opening ' + dest.join('/') + ' instead.', err);
+      toast(session ? 'Could not open that here. Opening the session.' : 'Could not open that here. Opening it in Work.');
+      if (history.state && history.state.cosTodayOverlay) location.replace('#/' + dest.map(encodeURIComponent).join('/'));
+      else go(dest[0], dest.slice(1));
+    });
+  }
   function setBadge(name, on) { document.querySelectorAll('[data-badge="' + name + '"]').forEach(function (b) { b.classList.toggle('hidden', !on); }); }
 
   // ── Sessions ────────────────────────────────────────────
@@ -583,9 +1003,21 @@
     if (SX.view !== 'sessions') { renderUsageView(force === true); return Promise.resolve(); }
     loadSessionHooks();
     if (force !== true && SX.rows && Date.now() - SX.loadedAt < 15000) { renderSessionGroups(); return Promise.resolve(); }
-    SX.loading = true;
-    renderSessionGroups();
-    return api('/api/agent-sessions?limit=80&sort=updated').then(function (d) {
+    // Paint the shared copy at once (Today usually fetched it) and refresh in place behind it.
+    var cached = !SX.rows && sessionListCached();
+    if (cached && cached.data && Array.isArray(cached.data.sessions)) {
+      SX.rows = cached.data.sessions; SX.dropped = cached.data.dropped || null; SX.enabled = cached.data.enabled !== false;
+      SX.loadedAt = cached.at;
+      if (sxQueryActive()) SX.instant = sxInstant(SX.q);
+      var fresh = force !== true && Date.now() - cached.at < 15000;
+      SX.loading = !fresh;   // rows stay on screen; the header reads "Refreshing…" until the new list lands
+      renderSessionGroups();
+      if (fresh) return Promise.resolve();
+    } else {
+      SX.loading = true;
+      renderSessionGroups();
+    }
+    return sessionList(force === true ? 0 : 15000).then(function (d) {
       SX.rows = (d && d.sessions) || [];
       SX.dropped = (d && d.dropped) || null;
       SX.enabled = !(d && d.enabled === false);
@@ -1041,7 +1473,8 @@
       if (f.tools.length > 8) f.tools.splice(0, f.tools.length - 8);
     }
   }
-  var SX_VERBS = { read: 'Read', edit: 'Edited', write: 'Edited', bash: 'Ran', run: 'Ran', search: 'Searched', grep: 'Searched', glob: 'Searched', fetch: 'Fetched', web: 'Fetched', agent: 'Delegated', task: 'Delegated' };
+  // `other` is the stream's verb for every tool it has no verb for; its target names the tool ("Used SendMessage").
+  var SX_VERBS = { read: 'Read', edit: 'Edited', write: 'Edited', bash: 'Ran', run: 'Ran', search: 'Searched', grep: 'Searched', glob: 'Searched', fetch: 'Fetched', web: 'Fetched', agent: 'Delegated', task: 'Delegated', other: 'Used' };
   function sxToolLine(t) { var v = String(t.verb || 'tool'); var w = SX_VERBS[v] || v.charAt(0).toUpperCase() + v.slice(1); return t.target ? w + ' ' + t.target : w; }
   // The word follows the page's own working flag, which a Stop or a finished turn settles before
   // the stream's status catches up; otherwise the server's derived state, as Control reads it.
@@ -1220,14 +1653,15 @@
   // probeChatAttachability): a busy thread parks a send, another app holding it idle asks first,
   // and anything else is the server's refusal, word for word.
   function sxProbeAttach(r) {
-    apiAnswer(sessionPath(r.provider, r.id, '/attachability')).then(function (a) {
-      if (state.reading !== r) return;
-      if (a.status === 404) { r.verdict = { attachable: false, reason: 'route_absent', reasonCopy: 'Update the COS server to continue a thread from here.', ownerCount: 0 }; renderVerdict(r); return; }
+    // Today's overlay probes its own session object (r.view): the same verdict, painted by its view.
+    return apiAnswer(sessionPath(r.provider, r.id, '/attachability')).then(function (a) {
+      if (state.reading !== r && !r.view) return;
+      if (a.status === 404) { r.verdict = { attachable: false, reason: 'route_absent', reasonCopy: 'Update the COS server to continue a thread from here.', ownerCount: 0 }; viewOf(r).verdict(r); return; }
       var b = a.body || {};
       if (a.status !== 200 || typeof b.attachable !== 'boolean') return;
       var owners = Number(b.ownerCount) || 0;
       r.verdict = { attachable: b.attachable, reason: String(b.reason || ''), reasonCopy: String(b.reasonCopy || ''), ownerCount: owners, caution: b.attachable === true && owners > 0 };
-      renderVerdict(r);
+      viewOf(r).verdict(r);
     }).catch(function () {});
   }
   var SX_PARK = {
@@ -1278,8 +1712,8 @@
     el.className = 'status-line' + (kind === 'error' ? ' error' : '');
     el.innerHTML = esc(text || '') + (actionHtml || '');
   }
-  function draftFor(text) {
-    var r = state.reading;
+  function draftFor(text, r) {
+    r = r || state.reading;
     if (!r.draft || r.draft.text !== text) r.draft = { text: text, key: newTurnKey() };
     return r.draft;
   }
@@ -1312,6 +1746,21 @@
     r.held.forEach(function (h) { if (!h.cancelled && !heldBubble(h.key)) showPendingTurn(h.text, 'sends after this reply', h.key); });
   }
 
+  // Where the send path below reports: the reader's own page by default. Today's overlay (panes/today-actions.js)
+  // hands continueSession a session object with its own view, so a reply or a steer from Today runs this same attach,
+  // turn and queue path (one binding store, one key per draft, the same refusals). The overlay keeps its own copies of
+  // the gates around it (sendSessionTurn), the turn watch (watchTurn) and the refusal box (renderVerdict).
+  var READER_VIEW = {
+    status: function (r, text, kind, actionHtml) { sessionStatus(text, kind, actionHtml); },
+    pending: function (r, text, note) { showPendingTurn(text, note); },
+    clear: function (r, text) { clearBoxOf(text); },
+    verdict: function (r) { renderVerdict(r); },
+    hold: function (r, draft) { holdUntilReplyEnds(r, draft); },
+    watch: function (r, bindingId, key) { watchTurn(bindingId, key, r.provider, r.id); },
+    queue: function (r) { loadQueue(r.provider, r.id); }
+  };
+  function viewOf(r) { return (r && r.view) || READER_VIEW; }
+
   function sendSessionTurn(fork, opts) {
     var r = state.reading; var form = $('session-form');
     if (!r || !form) return;
@@ -1345,8 +1794,8 @@
   // Resolves to 'sent' | 'parked' | 'held' | 'refused' | 'changed'.
   function continueSession(r, text, opts) {
     var provider = r.provider, id = r.id;
-    var draft = opts.held ? { text: opts.held.text, key: opts.held.key } : draftFor(text);
-    if (!opts.held) sessionStatus('Sending');
+    var draft = opts.held ? { text: opts.held.text, key: opts.held.key } : draftFor(text, r), view = viewOf(r);
+    if (!opts.held) view.status(r, 'Sending');
     var bound = bindingFor(provider, id);
     var attach = bound ? Promise.resolve({ ok: true, binding: bound }) : apiAnswer(sessionPath(provider, id, '/attach'), { method: 'POST', body: { cosSessionId: cosSessionId() }, timeoutMs: 20000 }).then(function (a) {
       // 201 Created on success; any 2xx that says attached counts.
@@ -1368,9 +1817,9 @@
         if (opts.held) settleHeld(r, opts.held, 'refused', copy);
         else {
           // Control's refusal box: the server's words, then Fork with this message.
-          sessionStatus('');
+          view.status(r, '');
           r.refusal = { copy: (at.refusal && at.refusal.reasonCopy) || 'COS cannot write to this session right now.', supplement: sxSupplement(why), fork: true };
-          renderVerdict(r);
+          view.verdict(r);
         }
         return 'refused';
       }
@@ -1381,9 +1830,9 @@
         var b = t.body || {};
         if (t.status >= 200 && t.status < 300 && (b.outcome === 'queued' || b.outcome === 'completed')) {
           if (opts.held) settleHeld(r, opts.held, 'sent');
-          else { showPendingTurn(draft.text, b.replayed ? 'already sent' : 'sent'); clearBoxOf(draft.text); }
-          sessionStatus(b.replayed ? 'Already sent. Watching for the reply.' : 'Sent. Watching for the reply.');
-          watchTurn(at.binding.bindingId, draft.key, provider, id);
+          else { view.pending(r, draft.text, b.replayed ? 'already sent' : 'sent'); view.clear(r, draft.text); }
+          view.status(r, b.replayed ? 'Already sent. Watching for the reply.' : 'Sent. Watching for the reply.');
+          view.watch(r, at.binding.bindingId, draft.key);
           return 'sent';
         }
         var reason = b.reason || '';
@@ -1391,15 +1840,15 @@
         // COS's own reply is still running on this thread. The server's queue counts that
         // thread as free (the running child is COS's), so it cannot park this; the page holds
         // it under the same key and sends it the moment the reply ends.
-        if (reason === 'native_turn_in_progress') { if (!opts.held) holdUntilReplyEnds(r, draft); return 'held'; }
+        if (reason === 'native_turn_in_progress') { if (!opts.held) view.hold(r, draft); return 'held'; }
         if (reason === 'native_thread_changed' && b.revision) {
           if (opts.held) settleHeld(r, opts.held, 'refused', 'This session changed on your Mac while your message waited.');
           else {
             // Control's refusal box for a changed thread: Refresh, Continue anyway, Fork with this message.
             r.sendAnyway = b.revision;
-            sessionStatus('');
+            view.status(r, '');
             r.refusal = { copy: b.reasonCopy || 'This session changed on your Mac since you opened it.', changed: true, fork: true };
-            renderVerdict(r);
+            view.verdict(r);
           }
           return 'changed';
         }
@@ -1409,7 +1858,7 @@
         }
         var refusedCopy = b.reasonCopy || 'The session did not take that message.';
         if (opts.held) settleHeld(r, opts.held, 'refused', refusedCopy);
-        else sessionStatus(refusedCopy + ' It is still in the box.', 'error');
+        else view.status(r, refusedCopy + ' It is still in the box.', 'error');
         return 'refused';
       });
     });
@@ -1469,6 +1918,7 @@
   }
 
   function parkTurn(r, draft, refusal, opts) {
+    var view = viewOf(r);
     return apiAnswer(sessionPath(r.provider, r.id, '/queued-turns'), {
       method: 'POST', timeoutMs: 15000,
       body: { cosSessionId: cosSessionId(), clientTurnId: draft.key, prompt: draft.text },
@@ -1477,14 +1927,14 @@
       if (b.queued === true || b.error === 'duplicate_turn') {
         rememberParked(r, draft.key);
         if (opts.held) settleHeld(r, opts.held, 'parked');
-        else { showPendingTurn(draft.text, 'waiting in line'); clearBoxOf(draft.text); }
-        sessionStatus(b.error === 'duplicate_turn' ? 'Already waiting to send.' : (b.position ? 'The session is busy. Yours is #' + (b.position + 1) + ' in line and sends on its own.' : 'The session is busy. Yours sends next, on its own.'));
-        loadQueue(r.provider, r.id);
+        else { view.pending(r, draft.text, 'waiting in line'); view.clear(r, draft.text); }
+        view.status(r, b.error === 'duplicate_turn' ? 'Already waiting to send.' : (b.position ? 'The session is busy. Yours is #' + (b.position + 1) + ' in line and sends on its own.' : 'The session is busy. Yours sends next, on its own.'));
+        view.queue(r);
         return 'parked';
       }
       if (b.error === 'thread_free' && !opts.freeRetry) return continueSession(r, draft.text, Object.assign({}, opts, { freeRetry: true }));
       var copy = (refusal && refusal.reasonCopy) || (b.error === 'queue_full' ? 'That session already has a full line of waiting messages.' : 'COS could not send or queue that.');
-      if (opts.held) settleHeld(r, opts.held, 'refused', copy); else sessionStatus(copy + ' It is still in the box.', 'error');
+      if (opts.held) settleHeld(r, opts.held, 'refused', copy); else view.status(r, copy + ' It is still in the box.', 'error');
       return 'refused';
     });
   }
@@ -1749,21 +2199,31 @@
     var h = Array.prototype.map.call(b, function (x) { return (x + 0x100).toString(16).slice(1); }).join('');
     return h.slice(0, 8) + '-' + h.slice(8, 12) + '-' + h.slice(12, 16) + '-' + h.slice(16, 20) + '-' + h.slice(20);
   }
+  var TODAY_REFERENCE = 'What Today in COS Control shows right now';
   function askCos(prompt, statusEl) {
     // 6.99.12: "it shows Sent but never shows up" (Miles, 11/04). With Ask COS in Messages, the sheet hands its words to
     // that composer (panes/cos-chat.js submitAsk), so the answer streams on screen and lands as a numbered turn. The
     // request below is the fallback for a page without it; it resolves to the Messages route to open.
     var chat = window.COSWeb && window.COSWeb.cosChat;
+    // Asked from Today: COS gets a short summary of what Today shows (panes/today-actions.js summary), as the Ask's
+    // quoted reference, the query-jobs field for context. Asked from any other pane, nothing extra is sent.
+    var context = state.pane === 'today' ? ensurePane('todayActions', 1500).then(function (m) {
+      // A broken summary never costs the Ask: it goes without it, and the console says why.
+      try { return m && m.summary ? m.summary() : ''; } catch (err) { console.error('[today] the Today summary failed; asking without it.', err); return ''; }
+    }, function () { return ''; }) : Promise.resolve('');
     if (chat && chat.askFromSheet) {
       setStatus(statusEl, 'Sending…');
-      return chat.askFromSheet(prompt).then(function (where) { setStatus(statusEl, ''); return where; }, function (err) {
+      return context.then(function (ctx) { return chat.askFromSheet(prompt, ctx ? { context: ctx } : undefined); }).then(function (where) { setStatus(statusEl, ''); return where; }, function (err) {
         setStatus(statusEl, err.message, true);
         throw err;
       });
     }
     setStatus(statusEl, 'Sent. COS is answering.');
     var body = { clientJobId: webJobId(), generation: 1, query: prompt, source: 'web', activityToolMode: 'status' };
-    return api('/api/query-jobs', { method: 'POST', body: body, timeoutMs: 30000 }).then(function () {
+    return context.then(function (ctx) {
+      if (ctx) body.reference = { query: TODAY_REFERENCE, response: ctx };
+      return api('/api/query-jobs', { method: 'POST', body: body, timeoutMs: 30000 });
+    }).then(function () {
       // The answer lands in Messages; refresh it there if it is open.
       var again = function () { if (state.pane === 'messages' && PANES.messages && PANES.messages.refresh) PANES.messages.refresh(); };
       setTimeout(again, 4000);
@@ -1774,27 +2234,6 @@
       throw err;
     });
   }
-  // ── Memories (the native page, hosted) ──────────────────
-  function syncFrameTheme() {
-    var frame = $('memories-frame'); if (!frame) return;
-    var mode = window.CosTheme ? window.CosTheme.mode() : 'light';
-    frame.style.colorScheme = mode;
-    try {
-      var root = frame.contentDocument && frame.contentDocument.documentElement;
-      if (root) {
-        root.setAttribute('data-theme', mode);
-        if (isPhone()) root.setAttribute('data-host', 'web-phone'); else root.removeAttribute('data-host');
-      }
-    } catch (_e) {}
-  }
-  function loadMemories() {
-    var frame = $('memories-frame');
-    if (state.memoriesLoaded) { syncFrameTheme(); return; }
-    state.memoriesLoaded = true;
-    frame.addEventListener('load', syncFrameTheme);
-    frame.src = '/control/memories/memories.html';
-  }
-
   // ── Usage ───────────────────────────────────────────────
   // Usage and COS cost are views inside Sessions, as on the Mac (ActivityWindow.swift 2306-2325);
   // an old #/usage link opens the Usage view there. Data: GET /api/usage/summary, the helper's
@@ -3392,7 +3831,7 @@
         var left = exp ? Math.round((exp.getTime() - Date.now()) / 1000) : 0;
         var el = $('device-code-left');
         if (!el) { clearInterval(codeTimer); return; }
-        if (left <= 0) { clearInterval(codeTimer); panel.innerHTML = '<p>That code expired. Choose Sign in another device for a new one.</p>'; return; }
+        if (left <= 0) { clearInterval(codeTimer); panel.innerHTML = '<p>That code expired. Choose Use COS on another phone or browser for a new one.</p>'; return; }
         el.textContent = 'Works once, for ' + (left >= 60 ? Math.ceil(left / 60) + ' more min' : left + ' more sec') + '.';
       };
       tick(); codeTimer = setInterval(tick, 1000);
@@ -3413,7 +3852,57 @@
     ['today', 'Today'], ['messages', 'Messages'], ['speakers', 'Speakers'], ['meetings', 'Meetings'], ['memories', 'Memories'],
     ['threads', 'Threads'], ['sessions', 'Sessions'], ['work', 'Work'], ['dictation', 'Dictation'], ['usage', 'Usage'], ['settings', 'Settings']
   ];
+  // ⌘K's File to Work inbox (Control's todaySubmitAsk, ActivityWindow.swift 8810): the words become a task in the Work
+  // inbox, in Control's taskDomain (quilt when the server has it, else the first domain it lists: reconcileTaskDomain),
+  // through POST /api/tasks/capture,
+  // the route Work's Add task uses. One captureId per text: a second tap, or a retry after a lost answer, files it once.
+  var ASK_FILE = { text: '', id: '', busy: false, domains: null, note: null };
+  // The result shows on the row itself, so it is in view wherever the sheet is (W5-r2: a status line under the sheet
+  // at 1000x703 hid a refusal), and a toast says it too.
+  function fileNoteHtml(q) {
+    var n = ASK_FILE.note && ASK_FILE.note.text === q ? ASK_FILE.note : null;
+    if (n) return '<span class="note' + (n.error ? ' file-error' : '') + '" role="' + (n.error ? 'alert' : 'status') + '">' + esc(n.line) + '</span>';
+    return '<span class="note">' + esc('As a task in ' + fileDomainLabel()) + '</span>';
+  }
+  function fileDomainEntry() {
+    var d = ASK_FILE.domains || [];
+    return d.filter(function (x) { return x && x.name === 'quilt'; })[0] || d.filter(function (x) { return x && x.name; })[0] || null;
+  }
+  function fileDomain() { var e = fileDomainEntry(); return e ? e.name : 'quilt'; }
+  function fileDomainLabel() { var e = fileDomainEntry(); return (e && e.label) || domainLabel(fileDomain()); }
+  function loadFileDomains() {
+    if (ASK_FILE.domains) return Promise.resolve();
+    return api('/api/domains').then(function (d) { ASK_FILE.domains = (d && Array.isArray(d.domains)) ? d.domains : []; }, function () { ASK_FILE.domains = null; });
+  }
+  function fileToInbox(text) {
+    if (ASK_FILE.busy || !text) return;
+    if (ASK_FILE.text !== text) { ASK_FILE.text = text; ASK_FILE.id = webJobId(); }
+    ASK_FILE.busy = true; ASK_FILE.note = null; renderAskFile();
+    loadFileDomains().then(function () {
+      return api('/api/tasks/capture', { method: 'POST', body: { domain: fileDomain(), text: text, section: 'inbox', captureId: ASK_FILE.id }, timeoutMs: 20000 });
+    }).then(function () {
+      ASK_FILE.busy = false; ASK_FILE.text = ''; ASK_FILE.note = null;
+      var box = $('ask-q'); if (box && box.value.trim() === text) { box.value = ''; renderAsk(); }
+      renderAskFile();
+      toast('Filed to the Work inbox.');
+      if (PANES.work && PANES.work.intakeChanged) PANES.work.intakeChanged();   // Work reads its board again when it opens
+    }, function (err) {
+      ASK_FILE.busy = false;
+      var line = 'Not filed: ' + ((err && err.message) || 'your Mac did not answer') + ' Filing again is safe.';
+      ASK_FILE.note = { text: text, line: line, error: true };
+      renderAskFile();
+      toast(line);
+    });
+  }
+  function renderAskFile() {
+    var b = document.querySelector('#ask-results [data-action="ask-file"]'); if (!b) return;
+    b.disabled = ASK_FILE.busy;
+    var g = b.querySelector('.grow'); if (!g) return;
+    var q = ($('ask-q') && $('ask-q').value.trim()) || '';
+    g.innerHTML = esc(ASK_FILE.busy ? 'Filing\u2026' : 'File to Work inbox') + fileNoteHtml(q);
+  }
   function openAsk(prefill) {
+    loadFileDomains().then(function () { if (!$('ask-sheet').classList.contains('hidden') && $('ask-q').value.trim()) renderAsk(); });
     $('ask-sheet').classList.remove('hidden');
     document.body.style.overflow = 'hidden';
     var input = $('ask-q'); input.value = prefill || '';
@@ -3434,7 +3923,8 @@
     }
     var jumps = JUMPS.filter(function (j) { return j[1].toLowerCase().indexOf(q.toLowerCase()) === 0; });
     out.innerHTML = '<div class="list" style="margin-top:14px">' +
-      '<button type="button" class="nav-row" data-action="ask-cos"><svg class="icon"><use href="#i-ask"/></svg><span class="grow">Ask COS<span class="note">“' + esc(q) + '”</span></span></button>' +
+      '<button type="button" class="nav-row" data-action="ask-cos"><svg class="icon"><use href="#i-ask"/></svg><span class="grow">Ask COS<span class="note">“' + esc(q) + '”' + (state.pane === 'today' ? ' with what Today shows' : '') + '</span></span></button>' +
+      '<button type="button" class="nav-row" data-action="ask-file"' + (ASK_FILE.busy ? ' disabled' : '') + '><svg class="icon"><use href="#i-work"/></svg><span class="grow">' + (ASK_FILE.busy ? 'Filing\u2026' : 'File to Work inbox') + fileNoteHtml(q) + '</span></button>' +
       '<button type="button" class="nav-row" data-action="ask-meaning"><svg class="icon"><use href="#i-sessions"/></svg><span class="grow">Find a session about this<span class="note">Ranks every session by meaning</span></span></button>' +
       '<button type="button" class="nav-row" data-action="ask-work"><svg class="icon"><use href="#i-work"/></svg><span class="grow">Find a task about this<span class="note">Searches Work by meaning</span></span></button>' +
       jumps.map(function (j) { return '<button type="button" class="nav-row" data-goto="' + j[0] + '"><svg class="icon"><use href="#i-' + j[0] + '"/></svg><span class="grow">Go to ' + esc(j[1]) + '</span><span class="chev"></span></button>'; }).join('') +
@@ -3451,7 +3941,7 @@
 
   // ── events (one delegated listener) ─────────────────────
   document.addEventListener('click', function (e) {
-    var t = e.target.closest('[data-goto],[data-pane],[data-session],[data-meeting],[data-speakers],[data-action],[data-open-ask],[data-theme-choice],#topbar-back,#section-btn,#sign-out,#copy-link,#ask-close,#auth-switch,#auth-token-show,#device-code-btn');
+    var t = e.target.closest('[data-today-next],[data-today-needs],[data-today],[data-goto],[data-pane],[data-session],[data-meeting],[data-speakers],[data-action],[data-open-ask],[data-theme-choice],#topbar-back,#section-btn,#sign-out,#copy-link,#ask-close,#auth-switch,#auth-token-show,#device-code-btn');
     if (!t) { if (e.target.id === 'ask-sheet') closeAsk(); if (e.target.id === 'section-menu') closeMenu(); return; }
     var inSheet = !!t.closest('#ask-sheet');
     if (t.id === 'topbar-back') return goBack();
@@ -3482,7 +3972,16 @@
       return;
     }
     if (t.hasAttribute('data-open-ask')) return openAsk();
-    if (t.hasAttribute('data-theme-choice')) { window.CosTheme.set(t.getAttribute('data-theme-choice')); paintAppearance(); syncFrameTheme(); return; }
+    if (t.hasAttribute('data-today')) return openTodayAction(t);
+    if (t.hasAttribute('data-today-next')) return prepNext();
+    if (t.hasAttribute('data-today-needs')) {
+      var which = t.getAttribute('data-today-needs');
+      if (which === 'all') TODAY.showAllNeeds = true;
+      else if (which === 'later') TODAY.showLater = true;
+      else { TODAY.extraAt = 0; return loadToday(); }
+      return paintNeeds();
+    }
+    if (t.hasAttribute('data-theme-choice')) { window.CosTheme.set(t.getAttribute('data-theme-choice')); paintAppearance(); return; }
     if (t.hasAttribute('data-goto') || t.hasAttribute('data-pane')) {
       if (inSheet) closeAsk(); closeMenu();
       // "work/sort" is a pane and its arguments, not one name.
@@ -3506,11 +4005,12 @@
     if (action === 'expand-turn') { var tr = document.querySelector('.turn[data-turn="' + t.getAttribute('data-turn') + '"]'); if (tr) tr.classList.remove('clamped'); t.remove(); return; }
     var q = $('ask-q').value.trim();
     if (action === 'ask-cos' && q) { askCos(q, $('ask-status')).then(function (where) { closeAsk(); go('messages', Array.isArray(where) ? where : []); }).catch(function () {}); return; }
+    if (action === 'ask-file' && q) return fileToInbox(q);
     if (action === 'ask-meaning' && q) { $('ask-hits').innerHTML = skeletonRows(3); findByMeaning(q).then(function (html) { var el = $('ask-hits'); if (el) el.innerHTML = html; }); return; }
     if (action === 'ask-work' && q) {
       closeAsk(); go('work');
       // The Work pane (panes/work.js) owns its search box; hand it the query.
-      if (PANES.work && PANES.work.search) PANES.work.search(q);
+      ensurePane('work').then(function () { if (PANES.work && PANES.work.search) PANES.work.search(q); }, function () {});
     }
   });
 
@@ -3554,14 +4054,14 @@
     });
   });
   window.addEventListener('hashchange', route);
-  // Folding or unfolding the Duo crosses the 600px line: keep the hosted Memories page in step.
-  window.matchMedia('(min-width: 600px)').addEventListener('change', syncFrameTheme);
   window.addEventListener('scroll', onScroll, { passive: true });
   document.addEventListener('visibilitychange', function () {
     if (document.hidden || $('app-shell').classList.contains('hidden')) return;
     // Coming back to the page refreshes Today in place. Other panes keep what is on screen:
     // rebuilding them here moved the page under Miles's finger ("it reloads the section").
     if (state.pane === 'today' && Date.now() - (state.lastLoad.today || 0) > 60000) { state.lastLoad.today = Date.now(); loadToday(); }
+    // Back within the minute: Today keeps its data, but the pet's loop stopped while hidden, so restart it.
+    else if (state.pane === 'today' && PET.pose && !PET.timer) renderPet(state.sessions || []);
   });
   window.addEventListener('message', function (e) {
     if (e.origin !== location.origin) return;
@@ -3603,6 +4103,9 @@
     readStore: readStore, writeStore: writeStore, copyText: copyText, isPhone: isPhone,
     state: state, titles: TITLES, go: go, parseRoute: parseRoute, goBack: goBack,
     registerPane: function (name, def) { PANES[name] = def; },
+    sessionList: sessionList,
+    petPrefs: petPrefs,
+    setPetPrefs: setPetPrefs,
     onRoute: function (fn) { routeHooks.push(fn); },
     onShell: function (fn) { shellHooks.push(fn); },
     // The detail title after "COS Control > Section" (Control's breadcrumb). Pane modules set it
@@ -3616,6 +4119,41 @@
     sessionState: function (s) { return sxState(s); },
     isKeepWarm: function (s) { return sxKeepWarm(s); }
   };
+  // Today as a place to act (panes/today-actions.js, Miles 11/06): what the Today cards show, a repaint after a
+  // decision, and the Sessions reader's own pieces, so the overlay sends and reads through the reader's code.
+  window.COSWeb.pane = function (name) { return PANES[name] || null; };
+  // Tap, then tap again (Today's Dismiss, Stop and Send anyway; a question card's Allow, Deny and Send): the second tap
+  // counts only once the first has been on screen ARM_CONFIRM_MS, so a double tap or a finger bounce arms and never
+  // confirms (W2-r2). The one rule both panes/today-actions.js and panes/questions.js read.
+  var ARM_CONFIRM_MS = 400;
+  window.COSWeb.armConfirmMs = ARM_CONFIRM_MS;
+  window.COSWeb.confirmReady = function (armedAt) { return typeof armedAt === 'number' && Date.now() - armedAt >= ARM_CONFIRM_MS; };
+  window.COSWeb.today = {
+    data: function () {
+      return { needs: TODAY.needs, working: TODAY.working, open: TODAY.open, welcome: TODAY.welcome, offline: TODAY.offline, at: TODAY.at,
+        sessions: state.sessions || [], intake: todayIntakeOpen(), intakeCaps: TODAY.intakeCaps, intakeLoaded: TODAY.intake !== null };
+    },
+    needWhy: needWhy, sessionTitle: sessionTitle, badge: badge, span: span, splitSessionId: splitSessionId,
+    // Needs you as Today lists it (all four sources), for the overlay's summary and the rail.
+    needs: function () { return TODAY.model; },
+    railLine: function () { return TODAY.model ? { text: todayRailLine(TODAY.model), hot: TODAY.model.now.length > 0 } : null; },
+    markGone: function (id, gone) { if (gone) TODAY.gone[id] = 1; else delete TODAY.gone[id]; paintTodayIntake(); },
+    reloadIntake: function () { return loadTodayIntake(); },
+    refresh: function () { if (state.pane === 'today') loadToday(); }
+  };
+  window.COSWeb.sessionKit = {
+    // A session object for continueSession, with the overlay's own view (READER_VIEW's methods).
+    session: function (provider, id, view) {
+      return { provider: provider, id: id, draft: null, held: [], view: view, verdict: null, refusal: null, cautionAck: false, feed: newFeed(), live: null, queued: 0 };
+    },
+    send: function (r, text, opts) { return continueSession(r, text, opts || {}); },
+    newKey: newTurnKey,
+    probe: function (r) { return sxProbeAttach(r); },
+    path: sessionPath, answer: apiAnswer,
+    feed: { fresh: newFeed, apply: applyFeed, word: sxFeedWord, detail: sxFeedDetail, tool: sxToolLine, elapsed: sxElapsed, fallback: sxFallbackLine },
+    title: sxTitle, stateOf: sxState, stateLabel: function (s) { return sxStateLabel(s, sxState(s)); },
+    parkCopy: function (p) { return SX_PARK[sxProvider(p)]; }, providerLabel: sxProviderLabel, markdown: sxMd
+  };
 
   // Every pane module is a plain script after this one; boot waits for all of them.
   function boot() {