@femtomc/mu-agent 26.3.2 → 26.3.4

package/README.md

@@ -77,7 +77,7 @@ Current stack:
 
 - `brandingExtension` — mu compact header/footer branding + default theme
 - `eventLogExtension` — event tail + watch widget
-- `uiExtension` — programmable `UiDoc` surface (`/mu ui ...`, `mu_ui`)
+- `uiExtension` — programmable `UiDoc` surface (`/mu ui ...`, `mu_ui`) with session-resume persistence via `custom` entries (`mu-ui-state/v1`)
 
 Default operator UI theme is `mu-gruvbox-dark`.
 

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

@@ -1 +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;AAq/CpF,wBAAgB,WAAW,CAAC,EAAE,EAAE,YAAY,QAkO3C;AAED,eAAe,WAAW,CAAC"}
+{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../../src/extensions/ui.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,YAAY,EAAoB,MAAM,+BAA+B,CAAC;AA0qDpF,wBAAgB,WAAW,CAAC,EAAE,EAAE,YAAY,QA4P3C;AAED,eAAe,WAAW,CAAC"}

package/dist/extensions/ui.js

@@ -1,4 +1,4 @@
-import { normalizeUiDocs, parseUiDoc, resolveUiStatusProfileName, uiStatusProfileWarnings, } from "@femtomc/mu-core";
+import { normalizeUiDocs, parseUiDoc, resolveUiStatusProfileName, stableSerializeJson, uiStatusProfileWarnings, } from "@femtomc/mu-core";
 import { matchesKey, truncateToWidth, visibleWidth } from "@mariozechner/pi-tui";
 import { registerMuSubcommand } from "./mu-command-dispatcher.js";
 const UI_DISPLAY_DOCS_MAX = 16;
@@ -6,6 +6,8 @@ const UI_PICKER_COMPONENTS_MAX = 8;
 const UI_PICKER_LIST_ITEMS_MAX = 4;
 const UI_PICKER_KEYVALUE_ROWS_MAX = 4;
 const UI_SESSION_KEY_FALLBACK = "__mu_ui_active_session__";
+const UI_STATE_CUSTOM_TYPE = "mu-ui-state/v1";
+const UI_STATE_SCHEMA_VERSION = 1;
 const UI_PROMPT_PREVIEW_MAX = 160;
 const UI_INTERACT_SHORTCUT_PRIMARY = "ctrl+shift+u";
 const UI_INTERACT_SHORTCUT_FALLBACK = "alt+u";
@@ -46,6 +48,7 @@ function createState() {
         interactionDepth: 0,
         lastStatusText: null,
         lastWidgetSignature: null,
+        lastPersistSignature: null,
     };
 }
 function pruneStaleStates(nowMs) {
@@ -389,6 +392,164 @@ function parseDocListInput(value) {
     }
     return { ok: true, docs: normalizeUiDocs(docs, { maxDocs: UI_DISPLAY_DOCS_MAX }) };
 }
