@femtomc/mu-agent 26.2.55 → 26.2.56

package/dist/extensions/messaging-setup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"messaging-setup.d.ts","sourceRoot":"","sources":["../../src/extensions/messaging-setup.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,YAAY,EAA6C,MAAM,+BAA+B,CAAC;AAyiC7G,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,YAAY,QA0PvD;AAED,eAAe,uBAAuB,CAAC"}
+{"version":3,"file":"messaging-setup.d.ts","sourceRoot":"","sources":["../../src/extensions/messaging-setup.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,YAAY,EAA6C,MAAM,+BAA+B,CAAC;AAwpC7G,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,YAAY,QAwPvD;AAED,eAAe,uBAAuB,CAAC"}

package/dist/extensions/messaging-setup.js

@@ -452,6 +452,62 @@ function planText(plan) {
 function planSummary(plans) {
     return plans.map((plan) => planText(plan)).join("\n\n");
 }
+function isRecord(value) {
+    return typeof value === "object" && value !== null;
+}
+function isControlPlaneGenerationIdentity(value) {
+    if (!isRecord(value))
+        return false;
+    return typeof value.generation_id === "string" && typeof value.generation_seq === "number";
+}
+function isControlPlaneReloadGenerationSummary(value) {
+    if (!isRecord(value))
+        return false;
+    if (typeof value.attempt_id !== "string")
+        return false;
+    if (typeof value.coalesced !== "boolean")
+        return false;
+    if (value.from_generation !== null && !isControlPlaneGenerationIdentity(value.from_generation))
+        return false;
+    if (!isControlPlaneGenerationIdentity(value.to_generation))
+        return false;
+    if (value.active_generation !== null && !isControlPlaneGenerationIdentity(value.active_generation))
+        return false;
+    return value.outcome === "success" || value.outcome === "failure";
+}
+function parseControlPlaneReloadApiResponse(raw) {
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        return {
+            response: null,
+            error: "control-plane reload returned invalid JSON response",
+        };
+    }
+    if (!isRecord(parsed)) {
+        return {
+            response: null,
+            error: "control-plane reload returned non-object payload",
+        };
+    }
+    if (!isControlPlaneReloadGenerationSummary(parsed.generation)) {
+        return {
+            response: null,
+            error: "control-plane reload response missing generation metadata (expected generation-scoped contract)",
+        };
+    }
+    const parsedRecord = parsed;
+    const response = {
+        ...parsed,
+        telegram_generation: parsedRecord.telegram_generation ?? null,
+    };
+    return {
+        response,
+        error: null,
+    };
+}
 async function reloadControlPlaneInProcess(reason) {
     const base = muServerUrl();
     if (!base) {
@@ -468,18 +524,27 @@ async function reloadControlPlaneInProcess(reason) {
             body: JSON.stringify({ reason }),
         });
         const raw = await response.text();
-        let parsed = null;
-        try {
-            parsed = JSON.parse(raw);
+        const parsedResult = parseControlPlaneReloadApiResponse(raw);
+        const parsed = parsedResult.response;
+        if (parsedResult.error) {
+            return {
+                ok: false,
+                response: null,
+                error: parsedResult.error,
+            };
         }
-        catch {
-            parsed = null;
+        if (!parsed) {
+            return {
+                ok: false,
+                response: null,
+                error: "control-plane reload response missing payload",
+            };
         }
-        if (!response.ok || !parsed?.ok) {
+        if (!response.ok || !parsed.ok) {
             return {
                 ok: false,
                 response: parsed,
-                error: parsed?.error ?? `control-plane reload failed (${response.status})`,
+                error: parsed.error ?? `control-plane reload failed (${response.status})`,
             };
         }
         return {
@@ -496,6 +561,22 @@ async function reloadControlPlaneInProcess(reason) {
         };
     }
 }
+function reloadOutcomeSummary(reload) {
+    if (!reload.ok) {
+        return `Control-plane reload failed: ${reload.error ?? "unknown error"}.`;
+    }
+    const response = reload.response;
+    if (!response) {
+        return "Control-plane reload failed: missing reload response payload.";
+    }
+    const adapters = response.control_plane?.adapters.join(", ") || "(none)";
+    const generationSummary = `${response.generation.outcome} (${response.generation.active_generation?.generation_id ?? response.generation.to_generation.generation_id})`;
+    const telegramRollbackTrigger = response.telegram_generation?.rollback.trigger;
+    const telegramNote = response.telegram_generation?.handled && telegramRollbackTrigger
+        ? ` rollback_trigger=${telegramRollbackTrigger}`
+        : "";
+    return `Control-plane reloaded in-process. Active adapters: ${adapters}. Generation: ${generationSummary}.${telegramNote}`;
+}
 function patchForAdapterValues(adapterId, values) {
     switch (adapterId) {
         case "slack":
@@ -846,9 +927,7 @@ async function runInteractiveApply(ctx, adapterId) {
     const lines = [
         `Updated config fields: ${outcome.updated_fields.join(", ") || "(none)"}`,
         `Config path: ${outcome.config_path ?? runtime.configPath ?? "(unknown)"}`,
-        outcome.reload.ok
-            ? `Control-plane reloaded in-process. Active adapters: ${outcome.reload.response?.control_plane?.adapters.join(", ") || "(none)"}.`
-            : `Control-plane reload failed: ${outcome.reload.error ?? "unknown error"}.`,
+        reloadOutcomeSummary(outcome.reload),
         "",
         verifyText(verify),
     ];
@@ -959,9 +1038,7 @@ export function messagingSetupExtension(pi) {
                     const lines = [
                         `Updated config fields: ${outcome.updated_fields.join(", ") || "(none)"}`,
                         `Config path: ${outcome.config_path ?? runtime.configPath ?? "(unknown)"}`,
-                        outcome.reload.ok
-                            ? `Control-plane reloaded in-process. Active adapters: ${outcome.reload.response?.control_plane?.adapters.join(", ") || "(none)"}.`
-                            : `Control-plane reload failed: ${outcome.reload.error ?? "unknown error"}.`,
+                        reloadOutcomeSummary(outcome.reload),
                         "",
                         verifyText(verify),
                     ];

package/dist/extensions/server-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server-tools.d.ts","sourceRoot":"","sources":["../../src/extensions/server-tools.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAgElE,MAAM,MAAM,wBAAwB,GAAG;IACtC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,sBAAsB,CAAC,EAAE,MAAM,EAAE,CAAC;CAClC,CAAC;AAoXF,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,YAAY,EAAE,IAAI,GAAE,wBAA6B,QAQzF;AAED,wBAAgB,4BAA4B,CAAC,EAAE,EAAE,YAAY,QAS5D;AAED,eAAe,oBAAoB,CAAC"}
+{"version":3,"file":"server-tools.d.ts","sourceRoot":"","sources":["../../src/extensions/server-tools.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAoFlE,MAAM,MAAM,wBAAwB,GAAG;IACtC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,sBAAsB,CAAC,EAAE,MAAM,EAAE,CAAC;CAClC,CAAC;AAuXF,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,YAAY,EAAE,IAAI,GAAE,wBAA6B,QAQzF;AAED,wBAAgB,4BAA4B,CAAC,EAAE,EAAE,YAAY,QAS5D;AAED,eAAe,oBAAoB,CAAC"}

package/dist/extensions/server-tools.js

@@ -21,17 +21,33 @@ function cpRoutesFromStatus(routes, adapters) {
         route: `/webhooks/${name}`,
     }));
 }
+function generationSummary(generation) {
+    const active = generation.active_generation?.generation_id ?? "(none)";
+    const pending = generation.pending_reload
+        ? `${generation.pending_reload.attempt_id}:${generation.pending_reload.state}`
+        : "(none)";
+    const last = generation.last_reload
+        ? `${generation.last_reload.attempt_id}:${generation.last_reload.state}`
+        : "(none)";
+    return `generation: active=${active} pending=${pending} last=${last}`;
+}
+function observabilitySummary(counters) {
+    return `observability: reload_success=${counters.reload_success_total} reload_failure=${counters.reload_failure_total} duplicate=${counters.duplicate_signal_total} drop=${counters.drop_signal_total}`;
+}
 function summarizeStatus(status) {
-    const cp = status.control_plane ?? { active: false, adapters: [], routes: [] };
+    const cp = status.control_plane;
     const routes = cpRoutesFromStatus(cp.routes, cp.adapters);
     const routeText = routes.length > 0 ? routes.map((entry) => `${entry.name}:${entry.route}`).join(", ") : "(none)";
-    return [
+    const lines = [
         `repo: ${status.repo_root}`,
         `issues: open=${status.open_count} ready=${status.ready_count}`,
         `control_plane: ${cp.active ? "active" : "inactive"}`,
         `adapters: ${cp.adapters.length > 0 ? cp.adapters.join(", ") : "(none)"}`,
         `routes: ${routeText}`,
-    ].join("\n");
+        generationSummary(cp.generation),
+        observabilitySummary(cp.observability.counters),
+    ];
+    return lines.join("\n");
 }
 function sliceWithLimit(items, limitRaw, fallback = 50) {
     const limit = clampInt(limitRaw, fallback, 1, 200);
@@ -68,7 +84,7 @@ function registerServerTools(pi, opts) {
         ctx.ui.setStatus("mu-server", ctx.ui.theme.fg("dim", `μ server ${url}`));
         try {
             const status = await fetchMuStatus(4_000);
-            ctx.ui.setStatus("mu-status", ctx.ui.theme.fg("dim", `open ${status.open_count} · ready ${status.ready_count} · cp ${status.control_plane?.active ? "on" : "off"}`));
+            ctx.ui.setStatus("mu-status", ctx.ui.theme.fg("dim", `open ${status.open_count} · ready ${status.ready_count} · cp ${status.control_plane.active ? "on" : "off"}`));
         }
         catch {
             ctx.ui.setStatus("mu-status", ctx.ui.theme.fg("warning", "μ status unavailable"));
@@ -96,19 +112,19 @@ function registerServerTools(pi, opts) {
         parameters: ControlPlaneParams,
         async execute(_toolCallId, params) {
             const status = await fetchMuStatus();
-            const cp = status.control_plane ?? {
-                active: false,
-                adapters: [],
-                routes: [],
-            };
+            const cp = status.control_plane;
             const routes = cpRoutesFromStatus(cp.routes, cp.adapters);
+            const generation = cp.generation;
+            const observability = cp.observability.counters;
             switch (params.action) {
                 case "status":
                     return textResult(toJsonText({
                         active: cp.active,
                         adapters: cp.adapters,
                         routes,
-                    }), { control_plane: cp, routes });
+                        generation,
+                        observability,
+                    }), { control_plane: cp, routes, generation, observability });
                 case "adapters":
                     return textResult(toJsonText(cp.adapters), { adapters: cp.adapters });
                 case "routes":
@@ -377,16 +393,14 @@ function registerServerTools(pi, opts) {
         handler: async (_args, ctx) => {
             try {
                 const status = await fetchMuStatus();
-                const cp = status.control_plane ?? {
-                    active: false,
-                    adapters: [],
-                    routes: [],
-                };
+                const cp = status.control_plane;
                 const routes = cpRoutesFromStatus(cp.routes, cp.adapters);
                 const lines = [
                     `control_plane: ${cp.active ? "active" : "inactive"}`,
                     `adapters: ${cp.adapters.length > 0 ? cp.adapters.join(", ") : "(none)"}`,
                     `routes: ${routes.length > 0 ? routes.map((entry) => `${entry.name}:${entry.route}`).join(", ") : "(none)"}`,
+                    generationSummary(cp.generation),
+                    observabilitySummary(cp.observability.counters),
                 ];
                 ctx.ui.notify(lines.join("\n"), "info");
             }

package/dist/extensions/shared.d.ts

@@ -2,15 +2,48 @@ export type MuControlPlaneRoute = {
     name: string;
     route: string;
 };
+export type MuGenerationIdentity = {
+    generation_id: string;
+    generation_seq: number;
+};
+export type MuGenerationReloadAttempt = {
+    attempt_id: string;
+    reason: string;
+    state: "planned" | "swapped" | "completed" | "failed";
+    requested_at_ms: number;
+    swapped_at_ms: number | null;
+    finished_at_ms: number | null;
+    from_generation: MuGenerationIdentity | null;
+    to_generation: MuGenerationIdentity;
+};
+export type MuGenerationSupervisorSnapshot = {
+    supervisor_id: string;
+    active_generation: MuGenerationIdentity | null;
+    pending_reload: MuGenerationReloadAttempt | null;
+    last_reload: MuGenerationReloadAttempt | null;
+};
+export type MuGenerationObservabilityCounters = {
+    reload_success_total: number;
+    reload_failure_total: number;
+    reload_drain_duration_ms_total: number;
+    reload_drain_duration_samples_total: number;
+    duplicate_signal_total: number;
+    drop_signal_total: number;
+};
+export type MuControlPlaneStatus = {
+    active: boolean;
+    adapters: string[];
+    routes?: MuControlPlaneRoute[];
+    generation: MuGenerationSupervisorSnapshot;
+    observability: {
+        counters: MuGenerationObservabilityCounters;
+    };
+};
 export type MuStatusResponse = {
     repo_root: string;
     open_count: number;
     ready_count: number;
-    control_plane?: {
-        active: boolean;
-        adapters: string[];
-        routes?: MuControlPlaneRoute[];
-    };
+    control_plane: MuControlPlaneStatus;
 };
 export declare function muServerUrl(): string | null;
 export declare function clampInt(value: number | undefined, fallback: number, min: number, max: number): number;

package/dist/extensions/shared.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/extensions/shared.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,mBAAmB,GAAG;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE;QACf,MAAM,EAAE,OAAO,CAAC;QAChB,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,MAAM,CAAC,EAAE,mBAAmB,EAAE,CAAC;KAC/B,CAAC;CACF,CAAC;AAEF,wBAAgB,WAAW,IAAI,MAAM,GAAG,IAAI,CAG3C;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAKtG;AAED,wBAAsB,WAAW,CAAC,CAAC,EAClC,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAO,GAChE,OAAO,CAAC,CAAC,CAAC,CA4BZ;AAED,wBAAsB,aAAa,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAEjF;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;;;;;;EAK7E;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEjD"}
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/extensions/shared.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,mBAAmB,GAAG;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IAClC,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;IACtD,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,eAAe,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAC7C,aAAa,EAAE,oBAAoB,CAAC;CACpC,CAAC;AAEF,MAAM,MAAM,8BAA8B,GAAG;IAC5C,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAC/C,cAAc,EAAE,yBAAyB,GAAG,IAAI,CAAC;IACjD,WAAW,EAAE,yBAAyB,GAAG,IAAI,CAAC;CAC9C,CAAC;AAEF,MAAM,MAAM,iCAAiC,GAAG;IAC/C,oBAAoB,EAAE,MAAM,CAAC;IAC7B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,8BAA8B,EAAE,MAAM,CAAC;IACvC,mCAAmC,EAAE,MAAM,CAAC;IAC5C,sBAAsB,EAAE,MAAM,CAAC;IAC/B,iBAAiB,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IAClC,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAC/B,UAAU,EAAE,8BAA8B,CAAC;IAC3C,aAAa,EAAE;QACd,QAAQ,EAAE,iCAAiC,CAAC;KAC5C,CAAC;CACF,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,oBAAoB,CAAC;CACpC,CAAC;AAEF,wBAAgB,WAAW,IAAI,MAAM,GAAG,IAAI,CAG3C;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAKtG;AAED,wBAAsB,WAAW,CAAC,CAAC,EAClC,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAO,GAChE,OAAO,CAAC,CAAC,CAAC,CA4BZ;AAiCD,wBAAsB,aAAa,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAGjF;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;;;;;;EAK7E;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEjD"}

package/dist/extensions/shared.js

@@ -39,8 +39,30 @@ export async function fetchMuJson(path, opts = {}) {
         clearTimeout(timeout);
     }
 }
+function ensureGenerationScopedStatus(status) {
+    const controlPlane = status.control_plane;
+    if (!controlPlane || typeof controlPlane !== "object") {
+        throw new Error("mu server /api/status missing control_plane payload (expected generation-scoped contract)");
+    }
+    const controlPlaneRecord = controlPlane;
+    if (!("generation" in controlPlaneRecord) || !controlPlaneRecord.generation) {
+        throw new Error("mu server /api/status missing control_plane.generation (expected generation-scoped contract)");
+    }
+    if (!("observability" in controlPlaneRecord) || !controlPlaneRecord.observability) {
+        throw new Error("mu server /api/status missing control_plane.observability (expected generation-scoped contract)");
+    }
+    const observability = controlPlaneRecord.observability;
+    if (typeof observability !== "object" ||
+        observability == null ||
+        !("counters" in observability) ||
+        !observability.counters) {
+        throw new Error("mu server /api/status missing control_plane.observability.counters (expected generation-scoped contract)");
+    }
+    return status;
+}
 export async function fetchMuStatus(timeoutMs) {
-    return await fetchMuJson("/api/status", { timeoutMs });
+    const status = await fetchMuJson("/api/status", { timeoutMs });
+    return ensureGenerationScopedStatus(status);
 }
 export function textResult(text, details = {}) {
     return {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@femtomc/mu-agent",
-	"version": "26.2.55",
+	"version": "26.2.56",
 	"description": "Shared agent runtime for mu chat, orchestration roles, and serve extensions.",
 	"keywords": [
 		"mu",