@femtomc/mu-server 26.2.101 → 26.2.103

package/README.md

@@ -126,6 +126,9 @@ Use `mu store paths --pretty` to resolve `<store>` for the active repo/workspace
     "source": "neovim"
   }
   ```
+  - `session_kind` is optional. When omitted, the server auto-resolves `session_id` across
+    `<store>/operator/sessions` and `<store>/control-plane/operator-sessions`.
+    If the same id exists in both stores, pass `session_kind` (or `session_dir`) to disambiguate.
   - Optional overrides: `session_file`, `session_dir`, `provider`, `model`, `thinking`, `extension_profile`
   - Response includes: `turn.reply`, `turn.context_entry_id`, `turn.session_file`
 
@@ -186,7 +189,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/config.d.ts

@@ -12,7 +12,6 @@ export type MuConfig = {
             telegram: {
                 webhook_secret: string | null;
                 bot_token: string | null;
-                bot_username: string | null;
             };
             neovim: {
                 shared_secret: string | null;
@@ -44,7 +43,6 @@ export type MuConfigPatch = {
             telegram?: {
                 webhook_secret?: string | null;
                 bot_token?: string | null;
-                bot_username?: string | null;
             };
             neovim?: {
                 shared_secret?: string | null;
@@ -76,7 +74,6 @@ export type MuConfigPresence = {
             telegram: {
                 webhook_secret: boolean;
                 bot_token: boolean;
-                bot_username: boolean;
             };
             neovim: {
                 shared_secret: boolean;

package/dist/config.js

@@ -15,7 +15,6 @@ export const DEFAULT_MU_CONFIG = {
             telegram: {
                 webhook_secret: null,
                 bot_token: null,
-                bot_username: null,
             },
             neovim: {
                 shared_secret: null,
@@ -107,9 +106,6 @@ export function normalizeMuConfig(input) {
             if ("bot_token" in telegram) {
                 next.control_plane.adapters.telegram.bot_token = normalizeNullableString(telegram.bot_token);
             }
-            if ("bot_username" in telegram) {
-                next.control_plane.adapters.telegram.bot_username = normalizeNullableString(telegram.bot_username);
-            }
         }
         const neovim = asRecord(adapters.neovim);
         if (neovim && "shared_secret" in neovim) {
@@ -185,9 +181,6 @@ function normalizeMuConfigPatch(input) {
             if ("bot_token" in telegram) {
                 telegramPatch.bot_token = normalizeNullableString(telegram.bot_token);
             }
-            if ("bot_username" in telegram) {
-                telegramPatch.bot_username = normalizeNullableString(telegram.bot_username);
-            }
             if (Object.keys(telegramPatch).length > 0) {
                 patch.control_plane.adapters.telegram = telegramPatch;
             }
@@ -273,9 +266,6 @@ export function applyMuConfigPatch(base, patchInput) {
             if ("bot_token" in adapters.telegram) {
                 next.control_plane.adapters.telegram.bot_token = adapters.telegram.bot_token ?? null;
             }
-            if ("bot_username" in adapters.telegram) {
-                next.control_plane.adapters.telegram.bot_username = adapters.telegram.bot_username ?? null;
-            }
         }
         if (adapters.neovim && "shared_secret" in adapters.neovim) {
             next.control_plane.adapters.neovim.shared_secret = adapters.neovim.shared_secret ?? null;
@@ -372,7 +362,6 @@ export function muConfigPresence(config) {
                 telegram: {
                     webhook_secret: isPresent(config.control_plane.adapters.telegram.webhook_secret),
                     bot_token: isPresent(config.control_plane.adapters.telegram.bot_token),
-                    bot_username: isPresent(config.control_plane.adapters.telegram.bot_username),
                 },
                 neovim: {
                     shared_secret: isPresent(config.control_plane.adapters.neovim.shared_secret),

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/dist/control_plane_adapter_registry.d.ts

@@ -8,7 +8,6 @@ export type DetectedTelegramAdapter = {
     name: "telegram";
     webhookSecret: string;
     botToken: string | null;
-    botUsername: string | null;
 };
 export type DetectedAdapter = DetectedStaticAdapter | DetectedTelegramAdapter;
 export declare function detectAdapters(config: ControlPlaneConfig): DetectedAdapter[];

package/dist/control_plane_adapter_registry.js

@@ -50,7 +50,6 @@ export function detectAdapters(config) {
             name: "telegram",
             webhookSecret: telegramSecret,
             botToken: config.adapters.telegram.bot_token,
-            botUsername: config.adapters.telegram.bot_username,
         });
     }
     return detected;

package/dist/control_plane_telegram_generation.js

@@ -23,21 +23,18 @@ function telegramAdapterConfigFromControlPlane(config) {
     return {
         webhookSecret,
         botToken: config.adapters.telegram.bot_token,
-        botUsername: config.adapters.telegram.bot_username,
     };
 }
 function applyTelegramAdapterConfig(base, telegram) {
     const next = cloneControlPlaneConfig(base);
     next.adapters.telegram.webhook_secret = telegram?.webhookSecret ?? null;
     next.adapters.telegram.bot_token = telegram?.botToken ?? null;
-    next.adapters.telegram.bot_username = telegram?.botUsername ?? null;
     return next;
 }
 function cloneTelegramAdapterConfig(config) {
     return {
         webhookSecret: config.webhookSecret,
         botToken: config.botToken,
-        botUsername: config.botUsername,
     };
 }
 function describeError(err) {
@@ -112,7 +109,6 @@ export class TelegramAdapterGenerationManager {
             outbox: this.#outbox,
             webhookSecret: config.webhookSecret,
             botToken: config.botToken,
-            botUsername: config.botUsername,
             deferredIngress: true,
             onOutboxEnqueued: this.#onOutboxEnqueued ?? undefined,
             signalObserver: this.#signalObserver ?? undefined,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@femtomc/mu-server",
-  "version": "26.2.101",
+  "version": "26.2.103",
   "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.103",
+    "@femtomc/mu-control-plane": "26.2.103",
+    "@femtomc/mu-core": "26.2.103"
   }
 }