@femtomc/mu-server 26.2.75 → 26.2.76

package/dist/activity_supervisor.d.ts

@@ -1,81 +0,0 @@
-import { ActivityHeartbeatScheduler } from "./heartbeat_scheduler.js";
-export type ControlPlaneActivityStatus = "running" | "completed" | "failed" | "cancelled";
-export type ControlPlaneActivitySnapshot = {
-    activity_id: string;
-    kind: string;
-    title: string;
-    status: ControlPlaneActivityStatus;
-    heartbeat_every_ms: number;
-    heartbeat_count: number;
-    last_heartbeat_at_ms: number | null;
-    last_heartbeat_reason: string | null;
-    last_progress: string | null;
-    final_message: string | null;
-    metadata: Record<string, unknown>;
-    source: "api" | "command" | "system";
-    started_at_ms: number;
-    updated_at_ms: number;
-    finished_at_ms: number | null;
-};
-export type ControlPlaneActivityEventKind = "activity_started" | "activity_progress" | "activity_heartbeat" | "activity_completed" | "activity_failed" | "activity_cancelled";
-export type ControlPlaneActivityEvent = {
-    seq: number;
-    ts_ms: number;
-    kind: ControlPlaneActivityEventKind;
-    message: string;
-    activity: ControlPlaneActivitySnapshot;
-};
-export type ControlPlaneActivityMutationResult = {
-    ok: boolean;
-    reason: "not_found" | "not_running" | "missing_target" | null;
-    activity: ControlPlaneActivitySnapshot | null;
-};
-export type ControlPlaneActivitySupervisorOpts = {
-    nowMs?: () => number;
-    heartbeatScheduler?: ActivityHeartbeatScheduler;
-    defaultHeartbeatEveryMs?: number;
-    maxHistory?: number;
-    maxEventsPerActivity?: number;
-    onEvent?: (event: ControlPlaneActivityEvent) => void | Promise<void>;
-};
-export declare class ControlPlaneActivitySupervisor {
-    #private;
-    constructor(opts?: ControlPlaneActivitySupervisorOpts);
-    start(opts: {
-        title: string;
-        kind?: string;
-        heartbeatEveryMs?: number;
-        metadata?: Record<string, unknown>;
-        source?: "api" | "command" | "system";
-    }): ControlPlaneActivitySnapshot;
-    list(opts?: {
-        status?: ControlPlaneActivityStatus;
-        kind?: string;
-        limit?: number;
-    }): ControlPlaneActivitySnapshot[];
-    get(activityId: string): ControlPlaneActivitySnapshot | null;
-    events(activityId: string, opts?: {
-        limit?: number;
-    }): ControlPlaneActivityEvent[] | null;
-    progress(opts: {
-        activityId?: string | null;
-        message?: string | null;
-    }): ControlPlaneActivityMutationResult;
-    heartbeat(opts: {
-        activityId?: string | null;
-        reason?: string | null;
-    }): ControlPlaneActivityMutationResult;
-    complete(opts: {
-        activityId?: string | null;
-        message?: string | null;
-    }): ControlPlaneActivityMutationResult;
-    fail(opts: {
-        activityId?: string | null;
-        message?: string | null;
-    }): ControlPlaneActivityMutationResult;
-    cancel(opts: {
-        activityId?: string | null;
-        message?: string | null;
-    }): ControlPlaneActivityMutationResult;
-    stop(): void;
-}

package/dist/activity_supervisor.js

