@femtomc/mu-agent 26.2.107 → 26.2.108

package/dist/extensions/hud.d.ts

@@ -1,4 +0,0 @@
-import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
-export declare function hudExtension(pi: ExtensionAPI): void;
-export default hudExtension;
-//# sourceMappingURL=hud.d.ts.map

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

@@ -1 +0,0 @@
-{"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,483 +0,0 @@
-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,
-        docsById: new Map(),
-    };
-}
-function parseSnapshotFormat(raw) {
-    const value = (raw ?? "compact").trim().toLowerCase();
-    return value === "multiline" ? "multiline" : "compact";
-}
-function short(text, max = HUD_LINE_MAX) {
-    const normalized = text.replace(/\s+/g, " ").trim();
-    if (normalized.length <= max) {
-        return normalized;
-    }
-    if (max <= 1) {
-        return "…";
-    }
-    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 });
-}
-function statusSummary(state) {
-    const docs = activeDocs(state, HUD_STORE_DOCS_MAX);
-    const ids = docs.map((doc) => doc.hud_id).join(", ") || "(none)";
-    return [
-        `HUD: ${state.enabled ? "enabled" : "disabled"}`,
-        `docs: ${docs.length}`,
-        `ids: ${ids}`,
-    ].join("\n");
-}
-function renderHud(ctx, state) {
-    if (!ctx.hasUI) {
-        return;
-    }
-    const docs = activeDocs(state);
-    if (!state.enabled || docs.length === 0) {
-        ctx.ui.setStatus("mu-hud", undefined);
-        ctx.ui.setWidget("mu-hud", undefined);
-        return;
-    }
-    const idLabel = short(docs.map((doc) => doc.hud_id).join(", "), 64);
-    ctx.ui.setStatus("mu-hud", [
-        ctx.ui.theme.fg("dim", "hud"),
-        ctx.ui.theme.fg("muted", "·"),
-        ctx.ui.theme.fg("accent", `${docs.length}`),
-        ctx.ui.theme.fg("muted", "·"),
-        ctx.ui.theme.fg("dim", idLabel),
-    ].join(" "));
-    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);
-    if (!parsed.success) {
-        return { ok: false, error: parsed.error.issues[0]?.message ?? "Invalid HUD doc." };
-    }
-    return { ok: true, doc: parsed.data };
-}
-function parseHudDocList(input) {
-    if (!Array.isArray(input)) {
-        return { ok: false, error: "docs must be an array." };
-    }
-    const docs = [];
-    for (let idx = 0; idx < input.length; idx += 1) {
-        const parsed = parseHudDoc(input[idx]);
-        if (!parsed.ok) {
-            return { ok: false, error: `docs[${idx}]: ${parsed.error}` };
-        }
-        docs.push(parsed.doc);
-    }
-    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 {
-        content: [{ type: "text", text: opts.message }],
-        hud_docs: docs,
-        details: {
-            ok: opts.ok,
-            action: opts.action,
-            enabled: opts.state.enabled,
-            doc_count: docs.length,
-            hud_ids: docs.map((doc) => doc.hud_id),
-            ...(opts.ok ? {} : { error: opts.message }),
-            ...(opts.extra ?? {}),
-        },
-    };
-}
-function applyHudAction(params, state) {
-    switch (params.action) {
-        case "status": {
-            return {
-                ok: true,
-                action: "status",
-                message: statusSummary(state),
-            };
-        }
-        case "snapshot": {
-            const mode = parseSnapshotFormat(params.snapshot_format);
-            const docs = activeDocs(state, HUD_STORE_DOCS_MAX);
-            const message = docs.length
-                ? serializeHudDocsTextFallback(docs, { mode, maxDocs: HUD_STORE_DOCS_MAX, maxSectionItems: 8, maxActions: 6 })
-                : "(no HUD docs)";
-            return {
-                ok: true,
-                action: "snapshot",
-                message,
-                extra: { snapshot_format: mode },
-            };
-        }
-        case "on":
-            state.enabled = true;
-            return { ok: true, action: "on", message: "HUD enabled." };
-        case "off":
-            state.enabled = false;
-            return { ok: true, action: "off", message: "HUD disabled." };
-        case "toggle":
-            state.enabled = !state.enabled;
-            return { ok: true, action: "toggle", message: `HUD ${state.enabled ? "enabled" : "disabled"}.` };
-        case "set":
-        case "update": {
-            const parsed = parseHudDoc(params.doc);
-            if (!parsed.ok) {
-                return { ok: false, action: params.action, message: parsed.error };
-            }
-            state.enabled = true;
-            state.docsById.set(parsed.doc.hud_id, parsed.doc);
-            return {
-                ok: true,
-                action: params.action,
-                message: `HUD doc set: ${parsed.doc.hud_id}`,
-                extra: { hud_id: parsed.doc.hud_id, ...presetWarningsExtraForDoc(parsed.doc) },
-            };
-        }
-        case "replace": {
-            const parsed = parseHudDocList(params.docs);
-            if (!parsed.ok) {
-                return { ok: false, action: "replace", message: parsed.error };
-            }
-            state.docsById.clear();
-            for (const doc of parsed.docs) {
-                state.docsById.set(doc.hud_id, doc);
-            }
-            state.enabled = true;
-            return {
-                ok: true,
-                action: "replace",
-                message: `HUD docs replaced (${parsed.docs.length}).`,
-                extra: presetWarningsExtraForDocs(parsed.docs),
-            };
-        }
-        case "remove": {
-            const hudId = (params.hud_id ?? "").trim();
-            if (!hudId) {
-                return { ok: false, action: "remove", message: "Missing hud_id." };
-            }
-            const removed = state.docsById.delete(hudId);
-            if (!removed) {
-                return { ok: false, action: "remove", message: `HUD doc not found: ${hudId}` };
-            }
-            return { ok: true, action: "remove", message: `HUD doc removed: ${hudId}` };
-        }
-        case "clear":
-            state.docsById.clear();
-            return { ok: true, action: "clear", message: "HUD docs cleared." };
-    }
-}
-function usageText() {
-    return [
-        "Usage:",
-        "  /mu hud status|snapshot",
-        "  /mu hud on|off|toggle",
-        "  /mu hud clear",
-        "  /mu hud remove <hud-id>",
-        "",
-        "For setting/updating docs, use the mu_hud tool with action=set|update|replace.",
-    ].join("\n");
-}
-function parseCommandAction(args) {
-    const tokens = args
-        .trim()
-        .split(/\s+/)
-        .filter((token) => token.length > 0);
-    const command = tokens[0] ?? "status";
-    switch (command) {
-        case "status":
-            return { action: "status" };
-        case "snapshot":
-            return { action: "snapshot", snapshot_format: tokens[1] };
-        case "on":
-            return { action: "on" };
-        case "off":
-            return { action: "off" };
-        case "toggle":
-            return { action: "toggle" };
-        case "clear":
-            return { action: "clear" };
-        case "remove":
-            return { action: "remove", hud_id: tokens[1] };
-        default:
-            return null;
-    }
-}
-export function hudExtension(pi) {
-    const state = createDefaultState();
-    const refresh = (ctx) => {
-        renderHud(ctx, state);
-    };
-    pi.on("session_start", async (_event, ctx) => {
-        refresh(ctx);
-    });
-    pi.on("session_switch", async (_event, ctx) => {
-        refresh(ctx);
-    });
-    pi.on("session_shutdown", async (_event, ctx) => {
-        if (!ctx.hasUI) {
-            return;
-        }
-        ctx.ui.setStatus("mu-hud", undefined);
-        ctx.ui.setWidget("mu-hud", undefined);
-    });
-    registerMuSubcommand(pi, {
-        subcommand: "hud",
-        summary: "HUD status and rendering controls",
-        usage: "/mu hud status|snapshot|on|off|toggle|clear|remove <hud-id>",
-        handler: async (args, ctx) => {
-            const parsed = parseCommandAction(args);
-            if (!parsed) {
-                ctx.ui.notify(usageText(), "error");
-                return;
-            }
-            const result = applyHudAction(parsed, state);
-            refresh(ctx);
-            ctx.ui.notify(result.message, result.ok ? "info" : "error");
-        },
-    });
-    pi.registerTool({
-        name: "mu_hud",
-        label: "mu HUD",
-        description: "Control or inspect HUD docs rendered in the TUI and shared across channel renderers.",
-        parameters: {
-            type: "object",
-            properties: {
-                action: {
-                    type: "string",
-                    enum: ["status", "snapshot", "on", "off", "toggle", "set", "update", "replace", "remove", "clear"],
-                },
-                doc: { type: "object", additionalProperties: true },
-                docs: { type: "array", items: { type: "object", additionalProperties: true } },
-                hud_id: { type: "string" },
-                snapshot_format: { type: "string", enum: ["compact", "multiline"] },
-            },
-            required: ["action"],
-            additionalProperties: false,
-        },
-        execute: async (_toolCallId, paramsRaw, _signal, _onUpdate, ctx) => {
-            const params = paramsRaw;
-            const result = applyHudAction(params, state);
-            refresh(ctx);
-            return hudToolResult({
-                state,
-                ok: result.ok,
-                action: result.action,
-                message: result.message,
-                extra: result.extra,
-            });
-        },
-    });
-}
-export default hudExtension;

