@femtomc/mu-server 26.2.65 → 26.2.66

package/dist/control_plane.d.ts

@@ -1,5 +1,5 @@
 import { type MessagingOperatorBackend, MessagingOperatorRuntime } from "@femtomc/mu-agent";
-import { type Channel, type GenerationTelemetryRecorder, type ReloadableGenerationIdentity } from "@femtomc/mu-control-plane";
+import { type Channel, type CommandPipelineResult, type GenerationTelemetryRecorder, type ReloadableGenerationIdentity } from "@femtomc/mu-control-plane";
 import { type MuConfig } from "./config.js";
 import type { ActivityHeartbeatScheduler } from "./heartbeat_scheduler.js";
 import { type ControlPlaneRunHeartbeatResult, type ControlPlaneRunInterruptResult, type ControlPlaneRunSnapshot, type ControlPlaneRunSupervisorOpts, type ControlPlaneRunTrace } from "./run_supervisor.js";
@@ -76,6 +76,11 @@ export type ControlPlaneHandle = {
         idOrRoot: string;
         limit?: number;
     }): Promise<ControlPlaneRunTrace | null>;
+    submitTerminalCommand?(opts: {
+        commandText: string;
+        repoRoot: string;
+        requestId?: string;
+    }): Promise<CommandPipelineResult>;
     stop(): Promise<void>;
 };
 export type ControlPlaneConfig = MuConfig["control_plane"];
@@ -138,6 +143,7 @@ export type BootstrapControlPlaneOpts = {
     generation?: ControlPlaneGenerationContext;
     telemetry?: GenerationTelemetryRecorder | null;
     telegramGenerationHooks?: TelegramGenerationSwapHooks;
+    terminalEnabled?: boolean;
 };
 export declare function bootstrapControlPlane(opts: BootstrapControlPlaneOpts): Promise<ControlPlaneHandle | null>;
 export {};

package/dist/control_plane.js

@@ -702,7 +702,7 @@ export async function bootstrapControlPlane(opts) {
             },
         }
         : undefined;
