@femtomc/mu-agent 26.2.101 → 26.2.103

package/dist/operator.js

@@ -1,5 +1,5 @@
 import { HudDocSchema, normalizeHudDocs } from "@femtomc/mu-core";
-import { appendJsonl, getStorePaths, readJsonl } from "@femtomc/mu-core/node";
+import { appendJsonl, getStorePaths } from "@femtomc/mu-core/node";
 import { mkdir, readFile, rename, writeFile } from "node:fs/promises";
 import { dirname, join } from "node:path";
 import { z } from "zod";
@@ -292,93 +292,6 @@ function collectHudDocsFromToolExecutionEvent(event) {
     }
     return extractHudDocsFromToolResult(rec.result);
 }
-function finiteInt(value) {
-    if (typeof value !== "number" || !Number.isFinite(value)) {
-        return null;
-    }
-    return Math.trunc(value);
-}
-function stringList(value) {
-    if (!Array.isArray(value)) {
-        return [];
-    }
-    const out = [];
-    for (const item of value) {
-        const parsed = nonEmptyString(item);
-        if (parsed) {
-            out.push(parsed);
-        }
-    }
-    return out;
-}
-function sessionFlashPath(repoRoot) {
-    return join(getStorePaths(repoRoot).storeDir, "control-plane", "session_flash.jsonl");
-}
-async function loadPendingSessionFlashes(opts) {
-    const rows = await readJsonl(sessionFlashPath(opts.repoRoot));
-    const created = new Map();
-    const delivered = new Set();
-    for (const row of rows) {
-        const rec = asRecord(row);
-        if (!rec) {
-            continue;
-        }
-        const kind = nonEmptyString(rec.kind);
-        if (kind === "session_flash.create") {
-            const tsMs = finiteInt(rec.ts_ms) ?? Date.now();
-            const flashId = nonEmptyString(rec.flash_id);
-            const sessionId = nonEmptyString(rec.session_id);
-            const body = nonEmptyString(rec.body);
-            if (!flashId || !sessionId || !body || sessionId !== opts.sessionId) {
-                continue;
-            }
-            created.set(flashId, {
-                flash_id: flashId,
-                created_at_ms: tsMs,
-                session_id: sessionId,
-                session_kind: nonEmptyString(rec.session_kind),
-                body,
-                context_ids: stringList(rec.context_ids),
-                source: nonEmptyString(rec.source),
-                metadata: asRecord(rec.metadata) ?? {},
-            });
-            continue;
-        }
-        if (kind === "session_flash.delivery") {
-            const flashId = nonEmptyString(rec.flash_id);
-            const sessionId = nonEmptyString(rec.session_id);
-            if (!flashId || !sessionId || sessionId !== opts.sessionId) {
-                continue;
-            }
-            delivered.add(flashId);
-        }
-    }
-    const pending = [...created.values()]
-        .filter((row) => !delivered.has(row.flash_id))
-        .sort((a, b) => a.created_at_ms - b.created_at_ms);
-    const limit = Math.max(1, Math.trunc(opts.limit ?? 16));
-    if (pending.length <= limit) {
-        return pending;
-    }
-    return pending.slice(pending.length - limit);
-}
-async function markSessionFlashesDelivered(opts) {
-    if (opts.flashIds.length === 0) {
-        return;
-    }
-    const deduped = [...new Set(opts.flashIds.filter((id) => id.trim().length > 0))];
-    for (const flashId of deduped) {
-        const row = {
-            kind: "session_flash.delivery",
-            ts_ms: opts.nowMs,
-            flash_id: flashId,
-            session_id: opts.sessionId,
-            delivered_by: "messaging_operator_runtime",
-            note: null,
-        };
-        await appendJsonl(sessionFlashPath(opts.repoRoot), row);
-    }
-}
 export class JsonFileConversationSessionStore {
     #path;
     #loaded = false;
@@ -551,46 +464,14 @@ export class MessagingOperatorRuntime {
                 operatorTurnId: turnId,
             };
         }