package/prompts/skills/subagents/hud/SKILL.md

@@ -1,205 +0,0 @@
----
-name: hud
-description: "Defines HUD usage for `mu_hud` and `/mu hud`, including doc schema patterns, deterministic update rules, and rendering-safe conventions."
----
-
-# hud
-
-Use this skill whenever you need to publish, update, or inspect HUD state.
-
-This skill is the canonical HUD reference for:
-
-- `mu_hud` tool calls (structured HUD state)
-- `/mu hud ...` command usage (inspection/control)
-- `HudDoc` conventions that render well in TUI/Slack/Telegram
-
-## Contents
-
-- [Core contract](#core-contract)
-- [HudDoc shape](#huddoc-shape)
-- [Recommended turn loop](#recommended-turn-loop)
-- [Ownership and teardown protocol](#ownership-and-teardown-protocol)
-- [Planning, subagents, and model-routing profiles](#planning-subagents-and-model-routing-profiles)
-- [Determinism and rendering limits](#determinism-and-rendering-limits)
-- [Evaluation scenarios](#evaluation-scenarios)
-
-## Core contract
-
-### Tool (`mu_hud`)
-
-Actions:
-
-- `status`, `snapshot`
-- `on`, `off`, `toggle`
-- `set`, `update`, `replace`, `remove`, `clear`
-
-Key params:
-
-- `doc` (for `set`/`update`)
-- `docs` (for `replace`)
-- `hud_id` (for `remove`)
-- `snapshot_format` (`compact` or `multiline`)
-
-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 ...`)
-
-Supported subcommands:
-
-- `/mu hud status`
-- `/mu hud snapshot [compact|multiline]`
-- `/mu hud on|off|toggle`
-- `/mu hud clear`
-- `/mu hud remove <hud-id>`
-
-Use the tool (`mu_hud`) for structured doc writes.
-
-## HudDoc shape
-
-HUD docs are validated against `HudDoc` (`@femtomc/mu-core`).
-
-Minimum practical fields:
-
-- `v: 1`
-- `hud_id: <non-empty>`
-- `title: <non-empty>`
-- `snapshot_compact: <non-empty>`
-- `updated_at_ms: <int>`
-
-Common optional fields:
-
-- `scope` (for root/session/issue scoping)
-- `title_style` / `snapshot_style` (`{weight?:"normal|strong", italic?:boolean, code?:boolean}`)
-- `chips` (`[{key,label,tone?,style?}]`)
-- `sections`:
-  - `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:
-
-```json
-{
-  "action": "set",
-  "doc": {
-    "v": 1,
-    "hud_id": "planning",
-    "title": "Planning HUD",
-    "scope": "mu-root-123",
-    "chips": [
-      { "key": "phase", "label": "phase:drafting", "tone": "accent", "style": { "weight": "strong" } },
-      { "key": "steps", "label": "steps:2/5", "tone": "dim" }
-    ],
-    "sections": [
-      {
-        "kind": "checklist",
-        "title": "Checklist",
-        "items": [
-          { "id": "1", "label": "Investigate", "done": true },
-          { "id": "2", "label": "Draft DAG", "done": true },
-          { "id": "3", "label": "Review", "done": false }
-        ]
-      }
-    ],
-    "actions": [
-      { "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": { "style_preset": "planning", "phase": "drafting" }
-  }
-}
-```
-
-## Recommended turn loop
-
-1. Ensure HUD is on:
-
-```json
-{"action":"on"}
-```
-
-2. Upsert exactly the docs you own (`set`/`update`).
-3. Emit compact snapshot for user-facing status:
-
-```json
-{"action":"snapshot","snapshot_format":"compact"}
-```
-
-4. Keep response text and HUD state aligned (no contradictions).
-
-## Ownership and teardown protocol
-
-HUD-using skills should treat HUD state as owned, explicit, and non-optional when
-that skill declares HUD-required behavior.
-
-1. **Own explicit `hud_id` values**
-   - Each active skill owns one canonical doc id (for example `planning`,
-     `subagents`, `control-flow`, `model-routing`).
-   - Prefer `remove <hud_id>` over `clear` to avoid deleting other skills’ docs.
-
-2. **Teardown is mandatory at skill end**
-   - When a HUD-owning skill completes, remove its doc(s).
-   - If no other HUD-owning skill is active next, turn HUD off.
-
-3. **Teardown during HUD-to-HUD handoff**
-   - Remove current skill doc(s), keep HUD enabled, then let next skill set its doc.
-   - Never leave stale docs from prior skills during handoff.
-
-Example teardown/handoff calls:
-
-```json
-{"action":"remove","hud_id":"planning"}
-{"action":"set","doc":{"v":1,"hud_id":"subagents","title":"Subagents HUD","snapshot_compact":"HUD(subagents)","updated_at_ms":1771853115001}}
-```
-
-Example full teardown (no next HUD skill):
-
-```json
-{"action":"remove","hud_id":"subagents"}
-{"action":"off"}
-```
-
-## Planning, subagents, and model-routing profiles
-
-Use profile-specific `hud_id` values:
-
-- planning profile: `hud_id: "planning"`
-- subagents profile: `hud_id: "subagents"`
-- model-routing profile: `hud_id: "model-routing"`
-
-Treat these as conventions layered on top of this generic contract.
-
-## Determinism and rendering limits
-
-- Keep one canonical doc per `hud_id`.
-- Keep `updated_at_ms` monotonic for each `hud_id`.
-- Prefer a small doc set (usually 1–3 docs total) for channel readability.
-- Keep command actions concise; long commands may degrade to text-only fallbacks on some channels.
-- Assume channel renderers cap docs/actions/lines; put critical state in `snapshot_compact` and first section items.
-
-If behavior is unclear, inspect implementation/tests before guessing:
-
-- `packages/core/src/hud.ts`
-- `packages/agent/src/extensions/hud.ts`
-- `packages/server/src/control_plane.ts`
-- `packages/agent/test/hud_tool.test.ts`
-
-## Evaluation scenarios
-
-1. **Planning review turn**
-   - Expected: `planning` doc updates phase/checklist/waiting state, then emits compact snapshot.
-
-2. **Subagents orchestration pass**
-   - Expected: `subagents` doc updates queue/activity/chips after each bounded pass.
-
-3. **HUD reset handoff**
-   - Expected: after phase completion, owned HUD docs are removed; HUD is turned off when no next HUD skill is active, or ownership cleanly hands off to the next skill with no stale docs.