-    if (detected.length === 0) {
+    if (detected.length === 0 && !opts.terminalEnabled) {
         return null;
     }
     const paths = getControlPlanePaths(opts.repoRoot);
@@ -1050,6 +1050,12 @@ export async function bootstrapControlPlane(opts) {
             async traceRun(traceOpts) {
                 return (await runSupervisor?.trace(traceOpts.idOrRoot, { limit: traceOpts.limit })) ?? null;
             },
+            async submitTerminalCommand(terminalOpts) {
+                if (!pipeline) {
+                    throw new Error("control_plane_pipeline_unavailable");
+                }
+                return await pipeline.handleTerminalInbound(terminalOpts);
+            },
             async stop() {
                 if (drainInterval) {
                     clearInterval(drainInterval);

package/dist/server.js

@@ -214,6 +214,7 @@ export function createServer(options = {}) {
                 heartbeatScheduler,
                 generation,
                 telemetry: generationTelemetry,
+                terminalEnabled: true,
             });
         });
     const controlPlaneProxy = {
@@ -272,6 +273,13 @@ export function createServer(options = {}) {
                 return null;
             return await handle.traceRun(opts);
         },
+        async submitTerminalCommand(opts) {
+            const handle = controlPlaneCurrent;
+            if (!handle?.submitTerminalCommand) {
+                throw new Error("control_plane_unavailable");
+            }
+            return await handle.submitTerminalCommand(opts);
+        },
         async stop() {
             const handle = controlPlaneCurrent;
             controlPlaneCurrent = null;
@@ -1102,6 +1110,94 @@ export function createServer(options = {}) {
                 control_plane: controlPlane,
             }, { headers });
         }
+        if (path === "/api/commands/submit") {
+            if (request.method !== "POST") {
+                return Response.json({ error: "Method Not Allowed" }, { status: 405, headers });
+            }
+            let body;
+            try {
+                body = (await request.json());
+            }
+            catch {
+                return Response.json({ error: "invalid json body" }, { status: 400, headers });
+            }
+            const kind = typeof body.kind === "string" ? body.kind.trim() : "";
+            if (!kind) {
+                return Response.json({ error: "kind is required" }, { status: 400, headers });
+            }
+            let commandText;
+            switch (kind) {
+                case "run_start": {
+                    const prompt = typeof body.prompt === "string" ? body.prompt.trim() : "";
+                    if (!prompt) {
+                        return Response.json({ error: "prompt is required for run_start" }, { status: 400, headers });
+                    }
+                    const maxStepsSuffix = typeof body.max_steps === "number" && Number.isFinite(body.max_steps)
+                        ? ` --max-steps ${Math.max(1, Math.trunc(body.max_steps))}`
+                        : "";
+                    commandText = `mu! run start ${prompt}${maxStepsSuffix}`;
+                    break;
+                }
+                case "run_resume": {
+                    const rootId = typeof body.root_issue_id === "string" ? body.root_issue_id.trim() : "";
+                    const maxSteps = typeof body.max_steps === "number" && Number.isFinite(body.max_steps)
+                        ? ` ${Math.max(1, Math.trunc(body.max_steps))}`
+                        : "";
+                    commandText = `mu! run resume${rootId ? ` ${rootId}` : ""}${maxSteps}`;
+                    break;
+                }
+                case "run_interrupt": {
+                    const rootId = typeof body.root_issue_id === "string" ? body.root_issue_id.trim() : "";
+                    commandText = `mu! run interrupt${rootId ? ` ${rootId}` : ""}`;
+                    break;
+                }
+                case "status":
+                    commandText = "/mu status";
+                    break;
+                case "issue_list":
+                    commandText = "/mu issue list";
+                    break;
+                case "issue_get": {
+                    const issueId = typeof body.issue_id === "string" ? body.issue_id.trim() : "";
+                    commandText = `/mu issue get${issueId ? ` ${issueId}` : ""}`;
+                    break;
+                }
+                case "forum_read": {
+                    const topic = typeof body.topic === "string" ? body.topic.trim() : "";
+                    const limit = typeof body.limit === "number" && Number.isFinite(body.limit)
+                        ? ` ${Math.max(1, Math.trunc(body.limit))}`
+                        : "";
+                    commandText = `/mu forum read${topic ? ` ${topic}` : ""}${limit}`;
+                    break;
+                }
+                case "run_list":
+                    commandText = "/mu run list";
+                    break;
+                case "run_status": {
+                    const rootId = typeof body.root_issue_id === "string" ? body.root_issue_id.trim() : "";
+                    commandText = `/mu run status${rootId ? ` ${rootId}` : ""}`;
+                    break;
+                }
+                case "ready":
+                    commandText = "/mu ready";
+                    break;
+                default:
+                    return Response.json({ error: `unknown command kind: ${kind}` }, { status: 400, headers });
+            }
+            try {
+                if (!controlPlaneProxy.submitTerminalCommand) {
+                    return Response.json({ error: "control plane not available" }, { status: 503, headers });
+                }
+                const result = await controlPlaneProxy.submitTerminalCommand({
+                    commandText,
+                    repoRoot: context.repoRoot,
+                });
+                return Response.json({ ok: true, result }, { headers });
+            }
+            catch (err) {
+                return Response.json({ error: `command failed: ${describeError(err)}` }, { status: 500, headers });
+            }
+        }
         if (path === "/api/runs") {
             if (request.method !== "GET") {
                 return Response.json({ error: "Method Not Allowed" }, { status: 405, headers });
@@ -2016,6 +2112,7 @@ export async function createServerAsync(options = {}) {
             generation_seq: 0,
         },
         telemetry: generationTelemetry,
+        terminalEnabled: true,
     });
     const serverConfig = createServer({
         ...options,

package/package.json

@@ -1,40 +1,40 @@
 {
-	"name": "@femtomc/mu-server",
-	"version": "26.2.65",
-	"description": "HTTP API server for mu status, work items, messaging setup, and web UI.",
-	"keywords": [
-		"mu",
-		"server",
-		"api",
-		"web",
-		"automation"
-	],
-	"type": "module",
-	"main": "./dist/index.js",
-	"types": "./dist/index.d.ts",
-	"bin": {
-		"mu-server": "./dist/cli.js"
-	},
-	"exports": {
-		".": {
-			"types": "./dist/index.d.ts",
-			"default": "./dist/index.js"
-		}
-	},
-	"files": [
-		"dist/**",
-		"public/**"
-	],
-	"scripts": {
-		"build": "tsc -p tsconfig.build.json",
-		"test": "bun test",
-		"start": "bun run dist/cli.js"
-	},
-	"dependencies": {
-		"@femtomc/mu-agent": "26.2.65",
-		"@femtomc/mu-control-plane": "26.2.65",
-		"@femtomc/mu-core": "26.2.65",
-		"@femtomc/mu-forum": "26.2.65",
-		"@femtomc/mu-issue": "26.2.65"
-	}
+  "name": "@femtomc/mu-server",
+  "version": "26.2.66",
+  "description": "HTTP API server for mu status, work items, messaging setup, and web UI.",
+  "keywords": [
+    "mu",
+    "server",
+    "api",
+    "web",
+    "automation"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "mu-server": "./dist/cli.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist/**",
+    "public/**"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "test": "bun test",
+    "start": "bun run dist/cli.js"
+  },
+  "dependencies": {
+    "@femtomc/mu-agent": "26.2.65",
+    "@femtomc/mu-control-plane": "26.2.65",
+    "@femtomc/mu-core": "26.2.65",
+    "@femtomc/mu-forum": "26.2.65",
+    "@femtomc/mu-issue": "26.2.65"
+  }
 }