@@ -1,306 +0,0 @@
-import { ActivityHeartbeatScheduler } from "./heartbeat_scheduler.js";
-const DEFAULT_HEARTBEAT_EVERY_MS = 15_000;
-function defaultNowMs() {
-    return Date.now();
-}
-function normalizeKind(value) {
-    const trimmed = value?.trim();
-    if (!trimmed) {
-        return "generic";
-    }
-    return trimmed.toLowerCase();
-}
-function normalizeTitle(value) {
-    const trimmed = value.trim();
-    if (trimmed.length === 0) {
-        throw new Error("activity_title_required");
-    }
-    return trimmed;
-}
-function normalizeHeartbeatEveryMs(value, fallback) {
-    if (typeof value === "number" && Number.isFinite(value)) {
-        return Math.max(0, Math.trunc(value));
-    }
-    if (typeof value === "string" && /^\d+$/.test(value.trim())) {
-        return Math.max(0, Number.parseInt(value.trim(), 10));
-    }
-    return fallback;
-}
-function toSafeMetadata(value) {
-    if (!value || typeof value !== "object" || Array.isArray(value)) {
-        return {};
-    }
-    return { ...value };
-}
-function pushBounded(items, value, max) {
-    items.push(value);
-    if (items.length <= max) {
-        return;
-    }
-    items.splice(0, items.length - max);
-}
-function elapsedSeconds(snapshot, nowMs) {
-    return Math.max(0, Math.trunc((nowMs - snapshot.started_at_ms) / 1_000));
-}
-export class ControlPlaneActivitySupervisor {
-    #nowMs;
-    #heartbeatScheduler;
-    #ownsHeartbeatScheduler;
-    #defaultHeartbeatEveryMs;
-    #maxHistory;
-    #maxEventsPerActivity;
-    #onEvent;
-    #activities = new Map();
-    #seq = 0;
-    #counter = 0;
-    constructor(opts = {}) {
-        this.#nowMs = opts.nowMs ?? defaultNowMs;
-        this.#heartbeatScheduler = opts.heartbeatScheduler ?? new ActivityHeartbeatScheduler();
-        this.#ownsHeartbeatScheduler = !opts.heartbeatScheduler;
-        this.#defaultHeartbeatEveryMs = Math.max(0, Math.trunc(opts.defaultHeartbeatEveryMs ?? DEFAULT_HEARTBEAT_EVERY_MS));
-        this.#maxHistory = Math.max(20, Math.trunc(opts.maxHistory ?? 200));
-        this.#maxEventsPerActivity = Math.max(20, Math.trunc(opts.maxEventsPerActivity ?? 400));
-        this.#onEvent = opts.onEvent ?? null;
-    }
-    #nextActivityId() {
-        this.#counter += 1;
-        return `activity-${this.#counter.toString(36)}-${crypto.randomUUID().slice(0, 8)}`;
-    }
-    #snapshot(activity) {
-        return {
-            ...activity.snapshot,
-            metadata: { ...activity.snapshot.metadata },
-        };
-    }
-    #touch(activity) {
-        activity.snapshot.updated_at_ms = Math.trunc(this.#nowMs());
-    }
-    #emit(kind, activity, message) {
-        const event = {
-            seq: ++this.#seq,
-            ts_ms: Math.trunc(this.#nowMs()),
-            kind,
-            message,
-            activity: this.#snapshot(activity),
-        };
-        pushBounded(activity.events, event, this.#maxEventsPerActivity);
-        if (!this.#onEvent) {
-            return;
-        }
-        void Promise.resolve(this.#onEvent(event)).catch(() => {
-            // Do not crash on notifier failures.
-        });
-    }
-    #pruneHistory() {
-        const rows = [...this.#activities.values()].sort((a, b) => {
-            if (a.snapshot.started_at_ms !== b.snapshot.started_at_ms) {
-                return b.snapshot.started_at_ms - a.snapshot.started_at_ms;
-            }
-            return a.snapshot.activity_id.localeCompare(b.snapshot.activity_id);
-        });
-        let kept = 0;
-        for (const row of rows) {
-            if (row.snapshot.status === "running") {
-                kept += 1;
-                continue;
-            }
-            kept += 1;
-            if (kept <= this.#maxHistory) {
-                continue;
-            }
-            this.#heartbeatScheduler.unregister(row.snapshot.activity_id);
-            this.#activities.delete(row.snapshot.activity_id);
-        }
-    }
-    #resolveActivity(activityIdRaw) {
-        const id = activityIdRaw?.trim() ?? "";
-        if (id.length === 0) {
-            return null;
-        }
-        return this.#activities.get(id) ?? null;
-    }
-    #heartbeatMessage(activity) {
-        const nowMs = Math.trunc(this.#nowMs());
-        const elapsed = elapsedSeconds(activity.snapshot, nowMs);
-        const progress = activity.snapshot.last_progress ? ` · ${activity.snapshot.last_progress}` : "";
-        return `⏱ ${activity.snapshot.title} running for ${elapsed}s${progress}`;
-    }
-    #emitHeartbeat(activity, reason) {
-        activity.snapshot.heartbeat_count += 1;
-        activity.snapshot.last_heartbeat_at_ms = Math.trunc(this.#nowMs());
-        activity.snapshot.last_heartbeat_reason = reason?.trim() || "requested";
-        this.#touch(activity);
-        this.#emit("activity_heartbeat", activity, this.#heartbeatMessage(activity));
-    }
-    #registerHeartbeat(activity) {
-        if (activity.snapshot.heartbeat_every_ms <= 0) {
-            return;
-        }
-        this.#heartbeatScheduler.register({
-            activityId: activity.snapshot.activity_id,
-            everyMs: activity.snapshot.heartbeat_every_ms,
-            handler: async ({ reason }) => {
-                if (activity.snapshot.status !== "running") {
-                    return { status: "skipped", reason: "not_running" };
-                }
-                this.#emitHeartbeat(activity, reason);
-                return { status: "ran" };
-            },
-        });
-    }
-    start(opts) {
-        const nowMs = Math.trunc(this.#nowMs());
-        const snapshot = {
-            activity_id: this.#nextActivityId(),
-            kind: normalizeKind(opts.kind),
-            title: normalizeTitle(opts.title),
-            status: "running",
-            heartbeat_every_ms: normalizeHeartbeatEveryMs(opts.heartbeatEveryMs, this.#defaultHeartbeatEveryMs),
-            heartbeat_count: 0,
-            last_heartbeat_at_ms: null,
-            last_heartbeat_reason: null,
-            last_progress: null,
-            final_message: null,
-            metadata: toSafeMetadata(opts.metadata),
-            source: opts.source ?? "api",
-            started_at_ms: nowMs,
-            updated_at_ms: nowMs,
-            finished_at_ms: null,
-        };
-        const activity = {
-            snapshot,
-            events: [],
-        };
-        this.#activities.set(snapshot.activity_id, activity);
-        this.#registerHeartbeat(activity);
-        this.#emit("activity_started", activity, `🚀 Started activity ${snapshot.title} (${snapshot.activity_id}).`);
-        return this.#snapshot(activity);
-    }
-    list(opts = {}) {
-        const limit = Math.max(1, Math.min(500, Math.trunc(opts.limit ?? 100)));
-        const kind = opts.kind?.trim().toLowerCase() || null;
-        return [...this.#activities.values()]
-            .filter((activity) => {
-            if (opts.status && activity.snapshot.status !== opts.status) {
-                return false;
-            }
-            if (kind && activity.snapshot.kind !== kind) {
-                return false;
-            }
-            return true;
-        })
-            .sort((a, b) => {
-            if (a.snapshot.started_at_ms !== b.snapshot.started_at_ms) {
-                return b.snapshot.started_at_ms - a.snapshot.started_at_ms;
-            }
-            return a.snapshot.activity_id.localeCompare(b.snapshot.activity_id);
-        })
-            .slice(0, limit)
-            .map((activity) => this.#snapshot(activity));
-    }
-    get(activityId) {
-        const activity = this.#resolveActivity(activityId);
-        return activity ? this.#snapshot(activity) : null;
-    }
-    events(activityId, opts = {}) {
-        const activity = this.#resolveActivity(activityId);
-        if (!activity) {
-            return null;
-        }
-        const limit = Math.max(1, Math.min(2_000, Math.trunc(opts.limit ?? 200)));
-        return activity.events.slice(-limit).map((event) => ({
-            ...event,
-            activity: {
-                ...event.activity,
-                metadata: { ...event.activity.metadata },
-            },
-        }));
-    }
-    progress(opts) {
-        const activity = this.#resolveActivity(opts.activityId);
-        if (!opts.activityId?.trim()) {
-            return { ok: false, reason: "missing_target", activity: null };
-        }
-        if (!activity) {
-            return { ok: false, reason: "not_found", activity: null };
-        }
-        if (activity.snapshot.status !== "running") {
-            return { ok: false, reason: "not_running", activity: this.#snapshot(activity) };
-        }
-        const message = opts.message?.trim() || "progress updated";
-        activity.snapshot.last_progress = message;
-        this.#touch(activity);
-        this.#emit("activity_progress", activity, `📈 ${message}`);
-        return { ok: true, reason: null, activity: this.#snapshot(activity) };
-    }
-    heartbeat(opts) {
-        const activityId = opts.activityId?.trim() || "";
-        if (activityId.length === 0) {
-            return { ok: false, reason: "missing_target", activity: null };
-        }
-        const activity = this.#activities.get(activityId) ?? null;
-        if (!activity) {
-            return { ok: false, reason: "not_found", activity: null };
-        }
-        if (activity.snapshot.status !== "running") {
-            return { ok: false, reason: "not_running", activity: this.#snapshot(activity) };
-        }
-        const reason = opts.reason?.trim() || "manual";
-        if (this.#heartbeatScheduler.has(activityId)) {
-            this.#heartbeatScheduler.requestNow(activityId, { reason, coalesceMs: 0 });
-        }
-        else {
-            this.#emitHeartbeat(activity, reason);
-        }
-        return { ok: true, reason: null, activity: this.#snapshot(activity) };
-    }
-    #finish(opts) {
-        const activityId = opts.activityId?.trim() || "";
-        if (activityId.length === 0) {
-            return { ok: false, reason: "missing_target", activity: null };
-        }
-        const activity = this.#activities.get(activityId) ?? null;
-        if (!activity) {
-            return { ok: false, reason: "not_found", activity: null };
-        }
-        if (activity.snapshot.status !== "running") {
-            return { ok: false, reason: "not_running", activity: this.#snapshot(activity) };
-        }
-        activity.snapshot.status = opts.status;
-        activity.snapshot.final_message = opts.message?.trim() || null;
-        activity.snapshot.finished_at_ms = Math.trunc(this.#nowMs());
-        activity.snapshot.updated_at_ms = activity.snapshot.finished_at_ms;
-        this.#heartbeatScheduler.unregister(activity.snapshot.activity_id);
-        switch (opts.status) {
-            case "completed":
-                this.#emit("activity_completed", activity, `✅ Activity completed: ${activity.snapshot.title}${activity.snapshot.final_message ? ` · ${activity.snapshot.final_message}` : ""}`);
-                break;
-            case "failed":
-                this.#emit("activity_failed", activity, `❌ Activity failed: ${activity.snapshot.title}${activity.snapshot.final_message ? ` · ${activity.snapshot.final_message}` : ""}`);
-                break;
-            case "cancelled":
-                this.#emit("activity_cancelled", activity, `🛑 Activity cancelled: ${activity.snapshot.title}${activity.snapshot.final_message ? ` · ${activity.snapshot.final_message}` : ""}`);
-                break;
-        }
-        this.#pruneHistory();
-        return { ok: true, reason: null, activity: this.#snapshot(activity) };
-    }
-    complete(opts) {
-        return this.#finish({ ...opts, status: "completed" });
-    }
-    fail(opts) {
-        return this.#finish({ ...opts, status: "failed" });
-    }
-    cancel(opts) {
-        return this.#finish({ ...opts, status: "cancelled" });
-    }
-    stop() {
-        for (const activity of this.#activities.values()) {
-            this.#heartbeatScheduler.unregister(activity.snapshot.activity_id);
-        }
-        if (this.#ownsHeartbeatScheduler) {
-            this.#heartbeatScheduler.stop();
-        }
-        this.#activities.clear();
-    }
-}

package/dist/api/activities.d.ts

@@ -1,2 +0,0 @@
-import type { ServerRoutingDependencies } from "../server_routing.js";
-export declare function activityRoutes(request: Request, url: URL, deps: ServerRoutingDependencies, headers: Headers): Promise<Response>;

package/dist/api/activities.js

@@ -1,160 +0,0 @@
-export async function activityRoutes(request, url, deps, headers) {
-    const path = url.pathname;
-    if (path === "/api/activities") {
-        if (request.method !== "GET") {
-            return Response.json({ error: "Method Not Allowed" }, { status: 405, headers });
-        }
-        const statusRaw = url.searchParams.get("status")?.trim().toLowerCase();
-        const status = statusRaw === "running" || statusRaw === "completed" || statusRaw === "failed" || statusRaw === "cancelled"
-            ? statusRaw
-            : undefined;
-        const kind = url.searchParams.get("kind")?.trim() || undefined;
-        const limitRaw = url.searchParams.get("limit");
-        const limit = limitRaw && /^\d+$/.test(limitRaw) ? Math.max(1, Math.min(500, Number.parseInt(limitRaw, 10))) : undefined;
-        const activities = deps.activitySupervisor.list({ status, kind, limit });
-        return Response.json({ count: activities.length, activities }, { headers });
-    }
-    if (path === "/api/activities/start") {
-        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 title = typeof body.title === "string" ? body.title.trim() : "";
-        if (!title) {
-            return Response.json({ error: "title is required" }, { status: 400, headers });
-        }
-        const kind = typeof body.kind === "string" ? body.kind.trim() : undefined;
-        const heartbeatEveryMs = typeof body.heartbeat_every_ms === "number" && Number.isFinite(body.heartbeat_every_ms)
-            ? Math.max(0, Math.trunc(body.heartbeat_every_ms))
-            : undefined;
-        const source = body.source === "api" || body.source === "command" || body.source === "system" ? body.source : "api";
-        try {
-            const activity = deps.activitySupervisor.start({
-                title,
-                kind,
-                heartbeatEveryMs,
-                metadata: body.metadata ?? undefined,
-                source,
-            });
-            return Response.json({ ok: true, activity }, { status: 201, headers });
-        }
-        catch (err) {
-            return Response.json({ error: deps.describeError(err) }, { status: 400, headers });
-        }
-    }
-    if (path === "/api/activities/progress") {
-        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 result = deps.activitySupervisor.progress({
-            activityId: typeof body.activity_id === "string" ? body.activity_id : null,
-            message: typeof body.message === "string" ? body.message : null,
-        });
-        if (result.ok) {
-            return Response.json(result, { headers });
-        }
-        if (result.reason === "missing_target") {
-            return Response.json(result, { status: 400, headers });
-        }
-        if (result.reason === "not_running") {
-            return Response.json(result, { status: 409, headers });
-        }
-        return Response.json(result, { status: 404, headers });
-    }
-    if (path === "/api/activities/heartbeat") {
-        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 result = deps.activitySupervisor.heartbeat({
-            activityId: typeof body.activity_id === "string" ? body.activity_id : null,
-            reason: typeof body.reason === "string" ? body.reason : null,
-        });
-        if (result.ok) {
-            return Response.json(result, { headers });
-        }
-        if (result.reason === "missing_target") {
-            return Response.json(result, { status: 400, headers });
-        }
-        if (result.reason === "not_running") {
-            return Response.json(result, { status: 409, headers });
-        }
-        return Response.json(result, { status: 404, headers });
-    }
-    if (path === "/api/activities/complete" || path === "/api/activities/fail" || path === "/api/activities/cancel") {
-        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 activityId = typeof body.activity_id === "string" ? body.activity_id : null;
-        const message = typeof body.message === "string" ? body.message : null;
-        const result = path === "/api/activities/complete"
-            ? deps.activitySupervisor.complete({ activityId, message })
-            : path === "/api/activities/fail"
-                ? deps.activitySupervisor.fail({ activityId, message })
-                : deps.activitySupervisor.cancel({ activityId, message });
-        if (result.ok) {
-            return Response.json(result, { headers });
-        }
-        if (result.reason === "missing_target") {
-            return Response.json(result, { status: 400, headers });
-        }
-        if (result.reason === "not_running") {
-            return Response.json(result, { status: 409, headers });
-        }
-        return Response.json(result, { status: 404, headers });
-    }
-    if (path.startsWith("/api/activities/")) {
-        if (request.method !== "GET") {
-            return Response.json({ error: "Method Not Allowed" }, { status: 405, headers });
-        }
-        const rest = path.slice("/api/activities/".length);
-        const [rawId, maybeSub] = rest.split("/");
-        const activityId = decodeURIComponent(rawId ?? "").trim();
-        if (activityId.length === 0) {
-            return Response.json({ error: "missing activity id" }, { status: 400, headers });
-        }
-        if (maybeSub === "events") {
-            const limitRaw = url.searchParams.get("limit");
-            const limit = limitRaw && /^\d+$/.test(limitRaw)
-                ? Math.max(1, Math.min(2_000, Number.parseInt(limitRaw, 10)))
-                : undefined;
-            const events = deps.activitySupervisor.events(activityId, { limit });
-            if (!events) {
-                return Response.json({ error: "activity not found" }, { status: 404, headers });
-            }
-            return Response.json({ count: events.length, events }, { headers });
-        }
-        const activity = deps.activitySupervisor.get(activityId);
-        if (!activity) {
-            return Response.json({ error: "activity not found" }, { status: 404, headers });
-        }
-        return Response.json(activity, { headers });
-    }
-    return Response.json({ error: "Not Found" }, { status: 404, headers });
-}

package/dist/api/session_flash.d.ts

@@ -1,60 +0,0 @@
-import type { ServerRoutingDependencies } from "../server_routing.js";
-export type SessionFlashStatus = "pending" | "delivered";
-export type SessionFlashRecord = {
-    flash_id: string;
-    created_at_ms: number;
-    session_id: string;
-    session_kind: string | null;
-    body: string;
-    context_ids: string[];
-    source: string | null;
-    metadata: Record<string, unknown>;
-    from: {
-        channel: string | null;
-        channel_tenant_id: string | null;
-        channel_conversation_id: string | null;
-        actor_binding_id: string | null;
-    };
-    status: SessionFlashStatus;
-    delivered_at_ms: number | null;
-    delivered_by: string | null;
-    delivery_note: string | null;
-};
-export declare function getSessionFlashPath(repoRoot: string): string;
-export declare function listSessionFlashRecords(opts: {
-    repoRoot: string;
-    sessionId?: string | null;
-    sessionKind?: string | null;
-    status?: SessionFlashStatus | "all";
-    contains?: string | null;
-    limit?: number;
-}): Promise<SessionFlashRecord[]>;
-export declare function getSessionFlashRecord(opts: {
-    repoRoot: string;
-    flashId: string;
-}): Promise<SessionFlashRecord | null>;
-export declare function createSessionFlashRecord(opts: {
-    repoRoot: string;
-    sessionId: string;
-    body: string;
-    sessionKind?: string | null;
-    contextIds?: string[];
-    source?: string | null;
-    metadata?: Record<string, unknown>;
-    from?: {
-        channel?: string | null;
-        channel_tenant_id?: string | null;
-        channel_conversation_id?: string | null;
-        actor_binding_id?: string | null;
-    };
-    nowMs?: number;
-}): Promise<SessionFlashRecord>;
-export declare function ackSessionFlashRecord(opts: {
-    repoRoot: string;
-    flashId: string;
-    sessionId?: string | null;
-    deliveredBy?: string | null;
-    note?: string | null;
-    nowMs?: number;
-}): Promise<SessionFlashRecord | null>;
-export declare function sessionFlashRoutes(request: Request, url: URL, deps: ServerRoutingDependencies, headers: Headers): Promise<Response>;