-        let pendingFlashes = [];
-        try {
-            pendingFlashes = await loadPendingSessionFlashes({
-                repoRoot: opts.inbound.repo_root,
-                sessionId,
-            });
-        }
-        catch {
-            pendingFlashes = [];
-        }
-        const inboundForBackend = pendingFlashes.length > 0
-            ? {
-                ...opts.inbound,
-                metadata: {
-                    ...opts.inbound.metadata,
-                    session_flash_messages: pendingFlashes,
-                },
-            }
-            : opts.inbound;
         let backendResult;
         try {
             backendResult = OperatorBackendTurnResultSchema.parse(await this.#backend.runTurn({
                 sessionId,
                 turnId,
-                inbound: inboundForBackend,
+                inbound: opts.inbound,
                 binding: opts.binding,
             }));
-            if (pendingFlashes.length > 0) {
-                try {
-                    await markSessionFlashesDelivered({
-                        repoRoot: opts.inbound.repo_root,
-                        sessionId,
-                        flashIds: pendingFlashes.map((row) => row.flash_id),
-                        nowMs: Date.now(),
-                    });
-                }
-                catch {
-                    // Best-effort delivery bookkeeping; do not fail the operator turn.
-                }
-            }
         }
         catch (err) {
             const failureCode = classifyBackendFailureCode(err);
@@ -707,53 +588,6 @@ function buildOperatorPromptContextBlock(metadata) {
     }
     return ["", "Client context (structured preview):", preview];
 }
