@femtomc/mu-agent 26.2.99 → 26.2.101

package/README.md

@@ -27,6 +27,7 @@ into `~/.mu/skills/` (or `$MU_HOME/skills/`) when missing:
 - `mu`
 - `memory`
 - `planning`
+- `hud`
 - `hierarchical-work-protocol`
 - `subagents`
 - `heartbeats`
@@ -36,6 +37,9 @@ into `~/.mu/skills/` (or `$MU_HOME/skills/`) when missing:
 - `setup-telegram`
 - `setup-neovim`
 
+Starter skills are version-synced by the CLI bootstrap path when users run `mu`
+commands after upgrading.
+
 ## Install
 
 ```bash
@@ -62,8 +66,9 @@ Current stack:
 
 - `brandingExtension` — mu compact header/footer branding + default theme
 - `eventLogExtension` — event tail + watch widget
-- `planningUiExtension` — planning mode: compact HUD for next-step/approval flow in widget/status surfaces while keeping the branding footer unchanged (`/mu plan ...`)
-- `subagentsUiExtension` — subagents mode: compact HUD with activity sentences from issue/forum events, with state kept in widget/status surfaces while branding footer stays unchanged (`/mu subagents ...`)
+- `hudExtension` — HUD surface for skill-directed planning/subagents communication (`/mu hud ...`, `mu_hud`)
+
+Extensions emit contract-valid `hud_docs` (`HudDoc`) so control-plane/server renderers can provide a consistent cross-surface HUD experience.
 
 Default operator UI theme is `mu-gruvbox-dark`.
 
@@ -72,8 +77,7 @@ 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 plan ...` — planning HUD (phases, checklist editing, communication state, snapshots); does not inject planning metadata into branding footer
-- `/mu subagents ...` — tmux + issue queue monitor/spawner (profiles, spawn pause, stale/refresh controls, snapshots); does not inject subagents metadata into branding footer
+- `/mu hud ...` — HUD command for enabling/inspecting/clearing HUD docs; does not inject HUD metadata into branding footer
 - `/mu help` — dispatcher catalog of registered `/mu` subcommands
 
 ## Tooling model (CLI-first)

package/dist/extensions/hud.d.ts

@@ -0,0 +1,4 @@
+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

@@ -0,0 +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"}

package/dist/extensions/hud.js

