@femtomc/mu-server 26.2.107 → 26.2.109

package/README.md

@@ -194,11 +194,7 @@ Operational fallbacks:
 - `telegram_reply_to_message_id` metadata anchors replies when parseable.
 - 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. 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.
+Server channel renderers consume canonical `ui_docs` metadata (`UiDoc`) for Slack/Telegram/Discord/Neovim delivery. Interactive actions use callback tokens (`mu-ui:*`) with deterministic text fallbacks when tokens cannot be issued or rendered.
 
 ## Running the Server
 

package/dist/api/control_plane.js

@@ -99,6 +99,7 @@ const TEXT_ONLY_UI_COMPONENT_SUPPORT = {
     key_value: false,
     divider: false,
 };
+const STATUS_PROFILE_ACTIONS_FALLBACK_REASON = "status_profile_actions_degrade_to_text";
 const CHANNEL_UI_CAPABILITIES = {
     slack: {
         supported: true,
@@ -106,7 +107,7 @@ const CHANNEL_UI_CAPABILITIES = {
         components: UI_COMPONENT_SUPPORT,
         actions: {
             supported: true,
-            reason: null,
+            reason: STATUS_PROFILE_ACTIONS_FALLBACK_REASON,
         },
     },
     discord: {
@@ -115,7 +116,7 @@ const CHANNEL_UI_CAPABILITIES = {
         components: TEXT_ONLY_UI_COMPONENT_SUPPORT,
         actions: {
             supported: true,
-            reason: null,
+            reason: STATUS_PROFILE_ACTIONS_FALLBACK_REASON,
         },
     },
     telegram: {
@@ -124,7 +125,7 @@ const CHANNEL_UI_CAPABILITIES = {
         components: TEXT_ONLY_UI_COMPONENT_SUPPORT,
         actions: {
             supported: true,
-            reason: null,
+            reason: STATUS_PROFILE_ACTIONS_FALLBACK_REASON,
         },
     },
     neovim: {
@@ -133,7 +134,7 @@ const CHANNEL_UI_CAPABILITIES = {
         components: TEXT_ONLY_UI_COMPONENT_SUPPORT,
         actions: {
             supported: true,
-            reason: null,
+            reason: STATUS_PROFILE_ACTIONS_FALLBACK_REASON,
         },
     },
     terminal: {

package/dist/control_plane.js

@@ -1,5 +1,5 @@
-import { applyHudStylePreset, normalizeHudDocs, normalizeUiDocs, } from "@femtomc/mu-core";
-import { ControlPlaneCommandPipeline, ControlPlaneOutbox, ControlPlaneRuntime, buildSanitizedUiEventForAction, buildSlackHudActionId, getControlPlanePaths, issueUiDocActionPayloads, TelegramControlPlaneAdapterSpec, uiActionPayloadContextFromOutboxRecord, uiDocActionPayloadKey, UiCallbackTokenStore, } from "@femtomc/mu-control-plane";
+import { normalizeUiDocs, resolveUiStatusProfileName, } from "@femtomc/mu-core";
+import { ControlPlaneCommandPipeline, ControlPlaneOutbox, ControlPlaneRuntime, buildSanitizedUiEventForAction, buildSlackUiActionId, getControlPlanePaths, issueUiDocActionPayloads, TelegramControlPlaneAdapterSpec, uiActionPayloadContextFromOutboxRecord, uiDocActionPayloadKey, UiCallbackTokenStore, } from "@femtomc/mu-control-plane";
 import { DEFAULT_MU_CONFIG } from "./config.js";
 import { buildMessagingOperatorRuntime, createOutboxDrainLoop } from "./control_plane_bootstrap_helpers.js";
 import { buildWakeOutboundEnvelope, resolveWakeFanoutCapability, wakeDeliveryMetadataFromOutboxRecord, wakeDispatchReasonCode, wakeFanoutDedupeKey, } from "./control_plane_wake_delivery.js";
@@ -147,9 +147,7 @@ const SLACK_BLOCKS_MAX = 50;
 const SLACK_ACTIONS_MAX_PER_BLOCK = 5;
 const SLACK_ACTIONS_MAX_TOTAL = 20;
 const SLACK_ACTION_VALUE_MAX_CHARS = 2_000;
-const SLACK_UI_EVENT_ACTION_ID = buildSlackHudActionId("ui_event");
-const SLACK_DOCS_MAX = 3;
-const SLACK_SECTION_LINE_MAX = 8;
+const SLACK_UI_EVENT_ACTION_ID = buildSlackUiActionId("ui_event");
 const UI_DOCS_MAX = 3;
 const UI_CALLBACK_TOKEN_TTL_MS = 15 * 60_000;
 export const UI_COMPONENT_SUPPORT = {
@@ -159,9 +157,6 @@ export const UI_COMPONENT_SUPPORT = {
     divider: true,
 };
 export const UI_ACTIONS_UNSUPPORTED_REASON = "ui_actions_not_implemented";
-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;
@@ -171,103 +166,6 @@ function truncateSlackText(text, maxLen = SLACK_BLOCK_TEXT_MAX_LEN) {
     }
     return `${text.slice(0, maxLen - 1)}…`;
 }
-function hudTonePrefix(tone) {
-    switch (tone) {
-        case "success":
-            return "✅";
-        case "warning":
-            return "⚠️";
-        case "error":
-            return "⛔";
-        case "accent":
-            return "🔹";
-        case "muted":
-            return "▫️";
-        case "dim":
-            return "·";
-        case "info":
-        default:
-            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) => {
-        const label = applySlackHudTextStyle(chip.label, chip.style, { defaultWeight: "strong" });
-        return `${hudTonePrefix(chip.tone)} ${label}`;
-    })
-        .join(" · ");
-    if (chipsLine.length > 0) {
-        lines.push(chipsLine);
-    }
-    for (const section of doc.sections) {
-        switch (section.kind) {
-            case "kv": {
-                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 = applySlackHudTextStyle(section.title ?? "Checklist", section.title_style, { defaultWeight: "strong" });
-                const items = section.items
-                    .slice(0, SLACK_SECTION_LINE_MAX)
-                    .map((item) => `${item.done ? "✅" : "⬜"} ${applySlackHudTextStyle(item.label, item.style)}`);
-                if (items.length > 0) {
-                    lines.push([title, ...items].join("\n"));
-                }
-                break;
-            }
-            case "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"));
-                }
-                break;
-            }
-            case "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) {
-        const snapshot = applySlackHudTextStyle(doc.snapshot_compact, doc.snapshot_style);
-        lines.push(`${applySlackHudTextStyle("Snapshot", undefined, { defaultWeight: "strong" })}\n${snapshot}`);
-    }
-    return lines;
-}
 function uiDocComponentLines(doc) {
     const lines = [];
     const components = [...doc.components].sort((a, b) => a.id.localeCompare(b.id));
@@ -350,17 +248,6 @@ function appendUiDocText(body, uiDocs) {
     }
     return `${trimmed}\n\n${fallback}`;
 }
-function hudActionButtons(doc) {
-    return doc.actions.slice(0, SLACK_ACTIONS_MAX_TOTAL).map((action) => ({
-        type: "button",
-        text: {
-            type: "plain_text",
-            text: truncateSlackText(action.label, 75),
-        },
-        value: truncateSlackText(action.command_text, SLACK_ACTION_VALUE_MAX_CHARS),
-        action_id: buildSlackHudActionId(action.id),
-    }));
-}
 function uiDocActionTextLine(action, opts = {}) {
     const parts = [`• ${action.label}`];
     if (action.description) {
@@ -369,11 +256,36 @@ function uiDocActionTextLine(action, opts = {}) {
     parts.push(`(id=${action.id}${opts.suffix ? `; ${opts.suffix}` : ""})`);
     return parts.join(" ");
 }
+function statusProfileVariant(doc) {
+    const profile = doc.metadata.profile;
+    if (!profile || typeof profile !== "object" || Array.isArray(profile)) {
+        return "status";
+    }
+    const rawVariant = typeof profile.variant === "string"
+        ? profile.variant.trim().toLowerCase()
+        : "";
+    return rawVariant.length > 0 ? rawVariant : "status";
+}
+function isStatusProfileStatusVariant(doc) {
+    return resolveUiStatusProfileName(doc) !== null && statusProfileVariant(doc) === "status";
+}
+function uiDocDeterministicActionFallbackLine(action) {
+    const commandText = commandTextForUiDocAction(action);
+    if (commandText) {
+        return `• ${action.label}: ${commandText}`;
+    }
+    return `• ${action.label}: interactive unavailable (missing command_text)`;
+}
 function uiDocActionButtons(doc, actionPayloadsByKey) {
     const buttons = [];
     const fallbackLines = [];
+    const statusProfile = isStatusProfileStatusVariant(doc);
     const actions = [...doc.actions].sort((a, b) => a.id.localeCompare(b.id)).slice(0, SLACK_ACTIONS_MAX_TOTAL);
     for (const action of actions) {
+        if (statusProfile) {
+            fallbackLines.push(uiDocDeterministicActionFallbackLine(action));
+            continue;
+        }
         const payload = actionPayloadsByKey.get(uiDocActionPayloadKey(doc.ui_id, action.id));
         if (!payload) {
             fallbackLines.push(uiDocActionTextLine(action, { suffix: "interactive unavailable" }));
@@ -415,9 +327,8 @@ export function splitSlackMessageText(text, maxLen = SLACK_MESSAGE_MAX_LEN) {
     }
     return chunks;
 }
-function slackBlocksForOutboxRecord(record, body, uiDocs, opts = {}) {
-    const hudDocs = hudDocsForPresentation(record.envelope.metadata?.hud_docs, SLACK_DOCS_MAX);
-    if (hudDocs.length === 0 && uiDocs.length === 0) {
+function slackBlocksForOutboxRecord(body, uiDocs, opts = {}) {
+    if (uiDocs.length === 0) {
         return undefined;
     }
     const uiDocActionPayloadsByKey = opts.uiDocActionPayloadsByKey ?? new Map();
@@ -427,35 +338,6 @@ function slackBlocksForOutboxRecord(record, body, uiDocs, opts = {}) {
         type: "section",
         text: { type: "mrkdwn", text: truncateSlackText(headerText) },
     });
-    for (const doc of hudDocs) {
-        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* · ${styledTitle}`) }],
-        });
-        for (const line of hudDocSectionLines(doc)) {
-            if (blocks.length >= SLACK_BLOCKS_MAX) {
-                break;
-            }
-            blocks.push({
-                type: "section",
-                text: { type: "mrkdwn", text: truncateSlackText(line) },
-            });
-        }
-        const buttons = hudActionButtons(doc);
-        for (let idx = 0; idx < buttons.length; idx += SLACK_ACTIONS_MAX_PER_BLOCK) {
-            if (blocks.length >= SLACK_BLOCKS_MAX) {
-                break;
-            }
-            blocks.push({
-                type: "actions",
-                elements: buttons.slice(idx, idx + SLACK_ACTIONS_MAX_PER_BLOCK),
-            });
-        }
-    }
     for (const doc of uiDocs) {
         if (blocks.length >= SLACK_BLOCKS_MAX) {
             break;
@@ -515,21 +397,11 @@ function slackStatusMessageTsFromMetadata(metadata) {
 const TELEGRAM_CALLBACK_DATA_MAX_BYTES = 64;
 const TELEGRAM_ACTIONS_MAX_TOTAL = 20;
 const TELEGRAM_ACTIONS_PER_ROW = 3;
-const TELEGRAM_DOCS_MAX = 2;
 function utf8ByteLength(value) {
     return new TextEncoder().encode(value).length;
 }
-function telegramTextForOutboxRecord(record, body, uiDocs) {
-    const hudDocs = hudDocsForPresentation(record.envelope.metadata?.hud_docs, TELEGRAM_DOCS_MAX);
+function telegramTextForOutboxRecord(body, uiDocs) {
     const lines = [body.trim()];
-    if (hudDocs.length > 0) {
-        for (const doc of hudDocs) {
-            lines.push("", `HUD · ${doc.title}`);
-            for (const sectionLine of hudDocSectionLines(doc)) {
-                lines.push(stripSlackMrkdwn(sectionLine));
-            }
-        }
-    }
     const uiFallback = uiDocsTextFallback(uiDocs);
     if (uiFallback) {
         lines.push("", uiFallback);
@@ -552,43 +424,6 @@ function telegramOverflowText(lines) {
     }
     return `\n\nActions:\n${lines.join("\n")}`;
 }
-async function compileTelegramHudActions(opts) {
-    const hudDocs = hudDocsForPresentation(opts.record.envelope.metadata?.hud_docs, TELEGRAM_DOCS_MAX);
-    if (hudDocs.length === 0) {
-        return { buttonEntries: [], overflowLines: [] };
-    }
-    const buttonEntries = [];
-    const overflowLines = [];
-    const actions = hudDocs.flatMap((doc) => doc.actions).slice(0, TELEGRAM_ACTIONS_MAX_TOTAL);
-    for (const action of actions) {
-        const fallbackLine = `• ${action.label}: ${action.command_text}`;
-        let callbackData = action.command_text;
-        if (opts.encodeCallbackData) {
-            try {
-                callbackData = await opts.encodeCallbackData(action.command_text, { record: opts.record });
-            }
-            catch {
-                overflowLines.push(fallbackLine);
-                continue;
-            }
-        }
-        if (utf8ByteLength(callbackData) > TELEGRAM_CALLBACK_DATA_MAX_BYTES) {
-            overflowLines.push(fallbackLine);
-            continue;
-        }
-        buttonEntries.push({
-            button: {
-                text: action.label.slice(0, 64),
-                callback_data: callbackData,
-            },
-            fallbackLine,
-        });
-    }
-    return {
-        buttonEntries,
-        overflowLines,
-    };
-}
 function commandTextForUiDocAction(action) {
     const fromMetadata = typeof action.metadata.command_text === "string" ? action.metadata.command_text.trim() : "";
     if (fromMetadata.length === 0) {
@@ -603,17 +438,22 @@ async function compileTelegramUiDocActions(opts) {
     const buttonEntries = [];
     const overflowLines = [];
     for (const doc of opts.uiDocs) {
+        const statusProfile = isStatusProfileStatusVariant(doc);
         const actions = [...doc.actions].sort((a, b) => a.id.localeCompare(b.id));
         for (const action of actions) {
+            const commandText = commandTextForUiDocAction(action);
+            const fallbackLine = commandText
+                ? `• ${action.label}: ${commandText}`
+                : `• ${action.label}: interactive unavailable (missing command_text)`;
+            if (statusProfile) {
+                overflowLines.push(fallbackLine);
+                continue;
+            }
             const uiEvent = buildSanitizedUiEventForAction({
                 doc,
                 action,
                 createdAtMs: opts.nowMs,
             });
-            const commandText = commandTextForUiDocAction(action);
-            const fallbackLine = commandText
-                ? `• ${action.label}: ${commandText}`
-                : `• ${action.label}: interactive unavailable (missing command_text)`;
             if (!commandText || !uiEvent) {
                 overflowLines.push(fallbackLine);
                 continue;
@@ -736,28 +576,22 @@ async function sendTelegramTextChunks(opts) {
 }
 export async function deliverTelegramOutboxRecord(opts) {
     const { botToken, record } = opts;
-    const uiDocs = normalizeUiDocs(record.envelope.metadata?.ui_docs, { maxDocs: TELEGRAM_DOCS_MAX });
+    const uiDocs = normalizeUiDocs(record.envelope.metadata?.ui_docs, { maxDocs: UI_DOCS_MAX });
     const nowMs = Math.trunc(Date.now());
-    const hudActions = await compileTelegramHudActions({
-        record,
-        encodeCallbackData: opts.encodeCallbackData,
-    });
     const uiActions = await compileTelegramUiDocActions({
         record,
         uiDocs,
         nowMs,
         encodeCallbackData: opts.encodeCallbackData,
     });
-    const combinedEntries = [...hudActions.buttonEntries, ...uiActions.buttonEntries];
-    const visibleEntries = combinedEntries.slice(0, TELEGRAM_ACTIONS_MAX_TOTAL);
+    const visibleEntries = uiActions.buttonEntries.slice(0, TELEGRAM_ACTIONS_MAX_TOTAL);
     const overflowLines = [
-        ...hudActions.overflowLines,
         ...uiActions.overflowLines,
-        ...combinedEntries.slice(TELEGRAM_ACTIONS_MAX_TOTAL).map((entry) => entry.fallbackLine),
+        ...uiActions.buttonEntries.slice(TELEGRAM_ACTIONS_MAX_TOTAL).map((entry) => entry.fallbackLine),
     ];
     const replyMarkup = telegramReplyMarkupFromButtons(visibleEntries.map((entry) => entry.button));
     const replyToMessageId = maybeParseTelegramMessageId(record.envelope.metadata?.telegram_reply_to_message_id);
-    const telegramText = `${telegramTextForOutboxRecord(record, record.envelope.body, uiDocs)}${telegramOverflowText(overflowLines)}`.trim();
+    const telegramText = `${telegramTextForOutboxRecord(record.envelope.body, uiDocs)}${telegramOverflowText(overflowLines)}`.trim();
     const fallbackMessagePayload = {
         ...buildTelegramSendMessagePayload({
             chatId: record.envelope.channel_conversation_id,
@@ -916,10 +750,11 @@ export async function deliverSlackOutboxRecord(opts) {
     const fetchImpl = opts.fetchImpl ?? fetch;
     const attachments = record.envelope.attachments ?? [];
     const uiDocs = normalizeUiDocs(record.envelope.metadata?.ui_docs, { maxDocs: UI_DOCS_MAX });
+    const interactiveUiDocs = uiDocs.filter((doc) => !isStatusProfileStatusVariant(doc));
     let uiDocActionPayloadsByKey = new Map();
-    if (opts.uiCallbackTokenStore && uiDocs.some((doc) => doc.actions.length > 0)) {
+    if (opts.uiCallbackTokenStore && interactiveUiDocs.some((doc) => doc.actions.length > 0)) {
         const issued = await issueUiDocActionPayloads({
-            uiDocs,
+            uiDocs: interactiveUiDocs,
             tokenStore: opts.uiCallbackTokenStore,
             context: uiActionPayloadContextFromOutboxRecord(record),
             ttlMs: UI_CALLBACK_TOKEN_TTL_MS,
@@ -928,7 +763,7 @@ export async function deliverSlackOutboxRecord(opts) {
         uiDocActionPayloadsByKey = new Map(issued.map((entry) => [entry.key, entry.payload_json]));
     }
     const renderedBodyForBlocks = renderSlackMarkdown(record.envelope.body);
-    const blocks = slackBlocksForOutboxRecord(record, renderedBodyForBlocks, uiDocs, {
+    const blocks = slackBlocksForOutboxRecord(renderedBodyForBlocks, uiDocs, {
         uiDocActionPayloadsByKey,
     });
     const bodyForText = blocks

package/package.json

@@ -1,37 +1,37 @@
 {
-  "name": "@femtomc/mu-server",
-  "version": "26.2.107",
-  "description": "HTTP API server for mu control-plane transport/session plus run/activity scheduling coordination.",
-  "keywords": [
-    "mu",
-    "server",
-    "api",
-    "web",
-    "automation"
-  ],
-  "type": "module",
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "bin": {
-    "mu-server": "./dist/cli.js"
-  },
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "default": "./dist/index.js"
-    }
-  },
-  "files": [
-    "dist/**"
-  ],
-  "scripts": {
-    "build": "tsc -p tsconfig.build.json",
-    "test": "bun test",
-    "start": "bun run dist/cli.js"
-  },
-  "dependencies": {
-    "@femtomc/mu-agent": "26.2.107",
-    "@femtomc/mu-control-plane": "26.2.107",
-    "@femtomc/mu-core": "26.2.107"
-  }
+	"name": "@femtomc/mu-server",
+	"version": "26.2.109",
+	"description": "HTTP API server for mu control-plane transport/session plus run/activity scheduling coordination.",
+	"keywords": [
+		"mu",
+		"server",
+		"api",
+		"web",
+		"automation"
+	],
+	"type": "module",
+	"main": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"bin": {
+		"mu-server": "./dist/cli.js"
+	},
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"default": "./dist/index.js"
+		}
+	},
+	"files": [
+		"dist/**"
+	],
+	"scripts": {
+		"build": "tsc -p tsconfig.build.json",
+		"test": "bun test",
+		"start": "bun run dist/cli.js"
+	},
+	"dependencies": {
+		"@femtomc/mu-agent": "26.2.109",
+		"@femtomc/mu-control-plane": "26.2.109",
+		"@femtomc/mu-core": "26.2.109"
+	}
 }