+function normalizeStringArray(value) {
+    if (!Array.isArray(value)) {
+        return [];
+    }
+    const out = [];
+    const seen = new Set();
+    for (const entry of value) {
+        if (typeof entry !== "string") {
+            continue;
+        }
+        const trimmed = entry.trim();
+        if (!trimmed || seen.has(trimmed)) {
+            continue;
+        }
+        seen.add(trimmed);
+        out.push(trimmed);
+    }
+    return out;
+}
+function parsePersistedPendingPrompt(value) {
+    if (!isPlainObject(value)) {
+        return null;
+    }
+    const kind = value.kind === "action" || value.kind === "review" ? value.kind : null;
+    if (!kind) {
+        return null;
+    }
+    const uiIdRaw = typeof value.ui_id === "string" ? value.ui_id.trim() : "";
+    if (!uiIdRaw) {
+        return null;
+    }
+    const actionIdRaw = typeof value.action_id === "string" ? value.action_id.trim() : "";
+    if (kind === "review") {
+        return { kind, ui_id: uiIdRaw };
+    }
+    if (actionIdRaw) {
+        return { kind, ui_id: uiIdRaw, action_id: actionIdRaw };
+    }
+    return { kind, ui_id: uiIdRaw };
+}
+function parsePersistedUiState(value) {
+    if (!isPlainObject(value)) {
+        return null;
+    }
+    if (value.v !== UI_STATE_SCHEMA_VERSION) {
+        return null;
+    }
+    const parsedDocs = parseDocListInput(value.docs);
+    if (!parsedDocs.ok) {
+        return null;
+    }
+    const pendingPrompts = [];
+    const pendingRaw = Array.isArray(value.pending_prompts) ? value.pending_prompts : [];
+    for (const pending of pendingRaw) {
+        const parsed = parsePersistedPendingPrompt(pending);
+        if (parsed) {
+            pendingPrompts.push(parsed);
+        }
+    }
+    return {
+        v: 1,
+        docs: parsedDocs.docs,
+        pending_prompts: pendingPrompts,
+        prompted_revision_keys: normalizeStringArray(value.prompted_revision_keys),
+        awaiting_ui_ids: normalizeStringArray(value.awaiting_ui_ids),
+    };
+}
+function serializeUiState(state) {
+    retainPromptedRevisionKeysForActiveDocs(state);
+    retainAwaitingUiIdsForActiveDocs(state);
+    retainPendingPromptsForActiveDocs(state);
+    const docs = activeDocs(state, UI_DISPLAY_DOCS_MAX);
+    return {
+        v: 1,
+        docs,
+        pending_prompts: state.pendingPrompts.map((pending) => ({
+            kind: pending.kind,
+            ui_id: pending.uiId,
+            ...(pending.actionId ? { action_id: pending.actionId } : {}),
+        })),
+        prompted_revision_keys: [...state.promptedRevisionKeys].sort((left, right) => left.localeCompare(right)),
+        awaiting_ui_ids: [...state.awaitingUiIds].sort((left, right) => left.localeCompare(right)),
+    };
+}
+function uiStatePersistSignature(value) {
+    return stableSerializeJson(value);
+}
+function persistUiStateSnapshot(pi, state) {
+    const snapshot = serializeUiState(state);
+    const signature = uiStatePersistSignature(snapshot);
+    if (state.lastPersistSignature === signature) {
+        return;
+    }
+    pi.appendEntry(UI_STATE_CUSTOM_TYPE, snapshot);
+    state.lastPersistSignature = signature;
+}
+function applyPersistedUiState(state, persisted) {
+    state.docsById.clear();
+    state.pendingPrompts = [];
+    state.promptedRevisionKeys.clear();
+    state.awaitingUiIds.clear();
+    state.interactionDepth = 0;
+    state.lastStatusText = null;
+    state.lastWidgetSignature = null;
+    for (const doc of persisted.docs) {
+        state.docsById.set(doc.ui_id, doc);
+    }
+    for (const revisionKey of persisted.prompted_revision_keys) {
+        state.promptedRevisionKeys.add(revisionKey);
+    }
+    for (const uiId of persisted.awaiting_ui_ids) {
+        state.awaitingUiIds.add(uiId);
+    }
+    for (const pending of persisted.pending_prompts) {
+        enqueuePendingPrompt(state, {
+            kind: pending.kind,
+            uiId: pending.ui_id,
+            actionId: pending.action_id,
+        });
+    }
+    retainPromptedRevisionKeysForActiveDocs(state);
+    retainAwaitingUiIdsForActiveDocs(state);
+    retainPendingPromptsForActiveDocs(state);
+    state.lastPersistSignature = uiStatePersistSignature(serializeUiState(state));
+}
+function latestPersistedUiStateFromBranch(entries) {
+    let latest = null;
+    for (const entry of entries) {
+        if (!isPlainObject(entry)) {
+            continue;
+        }
+        if (entry.type !== "custom" || entry.customType !== UI_STATE_CUSTOM_TYPE) {
+            continue;
+        }
+        const parsed = parsePersistedUiState(entry.data);
+        if (!parsed) {
+            continue;
+        }
+        latest = parsed;
+    }
+    return latest;
+}
+function restoreStateFromSessionBranch(ctx, key) {
+    const manager = ctx.sessionManager;
+    const branch = typeof manager.getBranch === "function" ? manager.getBranch() : [];
+    const restored = createState();
+    const persisted = latestPersistedUiStateFromBranch(branch);
+    if (persisted) {
+        applyPersistedUiState(restored, persisted);
+    }
+    const nowMs = Date.now();
+    pruneStaleStates(nowMs);
+    STATE_BY_SESSION.set(key, {
+        state: restored,
+        lastAccessMs: nowMs,
+    });
+    return restored;
+}
 function statusProfileWarningsExtraForDoc(doc) {
     const warnings = uiStatusProfileWarnings(doc);
     if (warnings.length === 0) {
@@ -1355,6 +1516,7 @@ export function uiExtension(pi) {
         removePendingPromptsForUiId(state, selectedDoc.ui_id);
         retainAwaitingUiIdsForActiveDocs(state);
         retainPendingPromptsForActiveDocs(state);
+        persistUiStateSnapshot(pi, state);
         ctx.ui.notify(`Submitted prompt from ${selectedDoc.ui_id}/${selectedAction.id}.`, "info");
     });
     registerMuSubcommand(pi, {
@@ -1432,15 +1594,35 @@ export function uiExtension(pi) {
             if (ctx.hasUI && result.ok && result.changedUiIds && result.changedUiIds.length > 0) {
                 armAutoPromptForUiDocs(state, result.changedUiIds);
             }
+            const shouldPersistMutation = result.ok &&
+                (result.action === "set" ||
+                    result.action === "update" ||
+                    result.action === "replace" ||
+                    result.action === "remove" ||
+                    result.action === "clear");
+            if (shouldPersistMutation) {
+                persistUiStateSnapshot(pi, state);
+            }
             refreshUi(ctx);
             return buildToolResult({ state, ...result });
         },
     });
-    pi.on("session_start", (_event, ctx) => {
+    const restoreAndRefresh = (ctx) => {
+        const key = sessionKey(ctx);
+        restoreStateFromSessionBranch(ctx, key);
         refreshUi(ctx);
+    };
+    pi.on("session_start", (_event, ctx) => {
+        restoreAndRefresh(ctx);
     });
     pi.on("session_switch", (_event, ctx) => {
-        refreshUi(ctx);
+        restoreAndRefresh(ctx);
+    });
+    pi.on("session_fork", (_event, ctx) => {
+        restoreAndRefresh(ctx);
+    });
+    pi.on("session_tree", (_event, ctx) => {
+        restoreAndRefresh(ctx);
     });
     pi.on("agent_end", async (_event, ctx) => {
         if (!ctx.hasUI) {
@@ -1453,6 +1635,7 @@ export function uiExtension(pi) {
         if (!pending) {
             return;
         }
+        persistUiStateSnapshot(pi, state);
         if (pending.kind === "action") {
             ctx.ui.notify(`Agent requested input via ${pending.uiId}. Submit now or press ${UI_INTERACT_SHORTCUT_HINT} later.`, "info");
         }

package/dist/operator.d.ts.map

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

package/dist/operator.js

@@ -173,16 +173,43 @@ function defaultSessionId() {
 function defaultTurnId() {
     return `turn-${crypto.randomUUID()}`;
 }
+function classifyProviderFailureCodeFromMessage(message) {
+    if (!message) {
+        return null;
+    }
+    const normalized = message.trim().toLowerCase();
+    if (!normalized) {
+        return null;
+    }
+    if (normalized.includes("chatgpt usage limit") ||
+        normalized.includes("usage limit") ||
+        normalized.includes("insufficient_quota") ||
+        normalized.includes("quota exceeded") ||
+        normalized.includes("billing hard limit")) {
+        return "operator_provider_usage_limit";
+    }
+    if (normalized.includes("context_length_exceeded") ||
+        normalized.includes("context window") ||
+        normalized.includes("maximum context length") ||
+        normalized.includes("input exceeds the context window")) {
+        return "operator_provider_context_length_exceeded";
+    }
+    return null;
+}
 function buildOperatorFailureFallbackMessage(code) {
     const reasonLine = code === "operator_timeout"
         ? "The operator turn exceeded the messaging timeout before a safe response was produced."
         : code === "operator_busy"
             ? "Another operator turn is already in progress for this conversation."
-            : code === "operator_empty_response"
-                ? "The operator completed without a usable response payload."
-                : code === "operator_cancelled"
-                    ? "The operator turn was cancelled before completion."
-                    : "An internal operator runtime/formatting error interrupted the turn.";
+            : code === "operator_provider_usage_limit"
+                ? "The configured operator provider rejected the turn due to usage or quota limits."
+                : code === "operator_provider_context_length_exceeded"
+                    ? "The configured operator provider rejected the turn because the context window was exceeded."
+                    : code === "operator_empty_response"
+                        ? "The operator completed without a usable response payload."
+                        : code === "operator_cancelled"
+                            ? "The operator turn was cancelled before completion."
+                            : "An internal operator runtime/formatting error interrupted the turn.";
     return [
         "I could not complete that turn safely.",
         `Code: ${code}`,
@@ -198,6 +225,16 @@ function classifyBackendFailureCode(err) {
     if (message.includes("pi operator timeout") || message.includes("operator timeout")) {
         return "operator_timeout";
     }
+    if (message.includes("operator_provider_usage_limit")) {
+        return "operator_provider_usage_limit";
+    }
+    if (message.includes("operator_provider_context_length_exceeded")) {
+        return "operator_provider_context_length_exceeded";
+    }
+    const providerFailureCode = classifyProviderFailureCodeFromMessage(message);
+    if (providerFailureCode) {
+        return providerFailureCode;
+    }
     if (message.includes("operator_empty_response")) {
         return "operator_empty_response";
     }
@@ -914,6 +951,8 @@ export class PiMessagingOperatorBackend {
         const sessionRecord = await this.#resolveSession(input.sessionId, input.inbound.repo_root, overrides);
         const session = sessionRecord.session;
         let assistantText = "";
+        let assistantStopReason = null;
+        let assistantErrorMessage = null;
         let capturedCommand = null;
         let capturedUiDocs = [];
         const turnEnv = autonomousTurnEnvironment(input.inbound.metadata);
@@ -927,6 +966,8 @@ export class PiMessagingOperatorBackend {
             // Capture assistant text for fallback responses.
             if (event?.type === "message_end" && event?.message?.role === "assistant") {
                 const msg = event.message;
+                assistantStopReason = typeof msg.stopReason === "string" ? msg.stopReason.trim().toLowerCase() : null;
+                assistantErrorMessage = typeof msg.errorMessage === "string" ? msg.errorMessage.trim() : null;
                 if (typeof msg.text === "string") {
                     assistantText = msg.text;
                 }
@@ -993,6 +1034,8 @@ export class PiMessagingOperatorBackend {
                 }
                 await session.agent.waitForIdle();
                 assistantText = "";
+                assistantStopReason = null;
+                assistantErrorMessage = null;
                 capturedCommand = null;
                 await promptOnce();
             }
@@ -1001,7 +1044,7 @@ export class PiMessagingOperatorBackend {
             await this.#auditTurn(input, {
                 outcome: "error",
                 reason: err instanceof Error ? err.message : "operator_backend_error",
-                messagePreview: assistantText,
+                messagePreview: assistantText || assistantErrorMessage || undefined,
             });
             throw err;
         }
@@ -1027,11 +1070,14 @@ export class PiMessagingOperatorBackend {
         // Otherwise treat the assistant text as a plain response.
         const message = assistantText.trim();
         if (!message) {
+            const providerFailureCode = classifyProviderFailureCodeFromMessage(assistantErrorMessage);
+            const emptyResponseCode = providerFailureCode ?? (assistantStopReason === "aborted" ? "operator_cancelled" : null) ?? "operator_empty_response";
             await this.#auditTurn(input, {
                 outcome: "error",
-                reason: "operator_empty_response",
+                reason: emptyResponseCode,
+                messagePreview: assistantErrorMessage || undefined,
             });
-            throw new Error("operator_empty_response");
+            throw new Error(emptyResponseCode);
         }
         const responseMessage = message.slice(0, OPERATOR_RESPONSE_MAX_CHARS);
         await this.#auditTurn(input, {

package/package.json

@@ -1,34 +1,34 @@
 {
-	"name": "@femtomc/mu-agent",
-	"version": "26.3.2",
-	"description": "Shared operator runtime for mu assistant sessions and serve extensions.",
-	"keywords": [
-		"mu",
-		"agent",
-		"runtime",
-		"chat",
-		"extensions"
-	],
-	"type": "module",
-	"main": "./dist/index.js",
-	"types": "./dist/index.d.ts",
-	"exports": {
-		".": {
-			"types": "./dist/index.d.ts",
-			"default": "./dist/index.js"
-		}
-	},
-	"files": [
-		"dist/**",
-		"prompts/**",
-		"themes/**"
-	],
-	"dependencies": {
-		"@femtomc/mu-core": "26.3.2",
-		"@mariozechner/pi-agent-core": "^0.54.2",
-		"@mariozechner/pi-ai": "^0.54.2",
-		"@mariozechner/pi-coding-agent": "^0.54.2",
-		"@mariozechner/pi-tui": "^0.54.2",
-		"zod": "^4.1.9"
-	}
+  "name": "@femtomc/mu-agent",
+  "version": "26.3.4",
+  "description": "Shared operator runtime for mu assistant sessions and serve extensions.",
+  "keywords": [
+    "mu",
+    "agent",
+    "runtime",
+    "chat",
+    "extensions"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist/**",
+    "prompts/**",
+    "themes/**"
+  ],
+  "dependencies": {
+    "@femtomc/mu-core": "26.3.4",
+    "@mariozechner/pi-agent-core": "^0.54.2",
+    "@mariozechner/pi-ai": "^0.54.2",
+    "@mariozechner/pi-coding-agent": "^0.54.2",
+    "@mariozechner/pi-tui": "^0.54.2",
+    "zod": "^4.1.9"
+  }
 }