@femtomc/mu-server 26.2.69 → 26.2.71

package/dist/cron_request.js

@@ -0,0 +1,65 @@
+export function parseCronTarget(body) {
+    const targetKind = typeof body.target_kind === "string" ? body.target_kind.trim().toLowerCase() : "";
+    if (targetKind === "run") {
+        const jobId = typeof body.run_job_id === "string" ? body.run_job_id.trim() : "";
+        const rootIssueId = typeof body.run_root_issue_id === "string" ? body.run_root_issue_id.trim() : "";
+        if (!jobId && !rootIssueId) {
+            return {
+                target: null,
+                error: "run target requires run_job_id or run_root_issue_id",
+            };
+        }
+        return {
+            target: {
+                kind: "run",
+                job_id: jobId || null,
+                root_issue_id: rootIssueId || null,
+            },
+            error: null,
+        };
+    }
+    if (targetKind === "activity") {
+        const activityId = typeof body.activity_id === "string" ? body.activity_id.trim() : "";
+        if (!activityId) {
+            return {
+                target: null,
+                error: "activity target requires activity_id",
+            };
+        }
+        return {
+            target: {
+                kind: "activity",
+                activity_id: activityId,
+            },
+            error: null,
+        };
+    }
+    return {
+        target: null,
+        error: "target_kind must be run or activity",
+    };
+}
+export function hasCronScheduleInput(body) {
+    return (body.schedule != null ||
+        body.schedule_kind != null ||
+        body.at_ms != null ||
+        body.at != null ||
+        body.every_ms != null ||
+        body.anchor_ms != null ||
+        body.expr != null ||
+        body.tz != null);
+}
+export function cronScheduleInputFromBody(body) {
+    if (body.schedule && typeof body.schedule === "object" && !Array.isArray(body.schedule)) {
+        return { ...body.schedule };
+    }
+    return {
+        kind: typeof body.schedule_kind === "string" ? body.schedule_kind : undefined,
+        at_ms: body.at_ms,
+        at: body.at,
+        every_ms: body.every_ms,
+        anchor_ms: body.anchor_ms,
+        expr: body.expr,
+        tz: body.tz,
+    };
+}

package/dist/index.d.ts

