@femtomc/mu-server 26.2.101 → 26.2.102

package/README.md

@@ -186,7 +186,9 @@ Operational fallbacks:
 - Missing Slack/Telegram bot tokens surface capability reason codes (`*_bot_token_missing`) and retry behavior.
 
 Server channel renderers consume canonical `hud_docs` metadata (`HudDoc`) for Slack/Telegram HUD
-rendering + actions. New features should extend the shared HUD contract path instead of bespoke
+rendering + actions. Optional HUD presentation hints (`title_style`, `snapshot_style`, chip/item styles)
+and metadata presets (`metadata.style_preset`) may be used by richer renderers and safely ignored by
+plain-text channels. New features should extend the shared HUD contract path instead of bespoke
 channel-specific HUD payload formats.
 
 ## Running the Server

package/dist/control_plane.js

@@ -1,4 +1,4 @@
-import { normalizeHudDocs } from "@femtomc/mu-core";
+import { applyHudStylePreset, normalizeHudDocs } from "@femtomc/mu-core";
 import { ControlPlaneCommandPipeline, ControlPlaneOutbox, ControlPlaneRuntime, buildSlackHudActionId, getControlPlanePaths, TelegramControlPlaneAdapterSpec, } from "@femtomc/mu-control-plane";
 import { DEFAULT_MU_CONFIG } from "./config.js";
 import { buildMessagingOperatorRuntime, createOutboxDrainLoop } from "./control_plane_bootstrap_helpers.js";
@@ -148,6 +148,9 @@ const SLACK_ACTIONS_MAX_PER_BLOCK = 5;
 const SLACK_ACTIONS_MAX_TOTAL = 20;
 const SLACK_DOCS_MAX = 3;
 const SLACK_SECTION_LINE_MAX = 8;
