@femtomc/mu-agent 26.2.106 → 26.2.108

package/README.md

@@ -22,24 +22,28 @@ These are loaded by runtime code and are the single source of truth for default
 ## Bundled starter skills
 
 Bundled starter skills live under `packages/agent/prompts/skills/` and are bootstrapped
-into `~/.mu/skills/` (or `$MU_HOME/skills/`) by the CLI store-initialization path:
-
-- `mu`
-- `memory`
-- `planning`
-- `hud`
-- `orchestration`
-- `control-flow`
-- `model-routing`
-- `code-mode`
-- `tmux`
+into `~/.mu/skills/` (or `$MU_HOME/skills/`) by the CLI store-initialization path.
+They are organized as category meta-skills plus subskills:
+
+- `core`
+  - `mu`
+  - `memory`
+  - `tmux`
+  - `code-mode`
 - `subagents`
-- `heartbeats`
-- `crons`
-- `setup-slack`
-- `setup-discord`
-- `setup-telegram`
-- `setup-neovim`
+  - `planning`
+  - `protocol`
+  - `execution`
+  - `control-flow`
+  - `model-routing`
+- `automation`
+  - `heartbeats`
+  - `crons`
+- `messaging`
+  - `setup-slack`
+  - `setup-discord`
+  - `setup-telegram`
+  - `setup-neovim`
 - `writing`
 
 Starter skills are version-synced by CLI bootstrap. Initial bootstrap seeds missing
