@batalabs/virlow-mcp-core 3.84.2 → 3.85.1

package/dist/cjs/widgets.js

@@ -0,0 +1,463 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WIDGET_PARTS = exports.WIDGET_RESOURCES = exports.TOOL_WIDGETS = exports.CONTEXT_CARD_FACTS = exports.KIND_COLORS = exports.VIRLOW_APP_URL = exports.MEMORY_CONTEXT_URI = exports.SAVED_MEMORY_URI = exports.WIDGET_MIME_TYPE = void 0;
+exports.widgetToolMeta = widgetToolMeta;
+exports.resourceMeta = resourceMeta;
+exports.readWidget = readWidget;
+exports.widgetHtml = widgetHtml;
+/** The MCP Apps resource type. ChatGPT reads it too. */
+exports.WIDGET_MIME_TYPE = 'text/html;profile=mcp-app';
+/**
+ * Versioned, because a host treats the URI as the cache key for the page:
+ * ChatGPT keeps what it fetched for a URI, so changed HTML under the same URI
+ * may never be seen. Bump the version whenever the page changes.
+ * v2: the card performs the MCP Apps handshake even when window.openai exists.
+ */
+exports.SAVED_MEMORY_URI = 'ui://widget/saved-memory-v2.html';
+exports.MEMORY_CONTEXT_URI = 'ui://widget/memory-context-v2.html';
+/** Where "Open in Virlow" goes. The web app has no per-memory route, so it
+ *  opens the app itself. */
+exports.VIRLOW_APP_URL = 'https://app.virlow.com';
+/**
+ * The thirteen kind colours, light and dark. A copy of KIND_COLORS in the
+ * web app (src/lib/entityKinds.ts), which cannot be imported here: that
+ * module pulls in lucide-react. A test holds the two to the same values.
+ */
+exports.KIND_COLORS = {
+    person: { light: '#4F6D8F', dark: '#8FB0D0' },
+    organization: { light: '#C2603E', dark: '#E08A67' },
+    project: { light: '#A27B17', dark: '#F2C66D' },
+    tool: { light: '#5E7B4A', dark: '#9DBB85' },
+    place: { light: '#7A5A8C', dark: '#B79BC8' },
+    event: { light: '#CB2A61', dark: '#F6638A' },
+    topic: { light: '#0C9184', dark: '#82DCCF' },
+    product: { light: '#9E2185', dark: '#EA78CD' },
+    media: { light: '#6E4A2E', dark: '#C8A07E' },
+    pet: { light: '#C16B10', dark: '#F59C4D' },
+    group: { light: '#10953A', dark: '#6AD177' },
+    goal: { light: '#5D47B2', dark: '#AC8FFA' },
+    other: { light: '#6B665C', dark: '#9A9488' },
+};
+/** How many facts the context card shows; the text result keeps them all. */
+exports.CONTEXT_CARD_FACTS = 5;
+const VIEW_URI = {
+    saved: exports.SAVED_MEMORY_URI,
+    context: exports.MEMORY_CONTEXT_URI,
+};
+/** Which tools show which card. Tools not named here have no UI. */
+exports.TOOL_WIDGETS = {
+    add_memory: 'saved',
+    update_memory: 'saved',
+    memory_context: 'context',
+};
+/** The tool-side `_meta` linking a tool to its card: the MCP Apps key, the
+ *  flat `ui/resourceUri` spelling older MCP Apps hosts read (the ext-apps
+ *  SDK's registerAppTool writes both), and ChatGPT's alias. Visibility is
+ *  stated rather than left to the default: the model calls these tools and
+ *  the card may call tools too (add_memory's Undo calls delete_memory, and
+ *  `openai/widgetAccessible` is ChatGPT's older spelling of that). */
+function widgetToolMeta(tool) {
+    const view = exports.TOOL_WIDGETS[tool];
+    if (!view)
+        return undefined;
+    const uri = VIEW_URI[view];
+    return {
+        ui: { resourceUri: uri, visibility: ['model', 'app'] },
+        'ui/resourceUri': uri,
+        'openai/outputTemplate': uri,
+        ...(tool === 'add_memory' && { 'openai/widgetAccessible': true }),
+    };
+}
+/**
+ * The resource-side `_meta`. Empty CSP lists are the secure default (no
+ * network); they are stated rather than omitted so a reviewer reads the
+ * decision. `openai/widgetCSP` is ChatGPT's older spelling of the same
+ * thing; redirect_domains lets "Open in Virlow" go straight to the app.
+ */
+function resourceMeta(view) {
+    return {
+        ui: {
+            prefersBorder: true,
+            csp: { connectDomains: [], resourceDomains: [], frameDomains: [] },
+        },
+        'openai/widgetDescription': view === 'saved'
+            ? 'Shows the memory just saved to Virlow, with Undo and a link to the app. The card already shows the fact, so a one-line confirmation is enough.'
+            : 'Shows a short summary of what Virlow has saved about this user or project.',
+        'openai/widgetCSP': {
+            connect_domains: [],
+            resource_domains: [],
+            redirect_domains: [exports.VIRLOW_APP_URL],
+        },
+        'openai/widgetPrefersBorder': true,
+    };
+}
+/** Everything the server needs to list and serve the two resources. */
+exports.WIDGET_RESOURCES = [
+    {
+        name: 'saved-memory-card',
+        uri: exports.SAVED_MEMORY_URI,
+        title: 'Saved to Virlow',
+        description: 'Inline card shown after a memory is saved or updated.',
+        view: 'saved',
+    },
+    {
+        name: 'memory-context-card',
+        uri: exports.MEMORY_CONTEXT_URI,
+        title: 'What Virlow knows',
+        description: 'Inline card summarising the memories returned by memory_context.',
+        view: 'context',
+    },
+];
+/** A `resources/read` result for one card. */
+function readWidget(view) {
+    const uri = VIEW_URI[view];
+    return {
+        contents: [{ uri, mimeType: exports.WIDGET_MIME_TYPE, text: widgetHtml(view), _meta: resourceMeta(view) }],
+    };
+}
+// ---------- the page ----------
+/** The Virlow mark from public/favicon.svg: the italic v and its dot. */
+const MARK_SVG = '<svg class="mark" viewBox="0 0 64 64" width="20" height="20" aria-hidden="true" focusable="false">' +
+    '<rect width="64" height="64" rx="12" fill="#fbfaf7"/>' +
+    '<g transform="translate(6.172854 51.207268) scale(2.201335896 -2.201335896)">' +
+    '<path d="M7.8 -0.4Q6.8 -0.4 6.4 -0.2Q6.1 0.1 6.1 0.4Q6.1 0.6 6.1 0.8Q6.1 0.9 6.1 1.1Q6.1 1.3 6.1 1.7Q6 3.9 5.7 6.3Q5.3 8.7 4.6 10.8Q3.9 12.9 3.1 14.3Q2.9 14.5 2.7 14.7Q2.5 14.8 2.3 14.8Q2 14.8 1.7 14.7Q1.4 14.5 1 14.2Q0.8 13.9 0.5 13.9Q0.4 13.9 0.1 14.1Q-0.1 14.3 -0.1 14.7Q-0.1 14.9 0 15.1Q1 16.5 2.3 17.2Q3.6 17.8 5.1 17.8Q7.1 17.8 8.2 15.9Q9 14.5 9.5 12.6Q9.9 10.8 10.1 8.7Q10.3 6.6 10.4 4.5Q10.4 4.1 10 3.1Q9.7 2.2 9.3 1.7Q10.3 2.3 11.4 3.3Q12.5 4.3 13.4 5.6Q14.4 6.9 15 8.3Q15.6 9.7 15.6 11.1Q15.6 12 15.4 12.6Q15.2 13.3 14.9 14Q14.7 14.7 14.7 15.5Q14.7 16.6 15.4 17.2Q16.1 17.8 17.2 17.8Q18.2 17.8 18.9 17.2Q19.5 16.6 19.8 15.8Q20.1 14.9 20.1 13.9Q20.1 12.4 19.4 10.7Q18.7 9 17.5 7.3Q16.2 5.7 14.8 4.2Q13.3 2.7 11.8 1.5Q10.3 0.4 9 -0.3Q9 -0.4 8.8 -0.4Q8.6 -0.4 7.8 -0.4Z" fill="#1f1d1a"/>' +
+    '<path d="M17.7 2.6Q17.7 3.9 18.5 4.9Q19.4 5.8 20.8 5.8Q22.1 5.8 22.8 5Q23.5 4.2 23.5 3Q23.5 1.6 22.6 0.6Q21.7 -0.4 20.4 -0.4Q19 -0.4 18.3 0.5Q17.7 1.4 17.7 2.6Z" fill="#775825"/>' +
+    '</g></svg>';
+function kindVars(mode) {
+    return Object.entries(exports.KIND_COLORS)
+        .map(([kind, c]) => `--k-${kind}:${c[mode]};`)
+        .join('');
+}
+const LIGHT = 'color-scheme:light;--ink:#1F1D1A;--ink-2:#5E5A52;--ink-3:#6B665C;--rule:rgba(0,0,0,0.12);' +
+    '--chip:rgba(0,0,0,0.05);--btn:#4F6D8F;--btn-ink:#FFFFFF;--btn-hover:#33506E;--ghost-hover:rgba(0,0,0,0.05);' +
+    '--ring:#33506E;--danger:#B3402E;--ok:#4C783C;' +
+    kindVars('light');
+const DARK = 'color-scheme:dark;--ink:#EDE7DD;--ink-2:#B8B0A4;--ink-3:#9A9488;--rule:rgba(255,255,255,0.16);' +
+    '--chip:rgba(255,255,255,0.07);--btn:#8FB0D0;--btn-ink:#14181D;--btn-hover:#B8D1E8;--ghost-hover:rgba(255,255,255,0.08);' +
+    '--ring:#B8D1E8;--danger:#E07A68;--ok:#9DBB85;' +
+    kindVars('dark');
+/** Kept to body and body-small sizes, system fonts, no inner scrolling: the
+ *  Apps SDK rules for an inline card. Long text is clamped, not scrolled. */
+const CSS = `
+:root{${LIGHT}}
+:root[data-theme="dark"]{${DARK}}
+@media (prefers-color-scheme: dark){:root:not([data-theme="light"]){${DARK}}}
+*{box-sizing:border-box}
+html,body{margin:0;padding:0;background:transparent;overflow:hidden}
+body{font:14px/1.45 system-ui,-apple-system,"Segoe UI",Roboto,"Helvetica Neue",Arial,sans-serif;color:var(--ink);-webkit-font-smoothing:antialiased}
+.card{padding:14px 16px;display:flex;flex-direction:column;gap:8px}
+.head{display:flex;align-items:center;gap:8px;min-width:0}
+.mark{flex:none;border-radius:5px;box-shadow:0 0 0 1px var(--rule)}
+.status{font-size:13px;font-weight:600;color:var(--ink-2);outline:none}
+.status.removed{color:var(--ink-3)}
+.ns{margin-left:auto;font-size:12px;color:var(--ink-3);white-space:nowrap;overflow:hidden;text-overflow:ellipsis;max-width:45%}
+.label{font-weight:600;margin:0;overflow-wrap:anywhere}
+.fact{margin:0;color:var(--ink-2);overflow-wrap:anywhere;display:-webkit-box;-webkit-box-orient:vertical;-webkit-line-clamp:4;overflow:hidden}
+.removed-body .label,.removed-body .fact{text-decoration:line-through;color:var(--ink-3)}
+.chips{display:flex;flex-wrap:wrap;gap:6px;margin:0;padding:0;list-style:none}
+.chip{display:inline-flex;align-items:center;gap:6px;max-width:100%;padding:2px 9px 2px 7px;border-radius:999px;background:var(--chip);font-size:12px;color:var(--ink)}
+.chip span{white-space:nowrap;overflow:hidden;text-overflow:ellipsis}
+.dot{flex:none;width:8px;height:8px;border-radius:50%;background:var(--k-other)}
+${Object.keys(exports.KIND_COLORS)
+    .map((k) => `.chip[data-kind="${k}"] .dot{background:var(--k-${k})}`)
+    .join('\n')}
+.facts{margin:0;padding:0;list-style:none;display:flex;flex-direction:column;gap:6px}
+.facts li{display:-webkit-box;-webkit-box-orient:vertical;-webkit-line-clamp:2;overflow:hidden;overflow-wrap:anywhere;color:var(--ink-2)}
+.facts b{color:var(--ink);font-weight:600}
+.note{margin:0;font-size:12px;color:var(--ink-3)}
+.error{margin:0;font-size:12px;color:var(--danger)}
+.actions{display:flex;gap:8px;flex-wrap:wrap;margin-top:2px}
+button{font:inherit;font-size:13px;font-weight:600;border-radius:8px;padding:6px 12px;cursor:pointer;border:1px solid transparent}
+button:focus-visible{outline:2px solid var(--ring);outline-offset:2px}
+button[disabled]{opacity:.6;cursor:default}
+.primary{background:var(--btn);color:var(--btn-ink)}
+.primary:hover:not([disabled]){background:var(--btn-hover)}
+.secondary{background:transparent;color:var(--ink);border-color:var(--rule)}
+.secondary:hover:not([disabled]){background:var(--ghost-hover)}
+.empty{margin:0;color:var(--ink-3)}
+`;
+/**
+ * The card's script. Plain ES2017 in a string, because it ships inside the
+ * HTML rather than through the package build. It speaks to both bridges at
+ * once, never one instead of the other:
+ *
+ * - The MCP Apps bridge, JSON-RPC over postMessage, whenever the page is in a
+ *   frame: the card sends ui/initialize, then ui/notifications/initialized,
+ *   receives ui/notifications/tool-result, reports its height with
+ *   ui/notifications/size-changed, and calls tools/call and ui/open-link.
+ *   Every MCP Apps host needs this, ChatGPT included: it delivers the tool
+ *   result to an mcp-app frame only after the handshake.
+ * - ChatGPT's `window.openai`, when present, as an extension: toolOutput
+ *   (the structuredContent, possibly before the handshake completes),
+ *   widgetState / setWidgetState for the Undo state, theme, the
+ *   `openai:set_globals` event, and callTool / openExternal as the fallback
+ *   while the standard bridge is not up.
+ */
+const SCRIPT = `
+(function () {
+  'use strict';
+  var APP_URL = ${JSON.stringify(exports.VIRLOW_APP_URL)};
+  var KIND_LABEL = {person:'person',organization:'organization',project:'project',tool:'tool',place:'place',event:'event',topic:'topic',product:'product',media:'media',pet:'pet',group:'group',goal:'goal',other:'other'};
+  var root = document.getElementById('root');
+  var view = document.body.getAttribute('data-view') === 'context' ? 'context' : 'saved';
+  var state = { data: null, removed: false, busy: false, error: '' };
+  var bridge = null;
+
+  function openai() { return window.openai || null; }
+
+  function el(tag, cls, text) {
+    var node = document.createElement(tag);
+    if (cls) node.className = cls;
+    if (text != null) node.textContent = String(text);
+    return node;
+  }
+
+  function applyTheme(theme) {
+    if (theme === 'light' || theme === 'dark') document.documentElement.setAttribute('data-theme', theme);
+  }
+
+  function header(status, ns, removed) {
+    var head = el('div', 'head');
+    var mark = document.createElement('span');
+    mark.innerHTML = ${JSON.stringify(MARK_SVG)};
+    head.appendChild(mark.firstChild);
+    var s = el('span', 'status' + (removed ? ' removed' : ''), status);
+    s.id = 'status';
+    s.setAttribute('tabindex', '-1');
+    s.setAttribute('role', 'status');
+    s.setAttribute('aria-live', 'polite');
+    head.appendChild(s);
+    if (ns) {
+      var n = el('span', 'ns', ns);
+      n.title = 'Project: ' + ns;
+      head.appendChild(n);
+    }
+    return head;
+  }
+
+  function chips(entities, max) {
+    var list = el('ul', 'chips');
+    list.setAttribute('aria-label', 'About');
+    var shown = entities.slice(0, max);
+    for (var i = 0; i < shown.length; i++) {
+      var e = shown[i];
+      var kind = KIND_LABEL[e.kind] ? e.kind : 'other';
+      var li = el('li', 'chip');
+      li.setAttribute('data-kind', kind);
+      li.title = e.name + ' (' + kind + ')';
+      li.appendChild(el('span', 'dot')).setAttribute('aria-hidden', 'true');
+      var name = el('span', null, e.name);
+      li.appendChild(name);
+      var sr = el('span', 'sr', ', ' + kind);
+      sr.style.cssText = 'position:absolute;width:1px;height:1px;overflow:hidden;clip:rect(0 0 0 0)';
+      li.appendChild(sr);
+      list.appendChild(li);
+    }
+    if (entities.length > max) list.appendChild(el('li', 'chip', '+' + (entities.length - max)));
+    return list;
+  }
+
+  function button(label, cls, onClick, aria) {
+    var b = el('button', cls, label);
+    b.type = 'button';
+    if (aria) b.setAttribute('aria-label', aria);
+    b.addEventListener('click', onClick);
+    return b;
+  }
+
+  // The standard bridge first once it is up, window.openai while it is not
+  // (or in a ChatGPT that never answers ui/initialize).
+  function openApp() {
+    if (bridge && bridge.ready) { bridge.request('ui/open-link', { url: APP_URL }).catch(function () {}); return; }
+    var host = openai();
+    if (host && typeof host.openExternal === 'function') { host.openExternal({ href: APP_URL }); return; }
+    window.open(APP_URL, '_blank', 'noopener');
+  }
+
+  function callTool(name, args) {
+    if (bridge && bridge.ready) return bridge.request('tools/call', { name: name, arguments: args });
+    var host = openai();
+    if (host && typeof host.callTool === 'function') return Promise.resolve(host.callTool(name, args));
+    return Promise.reject(new Error('This host cannot run tools from a card.'));
+  }
+
+  function persist() {
+    var host = openai();
+    if (host && typeof host.setWidgetState === 'function') {
+      try { host.setWidgetState({ removed: state.removed }); } catch (e) { /* the card still shows it */ }
+    }
+  }
+
+  function undo() {
+    var d = state.data;
+    if (!d || !d.id || state.busy || state.removed) return;
+    state.busy = true;
+    state.error = '';
+    render();
+    callTool('delete_memory', { id: d.id })
+      .then(function (result) {
+        if (result && result.isError) throw new Error('refused');
+        state.removed = true;
+        persist();
+      })
+      .catch(function () { state.error = 'Could not remove it. Try again.'; })
+      .then(function () {
+        state.busy = false;
+        render();
+        var s = document.getElementById('status');
+        if (state.removed && s) s.focus();
+      });
+  }
+
+  function renderSaved(d) {
+    var card = el('div', 'card' + (state.removed ? ' removed-body' : ''));
+    var status = state.removed ? 'Removed from Virlow' : d.updated ? 'Updated in Virlow' : 'Saved to Virlow';
+    card.appendChild(header(status, d.namespace, state.removed));
+    card.appendChild(el('p', 'label', d.label));
+    card.appendChild(el('p', 'fact', d.text));
+    if (d.entities && d.entities.length) card.appendChild(chips(d.entities, 8));
+    if (state.removed) card.appendChild(el('p', 'note', 'Moved to the Trash. You can restore it in the Virlow app.'));
+    if (state.error) card.appendChild(el('p', 'error', state.error));
+    var actions = el('div', 'actions');
+    // Undo deletes the memory, so it is offered only for a new one: on an
+    // update it would delete what was there before, not reverse the change.
+    if (!d.updated && !state.removed) {
+      var u = button(state.busy ? 'Removing...' : 'Undo', 'primary', undo, 'Undo: remove this memory from Virlow');
+      if (state.busy) u.disabled = true;
+      actions.appendChild(u);
+    }
+    actions.appendChild(button('Open in Virlow', 'secondary', openApp, 'Open Virlow in a new tab'));
+    card.appendChild(actions);
+    return card;
+  }
+
+  function renderContext(d) {
+    var card = el('div', 'card');
+    card.appendChild(header('What Virlow knows', d.namespace, false));
+    var facts = d.facts || [];
+    if (facts.length) {
+      var list = el('ul', 'facts');
+      for (var i = 0; i < facts.length; i++) {
+        var li = el('li');
+        li.appendChild(el('b', null, facts[i].label));
+        li.appendChild(document.createTextNode(': ' + facts[i].text));
+        list.appendChild(li);
+      }
+      card.appendChild(list);
+    } else {
+      card.appendChild(el('p', 'empty', 'Nothing saved yet.'));
+    }
+    var people = (d.entities || []).filter(function (e) { return e.kind === 'person' || e.kind === 'project'; });
+    if (people.length) card.appendChild(chips(people, 6));
+    if (d.paused) card.appendChild(el('p', 'note', 'Saving new memories is paused.'));
+    var actions = el('div', 'actions');
+    actions.appendChild(button('Open in Virlow', 'secondary', openApp, 'Open Virlow in a new tab'));
+    card.appendChild(actions);
+    return card;
+  }
+
+  function render() {
+    root.textContent = '';
+    var d = state.data;
+    if (!d || typeof d !== 'object') return;
+    root.appendChild(view === 'context' ? renderContext(d) : renderSaved(d));
+    if (bridge) bridge.resized();
+  }
+
+  function fromOpenai() {
+    var host = openai();
+    if (!host) return;
+    applyTheme(host.theme);
+    if (host.toolOutput && typeof host.toolOutput === 'object') state.data = host.toolOutput;
+    var ws = host.widgetState;
+    if (ws && ws.removed === true) state.removed = true;
+    render();
+  }
+
+  function startBridge() {
+    var nextId = 1;
+    var pending = {};
+    var lastHeight = 0;
+    function post(msg) { window.parent.postMessage(msg, '*'); }
+    bridge = {
+      request: function (method, params) {
+        return new Promise(function (resolve, reject) {
+          var id = nextId++;
+          pending[id] = { resolve: resolve, reject: reject };
+          post({ jsonrpc: '2.0', id: id, method: method, params: params });
+        });
+      },
+      notify: function (method, params) { post({ jsonrpc: '2.0', method: method, params: params || {} }); },
+      // Set once the host answers ui/initialize. Nothing but that request
+      // goes to the host before then, as the MCP Apps lifecycle requires.
+      ready: false,
+      resized: function () {
+        if (!bridge.ready) return;
+        var h = Math.ceil(document.documentElement.getBoundingClientRect().height);
+        if (h && h !== lastHeight) { lastHeight = h; bridge.notify('ui/notifications/size-changed', { height: h }); }
+      }
+    };
+    window.addEventListener('message', function (event) {
+      if (event.source !== window.parent) return;
+      var m = event.data;
+      if (!m || m.jsonrpc !== '2.0') return;
+      if (m.method === undefined && m.id != null && pending[m.id]) {
+        var p = pending[m.id];
+        delete pending[m.id];
+        if (m.error) p.reject(new Error(m.error.message || 'error')); else p.resolve(m.result);
+        return;
+      }
+      var params = m.params || {};
+      if (m.method === 'ui/notifications/tool-result') {
+        if (params.structuredContent) { state.data = params.structuredContent; render(); }
+      } else if (m.method === 'ui/notifications/host-context-changed') {
+        applyTheme(params.theme);
+      } else if ((m.method === 'ui/resource-teardown' || m.method === 'ping') && m.id != null) {
+        post({ jsonrpc: '2.0', id: m.id, result: {} });
+      } else if (m.id != null) {
+        post({ jsonrpc: '2.0', id: m.id, error: { code: -32601, message: 'Method not found' } });
+      }
+    });
+    bridge.request('ui/initialize', {
+      appInfo: { name: 'virlow-card', version: '1' },
+      appCapabilities: {},
+      protocolVersion: '2026-01-26'
+    }).then(function (result) {
+      if (result && result.hostContext) applyTheme(result.hostContext.theme);
+      bridge.ready = true;
+      bridge.notify('ui/notifications/initialized');
+      // The host sizes the frame from these reports alone: without one an
+      // inline card can stay at zero height.
+      bridge.resized();
+      if (typeof ResizeObserver === 'function') {
+        new ResizeObserver(function () { bridge.resized(); }).observe(document.documentElement);
+      }
+    }).catch(function () {});
+  }
+
+  // Both, not either. ChatGPT injects window.openai into an MCP Apps
+  // (text/html;profile=mcp-app) frame too, but as an extension: the tool
+  // result reaches the card over the bridge, and only after the card has
+  // sent ui/initialize. A card that saw window.openai and skipped the
+  // bridge never initialized, never received its data and never reported a
+  // height, so ChatGPT showed nothing at all.
+  if (openai()) {
+    window.addEventListener('openai:set_globals', fromOpenai);
+    fromOpenai();
+  }
+  if (window.parent && window.parent !== window) {
+    startBridge();
+  }
+})();
+`;
+/** The whole page for one card. */
+function widgetHtml(view) {
+    return ('<!doctype html><html lang="en"><head><meta charset="utf-8">' +
+        '<meta name="viewport" content="width=device-width,initial-scale=1">' +
+        `<title>${view === 'saved' ? 'Saved to Virlow' : 'What Virlow knows'}</title>` +
+        `<style>${CSS}</style></head>` +
+        `<body data-view="${view}"><div id="root"></div><script>${SCRIPT}</script></body></html>`);
+}
+/** The pieces, for the widget tests: they run the script against the page
+ *  body in jsdom without a host. */
+exports.WIDGET_PARTS = { css: CSS, script: SCRIPT };

package/dist/memories.d.ts

@@ -212,6 +212,9 @@ export declare class MemoryStore {
     /** The namespace of a memory this session has seen, without a sync;
      *  undefined for a global memory or one not cached yet. */
     namespaceOfCached(id: string): string | undefined;
+    /** One memory as this session has it, without a sync; undefined when it
+     *  is not cached. */
+    cached(id: string): CachedMemory | undefined;
     /** Requires a prior sync() in the same unlock to have populated the cache. */
     list(namespace?: string): CachedMemory[];
     update(id: string, changes: {

package/dist/memories.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memories.d.ts","sourceRoot":"","sources":["../src/memories.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"memories.d.ts","sourceRoot":"","sources":["../src/memories.ts"],"names":[],"mappings":"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"}

package/dist/memories.js

@@ -651,6 +651,11 @@ export class MemoryStore {
     namespaceOfCached(id) {
         return this.cache.get(id)?.namespace;
     }
+    /** One memory as this session has it, without a sync; undefined when it
+     *  is not cached. */
+    cached(id) {
+        return this.cache.get(id);
+    }
     /** Requires a prior sync() in the same unlock to have populated the cache. */
     list(namespace) {
         this.requireSession();