@femtomc/mu-agent 26.2.37 → 26.2.39

package/README.md

@@ -1,12 +1,11 @@
 # @femtomc/mu-agent
 
-Shared mu agent runtime package.
+Shared agent runtime package for mu.
 
-This package centralizes reusable agent logic that was previously split across
-`@femtomc/mu-control-plane` and `@femtomc/mu-orchestrator`, including:
+This package provides reusable runtime pieces for chat, orchestration, and serve-mode tooling, including:
 
-- Messaging meta-agent runtime + backend
-- Command context resolution for meta-agent command proposals
+- Messaging operator runtime + backend
+- Command context resolution for operator command proposals
 - Role prompt loading/defaults for orchestrator + worker agents
 - pi CLI/SDK orchestration backends and resource loader helpers
 - Prompt/template helpers used by orchestration roles
@@ -55,7 +54,7 @@ Current stack:
 - `/mu-events watch on|off` — toggle event watch widget
 - `/mu-brand on|off|toggle` — enable/disable UI branding
 
-## Tools (agent/meta-agent-facing)
+## Tools (agent/operator-facing)
 
 - `mu_status()`
   - High-level server status.

package/dist/extensions/index.d.ts

@@ -2,7 +2,6 @@ export { brandingExtension } from "./branding.js";
 export { eventLogExtension } from "./event-log.js";
 export { messagingSetupExtension } from "./messaging-setup.js";
 export { serverToolsExtension } from "./server-tools.js";
-import { brandingExtension } from "./branding.js";
 /**
  * Serve-mode extension module paths.
  *
@@ -11,11 +10,4 @@ import { brandingExtension } from "./branding.js";
  * anonymous inline factories.
  */
 export declare const serveExtensionPaths: string[];
-/**
- * Legacy serve-mode extension factories.
- *
- * Kept for compatibility in cases where callers need programmatic inline
- * factories, but path-based loading is preferred.
- */
-export declare const serveExtensionFactories: (typeof brandingExtension)[];
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/extensions/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAEzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAYlD;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,UAE/B,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,8BAKnC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/extensions/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AASzD;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,UAE/B,CAAC"}

package/dist/extensions/index.js

@@ -2,10 +2,6 @@ export { brandingExtension } from "./branding.js";
 export { eventLogExtension } from "./event-log.js";
 export { messagingSetupExtension } from "./messaging-setup.js";
 export { serverToolsExtension } from "./server-tools.js";
