@gotcos/glasses-server 6.99.33 → 7.0.7

package/server/web-control/panes/preview.js

@@ -0,0 +1,318 @@
+/* The preview engine's web viewer (phase 1, PLAN_preview_engine_2026-11-08 4d). Link cards where a reply links a local
+ * file, and one viewer for what a card or a sent file opens: Markdown rendered with the reply renderer, text and code
+ * with line numbers and jump-to-line, CSV and TSV as a table, HTML with scripts off (a per-open "Run scripts" runs them
+ * in an opaque origin with no network), a PDF inline on a desktop and in a new tab on a phone, pictures through the
+ * normalizer. Only opaque ids reach the server (GET /api/preview/...); a Mac path never reaches this page.
+ * The viewer shell (history, Back, focus, scroll restore, the 2-request budget) is panes/reader-media.js. */
+(function () {
+  'use strict';
+  var W = window.COSWeb;
+  if (!W) return;
+  var LINK_ID = /^al_[a-f0-9]{64}$/, FILE_ID = /^af_[a-f0-9]{64}$/;
+  var KINDS = ['image', 'pdf', 'html', 'markdown', 'text', 'code', 'table', 'document', 'slides', 'sheet', 'audio', 'video', 'archive', 'folder', 'file'];
+  var OFF = 'Not available on this Mac';
+  var REASONS = { outside_workspace: OFF, missing: OFF, secret_file: 'Not shown: this file may hold secrets.', unavailable: 'Not available right now. Reopen the session to check again.' };
+  var NORMALIZED = /\.(png|jpe?g|webp|hei[cf]|avif)$/i;
+  var THUMBS = { pdf: 1, document: 1, slides: 1, sheet: 1 };
+  var style = document.createElement('style');
+  style.textContent = '.pv-chip{display:inline-flex;align-items:center;gap:8px;vertical-align:middle;max-width:100%;min-height:44px;margin:2px 0;padding:4px 10px 4px 4px;border:1px solid var(--panel-border);border-radius:10px;background:var(--panel);color:var(--ink);font:inherit;text-align:left;cursor:pointer;box-sizing:border-box}' +
+    'button.pv-chip:hover{border-color:var(--sub)}button.pv-chip:focus-visible{outline:2px solid var(--accent,currentColor);outline-offset:2px}' +
+    '.pv-badge{flex:none;display:inline-flex;align-items:center;justify-content:center;min-width:34px;height:34px;padding:0 4px;border-radius:7px;background:var(--bg);border:1px solid var(--panel-border);font:600 10.5px/1 var(--body);letter-spacing:.04em;color:var(--sub);box-sizing:border-box}' +
+    '.pv-chip-text{display:inline-flex;flex-direction:column;min-width:0;line-height:1.25}.pv-chip-label{font:500 14px/1.3 var(--body);overflow-wrap:anywhere}.pv-chip-meta{font:12px/1.3 var(--body);color:var(--sub);overflow-wrap:anywhere}' +
+    '.pv-chip.off{cursor:default;opacity:.8;border-style:dashed}.pv-chip.off .pv-chip-meta{color:var(--sub)}.pv-chip.blocked .pv-badge{color:var(--amber,var(--sub))}' +
+    '.pv-chip.has-thumb{padding:4px 12px 4px 4px}.pv-thumb{flex:none;display:inline-flex;align-items:center;justify-content:center;width:48px;height:62px;overflow:hidden;border-radius:6px;background:#fff;border:1px solid var(--panel-border);font:600 10.5px/1 var(--body);color:#6e675d}.pv-thumb img{width:100%;height:100%;object-fit:contain;display:block}' +
+    // The viewer sits on a dark overlay (reader-media.js .rm-view), so everything drawn on a panel names its own ink:
+    // inherited, it was the overlay's white on a light panel (7.0.5 render: Markdown, code and the line field were blank).
+    '.pv-scroll{flex:1;min-height:0;width:100%;overflow:auto;border:1px solid var(--panel-border);border-radius:10px;background:var(--panel);color:var(--ink)}' +
+    '.pv-md{padding:12px 16px;max-width:none}.pv-code{font:12.5px/1.55 ui-monospace,SFMono-Regular,Menlo,monospace;padding:6px 0;min-width:max-content}.pv-line{display:flex;scroll-margin:40px 0}.pv-line.hit{background:var(--gold-bg,rgba(185,138,62,.14))}' +
+    '.pv-n{flex:none;width:4.2em;padding-right:12px;text-align:right;color:var(--sub);user-select:none;-webkit-user-select:none}.pv-t{white-space:pre;padding-right:16px}' +
+    '.pv-bar{display:flex;flex-wrap:wrap;gap:8px;align-items:center;width:100%}.pv-bar .rm-status{flex:1;min-width:12em}.pv-jump{display:flex;gap:6px;align-items:center}.pv-jump input{width:6.5em;min-height:44px;padding:0 10px;border:1px solid var(--panel-border);border-radius:10px;background:var(--panel);color:var(--ink);font:16px var(--body);box-sizing:border-box}' +
+    // A table is as wide as its columns need (a cell wraps by words past 22em, never mid-word), and scrolls sideways
+    // inside its own box on a phone; the page itself never does (7.0.5 render: 458 px crushed "industry" to "ind ustr y").
+    '.pv-table{border-collapse:collapse;font:13px/1.4 var(--body);width:max-content;min-width:100%}.pv-table th,.pv-table td{padding:6px 10px;border-bottom:1px solid var(--panel-border);text-align:left;vertical-align:top;max-width:22em;overflow-wrap:break-word}.pv-table thead th{position:sticky;top:0;background:var(--panel);z-index:1;font-weight:600}.pv-table td.pv-rn,.pv-table th.pv-rn{color:var(--sub);text-align:right;width:1%;white-space:nowrap}' +
+    '.pv-frame{flex:1;min-height:0;width:100%;border:1px solid var(--panel-border);border-radius:10px;background:#fff}.pv-other{display:flex;flex-direction:column;align-items:center;gap:12px;text-align:center}.pv-other .pv-thumb{width:160px;height:206px}' +
+    '.rm-view-body.pv-body{align-items:stretch;justify-content:flex-start}';
+  document.head.appendChild(style);
+
+  function element(tag, cls, text) { var el = document.createElement(tag); if (cls) el.className = cls; if (text != null) el.textContent = text; return el; }
+  function button(text, action, cls) { var b = element('button', cls || 'cx-btn quiet', text); b.type = 'button'; b.addEventListener('click', action); return b; }
+  function kindOf(name) {
+    var n = String(name || '');
+    var map = [[NORMALIZED, 'image'], [/\.gif$/i, 'image'], [/\.pdf$/i, 'pdf'], [/\.html?$/i, 'html'], [/\.(md|markdown|mdx)$/i, 'markdown'],
+      [/\.(csv|tsv)$/i, 'table'], [/\.(txt|log|text)$/i, 'text'],
+      [/\.(json|jsonl|ya?ml|toml|xml|svg|tsx?|mts|cts|jsx?|mjs|cjs|py|swift|sh|zsh|bash|s?css|rb|go|rs|java|kt|c|h|cc|cpp|hpp|m|mm|sql|lua|php|plist|ini|conf|cfg|properties)$/i, 'code'],
+      [/\.(docx?|pages|rtf)$/i, 'document'], [/\.(xlsx?|numbers)$/i, 'sheet'], [/\.(pptx?|key)$/i, 'slides'],
+      [/\.(wav|mp3|m4a|aac|flac|aiff?)$/i, 'audio'], [/\.(mp4|mov|webm|m4v)$/i, 'video'], [/\.(zip|tar|gz|tgz|bz2|xz|7z|ehpk)$/i, 'archive']];
+    for (var i = 0; i < map.length; i++) if (map[i][0].test(n)) return map[i][1];
+    return 'file';
+  }
+  // The checked DTO. Anything else from the server is ignored; a card never trusts a field it did not expect.
+  function clean(dto) {
+    if (!dto || (!LINK_ID.test(dto.id || '') && !FILE_ID.test(dto.id || '')) || ['available', 'unavailable'].indexOf(dto.state) < 0) return null;
+    var name = String(dto.name || 'File').slice(0, 120);
+    return {
+      id: dto.id, name: name, label: String(dto.label || name).slice(0, 120),
+      kind: KINDS.indexOf(dto.kind) >= 0 ? dto.kind : kindOf(name), type: String(dto.type || 'File').slice(0, 40),
+      size: typeof dto.size === 'number' && dto.size >= 0 ? dto.size : null,
+      line: Math.max(0, Math.min(9999999, Math.floor(Number(dto.line)) || 0)) || null,
+      state: dto.state, reason: REASONS[dto.reason] ? dto.reason : (dto.state === 'available' ? null : 'unavailable')
+    };
+  }
+  function parts(f) {
+    if (f.kind === 'folder' || f.state !== 'available') return [];
+    var p = ['raw'];
+    if (f.kind === 'pdf' || (f.kind === 'image' && NORMALIZED.test(f.name))) p.push('inline');
+    if (['markdown', 'text', 'code', 'html', 'table'].indexOf(f.kind) >= 0) p.push('text');
+    if (f.kind === 'table') p.push('table');
+    if (f.kind === 'html') p.push('html', 'html-run');
+    if (THUMBS[f.kind] || f.kind === 'html' || (f.kind === 'image' && NORMALIZED.test(f.name))) p.push('thumb');
+    return p;
+  }
+  function url(scope, id, part, q) {
+    return '/api/preview/agent-sessions/' + encodeURIComponent(scope.provider) + '/' + encodeURIComponent(scope.id) + '/' + encodeURIComponent(id) + '/content?part=' + part + (q || '');
+  }
+  function bytesWords(n) {
+    if (typeof n !== 'number' || !(n >= 0)) return '';
+    if (n < 1024) return n + ' B';
+    if (n < 1024 * 1024) return Math.max(1, Math.round(n / 1024)) + ' KB';
+    return (n / 1024 / 1024).toFixed(n < 10 * 1024 * 1024 ? 1 : 0) + ' MB';
+  }
+  function badge(f) {
+    if (f.kind === 'folder') return 'DIR';
+    if (f.kind === 'markdown') return 'MD';
+    var ext = /\.([a-z0-9]{1,4})$/i.exec(f.name); return ext ? ext[1].toUpperCase() : 'FILE';
+  }
+  // 7.0.4 QA, kept in the shared viewer: 503 previews_busy means the Mac is already reading its limit of previews.
+  var BUSY_WORDS = 'Your Mac is busy with other previews. Try again in a moment.';
+  function isBusy(err) { return !!(err && err.status === 503 && err.code === 'previews_busy'); }
+  function failWords(err) {
+    if (isBusy(err)) return BUSY_WORDS;
+    if (err && err.status === 401) return 'Signed out. Connect this browser again to open the file.';
+    if (err && err.status === 403) return err.code === 'secret_file_denied' ? REASONS.secret_file : 'Previews are off. Turn them on in Settings, Privacy.';
+    if (err && err.status === 404) return 'This file is no longer in the recent turns. Reopen the session to refresh it.';
+    if (err && err.status === 413) return 'Too large to open here. Open it on your Mac.';
+    if (err && err.status === 415) return 'This file is not text. Download it instead.';
+    return 'The file could not load. Check that your Mac is awake, then retry.';
+  }
+  function metaWords(f) {
+    if (f.kind === 'folder') return 'Folder · Open it on your Mac';
+    if (f.state !== 'available') return f.type + ' · ' + (REASONS[f.reason] || OFF);
+    return [f.type, bytesWords(f.size), f.line ? 'line ' + f.line : ''].filter(Boolean).join(' · ');
+  }
+
+  // A card where the link sits. An unavailable, blocked or folder card is words, never a button.
+  function chip(scope, dto, words, onOpen) {
+    var f = clean(dto); if (!f) return null;
+    var open = f.state === 'available' && f.kind !== 'folder';
+    var el = element(open ? 'button' : 'span', 'pv-chip' + (open ? '' : ' off') + (f.reason === 'secret_file' ? ' blocked' : ''));
+    if (open) { el.type = 'button'; el.setAttribute('aria-label', 'Open ' + f.type + ': ' + f.name + (f.line ? ', line ' + f.line : '')); }
+    var lead = element('span', 'pv-badge', badge(f)); lead.setAttribute('aria-hidden', 'true');
+    var text = element('span', 'pv-chip-text');
+    text.appendChild(element('span', 'pv-chip-label', String(words || f.label).slice(0, 120)));
+    text.appendChild(element('span', 'pv-chip-meta', metaWords(f)));
+    var card = { el: el, f: f, url: '', generation: 0 };
+    if (open && f.kind === 'pdf' && parts(f).indexOf('thumb') >= 0) {
+      el.className += ' has-thumb'; lead = element('span', 'pv-thumb', 'PDF'); lead.setAttribute('aria-hidden', 'true'); card.thumb = lead;
+    }
+    el.appendChild(lead); el.appendChild(text);
+    if (open) el.addEventListener('click', function () { onOpen(f, el); });
+    return card;
+  }
+
+  // ── Renderers. `v` is the viewer shell from reader-media.js: { body, acts, alive(), request(url, foreground, type) } ──
+  function status(v, words) { v.body.textContent = ''; var p = element('p', 'rm-status', words); p.setAttribute('role', 'status'); v.body.appendChild(p); return p; }
+  // A busy Mac, or one that did not answer, gets a "Try again" that draws the same file again; a refusal (secret,
+  // previews off, gone, too large) does not, because trying again cannot change it.
+  function fail(v) {
+    return function (err) {
+      if (!v.alive()) return;
+      status(v, failWords(err));
+      var again = isBusy(err) || !(err && err.status) || err.status === 503;
+      if (again && typeof v.retry === 'function') v.body.appendChild(button('Try again', function () { v.retry(); }));
+    };
+  }
+  function textPart(v, scope, f, offset, limit) {
+    return v.request(url(scope, f.id, 'text', '&offset=' + (offset || 0) + (limit ? '&limit=' + limit : '')), true, 'json').then(function (d) {
+      if (!d || typeof d.text !== 'string') throw new Error('No text');
+      return d;
+    });
+  }
+  function moreButton(v, words, run) { var b = button(words, function () { b.disabled = true; b.textContent = 'Loading…'; run(b); }); return b; }
+
+  function renderMarkdown(v, scope, f) {
+    var all = '';
+    var box = element('div', 'pv-scroll'), md = element('div', 'sx-md pv-md'); box.appendChild(md);
+    function load(offset) {
+      return textPart(v, scope, f, offset).then(function (d) {
+        if (!v.alive()) return;
+        all += d.text;
+        // The reply renderer: everything escaped first, a small subset of Markdown, links only to https.
+        md.innerHTML = W.sessionKit && W.sessionKit.markdown ? W.sessionKit.markdown(all) : '';
+        if (!md.innerHTML) md.textContent = all;
+        if (box.parentNode !== v.body) { v.body.textContent = ''; v.body.appendChild(box); }
+        if (d.more) md.appendChild(moreButton(v, 'Show more', function () { load(d.end); }));
+      });
+    }
+    load(0).catch(fail(v));
+  }
+
+  function renderCode(v, scope, f) {
+    var box = element('div', 'pv-scroll'), code = element('div', 'pv-code'), lines = [], next = 1, carry = '', loaded = false;
+    box.appendChild(code);
+    var bar = element('div', 'pv-bar'), note = element('span', 'rm-status');
+    var jump = element('form', 'pv-jump'), input = element('input'); input.type = 'number'; input.min = '1'; input.inputMode = 'numeric'; input.setAttribute('aria-label', 'Line number'); input.placeholder = 'Line';
+    jump.appendChild(input); jump.appendChild(button('Go to line', function () { go(Number(input.value)); }));
+    jump.addEventListener('submit', function (e) { e.preventDefault(); go(Number(input.value)); });
+    bar.appendChild(jump); bar.appendChild(note);
+    var more = null, end = 0;
+    function addLines(text, final) {
+      var parts = (carry + text).split('\n');
+      carry = final ? '' : parts.pop();
+      if (final && parts.length && parts[parts.length - 1] === '' ) parts.pop();
+      parts.forEach(function (t) {
+        var row = element('div', 'pv-line'); row.setAttribute('data-line', String(next));
+        row.appendChild(element('span', 'pv-n', String(next))); row.appendChild(element('span', 'pv-t', t || ' '));
+        code.appendChild(row); lines.push(row); next++;
+      });
+    }
+    function go(n) {
+      n = Math.floor(n);
+      if (!(n >= 1)) return;
+      if (n > lines.length) { note.textContent = more ? 'Line ' + n + ' is further down. Show more first.' : 'This file has ' + lines.length + ' lines.'; return; }
+      lines.forEach(function (r) { r.classList.remove('hit'); });
+      var row = lines[n - 1]; row.classList.add('hit');
+      try { row.scrollIntoView({ block: 'center' }); } catch (_e) { box.scrollTop = row.offsetTop - 40; }
+      note.textContent = 'Line ' + n;
+    }
+    function load(offset) {
+      return textPart(v, scope, f, offset).then(function (d) {
+        if (!v.alive()) return;
+        addLines(d.text, !d.more); end = d.end;
+        if (!loaded) { loaded = true; v.body.textContent = ''; v.body.appendChild(bar); v.body.appendChild(box); }
+        if (more) { more.remove(); more = null; }
+        if (d.more) { more = moreButton(v, 'Show more', function () { load(end); }); code.appendChild(more); }
+        if (f.line && lines.length >= f.line && !box.__jumped) { box.__jumped = true; input.value = String(f.line); go(f.line); }
+        else if (f.line && !d.more && !box.__jumped) { box.__jumped = true; go(f.line); }
+      });
+    }
+    load(0).catch(fail(v));
+  }
+
+  function renderTable(v, scope, f) {
+    var box = element('div', 'pv-scroll'), table = element('table', 'pv-table'), head = element('thead'), body = element('tbody'), note = element('p', 'rm-status');
+    table.appendChild(head); table.appendChild(body); box.appendChild(table);
+    var more = null, shown = 0;
+    function load(offset) {
+      return v.request(url(scope, f.id, 'table', '&offset=' + offset), true, 'json').then(function (d) {
+        if (!v.alive()) return;
+        if (!d || !Array.isArray(d.rows) || !Array.isArray(d.header)) throw new Error('No table');
+        if (!shown && !head.firstChild) {
+          var tr = element('tr'); tr.appendChild(element('th', 'pv-rn', '#'));
+          d.header.forEach(function (c) { var th = element('th', '', String(c)); th.setAttribute('scope', 'col'); tr.appendChild(th); });
+          head.appendChild(tr);
+          v.body.textContent = ''; v.body.appendChild(box); v.body.appendChild(note);
+        }
+        d.rows.forEach(function (r) {
+          var tr = element('tr'); shown++; tr.appendChild(element('td', 'pv-rn', String(shown)));
+          for (var k = 0; k < d.header.length || k < r.length; k++) tr.appendChild(element('td', '', String(r[k] == null ? '' : r[k])));
+          body.appendChild(tr);
+        });
+        if (more) { more.remove(); more = null; }
+        var words = [shown + (shown === 1 ? ' row' : ' rows') + ' shown'];
+        if (d.capped && !d.more) words.push('The preview stops at 5,000 rows. Download it for the rest.');
+        if (d.columnsCut) words.push('Only the first 50 columns are shown.');
+        note.textContent = words.join('. ') + (words.length > 1 ? '' : '.');
+        if (d.more) { more = moreButton(v, 'Show 200 more rows', function () { load(d.next); }); v.body.appendChild(more); }
+      });
+    }
+    load(0).catch(fail(v));
+  }
+
+  // HTML is served by the server under its own sandbox CSP (scripts off, no network), with the same policy injected as a
+  // <meta> at the top of the page. The frame is sandboxed too and never gets allow-same-origin. Full length.
+  function renderHtml(v, scope, f) {
+    var bar = element('div', 'pv-bar'), note = element('span', 'rm-status'), toggle = null, frame = null, on = false;
+    function show() {
+      if (frame) frame.remove();
+      frame = element('iframe', 'pv-frame');
+      frame.setAttribute('sandbox', on ? 'allow-scripts' : '');
+      frame.setAttribute('referrerpolicy', 'no-referrer');
+      frame.title = 'Preview of ' + f.name + (on ? ' (scripts on, no network)' : ' (scripts off)');
+      frame.src = url(scope, f.id, on ? 'html-run' : 'html');
+      v.body.appendChild(frame);
+      // Honest words: with scripts on, the page still cannot fetch anything or read COS, but a script can move its own
+      // frame to another address (no browser can stop that), so "cannot reach the internet" would overclaim.
+      note.textContent = on ? 'Scripts are on for this view only. They cannot fetch data or read COS.' : 'Scripts are off. Nothing on this page loads from the internet.';
+      toggle.textContent = on ? 'Turn scripts off' : 'Run scripts';
+      toggle.setAttribute('aria-pressed', String(on));
+    }
+    toggle = button('Run scripts', function () { on = !on; show(); });
+    bar.appendChild(toggle); bar.appendChild(note);
+    v.body.textContent = ''; v.body.appendChild(bar);
+    show();
+  }
+
+  // Decision 4a: a PDF opens inline on a desktop and in its own tab on a phone. "Phone" here is any touch-first screen,
+  // the unfolded Duo (703 wide) included: iOS Safari draws only part of a PDF inside a frame (plan canary 17, unrun).
+  function isPhone() {
+    try {
+      if (typeof W.isPhone === 'function' && W.isPhone()) return true;
+      return !!(window.matchMedia && window.matchMedia('(hover: none) and (pointer: coarse)').matches);
+    } catch (_e) { return false; }
+  }
+  function renderPdf(v, scope, f) {
+    v.body.textContent = '';
+    if (isPhone()) {
+      var p = element('p', 'rm-status', 'PDFs open in a new tab on a phone.'); v.body.appendChild(p);
+      var a = element('a', 'cx-btn', 'Open ' + f.name); a.href = url(scope, f.id, 'inline'); a.target = '_blank'; a.rel = 'noopener'; v.body.appendChild(a);
+      return;
+    }
+    // Same origin, so the browser's own PDF viewer draws it; the server sends it as application/pdf, nosniff.
+    var frame = element('iframe', 'pv-frame'); frame.title = f.name; frame.src = url(scope, f.id, 'inline');
+    v.body.appendChild(frame);
+  }
+
+  function renderImage(v, scope, f) {
+    status(v, 'Loading image…');
+    var gif = !NORMALIZED.test(f.name);
+    v.request(url(scope, f.id, gif ? 'raw' : 'inline'), true, 'blob').then(function (blob) {
+      if (!v.alive()) return;
+      if (!blob || !blob.size) throw new Error('No image');
+      var typed = new Blob([blob], { type: gif ? 'image/gif' : 'image/jpeg' });
+      v.setUrl(URL.createObjectURL(typed));
+      v.body.textContent = ''; var img = element('img'); img.alt = f.name; img.src = v.url(); v.body.appendChild(img);
+    }).catch(fail(v));
+  }
+
+  function renderOther(v, scope, f) {
+    v.body.textContent = '';
+    var box = element('div', 'pv-other');
+    if (parts(f).indexOf('thumb') >= 0) {
+      var t = element('span', 'pv-thumb', badge(f)); box.appendChild(t);
+      v.request(url(scope, f.id, 'thumb'), true, 'blob').then(function (blob) {
+        if (!v.alive() || !blob || !blob.size) return;
+        v.setUrl(URL.createObjectURL(new Blob([blob], { type: 'image/png' })));
+        t.textContent = ''; var img = element('img'); img.alt = ''; img.src = v.url(); t.appendChild(img);
+      }, function () { t.textContent = 'No preview image'; });
+    }
+    box.appendChild(element('p', 'rm-status', f.type + (f.size != null ? ' · ' + bytesWords(f.size) : '') + '. Download it, or open it on your Mac.'));
+    v.body.appendChild(box);
+  }
+
+  function render(v, scope, dto) {
+    var f = clean(dto); if (!f) return status(v, OFF);
+    if ((' ' + v.body.className + ' ').indexOf(' pv-body ') < 0) v.body.className += ' pv-body';
+    v.retry = function () { if (v.alive()) render(v, scope, dto); };
+    if (f.state !== 'available') return status(v, REASONS[f.reason] || OFF);
+    if (f.kind === 'markdown') return renderMarkdown(v, scope, f);
+    if (f.kind === 'text' || f.kind === 'code') return renderCode(v, scope, f);
+    if (f.kind === 'table') return renderTable(v, scope, f);
+    if (f.kind === 'html') return renderHtml(v, scope, f);
+    if (f.kind === 'pdf') return renderPdf(v, scope, f);
+    if (f.kind === 'image') return renderImage(v, scope, f);
+    return renderOther(v, scope, f);
+  }
+
+  W.preview = { chip: chip, render: render, clean: clean, parts: parts, kindOf: kindOf, url: url, failWords: failWords, isBusy: isBusy, reasons: REASONS, isPhone: isPhone };
+  W.registerPane('preview', W.preview);
+})();

