@gotcos/glasses-server 7.0.7 → 7.0.18

package/server/web-control/panes/cos-chat.js

@@ -29,9 +29,12 @@
    finishes, POST /api/cos-thread/turn once with its answer. "New thread" in the header posts /api/cos-thread/new.
    Without the capability, the old rule stands: one conversation per day, kept in this browser.
 
-   The rail badge on Messages is a number for `waiting` (GET /api/inbox/summary) and a dot for unread only. It is read
-   with the shell's existing status read (shell.js checkServer), never on a timer of its own, and painting it touches
-   only the badge, never the pane. */
+   The rail badge on Messages (7.0.9, Miles 11/08: "notifications would just be for net new messages") is a number for
+   `unread` only: what COS sent since the chat was last open on any device (the server keeps readAt, and the first
+   7.0.9 open marked everything older as read). A dot, with no number, says something in the chat waits on your reply
+   (`asked`). Work's Your move is not counted here: it has its own count on Today and in Work. It is read with the
+   shell's existing status read (shell.js checkServer), never on a timer of its own, and painting it touches only the
+   badge, never the pane. */
 (function () {
   'use strict';
   var W = window.COSWeb;
@@ -40,6 +43,8 @@
   var DRAFTS = 'cos.web.cosDrafts';
 
   var C = {
+    archive: null,          // 7.0.9: the older questions (GET /api/inbox/archive) once opened, newest first
+    archiveOpen: false,
     caps: null,             // null until /api/health is read: { dropIt, jobs, steer }
     capsLoading: null,
     summary: null,          // { unread, waiting, lastLine, lastAt }
@@ -114,7 +119,9 @@
       // reply box shows no clip, so a file can never be dropped from a turn in silence.
       turnFiles: h && Number.isInteger(h.threadTurnAttachments) && h.threadTurnAttachments > 0 ? Math.min(h.threadTurnAttachments, MAX_ATTS) : 0,
       // 6.99.27: any file for a session turn, up to this many bytes (threadTurnFileBytes). 0: the chat's list only.
-      turnFileBytes: h && Number.isInteger(h.threadTurnFileBytes) && h.threadTurnFileBytes > 0 ? Math.min(h.threadTurnFileBytes, MAX_DOC) : 0
+      turnFileBytes: h && Number.isInteger(h.threadTurnFileBytes) && h.threadTurnFileBytes > 0 ? Math.min(h.threadTurnFileBytes, MAX_DOC) : 0,
+      // 6.99.31: the Mac runs the phone key signer (webKeySigner 1, only with COS_WEB_KEY_AUTHORITY on). Absent: 0, nothing offered.
+      webKeySigner: h && h.webKeySigner === 1 ? 1 : 0
     };
     if (next.prep && next.prep.serverInstanceId) PREP_INST = next.prep.serverInstanceId;
     var changed = !C.caps || C.caps.dropIt !== next.dropIt || C.caps.jobs !== next.jobs || C.caps.thread !== next.thread;
@@ -133,7 +140,7 @@
       serverInstanceId: typeof p.serverInstanceId === 'string' ? p.serverInstanceId : '' };
   }
   // The shell's status read (shell.js checkServer) hands its /api/health answer here.
-  function fromHealth(h) { setCaps(h); }
+  function fromHealth(h) { setCaps(h); if (C.asks.some(relayPending)) loadRelayRows(15000); }
   function ensureCaps() {
     if (C.caps) return Promise.resolve(C.caps);
     if (!C.capsLoading) C.capsLoading = api('/api/health').then(function (h) { setCaps(h); return C.caps; }, function () { C.capsLoading = null; return null; });
@@ -149,10 +156,12 @@
       return null;
     });
   }
-  function waitingOf(s) { var n = s && Number(s.waiting); return Number.isInteger(n) && n > 0 ? n : 0; }
+  // `asked` is the chat's own part of `waiting` (7.0.9). An older server without it: the chat's part cannot be told
+  // apart from Work's, so nothing is claimed as waiting on a reply here.
+  function waitingOf(s) { var n = s && Number(s.asked); return Number.isInteger(n) && n > 0 ? n : 0; }
   function unreadOf(s) { var n = s && Number(s.unread); return Number.isInteger(n) && n > 0 ? n : 0; }
-  // A number for what waits on you, a dot for unread only. Created on first paint, so with Drop it off the rail's DOM
-  // is untouched.
+  // A number for what is new, a dot for a reply the chat waits on. Created on first paint, so with Drop it off the
+  // rail's DOM is untouched.
   function paintRail() {
     var waiting = waitingOf(C.summary), unread = unreadOf(C.summary);
     document.querySelectorAll('.rail-btn[data-pane="messages"], #section-menu [data-goto="messages"]').forEach(function (b) {
@@ -162,10 +171,10 @@
         var dot = document.createElement('span'); dot.className = 'inbox-dot hidden'; dot.setAttribute('data-inbox-dot', '');
         b.appendChild(count); b.appendChild(dot);
       }
-      count.textContent = waiting > 99 ? '99+' : String(waiting);
-      count.classList.toggle('hidden', !waiting);
-      b.querySelector('[data-inbox-dot]').classList.toggle('hidden', !(unread && !waiting));
-      var label = waiting ? waiting + ' waiting on you' : unread ? unread + ' new in COS' : '';
+      count.textContent = unread > 99 ? '99+' : String(unread);
+      count.classList.toggle('hidden', !unread);
+      b.querySelector('[data-inbox-dot]').classList.toggle('hidden', !(waiting && !unread));
+      var label = [unread ? unread + ' new in COS' : '', waiting ? waiting + ' waiting on your reply' : ''].filter(Boolean).join(', ');
       b.setAttribute('aria-label', 'Messages' + (label ? ', ' + label : ''));
     });
   }