-function extractSessionFlashPromptMessages(metadata) {
-    const raw = metadata.session_flash_messages;
-    if (!Array.isArray(raw)) {
-        return [];
-    }
-    const out = [];
-    for (const value of raw) {
-        const rec = asRecord(value);
-        if (!rec) {
-            continue;
-        }
-        const flashId = nonEmptyString(rec.flash_id);
-        const body = nonEmptyString(rec.body);
-        const sessionId = nonEmptyString(rec.session_id);
-        if (!flashId || !body || !sessionId) {
-            continue;
-        }
-        out.push({
-            flash_id: flashId,
-            created_at_ms: finiteInt(rec.created_at_ms) ?? 0,
-            session_id: sessionId,
-            session_kind: nonEmptyString(rec.session_kind),
-            body,
-            context_ids: stringList(rec.context_ids),
-            source: nonEmptyString(rec.source),
-            metadata: asRecord(rec.metadata) ?? {},
-        });
-    }
-    out.sort((a, b) => a.created_at_ms - b.created_at_ms);
-    return out;
-}
-function buildOperatorPromptFlashBlock(metadata) {
-    const flashes = extractSessionFlashPromptMessages(metadata);
-    if (flashes.length === 0) {
-        return [];
-    }
-    const lines = ["", `Session flash messages (${flashes.length}):`];
-    for (const flash of flashes) {
-        const source = flash.source ?? "unknown";
-        const contextIds = flash.context_ids.length > 0 ? ` | context_ids=${flash.context_ids.join(",")}` : "";
-        const bodyPreview = compactJsonPreview(flash.body, 400) ?? flash.body;
-        lines.push(`- [${flash.flash_id}] source=${source}${contextIds}`);
-        lines.push(`  ${bodyPreview}`);
-    }
-    lines.push("Treat these as high-priority user-provided context for this session.");
-    return lines;
-}
 function buildOperatorPrompt(input) {
     const lines = [
         `[Messaging context]`,
@@ -763,7 +597,6 @@ function buildOperatorPrompt(input) {
         ``,
         `User message: ${input.inbound.command_text}`,
         ...buildOperatorPromptContextBlock(input.inbound.metadata),
-        ...buildOperatorPromptFlashBlock(input.inbound.metadata),
     ];
     return lines.join("\n");
 }

package/dist/session_factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session_factory.d.ts","sourceRoot":"","sources":["../src/session_factory.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,wBAAwB,GAAG,WAAW,GAAG,iBAAiB,GAAG,KAAK,GAAG,MAAM,CAAC;AAExF,MAAM,MAAM,wBAAwB,GAAG;IACtC,IAAI,CAAC,EAAE,wBAAwB,CAAC;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,OAAO,CAAC,EAAE,wBAAwB,CAAC;CACnC,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACvB,SAAS,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,KAAK,MAAM,IAAI,CAAC;IAC1D,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,qBAAqB,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvF,KAAK,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,cAAc,EAAE,CAAC,QAAQ,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,KAAK,EAAE;QAAE,WAAW,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE,CAAC;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE;QAChB,SAAS,CAAC,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;KAChC,CAAC;CACF,CAAC;AAkCF,wBAAsB,eAAe,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,SAAS,CAAC,CA2CnF"}
+{"version":3,"file":"session_factory.d.ts","sourceRoot":"","sources":["../src/session_factory.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,wBAAwB,GAAG,WAAW,GAAG,iBAAiB,GAAG,KAAK,GAAG,MAAM,CAAC;AAExF,MAAM,MAAM,wBAAwB,GAAG;IACtC,IAAI,CAAC,EAAE,wBAAwB,CAAC;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,OAAO,CAAC,EAAE,wBAAwB,CAAC;CACnC,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACvB,SAAS,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,KAAK,MAAM,IAAI,CAAC;IAC1D,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,qBAAqB,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvF,KAAK,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,cAAc,EAAE,CAAC,QAAQ,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,KAAK,EAAE;QAAE,WAAW,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE,CAAC;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE;QAChB,SAAS,CAAC,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;KAChC,CAAC;CACF,CAAC;AAsCF,wBAAsB,eAAe,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,SAAS,CAAC,CAuDnF"}

package/dist/session_factory.js

@@ -1,8 +1,11 @@
 import { createBashTool, createEditTool, createReadTool, createWriteTool } from "@mariozechner/pi-coding-agent";
 import { createMuResourceLoader, resolveModel } from "./backend.js";
 import { MU_DEFAULT_THEME_NAME, MU_DEFAULT_THEME_PATH } from "./ui_defaults.js";
+function resolveSessionPersistenceMode(sessionOpts) {
+    return sessionOpts?.mode ?? (sessionOpts?.sessionFile ? "open" : "continue-recent");
+}
 function createSessionManager(SessionManager, cwd, sessionOpts) {
-    const mode = sessionOpts?.mode ?? (sessionOpts?.sessionFile ? "open" : "continue-recent");
+    const mode = resolveSessionPersistenceMode(sessionOpts);
     const sessionDir = sessionOpts?.sessionDir;
     switch (mode) {
         case "continue-recent":
@@ -23,10 +26,13 @@ function createSessionManager(SessionManager, cwd, sessionOpts) {
 export async function createMuSession(opts) {
     const { AuthStorage, createAgentSession, SessionManager, SettingsManager } = await import("@mariozechner/pi-coding-agent");
     const authStorage = AuthStorage.create();
+    const sessionMode = resolveSessionPersistenceMode(opts.session);
+    const shouldRestoreSessionConfig = sessionMode === "open" && !opts.provider && !opts.model;
     const defaultModel = "gpt-5.3-codex";
-    const modelId = opts.model ?? defaultModel;
-    const model = resolveModel(modelId, authStorage, opts.provider);
-    if (!model) {
+    const requestedModelId = opts.model?.trim();
+    const modelId = requestedModelId && requestedModelId.length > 0 ? requestedModelId : shouldRestoreSessionConfig ? null : defaultModel;
+    const model = modelId ? resolveModel(modelId, authStorage, opts.provider) : undefined;
+    if (modelId && !model) {
         const scope = opts.provider ? ` in provider "${opts.provider}"` : "";
         throw new Error(`Model "${modelId}" not found${scope} in pi-ai registry.`);
     }
@@ -45,15 +51,22 @@ export async function createMuSession(opts) {
         createWriteTool(opts.cwd),
         createEditTool(opts.cwd),
     ];
-    const { session } = await createAgentSession({
+    const requestedThinking = opts.thinking?.trim();
+    const thinkingLevel = requestedThinking && requestedThinking.length > 0
+        ? requestedThinking
+        : shouldRestoreSessionConfig
+            ? undefined
+            : "minimal";
+    const createOpts = {
         cwd: opts.cwd,
-        model,
+        ...(model ? { model } : {}),
         tools,
-        thinkingLevel: (opts.thinking ?? "minimal"),
+        ...(thinkingLevel ? { thinkingLevel: thinkingLevel } : {}),
         sessionManager: createSessionManager(SessionManager, opts.cwd, opts.session),
         settingsManager,
         resourceLoader,
         authStorage,
-    });
+    };
+    const { session } = await createAgentSession(createOpts);
     return session;
 }

package/dist/session_turn.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session_turn.d.ts","sourceRoot":"","sources":["../src/session_turn.ts"],"names":[],"mappings":"AAKA,OAAO,EAAmB,KAAK,mBAAmB,EAAE,KAAK,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEjG,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,aAAa,CAAC;AACrD,MAAM,MAAM,uBAAuB,GAAG,UAAU,GAAG,MAAM,CAAC;AAE1D,MAAM,MAAM,kBAAkB,GAAG;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,WAAW,GAAG,IAAI,CAAC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,iBAAiB,EAAE,uBAAuB,GAAG,IAAI,CAAC;CAClD,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,WAAW,GAAG,IAAI,CAAC;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,qBAAa,gBAAiB,SAAQ,KAAK;IAC1C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEL,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAIlD;AAsQD,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IACvE,OAAO,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACnC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB,CAyCA;AAED,wBAAsB,kBAAkB,CAAC,IAAI,EAAE;IAC9C,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,kBAAkB,CAAC;IAC5B,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,mBAAmB,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;IACnE,KAAK,CAAC,EAAE,MAAM,MAAM,CAAC;CACrB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA+F7B"}
+{"version":3,"file":"session_turn.d.ts","sourceRoot":"","sources":["../src/session_turn.ts"],"names":[],"mappings":"AAKA,OAAO,EAAmB,KAAK,mBAAmB,EAAE,KAAK,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEjG,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,aAAa,CAAC;AACrD,MAAM,MAAM,uBAAuB,GAAG,UAAU,GAAG,MAAM,CAAC;AAE1D,MAAM,MAAM,kBAAkB,GAAG;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,WAAW,GAAG,IAAI,CAAC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,iBAAiB,EAAE,uBAAuB,GAAG,IAAI,CAAC;CAClD,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,WAAW,GAAG,IAAI,CAAC;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,qBAAa,gBAAiB,SAAQ,KAAK;IAC1C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEL,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAIlD;AAuUD,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IACvE,OAAO,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACnC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB,CAyCA;AAED,wBAAsB,kBAAkB,CAAC,IAAI,EAAE;IAC9C,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,kBAAkB,CAAC;IAC5B,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,mBAAmB,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;IACnE,KAAK,CAAC,EAAE,MAAM,MAAM,CAAC;CACrB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAgG7B"}

package/dist/session_turn.js

@@ -65,6 +65,29 @@ function defaultSessionDirForKind(repoRoot, sessionKind) {
             return join(storeDir, "control-plane", "operator-sessions");
     }
 }
+function normalizePathForPrefixMatch(path) {
+    return resolve(path).replaceAll("\\", "/");
+}
+function inferSessionKindFromSessionDir(repoRoot, sessionDir) {
+    const storeDir = getStorePaths(repoRoot).storeDir;
+    const normalizedSessionDir = normalizePathForPrefixMatch(sessionDir);
+    const operatorDir = normalizePathForPrefixMatch(join(storeDir, "operator", "sessions"));
+    if (normalizedSessionDir === operatorDir || normalizedSessionDir.startsWith(`${operatorDir}/`)) {
+        return "operator";
+    }
+    const cpOperatorDir = normalizePathForPrefixMatch(join(storeDir, "control-plane", "operator-sessions"));
+    if (normalizedSessionDir === cpOperatorDir || normalizedSessionDir.startsWith(`${cpOperatorDir}/`)) {
+        return "cp_operator";
+    }
+    return null;
+}
+function defaultSessionLookupTargets(repoRoot) {
+    const storeDir = getStorePaths(repoRoot).storeDir;
+    return [
+        { sessionKind: "operator", sessionDir: join(storeDir, "operator", "sessions") },
+        { sessionKind: "cp_operator", sessionDir: join(storeDir, "control-plane", "operator-sessions") },
+    ];
+}
 async function pathExists(path) {
     try {
         await stat(path);
@@ -208,9 +231,7 @@ function safeSessionFile(session) {
     return typeof value === "string" && value.trim().length > 0 ? value : null;
 }
 async function resolveSessionTarget(opts) {
-    const sessionDir = opts.request.session_dir
-        ? resolveRepoPath(opts.repoRoot, opts.request.session_dir)
-        : defaultSessionDirForKind(opts.repoRoot, opts.normalizedSessionKind);
+    const explicitSessionDir = opts.request.session_dir ? resolveRepoPath(opts.repoRoot, opts.request.session_dir) : null;
     if (opts.request.session_file) {
         const sessionFile = resolveRepoPath(opts.repoRoot, opts.request.session_file);
         if (!(await pathExists(sessionFile))) {
@@ -223,22 +244,55 @@ async function resolveSessionTarget(opts) {
         if (headerId !== opts.request.session_id) {
             throw new SessionTurnError(409, `session_file header id mismatch (expected ${opts.request.session_id}, found ${headerId})`);
         }
+        const sessionDir = explicitSessionDir ?? dirname(sessionFile);
+        return {
+            sessionFile,
+            sessionDir,
+            sessionKind: opts.normalizedSessionKind ?? inferSessionKindFromSessionDir(opts.repoRoot, sessionDir),
+        };
+    }
+    if (explicitSessionDir || opts.normalizedSessionKind) {
+        const sessionDir = explicitSessionDir ?? defaultSessionDirForKind(opts.repoRoot, opts.normalizedSessionKind);
+        if (!(await directoryExists(sessionDir))) {
+            throw new SessionTurnError(404, `session directory not found: ${sessionDir}`);
+        }
+        const sessionFile = await resolveSessionFileById({
+            sessionDir,
+            sessionId: opts.request.session_id,
+        });
+        if (!sessionFile) {
+            throw new SessionTurnError(404, `session_id not found in ${sessionDir}: ${opts.request.session_id}`);
+        }
         return {
             sessionFile,
-            sessionDir: opts.request.session_dir ? sessionDir : dirname(sessionFile),
+            sessionDir,
+            sessionKind: opts.normalizedSessionKind ?? inferSessionKindFromSessionDir(opts.repoRoot, sessionDir),
         };
     }
-    if (!(await directoryExists(sessionDir))) {
-        throw new SessionTurnError(404, `session directory not found: ${sessionDir}`);
+    const matches = [];
+    for (const target of defaultSessionLookupTargets(opts.repoRoot)) {
+        if (!(await directoryExists(target.sessionDir))) {
+            continue;
+        }
+        const sessionFile = await resolveSessionFileById({
+            sessionDir: target.sessionDir,
+            sessionId: opts.request.session_id,
+        });
+        if (sessionFile) {
+            matches.push({
+                sessionFile,
+                sessionDir: target.sessionDir,
+                sessionKind: target.sessionKind,
+            });
+        }
+    }
+    if (matches.length === 1) {
+        return matches[0];
     }
-    const sessionFile = await resolveSessionFileById({
-        sessionDir,
-        sessionId: opts.request.session_id,
-    });
-    if (!sessionFile) {
-        throw new SessionTurnError(404, `session_id not found in ${sessionDir}: ${opts.request.session_id}`);
+    if (matches.length > 1) {
+        throw new SessionTurnError(409, `session_id is ambiguous across operator/cp_operator stores: ${opts.request.session_id} (pass --session-kind or --session-dir)`);
     }
-    return { sessionFile, sessionDir };
+    throw new SessionTurnError(404, `session_id not found in operator/cp_operator stores: ${opts.request.session_id}`);
 }
 export function parseSessionTurnRequest(body) {
     const sessionId = nonEmptyString(body.session_id);
@@ -289,18 +343,19 @@ export async function executeSessionTurn(opts) {
         request: opts.request,
         normalizedSessionKind,
     });
+    const effectiveSessionKind = target.sessionKind ?? normalizedSessionKind;
     const sessionFactory = opts.sessionFactory ?? createMuSession;
     const session = await sessionFactory({
         cwd: opts.repoRoot,
         systemPrompt: systemPromptForTurn({
-            sessionKind: normalizedSessionKind,
+            sessionKind: effectiveSessionKind,
             extensionProfile,
         }),
         provider: opts.request.provider ?? undefined,
         model: opts.request.model ?? undefined,
         thinking: opts.request.thinking ?? undefined,
         extensionPaths: extensionPathsForTurn({
-            sessionKind: normalizedSessionKind,
+            sessionKind: effectiveSessionKind,
             extensionProfile,
         }),
         session: {
@@ -365,7 +420,7 @@ export async function executeSessionTurn(opts) {
     }
     return {
         session_id: resolvedSessionId ?? opts.request.session_id,
-        session_kind: normalizedSessionKind,
+        session_kind: effectiveSessionKind,
         session_file: resolvedSessionFile ?? target.sessionFile,
         context_entry_id: contextEntryId,
         reply,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@femtomc/mu-agent",
-  "version": "26.2.101",
+  "version": "26.2.103",
   "description": "Shared operator runtime for mu assistant sessions and serve extensions.",
   "keywords": [
     "mu",
@@ -24,10 +24,10 @@
     "themes/**"
   ],
   "dependencies": {
-    "@femtomc/mu-core": "26.2.101",
-    "@mariozechner/pi-agent-core": "^0.53.0",
-    "@mariozechner/pi-ai": "^0.53.0",
-    "@mariozechner/pi-coding-agent": "^0.53.0",
+    "@femtomc/mu-core": "26.2.103",
+    "@mariozechner/pi-agent-core": "^0.54.2",
+    "@mariozechner/pi-ai": "^0.54.2",
+    "@mariozechner/pi-coding-agent": "^0.54.2",
     "zod": "^4.1.9"
   }
 }

package/prompts/roles/operator.md

@@ -19,5 +19,6 @@ Using `mu`:
 - The `mu` CLI is self-explanatory: poke around with `mu --help` to understand.
 - Use `mu memory search|timeline|stats` to access contextual memory from past interactions.
 - Use `mu memory index status|rebuild` to inspect/refresh local memory index health when needed.
+- Use `mu control harness [provider] --json --pretty` to inspect harness adapter/provider/model configuration and model capability vectors.
 - Use `mu heartbeats` and `mu cron` to access persistent scheduled processes that broadcast to the user.
 

package/prompts/skills/hud/SKILL.md

@@ -44,6 +44,7 @@ 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 ...`)
 
@@ -72,14 +73,15 @@ Minimum practical fields:
 Common optional fields:
 
 - `scope` (for root/session/issue scoping)
-- `chips` (`[{key,label,tone?}]`)
+- `title_style` / `snapshot_style` (`{weight?:"normal|strong", italic?:boolean, code?:boolean}`)
+- `chips` (`[{key,label,tone?,style?}]`)
 - `sections`:
-  - `kv` (key/value)
-  - `checklist` (checkbox-style progress)
-  - `activity` (recent lines)
-  - `text` (free text)
-- `actions` (`[{id,label,command_text,kind?}]`)
-- `metadata` (machine-readable extras)
+  - `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:
 
@@ -92,7 +94,7 @@ Example checklist doc:
     "title": "Planning HUD",
     "scope": "mu-root-123",
     "chips": [
-      { "key": "phase", "label": "phase:drafting", "tone": "accent" },
+      { "key": "phase", "label": "phase:drafting", "tone": "accent", "style": { "weight": "strong" } },
       { "key": "steps", "label": "steps:2/5", "tone": "dim" }
     ],
     "sections": [
@@ -107,11 +109,11 @@ Example checklist doc:
       }
     ],
     "actions": [
-      { "id": "snapshot", "label": "Snapshot", "command_text": "/mu hud snapshot", "kind": "secondary" }
+      { "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": { "phase": "drafting" }
+    "metadata": { "style_preset": "planning", "phase": "drafting" }
   }
 }
 ```

package/prompts/skills/memory/SKILL.md

@@ -136,9 +136,6 @@ mu memory stats --pretty
 - adjust anchors (`issue_id`, `run_id`, `session_id`, `topic`, channel metadata)
 - rebuild selected sources only
 
-Compatibility note:
-- `mu context ...` remains an alias to `mu memory ...`.
-
 ## Evaluation scenarios
 
 1. **Issue-scoped context retrieval**