@femtomc/mu-agent 26.2.68 → 26.2.70

package/README.md

@@ -45,13 +45,15 @@ not anonymous inline factories).
 
 Current stack:
 
-- `brandingExtension` — mu header/footer/widgets
+- `brandingExtension` — mu compact header/footer branding + default theme
 - `serverToolsExtension` — status + issues/forum/events/control-plane tools
 - `eventLogExtension` — event tail + watch widget
 - `messagingSetupExtension` — adapter diagnostics and setup guidance
 
 `mu serve` sets `MU_SERVER_URL` automatically for these extensions.
 
+Default operator UI theme is `mu-gruvbox-dark`.
+
 ## Slash commands (operator-facing)
 
 - `/mu status` — concise server status
@@ -81,6 +83,23 @@ Current stack:
   - `action`: `check | preflight | guide | plan | apply | verify`
   - `adapter`: `slack | discord | telegram | gmail`
 
+### Query contract (context-safe by default)
+
+Read-heavy `mu_*` tools are designed to be summary-first, with explicit narrowing:
+
+- `limit` controls result size (default is usually `20` for list/query/read actions).
+- `contains` performs case-insensitive content filtering where relevant.
+- `fields` (comma-separated paths) supports precise retrieval on targeted actions (`get`, `status`, `trace`, etc.).
+
+Recommended flow:
+
+1. Discover with bounded list/query (`limit` + filters).
+2. Select a concrete ID.
+3. Retrieve only required fields via `fields`.
+
+Tool `details` may still include richer payloads for diagnostics, but `content` is
+kept compact to reduce context pollution.
+
 ## Messaging setup notes
 
 - Runtime setup state comes from `GET /api/config` and `.mu/config.json`.

package/dist/backend.d.ts

@@ -40,6 +40,7 @@ export type CreateMuResourceLoaderOpts = {
     settingsManager?: SettingsManager;
     additionalExtensionPaths?: string[];
     additionalSkillPaths?: string[];
+    additionalThemePaths?: string[];
 };
 export declare function createMuResourceLoader(opts: CreateMuResourceLoaderOpts): DefaultResourceLoader;
 //# sourceMappingURL=backend.d.ts.map