-import { brandingExtension } from "./branding.js";
-import { eventLogExtension } from "./event-log.js";
-import { messagingSetupExtension } from "./messaging-setup.js";
-import { serverToolsExtension } from "./server-tools.js";
 const SERVE_EXTENSION_MODULE_BASENAMES = ["branding", "server-tools", "event-log", "messaging-setup"];
 const RUNTIME_EXTENSION = import.meta.url.endsWith(".ts") ? "ts" : "js";
 function resolveBundledExtensionPath(moduleBasename) {
@@ -19,15 +15,3 @@ function resolveBundledExtensionPath(moduleBasename) {
  * anonymous inline factories.
  */
 export const serveExtensionPaths = SERVE_EXTENSION_MODULE_BASENAMES.map((moduleBasename) => resolveBundledExtensionPath(moduleBasename));
-/**
- * Legacy serve-mode extension factories.
- *
- * Kept for compatibility in cases where callers need programmatic inline
- * factories, but path-based loading is preferred.
- */
-export const serveExtensionFactories = [
-    brandingExtension,
-    serverToolsExtension,
-    eventLogExtension,
-    messagingSetupExtension,
-];

package/dist/extensions/server-tools.d.ts

@@ -1,7 +1,7 @@
 /**
  * mu-server-tools — Serve-mode tools for querying mu server state.
  *
- * This is the core extension the meta-agent relies on for repo introspection.
+ * This is the core extension the operator relies on for repo introspection.
  */
 import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
 export declare function serverToolsExtension(pi: ExtensionAPI): void;

package/dist/extensions/server-tools.js

@@ -1,7 +1,7 @@
 /**
  * mu-server-tools — Serve-mode tools for querying mu server state.
  *
- * This is the core extension the meta-agent relies on for repo introspection.
+ * This is the core extension the operator relies on for repo introspection.
  */
 import { StringEnum } from "@mariozechner/pi-ai";
 import { Type } from "@sinclair/typebox";

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 export * from "./command_context.js";
 export * from "./extensions/index.js";
-export * from "./meta_agent.js";
+export * from "./operator.js";
 export * from "./mu_roles.js";
 export * from "./pi_backend.js";
 export * from "./pi_sdk_backend.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,sBAAsB,CAAC"}

package/dist/index.js

@@ -1,6 +1,6 @@
 export * from "./command_context.js";
 export * from "./extensions/index.js";
-export * from "./meta_agent.js";
+export * from "./operator.js";
 export * from "./mu_roles.js";
 export * from "./pi_backend.js";
 export * from "./pi_sdk_backend.js";

package/dist/{meta_agent.d.ts → operator.d.ts}

@@ -1,6 +1,6 @@
 import { z } from "zod";
 import { CommandContextResolver } from "./command_context.js";
-export type MessagingMetaInboundEnvelope = {
+export type MessagingOperatorInboundEnvelope = {
     channel: string;
     channel_tenant_id: string;
     channel_conversation_id: string;
@@ -11,13 +11,13 @@ export type MessagingMetaInboundEnvelope = {
     target_id: string;
     metadata: Record<string, unknown>;
 };
-export type MessagingMetaIdentityBinding = {
+export type MessagingOperatorIdentityBinding = {
     binding_id: string;
     assurance_tier: string;
 };
-type InboundEnvelope = MessagingMetaInboundEnvelope;
-type IdentityBinding = MessagingMetaIdentityBinding;
-export declare const MetaApprovedCommandSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+type InboundEnvelope = MessagingOperatorInboundEnvelope;
+type IdentityBinding = MessagingOperatorIdentityBinding;
+export declare const OperatorApprovedCommandSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     kind: z.ZodLiteral<"status">;
 }, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<"ready">;
@@ -39,8 +39,8 @@ export declare const MetaApprovedCommandSchema: z.ZodDiscriminatedUnion<[z.ZodOb
     prompt: z.ZodString;
     max_steps: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>], "kind">;
-export type MetaApprovedCommand = z.infer<typeof MetaApprovedCommandSchema>;
-export declare const MetaAgentBackendTurnResultSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+export type OperatorApprovedCommand = z.infer<typeof OperatorApprovedCommandSchema>;
+export declare const OperatorBackendTurnResultSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     kind: z.ZodLiteral<"respond">;
     message: z.ZodString;
 }, z.core.$strip>, z.ZodObject<{
@@ -68,32 +68,32 @@ export declare const MetaAgentBackendTurnResultSchema: z.ZodDiscriminatedUnion<[
         max_steps: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>], "kind">;
 }, z.core.$strip>], "kind">;
-export type MetaAgentBackendTurnResult = z.infer<typeof MetaAgentBackendTurnResultSchema>;
-export type MetaAgentBackendTurnInput = {
+export type OperatorBackendTurnResult = z.infer<typeof OperatorBackendTurnResultSchema>;
+export type OperatorBackendTurnInput = {
     sessionId: string;
     turnId: string;
     inbound: InboundEnvelope;
     binding: IdentityBinding;
 };
-export interface MessagingMetaAgentBackend {
-    runTurn(input: MetaAgentBackendTurnInput): Promise<MetaAgentBackendTurnResult>;
+export interface MessagingOperatorBackend {
+    runTurn(input: OperatorBackendTurnInput): Promise<OperatorBackendTurnResult>;
 }
-export type MetaAgentDecision = {
+export type OperatorDecision = {
     kind: "response";
     message: string;
-    metaSessionId: string;
-    metaTurnId: string;
+    operatorSessionId: string;
+    operatorTurnId: string;
 } | {
     kind: "command";
     commandText: string;
-    metaSessionId: string;
-    metaTurnId: string;
+    operatorSessionId: string;
+    operatorTurnId: string;
 } | {
     kind: "reject";
-    reason: "meta_agent_disabled" | "meta_agent_action_disallowed" | "meta_agent_invalid_output" | "context_missing" | "context_ambiguous" | "context_unauthorized" | "cli_validation_failed";
+    reason: "operator_disabled" | "operator_action_disallowed" | "operator_invalid_output" | "context_missing" | "context_ambiguous" | "context_unauthorized" | "cli_validation_failed";
     details?: string;
-    metaSessionId: string;
-    metaTurnId: string;
+    operatorSessionId: string;
+    operatorTurnId: string;
 };
 export type ApprovedCommandBrokerOpts = {
     contextResolver?: CommandContextResolver;
@@ -103,47 +103,46 @@ export declare class ApprovedCommandBroker {
     #private;
     constructor(opts?: ApprovedCommandBrokerOpts);
     approve(opts: {
-        proposal: MetaApprovedCommand;
+        proposal: OperatorApprovedCommand;
         inbound: InboundEnvelope;
     }): {
         kind: "approved";
         commandText: string;
     } | {
         kind: "reject";
-        reason: "meta_agent_action_disallowed" | "context_missing" | "context_ambiguous" | "context_unauthorized" | "cli_validation_failed";
+        reason: "operator_action_disallowed" | "context_missing" | "context_ambiguous" | "context_unauthorized" | "cli_validation_failed";
         details?: string;
     };
 }
-export type MessagingMetaAgentRuntimeOpts = {
-    backend: MessagingMetaAgentBackend;
+export type MessagingOperatorRuntimeOpts = {
+    backend: MessagingOperatorBackend;
     broker?: ApprovedCommandBroker;
     enabled?: boolean;
     enabledChannels?: readonly string[];
     sessionIdFactory?: () => string;
     turnIdFactory?: () => string;
 };
-export declare class MessagingMetaAgentRuntime {
+export declare class MessagingOperatorRuntime {
     #private;
-    constructor(opts: MessagingMetaAgentRuntimeOpts);
+    constructor(opts: MessagingOperatorRuntimeOpts);
     handleInbound(opts: {
         inbound: InboundEnvelope;
         binding: IdentityBinding;
-    }): Promise<MetaAgentDecision>;
+    }): Promise<OperatorDecision>;
 }
-export type PiMessagingMetaAgentBackendOpts = {
+export type PiMessagingOperatorBackendOpts = {
     provider?: string;
     model?: string;
     thinking?: string;
     systemPrompt?: string;
     timeoutMs?: number;
     extensionPaths?: string[];
-    extensionFactories?: Array<(pi: any) => void | Promise<void>>;
 };
 export declare const DEFAULT_CHAT_SYSTEM_PROMPT: string;
-export declare class PiMessagingMetaAgentBackend implements MessagingMetaAgentBackend {
+export declare class PiMessagingOperatorBackend implements MessagingOperatorBackend {
     #private;
-    constructor(opts?: PiMessagingMetaAgentBackendOpts);
-    runTurn(input: MetaAgentBackendTurnInput): Promise<MetaAgentBackendTurnResult>;
+    constructor(opts?: PiMessagingOperatorBackendOpts);
+    runTurn(input: OperatorBackendTurnInput): Promise<OperatorBackendTurnResult>;
 }
 export {};
-//# sourceMappingURL=meta_agent.d.ts.map
+//# sourceMappingURL=operator.d.ts.map

package/dist/operator.d.ts.map

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

package/dist/{meta_agent.js → operator.js}

@@ -3,7 +3,7 @@ import { z } from "zod";
 import { CommandContextResolver } from "./command_context.js";
 import { createMuSession } from "./session_factory.js";
 const SAFE_RESPONSE_RE = /^[\s\S]{1,2000}$/;
-export const MetaApprovedCommandSchema = z.discriminatedUnion("kind", [
+export const OperatorApprovedCommandSchema = z.discriminatedUnion("kind", [
     z.object({ kind: z.literal("status") }),
     z.object({ kind: z.literal("ready") }),
     z.object({ kind: z.literal("issue_list") }),
@@ -24,9 +24,9 @@ export const MetaApprovedCommandSchema = z.discriminatedUnion("kind", [
         max_steps: z.number().int().min(1).max(500).optional(),
     }),
 ]);
-export const MetaAgentBackendTurnResultSchema = z.discriminatedUnion("kind", [
+export const OperatorBackendTurnResultSchema = z.discriminatedUnion("kind", [
     z.object({ kind: z.literal("respond"), message: z.string().trim().min(1).max(2000) }),
-    z.object({ kind: z.literal("command"), command: MetaApprovedCommandSchema }),
+    z.object({ kind: z.literal("command"), command: OperatorApprovedCommandSchema }),
 ]);
 function splitPromptIntoTokens(prompt) {
     return prompt
@@ -77,7 +77,7 @@ export class ApprovedCommandBroker {
             }
             case "run_resume": {
                 if (!this.#runTriggersEnabled) {
-                    return { kind: "reject", reason: "meta_agent_action_disallowed", details: "run triggers disabled" };
+                    return { kind: "reject", reason: "operator_action_disallowed", details: "run triggers disabled" };
                 }
                 commandKey = "run resume";
                 args = [];
@@ -91,14 +91,14 @@ export class ApprovedCommandBroker {
             }
             case "run_start": {
                 if (!this.#runTriggersEnabled) {
-                    return { kind: "reject", reason: "meta_agent_action_disallowed", details: "run triggers disabled" };
+                    return { kind: "reject", reason: "operator_action_disallowed", details: "run triggers disabled" };
                 }
                 commandKey = "run start";
                 args = splitPromptIntoTokens(opts.proposal.prompt);
                 break;
             }
             default:
-                return { kind: "reject", reason: "meta_agent_action_disallowed" };
+                return { kind: "reject", reason: "operator_action_disallowed" };
         }
         const resolved = this.#contextResolver.resolve({
             repoRoot: opts.inbound.repo_root,
@@ -122,7 +122,7 @@ export class ApprovedCommandBroker {
     }
 }
 function defaultSessionId() {
-    return `meta-${randomUUID()}`;
+    return `operator-${randomUUID()}`;
 }
 function defaultTurnId() {
     return `turn-${randomUUID()}`;
@@ -130,7 +130,7 @@ function defaultTurnId() {
 function conversationKey(inbound, binding) {
     return `${inbound.channel}:${inbound.channel_tenant_id}:${inbound.channel_conversation_id}:${binding.binding_id}`;
 }
-export class MessagingMetaAgentRuntime {
+export class MessagingOperatorRuntime {
     #backend;
     #broker;
     #enabled;
@@ -162,22 +162,22 @@ export class MessagingMetaAgentRuntime {
         if (!this.#enabled) {
             return {
                 kind: "reject",
-                reason: "meta_agent_disabled",
-                metaSessionId: sessionId,
-                metaTurnId: turnId,
+                reason: "operator_disabled",
+                operatorSessionId: sessionId,
+                operatorTurnId: turnId,
             };
         }
         if (this.#enabledChannels && !this.#enabledChannels.has(opts.inbound.channel.toLowerCase())) {
             return {
                 kind: "reject",
-                reason: "meta_agent_disabled",
-                metaSessionId: sessionId,
-                metaTurnId: turnId,
+                reason: "operator_disabled",
+                operatorSessionId: sessionId,
+                operatorTurnId: turnId,
             };
         }
         let backendResult;
         try {
-            backendResult = MetaAgentBackendTurnResultSchema.parse(await this.#backend.runTurn({
+            backendResult = OperatorBackendTurnResultSchema.parse(await this.#backend.runTurn({
                 sessionId,
                 turnId,
                 inbound: opts.inbound,
@@ -187,10 +187,10 @@ export class MessagingMetaAgentRuntime {
         catch (err) {
             return {
                 kind: "reject",
-                reason: "meta_agent_invalid_output",
-                details: err instanceof Error ? err.message : "meta_agent_backend_error",
-                metaSessionId: sessionId,
-                metaTurnId: turnId,
+                reason: "operator_invalid_output",
+                details: err instanceof Error ? err.message : "operator_backend_error",
+                operatorSessionId: sessionId,
+                operatorTurnId: turnId,
             };
         }
         if (backendResult.kind === "respond") {
@@ -198,17 +198,17 @@ export class MessagingMetaAgentRuntime {
             if (!SAFE_RESPONSE_RE.test(message)) {
                 return {
                     kind: "reject",
-                    reason: "meta_agent_invalid_output",
+                    reason: "operator_invalid_output",
                     details: "invalid response payload",
-                    metaSessionId: sessionId,
-                    metaTurnId: turnId,
+                    operatorSessionId: sessionId,
+                    operatorTurnId: turnId,
                 };
             }
             return {
                 kind: "response",
                 message,
-                metaSessionId: sessionId,
-                metaTurnId: turnId,
+                operatorSessionId: sessionId,
+                operatorTurnId: turnId,
             };
         }
         const approved = this.#broker.approve({
@@ -220,15 +220,15 @@ export class MessagingMetaAgentRuntime {
                 kind: "reject",
                 reason: approved.reason,
                 details: approved.details,
-                metaSessionId: sessionId,
-                metaTurnId: turnId,
+                operatorSessionId: sessionId,
+                operatorTurnId: turnId,
             };
         }
         return {
             kind: "command",
             commandText: approved.commandText,
-            metaSessionId: sessionId,
-            metaTurnId: turnId,
+            operatorSessionId: sessionId,
+            operatorTurnId: turnId,
         };
     }
 }
@@ -243,7 +243,7 @@ export const DEFAULT_CHAT_SYSTEM_PROMPT = [
     "",
     "Be concise, practical, and actionable.",
 ].join("\n");
-const DEFAULT_META_SYSTEM_PROMPT = [
+const DEFAULT_OPERATOR_SYSTEM_PROMPT = [
     "You are mu, an AI assistant for the mu orchestration platform.",
     "You have tools to interact with the mu server: mu_status, mu_control_plane, mu_issues, mu_forum, mu_events.",
     "Use these tools to answer questions about repository state, issues, events, and control-plane runtime state.",
@@ -253,7 +253,7 @@ const DEFAULT_META_SYSTEM_PROMPT = [
     "Be concise, practical, and actionable.",
     "Respond in plain text — do not wrap in JSON.",
 ].join("\n");
-function buildMetaPrompt(input) {
+function buildOperatorPrompt(input) {
     return [
         `[Messaging context]`,
         `channel: ${input.inbound.channel}`,
@@ -263,22 +263,20 @@ function buildMetaPrompt(input) {
         `User message: ${input.inbound.command_text}`,
     ].join("\n");
 }
-export class PiMessagingMetaAgentBackend {
+export class PiMessagingOperatorBackend {
     #provider;
     #model;
     #thinking;
     #systemPrompt;
     #timeoutMs;
     #extensionPaths;
-    #extensionFactories;
     constructor(opts = {}) {
         this.#provider = opts.provider;
         this.#model = opts.model;
         this.#thinking = opts.thinking ?? "minimal";
-        this.#systemPrompt = opts.systemPrompt ?? DEFAULT_META_SYSTEM_PROMPT;
+        this.#systemPrompt = opts.systemPrompt ?? DEFAULT_OPERATOR_SYSTEM_PROMPT;
         this.#timeoutMs = Math.max(1_000, Math.trunc(opts.timeoutMs ?? 90_000));
         this.#extensionPaths = opts.extensionPaths ?? [];
-        this.#extensionFactories = opts.extensionFactories ?? [];
     }
     async runTurn(input) {
         const session = await createMuSession({
@@ -288,7 +286,6 @@ export class PiMessagingMetaAgentBackend {
             model: this.#model,
             thinking: this.#thinking,
             extensionPaths: this.#extensionPaths,
-            extensionFactories: this.#extensionFactories,
         });
         try {
             await session.bindExtensions({
@@ -325,11 +322,11 @@ export class PiMessagingMetaAgentBackend {
                 }
             });
             const timeoutPromise = new Promise((_, reject) => {
-                setTimeout(() => reject(new Error("pi meta-agent timeout")), this.#timeoutMs);
+                setTimeout(() => reject(new Error("pi operator timeout")), this.#timeoutMs);
             });
             try {
                 await Promise.race([
-                    session.prompt(buildMetaPrompt(input), { expandPromptTemplates: false }),
+                    session.prompt(buildOperatorPrompt(input), { expandPromptTemplates: false }),
                     timeoutPromise,
                 ]);
             }
@@ -339,7 +336,7 @@ export class PiMessagingMetaAgentBackend {
             // The agent now responds naturally with tools — always return as respond
             const message = assistantText.trim();
             if (!message) {
-                throw new Error("meta_agent_empty_response");
+                throw new Error("operator_empty_response");
             }
             return { kind: "respond", message: message.slice(0, 2000) };
         }

package/dist/pi_sdk_backend.d.ts

@@ -24,7 +24,6 @@ export type CreateMuResourceLoaderOpts = {
     settingsManager?: SettingsManager;
     additionalExtensionPaths?: string[];
     additionalSkillPaths?: string[];
-    extensionFactories?: import("@mariozechner/pi-coding-agent").ExtensionFactory[];
 };
 export declare function createMuResourceLoader(opts: CreateMuResourceLoaderOpts): DefaultResourceLoader;
 //# sourceMappingURL=pi_sdk_backend.d.ts.map

package/dist/pi_sdk_backend.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pi_sdk_backend.d.ts","sourceRoot":"","sources":["../src/pi_sdk_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,aAAa,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAGrE;;;;;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;;;;;GAKG;AACH,qBAAa,YAAa,YAAW,aAAa;IAC3C,GAAG,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC;CAiGhD;AAED,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,kBAAkB,CAAC,EAAE,OAAO,+BAA+B,EAAE,gBAAgB,EAAE,CAAC;CAChF,CAAC;AAEF,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,0BAA0B,GAAG,qBAAqB,CAwB9F"}
+{"version":3,"file":"pi_sdk_backend.d.ts","sourceRoot":"","sources":["../src/pi_sdk_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,aAAa,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAGrE;;;;;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;;;;;GAKG;AACH,qBAAa,YAAa,YAAW,aAAa;IAC3C,GAAG,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC;CAiGhD;AAED,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"}

package/dist/pi_sdk_backend.js

@@ -145,7 +145,6 @@ export function createMuResourceLoader(opts) {
         settingsManager: opts.settingsManager ?? SettingsManager.inMemory(),
         additionalExtensionPaths: opts.additionalExtensionPaths,
         additionalSkillPaths: [...skillPaths],
-        extensionFactories: opts.extensionFactories,
         systemPromptOverride: (_base) => opts.systemPrompt,
         agentsFilesOverride: (base) => ({
             agentsFiles: base.agentsFiles.filter((f) => basename(f.path) === "AGENTS.md"),

package/dist/prompt.js

@@ -13,7 +13,7 @@ function stripQuotes(s) {
 }
 function parseSimpleYamlFrontmatter(text) {
     // We only need a small subset: flat `key: value` mappings.
-    // If parsing fails, we return {} (mirrors Python behavior).
+    // If parsing fails, return empty metadata.
     const out = {};
     const lines = text.split(/\r?\n/);
     for (const rawLine of lines) {

package/dist/session_factory.d.ts

@@ -1,4 +1,3 @@
-import type { ExtensionFactory } from "@mariozechner/pi-coding-agent";
 export type CreateMuSessionOpts = {
     cwd: string;
     systemPrompt?: string;
@@ -6,7 +5,6 @@ export type CreateMuSessionOpts = {
     model?: string;
     thinking?: string;
     extensionPaths?: string[];
-    extensionFactories?: ExtensionFactory[];
 };
 export type MuSession = {
     subscribe: (listener: (event: any) => void) => () => void;

package/dist/session_factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session_factory.d.ts","sourceRoot":"","sources":["../src/session_factory.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAGtE,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,kBAAkB,CAAC,EAAE,gBAAgB,EAAE,CAAC;CACxC,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,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;CAC5C,CAAC;AAEF,wBAAsB,eAAe,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,SAAS,CAAC,CAmCnF"}
+{"version":3,"file":"session_factory.d.ts","sourceRoot":"","sources":["../src/session_factory.ts"],"names":[],"mappings":"AAGA,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;CAC1B,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,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;CAC5C,CAAC;AAEF,wBAAsB,eAAe,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,SAAS,CAAC,CAkCnF"}

package/dist/session_factory.js

@@ -15,7 +15,6 @@ export async function createMuSession(opts) {
         systemPrompt: opts.systemPrompt ?? "You are mu, an AI assistant.",
         settingsManager,
         additionalExtensionPaths: opts.extensionPaths,
-        extensionFactories: opts.extensionFactories,
     });
     await resourceLoader.reload();
     const { session } = await createAgentSession({

package/package.json

@@ -1,6 +1,8 @@
 {
   "name": "@femtomc/mu-agent",
-  "version": "26.2.37",
+  "version": "26.2.39",
+  "description": "Shared agent runtime for mu chat, orchestration roles, and serve extensions.",
+  "keywords": ["mu", "agent", "runtime", "chat", "extensions"],
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -14,7 +16,7 @@
     "dist/**"
   ],
   "dependencies": {
-    "@femtomc/mu-core": "26.2.37",
+    "@femtomc/mu-core": "26.2.39",
     "@mariozechner/pi-agent-core": "^0.52.12",
     "@mariozechner/pi-ai": "^0.52.12",
     "@mariozechner/pi-coding-agent": "^0.52.12",

package/dist/meta_agent.d.ts.map

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