@femtomc/mu-server 26.2.31 → 26.2.33

package/README.md

@@ -87,16 +87,17 @@ Bun.serve(server);
 
 ### With Web UI (Recommended)
 
-The easiest way to run the server with the web interface:
+The easiest way to run the server with the bundled web interface (and default terminal meta-agent chat):
 
 ```bash
 # From any mu repository
-mu serve
-
-# Or with custom ports
-mu serve --port 8080 --api-port 3001
+mu serve              # API + web UI + terminal meta-agent session
+mu serve --no-open    # Skip browser auto-open (headless/SSH)
+mu serve --port 8080  # Custom shared API/web UI port
 ```
 
+Type `/exit` (or press Ctrl+C) to stop both the chat session and server.
+
 ### Standalone Server
 
 ```bash

package/dist/control_plane.d.ts

@@ -1,4 +1,5 @@
 import { type Channel } from "@femtomc/mu-control-plane";
+import { type MessagingMetaAgentBackend, MessagingMetaAgentRuntime } from "@femtomc/mu-agent";
 export declare const ENV_VARS: {
     readonly slack: {
         readonly signingSecret: "MU_SLACK_SIGNING_SECRET";
@@ -12,6 +13,17 @@ export declare const ENV_VARS: {
         readonly botUsername: "MU_TELEGRAM_BOT_USERNAME";
         readonly tenantId: "MU_TELEGRAM_TENANT_ID";
     };
+    readonly metaAgent: {
+        readonly enabled: "MU_META_AGENT_ENABLED";
+        readonly enabledChannels: "MU_META_AGENT_ENABLED_CHANNELS";
+        readonly runTriggersEnabled: "MU_META_AGENT_RUN_TRIGGERS_ENABLED";
+        readonly provider: "MU_META_AGENT_PROVIDER";
+        readonly model: "MU_META_AGENT_MODEL";
+        readonly thinking: "MU_META_AGENT_THINKING";
+        readonly systemPrompt: "MU_META_AGENT_SYSTEM_PROMPT";
+        readonly timeoutMs: "MU_META_AGENT_TIMEOUT_MS";
+        readonly piBinary: "MU_META_AGENT_PI_BINARY";
+    };
 };
 export type ActiveAdapter = {
     name: Channel;
@@ -36,8 +48,11 @@ type DetectedAdapter = {
     tenantId: string | null;
 };
 export declare function detectAdapters(env: Record<string, string | undefined>): DetectedAdapter[];
-export declare function bootstrapControlPlane(opts: {
+export type BootstrapControlPlaneOpts = {
     repoRoot: string;
     env?: Record<string, string | undefined>;
-}): Promise<ControlPlaneHandle | null>;
+    metaAgentRuntime?: MessagingMetaAgentRuntime | null;
+    metaAgentBackend?: MessagingMetaAgentBackend;
+};
+export declare function bootstrapControlPlane(opts: BootstrapControlPlaneOpts): Promise<ControlPlaneHandle | null>;
 export {};

package/dist/control_plane.js

@@ -1,4 +1,5 @@
-import { ControlPlaneRuntime, ControlPlaneCommandPipeline, ControlPlaneOutbox, ControlPlaneOutboxDispatcher, SlackControlPlaneAdapter, DiscordControlPlaneAdapter, TelegramControlPlaneAdapter, getControlPlanePaths, } from "@femtomc/mu-control-plane";
+import { ControlPlaneCommandPipeline, ControlPlaneOutbox, ControlPlaneOutboxDispatcher, ControlPlaneRuntime, DiscordControlPlaneAdapter, getControlPlanePaths, SlackControlPlaneAdapter, TelegramControlPlaneAdapter, } from "@femtomc/mu-control-plane";
+import { ApprovedCommandBroker, CommandContextResolver, MessagingMetaAgentRuntime, PiMessagingMetaAgentBackend, } from "@femtomc/mu-agent";
 export const ENV_VARS = {
     slack: { signingSecret: "MU_SLACK_SIGNING_SECRET" },
     discord: { signingSecret: "MU_DISCORD_SIGNING_SECRET" },
@@ -8,6 +9,17 @@ export const ENV_VARS = {
         botUsername: "MU_TELEGRAM_BOT_USERNAME",
         tenantId: "MU_TELEGRAM_TENANT_ID",
     },
+    metaAgent: {
+        enabled: "MU_META_AGENT_ENABLED",
+        enabledChannels: "MU_META_AGENT_ENABLED_CHANNELS",
+        runTriggersEnabled: "MU_META_AGENT_RUN_TRIGGERS_ENABLED",
+        provider: "MU_META_AGENT_PROVIDER",
+        model: "MU_META_AGENT_MODEL",
+        thinking: "MU_META_AGENT_THINKING",
+        systemPrompt: "MU_META_AGENT_SYSTEM_PROMPT",
+        timeoutMs: "MU_META_AGENT_TIMEOUT_MS",
+        piBinary: "MU_META_AGENT_PI_BINARY",
+    },
 };
 const ROUTE_MAP = {
     slack: "/webhooks/slack",
@@ -36,6 +48,66 @@ export function detectAdapters(env) {
     }
     return adapters;
 }
+function parseBooleanEnv(value, defaultValue) {
+    if (value == null) {
+        return defaultValue;
+    }
+    const normalized = value.trim().toLowerCase();
+    if (["1", "true", "yes", "on", "enabled"].includes(normalized)) {
+        return true;
+    }
+    if (["0", "false", "no", "off", "disabled"].includes(normalized)) {
+        return false;
+    }
+    return defaultValue;
+}
+function parsePositiveIntEnv(value) {
+    if (!value) {
+        return undefined;
+    }
+    const parsed = Number.parseInt(value, 10);
+    if (!Number.isFinite(parsed) || parsed <= 0) {
+        return undefined;
+    }
+    return parsed;
+}
+function parseCsvEnv(value) {
+    if (!value) {
+        return undefined;
+    }
+    const tokens = value
+        .split(",")
+        .map((token) => token.trim().toLowerCase())
+        .filter((token) => token.length > 0);
+    return tokens.length > 0 ? tokens : undefined;
+}
+function buildMessagingMetaAgentRuntime(opts) {
+    const enabled = parseBooleanEnv(opts.env[ENV_VARS.metaAgent.enabled], true);
+    if (!enabled) {
+        return null;
+    }
+    const runTriggersEnabled = parseBooleanEnv(opts.env[ENV_VARS.metaAgent.runTriggersEnabled], true);
+    const enabledChannels = parseCsvEnv(opts.env[ENV_VARS.metaAgent.enabledChannels]);
+    const timeoutMs = parsePositiveIntEnv(opts.env[ENV_VARS.metaAgent.timeoutMs]);
+    const backend = opts.backend ??
+        new PiMessagingMetaAgentBackend({
+            provider: opts.env[ENV_VARS.metaAgent.provider],
+            model: opts.env[ENV_VARS.metaAgent.model],
+            thinking: opts.env[ENV_VARS.metaAgent.thinking],
+            systemPrompt: opts.env[ENV_VARS.metaAgent.systemPrompt],
+            timeoutMs,
+            piBinary: opts.env[ENV_VARS.metaAgent.piBinary],
+        });
+    return new MessagingMetaAgentRuntime({
+        backend,
+        broker: new ApprovedCommandBroker({
+            runTriggersEnabled,
+            contextResolver: new CommandContextResolver({ allowedRepoRoots: [opts.repoRoot] }),
+        }),
+        enabled,
+        enabledChannels,
+    });
+}
 export async function bootstrapControlPlane(opts) {
     const env = opts.env ?? process.env;
     const detected = detectAdapters(env);
@@ -45,7 +117,14 @@ export async function bootstrapControlPlane(opts) {
     const paths = getControlPlanePaths(opts.repoRoot);
     const runtime = new ControlPlaneRuntime({ repoRoot: opts.repoRoot });
     await runtime.start();
-    const pipeline = new ControlPlaneCommandPipeline({ runtime });
+    const metaAgent = opts.metaAgentRuntime !== undefined
+        ? opts.metaAgentRuntime
+        : buildMessagingMetaAgentRuntime({
+            repoRoot: opts.repoRoot,
+            env,
+            backend: opts.metaAgentBackend,
+        });
+    const pipeline = new ControlPlaneCommandPipeline({ runtime, metaAgent });
     await pipeline.start();
     const outbox = new ControlPlaneOutbox(paths.outboxPath);
     await outbox.load();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@femtomc/mu-server",
-  "version": "26.2.31",
+  "version": "26.2.33",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -23,9 +23,10 @@
     "start": "bun run dist/cli.js"
   },
   "dependencies": {
-    "@femtomc/mu-core": "26.2.31",
-    "@femtomc/mu-issue": "26.2.31",
-    "@femtomc/mu-forum": "26.2.31",
-    "@femtomc/mu-control-plane": "26.2.31"
+    "@femtomc/mu-agent": "26.2.33",
+    "@femtomc/mu-control-plane": "26.2.33",
+    "@femtomc/mu-core": "26.2.33",
+    "@femtomc/mu-forum": "26.2.33",
+    "@femtomc/mu-issue": "26.2.33"
   }
 }