+function hudDocsForPresentation(input, maxDocs) {
+    return normalizeHudDocs(input, { maxDocs }).map((doc) => applyHudStylePreset(doc) ?? doc);
+}
 function truncateSlackText(text, maxLen = SLACK_BLOCK_TEXT_MAX_LEN) {
     if (text.length <= maxLen) {
         return text;
@@ -176,11 +179,33 @@ function hudTonePrefix(tone) {
             return "ℹ️";
     }
 }
+function applySlackHudTextStyle(text, style, opts = {}) {
+    const weight = style?.weight ?? opts.defaultWeight;
+    const italic = style?.italic ?? opts.defaultItalic ?? false;
+    const code = style?.code ?? opts.defaultCode ?? false;
+    let out = text;
+    if (code) {
+        out = `\`${out}\``;
+    }
+    if (italic) {
+        out = `_${out}_`;
+    }
+    if (weight === "strong") {
+        out = `*${out}*`;
+    }
+    return out;
+}
+function stripSlackMrkdwn(text) {
+    return text.replace(/[*_`~]/g, "");
+}
 function hudDocSectionLines(doc) {
     const lines = [];
     const chipsLine = doc.chips
         .slice(0, 8)
-        .map((chip) => `${hudTonePrefix(chip.tone)} *${chip.label}*`)
+        .map((chip) => {
+        const label = applySlackHudTextStyle(chip.label, chip.style, { defaultWeight: "strong" });
+        return `${hudTonePrefix(chip.tone)} ${label}`;
+    })
         .join(" · ");
     if (chipsLine.length > 0) {
         lines.push(chipsLine);
@@ -188,25 +213,28 @@ function hudDocSectionLines(doc) {
     for (const section of doc.sections) {
         switch (section.kind) {
             case "kv": {
-                const title = section.title ? `*${section.title}*` : "*Details*";
-                const items = section.items.slice(0, SLACK_SECTION_LINE_MAX).map((item) => `• *${item.label}:* ${item.value}`);
+                const title = applySlackHudTextStyle(section.title ?? "Details", section.title_style, { defaultWeight: "strong" });
+                const items = section.items.slice(0, SLACK_SECTION_LINE_MAX).map((item) => {
+                    const value = applySlackHudTextStyle(item.value, item.value_style);
+                    return `• *${item.label}:* ${value}`;
+                });
                 if (items.length > 0) {
                     lines.push([title, ...items].join("\n"));
                 }
                 break;
             }
             case "checklist": {
-                const title = section.title ? `*${section.title}*` : "*Checklist*";
+                const title = applySlackHudTextStyle(section.title ?? "Checklist", section.title_style, { defaultWeight: "strong" });
                 const items = section.items
                     .slice(0, SLACK_SECTION_LINE_MAX)
-                    .map((item) => `${item.done ? "✅" : "⬜"} ${item.label}`);
+                    .map((item) => `${item.done ? "✅" : "⬜"} ${applySlackHudTextStyle(item.label, item.style)}`);
                 if (items.length > 0) {
                     lines.push([title, ...items].join("\n"));
                 }
                 break;
             }
             case "activity": {
-                const title = section.title ? `*${section.title}*` : "*Activity*";
+                const title = applySlackHudTextStyle(section.title ?? "Activity", section.title_style, { defaultWeight: "strong" });
                 const items = section.lines.slice(0, SLACK_SECTION_LINE_MAX).map((line) => `• ${line}`);
                 if (items.length > 0) {
                     lines.push([title, ...items].join("\n"));
@@ -214,14 +242,18 @@ function hudDocSectionLines(doc) {
                 break;
             }
             case "text": {
-                const title = section.title ? `*${section.title}*\n` : "";
-                lines.push(`${title}${section.text}`);
+                const title = section.title
+                    ? `${applySlackHudTextStyle(section.title, section.title_style, { defaultWeight: "strong" })}\n`
+                    : "";
+                const text = applySlackHudTextStyle(section.text, section.style);
+                lines.push(`${title}${text}`);
                 break;
             }
         }
     }
     if (lines.length === 0) {
-        lines.push(`*Snapshot*\n${doc.snapshot_compact}`);
+        const snapshot = applySlackHudTextStyle(doc.snapshot_compact, doc.snapshot_style);
+        lines.push(`${applySlackHudTextStyle("Snapshot", undefined, { defaultWeight: "strong" })}\n${snapshot}`);
     }
     return lines;
 }
@@ -257,7 +289,7 @@ export function splitSlackMessageText(text, maxLen = SLACK_MESSAGE_MAX_LEN) {
     return chunks;
 }
 function slackBlocksForOutboxRecord(record, body) {
-    const hudDocs = normalizeHudDocs(record.envelope.metadata?.hud_docs, { maxDocs: SLACK_DOCS_MAX });
+    const hudDocs = hudDocsForPresentation(record.envelope.metadata?.hud_docs, SLACK_DOCS_MAX);
     if (hudDocs.length === 0) {
         return undefined;
     }
@@ -270,9 +302,10 @@ function slackBlocksForOutboxRecord(record, body) {
         if (blocks.length >= SLACK_BLOCKS_MAX) {
             break;
         }
+        const styledTitle = applySlackHudTextStyle(doc.title, doc.title_style, { defaultWeight: "strong" });
         blocks.push({
             type: "context",
-            elements: [{ type: "mrkdwn", text: truncateSlackText(`*HUD · ${doc.title}*`) }],
+            elements: [{ type: "mrkdwn", text: truncateSlackText(`*HUD* · ${styledTitle}`) }],
         });
         for (const line of hudDocSectionLines(doc)) {
             if (blocks.length >= SLACK_BLOCKS_MAX) {
@@ -321,7 +354,7 @@ function utf8ByteLength(value) {
     return new TextEncoder().encode(value).length;
 }
 function telegramTextForOutboxRecord(record, body) {
-    const hudDocs = normalizeHudDocs(record.envelope.metadata?.hud_docs, { maxDocs: TELEGRAM_DOCS_MAX });
+    const hudDocs = hudDocsForPresentation(record.envelope.metadata?.hud_docs, TELEGRAM_DOCS_MAX);
     if (hudDocs.length === 0) {
         return body;
     }
@@ -329,13 +362,13 @@ function telegramTextForOutboxRecord(record, body) {
     for (const doc of hudDocs) {
         lines.push("", `HUD · ${doc.title}`);
         for (const sectionLine of hudDocSectionLines(doc)) {
-            lines.push(sectionLine.replace(/\*/g, ""));
+            lines.push(stripSlackMrkdwn(sectionLine));
         }
     }
     return lines.join("\n").trim();
 }
 async function compileTelegramHudActions(opts) {
-    const hudDocs = normalizeHudDocs(opts.record.envelope.metadata?.hud_docs, { maxDocs: TELEGRAM_DOCS_MAX });
+    const hudDocs = hudDocsForPresentation(opts.record.envelope.metadata?.hud_docs, TELEGRAM_DOCS_MAX);
     if (hudDocs.length === 0) {
         return { overflowText: "" };
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@femtomc/mu-server",
-  "version": "26.2.101",
+  "version": "26.2.102",
   "description": "HTTP API server for mu control-plane transport/session plus run/activity scheduling coordination.",
   "keywords": [
     "mu",
@@ -30,8 +30,8 @@
     "start": "bun run dist/cli.js"
   },
   "dependencies": {
-    "@femtomc/mu-agent": "26.2.101",
-    "@femtomc/mu-control-plane": "26.2.101",
-    "@femtomc/mu-core": "26.2.101"
+    "@femtomc/mu-agent": "26.2.102",
+    "@femtomc/mu-control-plane": "26.2.102",
+    "@femtomc/mu-core": "26.2.102"
   }
 }