package/dist/backend.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"backend.d.ts","sourceRoot":"","sources":["../src/backend.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAEjD,OAAO,EACN,WAAW,EAOX,qBAAqB,EAErB,eAAe,EACf,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAE5C,MAAM,MAAM,cAAc,GAAG;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,WAAW,aAAa;IAC7B,GAAG,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC3C;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CA4BpD;AAGD;;;;;GAKG;AACH,wBAAgB,YAAY,CAC3B,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,WAAW,EACxB,kBAAkB,CAAC,EAAE,MAAM,GACzB,KAAK,CAAC,GAAG,CAAC,GAAG,SAAS,CA6BxB;AAED;;;;GAIG;AACH,qBAAa,UAAW,YAAW,aAAa;IACzC,GAAG,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC;CAiGhD;AAGD,MAAM,MAAM,0BAA0B,GAAG;IACxC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,wBAAwB,CAAC,EAAE,MAAM,EAAE,CAAC;IACpC,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;CAChC,CAAC;AAEF,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,0BAA0B,GAAG,qBAAqB,CAuB9F"}
+{"version":3,"file":"backend.d.ts","sourceRoot":"","sources":["../src/backend.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAEjD,OAAO,EACN,WAAW,EAOX,qBAAqB,EAErB,eAAe,EACf,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAI5C,MAAM,MAAM,cAAc,GAAG;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,WAAW,aAAa;IAC7B,GAAG,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC3C;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CA4BpD;AAGD;;;;;GAKG;AACH,wBAAgB,YAAY,CAC3B,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,WAAW,EACxB,kBAAkB,CAAC,EAAE,MAAM,GACzB,KAAK,CAAC,GAAG,CAAC,GAAG,SAAS,CA6BxB;AAED;;;;GAIG;AACH,qBAAa,UAAW,YAAW,aAAa;IACzC,GAAG,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC;CAmGhD;AAGD,MAAM,MAAM,0BAA0B,GAAG;IACxC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,wBAAwB,CAAC,EAAE,MAAM,EAAE,CAAC;IACpC,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;CAChC,CAAC;AAEF,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,0BAA0B,GAAG,qBAAqB,CA6B9F"}

package/dist/backend.js

@@ -3,6 +3,8 @@ import { mkdir, open } from "node:fs/promises";
 import { basename, dirname, join } from "node:path";
 import { getModels, getProviders } from "@mariozechner/pi-ai";
 import { AuthStorage, createAgentSession, createBashTool, createEditTool, createReadTool, createWriteTool, DefaultResourceLoader, SessionManager, SettingsManager, } from "@mariozechner/pi-coding-agent";
+import { orchestratorToolExtensionPaths, workerToolExtensionPaths } from "./extensions/index.js";
+import { MU_DEFAULT_THEME_NAME, MU_DEFAULT_THEME_PATH } from "./ui_defaults.js";
 export function streamHasError(line) {
     let event;
     try {
@@ -75,11 +77,13 @@ export class SdkBackend {
             const scope = opts.provider ? ` in provider "${opts.provider}"` : "";
             throw new Error(`Model "${opts.model}" not found${scope} in pi-ai registry.`);
         }
-        const settingsManager = SettingsManager.inMemory();
+        const settingsManager = SettingsManager.inMemory({ theme: MU_DEFAULT_THEME_NAME, quietStartup: true });
+        const roleExtensionPaths = opts.role === "worker" ? workerToolExtensionPaths : orchestratorToolExtensionPaths;
         const resourceLoader = createMuResourceLoader({
             cwd: opts.cwd,
             systemPrompt: opts.systemPrompt,
             settingsManager,
+            additionalExtensionPaths: roleExtensionPaths,
         });
         await resourceLoader.reload();
         const tools = [
@@ -159,6 +163,10 @@ export function createMuResourceLoader(opts) {
     for (const p of opts.additionalSkillPaths ?? []) {
         skillPaths.add(p);
     }
+    const themePaths = new Set([MU_DEFAULT_THEME_PATH]);
+    for (const p of opts.additionalThemePaths ?? []) {
+        themePaths.add(p);
+    }
     // If a repo has a top-level `skills/` dir (like workshop/), load it.
     const repoSkills = join(opts.cwd, "skills");
     if (existsSync(repoSkills)) {
@@ -167,9 +175,10 @@ export function createMuResourceLoader(opts) {
     return new DefaultResourceLoader({
         cwd: opts.cwd,
         agentDir: opts.agentDir,
-        settingsManager: opts.settingsManager ?? SettingsManager.inMemory(),
+        settingsManager: opts.settingsManager ?? SettingsManager.inMemory({ theme: MU_DEFAULT_THEME_NAME, quietStartup: true }),
         additionalExtensionPaths: opts.additionalExtensionPaths,
         additionalSkillPaths: [...skillPaths],
+        additionalThemePaths: [...themePaths],
         systemPromptOverride: (_base) => opts.systemPrompt,
         agentsFilesOverride: (base) => ({
             agentsFiles: base.agentsFiles.filter((f) => basename(f.path) === "AGENTS.md"),

package/dist/extensions/activities.d.ts

@@ -1,4 +1,7 @@
 import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
-export declare function activitiesExtension(pi: ExtensionAPI): void;
+export type ActivitiesExtensionOpts = {
+    allowMutations?: boolean;
+};
+export declare function activitiesExtension(pi: ExtensionAPI, opts?: ActivitiesExtensionOpts): void;
 export default activitiesExtension;
 //# sourceMappingURL=activities.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"activities.d.ts","sourceRoot":"","sources":["../../src/extensions/activities.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAUlE,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,YAAY,QAmHnD;AAED,eAAe,mBAAmB,CAAC"}
+{"version":3,"file":"activities.d.ts","sourceRoot":"","sources":["../../src/extensions/activities.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAsDlE,MAAM,MAAM,uBAAuB,GAAG;IACrC,cAAc,CAAC,EAAE,OAAO,CAAC;CACzB,CAAC;AAEF,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,YAAY,EAAE,IAAI,GAAE,uBAA4B,QAqMvF;AAED,eAAe,mBAAmB,CAAC"}

package/dist/extensions/activities.js

@@ -1,28 +1,65 @@
 import { StringEnum } from "@mariozechner/pi-ai";
 import { Type } from "@sinclair/typebox";
-import { clampInt, fetchMuJson, textResult, toJsonText } from "./shared.js";
+import { asArray, asNumber, asRecord, asString, clampInt, fetchMuJson, parseFieldPaths, previewText, selectFields, textResult, toJsonText, } from "./shared.js";
 function trimOrNull(value) {
     if (value == null)
         return null;
     const trimmed = value.trim();
     return trimmed.length > 0 ? trimmed : null;
 }
-export function activitiesExtension(pi) {
+function summarizeActivity(activity) {
+    return {
+        activity_id: asString(activity.activity_id),
+        title: previewText(activity.title, 140),
+        kind: asString(activity.kind),
+        status: asString(activity.status),
+        message_preview: previewText(activity.message, 180),
+        started_at_ms: asNumber(activity.started_at_ms),
+        updated_at_ms: asNumber(activity.updated_at_ms),
+        finished_at_ms: asNumber(activity.finished_at_ms),
+    };
+}
+function summarizeActivityEvent(event) {
+    return {
+        ts_ms: asNumber(event.ts_ms),
+        status: asString(event.status),
+        message_preview: previewText(event.message, 220),
+        reason: asString(event.reason),
+        source: asString(event.source),
+    };
+}
+function summarizeActivityMutation(payload) {
+    const activity = asRecord(payload.activity) ?? asRecord(payload.target_activity) ?? asRecord(payload.result);
+    return {
+        ok: payload.ok ?? null,
+        reason: asString(payload.reason),
+        activity: activity ? summarizeActivity(activity) : null,
+    };
+}
+export function activitiesExtension(pi, opts = {}) {
+    const allowMutations = opts.allowMutations ?? true;
+    const activityActions = allowMutations
+        ? ["list", "get", "start", "progress", "heartbeat", "complete", "fail", "cancel", "events"]
+        : ["list", "get", "events"];
     const ActivitiesParams = Type.Object({
-        action: StringEnum(["list", "get", "start", "progress", "heartbeat", "complete", "fail", "cancel", "events"]),
+        action: StringEnum(activityActions),
         activity_id: Type.Optional(Type.String({ description: "Activity ID" })),
         title: Type.Optional(Type.String({ description: "Title for start" })),
         kind: Type.Optional(Type.String({ description: "Activity kind for start/list filtering" })),
         heartbeat_every_ms: Type.Optional(Type.Number({ description: "Heartbeat interval in ms for start" })),
         status: Type.Optional(Type.String({ description: "Status filter for list" })),
+        contains: Type.Optional(Type.String({ description: "Case-insensitive search text for list/event messages" })),
         message: Type.Optional(Type.String({ description: "Progress/final message" })),
         reason: Type.Optional(Type.String({ description: "Heartbeat reason" })),
-        limit: Type.Optional(Type.Number({ description: "Optional limit for list/events" })),
+        fields: Type.Optional(Type.String({ description: "Comma-separated fields for get/events selection" })),
+        limit: Type.Optional(Type.Number({ description: "Optional limit for list/events (default: 20)" })),
     });
     pi.registerTool({
         name: "mu_activities",
         label: "Activities",
-        description: "Manage generic long-running activities. Actions: list, get, start, progress, heartbeat, complete, fail, cancel, events.",
+        description: allowMutations
+            ? "Manage generic long-running activities. Actions: list, get, start, progress, heartbeat, complete, fail, cancel, events. List/events are summary-first; use fields for precise retrieval."
+            : "Read-only activity inspection. Actions: list, get, events. Mutation actions are disabled in query-only mode.",
         parameters: ActivitiesParams,
         async execute(_toolCallId, params) {
             switch (params.action) {
@@ -30,31 +67,72 @@ export function activitiesExtension(pi) {
                     const query = new URLSearchParams();
                     const status = trimOrNull(params.status);
                     const kind = trimOrNull(params.kind);
-                    const limit = clampInt(params.limit, 50, 1, 500);
+                    const contains = trimOrNull(params.contains);
+                    const limit = clampInt(params.limit, 20, 1, 500);
                     if (status)
                         query.set("status", status);
                     if (kind)
                         query.set("kind", kind);
-                    query.set("limit", String(limit));
+                    query.set("limit", String(Math.max(limit, 100)));
                     const payload = await fetchMuJson(`/api/activities?${query.toString()}`);
-                    return textResult(toJsonText(payload), { action: "list", status, kind, limit });
+                    const activities = asArray(payload.activities)
+                        .map((activity) => asRecord(activity))
+                        .filter((activity) => activity != null)
+                        .filter((activity) => {
+                        if (!contains)
+                            return true;
+                        const haystack = `${previewText(activity.title, 500)}\n${previewText(activity.message, 500)}`.toLowerCase();
+                        return haystack.includes(contains.toLowerCase());
+                    });
+                    const sliced = activities.slice(0, limit);
+                    return textResult(toJsonText({
+                        total: activities.length,
+                        returned: sliced.length,
+                        truncated: sliced.length < activities.length,
+                        activities: sliced.map((activity) => summarizeActivity(activity)),
+                    }), { action: "list", status, kind, contains, limit, payload });
                 }
                 case "get": {
                     const activityId = trimOrNull(params.activity_id);
                     if (!activityId)
                         return textResult("get requires activity_id");
                     const payload = await fetchMuJson(`/api/activities/${encodeURIComponent(activityId)}`);
-                    return textResult(toJsonText(payload), { action: "get", activityId });
+                    const fields = parseFieldPaths(trimOrNull(params.fields) ?? undefined);
+                    const content = fields.length > 0
+                        ? { activity_id: activityId, selected: selectFields(payload, fields) }
+                        : { activity: summarizeActivity(payload) };
+                    return textResult(toJsonText(content), { action: "get", activityId, fields, payload });
                 }
                 case "events": {
                     const activityId = trimOrNull(params.activity_id);
                     if (!activityId)
                         return textResult("events requires activity_id");
-                    const limit = clampInt(params.limit, 200, 1, 2_000);
-                    const payload = await fetchMuJson(`/api/activities/${encodeURIComponent(activityId)}/events?limit=${limit}`);
-                    return textResult(toJsonText(payload), { action: "events", activityId, limit });
+                    const contains = trimOrNull(params.contains);
+                    const limit = clampInt(params.limit, 20, 1, 500);
+                    const payload = await fetchMuJson(`/api/activities/${encodeURIComponent(activityId)}/events?limit=${Math.max(limit, 100)}`);
+                    const fields = parseFieldPaths(trimOrNull(params.fields) ?? undefined);
+                    const records = asArray(payload.events)
+                        .map((event) => asRecord(event))
+                        .filter((event) => event != null)
+                        .filter((event) => {
+                        if (!contains)
+                            return true;
+                        const haystack = `${previewText(event.message, 500)}\n${previewText(event.reason, 500)}\n${previewText(event.status, 500)}`.toLowerCase();
+                        return haystack.includes(contains.toLowerCase());
+                    });
+                    const sliced = records.slice(-limit);
+                    const content = fields.length > 0
+                        ? { activity_id: activityId, selected: sliced.map((event) => selectFields(event, fields)) }
+                        : { activity_id: activityId, events: sliced.map((event) => summarizeActivityEvent(event)) };
+                    return textResult(toJsonText(content), { action: "events", activityId, contains, limit, fields, payload });
                 }
                 case "start": {
+                    if (!allowMutations) {
+                        return textResult("activity mutations are disabled in query-only mode.", {
+                            blocked: true,
+                            reason: "activities_query_only_mode",
+                        });
+                    }
                     const title = trimOrNull(params.title);
                     if (!title)
                         return textResult("start requires title");
@@ -70,9 +148,21 @@ export function activitiesExtension(pi) {
                             heartbeat_every_ms: heartbeatEveryMs,
                         },
                     });
-                    return textResult(toJsonText(payload), { action: "start", title, kind, heartbeatEveryMs });
+                    return textResult(toJsonText(summarizeActivityMutation(payload)), {
+                        action: "start",
+                        title,
+                        kind,
+                        heartbeatEveryMs,
+                        payload,
+                    });
                 }
                 case "progress": {
+                    if (!allowMutations) {
+                        return textResult("activity mutations are disabled in query-only mode.", {
+                            blocked: true,
+                            reason: "activities_query_only_mode",
+                        });
+                    }
                     const activityId = trimOrNull(params.activity_id);
                     if (!activityId)
                         return textResult("progress requires activity_id");
@@ -84,9 +174,20 @@ export function activitiesExtension(pi) {
                             message,
                         },
                     });
-                    return textResult(toJsonText(payload), { action: "progress", activityId, message });
+                    return textResult(toJsonText(summarizeActivityMutation(payload)), {
+                        action: "progress",
+                        activityId,
+                        message,
+                        payload,
+                    });
                 }
                 case "heartbeat": {
+                    if (!allowMutations) {
+                        return textResult("activity mutations are disabled in query-only mode.", {
+                            blocked: true,
+                            reason: "activities_query_only_mode",
+                        });
+                    }
                     const activityId = trimOrNull(params.activity_id);
                     if (!activityId)
                         return textResult("heartbeat requires activity_id");
@@ -98,7 +199,12 @@ export function activitiesExtension(pi) {
                             reason,
                         },
                     });
-                    return textResult(toJsonText(payload), { action: "heartbeat", activityId, reason });
+                    return textResult(toJsonText(summarizeActivityMutation(payload)), {
+                        action: "heartbeat",
+                        activityId,
+                        reason,
+                        payload,
+                    });
                 }
                 case "complete":
                 case "fail":
@@ -114,7 +220,12 @@ export function activitiesExtension(pi) {
                             message,
                         },
                     });
-                    return textResult(toJsonText(payload), { action: params.action, activityId, message });
+                    return textResult(toJsonText(summarizeActivityMutation(payload)), {
+                        action: params.action,
+                        activityId,
+                        message,
+                        payload,
+                    });
                 }
                 default:
                     return textResult(`unknown action: ${params.action}`);

package/dist/extensions/branding.d.ts

@@ -1,9 +1,8 @@
 /**
  * mu-branding — Custom serve-mode TUI chrome for mu.
  *
- * Adds:
- * - Custom header + footer
- * - Quick command widget above the editor
+ * Defaults to a minimal, information-dense layout:
+ * - Compact header + footer
  * - Terminal title and working message branding
  * - Lightweight periodic status refresh (open/ready/control-plane)
  */

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

@@ -1 +1 @@
-{"version":3,"file":"branding.d.ts","sourceRoot":"","sources":["../../src/extensions/branding.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAoB,MAAM,+BAA+B,CAAC;AAgDpF,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,YAAY,QA8NjD;AAED,eAAe,iBAAiB,CAAC"}
+{"version":3,"file":"branding.d.ts","sourceRoot":"","sources":["../../src/extensions/branding.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAoB,MAAM,+BAA+B,CAAC;AAwEpF,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,YAAY,QAmOjD;AAED,eAAe,iBAAiB,CAAC"}

package/dist/extensions/branding.js

@@ -1,13 +1,13 @@
 /**
  * mu-branding — Custom serve-mode TUI chrome for mu.
  *
- * Adds:
- * - Custom header + footer
- * - Quick command widget above the editor
+ * Defaults to a minimal, information-dense layout:
+ * - Compact header + footer
  * - Terminal title and working message branding
  * - Lightweight periodic status refresh (open/ready/control-plane)
  */
 import { basename } from "node:path";
+import { MU_DEFAULT_THEME_NAME, MU_VERSION } from "../ui_defaults.js";
 import { registerMuSubcommand } from "./mu-command-dispatcher.js";
 import { fetchMuStatus, muServerUrl } from "./shared.js";
 const EMPTY_SNAPSHOT = {
@@ -17,7 +17,7 @@ const EMPTY_SNAPSHOT = {
     adapters: [],
     error: null,
 };
-const ANSI_RE = /\u001b\[[0-9;]*m/g;
+const ANSI_RE = new RegExp(`${String.fromCharCode(27)}\\[[0-9;]*m`, "g");
 function visibleWidth(text) {
     return text.replace(ANSI_RE, "").length;
 }
@@ -31,61 +31,75 @@ function truncateToWidth(text, width) {
         return plain.slice(0, 1);
     return `${plain.slice(0, width - 1)}…`;
 }
+function centerLine(text, width) {
+    const vw = visibleWidth(text);
+    if (vw >= width)
+        return truncateToWidth(text, width);
+    const pad = Math.floor((width - vw) / 2);
+    return " ".repeat(pad) + text;
+}
 function routesFromStatus(adapters, routes) {
     if (routes && routes.length > 0)
         return routes;
     return adapters.map((name) => ({ name, route: `/webhooks/${name}` }));
 }
-function modelLabelFromContext(ctx) {
+function shortModelLabel(ctx) {
     if (!ctx.model)
-        return "model:unknown";
-    return `${ctx.model.provider}/${ctx.model.id}`;
+        return "?";
+    return ctx.model.id;
+}
+function shortModelLabelFromEvent(model) {
+    return model.id;
 }
-function modelLabelFromEventModel(model) {
-    return `${model.provider}/${model.id}`;
+const BAR_CHARS = ["░", "▏", "▎", "▍", "▌", "▋", "▊", "▉", "█"];
+function contextBar(percent, barWidth) {
+    const clamped = Math.max(0, Math.min(100, percent));
+    const filled = (clamped / 100) * barWidth;
+    const full = Math.floor(filled);
+    const frac = filled - full;
+    const fracIdx = Math.round(frac * (BAR_CHARS.length - 1));
+    const empty = barWidth - full - (fracIdx > 0 ? 1 : 0);
+    return (BAR_CHARS[BAR_CHARS.length - 1].repeat(full) +
+        (fracIdx > 0 ? BAR_CHARS[fracIdx] : "") +
+        BAR_CHARS[0].repeat(Math.max(0, empty)));
 }
 export function brandingExtension(pi) {
     let enabled = true;
     let repoName = "mu";
-    let currentModel = "model:unknown";
+    let currentModelLabel = "?";
     let snapshot = { ...EMPTY_SNAPSHOT };
     let activeCtx = null;
     let pollTimer = null;
     let footerRequestRender = null;
-    function refreshWidget(ctx) {
+    function applyDefaultTheme(ctx) {
         if (!ctx.hasUI)
             return;
-        ctx.ui.setWidget("mu-quick-actions", (_tui, theme) => ({
-            render(width) {
-                const cpState = snapshot.error
-                    ? theme.fg("warning", "cp unavailable")
-                    : snapshot.controlPlaneActive
-                        ? theme.fg("success", `cp ${snapshot.adapters.join(",") || "on"}`)
-                        : theme.fg("muted", "cp off");
-                const line1 = `${theme.fg("accent", "μ")}${theme.fg("dim", " quick actions")}: ${theme.fg("muted", "/mu status  /mu control  /mu setup  /mu events")}`;
-                const line2 = `${theme.fg("dim", `open ${snapshot.openCount} · ready ${snapshot.readyCount}`)} · ${cpState}`;
-                return [truncateToWidth(line1, width), truncateToWidth(line2, width)];
-            },
-            invalidate() { },
-        }));
+        const result = ctx.ui.setTheme(MU_DEFAULT_THEME_NAME);
+        if (!result.success) {
+            ctx.ui.notify(`failed to apply ${MU_DEFAULT_THEME_NAME}: ${result.error ?? "unknown error"}`, "warning");
+        }
     }
     function applyChrome(ctx) {
         if (!ctx.hasUI || !enabled)
             return;
-        ctx.ui.setTitle(`mu • ${repoName}`);
-        ctx.ui.setWorkingMessage("μ working...");
+        ctx.ui.setTitle(`mu · ${repoName}`);
+        ctx.ui.setWorkingMessage("working…");
+        ctx.ui.setWidget("mu-quick-actions", undefined);
         ctx.ui.setHeader((_tui, theme) => ({
             render(width) {
-                const line1 = `${theme.fg("accent", theme.bold("μ"))} ${theme.bold("mu")} ${theme.fg("muted", "serve console")}`;
-                const line2 = theme.fg("dim", `repo: ${repoName}`);
-                const line3 = theme.fg("muted", "status via: mu_status · mu_control_plane · mu_messaging_setup");
-                return [
-                    "",
-                    truncateToWidth(line1, width),
-                    truncateToWidth(line2, width),
-                    truncateToWidth(line3, width),
-                    "",
-                ];
+                const cpPart = snapshot.error
+                    ? ""
+                    : snapshot.controlPlaneActive
+                        ? ` ${theme.fg("muted", "·")} ${theme.fg("success", `cp:${snapshot.adapters.join(",") || "on"}`)}`
+                        : "";
+                const line = [
+                    theme.fg("accent", theme.bold("μ")),
+                    theme.fg("muted", "·"),
+                    theme.fg("dim", `v${MU_VERSION}`),
+                    theme.fg("muted", "·"),
+                    theme.fg("dim", repoName),
+                ].join(" ") + cpPart;
+                return [centerLine(line, width)];
             },
             invalidate() { },
         }));
@@ -102,27 +116,24 @@ export function brandingExtension(pi) {
                 },
                 invalidate() { },
                 render(width) {
-                    const cpLabel = snapshot.error
-                        ? theme.fg("warning", "cp:unavailable")
-                        : snapshot.controlPlaneActive
-                            ? theme.fg("success", `cp:${snapshot.adapters.join(",") || "on"}`)
-                            : theme.fg("muted", "cp:off");
-                    const left = [
-                        theme.fg("accent", "μ"),
-                        theme.fg("dim", repoName),
-                        theme.fg("muted", "|"),
-                        theme.fg("dim", `open ${snapshot.openCount} ready ${snapshot.readyCount}`),
-                        theme.fg("muted", "|"),
-                        cpLabel,
-                    ].join(" ");
+                    const parts = [theme.fg("dim", currentModelLabel)];
                     const branch = footerData.getGitBranch();
-                    const right = theme.fg("dim", branch ? `${currentModel} · branch:${branch}` : currentModel);
-                    const pad = " ".repeat(Math.max(1, width - visibleWidth(left) - visibleWidth(right)));
-                    return [truncateToWidth(`${left}${pad}${right}`, width)];
+                    if (branch) {
+                        parts.push(theme.fg("muted", "·"), theme.fg("dim", branch));
+                    }
+                    const usage = activeCtx?.getContextUsage();
+                    if (usage && usage.percent != null) {
+                        const pct = Math.round(usage.percent);
+                        const barColor = pct >= 80 ? "warning" : pct >= 60 ? "muted" : "dim";
+                        parts.push(theme.fg("muted", "·"), theme.fg(barColor, `ctx ${pct}%`), theme.fg(barColor, contextBar(pct, 10)));
+                    }
+                    if (snapshot.openCount > 0 || snapshot.readyCount > 0) {
+                        parts.push(theme.fg("muted", "·"), theme.fg("dim", `open ${snapshot.openCount} ready ${snapshot.readyCount}`));
+                    }
+                    return [centerLine(parts.join(" "), width)];
                 },
             };
         });
-        refreshWidget(ctx);
     }
     function clearChrome(ctx) {
         if (!ctx.hasUI)
@@ -142,7 +153,6 @@ export function brandingExtension(pi) {
                 error: "MU_SERVER_URL not set",
             };
             ctx.ui.setStatus("mu-overview", ctx.ui.theme.fg("warning", "μ server unavailable"));
-            refreshWidget(ctx);
             footerRequestRender?.();
             return;
         }
@@ -169,7 +179,6 @@ export function brandingExtension(pi) {
             };
             ctx.ui.setStatus("mu-overview", ctx.ui.theme.fg("warning", "μ status refresh failed"));
         }
-        refreshWidget(ctx);
         footerRequestRender?.();
     }
     function ensurePolling() {
@@ -190,10 +199,11 @@ export function brandingExtension(pi) {
     async function initialize(ctx) {
         activeCtx = ctx;
         repoName = basename(ctx.cwd);
-        currentModel = modelLabelFromContext(ctx);
+        currentModelLabel = shortModelLabel(ctx);
         if (!ctx.hasUI)
             return;
         if (enabled) {
+            applyDefaultTheme(ctx);
             applyChrome(ctx);
             await refreshStatus(ctx);
             ensurePolling();
@@ -210,10 +220,14 @@ export function brandingExtension(pi) {
         await initialize(ctx);
     });
     pi.on("model_select", async (event, ctx) => {
-        currentModel = modelLabelFromEventModel(event.model);
+        currentModelLabel = shortModelLabelFromEvent(event.model);
+        if (!ctx.hasUI || !enabled)
+            return;
+        footerRequestRender?.();
+    });
+    pi.on("turn_end", async (_event, ctx) => {
         if (!ctx.hasUI || !enabled)
             return;
-        ctx.ui.setStatus("mu-model", ctx.ui.theme.fg("dim", currentModel));
         footerRequestRender?.();
     });
     pi.on("session_shutdown", async () => {
@@ -241,6 +255,7 @@ export function brandingExtension(pi) {
                 return;
             }
             if (enabled) {
+                applyDefaultTheme(ctx);
                 applyChrome(ctx);
                 await refreshStatus(ctx);
                 ensurePolling();

package/dist/extensions/cron.d.ts

@@ -1,4 +1,7 @@
 import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
-export declare function cronExtension(pi: ExtensionAPI): void;
+export type CronExtensionOpts = {
+    allowMutations?: boolean;
+};
+export declare function cronExtension(pi: ExtensionAPI, opts?: CronExtensionOpts): void;
 export default cronExtension;
 //# sourceMappingURL=cron.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"cron.d.ts","sourceRoot":"","sources":["../../src/extensions/cron.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAiBlE,wBAAgB,aAAa,CAAC,EAAE,EAAE,YAAY,QAoK7C;AAED,eAAe,aAAa,CAAC"}
+{"version":3,"file":"cron.d.ts","sourceRoot":"","sources":["../../src/extensions/cron.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AA0DlE,MAAM,MAAM,iBAAiB,GAAG;IAC/B,cAAc,CAAC,EAAE,OAAO,CAAC;CACzB,CAAC;AAEF,wBAAgB,aAAa,CAAC,EAAE,EAAE,YAAY,EAAE,IAAI,GAAE,iBAAsB,QAqM3E;AAED,eAAe,aAAa,CAAC"}