@@ -2,7 +2,10 @@ export type { ControlPlaneActivityEvent, ControlPlaneActivityEventKind, ControlP
 export { ControlPlaneActivitySupervisor } from "./activity_supervisor.js";
 export type { MuConfig, MuConfigPatch, MuConfigPresence } from "./config.js";
 export { applyMuConfigPatch, DEFAULT_MU_CONFIG, getMuConfigPath, muConfigPresence, normalizeMuConfig, readMuConfigFile, redactMuConfigSecrets, writeMuConfigFile, } from "./config.js";
-export type { ActiveAdapter, ControlPlaneConfig, ControlPlaneHandle, ControlPlaneSessionLifecycle, ControlPlaneSessionMutationAction, ControlPlaneSessionMutationResult, } from "./control_plane.js";
+export type { ActiveAdapter, ControlPlaneConfig, ControlPlaneHandle, ControlPlaneSessionLifecycle, ControlPlaneSessionMutationAction, ControlPlaneSessionMutationResult, InterRootQueuePolicy, NotifyOperatorsOpts, NotifyOperatorsResult, OrchestrationQueueState, WakeDeliveryEvent, WakeNotifyContext, WakeNotifyDecision, } from "./control_plane_contract.js";
+export { DEFAULT_INTER_ROOT_QUEUE_POLICY, normalizeInterRootQueuePolicy, ORCHESTRATION_QUEUE_ALLOWED_TRANSITIONS, ORCHESTRATION_QUEUE_INVARIANTS, } from "./control_plane_contract.js";
+export type { DurableRunQueueClaimOpts, DurableRunQueueEnqueueOpts, DurableRunQueueOpts, DurableRunQueueSnapshot, DurableRunQueueState, DurableRunQueueTransitionOpts, RunQueueReconcilePlan, } from "./run_queue.js";
+export { DurableRunQueue, queueStatesForRunStatusFilter, reconcileRunQueue, RUN_QUEUE_RECONCILE_INVARIANTS, runQueuePath, runSnapshotFromQueueSnapshot, runStatusFromQueueState, } from "./run_queue.js";
 export { bootstrapControlPlane, detectAdapters } from "./control_plane.js";
 export type { CronProgramLifecycleAction, CronProgramLifecycleEvent, CronProgramOperationResult, CronProgramRegistryOpts, CronProgramSnapshot, CronProgramStatusSnapshot, CronProgramTarget, CronProgramTickEvent, CronProgramWakeMode, } from "./cron_programs.js";
 export { CronProgramRegistry } from "./cron_programs.js";
@@ -15,4 +18,6 @@ export { HeartbeatProgramRegistry } from "./heartbeat_programs.js";
 export type { ActivityHeartbeatSchedulerOpts, HeartbeatRunResult, HeartbeatTickHandler, } from "./heartbeat_scheduler.js";
 export { ActivityHeartbeatScheduler } from "./heartbeat_scheduler.js";
 export type { ServerContext, ServerInstanceOptions, ServerOptions, ServerRuntime, ServerRuntimeCapabilities, ServerRuntimeOptions, } from "./server.js";
-export { composeServerRuntime, createContext, createProcessSessionLifecycle, createServerFromRuntime, } from "./server.js";
+export { composeServerRuntime, createContext, createServerFromRuntime } from "./server.js";
+export type { ShellCommandResult, ShellCommandRunner } from "./session_lifecycle.js";
+export { createProcessSessionLifecycle } from "./session_lifecycle.js";

package/dist/index.js

@@ -1,9 +1,12 @@
 export { ControlPlaneActivitySupervisor } from "./activity_supervisor.js";
 export { applyMuConfigPatch, DEFAULT_MU_CONFIG, getMuConfigPath, muConfigPresence, normalizeMuConfig, readMuConfigFile, redactMuConfigSecrets, writeMuConfigFile, } from "./config.js";
+export { DEFAULT_INTER_ROOT_QUEUE_POLICY, normalizeInterRootQueuePolicy, ORCHESTRATION_QUEUE_ALLOWED_TRANSITIONS, ORCHESTRATION_QUEUE_INVARIANTS, } from "./control_plane_contract.js";
+export { DurableRunQueue, queueStatesForRunStatusFilter, reconcileRunQueue, RUN_QUEUE_RECONCILE_INVARIANTS, runQueuePath, runSnapshotFromQueueSnapshot, runStatusFromQueueState, } from "./run_queue.js";
 export { bootstrapControlPlane, detectAdapters } from "./control_plane.js";
 export { CronProgramRegistry } from "./cron_programs.js";
 export { computeNextScheduleRunAtMs, normalizeCronSchedule } from "./cron_schedule.js";
 export { CronTimerRegistry } from "./cron_timer.js";
 export { HeartbeatProgramRegistry } from "./heartbeat_programs.js";
 export { ActivityHeartbeatScheduler } from "./heartbeat_scheduler.js";
-export { composeServerRuntime, createContext, createProcessSessionLifecycle, createServerFromRuntime, } from "./server.js";
+export { composeServerRuntime, createContext, createServerFromRuntime } from "./server.js";
+export { createProcessSessionLifecycle } from "./session_lifecycle.js";

package/dist/run_queue.d.ts

@@ -0,0 +1,95 @@
+import type { JsonlStore } from "@femtomc/mu-core";
+import { type InterRootQueuePolicy, type InterRootQueueReconcilePlan, type OrchestrationQueueState } from "@femtomc/mu-orchestrator";
+import type { ControlPlaneRunMode, ControlPlaneRunSnapshot, ControlPlaneRunStatus } from "./run_supervisor.js";
+export type DurableRunQueueState = OrchestrationQueueState;
+export type DurableRunQueueSnapshot = {
+    v: 1;
+    queue_id: string;
+    dedupe_key: string;
+    mode: ControlPlaneRunMode;
+    state: DurableRunQueueState;
+    prompt: string | null;
+    root_issue_id: string | null;
+    max_steps: number;
+    command_id: string | null;
+    source: "command" | "api";
+    job_id: string | null;
+    started_at_ms: number | null;
+    updated_at_ms: number;
+    finished_at_ms: number | null;
+    exit_code: number | null;
+    pid: number | null;
+    last_progress: string | null;
+    created_at_ms: number;
+    revision: number;
+    applied_operation_ids: string[];
+};
+export type DurableRunQueueOpts = {
+    repoRoot: string;
+    nowMs?: () => number;
+    store?: JsonlStore<unknown>;
+    maxOperationIds?: number;
+};
+export type DurableRunQueueEnqueueOpts = {
+    mode: ControlPlaneRunMode;
+    prompt: string | null;
+    rootIssueId: string | null;
+    maxSteps?: number;
+    commandId?: string | null;
+    source: "command" | "api";
+    dedupeKey: string;
+    operationId?: string | null;
+    nowMs?: number;
+};
+export type DurableRunQueueTransitionOpts = {
+    queueId: string;
+    toState: DurableRunQueueState;
+    operationId?: string | null;
+    nowMs?: number;
+};
+export type DurableRunQueueClaimOpts = {
+    queueId?: string | null;
+    operationId?: string | null;
+    nowMs?: number;
+};
+export declare function runStatusFromQueueState(state: DurableRunQueueState): ControlPlaneRunStatus;
+export declare function queueStatesForRunStatusFilter(status: string | null | undefined): DurableRunQueueState[] | null;
+export type RunQueueReconcilePlan = InterRootQueueReconcilePlan;
+export declare const RUN_QUEUE_RECONCILE_INVARIANTS: readonly ["ORCH-INTER-ROOT-RECON-001: one queue snapshot + policy yields one deterministic activation/launch plan.", "ORCH-INTER-ROOT-RECON-002: activation order is FIFO (`created_at_ms`, then `queue_id`) with per-root slot dedupe.", "ORCH-INTER-ROOT-RECON-003: sequential policy admits <=1 occupied root; parallel admits <=max_active_roots roots.", "ORCH-INTER-ROOT-RECON-004: launch candidates are active rows without bound job ids, one launch per root slot."];
+/**
+ * Server adapter wrapper around the orchestrator-owned inter-root planner.
+ */
+export declare function reconcileRunQueue(rows: readonly DurableRunQueueSnapshot[], policy: InterRootQueuePolicy): RunQueueReconcilePlan;
+export declare function runQueuePath(repoRoot: string): string;
+export declare function runSnapshotFromQueueSnapshot(queue: DurableRunQueueSnapshot, runtime?: ControlPlaneRunSnapshot | null): ControlPlaneRunSnapshot;
+export declare class DurableRunQueue {
+    #private;
+    constructor(opts: DurableRunQueueOpts);
+    enqueue(opts: DurableRunQueueEnqueueOpts): Promise<DurableRunQueueSnapshot>;
+    claim(opts?: DurableRunQueueClaimOpts): Promise<DurableRunQueueSnapshot | null>;
+    activate(opts: DurableRunQueueClaimOpts): Promise<DurableRunQueueSnapshot | null>;
+    transition(opts: DurableRunQueueTransitionOpts): Promise<DurableRunQueueSnapshot>;
+    bindRunSnapshot(opts: {
+        queueId: string;
+        run: ControlPlaneRunSnapshot;
+        operationId?: string | null;
+        nowMs?: number;
+    }): Promise<DurableRunQueueSnapshot>;
+    applyRunSnapshot(opts: {
+        run: ControlPlaneRunSnapshot;
+        queueId?: string | null;
+        operationId?: string | null;
+        nowMs?: number;
+        createIfMissing?: boolean;
+    }): Promise<DurableRunQueueSnapshot | null>;
+    get(idOrRoot: string): Promise<DurableRunQueueSnapshot | null>;
+    list(opts?: {
+        states?: readonly DurableRunQueueState[];
+        limit?: number;
+    }): Promise<DurableRunQueueSnapshot[]>;
+    listRunSnapshots(opts?: {
+        status?: string;
+        limit?: number;
+        runtimeByJobId?: Map<string, ControlPlaneRunSnapshot>;
+    }): Promise<ControlPlaneRunSnapshot[]>;
+}