@@ -179,7 +188,7 @@
   // ── the pinned row (first in Recent) ──────────────────
   function pinStatus() {
     var s = C.summary, w = waitingOf(s), u = unreadOf(s);
-    return [w ? w + ' waiting' : '', u ? u + ' new' : ''].filter(Boolean).join(' · ');
+    return [u ? u + ' new' : '', w ? w + ' waiting on your reply' : ''].filter(Boolean).join(' · ');
   }
   function pinnedRowHtml(selected) {
     var s = dropOn() ? C.summary : null;
@@ -345,7 +354,7 @@
         (threadOn() ? '<button type="button" class="link-btn" data-cos="new-thread">New thread</button>' : '') + '</div>' +
         (threadOn() ? '<p class="cc-thread" data-cos-thread role="status">' + esc(threadLine()) + '</p>' : '') + '</header>' +
       '<div class="cc-feed" data-cos-feed aria-live="polite"></div>' +
-      composerHtml(CHAT, { drop: drop, placeholder: drop ? 'Ask COS, or drop a thought, a task, a reminder' : 'Ask COS anything', label: 'Message to COS' }) +
+      composerHtml(CHAT, { drop: drop, placeholder: drop ? 'Ask COS or drop a thought' : 'Ask COS anything', label: 'Message to COS' }) +
       '</section>';
   }
   function mount(host, visible) {
@@ -393,12 +402,39 @@
     });
     C.items.sort(function (a, b) { return String(a.createdAt).localeCompare(String(b.createdAt)); });
   }
+  // ── older questions (7.0.9, Miles 11/08: "Expire after 7 days") ──
+  // What still asks for a reply but was asked 7 days ago or more stops counting as waiting (server rule
+  // WAITING_EXPIRY_DAYS, drop-service.ts) and shows here, closed until opened. Each still answers as in the chat, and
+  // answering it takes it off this list. The count and the days come from the server, so no rule is kept here.
+  function archivedOf(s) { var n = s && Number(s.archived); return Number.isInteger(n) && n > 0 ? n : 0; }
+  function archiveHtml() {
+    var n = C.archive ? C.archive.length : archivedOf(C.summary);
+    if (!n) return '';
+    var days = (C.summary && Number(C.summary.waitingExpiryDays)) || 7;
+    var body = !C.archiveOpen ? '' : C.archive === null ? '<p class="cc-fine">Reading older questions.</p>'
+      : C.archive.map(itemHtml).join('');
+    return '<details class="cc-archive" data-cos-archive' + (C.archiveOpen ? ' open' : '') + '><summary data-cos="archive">' +
+      n + (n === 1 ? ' older question' : ' older questions') + '</summary>' +
+      '<p class="cc-fine">Asked more than ' + days + ' days ago, so ' + (n === 1 ? 'it no longer counts' : 'they no longer count') + ' as waiting on you. You can still answer here.</p>' +
+      body + '</details>';
+  }
+  function loadArchive() {
+    return api('/api/inbox/archive').then(function (d) {
+      C.archive = (d && Array.isArray(d.items)) ? d.items : [];
+      paintFeed(false);
+    }, function () { if (C.archive === null) C.archive = []; paintFeed(false); });
+  }
+  function toggleArchive() {
+    C.archiveOpen = !C.archiveOpen;
+    if (C.archiveOpen) { C.archive = null; loadArchive(); }
+    else paintFeed(false);
+  }
   function markReadIfShown(force) {
     if (!dropOn() || !chatVisible() || !C.items || !C.items.length) return;
     if (!force && C.summary && !unreadOf(C.summary)) return;
     var last = C.items[C.items.length - 1];
     api('/api/inbox/read', { method: 'POST', body: { through: last.id } }).then(function (r) {
-      if (C.summary) { C.summary.unread = r.unread; if (typeof r.waiting === 'number') C.summary.waiting = r.waiting; }
+      if (C.summary) { C.summary.unread = r.unread; if (typeof r.waiting === 'number') C.summary.waiting = r.waiting; if (typeof r.asked === 'number') C.summary.asked = r.asked; }
       paintRail(); paintPin();
     }, function () {});
   }
@@ -482,10 +518,159 @@
   function askState(a) {
     return a.status === 'completed' ? 'Answered' : a.status === 'canceled' ? 'Canceled' : a.status === 'failed' || a.status === 'interrupted' ? 'Did not finish' : a.status === 'sending' ? 'Sending' : 'Answering';
   }