@@ -71,9 +75,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`) 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.
+- `uiExtension` — programmable `UiDoc` surface (`/mu ui ...`, `mu_ui`) with terminal auto-prompt/awaiting behavior and deterministic action fallbacks
 
 Default operator UI theme is `mu-gruvbox-dark`.
 
@@ -82,8 +84,26 @@ Default operator UI theme is `mu-gruvbox-dark`.
 - `/mu events [n]` / `/mu events tail [n]` — event log tail
 - `/mu events watch on|off` — toggle event watch widget
 - `/mu brand on|off|toggle` — enable/disable UI branding
-- `/mu hud ...` — HUD command for enabling/inspecting/clearing HUD docs; does not inject HUD metadata into branding footer
+- `/mu ui ...` — inspect interactive `UiDoc`s (`status`/`snapshot`)
 - `/mu help` — dispatcher catalog of registered `/mu` subcommands
+- `ctrl+shift+u` — reopen local programmable-UI interaction flow (in-TUI doc/action picker, auto-fill payload-backed template values, prompt unresolved values, submit composed prompt)
+
+## Programmable UI documents
+
+Skills can publish interactive UI state via the `mu_ui` tool. Rendered `UiDoc`s survive session reconnects
+(30 minute retention per session ID), respect revision/version bumps, and route action clicks/taps back to
+plain command text via `metadata.command_text` (the `/answer` flow is the reference pattern).
+
+Actions without `metadata.command_text` are treated as non-interactive and rendered as deterministic fallback rows.
+
+Current runtime behavior is channel-specific:
+
+- Slack renders rich blocks + interactive action buttons.
+- Discord/Telegram/Neovim render text-first docs; interactive actions are tokenized, while status-profile actions deterministically degrade to command-text fallback.
+- Terminal operator UI (`mu serve`) renders docs in-widget, auto-prompts when agent publishes new runnable actions, shows `awaiting` UI status/widget state until resolved, and supports manual reopen via `ctrl+shift+u` (in-TUI picker overlay + prompt composition).
+- When interactive controls cannot be rendered, adapters append deterministic text fallback.
+
+See the [Programmable UI substrate guide](../../docs/mu-ui.md) for the full support matrix and workflow.
 
 ## Tooling model (CLI-first)
 

package/dist/extensions/index.d.ts

@@ -1,8 +1,8 @@
 export { brandingExtension } from "./branding.js";
 export { eventLogExtension } from "./event-log.js";
-export { hudExtension } from "./hud.js";
 export { muOperatorExtension } from "./mu-operator.js";
 export { muServeExtension } from "./mu-serve.js";
+export { uiExtension } from "./ui.js";
 /**
  * Serve-mode extension — single facade that bundles all serve extensions.
  */

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/extensions/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAQjD;;GAEG;AACH,eAAO,MAAM,mBAAmB,UAA4C,CAAC;AAE7E;;GAEG;AACH,eAAO,MAAM,sBAAsB,UAA+C,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/extensions/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAQtC;;GAEG;AACH,eAAO,MAAM,mBAAmB,UAA4C,CAAC;AAE7E;;GAEG;AACH,eAAO,MAAM,sBAAsB,UAA+C,CAAC"}

package/dist/extensions/index.js

@@ -1,8 +1,8 @@
 export { brandingExtension } from "./branding.js";
 export { eventLogExtension } from "./event-log.js";
-export { hudExtension } from "./hud.js";
 export { muOperatorExtension } from "./mu-operator.js";
 export { muServeExtension } from "./mu-serve.js";
+export { uiExtension } from "./ui.js";
 const RUNTIME_EXTENSION = import.meta.url.endsWith(".ts") ? "ts" : "js";
 function resolveBundledExtensionPath(moduleBasename) {
     return new URL(`./${moduleBasename}.${RUNTIME_EXTENSION}`, import.meta.url).pathname;

package/dist/extensions/mu-command-dispatcher.d.ts

@@ -4,7 +4,6 @@ export type MuSubcommandRegistration = {
     subcommand: string;
     summary: string;
     usage: string;
-    aliases?: string[];
     handler: MuSubcommandHandler;
 };
 export declare function resetMuCommandDispatcher(): void;

package/dist/extensions/mu-command-dispatcher.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mu-command-dispatcher.d.ts","sourceRoot":"","sources":["../../src/extensions/mu-command-dispatcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAE3F,MAAM,MAAM,mBAAmB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,uBAAuB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAEvG,MAAM,MAAM,wBAAwB,GAAG;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,EAAE,mBAAmB,CAAC;CAC7B,CAAC;AAcF,wBAAgB,wBAAwB,IAAI,IAAI,CAE/C;AAoHD,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,YAAY,EAAE,YAAY,EAAE,wBAAwB,GAAG,IAAI,CAsDnG"}
+{"version":3,"file":"mu-command-dispatcher.d.ts","sourceRoot":"","sources":["../../src/extensions/mu-command-dispatcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAE3F,MAAM,MAAM,mBAAmB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,uBAAuB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAEvG,MAAM,MAAM,wBAAwB,GAAG;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,mBAAmB,CAAC;CAC7B,CAAC;AAYF,wBAAgB,wBAAwB,IAAI,IAAI,CAE/C;AA+GD,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,YAAY,EAAE,YAAY,EAAE,wBAAwB,GAAG,IAAI,CAmBnG"}

package/dist/extensions/mu-command-dispatcher.js

@@ -10,8 +10,7 @@ function isValidSubcommandToken(value) {
     return /^[a-z][a-z0-9_-]*$/.test(value);
 }
 function subcommandUsageSummary(entry) {
-    const aliasSuffix = entry.aliases && entry.aliases.length > 0 ? ` (aliases: ${entry.aliases.join(", ")})` : "";
-    return `- ${entry.usage} — ${entry.summary}${aliasSuffix}`;
+    return `- ${entry.usage} — ${entry.summary}`;
 }
 function renderSubcommandCatalog(state) {
     if (state.entries.size === 0) {
@@ -26,11 +25,7 @@ function renderSubcommandCatalog(state) {
     return lines.join("\n");
 }
 function renderSubcommandHelp(entry) {
-    const lines = [entry.summary, "", `Usage: ${entry.usage}`];
-    if (entry.aliases && entry.aliases.length > 0) {
-        lines.push(`Aliases: ${entry.aliases.map((alias) => `/mu ${alias}`).join(", ")}`);
-    }
-    return lines.join("\n");
+    return [entry.summary, "", `Usage: ${entry.usage}`].join("\n");
 }
 function parseInvocation(args) {
     const trimmed = args.trim();
@@ -48,10 +43,10 @@ function parseInvocation(args) {
 }
 function resolveEntry(state, token) {
     const normalized = normalizeSubcommand(token);
-    if (!normalized)
+    if (!normalized) {
         return null;
-    const canonical = state.aliases.get(normalized) ?? normalized;
-    return state.entries.get(canonical) ?? null;
+    }
+    return state.entries.get(normalized) ?? null;
 }
 function ensureDispatcher(pi) {
     if (singletonState) {
@@ -59,7 +54,6 @@ function ensureDispatcher(pi) {
     }
     const state = {
         entries: new Map(),
-        aliases: new Map(),
     };
     singletonState = state;
     pi.registerCommand("mu", {
@@ -106,40 +100,9 @@ export function registerMuSubcommand(pi, registration) {
     if (!registration.usage.startsWith("/mu ")) {
         throw new Error(`mu subcommand usage must start with '/mu ': ${registration.usage}`);
     }
-    const normalizedAliases = (registration.aliases ?? [])
-        .map((alias) => normalizeSubcommand(alias))
-        .filter((alias) => alias.length > 0 && alias !== normalizedSubcommand);
-    for (const alias of normalizedAliases) {
-        if (!isValidSubcommandToken(alias)) {
-            throw new Error(`Invalid mu subcommand alias: ${alias}`);
-        }
-        if (RESERVED_SUBCOMMANDS.has(alias)) {
-            throw new Error(`Reserved mu subcommand alias: ${alias}`);
-        }
-    }
-    const existing = state.entries.get(normalizedSubcommand);
-    if (existing) {
-        for (const alias of existing.normalizedAliases) {
-            state.aliases.delete(alias);
-        }
-    }
-    for (const alias of normalizedAliases) {
-        const occupiedBy = state.aliases.get(alias);
-        if (occupiedBy && occupiedBy !== normalizedSubcommand) {
-            throw new Error(`mu subcommand alias '${alias}' is already registered by '${occupiedBy}'`);
-        }
-        if (state.entries.has(alias) && alias !== normalizedSubcommand) {
-            throw new Error(`mu subcommand alias '${alias}' conflicts with existing subcommand`);
-        }
-    }
     const entry = {
         ...registration,
         normalizedSubcommand,
-        normalizedAliases,
     };
     state.entries.set(normalizedSubcommand, entry);
-    state.aliases.set(normalizedSubcommand, normalizedSubcommand);
-    for (const alias of normalizedAliases) {
-        state.aliases.set(alias, normalizedSubcommand);
-    }
 }

package/dist/extensions/mu-operator.js

@@ -6,9 +6,9 @@
  */
 import { brandingExtension } from "./branding.js";
 import { eventLogExtension } from "./event-log.js";
-import { hudExtension } from "./hud.js";
+import { uiExtension } from "./ui.js";
 export function muOperatorExtension(pi) {
-    hudExtension(pi);
+    uiExtension(pi);
     brandingExtension(pi);
     eventLogExtension(pi);
 }

package/dist/extensions/mu-serve.js

@@ -6,9 +6,9 @@
  */
 import { brandingExtension } from "./branding.js";
 import { eventLogExtension } from "./event-log.js";
-import { hudExtension } from "./hud.js";
+import { uiExtension } from "./ui.js";
 export function muServeExtension(pi) {
-    hudExtension(pi);
+    uiExtension(pi);
     brandingExtension(pi);
     eventLogExtension(pi);
 }

package/dist/extensions/ui.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../../src/extensions/ui.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,YAAY,EAAoB,MAAM,+BAA+B,CAAC;AA8+BpF,wBAAgB,WAAW,CAAC,EAAE,EAAE,YAAY,QA2N3C;AAED,eAAe,WAAW,CAAC"}