@femtomc/mu-server 26.2.72 → 26.2.74

package/dist/server.js

@@ -1,9 +1,7 @@
-import { GenerationTelemetryRecorder } from "@femtomc/mu-control-plane";
+import { GenerationTelemetryRecorder, presentPipelineResultMessage, } from "@femtomc/mu-control-plane";
 import { currentRunId, EventLog, FsJsonlStore, getStorePaths, JsonlEventSink } from "@femtomc/mu-core/node";
-import { ForumStore } from "@femtomc/mu-forum";
-import { IssueStore } from "@femtomc/mu-issue";
 import { ControlPlaneActivitySupervisor } from "./activity_supervisor.js";
-import { DEFAULT_MU_CONFIG, readMuConfigFile, writeMuConfigFile, } from "./config.js";
+import { DEFAULT_MU_CONFIG, readMuConfigFile, writeMuConfigFile } from "./config.js";
 import { bootstrapControlPlane } from "./control_plane.js";
 import { createReloadManager, } from "./control_plane_reload.js";
 import { ActivityHeartbeatScheduler } from "./heartbeat_scheduler.js";
@@ -12,7 +10,6 @@ import { createServerProgramOrchestration } from "./server_program_orchestration
 import { createServerRequestHandler } from "./server_routing.js";
 import { toNonNegativeInt } from "./server_types.js";
 const DEFAULT_OPERATOR_WAKE_COALESCE_MS = 2_000;
-const DEFAULT_AUTO_RUN_HEARTBEAT_EVERY_MS = 15_000;
 export { createProcessSessionLifecycle };
 function describeError(err) {
     if (err instanceof Error)
@@ -27,19 +24,6 @@ function emptyNotifyOperatorsResult() {
         decisions: [],
     };
 }
