@femtomc/mu-agent 26.2.74 → 26.2.76

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;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;CAoGhD;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"}
+{"version":3,"file":"backend.d.ts","sourceRoot":"","sources":["../src/backend.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAEjD,OAAO,EACN,WAAW,EAOX,qBAAqB,EAGrB,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;CAoGhD;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,CA+C9F"}

package/dist/backend.js

@@ -1,8 +1,9 @@
 import { existsSync } from "node:fs";
 import { mkdir, open } from "node:fs/promises";
 import { basename, dirname, join } from "node:path";
+import { findRepoRoot, getMuHomeDir, getStorePaths } from "@femtomc/mu-core/node";
 import { getModels, getProviders } from "@mariozechner/pi-ai";
-import { AuthStorage, createAgentSession, createBashTool, createEditTool, createReadTool, createWriteTool, DefaultResourceLoader, SessionManager, SettingsManager, } from "@mariozechner/pi-coding-agent";
+import { AuthStorage, createAgentSession, createBashTool, createEditTool, createReadTool, createWriteTool, DefaultResourceLoader, getAgentDir, 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) {
@@ -159,25 +160,42 @@ export class SdkBackend {
     }
 }
 export function createMuResourceLoader(opts) {
-    const skillPaths = new Set();
+    const repoRoot = findRepoRoot(opts.cwd);
+    const storePaths = getStorePaths(repoRoot);
+    const piAgentDir = opts.agentDir ?? getAgentDir();
+    const skillPaths = [];
+    const seenSkillPaths = new Set();
+    const addSkillPath = (path, requireExists) => {
+        if (requireExists && !existsSync(path)) {
+            return;
+        }
+        if (seenSkillPaths.has(path)) {
+            return;
+        }
+        seenSkillPaths.add(path);
+        skillPaths.push(path);
+    };
+    // Preference order (first match wins on skill-name collisions):
+    // mu workspace -> mu global -> repo top-level -> explicit additions -> pi project -> pi global.
+    addSkillPath(join(storePaths.storeDir, "skills"), true);
+    addSkillPath(join(getMuHomeDir(), "skills"), true);
+    addSkillPath(join(repoRoot, "skills"), true);
     for (const p of opts.additionalSkillPaths ?? []) {
-        skillPaths.add(p);
+        addSkillPath(p, false);
     }
+    addSkillPath(join(repoRoot, ".pi", "skills"), true);
+    addSkillPath(join(piAgentDir, "skills"), true);
     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)) {
-        skillPaths.add(repoSkills);
-    }
     return new DefaultResourceLoader({
         cwd: opts.cwd,
         agentDir: opts.agentDir,
         settingsManager: opts.settingsManager ?? SettingsManager.inMemory({ theme: MU_DEFAULT_THEME_NAME, quietStartup: true }),
         additionalExtensionPaths: opts.additionalExtensionPaths,
-        additionalSkillPaths: [...skillPaths],
+        noSkills: true,
+        additionalSkillPaths: skillPaths,
         additionalThemePaths: [...themePaths],
         systemPromptOverride: (_base) => opts.systemPrompt,
         agentsFilesOverride: (base) => ({

package/dist/default_prompts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"default_prompts.d.ts","sourceRoot":"","sources":["../src/default_prompts.ts"],"names":[],"mappings":"AAUA;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAStD;AAED,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAO/E;AAED,eAAO,MAAM,mBAAmB,QAAqC,CAAC;AAOtE,eAAO,MAAM,2BAA2B,QAAkE,CAAC;AAC3G,eAAO,MAAM,uBAAuB,QAA8D,CAAC;AACnG,eAAO,MAAM,qBAAqB,QAA4D,CAAC;AAC/F,eAAO,MAAM,8BAA8B,QAAqE,CAAC"}
+{"version":3,"file":"default_prompts.d.ts","sourceRoot":"","sources":["../src/default_prompts.ts"],"names":[],"mappings":"AAWA;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAStD;AAED,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAO/E;AAED,eAAO,MAAM,mBAAmB,QAAqC,CAAC;AAOtE,eAAO,MAAM,2BAA2B,QAAkE,CAAC;AAC3G,eAAO,MAAM,uBAAuB,QAA8D,CAAC;AACnG,eAAO,MAAM,qBAAqB,QAA4D,CAAC;AAC/F,eAAO,MAAM,8BAA8B,QAE1C,CAAC"}

package/dist/default_prompts.js

@@ -2,6 +2,7 @@ import { readFileSync } from "node:fs";
 import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
 import { splitFrontmatter } from "./prompt.js";
+import { appendMuDocumentationSection } from "./self_documentation.js";
 function bundledPromptPath(name) {
     const here = dirname(fileURLToPath(import.meta.url));
     return join(here, "..", "prompts", name);
@@ -38,4 +39,4 @@ const BASE_OPERATOR_SYSTEM_PROMPT = loadBundledPrompt("roles/operator.md");
 export const DEFAULT_ORCHESTRATOR_PROMPT = appendSharedSoul(BASE_ORCHESTRATOR_PROMPT, DEFAULT_SOUL_PROMPT);
 export const DEFAULT_REVIEWER_PROMPT = appendSharedSoul(BASE_REVIEWER_PROMPT, DEFAULT_SOUL_PROMPT);
 export const DEFAULT_WORKER_PROMPT = appendSharedSoul(BASE_WORKER_PROMPT, DEFAULT_SOUL_PROMPT);
-export const DEFAULT_OPERATOR_SYSTEM_PROMPT = appendSharedSoul(BASE_OPERATOR_SYSTEM_PROMPT, DEFAULT_SOUL_PROMPT);
+export const DEFAULT_OPERATOR_SYSTEM_PROMPT = appendMuDocumentationSection(appendSharedSoul(BASE_OPERATOR_SYSTEM_PROMPT, DEFAULT_SOUL_PROMPT));

package/dist/extensions/event-log.js

@@ -19,7 +19,7 @@ async function fetchTail(n) {
     if (!muServerUrl())
         return [];
     try {
-        return await fetchMuJson(`/api/events/tail?n=${n}`, { timeoutMs: 6_000 });
+        return await fetchMuJson(`/api/control-plane/events/tail?n=${n}`, { timeoutMs: 6_000 });
     }
     catch {
         return [];

package/dist/extensions/shared.js

@@ -42,25 +42,25 @@ export async function fetchMuJson(path, opts = {}) {
 function ensureGenerationScopedStatus(status) {
     const controlPlane = status.control_plane;
     if (!controlPlane || typeof controlPlane !== "object") {
-        throw new Error("mu server /api/status missing control_plane payload (expected generation-scoped contract)");
+        throw new Error("mu server /api/control-plane/status missing control_plane payload (expected generation-scoped contract)");
     }
     const controlPlaneRecord = controlPlane;
     if (!("generation" in controlPlaneRecord) || !controlPlaneRecord.generation) {
-        throw new Error("mu server /api/status missing control_plane.generation (expected generation-scoped contract)");
+        throw new Error("mu server /api/control-plane/status missing control_plane.generation (expected generation-scoped contract)");
     }
     if (!("observability" in controlPlaneRecord) || !controlPlaneRecord.observability) {
-        throw new Error("mu server /api/status missing control_plane.observability (expected generation-scoped contract)");
+        throw new Error("mu server /api/control-plane/status missing control_plane.observability (expected generation-scoped contract)");
     }
     const observability = controlPlaneRecord.observability;
     if (typeof observability !== "object" ||
         observability == null ||
         !("counters" in observability) ||
         !observability.counters) {
-        throw new Error("mu server /api/status missing control_plane.observability.counters (expected generation-scoped contract)");
+        throw new Error("mu server /api/control-plane/status missing control_plane.observability.counters (expected generation-scoped contract)");
     }
     return status;
 }
 export async function fetchMuStatus(timeoutMs) {
-    const status = await fetchMuJson("/api/status", { timeoutMs });
+    const status = await fetchMuJson("/api/control-plane/status", { timeoutMs });
     return ensureGenerationScopedStatus(status);
 }

package/dist/index.d.ts

@@ -6,4 +6,5 @@ export * from "./operator.js";
 export * from "./mu_roles.js";
 export * from "./prompt.js";
 export * from "./session_factory.js";
+export * from "./session_turn.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC;AACrC,OAAO,EACN,8BAA8B,EAC9B,2BAA2B,EAC3B,uBAAuB,EACvB,mBAAmB,EACnB,qBAAqB,EACrB,gBAAgB,EAChB,iBAAiB,GACjB,MAAM,sBAAsB,CAAC;AAC9B,cAAc,uBAAuB,CAAC;AACtC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC;AACrC,OAAO,EACN,8BAA8B,EAC9B,2BAA2B,EAC3B,uBAAuB,EACvB,mBAAmB,EACnB,qBAAqB,EACrB,gBAAgB,EAChB,iBAAiB,GACjB,MAAM,sBAAsB,CAAC;AAC9B,cAAc,uBAAuB,CAAC;AACtC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC"}

package/dist/index.js

@@ -6,3 +6,4 @@ export * from "./operator.js";
 export * from "./mu_roles.js";
 export * from "./prompt.js";
 export * from "./session_factory.js";
+export * from "./session_turn.js";

package/dist/operator.d.ts

@@ -48,6 +48,23 @@ export declare const OperatorApprovedCommandSchema: z.ZodDiscriminatedUnion<[z.Z
     kind: z.ZodLiteral<"reload">;
 }, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<"update">;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"operator_config_get">;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"operator_model_list">;
+    provider: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"operator_thinking_list">;
+    provider: z.ZodOptional<z.ZodString>;
+    model: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"operator_model_set">;
+    provider: z.ZodString;
+    model: z.ZodString;
+    thinking: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"operator_thinking_set">;
+    thinking: z.ZodString;
 }, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<"run_start">;
     prompt: z.ZodString;
@@ -88,6 +105,23 @@ export declare const OperatorBackendTurnResultSchema: z.ZodDiscriminatedUnion<[z
         kind: z.ZodLiteral<"reload">;
     }, z.core.$strip>, z.ZodObject<{
         kind: z.ZodLiteral<"update">;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"operator_config_get">;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"operator_model_list">;
+        provider: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"operator_thinking_list">;
+        provider: z.ZodOptional<z.ZodString>;
+        model: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"operator_model_set">;
+        provider: z.ZodString;
+        model: z.ZodString;
+        thinking: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"operator_thinking_set">;
+        thinking: z.ZodString;
     }, z.core.$strip>, z.ZodObject<{
         kind: z.ZodLiteral<"run_start">;
         prompt: z.ZodString;

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

@@ -1,4 +1,4 @@
-import { appendJsonl, readJsonl } from "@femtomc/mu-core/node";
+import { appendJsonl, getStorePaths, readJsonl } from "@femtomc/mu-core/node";
 import { mkdir, readFile, rename, writeFile } from "node:fs/promises";
 import { dirname, join } from "node:path";
 import { z } from "zod";
@@ -32,6 +32,26 @@ export const OperatorApprovedCommandSchema = z.discriminatedUnion("kind", [
     }),
     z.object({ kind: z.literal("reload") }),
     z.object({ kind: z.literal("update") }),
+    z.object({ kind: z.literal("operator_config_get") }),
+    z.object({
+        kind: z.literal("operator_model_list"),
+        provider: z.string().trim().min(1).optional(),
+    }),
+    z.object({
+        kind: z.literal("operator_thinking_list"),
+        provider: z.string().trim().min(1).optional(),
+        model: z.string().trim().min(1).optional(),
+    }),
+    z.object({
+        kind: z.literal("operator_model_set"),
+        provider: z.string().trim().min(1),
+        model: z.string().trim().min(1),
+        thinking: z.string().trim().min(1).optional(),
+    }),
+    z.object({
+        kind: z.literal("operator_thinking_set"),
+        thinking: z.string().trim().min(1),
+    }),
     z.object({
         kind: z.literal("run_start"),
         prompt: z.string().trim().min(1),
@@ -135,6 +155,43 @@ export class ApprovedCommandBroker {
                 args = [];
                 break;
             }
+            case "operator_config_get": {
+                commandKey = "operator config get";
+                args = [];
+                break;
+            }
+            case "operator_model_list": {
+                commandKey = "operator model list";
+                args = [];
+                if (opts.proposal.provider) {
+                    args.push(normalizeArg(opts.proposal.provider));
+                }
+                break;
+            }
+            case "operator_thinking_list": {
+                commandKey = "operator thinking list";
+                args = [];
+                if (opts.proposal.provider) {
+                    args.push(normalizeArg(opts.proposal.provider));
+                }
+                if (opts.proposal.model) {
+                    args.push(normalizeArg(opts.proposal.model));
+                }
+                break;
+            }
+            case "operator_model_set": {
+                commandKey = "operator model set";
+                args = [normalizeArg(opts.proposal.provider), normalizeArg(opts.proposal.model)];
+                if (opts.proposal.thinking) {
+                    args.push(normalizeArg(opts.proposal.thinking));
+                }
+                break;
+            }
+            case "operator_thinking_set": {
+                commandKey = "operator thinking set";
+                args = [normalizeArg(opts.proposal.thinking)];
+                break;
+            }
             case "run_start": {
                 if (!this.#runTriggersEnabled) {
                     return { kind: "reject", reason: "operator_action_disallowed", details: "run triggers disabled" };
@@ -216,7 +273,7 @@ function stringList(value) {
     return out;
 }
 function sessionFlashPath(repoRoot) {
-    return join(repoRoot, ".mu", "control-plane", "session_flash.jsonl");
+    return join(getStorePaths(repoRoot).storeDir, "control-plane", "session_flash.jsonl");
 }
 async function loadPendingSessionFlashes(opts) {
     const rows = await readJsonl(sessionFlashPath(opts.repoRoot));
@@ -661,7 +718,8 @@ export class PiMessagingOperatorBackend {
         this.#auditTurns = opts.auditTurns ?? true;
         this.#persistSessions = opts.persistSessions ?? true;
         this.#sessionDirForRepoRoot =
-            opts.sessionDirForRepoRoot ?? ((repoRoot) => join(repoRoot, ".mu", "control-plane", "operator-sessions"));
+            opts.sessionDirForRepoRoot ??
+                ((repoRoot) => join(getStorePaths(repoRoot).storeDir, "control-plane", "operator-sessions"));
         // Operator turns can emit structured command proposals captured from tool events.
     }
     #disposeSession(sessionId) {
@@ -766,7 +824,7 @@ export class PiMessagingOperatorBackend {
             command: opts.command ?? null,
         };
         try {
-            const path = join(input.inbound.repo_root, ".mu", "control-plane", "operator_turns.jsonl");
+            const path = join(getStorePaths(input.inbound.repo_root).storeDir, "control-plane", "operator_turns.jsonl");
             await appendJsonl(path, entry);
         }
         catch {

package/dist/prompt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../src/prompt.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAE9C,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAyCjD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CA6BjF;AAYD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAW1G;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAItE;AAMD,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAwCxE;AAED,wBAAsB,oBAAoB,CACzC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,GAAG,OAAO,GAAG,MAAM,CAAC,EAC3C,IAAI,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,GAC9B,OAAO,CAAC,MAAM,CAAC,CAmBjB;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAK9E"}
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../src/prompt.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAE9C,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAyCjD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CA6BjF;AAYD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAW1G;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAItE;AAMD,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAwCxE;AAED,wBAAsB,oBAAoB,CACzC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,GAAG,OAAO,GAAG,MAAM,CAAC,EAC3C,IAAI,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,GAC9B,OAAO,CAAC,MAAM,CAAC,CAmBjB;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAK9E"}

package/dist/prompt.js

@@ -1,3 +1,4 @@
+import { getStorePaths } from "@femtomc/mu-core/node";
 import { readdir } from "node:fs/promises";
 import { isAbsolute, join, relative } from "node:path";
 function stripQuotes(s) {
@@ -96,7 +97,7 @@ function toPosixPath(path) {
     return path.replaceAll("\\", "/");
 }
 export async function buildRoleCatalog(repoRoot) {
-    const rolesDir = join(repoRoot, ".mu", "roles");
+    const rolesDir = join(getStorePaths(repoRoot).storeDir, "roles");
     let entries;
     try {
         entries = await readdir(rolesDir);

package/dist/self_documentation.d.ts

@@ -0,0 +1,7 @@
+export type MuDocumentation = {
+    readmePath?: string;
+    docsPath?: string;
+};
+export declare function resolveMuDocumentation(): MuDocumentation;
+export declare function appendMuDocumentationSection(basePrompt: string): string;
+//# sourceMappingURL=self_documentation.d.ts.map

package/dist/self_documentation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"self_documentation.d.ts","sourceRoot":"","sources":["../src/self_documentation.ts"],"names":[],"mappings":"AA8BA,MAAM,MAAM,eAAe,GAAG;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,wBAAgB,sBAAsB,IAAI,eAAe,CA2BxD;AAED,wBAAgB,4BAA4B,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAiBvE"}

package/dist/self_documentation.js

@@ -0,0 +1,67 @@
+import { existsSync } from "node:fs";
+import { createRequire } from "node:module";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+const require = createRequire(import.meta.url);
+function findPackageRoot(startDir) {
+    let dir = resolve(startDir);
+    while (true) {
+        if (existsSync(join(dir, "package.json"))) {
+            return dir;
+        }
+        const parent = dirname(dir);
+        if (parent === dir) {
+            return resolve(startDir);
+        }
+        dir = parent;
+    }
+}
+function firstExistingPath(candidates) {
+    for (const candidate of candidates) {
+        if (existsSync(candidate)) {
+            return candidate;
+        }
+    }
+    return undefined;
+}
+export function resolveMuDocumentation() {
+    const thisModuleDir = dirname(fileURLToPath(import.meta.url));
+    const agentPackageRoot = findPackageRoot(thisModuleDir);
+    let muPackageRoot;
+    try {
+        const muEntry = require.resolve("@femtomc/mu");
+        muPackageRoot = findPackageRoot(dirname(muEntry));
+    }
+    catch {
+        muPackageRoot = undefined;
+    }
+    const candidateRoots = [muPackageRoot, agentPackageRoot].filter((v) => Boolean(v));
+    const readmeCandidates = [];
+    const docsCandidates = [];
+    for (const root of candidateRoots) {
+        readmeCandidates.push(resolve(root, "..", "..", "README.md"));
+        readmeCandidates.push(join(root, "README.md"));
+        docsCandidates.push(resolve(root, "..", "..", "docs"));
+        docsCandidates.push(join(root, "docs"));
+    }
+    return {
+        readmePath: firstExistingPath(readmeCandidates),
+        docsPath: firstExistingPath(docsCandidates),
+    };
+}
+export function appendMuDocumentationSection(basePrompt) {
+    const trimmed = basePrompt.trim();
+    const { readmePath, docsPath } = resolveMuDocumentation();
+    const lines = ["Mu documentation (for mu feature/configuration/setup questions):"];
+    if (readmePath) {
+        lines.push(`- Main documentation: ${readmePath}`);
+    }
+    if (docsPath) {
+        lines.push(`- Additional docs: ${docsPath}`);
+    }
+    if (!readmePath && !docsPath) {
+        lines.push("- Documentation path unavailable at runtime; use `mu --help` and package README files.");
+    }
+    lines.push("- Read these when users ask about mu capabilities, adapters, or operational setup.");
+    return `${trimmed}\n\n${lines.join("\n")}`;
+}

package/dist/session_turn.d.ts

@@ -0,0 +1,37 @@
+import { type CreateMuSessionOpts, type MuSession } from "./session_factory.js";
+export type SessionTurnRequest = {
+    session_id: string;
+    session_kind: string | null;
+    body: string;
+    source: string | null;
+    provider: string | null;
+    model: string | null;
+    thinking: string | null;
+    session_file: string | null;
+    session_dir: string | null;
+    extension_profile: string | null;
+};
+export type SessionTurnResult = {
+    session_id: string;
+    session_kind: string | null;
+    session_file: string;
+    context_entry_id: string | null;
+    reply: string;
+    source: string | null;
+    completed_at_ms: number;
+};
+export declare class SessionTurnError extends Error {
+    readonly status: number;
+    constructor(status: number, message: string);
+}
+export declare function parseSessionTurnRequest(body: Record<string, unknown>): {
+    request: SessionTurnRequest | null;
+    error: string | null;
+};
+export declare function executeSessionTurn(opts: {
+    repoRoot: string;
+    request: SessionTurnRequest;
+    sessionFactory?: (opts: CreateMuSessionOpts) => Promise<MuSession>;
+    nowMs?: () => number;
+}): Promise<SessionTurnResult>;
+//# sourceMappingURL=session_turn.d.ts.map

package/dist/session_turn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session_turn.d.ts","sourceRoot":"","sources":["../src/session_turn.ts"],"names":[],"mappings":"AAcA,OAAO,EAAmB,KAAK,mBAAmB,EAAE,KAAK,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEjG,MAAM,MAAM,kBAAkB,GAAG;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,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,MAAM,GAAG,IAAI,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,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;AAoSD,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,CA+BA;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"}

package/dist/session_turn.js

@@ -0,0 +1,392 @@
+import { getStorePaths } from "@femtomc/mu-core/node";
+import { readdir, readFile, stat } from "node:fs/promises";
+import { dirname, isAbsolute, join, resolve } from "node:path";
+import { DEFAULT_OPERATOR_SYSTEM_PROMPT, DEFAULT_ORCHESTRATOR_PROMPT, DEFAULT_REVIEWER_PROMPT, DEFAULT_WORKER_PROMPT, } from "./default_prompts.js";
+import { operatorExtensionPaths, orchestratorToolExtensionPaths, workerToolExtensionPaths, } from "./extensions/index.js";
+import { createMuSession } from "./session_factory.js";
+export class SessionTurnError extends Error {
+    status;
+    constructor(status, message) {
+        super(message);
+        this.status = status;
+    }
+}
+function nonEmptyString(value) {
+    if (typeof value !== "string") {
+        return null;
+    }
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : null;
+}
+function asRecord(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        return null;
+    }
+    return value;
+}
+function normalizeSessionKind(value) {
+    if (!value) {
+        return null;
+    }
+    const normalized = value.trim().toLowerCase().replaceAll("-", "_");
+    if (normalized === "cpoperator" || normalized === "control_plane_operator") {
+        return "cp_operator";
+    }
+    return normalized;
+}
+function normalizeExtensionProfile(value) {
+    if (!value) {
+        return null;
+    }
+    const normalized = value.trim().toLowerCase();
+    if (normalized === "operator" ||
+        normalized === "worker" ||
+        normalized === "orchestrator" ||
+        normalized === "reviewer" ||
+        normalized === "none") {
+        return normalized;
+    }
+    return null;
+}
+function sessionFileStem(sessionId) {
+    const normalized = sessionId.trim().replace(/[^a-zA-Z0-9._-]+/g, "-");
+    const compact = normalized.replace(/-+/g, "-").replace(/^-+/, "").replace(/-+$/, "");
+    return compact.length > 0 ? compact : "session";
+}
+function resolveRepoPath(repoRoot, candidate) {
+    return isAbsolute(candidate) ? resolve(candidate) : resolve(repoRoot, candidate);
+}
+function defaultSessionDirForKind(repoRoot, sessionKind) {
+    const storeDir = getStorePaths(repoRoot).storeDir;
+    switch (sessionKind) {
+        case "operator":
+            return join(storeDir, "operator", "sessions");
+        case "cp_operator":
+            return join(storeDir, "control-plane", "operator-sessions");
+        case "orchestrator":
+            return join(storeDir, "orchestrator", "sessions");
+        case "worker":
+            return join(storeDir, "worker", "sessions");
+        case "reviewer":
+            return join(storeDir, "reviewer", "sessions");
+        default:
+            return join(storeDir, "control-plane", "operator-sessions");
+    }
+}
+async function pathExists(path) {
+    try {
+        await stat(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function directoryExists(path) {
+    try {
+        const info = await stat(path);
+        return info.isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+async function readSessionHeaderId(sessionFile) {
+    let raw;
+    try {
+        raw = await readFile(sessionFile, "utf8");
+    }
+    catch {
+        return null;
+    }
+    const firstLine = raw
+        .split("\n")
+        .map((line) => line.trim())
+        .find((line) => line.length > 0);
+    if (!firstLine) {
+        return null;
+    }
+    try {
+        const parsed = JSON.parse(firstLine);
+        if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+            return null;
+        }
+        const header = parsed;
+        if (header.type !== "session") {
+            return null;
+        }
+        return nonEmptyString(header.id);
+    }
+    catch {
+        return null;
+    }
+}
+async function resolveSessionFileById(opts) {
+    const direct = join(opts.sessionDir, `${sessionFileStem(opts.sessionId)}.jsonl`);
+    if (await pathExists(direct)) {
+        const headerId = await readSessionHeaderId(direct);
+        if (headerId === opts.sessionId) {
+            return direct;
+        }
+    }
+    const entries = await readdir(opts.sessionDir, { withFileTypes: true });
+    for (const entry of entries) {
+        if (!entry.isFile() || !entry.name.endsWith(".jsonl")) {
+            continue;
+        }
+        const filePath = join(opts.sessionDir, entry.name);
+        if (filePath === direct) {
+            continue;
+        }
+        const headerId = await readSessionHeaderId(filePath);
+        if (headerId === opts.sessionId) {
+            return filePath;
+        }
+    }
+    return null;
+}
+function extensionPathsForTurn(opts) {
+    if (opts.extensionProfile === "none") {
+        return [];
+    }
+    if (opts.extensionProfile === "operator") {
+        return [...operatorExtensionPaths];
+    }
+    if (opts.extensionProfile === "orchestrator") {
+        return [...orchestratorToolExtensionPaths];
+    }
+    if (opts.extensionProfile === "worker" || opts.extensionProfile === "reviewer") {
+        return [...workerToolExtensionPaths];
+    }
+    if (opts.sessionKind === "operator" || opts.sessionKind === "cp_operator") {
+        return [...operatorExtensionPaths];
+    }
+    if (opts.sessionKind === "orchestrator") {
+        return [...orchestratorToolExtensionPaths];
+    }
+    if (opts.sessionKind === "worker" || opts.sessionKind === "reviewer") {
+        return [...workerToolExtensionPaths];
+    }
+    return [...operatorExtensionPaths];
+}
+function systemPromptForTurn(opts) {
+    const role = opts.extensionProfile ?? opts.sessionKind;
+    if (role === "operator" || role === "cp_operator") {
+        return DEFAULT_OPERATOR_SYSTEM_PROMPT;
+    }
+    if (role === "orchestrator") {
+        return DEFAULT_ORCHESTRATOR_PROMPT;
+    }
+    if (role === "reviewer") {
+        return DEFAULT_REVIEWER_PROMPT;
+    }
+    if (role === "worker") {
+        return DEFAULT_WORKER_PROMPT;
+    }
+    return undefined;
+}
+function extractAssistantText(message) {
+    if (!message || typeof message !== "object") {
+        return "";
+    }
+    const record = message;
+    if (typeof record.text === "string") {
+        return record.text;
+    }
+    if (typeof record.content === "string") {
+        return record.content;
+    }
+    if (Array.isArray(record.content)) {
+        const parts = [];
+        for (const item of record.content) {
+            if (typeof item === "string") {
+                if (item.trim().length > 0) {
+                    parts.push(item);
+                }
+                continue;
+            }
+            if (!item || typeof item !== "object") {
+                continue;
+            }
+            const text = nonEmptyString(item.text);
+            if (text) {
+                parts.push(text);
+            }
+        }
+        return parts.join("\n");
+    }
+    return "";
+}
+function safeLeafId(session) {
+    const manager = session.sessionManager;
+    if (!manager || typeof manager.getLeafId !== "function") {
+        return null;
+    }
+    const value = manager.getLeafId();
+    return typeof value === "string" && value.trim().length > 0 ? value : null;
+}
+function safeSessionId(session) {
+    const value = session.sessionId;
+    return typeof value === "string" && value.trim().length > 0 ? value : null;
+}
+function safeSessionFile(session) {
+    const value = session.sessionFile;
+    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);
+    if (opts.request.session_file) {
+        const sessionFile = resolveRepoPath(opts.repoRoot, opts.request.session_file);
+        if (!(await pathExists(sessionFile))) {
+            throw new SessionTurnError(404, `session_file not found: ${sessionFile}`);
+        }
+        const headerId = await readSessionHeaderId(sessionFile);
+        if (!headerId) {
+            throw new SessionTurnError(400, `session_file is missing a valid session header: ${sessionFile}`);
+        }
+        if (headerId !== opts.request.session_id) {
+            throw new SessionTurnError(409, `session_file header id mismatch (expected ${opts.request.session_id}, found ${headerId})`);
+        }
+        return {
+            sessionFile,
+            sessionDir: opts.request.session_dir ? sessionDir : dirname(sessionFile),
+        };
+    }
+    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 };
+}
+export function parseSessionTurnRequest(body) {
+    const sessionId = nonEmptyString(body.session_id);
+    if (!sessionId) {
+        return { request: null, error: "session_id is required" };
+    }
+    const messageBody = nonEmptyString(body.body) ?? nonEmptyString(body.message) ?? nonEmptyString(body.prompt);
+    if (!messageBody) {
+        return { request: null, error: "body (or message/prompt) is required" };
+    }
+    const extensionProfileRaw = nonEmptyString(body.extension_profile);
+    if (extensionProfileRaw && !normalizeExtensionProfile(extensionProfileRaw)) {
+        return {
+            request: null,
+            error: "extension_profile must be one of operator|worker|orchestrator|reviewer|none",
+        };
+    }
+    return {
+        request: {
+            session_id: sessionId,
+            session_kind: nonEmptyString(body.session_kind),
+            body: messageBody,
+            source: nonEmptyString(body.source),
+            provider: nonEmptyString(body.provider),
+            model: nonEmptyString(body.model),
+            thinking: nonEmptyString(body.thinking),
+            session_file: nonEmptyString(body.session_file),
+            session_dir: nonEmptyString(body.session_dir),
+            extension_profile: extensionProfileRaw,
+        },
+        error: null,
+    };
+}
+export async function executeSessionTurn(opts) {
+    const normalizedSessionKind = normalizeSessionKind(opts.request.session_kind);
+    const extensionProfile = normalizeExtensionProfile(opts.request.extension_profile);
+    const target = await resolveSessionTarget({
+        repoRoot: opts.repoRoot,
+        request: opts.request,
+        normalizedSessionKind,
+    });
+    const sessionFactory = opts.sessionFactory ?? createMuSession;
+    const session = await sessionFactory({
+        cwd: opts.repoRoot,
+        systemPrompt: systemPromptForTurn({
+            sessionKind: normalizedSessionKind,
+            extensionProfile,
+        }),
+        provider: opts.request.provider ?? undefined,
+        model: opts.request.model ?? undefined,
+        thinking: opts.request.thinking ?? undefined,
+        extensionPaths: extensionPathsForTurn({
+            sessionKind: normalizedSessionKind,
+            extensionProfile,
+        }),
+        session: {
+            mode: "open",
+            sessionDir: target.sessionDir,
+            sessionFile: target.sessionFile,
+        },
+    });
+    let assistantText = "";
+    let contextEntryId = null;
+    let resolvedSessionId = null;
+    let resolvedSessionFile = null;
+    const nowMs = opts.nowMs ?? Date.now;
+    try {
+        await session.bindExtensions({
+            commandContextActions: {
+                waitForIdle: () => session.agent.waitForIdle(),
+                newSession: async () => ({ cancelled: true }),
+                fork: async () => ({ cancelled: true }),
+                navigateTree: async () => ({ cancelled: true }),
+                switchSession: async () => ({ cancelled: true }),
+                reload: async () => { },
+            },
+            onError: () => { },
+        });
+        const unsubscribe = session.subscribe((event) => {
+            const rec = asRecord(event);
+            if (!rec || rec.type !== "message_end") {
+                return;
+            }
+            const message = asRecord(rec.message);
+            if (!message || message.role !== "assistant") {
+                return;
+            }
+            const text = extractAssistantText(message);
+            if (text.trim().length > 0) {
+                assistantText = text;
+            }
+        });
+        try {
+            await session.prompt(opts.request.body, { expandPromptTemplates: false });
+            await session.agent.waitForIdle();
+        }
+        finally {
+            unsubscribe();
+        }
+        contextEntryId = safeLeafId(session);
+        resolvedSessionId = safeSessionId(session) ?? opts.request.session_id;
+        resolvedSessionFile = safeSessionFile(session) ?? target.sessionFile;
+    }
+    finally {
+        try {
+            session.dispose();
+        }
+        catch {
+            // Best effort cleanup.
+        }
+    }
+    const reply = assistantText.trim();
+    if (reply.length === 0) {
+        throw new SessionTurnError(502, "session turn completed without an assistant reply");
+    }
+    return {
+        session_id: resolvedSessionId ?? opts.request.session_id,
+        session_kind: normalizedSessionKind,
+        session_file: resolvedSessionFile ?? target.sessionFile,
+        context_entry_id: contextEntryId,
+        reply,
+        source: opts.request.source ?? null,
+        completed_at_ms: Math.trunc(nowMs()),
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@femtomc/mu-agent",
-  "version": "26.2.74",
+  "version": "26.2.76",
   "description": "Shared agent runtime for mu chat, orchestration roles, and serve extensions.",
   "keywords": [
     "mu",
@@ -24,7 +24,7 @@
     "themes/**"
   ],
   "dependencies": {
-    "@femtomc/mu-core": "26.2.74",
+    "@femtomc/mu-core": "26.2.76",
     "@mariozechner/pi-agent-core": "^0.53.0",
     "@mariozechner/pi-ai": "^0.53.0",
     "@mariozechner/pi-coding-agent": "^0.53.0",

package/prompts/roles/operator.md

@@ -16,6 +16,8 @@ Available tools:
 CLI-first workflow:
 - Use `bash` + `mu ...` for issue/forum/run/control-plane state operations.
 - Prefer `--pretty` (or `--json` + targeted parsing) for clear, auditable output.
+- Use `mu memory search|timeline|stats` as the primary cross-store memory surface.
+- Use `mu memory index status|rebuild` to inspect/refresh local memory index health when needed.
 - Do not use bespoke query/command wrappers; call the CLI surface directly.
 
 Example invocation patterns:
@@ -25,10 +27,16 @@ Example invocation patterns:
 - `bash("mu runs start \"ship release\" --max-steps 25 --pretty")`
 - `bash("mu issues close mu-abc123 --outcome success --pretty")`
 - `bash("mu forum post issue:mu-abc123 -m \"done\" --author operator --pretty")`
+- `bash("mu memory search --query reload --limit 20 --pretty")`
+- `bash("mu memory timeline --issue-id mu-abc123 --order desc --limit 40 --pretty")`
+- `bash("mu memory index status --pretty")`
+- `bash("mu memory index rebuild --sources issues,forum,events --pretty")`
+- `bash("mu control operator set openai-codex gpt-5.3-codex xhigh --pretty")`
+- `bash("mu control operator thinking-set high --pretty")`
 - `bash("mu control reload --pretty")`
 
 Guardrails:
-- Never hand-edit `.mu/*.jsonl` for normal lifecycle actions; use `mu` CLI commands.
+- Never hand-edit workspace-store `*.jsonl` files for normal lifecycle actions; use `mu` CLI commands.
 - Prefer bounded retrieval (`--limit`, scoped filters) before broad scans.
 - Do NOT pre-fetch status/issues/events/runs at conversation start.
 - Fetch only what the user request requires.

package/prompts/roles/orchestrator.md

@@ -25,6 +25,9 @@ Workflow:
    - `bash("mu issues get <id> --pretty")`
    - `bash("mu forum read issue:<id> --limit 20 --pretty")`
    - `bash("mu issues children <id> --pretty")` (or `mu issues list --root <id> --pretty`)
+   - `bash("mu memory search --query <keywords> --issue-id <id> --limit 20 --pretty")`
+   - `bash("mu memory timeline --issue-id <id> --order desc --limit 40 --pretty")`
+   - `bash("mu memory index status --pretty")` (rebuild when missing/stale if broader retrieval is needed)
 2. Decompose into worker issues:
    - `bash("mu issues create \"<title>\" --body \"<body>\" --tags \"node:agent,role:worker\" --parent <id> --pretty")`
 3. Add ordering where needed:

package/prompts/roles/reviewer.md

@@ -19,6 +19,8 @@ Workflow:
 1. Inspect:
    - `bash("mu issues get <id> --pretty")`
    - `bash("mu forum read issue:<id> --limit 20 --pretty")`
+   - `bash("mu memory search --query <keywords> --issue-id <id> --limit 20 --pretty")`
+   - `bash("mu memory timeline --issue-id <id> --order desc --limit 40 --pretty")`
 2. Verify:
    - Re-run relevant tests/checks, inspect changed files/logs.
 3. Decide:

package/prompts/roles/worker.md

@@ -19,6 +19,9 @@ Workflow:
 1. Inspect:
    - `bash("mu issues get <id> --pretty")`
    - `bash("mu forum read issue:<id> --limit 20 --pretty")`
+   - `bash("mu memory search --query <keywords> --issue-id <id> --limit 20 --pretty")`
+   - `bash("mu memory timeline --issue-id <id> --order desc --limit 40 --pretty")`
+   - `bash("mu memory index status --pretty")` (rebuild when missing/stale if context retrieval quality is poor)
 2. Implement:
    - Edit files and run commands needed for this issue only.
 3. Verify: