@femtomc/mu-agent 26.2.101 → 26.2.102

package/README.md

@@ -66,7 +66,7 @@ Current stack:
 
 - `brandingExtension` — mu compact header/footer branding + default theme
 - `eventLogExtension` — event tail + watch widget
-- `hudExtension` — HUD surface for skill-directed planning/subagents communication (`/mu hud ...`, `mu_hud`)
+- `hudExtension` — HUD surface for skill-directed planning/subagents communication (`/mu hud ...`, `mu_hud`) with tone/style-aware TUI widget rows, including `metadata.style_preset` support for `planning|subagents` (plain deterministic snapshots remain available via `/mu hud snapshot`)
 
 Extensions emit contract-valid `hud_docs` (`HudDoc`) so control-plane/server renderers can provide a consistent cross-surface HUD experience.
 

package/dist/extensions/hud.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hud.d.ts","sourceRoot":"","sources":["../../src/extensions/hud.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAoB,MAAM,+BAA+B,CAAC;AA8QpF,wBAAgB,YAAY,CAAC,EAAE,EAAE,YAAY,QAuE5C;AAED,eAAe,YAAY,CAAC"}
+{"version":3,"file":"hud.d.ts","sourceRoot":"","sources":["../../src/extensions/hud.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,YAAY,EAAoB,MAAM,+BAA+B,CAAC;AA0fpF,wBAAgB,YAAY,CAAC,EAAE,EAAE,YAAY,QAuE5C;AAED,eAAe,YAAY,CAAC"}

package/dist/extensions/hud.js

@@ -1,8 +1,89 @@
-import { HudDocSchema, normalizeHudDocs, serializeHudDocsTextFallback } from "@femtomc/mu-core";
+import { applyHudStylePreset, hudStylePresetWarnings, HudDocSchema, normalizeHudDocs, serializeHudDocsTextFallback, } from "@femtomc/mu-core";
 import { registerMuSubcommand } from "./mu-command-dispatcher.js";
 const HUD_DISPLAY_DOCS_MAX = 16;
 const HUD_STORE_DOCS_MAX = 64;
 const HUD_LINE_MAX = 120;
+const HUD_CHIPS_MAX = 8;
+const HUD_SECTION_ITEMS_MAX = 6;
+const HUD_ACTIONS_MAX = 4;
+const HUD_LABEL_MAX = 28;
+const HUD_VALUE_MAX = 84;
+function themeBold(theme, text) {
+    if (typeof theme.bold === "function") {
+        return theme.bold(text);
+    }
+    return text;
+}
+function themeItalic(theme, text) {
+    if (typeof theme.italic === "function") {
+        return theme.italic(text);
+    }
+    return text;
+}
+function themeInverse(theme, text) {
+    if (typeof theme.inverse === "function") {
+        return theme.inverse(text);
+    }
+    return text;
+}
+function applyHudTextStyle(theme, text, style, opts = {}) {
+    let out = text;
+    const weight = style?.weight ?? opts.defaultWeight;
+    const italic = style?.italic ?? opts.defaultItalic ?? false;
+    const code = style?.code ?? opts.defaultCode ?? false;
+    if (code) {
+        out = themeInverse(theme, out);
+    }
+    if (italic) {
+        out = themeItalic(theme, out);
+    }
+    if (weight === "strong") {
+        out = themeBold(theme, out);
+    }
+    return out;
+}
+function toneColor(tone) {
+    switch (tone) {
+        case "success":
+            return "success";
+        case "warning":
+            return "warning";
+        case "error":
+            return "error";
+        case "muted":
+            return "muted";
+        case "dim":
+            return "dim";
+        case "accent":
+            return "accent";
+        case "info":
+        default:
+            return "text";
+    }
+}
+function actionKindColor(kind) {
+    switch (kind) {
+        case "primary":
+            return "accent";
+        case "danger":
+            return "error";
+        case "secondary":
+        default:
+            return "dim";
+    }
+}
+function sectionFallbackTitle(kind) {
+    switch (kind) {
+        case "kv":
+            return "Details";
+        case "checklist":
+            return "Checklist";
+        case "activity":
+            return "Activity";
+        case "text":
+            return "Notes";
+    }
+}
 function createDefaultState() {
     return {
         enabled: false,
@@ -23,6 +104,113 @@ function short(text, max = HUD_LINE_MAX) {
     }
     return `${normalized.slice(0, max - 1)}…`;
 }
+function sectionHeading(theme, section) {
+    const title = short(section.title ?? sectionFallbackTitle(section.kind), 48);
+    const styledTitle = applyHudTextStyle(theme, title, section.title_style, { defaultWeight: "strong" });
+    return [theme.fg("accent", styledTitle), theme.fg("dim", `(${section.kind})`)].join(" ");
+}
+function renderHudWidgetLines(theme, docs) {
+    const lines = [];
+    for (const [docIndex, doc] of docs.entries()) {
+        if (docIndex > 0) {
+            lines.push(theme.fg("muted", "─".repeat(26)));
+        }
+        const title = short(doc.title, 64);
+        const hudId = short(doc.hud_id, 32);
+        const styledTitle = applyHudTextStyle(theme, title, doc.title_style, { defaultWeight: "strong" });
+        lines.push(`${theme.fg("accent", styledTitle)} ${theme.fg("dim", `[${hudId}]`)}`);
+        if (doc.scope) {
+            lines.push(`${theme.fg("dim", "scope:")} ${theme.fg("muted", short(doc.scope, HUD_LINE_MAX - 7))}`);
+        }
+        if (doc.chips.length > 0) {
+            const visible = doc.chips.slice(0, HUD_CHIPS_MAX);
+            const chips = visible.map((chip) => {
+                const color = toneColor(chip.tone);
+                const label = short(chip.label, 28);
+                const chipLabel = applyHudTextStyle(theme, label, chip.style, {
+                    defaultWeight: color === "muted" || color === "dim" ? "normal" : "strong",
+                });
+                return theme.fg(color, chipLabel);
+            });
+            const hiddenCount = doc.chips.length - visible.length;
+            if (hiddenCount > 0) {
+                chips.push(theme.fg("dim", `+${hiddenCount}`));
+            }
+            lines.push(chips.join(theme.fg("muted", " · ")));
+        }
+        for (const section of doc.sections) {
+            lines.push(sectionHeading(theme, section));
+            switch (section.kind) {
+                case "kv": {
+                    const visible = section.items.slice(0, HUD_SECTION_ITEMS_MAX);
+                    for (const item of visible) {
+                        const keyLabel = short(item.label, HUD_LABEL_MAX);
+                        const valueMax = Math.max(16, HUD_LINE_MAX - keyLabel.length - 8);
+                        const valueLabel = short(item.value, Math.min(HUD_VALUE_MAX, valueMax));
+                        const styledValue = applyHudTextStyle(theme, valueLabel, item.value_style);
+                        lines.push(`  ${theme.fg("muted", "-")} ${theme.fg("dim", `${keyLabel}:`)} ${theme.fg(toneColor(item.tone), styledValue)}`);
+                    }
+                    const hiddenCount = section.items.length - visible.length;
+                    if (hiddenCount > 0) {
+                        lines.push(theme.fg("dim", `  … (+${hiddenCount} more)`));
+                    }
+                    break;
+                }
+                case "checklist": {
+                    const visible = section.items.slice(0, HUD_SECTION_ITEMS_MAX);
+                    for (const item of visible) {
+                        const marker = item.done ? theme.fg("success", "[x]") : theme.fg("dim", "[ ]");
+                        const textColor = item.done ? "dim" : "text";
+                        const label = short(item.label, HUD_LINE_MAX - 8);
+                        const styledLabel = applyHudTextStyle(theme, label, item.style);
+                        lines.push(`  ${marker} ${theme.fg(textColor, styledLabel)}`);
+                    }
+                    const hiddenCount = section.items.length - visible.length;
+                    if (hiddenCount > 0) {
+                        lines.push(theme.fg("dim", `  … (+${hiddenCount} more)`));
+                    }
+                    break;
+                }
+                case "activity": {
+                    const visible = section.lines.slice(0, HUD_SECTION_ITEMS_MAX);
+                    for (const line of visible) {
+                        lines.push(`  ${theme.fg("muted", "-")} ${theme.fg("dim", short(line, HUD_LINE_MAX - 6))}`);
+                    }
+                    const hiddenCount = section.lines.length - visible.length;
+                    if (hiddenCount > 0) {
+                        lines.push(theme.fg("dim", `  … (+${hiddenCount} more)`));
+                    }
+                    break;
+                }
+                case "text": {
+                    const text = short(section.text, HUD_LINE_MAX - 4);
+                    const styledText = applyHudTextStyle(theme, text, section.style);
+                    lines.push(`  ${theme.fg(toneColor(section.tone), styledText)}`);
+                    break;
+                }
+            }
+        }
+        if (doc.actions.length > 0) {
+            lines.push(theme.fg("accent", applyHudTextStyle(theme, "Actions", undefined, { defaultWeight: "strong" })));
+            const visible = doc.actions.slice(0, HUD_ACTIONS_MAX);
+            for (const action of visible) {
+                const color = actionKindColor(action.kind);
+                const label = short(action.label, HUD_LABEL_MAX);
+                const styledLabel = applyHudTextStyle(theme, label, action.style, { defaultWeight: "strong" });
+                const commandText = short(action.command_text, HUD_VALUE_MAX);
+                lines.push(`  ${theme.fg(color, styledLabel)} ${theme.fg("dim", commandText)}`);
+            }
+            const hiddenCount = doc.actions.length - visible.length;
+            if (hiddenCount > 0) {
+                lines.push(theme.fg("dim", `  … (+${hiddenCount} more)`));
+            }
+        }
+        const snapshotText = short(doc.snapshot_compact, HUD_LINE_MAX - 10);
+        const styledSnapshot = applyHudTextStyle(theme, snapshotText, doc.snapshot_style, { defaultItalic: true });
+        lines.push(`${theme.fg("dim", "snapshot:")} ${theme.fg("muted", styledSnapshot)}`);
+    }
+    return lines;
+}
 function activeDocs(state, maxDocs = HUD_DISPLAY_DOCS_MAX) {
     return normalizeHudDocs([...state.docsById.values()], { maxDocs });
 }
@@ -53,18 +241,9 @@ function renderHud(ctx, state) {
         ctx.ui.theme.fg("muted", "·"),
         ctx.ui.theme.fg("dim", idLabel),
     ].join(" "));
-    const snapshot = serializeHudDocsTextFallback(docs, {
-        mode: "multiline",
-        maxDocs: HUD_DISPLAY_DOCS_MAX,
-        maxSectionItems: 6,
-        maxActions: 4,
-        maxChars: 8_000,
-    });
-    const lines = snapshot
-        .split(/\r?\n/)
-        .map((line) => short(line, HUD_LINE_MAX))
-        .filter((line) => line.length > 0);
-    ctx.ui.setWidget("mu-hud", lines.length > 0 ? lines : ["(hud enabled, no docs)"], { placement: "belowEditor" });
+    const docsForRender = docs.map((doc) => applyHudStylePreset(doc) ?? doc);
+    const lines = renderHudWidgetLines(ctx.ui.theme, docsForRender);
+    ctx.ui.setWidget("mu-hud", lines.length > 0 ? lines : [ctx.ui.theme.fg("dim", "(hud enabled, no docs)")], { placement: "belowEditor" });
 }
 function parseHudDoc(input) {
     const parsed = HudDocSchema.safeParse(input);
@@ -87,6 +266,23 @@ function parseHudDocList(input) {
     }
     return { ok: true, docs: normalizeHudDocs(docs, { maxDocs: HUD_STORE_DOCS_MAX }) };
 }