+  // ── what a running answer is doing, and where a relayed message went (7.0.9) ──
+  // Miles 11/08: "It's hard to see when a session is making progress, whereas when you're wearing it on the glasses, we
+  // can see the whole audit trail." The steps are the job's own trail (GET /api/query-jobs/:id?trail=1, the lens's
+  // data, redacted for secrets on the Mac at the journal), read by the poll this card already runs. While it runs: the
+  // newest few, newest last. Once it ends: a quiet "N steps" that opens.
+  var TERMINAL = { completed: 1, failed: 1, canceled: 1, interrupted: 1 };
+  function askRunning(a) { return !TERMINAL[a.status]; }
+  function hasText(a) { return !!(a.response || a.partial); }
+  var STEP_VERBS = { read: 'Read', edit: 'Edited', write: 'Edited', bash: 'Ran', search: 'Searched', task: 'Delegated', other: 'Used' };
+  var LIVE_STEPS = 6, DONE_STEPS = 40;
+  // A path on the Mac shows as its last part only. Paths are not secrets on the Mac, but the web never shows one.
+  var MAC_PATH = /(?:~|\/(?:Users|home|private|var|tmp|opt|Volumes|Library|System|Applications|etc))(?:\/[^\s'"`()<>\[\]{},;|]+)+\/?/g;
+  function scrubPaths(text) {
+    return String(text || '').replace(MAC_PATH, function (p) { var parts = p.replace(/\/+$/, '').split('/'); return parts[parts.length - 1] || 'a file'; });
+  }
+  function stepText(e) {
+    if (!e || typeof e !== 'object') return null;
+    if (e.kind === 'tool') {
+      var target = clip(scrubPaths(e.target), 90), detail = clip(scrubPaths(e.detail), 60);
+      if (target === 'SendMessage') return { kind: 'tool', text: 'Sent a message' + (detail ? ' ' + detail : '') };
+      var verb = STEP_VERBS[e.verb] || 'Used';
+      return { kind: 'tool', text: (target ? verb + ' ' + target : verb) + (detail ? ' (' + detail + ')' : '') };
+    }
+    if (e.kind === 'status' && (e.detail || e.needs_action)) return { kind: 'note', text: clip(scrubPaths(e.detail || e.needs_action), 140) };
+    if (e.kind === 'prose' && e.text) return { kind: 'prose', text: clip(scrubPaths(e.text), 160) };
+    return null;
+  }
+  function stepsOf(a) {
+    var out = [];
+    (a.trail || []).forEach(function (e) { var t = stepText(e); if (t && t.text) out.push(t); });
+    return out;
+  }
+  function stepLi(t) { return '<li class="cc-step ' + t.kind + '">' + esc(t.text) + '</li>'; }
+  function earlierLi(n) { return n > 0 ? '<li class="cc-step more">' + n + ' earlier ' + (n === 1 ? 'step' : 'steps') + '</li>' : ''; }
+  function stepsHtml(a) {
+    var steps = stepsOf(a);
+    if (!steps.length) return '';
+    if (askRunning(a)) {
+      var live = steps.slice(-LIVE_STEPS);
+      return '<ol class="cc-steps live" aria-label="What COS is doing">' + earlierLi(steps.length - live.length) + live.map(stepLi).join('') + '</ol>';
+    }
+    var kept = steps.slice(-DONE_STEPS);
+    return '<details class="cc-steps-done"' + (a.stepsOpen ? ' open' : '') + '><summary data-cos="steps" data-cid="' + esc(a.cid) + '">' +
+      steps.length + (steps.length === 1 ? ' step' : ' steps') + '</summary><ol class="cc-steps">' + earlierLi(steps.length - kept.length) + kept.map(stepLi).join('') + '</ol></details>';
+  }
+
+  // Issue 4 (Miles 11/08, Message #465 "Why aren't you responding to the other session?"): an answer that sent a message
+  // to another session (SendMessage in its trail) gets that session's reply in that session, never here. The card says
+  // where it went, opens that session, and shows its newest reply once the session has answered. Read from the session
+  // list the shell already keeps (W.sessionList, cached), refreshed by the live stream and the shell's status read.
+  function relaysOf(a) {
+    var out = [];
+    (a.trail || []).forEach(function (e) {
+      if (!e || e.kind !== 'tool' || String(e.target) !== 'SendMessage') return;
+      var m = /^to (.+)$/.exec(String(e.detail || '').trim());
+      var name = m && m[1] !== 'another session' && m[1] !== 'every session' ? m[1].trim() : '';
+      if (out.indexOf(name) < 0) out.push(name);
+    });
+    return out.slice(-2);
+  }
+  function rowTitle(r) { return String(r.display_label || r.custom_title || r.title || '').replace(/\s+/g, ' ').trim(); }
+  function relayRow(name) {
+    if (!name || !Array.isArray(C.sessionRows)) return null;
+    var want = name.toLowerCase(), sid = /^session ([0-9a-f]{8})$/i.exec(name);
+    for (var i = 0; i < C.sessionRows.length; i++) {
+      var r = C.sessionRows[i], id = String(r.session_id || r.id || '').replace(/^(claude|codex|cursor):/, '');
+      if (sid ? id.toLowerCase().indexOf(sid[1].toLowerCase()) === 0 : rowTitle(r).toLowerCase() === want || id.toLowerCase() === want) return r;
+    }
+    return null;
+  }
+  function msOf(v) { var d = W.toDate(v); return d ? d.getTime() : 0; }
+  // The session's newest reply, only once it came after this Ask started.
+  function relayReply(r, a) {
+    var text = r && String(r.last_reply || '').trim();
+    if (!text) return '';
+    var at = msOf(r.state_since) || msOf(r.last_activity_at);
+    return at && at > (a.at || 0) ? text : '';
+  }
+  function relayHtml(a) {
+    var names = relaysOf(a);
+    if (!names.length) return '';
+    return '<div class="cc-relays" data-ask-relay>' + names.map(function (name) {
+      var r = relayRow(name), title = r ? rowTitle(r) || name : name, reply = relayReply(r, a);
+      var id = r ? String(r.session_id || r.id || '').replace(/^(claude|codex|cursor):/, '') : '';
+      var where = title ? 'Sent to ' + title + '.' : 'Sent to another session.';
+      return '<div class="cc-relay"><p class="cc-relay-line">' + esc(where) + ' Its answer shows in that session, not here.</p>' +
+        (reply ? '<p class="cc-relay-reply"><span class="cc-relay-who">' + esc(title || 'The session') + ' replied</span>' + esc(clip(scrubPaths(reply), 400)) + '</p>' :
+          askRunning(a) ? '' : '<p class="cc-fine">Its reply shows here when it answers.</p>') +
+        '<div class="cc-acts">' + (r ? '<button type="button" class="cx-btn" data-cos="open-session" data-provider="' + esc(r.provider || 'claude') + '" data-sid="' + esc(id) + '">Open session</button>'
+          : '<button type="button" class="cx-btn quiet" data-cos="open-sessions">Open Sessions</button>') + '</div></div>';
+    }).join('') + '</div>';
+  }
+  function relayPending(a) {
+    if (!relaysOf(a).length || Date.now() - (a.at || 0) > 2 * 3600000) return false;
+    return relaysOf(a).some(function (n) { var r = relayRow(n); return !relayReply(r, a); });
+  }
+  var relayHooked = false;
+  function loadRelayRows(maxAgeMs) {
+    if (!W.sessionList) return;
+    W.sessionList(maxAgeMs).then(function (d) {
+      if (!d || !Array.isArray(d.sessions)) return;
+      C.sessionRows = d.sessions;
+      C.asks.forEach(function (x) { if (relaysOf(x).length) paintRelay(x); });
+    }, function () {});
+  }
+  // No loop of its own: the first read when a relay shows up, then the live stream's frames and the shell's status read.
+  function watchRelays(a) {
+    if (!relaysOf(a).length || a.relayWatched) return;
+    a.relayWatched = true;
+    loadRelayRows(15000);
+    if (!relayHooked && W.live && typeof W.live.on === 'function') {
+      relayHooked = true;
+      W.live.on(function () { if (C.asks.some(relayPending)) loadRelayRows(15000); });
+    }
+  }
+  function paintRelay(a) {
+    var el = document.querySelector('[data-ask="' + a.cid + '"]');
+    var box = el && el.querySelector('[data-ask-relay-slot]');
+    if (!box) return;
+    var html = relayHtml(a);
+    if (box.getAttribute('data-html') !== html) { box.innerHTML = html; box.setAttribute('data-html', html); }
+  }
+  // Issue 2 (Message #463 said "Answered" over "COS is answering"): a finished Ask with no words. The card used to read
+  // "no words yet" as "still answering". Now it reads the turn from Messages once (the answer may have reached Messages
+  // after this card's last read), and if Messages has no words either, says so, with its steps and where it sent things.
+  function emptyAnswerHtml(a) {
+    if (a.recovering) return '<span class="cc-wait">Reading the answer from Messages.</span>';
+    if (relaysOf(a).length) return '';
+    return '<span class="cc-wait">COS finished without a written answer.' + (stepsOf(a).length ? ' What it did is under steps.' : '') + '</span>';
+  }
+  function recoverAnswer(a) {
+    if (a.recovered || a.recovering) return Promise.resolve();
+    a.recovered = true;
+    if (!a.no) return Promise.resolve();
+    a.recovering = true;
+    paintAsk(a);
+    return api('/api/sessions/today/all-messages?limit=100').then(function (d) {
+      var list = (d && d.messages) || [];
+      for (var i = list.length - 1; i >= 0; i--) {
+        var t = list[i], no = t.no != null ? t.no : t.globalMsgNum;
+        if (Number(no) === Number(a.no) && (!a.sessionId || !t.sessionId || t.sessionId === a.sessionId)) {
+          if (typeof t.text === 'string' && t.text.trim()) a.response = t.text;
+          break;
+        }
+      }
+    }, function () {}).then(function () { a.recovering = false; paintAsk(a, true); });
+  }
   function askHtml(a, linked) {
     var running = a.status === 'sending' || a.status === 'queued' || a.status === 'running';
     var title = a.no ? 'Message #' + a.no : 'Asking COS';
     var body = answerHtml(a);
+    // "COS is answering" only while it is; a finished Ask with no words says so (issue 2).
+    if (!body) body = a.status === 'completed' ? emptyAnswerHtml(a) : askRunning(a) ? '<span class="cc-wait">COS is answering. It also lands in Messages on the glasses.</span>' : '';
     var acts = '';
     if (running && a.jobId) {
       acts = (C.caps && C.caps.steer && a.steerable !== false ? '<button type="button" class="link-btn cc-text-btn" data-cos="steer" data-cid="' + a.cid + '">Steer</button>' : '') +
@@ -501,7 +686,9 @@
     return (linked ? '' : '<div class="cc-line you"><div class="cc-bubble">' + esc(a.query) + '</div>' + sentAttsHtml(a.atts) + '<div class="cc-src">' + (a.replyKey ? 'Replied on the web' : 'Asked on the web') + '</div></div>') +
       '<div class="cc-line cos" data-ask="' + a.cid + '"><span class="cc-avatar">' + MARK + '</span><div class="cc-card">' +
       '<p class="cc-card-title"><span data-ask-title>' + esc(title) + '</span><span class="cx-time" data-ask-state>' + esc(askState(a)) + '</span></p>' +
-      '<div class="cc-answer md" data-ask-body>' + (body || '<span class="cc-wait">COS is answering. It also lands in Messages on the glasses.</span>') + '</div>' +
+      '<div class="cc-answer md" data-ask-body>' + body + '</div>' +
+      '<div class="cc-steps-slot" data-ask-steps>' + stepsHtml(a) + '</div>' +
+      '<div data-ask-relay-slot>' + relayHtml(a) + '</div>' +
       (a.error ? '<p class="cc-fine warn">' + esc(a.error) + '</p>' : '') +
       '<div class="cc-acts" data-ask-acts>' + acts + '</div>' +
       (a.steering ? '<form class="cc-steer" data-cos-steer="' + a.cid + '"><input class="field" type="text" maxlength="2000" placeholder="Steer the answer" aria-label="Steer the answer"><button type="submit" class="cx-btn">Send</button></form>' : '') +
@@ -516,10 +703,12 @@
     if (C.items === null && C.feedState !== 'error') html = W.skeletonRows(3);
     else if (C.feedState === 'error' && C.items === null) html = '<div class="cx-notice warn"><span>' + esc(C.feedError) + '</span></div><button type="button" class="cx-btn quiet" data-cos="retry">Try again</button>';
     else {
-      var rows = (C.items || []).map(function (it) { return { at: it.createdAt, html: itemHtml(it) }; });
+      // 7.0.9: a question asked 7 days ago or more (the server marks it `archived`) lives under older questions.
+      var rows = (C.items || []).filter(function (it) { return !it.archived; }).map(function (it) { return { at: it.createdAt, html: itemHtml(it) }; });
       C.asks.forEach(function (a) { if (!a.replyKey) rows.push({ at: new Date(a.at + (a.dropId ? 1 : 0)).toISOString(), html: askHtml(a, !!a.dropId) }); });
       rows.sort(function (a, b) { return String(a.at).localeCompare(String(b.at)); });
-      html = rows.length ? rows.map(function (r) { return r.html; }).join('')
+      var older = archiveHtml();
+      html = rows.length || older ? older + rows.map(function (r) { return r.html; }).join('')
         : dropOn() ? '<p class="cc-empty">Nothing here yet. Ask COS something, or drop a thought and COS files it.</p>'
           : '<p class="cc-empty">Ask COS anything. Attach photos or files with the clip.</p>';
     }
@@ -535,7 +724,8 @@
     else if (W.parseRoute().args[0] === 'cos') window.scrollTo(0, document.body.scrollHeight);
   }
   // A running Ask updates its own card in place, so a poll never rebuilds the chat (or the reader).
-  function paintAsk(a) {
+  // `inPlace`: repaint this card only, never the chat around it (a late answer from recoverAnswer).
+  function paintAsk(a, inPlace) {
     var el = document.querySelector('[data-ask="' + a.cid + '"]');
     if (!el) return a.replyKey ? paintReplyFeed(a.replyKey) : paintFeed(false);
     var running = a.status === 'sending' || a.status === 'queued' || a.status === 'running';
@@ -543,7 +733,12 @@
     var st = el.querySelector('[data-ask-state]'); if (st) st.textContent = askState(a);
     var body = el.querySelector('[data-ask-body]'); var text = a.response || a.partial;
     if (body && text && body.getAttribute('data-len') !== String(text.length) + (a.response ? 'r' : '')) { body.innerHTML = answerHtml(a); body.setAttribute('data-len', String(text.length) + (a.response ? 'r' : '')); }
-    if (!running) { if (a.replyKey) paintReplyFeed(a.replyKey); else paintFeed(false); }
+    // No words and no longer running: never leave "COS is answering" under a finished card (issue 2).
+    else if (body && !text && !askRunning(a)) { var none = a.status === 'completed' ? emptyAnswerHtml(a) : ''; if (body.getAttribute('data-none') !== none) { body.innerHTML = none; body.setAttribute('data-none', none); body.removeAttribute('data-len'); } }
+    var steps = el.querySelector('[data-ask-steps]');
+    if (steps) { var sig = (a.trail ? a.trail.length + ':' + (a.trail.length ? a.trail[a.trail.length - 1].trailSeq : 0) : '0') + (askRunning(a) ? 'r' : 'd'); if (steps.getAttribute('data-sig') !== sig) { steps.innerHTML = stepsHtml(a); steps.setAttribute('data-sig', sig); } }
+    paintRelay(a);
+    if (!running && !inPlace) { if (a.replyKey) paintReplyFeed(a.replyKey); else paintFeed(false); }
   }
 
   function uploadsPending(k) { return k.atts.some(function (t) { return t.state === 'reading' || t.state === 'uploading'; }); }
@@ -1067,7 +1262,7 @@
     opts = opts || {};
     var a = { cid: uuid(), query: text, at: Date.now(), status: 'sending', partial: '', dropId: dropId || '', atts: opts.atts || [], replyKey: opts.replyKey || '' };
     // 7.0.2 (A6): what Ask again sends: the same words, files and conversation.
-    a.again = { attachmentIds: (opts.attachmentIds || []).slice(0, MAX_ATTS), atts: (opts.atts || []).slice(0, MAX_ATTS), sessionId: opts.sessionId || '', replyKey: opts.replyKey || '', context: opts.context || '' };
+    a.again = { attachmentIds: (opts.attachmentIds || []).slice(0, MAX_ATTS), atts: (opts.atts || []).slice(0, MAX_ATTS), sessionId: opts.sessionId || '', replyKey: opts.replyKey || '', context: opts.context || '', contextRef: opts.contextRef || '' };
     C.asks.push(a);
     if (a.replyKey) paintReplyFeed(a.replyKey); else paintFeed(true);
     var body = { clientJobId: a.cid, generation: 1, query: text, source: 'web', activityToolMode: 'status' };
@@ -1104,7 +1299,7 @@
       // after the plan, immediately before admission (root review, 7.0.2: the thread can change between askAgain's check
       // and this send's own thread read, and a retry carries old files and context).
       if (opts.expect && !sameConversation(opts.expect, a)) throw Object.assign(new Error(MOVED_ON), { code: 'conversation_moved' });
-      withContext(body, opts.context);
+      withContext(body, opts.context, opts.contextRef);
     });
     prepare.then(function () { return admit(true); }).then(function (d) {
       var job = d && d.job; if (!job) throw new Error('The Mac did not take the question.');
@@ -1138,12 +1333,63 @@
   }
   // An Ask from Today carries what Today shows (app.js askCos, panes/today-actions.js summary) as the quoted reference,
   // after a carried thread summary when there is one. Bounded, and only on the Ask it was given to.
+  // Today round 2: "Ask about this" names its own reference (ABOUT_REF).
   var TODAY_REF = 'What Today in COS Control shows right now', CONTEXT_MAX = 6000;
-  function withContext(body, context) {
+  function withContext(body, context, ref) {
     var text = typeof context === 'string' ? context.trim().slice(0, CONTEXT_MAX) : '';
     if (!text) return;
-    if (body.reference) body.reference = { query: body.reference.query + ', then ' + TODAY_REF.charAt(0).toLowerCase() + TODAY_REF.slice(1), response: body.reference.response + '\n\n' + text };
-    else body.reference = { query: TODAY_REF, response: text };
+    var name = typeof ref === 'string' && ref ? ref : TODAY_REF;
+    if (body.reference) body.reference = { query: body.reference.query + ', then ' + name.charAt(0).toLowerCase() + name.slice(1), response: body.reference.response + '\n\n' + text };
+    else body.reference = { query: name, response: text };
+  }
+
+  // ── Ask about this (Today round 2, Miles 11/09) ───────
+  // Today's box under the model summary (app.js sendTodayAsk) asks here. The typed words are the question; the summary,
+  // when it was written and the sessions it read go as the Ask's reference, which the server quotes as untrusted data
+  // (lib/prompt-reference-boundary.ts), so nothing in them can act as an instruction. Each session is named by the title
+  // its Sessions row shows, so COS can pass an instruction to it with its own relay (SendMessage to that title; the
+  // answer card then says "Sent to <title>", relayHtml). Never transcript text: only the last message into each session,
+  // as the summary already read it. The same lines as desktop Control 0.5.384's ```today-context block.
+  var ABOUT_REF = 'The Today summary and the sessions it read', ABOUT_ROWS = 12;
+  function aboutClock(v) { var d = W.toDate(v); return d ? W.clock(d) : ''; }
+  function aboutAgo(v) {
+    var d = W.toDate(v); if (!d) return '';
+    var m = Math.max(0, Math.round((Date.now() - d.getTime()) / 60000));
+    if (m < 1) return 'just now';
+    if (m < 60) return m + ' min ago';
+    var h = Math.floor(m / 60);
+    return h < 48 ? h + ' h ago' : Math.round(h / 24) + ' days ago';
+  }
+  // A fence cannot be closed from inside: three backticks become three single quotes; one line per field.
+  function aboutText(v, n) { return clip(String(v == null ? '' : v).replace(/```/g, "'''"), n); }
+  function aboutContextText(ctx) {
+    if (!ctx || typeof ctx !== 'object') return '';
+    var summary = aboutText(ctx.summary, 1200);
+    var rows = Array.isArray(ctx.sessions) ? ctx.sessions.filter(function (r) { return r && r.title; }) : [];
+    if (!summary && !rows.length) return '';
+    var when = aboutClock(ctx.at);
+    var lines = [];
+    if (summary) lines.push('Today summary' + (when ? ', written ' + when : '') + ':', summary, '');
+    lines.push('Sessions Today read (' + rows.length + '):');
+    rows.slice(0, ABOUT_ROWS).forEach(function (r) {
+      var moved = aboutAgo(r.movedAt);
+      lines.push('- ' + [aboutText(r.title, 120), aboutText(r.provider || 'claude', 12), aboutText(r.state, 12)].join(' | ') +
+        (moved ? ' | last activity ' + moved : '') + (r.lastAsk ? ' | last ask: "' + aboutText(r.lastAsk, 160).replace(/"/g, "'") + '"' : ''));
+    });
+    if (rows.length > ABOUT_ROWS) lines.push('and ' + (rows.length - ABOUT_ROWS) + ' more');
+    return lines.join('\n').slice(0, CONTEXT_MAX);
+  }
+  function askAbout(text, ctx) {
+    return ensureCaps().then(function (caps) {
+      if (!caps || !caps.jobs) { var off = new Error('Ask needs the durable query jobs switch on your Mac.'); off.code = 'durable_query_jobs_disabled'; throw off; }
+      var q = String(text || '').trim();
+      if (!q) throw new Error('Type what to ask first.');
+      var body = aboutContextText(ctx);
+      return new Promise(function (resolve, reject) {
+        submitAsk(q, null, function (ok) { if (ok) resolve(['cos']); else reject(new Error('Not sent. Your words are still in the box on Today.')); },
+          body ? { context: body, contextRef: ABOUT_REF } : undefined);
+      });
+    });
   }
   function take(a, job) {
     a.jobId = job.jobId; a.status = job.status || a.status;
@@ -1151,6 +1397,8 @@
     if (job.sessionId) a.sessionId = job.sessionId;
     if (typeof job.partialText === 'string') a.partial = job.partialText;
     if (typeof job.response === 'string') a.response = job.response;
+    // 7.0.9: the steps, as the lens reads them (bounded on the Mac to 200 entries and 32,000 characters).
+    if (Array.isArray(job.trail)) { a.trail = job.trail; watchRelays(a); }
     if (job.steerable === false) a.steerable = false;
     if (job.error && (a.status === 'failed' || a.status === 'interrupted')) a.error = errorLine(job);
   }
@@ -1241,6 +1489,7 @@
       if (g.attachmentIds && g.attachmentIds.length) { o.attachmentIds = g.attachmentIds.slice(0, MAX_ATTS); o.atts = (g.atts || []).slice(0, MAX_ATTS); }
       if (g.replyKey) { o.replyKey = g.replyKey; o.sessionId = g.sessionId; }
       if (g.context) o.context = g.context;
+      if (g.contextRef) o.contextRef = g.contextRef;
       o.reask = true;
       if (a.conv) { o.expect = a.conv; o.retryOf = a; }
       return submitAsk(a.query, null, null, o);
@@ -1250,7 +1499,7 @@
     var started = Date.now();
     var tick = function () {
       if (!a.jobId) return;
-      api('/api/query-jobs/' + a.jobId + '?generation=1').then(function (d) {
+      api('/api/query-jobs/' + a.jobId + '?generation=1&trail=1').then(function (d) {
         if (d && d.job) take(a, d.job);
         paintAsk(a);
         if (['completed', 'failed', 'canceled', 'interrupted'].indexOf(a.status) >= 0) return finished(a);
@@ -1260,6 +1509,7 @@
     setTimeout(tick, 600);
   }
   function finished(a) {
+    if (a.status === 'completed' && !hasText(a)) recoverAnswer(a);
     postTurn(a);
     refreshDefault();
     if (a.replyKey) paintReplyFeed(a.replyKey); else paintFeed(false);
@@ -1322,6 +1572,9 @@
   // ── actions on a line ─────────────────────────────────
   function act(itemId, action) {
     var item = (C.items || []).filter(function (i) { return i.id === itemId; })[0];
+    // 7.0.9: an older question answers from its list exactly as from the chat.
+    var fromArchive = !item || !!item.archived;
+    if (!item) item = (C.archive || []).filter(function (i) { return i.id === itemId; })[0];
     if (!item) return;
     if (action === 'move') { C.moving = C.moving === itemId ? '' : itemId; return paintFeed(false); }
     if (action === 'open_card') return W.go('work');
@@ -1350,6 +1603,8 @@
       // A reminder action answers the finished item itself (merged above); dismiss answers counts only.
       if (action === 'dismiss') item.state = 'done';
       if (ans && ans.next && ans.next.kind === 'ask' && C.caps && C.caps.jobs) submitAsk(ans.next.prompt, ans.drop.id, null, askFilesOf(ans.next));
+      // Answered: it is no longer an older question, wherever it was.
+      if (fromArchive) { delete item.archived; (C.items || []).forEach(function (i) { if (i.id === itemId) delete i.archived; }); if (C.archive) C.archive = C.archive.filter(function (i) { return i.id !== itemId; }); if (C.archiveOpen) loadArchive(); }
       paintFeed(false); refreshSummary();
     }, function (err) { W.toast((err && err.message) || 'That did not go through.'); });
   }
@@ -1512,14 +1767,17 @@
     var act = ((item && item.actions) || []).filter(function (a) { return a && a.id === 'prep'; })[0] || {};
     var info = (act.prep && typeof act.prep === 'object' ? act.prep : item.prep && typeof item.prep === 'object' ? item.prep : {}) || {};
     var key = 'item:' + item.id;
-    if (P && P.key === key) { paintPrep(); focusPrep(); return; }
+    // Resolves to this composer once its draft is read (or the read failed, its note set): Today's Start prep waits on it.
+    if (P && P.key === key) { var same = P; paintPrep(); focusPrep(); return (same.loaded || Promise.resolve()).then(function () { return same; }); }
     if (P) closePrep();
     P = { key: key, title: clip(info.title || item.title || 'my next meeting', 200), startsAt: typeof info.startsAt === 'string' ? info.startsAt : null,
       draft: null, steer: '', dirty: false, ups: [], note: '', warn: false, running: false, pending: null, chain: Promise.resolve(), timer: null, conflicts: 0, loading: true };
     paintPrep(true); focusPrep();
     // On a phone the page scrolls: bring the composer up to where the card was tapped.
     var slot = prepSlot(false); if (slot && slot.scrollIntoView && !wide()) slot.scrollIntoView({ block: 'start' });
-    loadPrep(P);
+    var p = P;
+    p.loaded = loadPrep(p);
+    return p.loaded.then(function () { return p; });
   }
   function closePrep() {
     if (!P) return;
@@ -1615,9 +1873,9 @@
 
   // Files: the composer's own upload (uploadMedia), then POST .../files with the draft's revision.
   function addPrepFiles(list) {
-    var p = P; if (!p) return;
+    var p = P; if (!p) return 0;
     var files = Array.prototype.slice.call(list || []), refusals = [];
-    if (!p.draft) { setPrepNote(p, 'This prep is still opening. Add the files again in a moment.', true); return; }
+    if (!p.draft) { setPrepNote(p, 'This prep is still opening. Add the files again in a moment.', true); return files.length; }
     files.forEach(function (file) {
       if (prepFiles(p.draft).length + p.ups.length >= prepMax()) { refusals.push('A prep holds ' + prepMax() + ' files. ' + (file.name || 'A file') + ' was not added.'); return; }
       var c = classify(file);
@@ -1629,6 +1887,7 @@
     });
     setPrepNote(p, refusals.join(' '), !!refusals.length);
     paintPrep();
+    return refusals.length;
   }
   function sendPrepFile(p, t) {
     t.state = t.mediaId ? 'adding' : 'reading'; t.progress = 0; t.error = '';
@@ -1654,7 +1913,7 @@
       });
     }).then(function (r) {
       if (!r || p.ups.indexOf(t) < 0) return;
-      if (r.status >= 200 && r.status < 300) { p.ups = p.ups.filter(function (x) { return x !== t; }); paintPrep(); return; }
+      if (r.status >= 200 && r.status < 300) { p.ups = p.ups.filter(function (x) { return x !== t; }); paintPrep(); return prepUploadsSettled(p); }
       // Refused (a 4xx), so nothing was recorded: Retry is a new operation. No answer or a 5xx: Retry is the same one.
       if (r.status >= 400 && r.status < 500) t.opId = '';
       // The staged copy is gone or differs: Retry uploads the bytes again.
@@ -1663,11 +1922,13 @@
       t.state = 'failed';
       t.error = r.mismatch ? 'Not added: the Mac\u2019s COS server changed. Retry.' : r.status === 409 && code === 'revision_conflict' ? 'Not added: the prep changed. Retry.' : prepErrorText(r);
       paintPrep();
+      prepUploadsSettled(p);
     }).catch(function (err) {
       if (p.ups.indexOf(t) < 0 || (err && err.code === 'aborted')) return;
       t.state = 'failed';
       t.error = err && err.code === 'kept' ? err.message : err && err.status === 401 ? 'Signed out. Sign in, then retry.' : uploadErrorText(err);
       paintPrep();
+      prepUploadsSettled(p);
     });
   }
   function removePrepFile(p, fileId) {
@@ -1695,6 +1956,31 @@
       return postRun(p, p.pending, true);
     }).then(function (r) { return settleRun(p, r, true); });
   }
+  // Today's Start prep (prepStart): the run waits until every file it added is in the draft. A file that did not upload
+  // stops it, with one line saying so, so a prep never runs without a file the person chose for it.
+  var PREP_FILE_HELD = 'A file did not upload, so this prep has not started. Retry or remove it, then tap Prep me.';
+  function prepUploadsSettled(p) {
+    if (!p || !p.autoRun || P !== p || prepUploading(p)) return;
+    p.autoRun = false;
+    if (p.ups.length) { setPrepNote(p, PREP_FILE_HELD, true); return paintPrep(); }
+    runPrep(p);
+  }
+  // The context typed on Today joins the draft's notes: kept as they are when they already hold it, else added after them.
+  function mergeSteer(old, add) {
+    var a = String(add || '').trim(), o = String(old || '');
+    if (!a) return o;
+    if (!o.trim()) return a.slice(0, prepChars());
+    if (o.indexOf(a) >= 0) return o;
+    return (o.replace(/\s+$/, '') + '\n\n' + a).slice(0, prepChars());
+  }
+  // Prep off on the Mac, Ask on: "Prep me for <title> at <time>", the context typed on Today as the Ask's quoted
+  // reference (data, never instructions; ``` cannot close the fence), as askAbout sends the Today summary.
+  var PREP_ASK_REF = 'Context added for this prep on Today';
+  function prepAskContext(title, when, steer) {
+    var text = aboutText(steer, 2000);
+    if (!text) return '';
+    return ['Meeting: ' + aboutText(title, 200), when ? 'Starts: ' + when : '', 'Added context: ' + text].filter(Boolean).join('\n');
+  }
   function runBody(p, run) {
     var body = { clientRequestId: run.rid, revision: p.draft.revision };
     if (run.model) body.model = run.model;
@@ -1951,6 +2237,7 @@
       if (up.xhr) { try { up.xhr.abort(); } catch (_e) {} }
       p.ups = p.ups.filter(function (x) { return x !== up; });
       paintPrep();
+      prepUploadsSettled(p);
     }
   }
   function onPrepDrag(e, slot) {
@@ -1976,6 +2263,10 @@
     if (what === 'move-to') return moveTo(t.getAttribute('data-item'), t.getAttribute('data-dest'), t.getAttribute('data-domain'));
     if (what === 'move-cancel') { C.moving = ''; return paintFeed(false); }
     if (what === 'open-msg') return W.go('messages', ['m', t.getAttribute('data-no')]);
+    if (what === 'open-session') return W.go('sessions', [t.getAttribute('data-provider') || 'claude', t.getAttribute('data-sid')]);
+    if (what === 'open-sessions') return W.go('sessions');
+    if (what === 'archive') return toggleArchive();
+    if (what === 'steps') { var sa = C.asks.filter(function (x) { return x.cid === t.getAttribute('data-cid'); })[0]; if (sa) sa.stepsOpen = !sa.stepsOpen; return; }
     if (what === 'steer') {
       var a = C.asks.filter(function (x) { return x.cid === t.getAttribute('data-cid'); })[0];
       if (a) { a.steering = !a.steering; if (a.replyKey) paintReplyFeed(a.replyKey); else paintFeed(false); var f = document.querySelector('[data-cos-steer="' + a.cid + '"] input'); if (f) f.focus(); }
@@ -2143,6 +2434,8 @@
     on: on, dropOn: dropOn, askOn: askOn, known: function () { return !!C.caps; }, ensureCaps: ensureCaps, fromHealth: fromHealth, refreshSummary: refreshSummary,
     pinnedRowHtml: pinnedRowHtml, mount: mount, wide: wide,
     replyHtml: replyHtml, mountReply: mountReply, askFromSheet: askFromSheet,
+    // Today round 2: "Ask about this" under the Today summary (app.js sendTodayAsk).
+    askAbout: askAbout, aboutContextText: aboutContextText,
     onClick: onClick, onKey: onKey, onInput: onInput, onChange: onChangeEvent, onSubmit: onSubmit, onPaste: onPaste, onDrag: onDrag,
     setOnChange: function (fn) { C.onChange = fn; }, setOnAnswered: function (fn) { C.onAnswered = fn; },
     // Test and render hooks: what the chat holds right now.
@@ -2173,6 +2466,8 @@
       // How many files a session turn takes on this Mac (threadTurnAttachments); 0 means words only.
       turnFiles: function () { return C.caps && C.caps.turnFiles > 0 ? C.caps.turnFiles : 0; },
       turnFileBytes: function () { return C.caps && C.caps.turnFiles > 0 && C.caps.turnFileBytes > 0 ? C.caps.turnFileBytes : 0; },
+      // 6.99.31: 1 when the Mac offers "Approve on this phone" (the 3144 signer), else 0.
+      webKeySigner: function () { return C.caps && C.caps.webKeySigner === 1 ? 1 : 0; },
       askOn: askOn, ensureCaps: ensureCaps
     },
     // 6.99.19: Prep. meetings.js reads the capability from here (one /api/health read for the page).
@@ -2189,11 +2484,48 @@
         return '';
       });
     },
+    // Prep on every Next up row (Miles 11/09): Start prep under a row of Today. With Prep on the Mac, the Prep composer
+    // opens for that meeting (the same draft prepFor opens), the typed context joins its notes, the files go up through
+    // the composer's own path (addPrepFiles), and Prep me runs once they are in. Without Prep, the plain Ask "Prep me for
+    // <title> at <time>" with the context as its quoted reference. Resolves to 'prep', 'ask' or '' (neither is on).
+    prepStart: function (title, startsAt, extra) {
+      var steer = String((extra && extra.steer) || '').trim(), files = (extra && extra.files) || [];
+      return ensureCaps().then(function () {
+        var t = String(title || '').trim() || 'my next meeting';
+        if (prepOn()) {
+          var item = { id: 'today-next:' + (startsAt || '') + ':' + t, title: t, prep: { title: t, startsAt: startsAt || null } };
+          return openPrep(item).then(function (p) {
+            if (!p || P !== p || !p.draft) return 'prep';
+            var merged = mergeSteer(p.steer, steer);
+            if (merged !== p.steer) {
+              p.steer = merged; p.dirty = true;
+              var box = prepBox(); if (box && box.value !== p.steer) { box.value = p.steer; W.autoGrow(box); }
+              paintPrepParts(p);
+            }
+            if (files.length && addPrepFiles(files) > 0) return 'prep';
+            p.autoRun = true;
+            prepUploadsSettled(p);
+            return 'prep';
+          });
+        }
+        if (C.caps && C.caps.jobs) {
+          var d = startsAt ? W.toDate(startsAt) : null, when = d ? W.clock(d) : '';
+          var context = prepAskContext(t, when, steer);
+          return new Promise(function (resolve, reject) {
+            submitAsk('Prep me for ' + t + (when ? ' at ' + when : ''), null, function (ok) { if (ok) resolve('ask'); else reject(new Error('Prep did not start. Your context is still under the meeting on Today.')); },
+              context ? { context: context, contextRef: PREP_ASK_REF } : undefined);
+          });
+        }
+        return '';
+      });
+    },
+    // The file types the Prep composer takes (Today's Add files uses the same list).
+    prepAccept: PREP_ACCEPT,
     // The Prep server id to name on a write: the newest from capabilities.prep or any Prep answer (meetings.js reports its own).
     prepInstance: function () { return PREP_INST; }, notePrepInstance: function (id) { if (typeof id === 'string' && id) PREP_INST = id; },
     _prep: function () { return P; }, _openPrep: openPrep, _prepHtml: function () { return P ? prepPanelHtml(P) : ''; }, _addPrepFiles: addPrepFiles,
     _runPrep: function () { runPrep(P); }, _sha256Js: sha256Js, _closePrep: closePrep, _onPrepInput: onPrepInput, _savePrepSteer: function () { return P ? savePrepSteer(P) : null; },
-    _errorLine: errorLine, _askAgain: askAgain, _askHtml: askHtml, _settle: settleAfterKeyboard, _dockWide: dockWide, _revealComposer: revealComposer, _markKeyboard: markKeyboard, _refreshDefault: refreshDefault, _defaultLabel: defaultLabel, _modelMenuHtml: modelMenuHtml,
+    _errorLine: errorLine, _askAgain: askAgain, _askHtml: askHtml, _paintFeed: paintFeed, _paintAsk: paintAsk, _poll: poll, _finished: finished, _stepsHtml: stepsHtml, _relayHtml: relayHtml, _scrubPaths: scrubPaths, _settle: settleAfterKeyboard, _dockWide: dockWide, _revealComposer: revealComposer, _markKeyboard: markKeyboard, _refreshDefault: refreshDefault, _defaultLabel: defaultLabel, _modelMenuHtml: modelMenuHtml,
     _state: C, _composer: composer, _classify: classify, _modelsFrom: modelsFrom, _addFiles: addFiles, _itemHtml: itemHtml, _setCaps: setCaps, _threadLine: threadLine, _postTurn: postTurn
   };
 })();