package/server/web-control/panes/questions.js

@@ -47,7 +47,8 @@
     stopped: false,
     inflight: false,      // a poll is on the wire
     again: false,         // something asked for a poll while one was out: one more as soon as it lands
-    lastPollAt: 0         // when the last poll went out (Date.now)
+    lastPollAt: 0,        // when the last poll went out (Date.now)
+    load: 'unread'        // W13: 'unread' (no read yet), 'ok' (the last read was the server's answer) or 'failed' (it was not)
   };
   var DEFAULT_POLL_MS = 10000;
   var POLL_TIMEOUT_MS = 15000;
@@ -134,6 +135,19 @@
     // QA 6.99.27 (N4): the read asked for while this one was out goes through nudge, so it waits out the 1 s gap too.
     if (Q.again) { Q.again = false; nudge(); }
   }
+  // W13 (QA week of 11/01-11/08): whether the last read was the server's answer. A failed read leaves no cards, and Today's
+  // sheet read "no card" as "at the Mac's prompt" (a Claude session) with no way to read again. Each change tells the
+  // mounted sheets (their onChange), never on a read that changed nothing.
+  function noteLoad(state) {
+    if (Q.load === state) return;
+    Q.load = state;
+    tellMounts();
+  }
+  function tellMounts() {
+    mounts.forEach(function (m) {
+      if (m.onChange) { try { m.onChange(itemsFor(m.sessionId).length, atMacFor(m.sessionId).length); } catch (_e) {} }
+    });
+  }
   function poll() {
     clearTimeout(Q.timer);
     if (Q.stopped || document.hidden || !signedIn()) return;
@@ -141,7 +155,7 @@
     if (Q.inflight) { Q.again = true; return; }
     Q.inflight = true; Q.again = false; Q.lastPollAt = Date.now();
     capForPoll().then(function (cap) {
-      if (!usable(cap)) { Q.again = false; landed(); clearCards(); schedule(60000); return; }
+      if (!usable(cap)) { Q.again = false; landed(); clearCards(); schedule(60000); noteLoad(cap ? 'ok' : 'failed'); return; }
       // 6.99.32 (QA 6.99.30 canary W1): a Mac that hangs (asleep, a stale Tailscale route) never answered and never
       // refused, so this read stayed in flight forever: no more polls, and the Mac never marked down. It gives up after
       // POLL_TIMEOUT_MS, says the Mac is not answering, and polls again. The limit covers the body too (QA 6.99.32
@@ -153,27 +167,32 @@
         // answered (any status) or did not (below); otherwise a "down" mark stranded Submit, Allow and Deny for minutes.
         if (W.noteServer) W.noteServer(true);
         if (res.status === 401) { clearTimeout(limit); Q.again = false; landed(); Q.stopped = true; clearCards(); return; }
-        if (!res.ok) { clearTimeout(limit); schedule(DEFAULT_POLL_MS); landed(); return; }
+        if (!res.ok) { clearTimeout(limit); schedule(DEFAULT_POLL_MS); landed(); noteLoad('failed'); return; }
         return res.json().then(function (d) {
           clearTimeout(limit);
-          if (!d || d.enabled === false) { Q.again = false; landed(); clearCards(); schedule(60000); return; }
+          if (!d || d.enabled === false) { Q.again = false; landed(); clearCards(); schedule(60000); noteLoad('ok'); return; }
           // Painted as soon as the read lands: take() draws the cards and repaints Today's Needs you and the pet.
+          // The state first, so a redraw take() makes already reads 'ok'; a read that changed no card redraws nothing, so
+          // the sheets still hear that the failure is over.
+          var was = Q.load;
+          Q.load = 'ok';
           take(Array.isArray(d.items) ? d.items : [], Array.isArray(d.settled) ? d.settled : []);
+          if (was !== 'ok') tellMounts();
           var every = Number(d.pollIntervalMs) > 0 ? Number(d.pollIntervalMs) : DEFAULT_POLL_MS;
           schedule(nextWait(every));
           landed();
         }, function () {
           // The body never finished (cut off, or the limit fired mid-body). The Mac did answer the headers, so it is not
           // marked down; the poll is freed and goes again.
-          clearTimeout(limit); schedule(DEFAULT_POLL_MS); landed();
+          clearTimeout(limit); schedule(DEFAULT_POLL_MS); landed(); noteLoad('failed');
         });
       }, function () {
         // No answer at all: refused, unreachable, or the limit fired before the headers (the only abort this read has).
         clearTimeout(limit);
         if (W.noteServer) W.noteServer(false);
-        schedule(DEFAULT_POLL_MS); landed();
+        schedule(DEFAULT_POLL_MS); landed(); noteLoad('failed');
       });
-    }).catch(function () { schedule(DEFAULT_POLL_MS); landed(); });
+    }).catch(function () { schedule(DEFAULT_POLL_MS); landed(); noteLoad('failed'); });
   }
   // Read now, unless a read went out under NUDGE_GAP_MS ago (then at the end of that gap) or one is on the wire (then
   // once more when it lands). Today calls this when a session goes to waiting, so its question shows at once.
@@ -707,5 +726,6 @@
   if (W.onRoute) W.onRoute(function (r) { if (r && r.pane === 'today') nudge(); });
 
   W.sessionQuestions = { _state: Q, _take: take, _render: render, _presenceAge: presenceAge, _pollUrl: pollUrl, _key: onKey, _advanceMs: ADVANCE_MS, _todayPollMs: TODAY_POLL_MS, _fitKeyboard: fitKeyboard, poll: poll, nudge: nudge, mount: mount,
-    itemsFor: itemsFor, atMacFor: atMacFor, answeredFor: answeredFor, wordsOf: wordsOf, macLine: MAC_LINE, answeredLine: ANSWERED_LINE };
+    itemsFor: itemsFor, atMacFor: atMacFor, answeredFor: answeredFor, wordsOf: wordsOf, macLine: MAC_LINE, answeredLine: ANSWERED_LINE,
+    loadState: function () { return Q.load; }, retry: function () { nudge(); } };
 })();