amalgm 0.1.143 → 0.1.144

package/runtime/scripts/amalgm-mcp/lib/email-md.js

@@ -20,30 +20,16 @@
 const embeds = require('./email-embeds');
 const { buildEmailRenderContext, normalizeEmailLink } = require('./email-deeplinks');
 
-const EMAIL_TOKENS = {
-  font: {
-    text: "'SF Pro Text',-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,'Helvetica Neue',sans-serif",
-    mono: "'JetBrains Mono','SF Mono',SFMono-Regular,Menlo,Consolas,monospace",
-  },
-  type: {
-    body: 14,
-    // h1 caps at the section-header size; h4-h6 share the body size.
-    headings: { 1: 18, 2: 16, 3: 15, 4: 14, 5: 14, 6: 14 },
-    code: 12,
-    table: 14,
-  },
-  color: {
-    text: '#ffffff',
-    textSecondary: '#d6d3d1',
-    border: '#1c1917', // stone-900 — container borders
-    tableBorder: '#292524', // stone-800 — table grid (Notion editor standard)
-    tableHeaderBg: '#141210', // stone-925 — Notion editor header row
-    bg: '#000000',
-    bgInset: '#0a0a0a', // inline-code fill
-    link: '#60a5fa', // blue-400 — hyperlinks + citations everywhere
-  },
-  radius: { inline: 6, block: 12 },
-};
+// GENERATED from lib/rendering/tokens.ts by
+// scripts/amalgm-mcp/generate-email-render-assets.mts — the deterministic
+// adapter. There is no hand-mirrored token copy anymore; change tokens.ts
+// (or Citation.tsx for the templates below) and regenerate.
+const RENDER_ASSETS = require('./generated/email-render.json');
+const EMAIL_TOKENS = RENDER_ASSETS.tokens;
+const TEMPLATES = RENDER_ASSETS.templates;
+// Markdown block metrics — the same values app/generated/markdown-surface.css
+// is generated from, so blocks land at identical positions in both surfaces.
+const BLOCKS = RENDER_ASSETS.blocks;
 
 function escapeHtmlAttr(value) {
   return String(value)
@@ -74,14 +60,57 @@ function parseStandaloneMediaLine(line) {
   return { alt: match[1], src, title };
 }
 
+/**
+ * Fill an SSR'd citation template (the real <Citation> component, rendered at
+ * asset-generation time with __PLACEHOLDER__ values). label/href/title are
+ * escaped here; icon is trusted HTML (a cid: <img> or favicon <img>).
+ */
+function fillCitationTemplate(template, { label, href, title, iconHtml }) {
+  let html = template;
+  html = title
+    ? html.replace('__TITLE__', escapeHtmlAttr(title))
+    : html.replace(' title="__TITLE__"', '');
+  if (href !== undefined) html = html.replace('__HREF__', escapeHtmlAttr(href));
+  if (iconHtml !== undefined) html = html.replace('__ICON__', iconHtml);
+  return html.replace('__LABEL__', escapeHtmlText(label));
+}
+
 // Inline citation for amalgm:// references (files, folders, skills, agents).
-// Codex-style: plain blue text at the surrounding font size — no chip.
-// Non-clickable in email (local resources can't open from a mail client);
-// the optional description survives as a title tooltip.
-function renderAmalgmCitation(label, _kindAndPath, description) {
-  const titleAttr = description ? ` title="${escapeHtmlAttr(description)}"` : '';
-  const safeLabel = escapeHtmlText(label);
-  return `<span style="color:${EMAIL_TOKENS.color.link};white-space:nowrap"${titleAttr}>${safeLabel}</span>`;
+// Same visual as the app: blue inline text led by the file-type icon (CID
+// PNG raster of the same registry glyph the app shows). Non-clickable in
+// email (local resources can't open from a mail client); the optional
+// description survives as a title tooltip.
+function renderAmalgmCitation(label, kindAndPath, description) {
+  const kind = String(kindAndPath || '').split('/')[0].toLowerCase();
+  let descriptor = null;
+  if (kind === 'file') descriptor = embeds.resolveFileIconDescriptor(label);
+  else if (kind === 'folder') descriptor = embeds.resolveFileIconDescriptor('', { isDirectory: true });
+  else if (kind === 'skill') descriptor = embeds.resolveFileIconDescriptor('', { isSkill: true });
+  else if (kind === 'agent') descriptor = embeds.resolveEntityIconDescriptor('agent');
+  if (!descriptor) {
+    return fillCitationTemplate(TEMPLATES.citationText, { label, title: description });
+  }
+  return fillCitationTemplate(TEMPLATES.citationTextWithIcon, {
+    label,
+    title: description,
+    iconHtml: embeds.citationIconHtml(descriptor),
+  });
+}
+
+/** Web hyperlink as the app renders it: favicon + blue label (Citation + WebFavicon). */
+function renderWebCitation(label, href) {
+  let domain = '';
+  try {
+    domain = new URL(href).hostname;
+  } catch {
+    domain = '';
+  }
+  if (!domain) {
+    return fillCitationTemplate(TEMPLATES.citationLink, { label, href });
+  }
+  const size = RENDER_ASSETS.chrome.citationIconSize;
+  const favicon = `<img src="https://www.google.com/s2/favicons?domain=${escapeHtmlAttr(domain)}&amp;sz=32" alt="" width="${size}" height="${size}" style="display:inline-block;width:${size}px;height:${size}px;border:0;border-radius:3px;vertical-align:-1px">`;
+  return fillCitationTemplate(TEMPLATES.citationLinkWithIcon, { label, href, iconHtml: favicon });
 }
 
 /**
@@ -124,12 +153,12 @@ function inlineFormat(text, renderContext = {}) {
         (_, label, kindAndPath, description) =>
           renderAmalgmCitation(label, kindAndPath, description),
       )
-      // Links: [text](url) — blue hyperlink per the rendering ruleset.
+      // Links: [text](url) — the app's web citation: favicon + blue label.
       .replace(
         /\[([^\]]+)\]\(([^)]+)\)/g,
         (_, label, url) => {
           const href = normalizeEmailLink(url, renderContext.appOrigin) || url;
-          return `<a href="${escapeHtmlAttr(href)}" style="color:${EMAIL_TOKENS.color.link};text-decoration:none" target="_blank">${escapeHtmlText(label)}</a>`;
+          return renderWebCitation(label, href);
         },
       )
       // Bold + italic: ***text***
@@ -145,7 +174,7 @@ function inlineFormat(text, renderContext = {}) {
       // Inline code: `text`
       .replace(
         /`([^`]+)`/g,
-        `<code style="background:${EMAIL_TOKENS.color.bgInset};border:1px solid ${EMAIL_TOKENS.color.border};padding:2px 6px;border-radius:${EMAIL_TOKENS.radius.inline}px;font-size:${EMAIL_TOKENS.type.code}px;font-family:${EMAIL_TOKENS.font.mono};color:#f5f5f4">$1</code>`,
+        `<code style="background:${BLOCKS.codeInline.bg};border:1px solid ${BLOCKS.codeInline.border};padding:${BLOCKS.codeInline.paddingY}px ${BLOCKS.codeInline.paddingX}px;border-radius:${BLOCKS.codeInline.radius}px;font-size:${BLOCKS.codeInline.size}px;line-height:${BLOCKS.codeInline.lineHeight};font-family:${EMAIL_TOKENS.font.mono};color:${BLOCKS.codeInline.color}">$1</code>`,
       )
   );
 }
@@ -157,12 +186,18 @@ function markdownToEmailHtml(md, renderContextInput = {}) {
   text = text.replace(/\\n/g, '\n');
 
   // Extract fenced code blocks first so line parser doesn't touch them.
+  // Chrome mirrors the chat CodeBlock: rounded card with a language header
+  // bar (the copy/download controls are app-only interactivity).
   const codeBlocks = [];
-  text = text.replace(/```(\w*)\n([\s\S]*?)```/g, (_, _lang, code) => {
+  text = text.replace(/```(\w*)\n([\s\S]*?)```/g, (_, lang, code) => {
     const escaped = code.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
     const placeholder = `%%CODEBLOCK_${codeBlocks.length}%%`;
+    const B = BLOCKS.codeBlock;
     codeBlocks.push(
-      `<pre style="background:${EMAIL_TOKENS.color.bg};border:1px solid ${EMAIL_TOKENS.color.border};border-radius:${EMAIL_TOKENS.radius.block}px;padding:16px;font-size:${EMAIL_TOKENS.type.code}px;font-family:${EMAIL_TOKENS.font.mono};color:#f5f5f4;overflow-x:auto;margin:16px 0;line-height:1.6"><code>${escaped.trimEnd()}</code></pre>`,
+      `<div style="background:${B.bg};border:1px solid ${B.border};border-radius:${B.radius}px;overflow:hidden;margin:0">` +
+        `<div style="padding:${B.header.paddingY}px ${B.header.paddingX}px;border-bottom:1px solid ${B.border};font-size:${B.header.size}px;color:${B.header.color};font-family:${EMAIL_TOKENS.font.mono};text-transform:lowercase">${escapeHtmlText(lang || 'text')}</div>` +
+        `<pre style="background:${B.bg};padding:${B.padding}px;font-size:${B.size}px;font-family:${EMAIL_TOKENS.font.mono};color:${EMAIL_TOKENS.color.text};overflow-x:auto;margin:0;line-height:${B.lineHeight}"><code>${escaped.trimEnd()}</code></pre>` +
+        `</div>`,
     );
     return placeholder;
   });
@@ -178,18 +213,21 @@ function markdownToEmailHtml(md, renderContextInput = {}) {
 
   function flushPara() {
     if (!paraLines.length) return;
-    const content = inlineFormat(paraLines.join('\n'), renderContext).replace(/\n/g, '<br>');
-    out.push(`<p style="margin:12px 0;line-height:1.7;color:#ffffff">${content}</p>`);
+    // Soft line breaks collapse to spaces, like the app's markdown pipeline.
+    const content = inlineFormat(paraLines.join(' '), renderContext);
+    out.push(
+      `<p style="margin:0;line-height:${BLOCKS.paragraph.lineHeight};color:${EMAIL_TOKENS.color.text}">${content}</p>`,
+    );
     paraLines = [];
   }
   function flushList() {
     if (!listItems.length) return;
     const tag = listType;
     const items = listItems
-      .map((t) => `<li style="margin:4px 0;color:#ffffff">${inlineFormat(t, renderContext)}</li>`)
+      .map((t) => `<li style="margin:${BLOCKS.list.itemMarginY}px 0;padding:${BLOCKS.list.itemPaddingY}px 0;line-height:${BLOCKS.list.itemLineHeight};color:${EMAIL_TOKENS.color.text}">${inlineFormat(t, renderContext)}</li>`)
       .join('');
     out.push(
-      `<${tag} style="margin:12px 0;padding-left:24px;color:#ffffff">${items}</${tag}>`,
+      `<${tag} style="margin:0;padding-left:${BLOCKS.list.paddingLeft}px;color:${EMAIL_TOKENS.color.text}">${items}</${tag}>`,
     );
     listItems = [];
     listType = '';
@@ -204,8 +242,8 @@ function markdownToEmailHtml(md, renderContextInput = {}) {
     // stone-925 header row, px-3 py-1.5 cells, 14px text, wrapped in the
     // same rounded-xl (12px) chrome as code blocks. The wrapper draws the
     // outer border, so cells only draw their inner right/bottom edges.
-    const cellBase = `padding:6px 12px;text-align:left;vertical-align:top;font-size:${EMAIL_TOKENS.type.table}px`;
-    const edge = `1px solid ${EMAIL_TOKENS.color.tableBorder}`;
+    const cellBase = `padding:${BLOCKS.table.cellPaddingY}px ${BLOCKS.table.cellPaddingX}px;text-align:left;vertical-align:top;font-size:${BLOCKS.table.size}px;line-height:${BLOCKS.table.cellLineHeight}`;
+    const edge = `1px solid ${BLOCKS.table.gridColor}`;
     const cellBorders = (isLastCol, isLastRow) =>
       `${isLastCol ? '' : `border-right:${edge};`}${isLastRow ? '' : `border-bottom:${edge};`}`;
     const headerCells = tableRows[0].cells;
@@ -213,7 +251,7 @@ function markdownToEmailHtml(md, renderContextInput = {}) {
     const hdr = headerCells
       .map(
         (c, i) =>
-          `<th style="${cellBase};${cellBorders(i === headerCells.length - 1, false)}background:${EMAIL_TOKENS.color.tableHeaderBg};font-weight:500;color:#ffffff">${inlineFormat(c, renderContext)}</th>`,
+          `<th style="${cellBase};${cellBorders(i === headerCells.length - 1, false)}background:${BLOCKS.table.headerBgEmail};font-weight:${BLOCKS.table.headerWeight};color:${EMAIL_TOKENS.color.text}">${inlineFormat(c, renderContext)}</th>`,
       )
       .join('');
     const body = bodyRows
@@ -230,15 +268,16 @@ function markdownToEmailHtml(md, renderContextInput = {}) {
       )
       .join('');
     out.push(
-      `<div style="border:${edge};border-radius:12px;overflow:hidden;margin:16px 0"><table style="width:100%;border-collapse:collapse"><thead><tr>${hdr}</tr></thead><tbody>${body}</tbody></table></div>`,
+      `<div style="border:${edge};border-radius:${BLOCKS.table.radius}px;overflow:hidden;margin:0"><table style="width:100%;border-collapse:collapse"><thead><tr>${hdr}</tr></thead><tbody>${body}</tbody></table></div>`,
     );
     tableRows = [];
   }
   function flushQuote() {
     if (!quoteLines.length) return;
-    const content = inlineFormat(quoteLines.join('\n'), renderContext).replace(/\n/g, '<br>');
+    // Soft line breaks collapse to spaces, like the app's markdown pipeline.
+    const content = inlineFormat(quoteLines.join(' '), renderContext);
     out.push(
-      `<blockquote style="margin:16px 0;padding:8px 16px;border-left:3px solid ${EMAIL_TOKENS.color.tableBorder};color:${EMAIL_TOKENS.color.textSecondary};font-style:italic">${content}</blockquote>`,
+      `<blockquote style="margin:0;line-height:${BLOCKS.blockquote.lineHeight};${BLOCKS.blockquote.italic ? 'font-style:italic;' : ''}padding:0 0 0 ${BLOCKS.blockquote.paddingLeft}px;border-left:${BLOCKS.blockquote.borderWidth}px solid ${BLOCKS.blockquote.borderColor};color:${BLOCKS.blockquote.color}">${content}</blockquote>`,
     );
     quoteLines = [];
   }
@@ -272,7 +311,7 @@ function markdownToEmailHtml(md, renderContextInput = {}) {
     }
     if (/^(-{3,}|_{3,}|\*{3,})$/.test(trimmed)) {
       flushAll();
-      out.push(`<hr style="border:none;border-top:1px solid ${EMAIL_TOKENS.color.border};margin:24px 0">`);
+      out.push(`<hr style="border:none;border-top:1px solid ${BLOCKS.hr.color};margin:0">`);
       continue;
     }
     // Standalone media line → block embed (image bare, video in the
@@ -295,9 +334,9 @@ function markdownToEmailHtml(md, renderContextInput = {}) {
     if (headingMatch) {
       flushAll();
       const level = headingMatch[1].length;
-      const size = EMAIL_TOKENS.type.headings[level];
+      const spec = BLOCKS.heading[`h${Math.min(level, 4)}`];
       out.push(
-        `<h${level} style="margin:20px 0 8px;font-size:${size}px;font-weight:650;color:#ffffff;line-height:1.35">${inlineFormat(headingMatch[2], renderContext)}</h${level}>`,
+        `<h${level} style="margin:0;font-size:${spec.size}px;font-weight:${BLOCKS.heading.weight};color:${EMAIL_TOKENS.color.text};line-height:${BLOCKS.heading.lineHeight}">${inlineFormat(headingMatch[2], renderContext)}</h${level}>`,
       );
       continue;
     }
@@ -349,7 +388,12 @@ function markdownToEmailHtml(md, renderContextInput = {}) {
   }
 
   flushAll();
-  return out.join('\n');
+  // Uniform gap between top-level blocks — the chat surface's Streamdown
+  // container applies space-y (15px at the app root font-size) with the
+  // first child's top margin removed; individual blocks carry margin:0.
+  return out
+    .map((html, index) => (index === 0 ? html : `<div style="margin:${BLOCKS.blockGap}px 0 0">${html}</div>`))
+    .join('\n');
 }
 
 /**
@@ -363,7 +407,7 @@ function formatNotificationEmail(message, link, renderContextInput = {}) {
     : '';
   return `<!DOCTYPE html>
 <html><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"></head>
-<body style="margin:0;padding:0;background:#000000;font-family:${EMAIL_TOKENS.font.text};-webkit-font-smoothing:antialiased">
+<body style="margin:0;padding:0;background:#000000;font-family:${EMAIL_TOKENS.font.text}">
 <table role="presentation" width="100%" cellpadding="0" cellspacing="0" style="background:#000000"><tr><td align="center" style="padding:0">
   <table role="presentation" width="520" cellpadding="0" cellspacing="0" style="max-width:520px;width:100%"><tr><td style="padding:40px 28px 48px">
     <div style="font-size:${EMAIL_TOKENS.type.body}px;color:#ffffff">${htmlMessage}</div>

package/runtime/scripts/amalgm-mcp/lib/file-icon-registry.json

@@ -14,9 +14,10 @@
       "color": "#d6d3d1"
     },
     "skill": {
-      "kind": "skill",
-      "colorClass": "text-violet-400",
-      "color": "#a78bfa"
+      "kind": "lucide",
+      "name": "Box",
+      "colorClass": "text-stone-300",
+      "color": "#d6d3d1"
     }
   },
   "extensionIcons": {
@@ -418,6 +419,126 @@
       "name": "FileArchive",
       "colorClass": "text-yellow-400",
       "color": "#facc15"
+    },
+    "pptx": {
+      "kind": "letter",
+      "letters": "P",
+      "bg": "#D24726",
+      "fg": "#ffffff"
+    },
+    "ppt": {
+      "kind": "letter",
+      "letters": "P",
+      "bg": "#D24726",
+      "fg": "#ffffff"
+    },
+    "ipynb": {
+      "kind": "letter",
+      "letters": "Nb",
+      "bg": "#F37626",
+      "fg": "#ffffff"
+    },
+    "ttf": {
+      "kind": "letter",
+      "letters": "Aa",
+      "bg": "#57534E",
+      "fg": "#ffffff"
+    },
+    "otf": {
+      "kind": "letter",
+      "letters": "Aa",
+      "bg": "#57534E",
+      "fg": "#ffffff"
+    },
+    "woff": {
+      "kind": "letter",
+      "letters": "Aa",
+      "bg": "#57534E",
+      "fg": "#ffffff"
+    },
+    "woff2": {
+      "kind": "letter",
+      "letters": "Aa",
+      "bg": "#57534E",
+      "fg": "#ffffff"
+    },
+    "m4a": {
+      "kind": "lucide",
+      "name": "Music",
+      "colorClass": "text-pink-400",
+      "color": "#f472b6"
+    },
+    "flac": {
+      "kind": "lucide",
+      "name": "Music",
+      "colorClass": "text-pink-400",
+      "color": "#f472b6"
+    },
+    "ogg": {
+      "kind": "lucide",
+      "name": "Music",
+      "colorClass": "text-pink-400",
+      "color": "#f472b6"
+    },
+    "aac": {
+      "kind": "lucide",
+      "name": "Music",
+      "colorClass": "text-pink-400",
+      "color": "#f472b6"
+    },
+    "opus": {
+      "kind": "lucide",
+      "name": "Music",
+      "colorClass": "text-pink-400",
+      "color": "#f472b6"
+    },
+    "avif": {
+      "kind": "lucide",
+      "name": "FileImage",
+      "colorClass": "text-purple-400",
+      "color": "#c084fc"
+    },
+    "bmp": {
+      "kind": "lucide",
+      "name": "FileImage",
+      "colorClass": "text-purple-400",
+      "color": "#c084fc"
+    },
+    "avi": {
+      "kind": "lucide",
+      "name": "Video",
+      "colorClass": "text-pink-400",
+      "color": "#f472b6"
+    },
+    "ogv": {
+      "kind": "lucide",
+      "name": "Video",
+      "colorClass": "text-pink-400",
+      "color": "#f472b6"
+    },
+    "jsonl": {
+      "kind": "lucide",
+      "name": "Braces",
+      "colorClass": "text-yellow-400",
+      "color": "#facc15"
+    },
+    "ndjson": {
+      "kind": "lucide",
+      "name": "Braces",
+      "colorClass": "text-yellow-400",
+      "color": "#facc15"
+    },
+    "diff": {
+      "kind": "lucide",
+      "name": "FileText",
+      "colorClass": "text-stone-400",
+      "color": "#a8a29e"
+    },
+    "patch": {
+      "kind": "lucide",
+      "name": "FileText",
+      "colorClass": "text-stone-400",
+      "color": "#a8a29e"
     }
   },
   "specialFilenameIcons": [
@@ -553,6 +674,12 @@
       "name": "Box",
       "colorClass": "text-white",
       "color": "#ffffff"
+    },
+    "agent": {
+      "kind": "lucide",
+      "name": "AtSign",
+      "colorClass": "text-white",
+      "color": "#ffffff"
     }
   },
   "lucideNodes": {
@@ -990,6 +1117,22 @@
           "d": "M4 14a1 1 0 0 1-.78-1.63l9.9-10.2a.5.5 0 0 1 .86.46l-1.92 6.02A1 1 0 0 0 13 10h7a1 1 0 0 1 .78 1.63l-9.9 10.2a.5.5 0 0 1-.86-.46l1.92-6.02A1 1 0 0 0 11 14z"
         }
       ]
+    ],
+    "AtSign": [
+      [
+        "circle",
+        {
+          "cx": "12",
+          "cy": "12",
+          "r": "4"
+        }
+      ],
+      [
+        "path",
+        {
+          "d": "M16 8v5a3 3 0 0 0 6 0v-1a10 10 0 1 0-4 8"
+        }
+      ]
     ]
   }
 }

package/runtime/scripts/amalgm-mcp/lib/generated/email-render.json

@@ -0,0 +1,153 @@
+{
+  "//": "GENERATED by scripts/amalgm-mcp/generate-email-render-assets.mts — do not edit.",
+  "version": 1,
+  "tokens": {
+    "font": {
+      "text": "\"SF Pro Text\", \"SF Pro Display\", -apple-system, BlinkMacSystemFont, system-ui, sans-serif",
+      "mono": "'JetBrains Mono', 'SFMono-Regular', Menlo, monospace"
+    },
+    "type": {
+      "body": 14,
+      "headings": {
+        "1": 18,
+        "2": 16,
+        "3": 15,
+        "4": 14,
+        "5": 14,
+        "6": 14
+      },
+      "code": 12,
+      "table": 14
+    },
+    "color": {
+      "text": "#ffffff",
+      "textSecondary": "#d6d3d1",
+      "textMuted": "#a8a29e",
+      "faint": "#57534e",
+      "border": "#1c1917",
+      "tableBorder": "#292524",
+      "tableHeaderBg": "#141210",
+      "bg": "#000000",
+      "bgInset": "#0a0a0a",
+      "bgChip": "#0c0a09",
+      "link": "#60a5fa",
+      "linkHover": "#93c5fd"
+    },
+    "radius": {
+      "inline": 6,
+      "block": 12,
+      "embed": 16
+    }
+  },
+  "chrome": {
+    "pillTableCss": "display:inline-table;height:32px;background:#0c0a09;border:1px solid #292524;border-radius:12px;border-collapse:separate;box-shadow:0 25px 50px -12px rgba(0,0,0,0.25)",
+    "pillHeight": 32,
+    "pillFontSize": 13,
+    "pillIconSize": 14,
+    "pillPaddingX": 12,
+    "pillGap": 8,
+    "pillText": "#ffffff",
+    "frameCss": "border:1px solid #292524;border-radius:16px;background:#000000;margin:0;overflow:hidden",
+    "frameBg": "#000000",
+    "entityTileCss": "text-decoration:none;display:inline-block;background:#000000;border:1px solid #1c1917;border-radius:12px;padding:8px 12px;margin:2px 0;vertical-align:middle",
+    "entityTileFontSize": 14,
+    "entityTileFontWeight": 650,
+    "entityTileIconSize": 14,
+    "entityTileText": "#ffffff",
+    "citationIconSize": 12
+  },
+  "blocks": {
+    "blockGap": 15,
+    "heading": {
+      "lineHeight": 1.35,
+      "weight": 650,
+      "h1": {
+        "size": 18,
+        "marginTop": 20,
+        "marginBottom": 8
+      },
+      "h2": {
+        "size": 16,
+        "marginTop": 18,
+        "marginBottom": 6
+      },
+      "h3": {
+        "size": 15,
+        "marginTop": 16,
+        "marginBottom": 6
+      },
+      "h4": {
+        "size": 14,
+        "marginTop": 14,
+        "marginBottom": 4
+      }
+    },
+    "paragraph": {
+      "lineHeight": 1.75,
+      "marginY": 4
+    },
+    "list": {
+      "marginY": 8,
+      "paddingLeft": 24,
+      "itemMarginY": 4,
+      "itemLineHeight": 1.5,
+      "itemPaddingY": 3.75
+    },
+    "blockquote": {
+      "marginY": 14,
+      "borderWidth": 3,
+      "borderColor": "#292524",
+      "paddingLeft": 16,
+      "color": "#d6d3d1",
+      "italic": true,
+      "lineHeight": 1.75
+    },
+    "codeInline": {
+      "size": 12,
+      "lineHeight": 1.2,
+      "radius": 5.625,
+      "border": "#1c1917",
+      "bg": "#0a0a0a",
+      "color": "#f5f5f4",
+      "paddingX": 7.5,
+      "paddingY": 1.875
+    },
+    "codeBlock": {
+      "size": 12,
+      "lineHeight": 1.6,
+      "marginY": 16,
+      "radius": 12,
+      "border": "#1c1917",
+      "bg": "#000000",
+      "padding": 15,
+      "header": {
+        "paddingX": 15,
+        "paddingY": 7.5,
+        "size": 11.25,
+        "color": "#a8a29e"
+      }
+    },
+    "table": {
+      "size": 14,
+      "marginY": 16,
+      "radius": 12,
+      "gridColor": "#292524",
+      "headerBg": "rgb(20 18 16 / 0.6)",
+      "headerWeight": 500,
+      "cellPaddingX": 11.25,
+      "cellPaddingY": 5.625,
+      "cellLineHeight": 1.5,
+      "headerBgEmail": "#0c0b0a"
+    },
+    "hr": {
+      "color": "#1c1917",
+      "marginY": 24
+    }
+  },
+  "templates": {
+    "citationLink": "<a href=\"__HREF__\" target=\"_blank\" rel=\"noreferrer\" title=\"__TITLE__\" class=\"render-citation\" style=\"display:inline;vertical-align:baseline;font:inherit;font-size:inherit;line-height:inherit;color:#60a5fa;text-decoration:none;white-space:nowrap;padding:0;background:transparent;border:none;\">__LABEL__</a>",
+    "citationLinkWithIcon": "<a href=\"__HREF__\" target=\"_blank\" rel=\"noreferrer\" title=\"__TITLE__\" class=\"render-citation\" style=\"display:inline;vertical-align:baseline;font:inherit;font-size:inherit;line-height:inherit;color:#60a5fa;text-decoration:none;white-space:nowrap;padding:0;background:transparent;border:none;\"><span style=\"display:inline-block;width:12px;height:12px;font-size:12px;line-height:12px;margin-right:0.3em;vertical-align:middle\">__ICON__</span>__LABEL__</a>",
+    "citationText": "<span title=\"__TITLE__\" class=\"render-citation\" style=\"display:inline;vertical-align:baseline;font:inherit;font-size:inherit;line-height:inherit;color:#60a5fa;text-decoration:none;white-space:nowrap;padding:0;background:transparent;border:none;\">__LABEL__</span>",
+    "citationTextWithIcon": "<span title=\"__TITLE__\" class=\"render-citation\" style=\"display:inline;vertical-align:baseline;font:inherit;font-size:inherit;line-height:inherit;color:#60a5fa;text-decoration:none;white-space:nowrap;padding:0;background:transparent;border:none;\"><span style=\"display:inline-block;width:12px;height:12px;font-size:12px;line-height:12px;margin-right:0.3em;vertical-align:middle\">__ICON__</span>__LABEL__</span>"
+  }
+}

package/runtime/scripts/amalgm-mcp/notify/index.js

@@ -9,7 +9,7 @@
 const { PROXY_BASE_URL, PROXY_TOKEN } = require('../config');
 const { ensureFreshProxyToken, readProxyToken } = require('../../proxy-token-store');
 const { formatNotificationEmail } = require('../lib/email-md');
-const { prepareEmailIconAttachments } = require('../lib/email-icons');
+const { prepareEmailIconAttachments, stripUnattachedIconImages } = require('../lib/email-icons');
 const { prepareEmailMedia } = require('./email-media');
 const { textResult, errorResult } = require('../lib/tool-result');
 
@@ -32,11 +32,14 @@ async function notifyUserViaProxy({ subject: customSubject, message, link, sessi
   // Local media embeds become attachments riding inside the email: images
   // inline via cid:, videos as regular attachments with a poster card.
   const media = prepareEmailMedia(message);
-  const html = formatNotificationEmail(media.message, link || null, { sessionId });
+  let html = formatNotificationEmail(media.message, link || null, { sessionId });
   const attachments = [
     ...media.attachments,
     ...prepareEmailIconAttachments(html, media.attachments),
   ];
+  // Icons that didn't fit the attachment budget degrade to plain text
+  // instead of broken-image boxes.
+  html = stripUnattachedIconImages(html, attachments);
 
   try {
     const res = await fetch(notifyUrl, {

package/runtime/scripts/amalgm-mcp/server/core-tools.js

@@ -58,6 +58,12 @@ const CORE_TOOL_GROUPS = [
     'Register, run, and route local-first Amalgm apps.',
     require('../apps/tools'),
   ),
+  group(
+    'computer-use',
+    'Computer Use',
+    require('../computer-use').DESCRIPTION,
+    require('../computer-use'),
+  ),
   // Browser is ONE toolbox entry. Users enable/disable it per agent as a
   // single tool; fine-grained control stays available because loadouts can
   // hold individual action ids (`browser.cua_click`). Action list, capability

package/runtime/scripts/amalgm-mcp/server/routes/apps.js

@@ -45,6 +45,10 @@ async function handleAppRoutes(ctx) {
     await appsRest.handleDelete(await ctx.readJsonBody(), ctx.sendJson, options);
     return true;
   }
+  if (route.path === '/update' && ctx.method === 'POST') {
+    await appsRest.handleUpdate(await ctx.readJsonBody(), ctx.sendJson, options);
+    return true;
+  }
   if (route.path === '/connect-dns' && ctx.method === 'POST') {
     await appsRest.handleConnectDns(await ctx.readJsonBody(), ctx.sendJson, options);
     return true;