@jossuealcala/madre 0.2.2 → 0.3.0

package/public/app.js

@@ -45,6 +45,7 @@ const PLACEHOLDERS = {
   ghost: 'Off the record. Ask anything; nothing is saved, nobody else will remember it.',
   control: 'Control armed. Say what to change in the project; every action runs without asking.',
   expendable: 'Type here, human. MOTHER is listening.',
+  memory: 'Ask what the room remembers. @madre answers from memory with citations; it does not act.',
 };
 let winkTimer = null;
 const LINE_PX = 21;
@@ -309,7 +310,7 @@ viewerUI.review?.addEventListener('click', (event) => {
   if (viewerUI.menu.hidden) showViewerMenu(rect.left, rect.bottom + 6); else hideViewerMenu();
 });
 viewer.dialog.addEventListener('click', (event) => { if (!viewerUI.menu.hidden && !viewerUI.menu.contains(event.target) && event.target !== viewerUI.review) hideViewerMenu(); });
-viewer.dialog.addEventListener('close', () => { hideViewerMenu(); setSelection(null, null); });
+viewer.dialog.addEventListener('close', () => { hideViewerMenu(); setSelection(null, null); ripley.frame = null; ripley.history = []; ripleyClearErrors(); if (ripley.nav) ripley.nav.hidden = true; });
 
 function codeView(text, { line = null, lines = null } = {}) {
   const pre = el('pre', 'code');
@@ -345,6 +346,9 @@ const RIPLEY_KIND = (name) => (/\.(html?|xhtml)$/i.test(name ?? '') ? 'html' : /
 const viewerMode = { button: document.querySelector('#viewer-mode'), preview: false, kind: null, text: '', src: '', line: null, lines: null };
 
 function showViewerSource() {
+  if (ripley.nav) ripley.nav.hidden = true;
+  ripleyClearErrors();
+  ripley.frame = null;
   const pre = codeView(viewerMode.text, { line: viewerMode.line, lines: viewerMode.lines });
   viewer.body.replaceChildren(pre);
   if (!state.ripley && viewerMode.kind) {
@@ -356,20 +360,115 @@ function showViewerSource() {
   else if (viewerMode.line) setSelection(viewerMode.line, viewerMode.line);
   pre.querySelector('.hl')?.scrollIntoView?.({ block: 'center' });
 }
-// The sealed frame: no scripts, no network, no storage; Markdown renders in place.
+// RIPLEY's frame, its small bar (back, reload), its history inside the project,
+// what the page reports up (which page, which errors), and reloads when an
+// agent changes the file on screen.
+const ripley = {
+  nav: document.querySelector('#viewer-nav'),
+  back: document.querySelector('#viewer-back'),
+  reload: document.querySelector('#viewer-reload'),
+  errors: document.querySelector('#viewer-errors'),
+  frame: null,
+  history: [],      // preview URLs visited in this session of the viewer
+  current: null,    // project-relative path of the page on screen
+  root: 'project',
+};
+function ripleyPathFromPreview(pathname) {
+  const match = String(pathname ?? '').match(/^\/preview\/(project|attachments)\/(.*)$/);
+  return match ? { root: match[1], path: decodeURIComponent(match[2]) } : null;
+}
+function ripleyNavigate(url, { push = true } = {}) {
+  if (!ripley.frame) return;
+  if (push && ripley.history.at(-1) !== url) ripley.history.push(url);
+  ripley.frame.src = url;
+  ripley.back.disabled = ripley.history.length < 2;
+}
+function ripleyClearErrors() { if (ripley.errors) { ripley.errors.hidden = true; ripley.errors.replaceChildren(); } }
+function ripleyShowError({ message, source, line }) {
+  if (!ripley.errors || !viewerMode.preview) return;
+  const where = source ? `${ripleyPathFromPreview(new URL(source, window.location.origin).pathname)?.path ?? source}${line ? `:${line}` : ''}` : (ripley.current ? `${ripley.current}${line ? `:${line}` : ''}` : '');
+  const row = el('div', 'err-row');
+  row.append(el('span', 'msg', message));
+  if (where) row.append(el('span', 'where', where));
+  const ask = el('button', null, 'ASK THE ROOM');
+  ask.type = 'button';
+  ask.title = 'Put this error and the file into the composer';
+  ask.addEventListener('click', () => {
+    const reference = ripley.current ? `!${ripley.current}${line ? `:${line}` : ''} ` : '';
+    els.input.value = `${reference}RIPLEY reports an error in the page: ${message}${where ? ` (${where})` : ''}. Find the cause and propose the fix.`;
+    viewer.dialog.close();
+    autosize();
+    els.input.focus();
+  });
+  row.append(ask);
+  ripley.errors.append(row);
+  while (ripley.errors.children.length > 3) ripley.errors.firstChild.remove();
+  ripley.errors.hidden = false;
+}
+window.addEventListener?.('message', (event) => {
+  const data = event.data;
+  if (!data || data.ripley !== 1 || !ripley.frame || event.source !== ripley.frame.contentWindow) return;
+  if (data.type === 'page') {
+    const at = ripleyPathFromPreview(data.path);
+    if (at) {
+      ripley.current = at.path;
+      ripley.root = at.root;
+      viewer.path.textContent = `${at.root === 'project' ? '/' : ''}${at.path}${data.title ? ` · ${data.title}` : ''}`;
+      viewer.open.href = `/api/files?root=${at.root}&path=${encodeURIComponent(at.path)}`;
+    }
+  } else if (data.type === 'error') {
+    ripleyShowError(data);
+  }
+});
+ripley.back?.addEventListener('click', () => {
+  if (ripley.history.length < 2) return;
+  ripley.history.pop();
+  ripleyClearErrors();
+  ripleyNavigate(ripley.history.at(-1), { push: false });
+});
+ripley.reload?.addEventListener('click', () => { if (ripley.frame) { ripleyClearErrors(); ripley.frame.src = ripley.frame.src; } });
+// An agent changed what is on screen (CONTROL) or created it (a lease): reload the page.
+function ripleyMaybeReload(paths) {
+  if (!viewerMode.preview || !ripley.frame || !ripley.current || !viewer.dialog.open) return;
+  const page = ripley.current;
+  const dir = page.includes('/') ? page.slice(0, page.lastIndexOf('/') + 1) : '';
+  const hit = paths.some((path) => path === page || (dir ? path.startsWith(dir) : !path.includes('/')));
+  if (!hit) return;
+  ripleyClearErrors();
+  ripley.frame.src = ripley.frame.src;
+  toast('MU/TH/UR › RIPLEY reloaded the page: an agent changed it.');
+}
+
 function showViewerPreview() {
   if (viewerMode.kind === 'markdown') {
+    ripley.nav.hidden = true;
     const doc = el('article', 'viewer-markdown bubble');
     doc.append(renderMarkdown(viewerMode.text));
     viewer.body.replaceChildren(doc);
     return;
   }
+  // Scripts may run; the frame has no origin of its own, no network, no forms, no way up to MADRE.
   const frame = el('iframe', 'ripley');
-  frame.setAttribute('sandbox', '');
+  frame.setAttribute('sandbox', 'allow-scripts');
   frame.setAttribute('referrerpolicy', 'no-referrer');
   frame.title = `RIPLEY preview of ${viewer.path.textContent}`;
-  frame.src = viewerMode.src.replace('/api/files?', '/api/preview?');
+  ripley.frame = frame;
+  ripley.history = [];
+  ripleyClearErrors();
+  const start = previewUrl(viewerMode.src);
+  const at = ripleyPathFromPreview(start);
+  ripley.current = at?.path ?? null;
+  ripley.root = at?.root ?? 'project';
   viewer.body.replaceChildren(frame);
+  ripley.nav.hidden = false;
+  ripleyNavigate(start);
+}
+// /api/files?root=project&path=a/b.html → /preview/project/a/b.html, so the page's relative links resolve.
+function previewUrl(filesUrl) {
+  const params = new URL(filesUrl, window.location.origin).searchParams;
+  const root = params.get('root') === 'attachments' ? 'attachments' : 'project';
+  const path = (params.get('path') ?? '').split('/').map(encodeURIComponent).join('/');
+  return `/preview/${root}/${path}`;
 }
 function syncViewerMode() {
   if (!viewerMode.button) return;
@@ -629,6 +728,11 @@ function renderPicker() {
     const text = paint(el('span', 'pick-label'), current.id);
     text.append('to ');
     text.append(el('b', null, `@${current.id}`));
+    if (current.local) {
+      const note = el('span', 'pick-note', 'memory · answers, does not act');
+      note.title = '@madre runs on this machine and speaks only for what the room said. To convene the crew or change files, write to a CLI agent.';
+      text.append(note);
+    }
     const modeChip = el('button', `mode-chip m${state.mode}`);
     modeChip.type = 'button';
     modeChip.append(el('b', null, `#${state.mode}`), `${MODES[state.mode].label} ▾`);
@@ -1673,6 +1777,20 @@ function renderEventNode(event) {
     case 'memory.distilled': node = renderDistilled(event); break;
     case 'memory.forgotten': node = renderForgotten(event); break;
     case 'memory.noted': attachMemoryHint(event); return;
+    case 'dataset.exported': return;
+    case 'agents.updated': {
+      for (const agent of event.payload.agents ?? []) {
+        const known = state.agents.get(agent.id);
+        state.agents.set(agent.id, { ...(known ?? { tokens: 0, rawTokens: 0, windowMs: null, rollsOverAt: null, officialPercent: null, officialResetAt: null, officialWindows: null }), ...agent });
+        const option = [...els.target.options].find((item) => item.value === agent.id);
+        if (agent.ready && !option) els.target.add(new Option(agent.label, agent.id));
+        if (!agent.ready && option) option.remove();
+      }
+      for (const id of event.payload.removed ?? []) { state.agents.delete(id); [...els.target.options].find((item) => item.value === id)?.remove(); }
+      renderAgents(); renderPicker(); renderOnboarding();
+      if (!replaying && event.payload.reason) toast(`MU/TH/UR › ${event.payload.reason}`);
+      return;
+    }
     case 'mother.alert': node = renderMotherAlert(event); break;
     case 'sentinel.report': state.reports.set(event.payload.id, { ...event.payload }); if (!replaying) { renderMotherSentinel(); toast(`MU/TH/UR › ${event.payload.kind === 'crash' ? 'a crash' : 'an unknown condition'} was recorded by the sentinel. Open MU/TH/UR to report it.`); } return;
     case 'sentinel.sent': { const report = state.reports.get(event.payload.id); if (report) report.sent = { ok: event.payload.ok, status: event.payload.status ?? null, error: event.payload.error ?? null, at: event.timestamp }; if (!replaying) renderMotherSentinel(); return; }
@@ -1698,12 +1816,12 @@ function renderEventNode(event) {
     case 'lease.missing': node = renderLeaseMissing(event); break;
     case 'mode.requested': node = renderModeRequest(event); break;
     case 'control.started': node = renderControlStarted(event); break;
-    case 'control.changed': node = renderControlChanged(event); break;
+    case 'control.changed': node = renderControlChanged(event); if (!replaying) ripleyMaybeReload((event.payload.files ?? []).map((file) => file.path)); break;
     case 'control.reverted': node = renderControlReverted(event); break;
     case 'mode.granted':
     case 'mode.denied': settleModeRequest(event); return;
     case 'plan.ignored': node = renderPlanIgnored(event); break;
-    case 'artifacts.created': attachArtifacts(event); return;
+    case 'artifacts.created': attachArtifacts(event); if (!replaying) ripleyMaybeReload((event.payload.files ?? []).map((file) => file.path)); return;
     case 'command.output': node = renderCommandCard(event); break;
     default: return;
   }
@@ -2224,7 +2342,8 @@ function updateCrewLabel() {
           : state.expendable ? 'CREW · EXPENDABLE ›' : 'HUMAN ›';
 }
 function updatePlaceholder() {
-  els.input.placeholder = state.mode === 3 ? PLACEHOLDERS.control : state.mode === 0 ? PLACEHOLDERS.ghost : state.create ? PLACEHOLDERS.create : (state.ashCode && state.ashCodeInstalled) ? PLACEHOLDERS.order : state.expendable ? PLACEHOLDERS.expendable : PLACEHOLDERS.plain;
+  const local = Boolean(state.agents.get(els.target.value)?.local);
+  els.input.placeholder = state.mode === 3 ? PLACEHOLDERS.control : state.mode === 0 ? PLACEHOLDERS.ghost : local ? PLACEHOLDERS.memory : state.create ? PLACEHOLDERS.create : (state.ashCode && state.ashCodeInstalled) ? PLACEHOLDERS.order : state.expendable ? PLACEHOLDERS.expendable : PLACEHOLDERS.plain;
 }
 function setOrder937(on, { wink = false } = {}) {
   state.ashCode = on;
@@ -2715,6 +2834,61 @@ function builtinCard(item) {
   for (const line of item.creates ?? []) list.append(el('li', null, line));
   for (const line of item.requires ?? []) list.append(el('li', null, `requires ${line}`));
   card.append(list);
+  if (item.id === 'ollama') {
+    const info = item.ollama ?? { running: false, models: [], settings: {} };
+    const status = el('dl', 'ollama-status');
+    const put = (k, v) => { status.append(el('dt', null, k), el('dd', null, v)); };
+    put('SERVER', info.running ? `running · ${info.host}` : 'not running');
+    put('EMBEDDINGS', info.embedModel ? `${info.embedModel}${info.settings.embeddings === false ? ' · off' : ''}` : 'no embedding model');
+    put('ARCHIVIST', info.chatModel ? `${info.chatModel}${info.settings.archivist === false ? ' · off' : ''}` : 'no chat model');
+    if (info.models?.length) put('MODELS', info.models.map((model) => model.name).join(', '));
+    card.append(status);
+    const actions = el('div', 'actions');
+    const recheck = el('button', null, 'RECHECK');
+    recheck.type = 'button';
+    recheck.addEventListener('click', async () => { recheck.disabled = true; await fetch('/api/ollama/probe', { method: 'POST' }).catch(() => null); await refreshModules(); });
+    actions.append(recheck);
+    if (info.running) {
+      const toggle = el('button', on ? null : 'primary', info.settings.enabled === false ? 'ENABLE OLLAMA' : 'DISABLE OLLAMA');
+      toggle.type = 'button';
+      toggle.addEventListener('click', async () => {
+        toggle.disabled = true;
+        try {
+          const response = await fetch('/api/extensions/ollama/install', { method: 'POST', headers: { 'content-type': 'application/json' }, body: '{}' });
+          const result = await response.json().catch(() => ({}));
+          if (!response.ok) throw new Error(result.error ?? `HTTP ${response.status}`);
+          toast(result.enabled ? 'MU/TH/UR › OLLAMA ON · memory embeds and distils on this machine.' : 'MU/TH/UR › OLLAMA OFF · back to the providers.');
+          await refreshModules();
+        } catch (error) { toast(`Ollama could not change state: ${error.message}`); toggle.disabled = false; }
+      });
+      actions.append(toggle);
+      for (const [role, model, present] of [['embeddings', item.recommended?.embed ?? 'nomic-embed-text', Boolean(info.embedModel)], ['archivist', item.recommended?.chat ?? 'qwen2.5:3b', Boolean(info.chatModel)], ['agent', item.recommended?.chat ?? 'qwen2.5:3b', Boolean(info.chatModel)]]) {
+        if (present) {
+          const box = el('label', 'toggle');
+          const input = el('input'); input.type = 'checkbox'; input.checked = info.settings[role] !== false;
+          input.addEventListener('change', async () => { input.disabled = true; await fetch('/api/ollama/settings', { method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify({ [role]: input.checked }) }).catch(() => null); await refreshModules(); });
+          box.append(input, role === 'agent' ? '@MADRE IN THE ROOM' : role.toUpperCase());
+          actions.append(box);
+        } else {
+          const pull = el('button', 'primary', `PULL ${model}`);
+          pull.type = 'button';
+          pull.title = `Download ${model} into Ollama for ${role}`;
+          pull.addEventListener('click', async () => {
+            pull.disabled = true;
+            const response = await fetch('/api/ollama/pull', { method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify({ model }) });
+            const result = await response.json().catch(() => ({}));
+            if (!response.ok) { toast(`MU/TH/UR › ${result.error ?? 'could not pull'}`); pull.disabled = false; }
+            else toast(`MU/TH/UR › pulling ${model}; progress shows in the room.`);
+          });
+          actions.append(pull);
+        }
+      }
+    } else {
+      card.append(el('p', 'confirm', 'Start Ollama (the app, or `ollama serve` in a terminal), then RECHECK. Without it the room keeps using its providers.'));
+    }
+    card.append(actions);
+    return card;
+  }
   if (item.id === 'ripley') {
     const actions = el('div', 'actions');
     const toggle = el('button', on ? null : 'primary', on ? 'DISABLE RIPLEY' : 'ENABLE RIPLEY');
@@ -3287,6 +3461,72 @@ function renderSettings() {
     save.disabled = false;
   });
   section.append(form);
+
+  // MEMORY: who distils, with whom, how often, where it embeds, how much recall a turn gets. Saves as you change it.
+  const mem = data.settings.memory;
+  if (mem) {
+    section.append(el('h3', null, `MEMORY · ${mem.stats ? `${mem.stats.entries} EXCHANGES · ${mem.stats.memories} MEMORIES · ${mem.stats.pending} WAITING` : 'NO INDEX'}`));
+    section.append(el('p', 'note', 'THE ARCHIVIST READS WHAT NOBODY HAS DISTILLED AND KEEPS THE FEW NOTES WORTH REMEMBERING. THE CHEAPEST ALLOWED AGENT GOES FIRST; A LOCAL MODEL COSTS NOTHING AND KEEPS EVERYTHING ON THIS MACHINE.'));
+    const mform = el('form', 'room-form memory-form');
+    const save = async (memoryPatch, describe) => { try { await saveSettingNow({ memory: memoryPatch }, describe); await loadSettings(); } catch (error) { toast(`Memory setting was not saved: ${error.message}`); } };
+    const field = (labelText, node) => { const label = el('label'); label.append(labelText); label.append(node); return label; };
+    const archivist = el('select');
+    for (const [value, text] of [['auto', 'AUTO · cheapest allowed'], ...mem.candidates.map((c) => [c.id, `@${c.id}${c.local ? ` · ${c.label}` : ''}`])]) { const option = el('option', null, text); option.value = value; if (value === mem.archivist) option.selected = true; archivist.append(option); }
+    archivist.addEventListener('change', () => save({ archivist: archivist.value }, archivist.value === 'auto' ? 'archivist: the cheapest allowed agent goes first.' : `archivist: @${archivist.value} distils first.`));
+    mform.append(field('ARCHIVIST', archivist));
+    const every = el('input'); every.type = 'number'; every.min = '1'; every.step = '1'; every.value = String(mem.every);
+    wireInstantNumber(every, { min: 1, toPatch: (value) => ({ memory: { every: value } }), describe: (value) => `distil every ${value} exchange${value === 1 ? '' : 's'}.` });
+    mform.append(field('DISTIL EVERY · EXCHANGES', every));
+    const idle = el('input'); idle.type = 'number'; idle.min = '1'; idle.step = '1'; idle.value = String(mem.idleMinutes);
+    wireInstantNumber(idle, { min: 1, toPatch: (value) => ({ memory: { idleMinutes: value } }), describe: (value) => `or after ${value} quiet minute${value === 1 ? '' : 's'}.` });
+    mform.append(field('OR AFTER · QUIET MINUTES', idle));
+    const share = el('input'); share.type = 'number'; share.min = '0'; share.max = '60'; share.step = '5'; share.value = String(Math.round(mem.recallShare * 100));
+    wireInstantNumber(share, { min: 0, toPatch: (value) => ({ memory: { recallShare: Math.min(60, value) / 100 } }), describe: (value) => `recall may take ${Math.min(60, value)}% of each turn's context.` });
+    mform.append(field('RECALL · % OF CONTEXT', share));
+    const embed = el('select');
+    const embedOptions = [['auto', 'AUTO · Ollama if running, else Gemini'], ['ollama', `OLLAMA · local${mem.ollama.embedModel ? ` · ${mem.ollama.embedModel}` : ' · no model yet'}`], ['gemini', 'GEMINI · needs your key'], ['off', 'OFF · words only']];
+    for (const [value, text] of embedOptions) { const option = el('option', null, text); option.value = value; if (value === (mem.embedProvider ?? data.config?.memory?.embedProvider ?? 'auto')) option.selected = true; embed.append(option); }
+    embed.addEventListener('change', () => save({ embedProvider: embed.value }, `embeddings: ${embed.options[embed.selectedIndex].textContent.toLowerCase()}.`));
+    const embedLabel = field(`EMBEDDINGS · NOW ${mem.embedder ? mem.embedder.toUpperCase() : 'OFF'}`, embed);
+    mform.append(embedLabel);
+    const who = el('div', 'full');
+    who.append(el('span', 'note', 'MAY DISTIL:'));
+    const allowed = new Set(mem.archivists ?? mem.candidates.map((c) => c.id));
+    for (const candidate of mem.candidates) {
+      const toggle = el('label', 'toggle');
+      const box = el('input'); box.type = 'checkbox'; box.checked = allowed.has(candidate.id);
+      box.addEventListener('change', () => {
+        if (box.checked) allowed.add(candidate.id); else allowed.delete(candidate.id);
+        if (!allowed.size) { box.checked = true; allowed.add(candidate.id); toast('MU/TH/UR › someone has to keep the archive.'); return; }
+        void save({ archivists: allowed.size === mem.candidates.length ? [] : [...allowed] }, `archivists: ${[...allowed].map((id) => `@${id}`).join(', ')}.`);
+      });
+      toggle.append(box, `@${candidate.id.toUpperCase()}${candidate.local ? ' · LOCAL · FREE' : ''}`);
+      who.append(toggle);
+    }
+    mform.append(who);
+    // The dataset behind MADRE AI: export what the room kept, train outside, @madre picks the result up.
+    const dataset = el('div', 'full dataset-row');
+    const exportButton = el('button', null, 'EXPORT DATASET');
+    exportButton.type = 'button';
+    exportButton.title = 'Write train.jsonl and valid.jsonl next to the ledger, redacted, in chat format for mlx-lm';
+    const datasetNote = el('span', 'note', 'LOADING…');
+    const showDataset = (payload) => {
+      const d = payload?.dataset;
+      datasetNote.textContent = d ? `${d.pairs} PAIRS · ${d.turns} TURNS · ${d.notes} NOTES · TRAIN ${d.train} · VALID ${d.valid} · ${new Date(d.exportedAt).toLocaleString()}${payload.trained ? ` · TRAINED MODEL ${payload.trained.toUpperCase()} IN USE` : ' · NO TRAINED MODEL YET · SEE docs/training'}` : 'NOT EXPORTED YET · PRESS EXPORT, THEN TRAIN WITH docs/training';
+    };
+    fetch('/api/dataset').then((response) => response.json()).then(showDataset).catch(() => { datasetNote.textContent = 'DATASET UNAVAILABLE'; });
+    exportButton.addEventListener('click', async () => {
+      exportButton.disabled = true;
+      try { const payload = await fetch('/api/dataset', { method: 'POST' }).then((response) => response.json()); showDataset(payload); toast(`MU/TH/UR › dataset exported: ${payload.dataset.pairs} pairs in ${payload.dir}`); }
+      catch (error) { toast(`Dataset export failed: ${error.message}`); }
+      finally { exportButton.disabled = false; }
+    });
+    dataset.append(exportButton, datasetNote);
+    mform.append(dataset);
+    if (mem.envWins) mform.append(el('span', 'note full', 'ENVIRONMENT VARIABLES ARE SET FOR MEMORY; THEY WIN OVER THESE VALUES ON THE NEXT LAUNCH.'));
+    mform.addEventListener('submit', (event) => event.preventDefault());
+    section.append(mform);
+  }
 }
 
 // Save one setting the moment it changes, the way the scope boxes do; the

package/public/brands.js

@@ -47,6 +47,24 @@ export const BRANDS = {
   },
 };
 
+BRANDS.madre = {
+  label: 'MADRE',
+  vendor: 'the room · local',
+  color: '#9bff66',
+  colorLight: '#2f8a1c',
+  ink: '#0a1405',
+  mark: () => glyph('<path d="M4 16 H11 L13 16 L15 9 L18 23 L20 16 L22 16 L23.5 13 L25 16 H28" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/>'),
+};
+
+BRANDS.ollama = {
+  label: 'Ollama',
+  vendor: 'local',
+  color: '#E6E6E6',
+  colorLight: '#3A3A3A',
+  ink: '#111111',
+  mark: () => glyph('<circle cx="16" cy="16" r="9" fill="none" stroke="currentColor" stroke-width="2"/><circle cx="12.5" cy="15" r="1.6" fill="currentColor"/><circle cx="19.5" cy="15" r="1.6" fill="currentColor"/>'),
+};
+
 export const fallbackBrand = (id) => ({
   label: id,
   vendor: '',

package/public/index.html

@@ -217,6 +217,10 @@
       </dialog>
       <dialog id="viewer" class="viewer" aria-label="File viewer">
         <header class="viewer-head">
+          <span class="viewer-nav" id="viewer-nav" hidden>
+            <button id="viewer-back" class="nav" type="button" title="Back to the previous page" aria-label="Back" disabled>‹</button>
+            <button id="viewer-reload" class="nav" type="button" title="Reload the page" aria-label="Reload">↻</button>
+          </span>
           <span id="viewer-path" class="viewer-path"></span>
           <span id="viewer-selection" class="viewer-selection" hidden></span>
           <button id="viewer-mode" class="viewer-review viewer-mode" type="button" hidden>SOURCE</button>
@@ -224,6 +228,7 @@
           <a id="viewer-open" class="viewer-open" target="_blank" rel="noopener noreferrer">OPEN RAW ↗</a>
           <button id="viewer-close" class="mother-close" type="button">CLOSE ×</button>
         </header>
+        <div id="viewer-errors" class="viewer-errors" hidden></div>
         <div id="viewer-body" class="viewer-body"></div>
         <div id="viewer-menu" class="viewer-menu" role="menu" hidden></div>
       </dialog>

package/public/styles.css

@@ -381,6 +381,7 @@ textarea::placeholder { color: var(--text-3); }
 .field button[type="submit"] svg { width: 18px; height: 18px; }
 .field button[type="submit"]:hover { filter: brightness(1.06); }
 .field button[type="submit"]:disabled { opacity: .4; cursor: default; box-shadow: none; }
+.pick-label .pick-note { font-family: var(--mono); font-size: 9px; letter-spacing: .14em; text-transform: uppercase; color: var(--text-3); margin-left: 4px; white-space: nowrap; }
 .safety { margin: 14px auto 18px; color: var(--text-3); font-family: var(--mono); font-size: 9.5px; letter-spacing: .08em; text-transform: uppercase; text-align: center; }
 
 /* toast */
@@ -710,6 +711,17 @@ dialog.viewer::backdrop { background: rgba(0,0,0,.7); backdrop-filter: blur(4px)
 .viewer-path { color: var(--text-2); overflow: hidden; text-overflow: ellipsis; white-space: nowrap; flex: 1; }
 .viewer-open { color: var(--phosphor); text-decoration: none; letter-spacing: .12em; font-size: 10px; }
 .viewer-body { height: calc(100% - 46px); overflow: auto; display: grid; place-items: start center; padding: 16px; }
+.viewer-nav { display: inline-flex; gap: 4px; }
+.viewer-nav .nav { width: 26px; height: 26px; display: grid; place-items: center; border: 1px solid var(--line-2); background: transparent; color: var(--text-2); border-radius: 7px; cursor: pointer; font: inherit; font-size: 14px; line-height: 1; }
+.viewer-nav .nav:hover { color: var(--text); border-color: var(--text-3); }
+.viewer-nav .nav:disabled { opacity: .35; cursor: default; }
+.viewer-errors { display: grid; gap: 6px; padding: 8px 16px; border-bottom: 1px solid color-mix(in srgb, var(--danger) 40%, transparent); background: color-mix(in srgb, var(--danger) 7%, transparent); font-family: var(--mono); font-size: 11px; }
+.viewer-errors:not([hidden]) + .viewer-body { height: auto; max-height: calc(100% - 46px); }
+.viewer-errors .err-row { display: flex; gap: 10px; align-items: center; flex-wrap: wrap; }
+.viewer-errors .msg { color: var(--danger); overflow-wrap: anywhere; }
+.viewer-errors .where { color: var(--text-3); font-size: 10px; }
+.viewer-errors button { margin-left: auto; border: 1px solid color-mix(in srgb, var(--danger) 55%, transparent); background: transparent; color: var(--danger); font: inherit; font-family: var(--mono); font-size: 9.5px; letter-spacing: .14em; padding: 3px 8px; border-radius: 6px; cursor: pointer; }
+.viewer-errors button:hover { background: color-mix(in srgb, var(--danger) 14%, transparent); }
 .viewer-body img { max-width: 100%; max-height: 100%; border-radius: 8px; }
 .viewer-body pre { margin: 0; width: 100%; font-family: var(--mono); font-size: 12.5px; line-height: 1.55; white-space: pre-wrap; overflow-wrap: anywhere; color: var(--text); }
 .viewer-body iframe { width: 100%; height: 100%; border: 0; background: #fff; border-radius: 8px; }
@@ -1018,4 +1030,12 @@ dialog.viewer::backdrop { background: rgba(0,0,0,.7); backdrop-filter: blur(4px)
 .mother-section.sentinel button { border: 1px solid var(--ph-dim); background: transparent; color: var(--ph); font: inherit; font-size: 9.5px; letter-spacing: .16em; padding: 6px 10px; cursor: pointer; }
 .mother-section.sentinel button:hover { background: var(--ph-faint); }
 .mother-section.sentinel .sentinel-report.sent { opacity: .65; }
+.settings .memory-form .toggle { display: inline-flex; align-items: center; gap: 6px; margin-right: 14px; font-size: 9.5px; letter-spacing: .14em; color: var(--ph-dim); cursor: pointer; text-transform: uppercase; }
+.settings .memory-form .toggle input { accent-color: #9bff66; width: auto; }
+.settings .memory-form .full .note { margin-right: 12px; }
+.settings .memory-form .dataset-row { display: flex; align-items: center; gap: 12px; flex-wrap: wrap; padding-top: 8px; border-top: 1px solid var(--ph-faint); }
+.module-card .ollama-status { margin: 0 0 10px; display: grid; grid-template-columns: auto 1fr; gap: 3px 12px; font-size: 10px; letter-spacing: .1em; }
+.module-card .ollama-status dt { color: var(--ph-dim); } .module-card .ollama-status dd { margin: 0; color: rgba(210, 255, 190, .85); overflow-wrap: anywhere; }
+.module-card .actions .toggle { display: inline-flex; align-items: center; gap: 6px; font-size: 9.5px; letter-spacing: .14em; color: var(--ph-dim); cursor: pointer; }
+.module-card .actions .toggle input { accent-color: #9bff66; }
 .mother-section.sentinel .note { margin: 0 0 10px; font-size: 10px; letter-spacing: .12em; line-height: 1.7; color: var(--ph-dim); }

package/public/troubleshooting.js

@@ -416,10 +416,32 @@ export const CONDITIONS = [
     severity: 'informational',
     title: 'RIPLEY: rendering HTML, SVG and Markdown in the viewer',
     match: /ripley|RIPLEY is off|renders \.html|render(ed|ing)? (the )?(html|svg|markdown)/i,
-    diagnosis: 'With RIPLEY on (MODULES), the file viewer renders .html and .svg through /api/preview inside a sealed frame (sandbox with no permissions; a policy that allows no scripts, no network, no forms, no storage) and Markdown in place; PREVIEW / SOURCE switches. Off, those files show as text with a note. 412 means RIPLEY is off; 415 means the type is not rendered (only .html, .htm, .svg; .md renders in the viewer itself). Plain /api/files always serves HTML as text.',
-    remedy: 'Enable RIPLEY in MODULES. If a page looks broken in PREVIEW it is usually because it needs scripts or external resources, which the frame forbids by design: open it with OPEN RAW in a normal tab if you trust it.',
+    diagnosis: 'With RIPLEY on (MODULES), the file viewer renders .html and .svg through /preview/project/<path> inside a sealed frame: the page\'s own scripts run, but the frame has no origin, no network, no forms and no way to reach MADRE, and it loads CSS, JS, images and fonts only from the project through MADRE. Relative links work. Markdown renders in place; PREVIEW / SOURCE switches. Off, those files show as text with a note. 412 means RIPLEY is off. Plain /api/files always serves HTML as text.',
+    remedy: 'Enable RIPLEY in MODULES. If a page looks broken in PREVIEW it is usually because it fetches something from the internet or another server, which the frame forbids by design: open it with OPEN RAW in a normal tab if you trust it.',
     fixes: same(['# MODULES → RIPLEY → ENABLE RIPLEY', '# viewer → PREVIEW / SOURCE']),
   },
+  {
+    id: 'ollama',
+    severity: 'informational',
+    title: 'Ollama: local embeddings and a local archivist',
+    match: /ollama|11434|local model|nomic-embed|qwen|llama3/i,
+    diagnosis: 'When Ollama runs on this machine with an embedding model and a chat model, MADRE embeds the memory locally (recall by meaning without any key) and distils memories with the local model first, before Gemini and the others. Nothing leaves the machine for remembering. Off or absent, everything falls back to the providers. MODULES shows what Ollama has, lets you pull the recommended models, and switches each role.',
+    remedy: 'Install Ollama (ollama.com), start it, then in MODULES press RECHECK and PULL the models it suggests. Set PULSE_OLLAMA_MODEL or PULSE_OLLAMA_EMBED_MODEL to prefer others; PULSE_EMBED_PROVIDER=gemini keeps embeddings on Gemini even with Ollama running.',
+    fixes: {
+      darwin: ['brew install ollama', 'ollama serve', 'ollama pull nomic-embed-text', 'ollama pull qwen2.5:3b'],
+      linux: ['curl -fsSL https://ollama.com/install.sh | sh', 'ollama serve', 'ollama pull nomic-embed-text', 'ollama pull qwen2.5:3b'],
+      win32: ['winget install Ollama.Ollama', 'ollama serve', 'ollama pull nomic-embed-text', 'ollama pull qwen2.5:3b'],
+    },
+  },
+  {
+    id: 'madre-agent',
+    severity: 'informational',
+    title: '@madre: the room\'s own memory, as an agent',
+    match: /@madre|madre-local|needs Ollama running with a chat model/i,
+    diagnosis: 'When Ollama runs with a chat model, a fifth agent joins the room: @madre. It answers from the whole archive (distilled notes and exact quotes, cited as [#n]) and from what the message carries, locally, for free. It never writes, draws, browses or delegates; when the room never discussed something it says so. Other agents may delegate a step to it to check what was decided. It leaves the room when Ollama stops, and MU/TH/UR says so.',
+    remedy: 'Start Ollama and PULL a chat model in MODULES → OLLAMA; the switch @MADRE IN THE ROOM turns the agent off if you do not want it. Ask it "what did we decide about …" or "did we ever discuss …".',
+    fixes: same(['ollama serve', 'ollama pull qwen2.5:3b', '@madre what did we decide about the webhook?']),
+  },
   {
     id: 'control-changes',
     severity: 'informational',

package/src/adapters/madre.mjs

@@ -0,0 +1,85 @@
+// @madre: the room's own intelligence. A local model (Ollama) that answers
+// from what the room remembers: the whole archive, not only the recent window,
+// plus the files the human points at. It never writes, never delegates, never
+// leaves the machine. It grows as the memory grows.
+
+import { ollamaGenerate } from '../ollama.mjs';
+
+export const MADRE_AGENT_ID = 'madre';
+export const MADRE_ADAPTER = 'madre-local';
+
+export function madreAgent(ollama, { enabled = true } = {}) {
+  const ready = Boolean(enabled && ollama?.running && ollama.chatModel);
+  return { id: MADRE_AGENT_ID, label: 'MADRE', detected: Boolean(ollama?.running), ready, adapter: MADRE_ADAPTER, path: null, version: ollama?.chatModel ?? null, local: true };
+}
+
+const SYSTEM = `You are @madre, the memory of this MADRE project room, running locally on this machine. You speak only for what the room has said and decided.
+Rules:
+1. Answer the question directly in the first sentence, then the supporting facts. Brief.
+2. Use only the ARCHIVE and the RECENT TRANSCRIPT you are given. Every fact taken from them ends with its sequence, like [#123].
+3. If they contain nothing on the point, say exactly that the room never discussed it, and stop. Do not guess, do not propose plans, do not invent files, decisions or dates.
+4. You cannot read or change files, run commands or browse. If that is needed, name the agent of the room that can (@codex, @claude, @gemini, @opencode).
+5. Answer in the language the human wrote in.`;
+
+// The room's briefing is written for CLIs with tools; @madre gets only what it can use:
+// the recent transcript, the archive, the question.
+export function briefingFor({ prompt, text, archive }) {
+  const transcript = prompt.match(/<context>\n([\s\S]*?)\n<\/context>/)?.[1] ?? '';
+  return [
+    transcript ? `RECENT TRANSCRIPT (oldest first):\n${transcript}` : null,
+    `ARCHIVE (what the room remembers that matches the question; notes first, then exact quotes):\n${archive || '(nothing in the archive matches this question)'}`,
+    // Small models weigh the last thing they read: the identity goes here too, after
+    // thousands of characters spoken by Claude, Codex, Gemini and OpenCode.
+    REMINDER,
+    `QUESTION FROM THE HUMAN:\n${text}`,
+  ].filter(Boolean).join('\n\n');
+}
+
+const REMINDER = `REMINDER: You are @madre, the local memory of this room. You are not Claude, Codex, Gemini or OpenCode; the quotes above are theirs, not yours. Never claim to be another assistant or company. Answer as @madre, from the archive only.`;
+
+// Orders @madre cannot carry out: convening, delegating, running, writing. They are answered
+// here, in the human's language, without calling the model. Questions pass through.
+const ACTION_ES = /(^|[\s,.;:!¡])(convoca|convócalos|convócala|reúne|reune|delega|coordina|pídele|pidele|pídeles|pideles|dile|diles|ordena|manda|envía|envia|ejecuta|corre|instala|implementa|refactoriza|despliega|escribe|crea|modifica|edita|borra|elimina|genera|haz|hazlo|realiza|lanza|arranca|reinicia|configura|publica|sube)\b/i;
+const ACTION_EN = /(^|[\s,.;:!])(convene|summon|gather|schedule|delegate|coordinate|ask @|tell @|order|run|execute|install|implement|refactor|deploy|write|create|modify|edit|delete|remove|generate|build|commit|push|publish|launch|restart|configure|make (?:a|the|it)|call a meeting|set up)\b/i;
+const QUESTION = /[?¿]|(^|[^\p{L}])(qué|cuál|cuáles|cuándo|dónde|quién|quiénes|cómo|por qué|what|which|when|where|who|how|why|did|do we|have we|is there)(?!\p{L})/iu;
+const SPANISH = /[áéíóúñ¿¡]|\b(el|la|los|las|una?|que|para|con|de|todos|reunión|reunion)\b/i;
+
+export function actionRequest(text = '') {
+  const body = String(text).trim().replace(/^@?madre[,:]?\s*/i, '').replace(/^\p{L}+,\s*/u, '');
+  if (!body || QUESTION.test(body)) return null;
+  if (!ACTION_ES.test(body) && !ACTION_EN.test(body)) return null;
+  return SPANISH.test(body)
+    ? 'Solo respondo desde la memoria de la sala: no convoco, no delego, no ejecuto ni escribo. Para eso escríbele a @codex, @claude, @gemini u @opencode, los que estén en la fila. Si quieres, pregúntame qué recuerda la sala sobre esto y te lo cito.'
+    : 'I only answer from the room\'s memory: I do not convene, delegate, run or write. For that, write to @codex, @claude, @gemini or @opencode, whichever is in the row. If you like, ask me what the room remembers about this and I will quote it.';
+}
+
+const NO_USAGE = { inputTokens: 0, outputTokens: 0, cachedInputTokens: 0, reasoningTokens: 0, totalTokens: 0, costUsd: 0, source: 'madre', local: true };
+
+// What the whole archive says about this request: notes first, then exact quotes.
+export async function gather(memory, text, { maxChars = 7000 } = {}) {
+  if (!memory) return { notes: [], quotes: [], text: '' };
+  const queryVector = await memory.embedQuery(text);
+  const notes = memory.recallMemories(text, { limit: 12, maxChars: Math.floor(maxChars * 0.35), queryVector, fallback: false });
+  const spent = notes.reduce((sum, note) => sum + note.text.length + 24, 0);
+  const recall = memory.recall(text, { limit: 12, maxChars: maxChars - spent, excerptChars: 420, queryVector });
+  const lines = [
+    ...notes.map((note) => `- [note · ${note.kind} · #${note.fromSequence}–#${note.throughSequence}] ${note.text}`),
+    ...recall.entries.map((entry) => `[#${entry.sequence} · ${(entry.timestamp ?? '').slice(0, 16).replace('T', ' ')} · ${entry.role === 'command' ? entry.sender : `@${entry.sender}`}] ${entry.excerpt}`),
+  ];
+  return { notes, quotes: recall.entries, text: lines.join('\n') };
+}
+
+// The invoker the room calls like any adapter. `text` is the human's request; `prompt` the room's full briefing.
+export function madreInvoker({ memory, ollama, fetchImpl = globalThis.fetch }) {
+  return async ({ prompt, text = '', timeoutMs = 180000, model = null }) => {
+    const state = typeof ollama === 'function' ? ollama() : ollama;
+    if (!state?.running || !state.chatModel) throw new Error('@madre needs Ollama running with a chat model. Open MODULES → OLLAMA.');
+    const question = text || prompt.match(/User message: ([\s\S]*)$/)?.[1] || prompt.slice(-2000);
+    const declined = actionRequest(question);
+    if (declined) return { text: declined, usage: { ...NO_USAGE }, grounded: { notes: 0, quotes: 0 }, declined: 'action' };
+    const archive = await gather(memory, question);
+    const briefing = briefingFor({ prompt, text: question, archive: archive.text });
+    const answer = await ollamaGenerate({ host: state.host, model: model ?? state.chatModel, system: SYSTEM, prompt: briefing, fetchImpl, timeoutMs, temperature: 0.1 });
+    return { text: answer.text, usage: { ...answer.usage, local: true }, grounded: { notes: archive.notes.length, quotes: archive.quotes.length } };
+  };
+}

package/src/auth-probe.mjs

@@ -129,6 +129,7 @@ export function loginPlanFor(agent) {
 }
 
 export async function probeAgentAuth(agent) {
+  if (agent.id === 'madre') return agent.ready ? { state: 'signed-in', detail: `local · ${agent.version ?? 'Ollama'}` } : { state: 'signed-out', detail: 'Ollama is not running or has no chat model' };
   if (!agent.detected || !agent.path) return { state: 'not-installed', detail: 'not found on this computer' };
   switch (agent.id) {
     case 'codex': return parseCodexLoginStatus(await run(agent.path, ['login', 'status']));

package/src/capabilities.mjs

@@ -10,6 +10,7 @@
 //   imageGen   generate images (Codex: image_generation feature via ChatGPT)
 //   web        fetch or search the web (denied by default in consultation mode)
 
+// @madre, the room's local memory agent, is not a CLI: capabilityOf gives it the read-only profile.
 export const CAPABILITIES = {
   codex: {
     read: true,