-function normalizeWakeTurnMode(value) {
-    if (typeof value !== "string") {
-        return "off";
-    }
-    const normalized = value.trim().toLowerCase();
-    if (normalized === "shadow") {
-        return "shadow";
-    }
-    if (normalized === "active") {
-        return "active";
-    }
-    return "off";
-}
 function stringField(payload, key) {
     const value = payload[key];
     if (typeof value !== "string") {
@@ -55,47 +39,52 @@ function numberField(payload, key) {
     }
     return Math.trunc(value);
 }
-function computeWakeId(opts) {
-    const source = stringField(opts.payload, "wake_source") ?? "unknown";
-    const programId = stringField(opts.payload, "program_id") ?? "unknown";
-    const sourceTsMs = numberField(opts.payload, "source_ts_ms");
-    const target = Object.hasOwn(opts.payload, "target") ? opts.payload.target : null;
-    let targetFingerprint = "null";
+function stablePayloadSnapshot(payload) {
     try {
-        targetFingerprint = JSON.stringify(target) ?? "null";
+        return JSON.stringify(payload) ?? "{}";
     }
     catch {
-        targetFingerprint = "[unserializable]";
+        return "[unserializable]";
     }
+}
+function computeWakeId(opts) {
+    const source = stringField(opts.payload, "wake_source") ?? "unknown";
+    const programId = stringField(opts.payload, "program_id") ?? "unknown";
+    const sourceTsMs = numberField(opts.payload, "source_ts_ms");
+    const payloadSnapshot = stablePayloadSnapshot(opts.payload);
     const hasher = new Bun.CryptoHasher("sha256");
-    hasher.update(`${source}|${programId}|${sourceTsMs ?? "na"}|${opts.dedupeKey}|${targetFingerprint}`);
+    hasher.update(`${source}|${programId}|${sourceTsMs ?? "na"}|${opts.dedupeKey}|${payloadSnapshot}`);
     return hasher.digest("hex").slice(0, 16);
 }
+function extractWakeTurnReply(turnResult) {
+    if (turnResult.kind === "operator_response") {
+        const message = turnResult.message.trim();
+        return message.length > 0 ? message : null;
+    }
+    const presented = presentPipelineResultMessage(turnResult);
+    const payload = presented.message.payload;
+    const payloadMessage = typeof payload.message === "string" ? payload.message.trim() : "";
+    if (payloadMessage.length > 0) {
+        return payloadMessage;
+    }
+    const compact = presented.compact.trim();
+    return compact.length > 0 ? compact : null;
+}
 function buildWakeTurnCommandText(opts) {
     const wakeSource = stringField(opts.payload, "wake_source") ?? "unknown";
     const programId = stringField(opts.payload, "program_id") ?? "unknown";
-    const wakeMode = stringField(opts.payload, "wake_mode") ?? "immediate";
-    const targetKind = stringField(opts.payload, "target_kind") ?? "unknown";
     const reason = stringField(opts.payload, "reason") ?? "scheduled";
-    let target = "null";
-    try {
-        target = JSON.stringify(Object.hasOwn(opts.payload, "target") ? opts.payload.target : null) ?? "null";
-    }
-    catch {
-        target = "[unserializable]";
-    }
+    const payloadSnapshot = stablePayloadSnapshot(opts.payload);
     return [
         "Autonomous wake turn triggered by heartbeat/cron scheduler.",
         `wake_id=${opts.wakeId}`,
         `wake_source=${wakeSource}`,
         `program_id=${programId}`,
-        `wake_mode=${wakeMode}`,
-        `target_kind=${targetKind}`,
         `reason=${reason}`,
-        `message=${opts.message}`,
-        `target=${target}`,
+        `trigger_message=${opts.message}`,
+        `payload=${payloadSnapshot}`,
         "",
-        "If an action is needed, produce exactly one `/mu ...` command. If no action is needed, provide a short operator response.",
+        "If action is needed, produce exactly one `/mu ...` command. If no action is needed, return a short operator response that can be broadcast verbatim.",
     ].join("\n");
 }
 export function createContext(repoRoot) {
@@ -104,9 +93,7 @@ export function createContext(repoRoot) {
     const eventLog = new EventLog(new JsonlEventSink(eventsStore), {
         runIdProvider: currentRunId,
     });
-    const issueStore = new IssueStore(new FsJsonlStore(paths.issuesPath), { events: eventLog });
-    const forumStore = new ForumStore(new FsJsonlStore(paths.forumPath), { events: eventLog });
-    return { repoRoot, issueStore, forumStore, eventLog, eventsStore };
+    return { repoRoot, eventLog, eventsStore };
 }
 function createServer(options = {}) {
     const repoRoot = options.repoRoot || process.cwd();
@@ -134,7 +121,6 @@ function createServer(options = {}) {
             },
         });
     const operatorWakeCoalesceMs = toNonNegativeInt(options.operatorWakeCoalesceMs, DEFAULT_OPERATOR_WAKE_COALESCE_MS);
-    const autoRunHeartbeatEveryMs = Math.max(1_000, toNonNegativeInt(options.autoRunHeartbeatEveryMs, DEFAULT_AUTO_RUN_HEARTBEAT_EVERY_MS));
     const operatorWakeLastByKey = new Map();
     const sessionLifecycle = options.sessionLifecycle ?? createProcessSessionLifecycle({ repoRoot });
     const emitWakeDeliveryEvent = async (payload) => {
@@ -146,61 +132,28 @@ function createServer(options = {}) {
     const emitOperatorWake = async (opts) => {
         const dedupeKey = opts.dedupeKey.trim();
         if (!dedupeKey) {
-            return false;
+            return { status: "failed", reason: "missing_dedupe_key" };
         }
         const nowMs = Date.now();
         const coalesceMs = Math.max(0, Math.trunc(opts.coalesceMs ?? operatorWakeCoalesceMs));
         const previous = operatorWakeLastByKey.get(dedupeKey);
         if (typeof previous === "number" && nowMs - previous < coalesceMs) {
-            return false;
+            return { status: "coalesced", reason: "coalesced_window" };
         }
         operatorWakeLastByKey.set(dedupeKey, nowMs);
         const wakeId = computeWakeId({ dedupeKey, payload: opts.payload });
-        const selectedWakeMode = stringField(opts.payload, "wake_mode");
         const wakeSource = stringField(opts.payload, "wake_source");
         const programId = stringField(opts.payload, "program_id");
         const sourceTsMs = numberField(opts.payload, "source_ts_ms");
-        let wakeTurnMode = normalizeWakeTurnMode(fallbackConfig.control_plane.operator.wake_turn_mode);
-        let configReadError = null;
-        try {
-            const config = await loadConfigFromDisk();
-            wakeTurnMode = normalizeWakeTurnMode(config.control_plane.operator.wake_turn_mode);
-        }
-        catch (err) {
-            configReadError = describeError(err);
-        }
         let decision;
-        if (wakeTurnMode === "off") {
-            decision = {
-                outcome: "skipped",
-                reason: "feature_disabled",
-                wakeTurnMode,
-                selectedWakeMode,
-                turnRequestId: null,
-                turnResultKind: null,
-                error: configReadError,
-            };
-        }
-        else if (wakeTurnMode === "shadow") {
-            decision = {
-                outcome: "skipped",
-                reason: "shadow_mode",
-                wakeTurnMode,
-                selectedWakeMode,
-                turnRequestId: null,
-                turnResultKind: null,
-                error: configReadError,
-            };
-        }
-        else if (typeof controlPlaneProxy.submitTerminalCommand !== "function") {
+        if (typeof controlPlaneProxy.submitTerminalCommand !== "function") {
             decision = {
                 outcome: "fallback",
                 reason: "control_plane_unavailable",
-                wakeTurnMode,
-                selectedWakeMode,
                 turnRequestId: null,
                 turnResultKind: null,
-                error: configReadError,
+                turnReply: null,
+                error: null,
             };
         }
         else {
@@ -219,23 +172,34 @@ function createServer(options = {}) {
                     decision = {
                         outcome: "fallback",
                         reason: `turn_result_${turnResult.kind}`,
-                        wakeTurnMode,
-                        selectedWakeMode,
                         turnRequestId,
                         turnResultKind: turnResult.kind,
-                        error: configReadError,
+                        turnReply: null,
+                        error: null,
                     };
                 }
                 else {
-                    decision = {
-                        outcome: "triggered",
-                        reason: "turn_invoked",
-                        wakeTurnMode,
-                        selectedWakeMode,
-                        turnRequestId,
-                        turnResultKind: turnResult.kind,
-                        error: configReadError,
-                    };
+                    const turnReply = extractWakeTurnReply(turnResult);
+                    if (!turnReply) {
+                        decision = {
+                            outcome: "fallback",
+                            reason: "turn_reply_empty",
+                            turnRequestId,
+                            turnResultKind: turnResult.kind,
+                            turnReply: null,
+                            error: null,
+                        };
+                    }
+                    else {
+                        decision = {
+                            outcome: "triggered",
+                            reason: "turn_invoked",
+                            turnRequestId,
+                            turnResultKind: turnResult.kind,
+                            turnReply,
+                            error: null,
+                        };
+                    }
                 }
             }
             catch (err) {
@@ -243,10 +207,9 @@ function createServer(options = {}) {
                 decision = {
                     outcome: "fallback",
                     reason: error === "control_plane_unavailable" ? "control_plane_unavailable" : "turn_execution_failed",
-                    wakeTurnMode,
-                    selectedWakeMode,
                     turnRequestId,
                     turnResultKind: null,
+                    turnReply: null,
                     error,
                 };
             }
@@ -259,22 +222,27 @@ function createServer(options = {}) {
                 wake_source: wakeSource,
                 program_id: programId,
                 source_ts_ms: sourceTsMs,
-                selected_wake_mode: selectedWakeMode,
-                wake_turn_mode: decision.wakeTurnMode,
-                wake_turn_feature_enabled: decision.wakeTurnMode === "active",
-                outcome: decision.outcome,
-                reason: decision.reason,
+                wake_turn_outcome: decision.outcome,
+                wake_turn_reason: decision.reason,
                 turn_request_id: decision.turnRequestId,
                 turn_result_kind: decision.turnResultKind,
-                error: decision.error,
+                turn_reply_present: decision.turnReply != null,
+                wake_turn_error: decision.error,
             },
         });
         let notifyResult = emptyNotifyOperatorsResult();
         let notifyError = null;
-        if (typeof controlPlaneProxy.notifyOperators === "function") {
+        let deliverySkippedReason = null;
+        if (!decision.turnReply) {
+            deliverySkippedReason = "no_turn_reply";
+        }
+        else if (typeof controlPlaneProxy.notifyOperators !== "function") {
+            deliverySkippedReason = "notify_operators_unavailable";
+        }
+        else {
             try {
                 notifyResult = await controlPlaneProxy.notifyOperators({
-                    message: opts.message,
+                    message: decision.turnReply,
                     dedupeKey,
                     wake: {
                         wakeId,
@@ -286,6 +254,7 @@ function createServer(options = {}) {
                         wake_delivery_reason: "heartbeat_cron_wake",
                         wake_turn_outcome: decision.outcome,
                         wake_turn_reason: decision.reason,
+                        wake_turn_result_kind: decision.turnResultKind,
                     },
                 });
             }
@@ -312,19 +281,18 @@ function createServer(options = {}) {
         await context.eventLog.emit("operator.wake", {
             source: "mu-server.operator-wake",
             payload: {
-                message: opts.message,
+                trigger_message: opts.message,
+                broadcast_message: decision.turnReply,
+                broadcast_message_present: decision.turnReply != null,
                 dedupe_key: dedupeKey,
                 coalesce_ms: coalesceMs,
                 ...opts.payload,
                 wake_id: wakeId,
-                decision_outcome: decision.outcome,
-                decision_reason: decision.reason,
-                wake_turn_mode: decision.wakeTurnMode,
-                selected_wake_mode: decision.selectedWakeMode,
-                wake_turn_feature_enabled: decision.wakeTurnMode === "active",
+                wake_turn_outcome: decision.outcome,
+                wake_turn_reason: decision.reason,
                 turn_request_id: decision.turnRequestId,
                 turn_result_kind: decision.turnResultKind,
-                decision_error: decision.error,
+                wake_turn_error: decision.error,
                 delivery: {
                     queued: notifyResult.queued,
                     duplicate: notifyResult.duplicate,
@@ -336,10 +304,23 @@ function createServer(options = {}) {
                     skipped: notifyResult.skipped,
                     total: notifyResult.decisions.length,
                 },
+                delivery_skipped_reason: deliverySkippedReason,
                 delivery_error: notifyError,
             },
         });
-        return true;
+        if (decision.outcome !== "triggered") {
+            return { status: "failed", reason: decision.reason };
+        }
+        if (!decision.turnReply) {
+            return { status: "failed", reason: "no_turn_reply" };
+        }
+        if (notifyError) {
+            return { status: "failed", reason: "notify_failed" };
+        }
+        if (deliverySkippedReason === "notify_operators_unavailable") {
+            return { status: "failed", reason: deliverySkippedReason };
+        }
+        return { status: "dispatched", reason: "operator_reply_broadcast" };
     };
     const generationTelemetry = options.generationTelemetry ?? new GenerationTelemetryRecorder();
     const loadConfigFromDisk = async () => {
@@ -358,7 +339,6 @@ function createServer(options = {}) {
             return await bootstrapControlPlane({
                 repoRoot,
                 config,
-                heartbeatScheduler,
                 generation,
                 telemetry: generationTelemetry,
                 sessionLifecycle,
@@ -461,13 +441,6 @@ function createServer(options = {}) {
             }
             return await handle.interruptRun(opts);
         },
-        async heartbeatRun(opts) {
-            const handle = reloadManager.getControlPlaneCurrent();
-            if (!handle?.heartbeatRun) {
-                return { ok: false, reason: "not_found", run: null };
-            }
-            return await handle.heartbeatRun(opts);
-        },
         async traceRun(opts) {
             const handle = reloadManager.getControlPlaneCurrent();
             if (!handle?.traceRun)
@@ -488,13 +461,10 @@ function createServer(options = {}) {
             await handle?.stop();
         },
     };
-    const { heartbeatPrograms, cronPrograms, registerAutoRunHeartbeatProgram, disableAutoRunHeartbeatProgram, } = createServerProgramOrchestration({
+    const { heartbeatPrograms, cronPrograms } = createServerProgramOrchestration({
         repoRoot,
         heartbeatScheduler,
-        controlPlaneProxy,
-        activitySupervisor,
         eventLog: context.eventLog,
-        autoRunHeartbeatEveryMs,
         emitOperatorWake,
     });
     const handleRequest = createServerRequestHandler({
@@ -507,8 +477,6 @@ function createServer(options = {}) {
         writeConfig,
         reloadControlPlane,
         getControlPlaneStatus: reloadManager.getControlPlaneStatus,
-        registerAutoRunHeartbeatProgram,
-        disableAutoRunHeartbeatProgram,
         describeError,
         initiateShutdown: options.initiateShutdown,
     });

package/dist/server_program_orchestration.d.ts

@@ -1,38 +1,23 @@
 import type { EventLog } from "@femtomc/mu-core/node";
-import type { ControlPlaneActivitySupervisor } from "./activity_supervisor.js";
-import type { ControlPlaneHandle } from "./control_plane_contract.js";
 import { CronProgramRegistry } from "./cron_programs.js";
 import { HeartbeatProgramRegistry } from "./heartbeat_programs.js";
 import type { ActivityHeartbeatScheduler } from "./heartbeat_scheduler.js";
-export type AutoHeartbeatRunSnapshot = {
-    job_id: string;
-    root_issue_id: string | null;
-    status: string;
-    source: "command" | "api";
-    mode: string;
-};
 type OperatorWakeEmitter = (opts: {
     dedupeKey: string;
     message: string;
     payload: Record<string, unknown>;
     coalesceMs?: number;
-}) => Promise<boolean>;
+}) => Promise<{
+    status: "dispatched" | "coalesced" | "failed";
+    reason: string;
+}>;
 export declare function createServerProgramOrchestration(opts: {
     repoRoot: string;
     heartbeatScheduler: ActivityHeartbeatScheduler;
-    controlPlaneProxy: ControlPlaneHandle;
-    activitySupervisor: ControlPlaneActivitySupervisor;
     eventLog: EventLog;
-    autoRunHeartbeatEveryMs: number;
     emitOperatorWake: OperatorWakeEmitter;
 }): {
     heartbeatPrograms: HeartbeatProgramRegistry;
     cronPrograms: CronProgramRegistry;
-    registerAutoRunHeartbeatProgram: (run: AutoHeartbeatRunSnapshot) => Promise<void>;
-    disableAutoRunHeartbeatProgram: (opts: {
-        jobId: string;
-        status: string;
-        reason: string;
-    }) => Promise<void>;
 };
 export {};