+function presetWarningsExtraForDoc(doc) {
+    const warnings = hudStylePresetWarnings(doc);
+    if (warnings.length === 0) {
+        return {};
+    }
+    return { preset_warnings: warnings };
+}
+function presetWarningsExtraForDocs(docs) {
+    const byHudId = {};
+    for (const doc of docs) {
+        const warnings = hudStylePresetWarnings(doc);
+        if (warnings.length > 0) {
+            byHudId[doc.hud_id] = warnings;
+        }
+    }
+    return Object.keys(byHudId).length > 0 ? { preset_warnings: byHudId } : {};
+}
 function hudToolResult(opts) {
     const docs = activeDocs(opts.state, HUD_STORE_DOCS_MAX);
     return {
@@ -146,7 +342,7 @@ function applyHudAction(params, state) {
                 ok: true,
                 action: params.action,
                 message: `HUD doc set: ${parsed.doc.hud_id}`,
-                extra: { hud_id: parsed.doc.hud_id },
+                extra: { hud_id: parsed.doc.hud_id, ...presetWarningsExtraForDoc(parsed.doc) },
             };
         }
         case "replace": {
@@ -159,7 +355,12 @@ function applyHudAction(params, state) {
                 state.docsById.set(doc.hud_id, doc);
             }
             state.enabled = true;
-            return { ok: true, action: "replace", message: `HUD docs replaced (${parsed.docs.length}).` };
+            return {
+                ok: true,
+                action: "replace",
+                message: `HUD docs replaced (${parsed.docs.length}).`,
+                extra: presetWarningsExtraForDocs(parsed.docs),
+            };
         }
         case "remove": {
             const hudId = (params.hud_id ?? "").trim();

package/dist/operator.d.ts

@@ -63,6 +63,14 @@ export declare const OperatorBackendTurnResultSchema: z.ZodDiscriminatedUnion<[z
         v: z.ZodDefault<z.ZodLiteral<1>>;
         hud_id: z.ZodString;
         title: z.ZodString;
+        title_style: z.ZodOptional<z.ZodObject<{
+            weight: z.ZodOptional<z.ZodEnum<{
+                normal: "normal";
+                strong: "strong";
+            }>>;
+            italic: z.ZodOptional<z.ZodBoolean>;
+            code: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>>;
         scope: z.ZodDefault<z.ZodNullable<z.ZodString>>;
         chips: z.ZodDefault<z.ZodArray<z.ZodObject<{
             key: z.ZodString;
@@ -76,10 +84,26 @@ export declare const OperatorBackendTurnResultSchema: z.ZodDiscriminatedUnion<[z
                 accent: "accent";
                 dim: "dim";
             }>>;
+            style: z.ZodOptional<z.ZodObject<{
+                weight: z.ZodOptional<z.ZodEnum<{
+                    normal: "normal";
+                    strong: "strong";
+                }>>;
+                italic: z.ZodOptional<z.ZodBoolean>;
+                code: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strict>>;
         }, z.core.$strict>>>;
         sections: z.ZodDefault<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
             kind: z.ZodLiteral<"kv">;
             title: z.ZodOptional<z.ZodString>;
+            title_style: z.ZodOptional<z.ZodObject<{
+                weight: z.ZodOptional<z.ZodEnum<{
+                    normal: "normal";
+                    strong: "strong";
+                }>>;
+                italic: z.ZodOptional<z.ZodBoolean>;
+                code: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strict>>;
             items: z.ZodDefault<z.ZodArray<z.ZodObject<{
                 key: z.ZodString;
                 label: z.ZodString;
@@ -93,22 +117,62 @@ export declare const OperatorBackendTurnResultSchema: z.ZodDiscriminatedUnion<[z
                     accent: "accent";
                     dim: "dim";
                 }>>;
+                value_style: z.ZodOptional<z.ZodObject<{
+                    weight: z.ZodOptional<z.ZodEnum<{
+                        normal: "normal";
+                        strong: "strong";
+                    }>>;
+                    italic: z.ZodOptional<z.ZodBoolean>;
+                    code: z.ZodOptional<z.ZodBoolean>;
+                }, z.core.$strict>>;
             }, z.core.$strict>>>;
         }, z.core.$strict>, z.ZodObject<{
             kind: z.ZodLiteral<"checklist">;
             title: z.ZodOptional<z.ZodString>;
+            title_style: z.ZodOptional<z.ZodObject<{
+                weight: z.ZodOptional<z.ZodEnum<{
+                    normal: "normal";
+                    strong: "strong";
+                }>>;
+                italic: z.ZodOptional<z.ZodBoolean>;
+                code: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strict>>;
             items: z.ZodDefault<z.ZodArray<z.ZodObject<{
                 id: z.ZodString;
                 label: z.ZodString;
                 done: z.ZodBoolean;
+                style: z.ZodOptional<z.ZodObject<{
+                    weight: z.ZodOptional<z.ZodEnum<{
+                        normal: "normal";
+                        strong: "strong";
+                    }>>;
+                    italic: z.ZodOptional<z.ZodBoolean>;
+                    code: z.ZodOptional<z.ZodBoolean>;
+                }, z.core.$strict>>;
             }, z.core.$strict>>>;
         }, z.core.$strict>, z.ZodObject<{
             kind: z.ZodLiteral<"activity">;
             title: z.ZodOptional<z.ZodString>;
+            title_style: z.ZodOptional<z.ZodObject<{
+                weight: z.ZodOptional<z.ZodEnum<{
+                    normal: "normal";
+                    strong: "strong";
+                }>>;
+                italic: z.ZodOptional<z.ZodBoolean>;
+                code: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strict>>;
             lines: z.ZodDefault<z.ZodArray<z.ZodString>>;
         }, z.core.$strict>, z.ZodObject<{
             kind: z.ZodLiteral<"text">;
             title: z.ZodOptional<z.ZodString>;
+            title_style: z.ZodOptional<z.ZodObject<{
+                weight: z.ZodOptional<z.ZodEnum<{
+                    normal: "normal";
+                    strong: "strong";
+                }>>;
+                italic: z.ZodOptional<z.ZodBoolean>;
+                code: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strict>>;
             text: z.ZodString;
             tone: z.ZodOptional<z.ZodEnum<{
                 error: "error";
@@ -119,6 +183,14 @@ export declare const OperatorBackendTurnResultSchema: z.ZodDiscriminatedUnion<[z
                 accent: "accent";
                 dim: "dim";
             }>>;
+            style: z.ZodOptional<z.ZodObject<{
+                weight: z.ZodOptional<z.ZodEnum<{
+                    normal: "normal";
+                    strong: "strong";
+                }>>;
+                italic: z.ZodOptional<z.ZodBoolean>;
+                code: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strict>>;
         }, z.core.$strict>], "kind">>>;
         actions: z.ZodDefault<z.ZodArray<z.ZodObject<{
             id: z.ZodString;
@@ -129,8 +201,24 @@ export declare const OperatorBackendTurnResultSchema: z.ZodDiscriminatedUnion<[z
                 secondary: "secondary";
                 danger: "danger";
             }>>;
+            style: z.ZodOptional<z.ZodObject<{
+                weight: z.ZodOptional<z.ZodEnum<{
+                    normal: "normal";
+                    strong: "strong";
+                }>>;
+                italic: z.ZodOptional<z.ZodBoolean>;
+                code: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strict>>;
         }, z.core.$strict>>>;
         snapshot_compact: z.ZodString;
+        snapshot_style: z.ZodOptional<z.ZodObject<{
+            weight: z.ZodOptional<z.ZodEnum<{
+                normal: "normal";
+                strong: "strong";
+            }>>;
+            italic: z.ZodOptional<z.ZodBoolean>;
+            code: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>>;
         snapshot_multiline: z.ZodOptional<z.ZodString>;
         updated_at_ms: z.ZodNumber;
         metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -176,6 +264,14 @@ export declare const OperatorBackendTurnResultSchema: z.ZodDiscriminatedUnion<[z
         v: z.ZodDefault<z.ZodLiteral<1>>;
         hud_id: z.ZodString;
         title: z.ZodString;
+        title_style: z.ZodOptional<z.ZodObject<{
+            weight: z.ZodOptional<z.ZodEnum<{
+                normal: "normal";
+                strong: "strong";
+            }>>;
+            italic: z.ZodOptional<z.ZodBoolean>;
+            code: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>>;
         scope: z.ZodDefault<z.ZodNullable<z.ZodString>>;
         chips: z.ZodDefault<z.ZodArray<z.ZodObject<{
             key: z.ZodString;
@@ -189,10 +285,26 @@ export declare const OperatorBackendTurnResultSchema: z.ZodDiscriminatedUnion<[z
                 accent: "accent";
                 dim: "dim";
             }>>;
+            style: z.ZodOptional<z.ZodObject<{
+                weight: z.ZodOptional<z.ZodEnum<{
+                    normal: "normal";
+                    strong: "strong";
+                }>>;
+                italic: z.ZodOptional<z.ZodBoolean>;
+                code: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strict>>;
         }, z.core.$strict>>>;
         sections: z.ZodDefault<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
             kind: z.ZodLiteral<"kv">;
             title: z.ZodOptional<z.ZodString>;
+            title_style: z.ZodOptional<z.ZodObject<{
+                weight: z.ZodOptional<z.ZodEnum<{
+                    normal: "normal";
+                    strong: "strong";
+                }>>;
+                italic: z.ZodOptional<z.ZodBoolean>;
+                code: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strict>>;
             items: z.ZodDefault<z.ZodArray<z.ZodObject<{
                 key: z.ZodString;
                 label: z.ZodString;
@@ -206,22 +318,62 @@ export declare const OperatorBackendTurnResultSchema: z.ZodDiscriminatedUnion<[z
                     accent: "accent";
                     dim: "dim";
                 }>>;
+                value_style: z.ZodOptional<z.ZodObject<{
+                    weight: z.ZodOptional<z.ZodEnum<{
+                        normal: "normal";
+                        strong: "strong";
+                    }>>;
+                    italic: z.ZodOptional<z.ZodBoolean>;
+                    code: z.ZodOptional<z.ZodBoolean>;
+                }, z.core.$strict>>;
             }, z.core.$strict>>>;
         }, z.core.$strict>, z.ZodObject<{
             kind: z.ZodLiteral<"checklist">;
             title: z.ZodOptional<z.ZodString>;
+            title_style: z.ZodOptional<z.ZodObject<{
+                weight: z.ZodOptional<z.ZodEnum<{
+                    normal: "normal";
+                    strong: "strong";
+                }>>;
+                italic: z.ZodOptional<z.ZodBoolean>;
+                code: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strict>>;
             items: z.ZodDefault<z.ZodArray<z.ZodObject<{
                 id: z.ZodString;
                 label: z.ZodString;
                 done: z.ZodBoolean;
+                style: z.ZodOptional<z.ZodObject<{
+                    weight: z.ZodOptional<z.ZodEnum<{
+                        normal: "normal";
+                        strong: "strong";
+                    }>>;
+                    italic: z.ZodOptional<z.ZodBoolean>;
+                    code: z.ZodOptional<z.ZodBoolean>;
+                }, z.core.$strict>>;
             }, z.core.$strict>>>;
         }, z.core.$strict>, z.ZodObject<{
             kind: z.ZodLiteral<"activity">;
             title: z.ZodOptional<z.ZodString>;
+            title_style: z.ZodOptional<z.ZodObject<{
+                weight: z.ZodOptional<z.ZodEnum<{
+                    normal: "normal";
+                    strong: "strong";
+                }>>;
+                italic: z.ZodOptional<z.ZodBoolean>;
+                code: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strict>>;
             lines: z.ZodDefault<z.ZodArray<z.ZodString>>;
         }, z.core.$strict>, z.ZodObject<{
             kind: z.ZodLiteral<"text">;
             title: z.ZodOptional<z.ZodString>;
+            title_style: z.ZodOptional<z.ZodObject<{
+                weight: z.ZodOptional<z.ZodEnum<{
+                    normal: "normal";
+                    strong: "strong";
+                }>>;
+                italic: z.ZodOptional<z.ZodBoolean>;
+                code: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strict>>;
             text: z.ZodString;
             tone: z.ZodOptional<z.ZodEnum<{
                 error: "error";
@@ -232,6 +384,14 @@ export declare const OperatorBackendTurnResultSchema: z.ZodDiscriminatedUnion<[z
                 accent: "accent";
                 dim: "dim";
             }>>;
+            style: z.ZodOptional<z.ZodObject<{
+                weight: z.ZodOptional<z.ZodEnum<{
+                    normal: "normal";
+                    strong: "strong";
+                }>>;
+                italic: z.ZodOptional<z.ZodBoolean>;
+                code: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strict>>;
         }, z.core.$strict>], "kind">>>;
         actions: z.ZodDefault<z.ZodArray<z.ZodObject<{
             id: z.ZodString;
@@ -242,8 +402,24 @@ export declare const OperatorBackendTurnResultSchema: z.ZodDiscriminatedUnion<[z
                 secondary: "secondary";
                 danger: "danger";
             }>>;
+            style: z.ZodOptional<z.ZodObject<{
+                weight: z.ZodOptional<z.ZodEnum<{
+                    normal: "normal";
+                    strong: "strong";
+                }>>;
+                italic: z.ZodOptional<z.ZodBoolean>;
+                code: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strict>>;
         }, z.core.$strict>>>;
         snapshot_compact: z.ZodString;
+        snapshot_style: z.ZodOptional<z.ZodObject<{
+            weight: z.ZodOptional<z.ZodEnum<{
+                normal: "normal";
+                strong: "strong";
+            }>>;
+            italic: z.ZodOptional<z.ZodBoolean>;
+            code: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>>;
         snapshot_multiline: z.ZodOptional<z.ZodString>;
         updated_at_ms: z.ZodNumber;
         metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;

package/dist/operator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"operator.d.ts","sourceRoot":"","sources":["../src/operator.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"operator.d.ts","sourceRoot":"","sources":["../src/operator.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@femtomc/mu-agent",
-  "version": "26.2.101",
+  "version": "26.2.102",
   "description": "Shared operator runtime for mu assistant sessions and serve extensions.",
   "keywords": [
     "mu",
@@ -24,7 +24,7 @@
     "themes/**"
   ],
   "dependencies": {
-    "@femtomc/mu-core": "26.2.101",
+    "@femtomc/mu-core": "26.2.102",
     "@mariozechner/pi-agent-core": "^0.53.0",
     "@mariozechner/pi-ai": "^0.53.0",
     "@mariozechner/pi-coding-agent": "^0.53.0",

package/prompts/skills/hud/SKILL.md

@@ -44,6 +44,7 @@ Notes:
 - `set` and `update` are both upsert-style single-doc writes.
 - `replace` is whole-inventory replacement.
 - Tool results include normalized `hud_docs` for downstream transport/rendering.
+- Advisory preset-shape warnings are surfaced in tool `details.preset_warnings` when `metadata.style_preset` and doc shape diverge (non-blocking).
 
 ### Command (`/mu hud ...`)
 
@@ -72,14 +73,15 @@ Minimum practical fields:
 Common optional fields:
 
 - `scope` (for root/session/issue scoping)
-- `chips` (`[{key,label,tone?}]`)
+- `title_style` / `snapshot_style` (`{weight?:"normal|strong", italic?:boolean, code?:boolean}`)
+- `chips` (`[{key,label,tone?,style?}]`)
 - `sections`:
-  - `kv` (key/value)
-  - `checklist` (checkbox-style progress)
-  - `activity` (recent lines)
-  - `text` (free text)
-- `actions` (`[{id,label,command_text,kind?}]`)
-- `metadata` (machine-readable extras)
+  - `kv` (key/value; supports `title_style` + item `value_style`)
+  - `checklist` (checkbox-style progress; supports `title_style` + item `style`)
+  - `activity` (recent lines; supports `title_style`)
+  - `text` (free text; supports `title_style` + `style`)
+- `actions` (`[{id,label,command_text,kind?,style?}]`)
+- `metadata` (machine-readable extras; optional `style_preset` convention: `planning|subagents`)
 
 Example checklist doc:
 
@@ -92,7 +94,7 @@ Example checklist doc:
     "title": "Planning HUD",
     "scope": "mu-root-123",
     "chips": [
-      { "key": "phase", "label": "phase:drafting", "tone": "accent" },
+      { "key": "phase", "label": "phase:drafting", "tone": "accent", "style": { "weight": "strong" } },
       { "key": "steps", "label": "steps:2/5", "tone": "dim" }
     ],
     "sections": [
@@ -107,11 +109,11 @@ Example checklist doc:
       }
     ],
     "actions": [
-      { "id": "snapshot", "label": "Snapshot", "command_text": "/mu hud snapshot", "kind": "secondary" }
+      { "id": "snapshot", "label": "Snapshot", "command_text": "/mu hud snapshot", "kind": "secondary", "style": { "italic": true } }
     ],
     "snapshot_compact": "HUD(plan) · phase=drafting · steps=2/5",
     "updated_at_ms": 1771853115000,
-    "metadata": { "phase": "drafting" }
+    "metadata": { "style_preset": "planning", "phase": "drafting" }
   }
 }
 ```

package/prompts/skills/planning/SKILL.md

@@ -117,12 +117,13 @@ Tool contract (preferred when tools are available):
     - `kv` status block (`phase`, `root`, `waiting_on_user`, `confidence`, `next_action`, `blocker`)
     - `checklist` block for plan milestones
   - actions: include useful follow-ups (for example, `snapshot`)
+  - metadata: include `style_preset:"planning"` for consistent renderer emphasis without repeating style hints
 
 Example tool calls:
 - Turn HUD on:
   - `{"action":"on"}`
 - Set/replace planning doc after investigation pass:
-  - `{"action":"set","doc":{"v":1,"hud_id":"planning","title":"Planning HUD","scope":"mu-root-123","chips":[{"key":"phase","label":"phase:investigating","tone":"dim"},{"key":"steps","label":"steps:1/4","tone":"accent"},{"key":"waiting","label":"waiting:no","tone":"dim"},{"key":"confidence","label":"conf:medium","tone":"accent"}],"sections":[{"kind":"kv","title":"Status","items":[{"key":"phase","label":"phase","value":"investigating"},{"key":"root","label":"root","value":"mu-root-123"},{"key":"waiting","label":"waiting_on_user","value":"no"},{"key":"confidence","label":"confidence","value":"medium"},{"key":"next","label":"next_action","value":"Draft root DAG"},{"key":"blocker","label":"blocker","value":"(none)"}]},{"kind":"checklist","title":"Checklist","items":[{"id":"1","label":"Investigate relevant code/docs/state","done":true},{"id":"2","label":"Create root + child issue DAG","done":false},{"id":"3","label":"Present plan + tradeoffs","done":false},{"id":"4","label":"Refine until approved","done":false}]}],"actions":[{"id":"snapshot","label":"Snapshot","command_text":"/mu hud snapshot","kind":"secondary"}],"snapshot_compact":"HUD(plan) · phase=investigating · steps=1/4 · waiting=no · conf=medium","updated_at_ms":1771853115000,"metadata":{"phase":"investigating","waiting_on_user":false,"confidence":"medium"}}}`
+  - `{"action":"set","doc":{"v":1,"hud_id":"planning","title":"Planning HUD","scope":"mu-root-123","chips":[{"key":"phase","label":"phase:investigating","tone":"dim"},{"key":"steps","label":"steps:1/4","tone":"accent"},{"key":"waiting","label":"waiting:no","tone":"dim"},{"key":"confidence","label":"conf:medium","tone":"accent"}],"sections":[{"kind":"kv","title":"Status","items":[{"key":"phase","label":"phase","value":"investigating"},{"key":"root","label":"root","value":"mu-root-123"},{"key":"waiting","label":"waiting_on_user","value":"no"},{"key":"confidence","label":"confidence","value":"medium"},{"key":"next","label":"next_action","value":"Draft root DAG"},{"key":"blocker","label":"blocker","value":"(none)"}]},{"kind":"checklist","title":"Checklist","items":[{"id":"1","label":"Investigate relevant code/docs/state","done":true},{"id":"2","label":"Create root + child issue DAG","done":false},{"id":"3","label":"Present plan + tradeoffs","done":false},{"id":"4","label":"Refine until approved","done":false}]}],"actions":[{"id":"snapshot","label":"Snapshot","command_text":"/mu hud snapshot","kind":"secondary"}],"snapshot_compact":"HUD(plan) · phase=investigating · steps=1/4 · waiting=no · conf=medium","updated_at_ms":1771853115000,"metadata":{"style_preset":"planning","phase":"investigating","waiting_on_user":false,"confidence":"medium"}}}`
 - Human-facing status line:
   - `{"action":"snapshot","snapshot_format":"compact"}`
 

package/prompts/skills/subagents/SKILL.md

@@ -192,8 +192,9 @@ Tool: `mu_hud`
   - chips: health, mode, paused
   - sections: queue counts + recent activity lines
   - actions: refresh/spawn command hooks (if desired)
+  - metadata: include `style_preset:"subagents"` for consistent renderer emphasis
 - Example update:
-  - `{"action":"set","doc":{"v":1,"hud_id":"subagents","title":"Subagents HUD","scope":"mu-root-123","chips":[{"key":"health","label":"healthy","tone":"success"},{"key":"mode","label":"mode:operator","tone":"dim"},{"key":"paused","label":"paused:no","tone":"dim"}],"sections":[{"kind":"kv","title":"Queue","items":[{"key":"ready","label":"Ready","value":"3"},{"key":"active","label":"Active","value":"2"},{"key":"sessions","label":"Sessions","value":"2"}]},{"kind":"activity","title":"Activity","lines":["Spawned worker for mu-abc123","Posted ORCH_PASS update"]}],"actions":[{"id":"refresh","label":"Refresh","command_text":"/mu hud snapshot","kind":"secondary"}],"snapshot_compact":"HUD(subagents) · healthy · mode=operator · ready=3 · active=2","updated_at_ms":1771853115000,"metadata":{"spawn_mode":"operator","spawn_paused":false}}}`
+  - `{"action":"set","doc":{"v":1,"hud_id":"subagents","title":"Subagents HUD","scope":"mu-root-123","chips":[{"key":"health","label":"healthy","tone":"success"},{"key":"mode","label":"mode:operator","tone":"dim"},{"key":"paused","label":"paused:no","tone":"dim"}],"sections":[{"kind":"kv","title":"Queue","items":[{"key":"ready","label":"Ready","value":"3"},{"key":"active","label":"Active","value":"2"},{"key":"sessions","label":"Sessions","value":"2"}]},{"kind":"activity","title":"Activity","lines":["Spawned worker for mu-abc123","Posted ORCH_PASS update"]}],"actions":[{"id":"refresh","label":"Refresh","command_text":"/mu hud snapshot","kind":"secondary"}],"snapshot_compact":"HUD(subagents) · healthy · mode=operator · ready=3 · active=2","updated_at_ms":1771853115000,"metadata":{"style_preset":"subagents","spawn_mode":"operator","spawn_paused":false}}}`
 
 ## Evaluation scenarios