@femtomc/mu-server 26.2.69 → 26.2.71

package/dist/run_supervisor.d.ts

@@ -18,6 +18,8 @@ export type ControlPlaneRunSnapshot = {
     exit_code: number | null;
     pid: number | null;
     last_progress: string | null;
+    queue_id?: string;
+    queue_state?: "queued" | "active" | "waiting_review" | "refining" | "done" | "failed" | "cancelled";
 };
 export type ControlPlaneRunTrace = {
     run: ControlPlaneRunSnapshot;
@@ -65,19 +67,37 @@ export type ControlPlaneRunSupervisorOpts = {
     maxHistory?: number;
     onEvent?: (event: ControlPlaneRunEvent) => void | Promise<void>;
 };
+/**
+ * Process execution boundary for orchestration runs.
+ *
+ * Contract with the durable queue/reconcile layer:
+ * - this supervisor executes already-selected work; it does not decide inter-root scheduling policy
+ * - sequential/parallel root policy is enforced by queue leasing before launch
+ * - compatibility adapters may call launch directly during migration, but the default path is queue-first
+ */
 export declare class ControlPlaneRunSupervisor {
     #private;
     constructor(opts: ControlPlaneRunSupervisorOpts);
+    /**
+     * Compatibility adapter entrypoint for run-start intent.
+     * Default architecture should enqueue first, then call this after lease acquisition.
+     */
     launchStart(opts: {
         prompt: string;
         maxSteps?: number;
         command?: CommandRecord | null;
+        commandId?: string | null;
         source?: "command" | "api";
     }): Promise<ControlPlaneRunSnapshot>;
+    /**
+     * Compatibility adapter entrypoint for run-resume intent.
+     * No feature-flag branch: queue-first reconcile remains the canonical path.
+     */
     launchResume(opts: {
         rootIssueId: string;
         maxSteps?: number;
         command?: CommandRecord | null;
+        commandId?: string | null;
         source?: "command" | "api";
     }): Promise<ControlPlaneRunSnapshot>;
     list(opts?: {

package/dist/run_supervisor.js

@@ -97,6 +97,14 @@ function describeRun(snapshot) {
     const root = snapshot.root_issue_id ?? snapshot.job_id;
     return `${snapshot.mode} ${root}`;
 }
+/**
+ * Process execution boundary for orchestration runs.
+ *
+ * Contract with the durable queue/reconcile layer:
+ * - this supervisor executes already-selected work; it does not decide inter-root scheduling policy
+ * - sequential/parallel root policy is enforced by queue leasing before launch
+ * - compatibility adapters may call launch directly during migration, but the default path is queue-first
+ */
 export class ControlPlaneRunSupervisor {
     #repoRoot;
     #nowMs;
@@ -212,6 +220,12 @@ export class ControlPlaneRunSupervisor {
             this.#emit("run_progress", job, `📈 ${line.trim()}`);
         }
     }
+    /**
+     * Executes one queue-activated run job.
+     *
+     * Queue contract expectation: caller has already persisted/activated the queue item and associated
+     * this launch with exactly one root slot under the active inter-root policy.
+     */
     async #launch(opts) {
         const nowMs = Math.trunc(this.#nowMs());
         const process = this.#spawnProcess({ argv: opts.argv, cwd: this.#repoRoot });
@@ -222,7 +236,7 @@ export class ControlPlaneRunSupervisor {
             prompt: opts.prompt,
             root_issue_id: opts.rootIssueId,
             max_steps: opts.maxSteps,
-            command_id: opts.command?.command_id ?? null,
+            command_id: opts.command?.command_id ?? opts.commandId ?? null,
             source: opts.source,
             started_at_ms: nowMs,
             updated_at_ms: nowMs,
@@ -298,6 +312,10 @@ export class ControlPlaneRunSupervisor {
         })();
         return this.#snapshot(job);
     }
+    /**
+     * Compatibility adapter entrypoint for run-start intent.
+     * Default architecture should enqueue first, then call this after lease acquisition.
+     */
     async launchStart(opts) {
         const prompt = opts.prompt.trim();
         if (prompt.length === 0) {
@@ -312,9 +330,14 @@ export class ControlPlaneRunSupervisor {
             maxSteps,
             argv,
             command: opts.command ?? null,
+            commandId: opts.commandId ?? null,
             source: opts.source ?? "api",
         });
     }
+    /**
+     * Compatibility adapter entrypoint for run-resume intent.
+     * No feature-flag branch: queue-first reconcile remains the canonical path.
+     */
     async launchResume(opts) {
         const rootIssueId = normalizeIssueId(opts.rootIssueId);
         if (!rootIssueId) {
@@ -329,6 +352,7 @@ export class ControlPlaneRunSupervisor {
             maxSteps,
             argv,
             command: opts.command ?? null,
+            commandId: opts.commandId ?? null,
             source: opts.source ?? "api",
         });
     }

package/dist/server.d.ts

@@ -1,32 +1,17 @@
-import { GenerationTelemetryRecorder, type ReloadableGenerationIdentity } from "@femtomc/mu-control-plane";
+import { GenerationTelemetryRecorder } from "@femtomc/mu-control-plane";
 import type { EventEnvelope, JsonlStore } from "@femtomc/mu-core";
 import { EventLog } from "@femtomc/mu-core/node";
 import { ForumStore } from "@femtomc/mu-forum";
 import { IssueStore } from "@femtomc/mu-issue";
 import { ControlPlaneActivitySupervisor } from "./activity_supervisor.js";
 import { type MuConfig } from "./config.js";
-import { type ControlPlaneConfig, type ControlPlaneHandle, type ControlPlaneSessionLifecycle, type ControlPlaneSessionMutationAction } from "./control_plane.js";
-import { CronProgramRegistry } from "./cron_programs.js";
-import { HeartbeatProgramRegistry } from "./heartbeat_programs.js";
+import type { ControlPlaneHandle, ControlPlaneSessionLifecycle } from "./control_plane_contract.js";
+import { type ConfigReader, type ConfigWriter, type ControlPlaneReloader, type ControlPlaneReloadResult, type ControlPlaneSummary } from "./control_plane_reload.js";
 import { ActivityHeartbeatScheduler } from "./heartbeat_scheduler.js";
-type ShellCommandResult = {
-    exitCode: number;
-    stdout: string;
-    stderr: string;
-};
-type ShellCommandRunner = (command: string) => Promise<ShellCommandResult>;
-export declare function createProcessSessionLifecycle(opts: {
-    repoRoot: string;
-    runShellCommand?: ShellCommandRunner;
-}): ControlPlaneSessionLifecycle;
-type ControlPlaneReloader = (opts: {
-    repoRoot: string;
-    previous: ControlPlaneHandle | null;
-    config: ControlPlaneConfig;
-    generation: ReloadableGenerationIdentity;
-}) => Promise<ControlPlaneHandle | null>;
-type ConfigReader = (repoRoot: string) => Promise<MuConfig>;
-type ConfigWriter = (repoRoot: string, config: MuConfig) => Promise<string>;
+import { createProcessSessionLifecycle } from "./session_lifecycle.js";
+import type { ServerRuntime } from "./server_runtime.js";
+export { createProcessSessionLifecycle };
+export type { ConfigReader, ConfigWriter, ControlPlaneReloader, ControlPlaneReloadResult, ControlPlaneSummary, };
 export type ServerOptions = {
     repoRoot?: string;
     port?: number;
@@ -41,15 +26,7 @@ export type ServerOptions = {
     configReader?: ConfigReader;
     configWriter?: ConfigWriter;
     sessionLifecycle?: ControlPlaneSessionLifecycle;
-};
-export type ServerRuntimeOptions = {
-    repoRoot?: string;
-    controlPlane?: ControlPlaneHandle | null;
-    heartbeatScheduler?: ActivityHeartbeatScheduler;
-    generationTelemetry?: GenerationTelemetryRecorder;
-    config?: MuConfig;
-    configReader?: ConfigReader;
-    sessionLifecycle?: ControlPlaneSessionLifecycle;
+    initiateShutdown?: () => Promise<void>;
 };
 export type ServerInstanceOptions = Omit<ServerOptions, "repoRoot" | "controlPlane" | "heartbeatScheduler" | "generationTelemetry" | "config" | "sessionLifecycle">;
 export type ServerContext = {
@@ -60,28 +37,14 @@ export type ServerContext = {
     eventsStore: JsonlStore<EventEnvelope>;
 };
 export declare function createContext(repoRoot: string): ServerContext;
-export type ServerRuntimeCapabilities = {
-    session_lifecycle_actions: readonly ControlPlaneSessionMutationAction[];
-    control_plane_bootstrapped: boolean;
-    control_plane_adapters: string[];
-};
-export type ServerRuntime = {
-    repoRoot: string;
-    config: MuConfig;
-    heartbeatScheduler: ActivityHeartbeatScheduler;
-    generationTelemetry: GenerationTelemetryRecorder;
-    sessionLifecycle: ControlPlaneSessionLifecycle;
-    controlPlane: ControlPlaneHandle | null;
-    capabilities: ServerRuntimeCapabilities;
-};
-export declare function composeServerRuntime(options?: ServerRuntimeOptions): Promise<ServerRuntime>;
+export type { ServerRuntime, ServerRuntimeCapabilities, ServerRuntimeOptions } from "./server_runtime.js";
+export { composeServerRuntime } from "./server_runtime.js";
 export declare function createServerFromRuntime(runtime: ServerRuntime, options?: ServerInstanceOptions): {
     port: number;
     fetch: (request: Request) => Promise<Response>;
     hostname: string;
     controlPlane: ControlPlaneHandle;
     activitySupervisor: ControlPlaneActivitySupervisor;
-    heartbeatPrograms: HeartbeatProgramRegistry;
-    cronPrograms: CronProgramRegistry;
+    heartbeatPrograms: import("./heartbeat_programs.js").HeartbeatProgramRegistry;
+    cronPrograms: import("./cron_programs.js").CronProgramRegistry;
 };
-export {};