@@ -0,0 +1,282 @@
+import { 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;
+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 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 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" });
+}
+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 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 },
+            };
+        }
+        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}).` };
+        }
+        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/dist/extensions/index.d.ts

@@ -1,9 +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 { planningUiExtension } from "./planning-ui.js";
-export { subagentsUiExtension } from "./subagents-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,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAQzD;;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,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"}

package/dist/extensions/index.js

@@ -1,9 +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 { planningUiExtension } from "./planning-ui.js";
-export { subagentsUiExtension } from "./subagents-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-operator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mu-operator.d.ts","sourceRoot":"","sources":["../../src/extensions/mu-operator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAMlE,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,YAAY,QAKnD;AAED,eAAe,mBAAmB,CAAC"}
+{"version":3,"file":"mu-operator.d.ts","sourceRoot":"","sources":["../../src/extensions/mu-operator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAKlE,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,YAAY,QAInD;AAED,eAAe,mBAAmB,CAAC"}

package/dist/extensions/mu-operator.js

@@ -6,12 +6,10 @@
  */
 import { brandingExtension } from "./branding.js";
 import { eventLogExtension } from "./event-log.js";
-import { planningUiExtension } from "./planning-ui.js";
-import { subagentsUiExtension } from "./subagents-ui.js";
+import { hudExtension } from "./hud.js";
 export function muOperatorExtension(pi) {
+    hudExtension(pi);
     brandingExtension(pi);
     eventLogExtension(pi);
-    planningUiExtension(pi);
-    subagentsUiExtension(pi);
 }
 export default muOperatorExtension;

package/dist/extensions/mu-serve.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mu-serve.d.ts","sourceRoot":"","sources":["../../src/extensions/mu-serve.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAMlE,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,YAAY,QAKhD;AAED,eAAe,gBAAgB,CAAC"}
+{"version":3,"file":"mu-serve.d.ts","sourceRoot":"","sources":["../../src/extensions/mu-serve.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAKlE,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,YAAY,QAIhD;AAED,eAAe,gBAAgB,CAAC"}

package/dist/extensions/mu-serve.js

@@ -6,12 +6,10 @@
  */
 import { brandingExtension } from "./branding.js";
 import { eventLogExtension } from "./event-log.js";
-import { planningUiExtension } from "./planning-ui.js";
-import { subagentsUiExtension } from "./subagents-ui.js";
+import { hudExtension } from "./hud.js";
 export function muServeExtension(pi) {
+    hudExtension(pi);
     brandingExtension(pi);
     eventLogExtension(pi);
-    planningUiExtension(pi);
-    subagentsUiExtension(pi);
 }
 export default muServeExtension;

package/dist/operator.d.ts

@@ -1,3 +1,4 @@
+import { type HudDoc } from "@femtomc/mu-core";
 import { z } from "zod";
 import { CommandContextResolver } from "./command_context.js";
 import { type CreateMuSessionOpts, type MuSession } from "./session_factory.js";
@@ -58,6 +59,82 @@ export type OperatorApprovedCommand = z.infer<typeof OperatorApprovedCommandSche
 export declare const OperatorBackendTurnResultSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     kind: z.ZodLiteral<"respond">;
     message: z.ZodString;
+    hud_docs: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        v: z.ZodDefault<z.ZodLiteral<1>>;
+        hud_id: z.ZodString;
+        title: z.ZodString;
+        scope: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        chips: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            key: z.ZodString;
+            label: z.ZodString;
+            tone: z.ZodOptional<z.ZodEnum<{
+                error: "error";
+                info: "info";
+                success: "success";
+                warning: "warning";
+                muted: "muted";
+                accent: "accent";
+                dim: "dim";
+            }>>;
+        }, z.core.$strict>>>;
+        sections: z.ZodDefault<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"kv">;
+            title: z.ZodOptional<z.ZodString>;
+            items: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                key: z.ZodString;
+                label: z.ZodString;
+                value: z.ZodString;
+                tone: z.ZodOptional<z.ZodEnum<{
+                    error: "error";
+                    info: "info";
+                    success: "success";
+                    warning: "warning";
+                    muted: "muted";
+                    accent: "accent";
+                    dim: "dim";
+                }>>;
+            }, z.core.$strict>>>;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"checklist">;
+            title: z.ZodOptional<z.ZodString>;
+            items: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                label: z.ZodString;
+                done: z.ZodBoolean;
+            }, z.core.$strict>>>;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"activity">;
+            title: z.ZodOptional<z.ZodString>;
+            lines: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"text">;
+            title: z.ZodOptional<z.ZodString>;
+            text: z.ZodString;
+            tone: z.ZodOptional<z.ZodEnum<{
+                error: "error";
+                info: "info";
+                success: "success";
+                warning: "warning";
+                muted: "muted";
+                accent: "accent";
+                dim: "dim";
+            }>>;
+        }, z.core.$strict>], "kind">>>;
+        actions: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            label: z.ZodString;
+            command_text: z.ZodString;
+            kind: z.ZodOptional<z.ZodEnum<{
+                primary: "primary";
+                secondary: "secondary";
+                danger: "danger";
+            }>>;
+        }, z.core.$strict>>>;
+        snapshot_compact: z.ZodString;
+        snapshot_multiline: z.ZodOptional<z.ZodString>;
+        updated_at_ms: z.ZodNumber;
+        metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strict>>>;
 }, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<"command">;
     command: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -95,6 +172,82 @@ export declare const OperatorBackendTurnResultSchema: z.ZodDiscriminatedUnion<[z
         kind: z.ZodLiteral<"operator_thinking_set">;
         thinking: z.ZodString;
     }, z.core.$strip>], "kind">;
+    hud_docs: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        v: z.ZodDefault<z.ZodLiteral<1>>;
+        hud_id: z.ZodString;
+        title: z.ZodString;
+        scope: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        chips: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            key: z.ZodString;
+            label: z.ZodString;
+            tone: z.ZodOptional<z.ZodEnum<{
+                error: "error";
+                info: "info";
+                success: "success";
+                warning: "warning";
+                muted: "muted";
+                accent: "accent";
+                dim: "dim";
+            }>>;
+        }, z.core.$strict>>>;
+        sections: z.ZodDefault<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"kv">;
+            title: z.ZodOptional<z.ZodString>;
+            items: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                key: z.ZodString;
+                label: z.ZodString;
+                value: z.ZodString;
+                tone: z.ZodOptional<z.ZodEnum<{
+                    error: "error";
+                    info: "info";
+                    success: "success";
+                    warning: "warning";
+                    muted: "muted";
+                    accent: "accent";
+                    dim: "dim";
+                }>>;
+            }, z.core.$strict>>>;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"checklist">;
+            title: z.ZodOptional<z.ZodString>;
+            items: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                label: z.ZodString;
+                done: z.ZodBoolean;
+            }, z.core.$strict>>>;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"activity">;
+            title: z.ZodOptional<z.ZodString>;
+            lines: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"text">;
+            title: z.ZodOptional<z.ZodString>;
+            text: z.ZodString;
+            tone: z.ZodOptional<z.ZodEnum<{
+                error: "error";
+                info: "info";
+                success: "success";
+                warning: "warning";
+                muted: "muted";
+                accent: "accent";
+                dim: "dim";
+            }>>;
+        }, z.core.$strict>], "kind">>>;
+        actions: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            label: z.ZodString;
+            command_text: z.ZodString;
+            kind: z.ZodOptional<z.ZodEnum<{
+                primary: "primary";
+                secondary: "secondary";
+                danger: "danger";
+            }>>;
+        }, z.core.$strict>>>;
+        snapshot_compact: z.ZodString;
+        snapshot_multiline: z.ZodOptional<z.ZodString>;
+        updated_at_ms: z.ZodNumber;
+        metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strict>>>;
 }, z.core.$strip>], "kind">;
 export type OperatorBackendTurnResult = z.infer<typeof OperatorBackendTurnResultSchema>;
 export type OperatorBackendTurnInput = {
@@ -111,11 +264,13 @@ export interface MessagingOperatorBackend {
 export type OperatorDecision = {
     kind: "response";
     message: string;
+    hud_docs?: HudDoc[];
     operatorSessionId: string;
     operatorTurnId: string;
 } | {
     kind: "command";
     commandText: string;
+    hud_docs?: HudDoc[];
     operatorSessionId: string;
     operatorTurnId: string;
 } | {

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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"}