@femtomc/mu-agent 26.2.70 → 26.2.71

package/README.md

@@ -81,7 +81,7 @@ Default operator UI theme is `mu-gruvbox-dark`.
   - `action`: `tail | query`
 - `mu_messaging_setup({ action, adapter?, public_base_url? })`
   - `action`: `check | preflight | guide | plan | apply | verify`
-  - `adapter`: `slack | discord | telegram | gmail`
+  - `adapter`: `slack | discord | telegram`
 
 ### Query contract (context-safe by default)
 
@@ -104,6 +104,5 @@ kept compact to reduce context pollution.
 
 - Runtime setup state comes from `GET /api/config` and `.mu/config.json`.
 - `slack`, `discord`, `telegram` are currently modeled as available adapters.
-- `gmail` is modeled as planned guidance (not mounted by runtime yet).
 - `mu_messaging_setup(action=preflight)` is the quickest health check during
   onboarding.

package/dist/backend.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"backend.d.ts","sourceRoot":"","sources":["../src/backend.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAEjD,OAAO,EACN,WAAW,EAOX,qBAAqB,EAErB,eAAe,EACf,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAI5C,MAAM,MAAM,cAAc,GAAG;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,WAAW,aAAa;IAC7B,GAAG,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC3C;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CA4BpD;AAGD;;;;;GAKG;AACH,wBAAgB,YAAY,CAC3B,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,WAAW,EACxB,kBAAkB,CAAC,EAAE,MAAM,GACzB,KAAK,CAAC,GAAG,CAAC,GAAG,SAAS,CA6BxB;AAED;;;;GAIG;AACH,qBAAa,UAAW,YAAW,aAAa;IACzC,GAAG,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC;CAmGhD;AAGD,MAAM,MAAM,0BAA0B,GAAG;IACxC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,wBAAwB,CAAC,EAAE,MAAM,EAAE,CAAC;IACpC,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;CAChC,CAAC;AAEF,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,0BAA0B,GAAG,qBAAqB,CA6B9F"}
+{"version":3,"file":"backend.d.ts","sourceRoot":"","sources":["../src/backend.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAEjD,OAAO,EACN,WAAW,EAOX,qBAAqB,EAErB,eAAe,EACf,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAI5C,MAAM,MAAM,cAAc,GAAG;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,WAAW,aAAa;IAC7B,GAAG,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC3C;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CA4BpD;AAGD;;;;;GAKG;AACH,wBAAgB,YAAY,CAC3B,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,WAAW,EACxB,kBAAkB,CAAC,EAAE,MAAM,GACzB,KAAK,CAAC,GAAG,CAAC,GAAG,SAAS,CA6BxB;AAED;;;;GAIG;AACH,qBAAa,UAAW,YAAW,aAAa;IACzC,GAAG,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC;CAoGhD;AAGD,MAAM,MAAM,0BAA0B,GAAG;IACxC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,wBAAwB,CAAC,EAAE,MAAM,EAAE,CAAC;IACpC,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;CAChC,CAAC;AAEF,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,0BAA0B,GAAG,qBAAqB,CA6B9F"}

package/dist/backend.js

@@ -78,7 +78,7 @@ export class SdkBackend {
             throw new Error(`Model "${opts.model}" not found${scope} in pi-ai registry.`);
         }
         const settingsManager = SettingsManager.inMemory({ theme: MU_DEFAULT_THEME_NAME, quietStartup: true });
-        const roleExtensionPaths = opts.role === "worker" ? workerToolExtensionPaths : orchestratorToolExtensionPaths;
+        const roleExtensionPaths = opts.role === "orchestrator" ? orchestratorToolExtensionPaths : workerToolExtensionPaths;
         const resourceLoader = createMuResourceLoader({
             cwd: opts.cwd,
             systemPrompt: opts.systemPrompt,

package/dist/default_prompts.d.ts

@@ -8,6 +8,7 @@ export declare function loadBundledPrompt(name: string): string;
 export declare function appendSharedSoul(basePrompt: string, soulPrompt: string): string;
 export declare const DEFAULT_SOUL_PROMPT: string;
 export declare const DEFAULT_ORCHESTRATOR_PROMPT: string;
+export declare const DEFAULT_REVIEWER_PROMPT: string;
 export declare const DEFAULT_WORKER_PROMPT: string;
 export declare const DEFAULT_OPERATOR_SYSTEM_PROMPT: string;
 //# sourceMappingURL=default_prompts.d.ts.map

package/dist/default_prompts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"default_prompts.d.ts","sourceRoot":"","sources":["../src/default_prompts.ts"],"names":[],"mappings":"AAUA;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAStD;AAED,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAO/E;AAED,eAAO,MAAM,mBAAmB,QAAqC,CAAC;AAMtE,eAAO,MAAM,2BAA2B,QAAkE,CAAC;AAC3G,eAAO,MAAM,qBAAqB,QAA4D,CAAC;AAC/F,eAAO,MAAM,8BAA8B,QAAqE,CAAC"}
+{"version":3,"file":"default_prompts.d.ts","sourceRoot":"","sources":["../src/default_prompts.ts"],"names":[],"mappings":"AAUA;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAStD;AAED,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAO/E;AAED,eAAO,MAAM,mBAAmB,QAAqC,CAAC;AAOtE,eAAO,MAAM,2BAA2B,QAAkE,CAAC;AAC3G,eAAO,MAAM,uBAAuB,QAA8D,CAAC;AACnG,eAAO,MAAM,qBAAqB,QAA4D,CAAC;AAC/F,eAAO,MAAM,8BAA8B,QAAqE,CAAC"}

package/dist/default_prompts.js

@@ -32,8 +32,10 @@ export function appendSharedSoul(basePrompt, soulPrompt) {
 }
 export const DEFAULT_SOUL_PROMPT = loadBundledPrompt("roles/soul.md");
 const BASE_ORCHESTRATOR_PROMPT = loadBundledPrompt("roles/orchestrator.md");
+const BASE_REVIEWER_PROMPT = loadBundledPrompt("roles/reviewer.md");
 const BASE_WORKER_PROMPT = loadBundledPrompt("roles/worker.md");
 const BASE_OPERATOR_SYSTEM_PROMPT = loadBundledPrompt("roles/operator.md");
 export const DEFAULT_ORCHESTRATOR_PROMPT = appendSharedSoul(BASE_ORCHESTRATOR_PROMPT, DEFAULT_SOUL_PROMPT);
+export const DEFAULT_REVIEWER_PROMPT = appendSharedSoul(BASE_REVIEWER_PROMPT, DEFAULT_SOUL_PROMPT);
 export const DEFAULT_WORKER_PROMPT = appendSharedSoul(BASE_WORKER_PROMPT, DEFAULT_SOUL_PROMPT);
 export const DEFAULT_OPERATOR_SYSTEM_PROMPT = appendSharedSoul(BASE_OPERATOR_SYSTEM_PROMPT, DEFAULT_SOUL_PROMPT);

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

@@ -0,0 +1,22 @@
+/**
+ * Config write/reload actions for mu-messaging-setup.
+ */
+import type { AdapterCheck, AdapterId, ApplyOutcome, ConfigPresence, ConfigWriteResponse, ControlPlaneReloadApiResponse, ControlPlaneReloadOutcome, VerifyOutcome } from "./types.js";
+export declare function parseControlPlaneReloadApiResponse(raw: string): {
+    response: ControlPlaneReloadApiResponse | null;
+    error: string | null;
+};
+export declare function reloadControlPlaneInProcess(reason: string): Promise<ControlPlaneReloadOutcome>;
+export declare function reloadOutcomeSummary(reload: ControlPlaneReloadOutcome): string;
+export declare function patchForAdapterValues(adapterId: AdapterId, values: Record<string, string>): Record<string, unknown>;
+export declare function writeConfigPatch(patch: Record<string, unknown>): Promise<ConfigWriteResponse>;
+export declare function applyAdapterConfig(opts: {
+    adapterId: AdapterId;
+    overrides?: Record<string, string>;
+    presence: ConfigPresence;
+}): Promise<ApplyOutcome>;
+export declare function buildVerifyOutcome(checks: AdapterCheck[], opts: {
+    adapterId?: AdapterId;
+    publicBaseUrl?: string;
+}): VerifyOutcome;
+//# sourceMappingURL=actions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../../src/extensions/messaging-setup/actions.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EACX,YAAY,EACZ,SAAS,EACT,YAAY,EACZ,cAAc,EACd,mBAAmB,EAEnB,6BAA6B,EAE7B,yBAAyB,EACzB,aAAa,EACb,MAAM,YAAY,CAAC;AAsBpB,wBAAgB,kCAAkC,CAAC,GAAG,EAAE,MAAM,GAAG;IAChE,QAAQ,EAAE,6BAA6B,GAAG,IAAI,CAAC;IAC/C,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB,CAmCA;AAED,wBAAsB,2BAA2B,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAwDpG;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,yBAAyB,GAAG,MAAM,CAiB9E;AAED,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAmCnH;AAED,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAMnG;AAED,wBAAsB,kBAAkB,CAAC,IAAI,EAAE;IAC9C,SAAS,EAAE,SAAS,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,QAAQ,EAAE,cAAc,CAAC;CACzB,GAAG,OAAO,CAAC,YAAY,CAAC,CAiDxB;AAED,wBAAgB,kBAAkB,CACjC,MAAM,EAAE,YAAY,EAAE,EACtB,IAAI,EAAE;IAAE,SAAS,CAAC,EAAE,SAAS,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,GACrD,aAAa,CASf"}

package/dist/extensions/messaging-setup/actions.js

@@ -0,0 +1,229 @@
+/**
+ * Config write/reload actions for mu-messaging-setup.
+ */
+import { adapterById, missingRequiredFields, normalizePublicBaseUrl } from "./adapters.js";
+import { resetChecksCache } from "./runtime.js";
+import { fetchMuJson, muServerUrl } from "../shared.js";
+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";
+}
+export 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,
+    };
+}
+export async function reloadControlPlaneInProcess(reason) {
+    const base = muServerUrl();
+    if (!base) {
+        return {
+            ok: false,
+            response: null,
+            error: "MU_SERVER_URL not set",
+        };
+    }
+    try {
+        const response = await fetch(`${base}/api/control-plane/reload`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({ reason }),
+        });
+        const raw = await response.text();
+        const parsedResult = parseControlPlaneReloadApiResponse(raw);
+        const parsed = parsedResult.response;
+        if (parsedResult.error) {
+            return {
+                ok: false,
+                response: null,
+                error: parsedResult.error,
+            };
+        }
+        if (!parsed) {
+            return {
+                ok: false,
+                response: null,
+                error: "control-plane reload response missing payload",
+            };
+        }
+        if (!response.ok || !parsed.ok) {
+            return {
+                ok: false,
+                response: parsed,
+                error: parsed.error ?? `control-plane reload failed (${response.status})`,
+            };
+        }
+        return {
+            ok: true,
+            response: parsed,
+            error: null,
+        };
+    }
+    catch (err) {
+        return {
+            ok: false,
+            response: null,
+            error: err instanceof Error ? err.message : String(err),
+        };
+    }
+}
+export 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}`;
+}
+export function patchForAdapterValues(adapterId, values) {
+    switch (adapterId) {
+        case "slack":
+            return {
+                control_plane: {
+                    adapters: {
+                        slack: {
+                            signing_secret: values.signing_secret ?? null,
+                        },
+                    },
+                },
+            };
+        case "discord":
+            return {
+                control_plane: {
+                    adapters: {
+                        discord: {
+                            signing_secret: values.signing_secret ?? null,
+                        },
+                    },
+                },
+            };
+        case "telegram":
+            return {
+                control_plane: {
+                    adapters: {
+                        telegram: {
+                            webhook_secret: values.webhook_secret ?? null,
+                            bot_token: values.bot_token ?? null,
+                            bot_username: values.bot_username ?? null,
+                        },
+                    },
+                },
+            };
+    }
+}
+export async function writeConfigPatch(patch) {
+    return await fetchMuJson("/api/config", {
+        method: "POST",
+        body: { patch },
+        timeoutMs: 6_000,
+    });
+}
+export async function applyAdapterConfig(opts) {
+    const adapter = adapterById(opts.adapterId);
+    if (adapter.support === "planned") {
+        return {
+            ok: false,
+            adapter: adapter.id,
+            reason: "adapter_planned",
+            missing_required_fields: adapter.fields.filter((field) => field.required).map((field) => field.key),
+        };
+    }
+    const missingRequired = missingRequiredFields(adapter, opts.presence);
+    const overrides = opts.overrides ?? {};
+    const unresolved = missingRequired.filter((field) => !(field in overrides));
+    if (unresolved.length > 0) {
+        return {
+            ok: false,
+            adapter: adapter.id,
+            reason: "missing_required_fields",
+            missing_required_fields: unresolved,
+        };
+    }
+    const patchValues = {};
+    for (const [key, value] of Object.entries(overrides)) {
+        const trimmed = value.trim();
+        if (trimmed.length > 0) {
+            patchValues[key] = trimmed;
+        }
+    }
+    let configPath = null;
+    const updatedFields = Object.keys(patchValues);
+    if (updatedFields.length > 0) {
+        const patch = patchForAdapterValues(adapter.id, patchValues);
+        const writeResult = await writeConfigPatch(patch);
+        configPath = writeResult.config_path;
+    }
+    resetChecksCache();
+    const reload = await reloadControlPlaneInProcess(`mu_setup_apply_${adapter.id}`);
+    return {
+        ok: true,
+        adapter: adapter.id,
+        updated_fields: updatedFields,
+        config_path: configPath,
+        reload,
+    };
+}
+export function buildVerifyOutcome(checks, opts) {
+    const targets = opts.adapterId ? checks.filter((check) => check.id === opts.adapterId) : checks;
+    const normalizedBase = normalizePublicBaseUrl(opts.publicBaseUrl);
+    const ok = targets.every((check) => check.state === "active");
+    return {
+        ok,
+        targets,
+        public_base_url: normalizedBase,
+    };
+}

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

@@ -0,0 +1,24 @@
+/**
+ * Adapter constants and lookup helpers for mu-messaging-setup.
+ */
+import type { AdapterCheck, AdapterConfig, AdapterId, ConfigPresence, SetupAction } from "./types.js";
+export declare const ADAPTERS: AdapterConfig[];
+export declare const SETUP_ACTIONS: readonly SetupAction[];
+export declare function isSetupAction(value: string): value is SetupAction;
+export declare function normalizeAdapterId(input: string): AdapterId | null;
+export declare function defaultRouteForAdapter(id: AdapterId): string;
+export declare function normalizePublicBaseUrl(input: string | undefined): string | null;
+export declare function adapterById(id: AdapterId): AdapterConfig;
+export declare function fieldPresent(presence: ConfigPresence, adapterId: AdapterId, key: string): boolean;
+export declare function missingRequiredFields(adapter: AdapterConfig, presence: ConfigPresence | null): string[];
+export declare function configured(adapter: AdapterConfig, presence: ConfigPresence | null): boolean;
+export declare function deriveState(opts: {
+    adapter: AdapterConfig;
+    configured: boolean;
+    active: boolean;
+}): AdapterCheck["state"];
+export declare function nextStepForState(opts: {
+    state: AdapterCheck["state"];
+    missing: string[];
+}): string;
+//# sourceMappingURL=adapters.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"adapters.d.ts","sourceRoot":"","sources":["../../../src/extensions/messaging-setup/adapters.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEtG,eAAO,MAAM,QAAQ,EAAE,aAAa,EAoEnC,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,SAAS,WAAW,EAOtC,CAAC;AAEX,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,WAAW,CAEjE;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAUlE;AAED,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,SAAS,GAAG,MAAM,CAE5D;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAc/E;AAED,wBAAgB,WAAW,CAAC,EAAE,EAAE,SAAS,GAAG,aAAa,CAMxD;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,cAAc,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAYjG;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,cAAc,GAAG,IAAI,GAAG,MAAM,EAAE,CAOvG;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,cAAc,GAAG,IAAI,GAAG,OAAO,CAE3F;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE;IACjC,OAAO,EAAE,aAAa,CAAC;IACvB,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,EAAE,OAAO,CAAC;CAChB,GAAG,YAAY,CAAC,OAAO,CAAC,CAKxB;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IAAE,KAAK,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,MAAM,CAWlG"}

package/dist/extensions/messaging-setup/adapters.js

@@ -0,0 +1,170 @@
+/**
+ * Adapter constants and lookup helpers for mu-messaging-setup.
+ */
+export const ADAPTERS = [
+    {
+        id: "slack",
+        name: "Slack",
+        support: "available",
+        fields: [
+            {
+                key: "signing_secret",
+                required: true,
+                description: "Slack Signing Secret used to validate inbound webhook signatures.",
+            },
+        ],
+        providerSetupSteps: [
+            "Create/open your Slack App (api.slack.com/apps).",
+            "Copy Signing Secret into .mu/config.json → control_plane.adapters.slack.signing_secret.",
+            "Create a Slash Command (e.g. /mu) with Request URL <public-base-url>/webhooks/slack.",
+            "Install/reinstall app after command changes.",
+            "Run /mu in Slack, then /mu setup verify slack.",
+        ],
+    },
+    {
+        id: "discord",
+        name: "Discord",
+        support: "available",
+        fields: [
+            {
+                key: "signing_secret",
+                required: true,
+                description: "Discord interaction public key for signature verification.",
+            },
+        ],
+        providerSetupSteps: [
+            "Create/open app in Discord Developer Portal.",
+            "Copy Interaction Public Key into .mu/config.json → control_plane.adapters.discord.signing_secret.",
+            "Set Interactions Endpoint URL to <public-base-url>/webhooks/discord.",
+            "Run a Discord command interaction, then /mu setup verify discord.",
+        ],
+    },
+    {
+        id: "telegram",
+        name: "Telegram",
+        support: "available",
+        fields: [
+            {
+                key: "webhook_secret",
+                required: true,
+                description: "Telegram webhook secret token.",
+            },
+            {
+                key: "bot_token",
+                required: true,
+                description: "Telegram bot token used for outbound replies.",
+            },
+            {
+                key: "bot_username",
+                required: false,
+                description: "Optional bot username used for mention normalization.",
+            },
+        ],
+        providerSetupSteps: [
+            "Create bot with @BotFather and place token in control_plane.adapters.telegram.bot_token.",
+            "Set control_plane.adapters.telegram.webhook_secret to a random secret string.",
+            "Call Telegram setWebhook using URL <public-base-url>/webhooks/telegram and matching secret_token.",
+            "Link your Telegram identity to control-plane policy (mu control link --channel telegram --actor-id <telegram-user-id> --tenant-id telegram-bot --role <viewer|contributor|operator>).",
+            "Optionally set control_plane.adapters.telegram.bot_username.",
+            "Send /mu in Telegram chat, then /mu setup verify telegram.",
+        ],
+    },
+];
+export const SETUP_ACTIONS = [
+    "check",
+    "preflight",
+    "guide",
+    "plan",
+    "apply",
+    "verify",
+];
+export function isSetupAction(value) {
+    return SETUP_ACTIONS.includes(value);
+}
+export function normalizeAdapterId(input) {
+    const normalized = input.trim().toLowerCase();
+    switch (normalized) {
+        case "slack":
+        case "discord":
+        case "telegram":
+            return normalized;
+        default:
+            return null;
+    }
+}
+export function defaultRouteForAdapter(id) {
+    return `/webhooks/${id}`;
+}
+export function normalizePublicBaseUrl(input) {
+    if (!input)
+        return null;
+    const trimmed = input.trim();
+    if (trimmed.length === 0)
+        return null;
+    try {
+        const url = new URL(trimmed);
+        if (url.protocol !== "http:" && url.protocol !== "https:") {
+            return null;
+        }
+        const normalized = `${url.protocol}//${url.host}${url.pathname.replace(/\/$/, "")}`;
+        return normalized.endsWith("/") ? normalized.slice(0, -1) : normalized;
+    }
+    catch {
+        return null;
+    }
+}
+export function adapterById(id) {
+    const found = ADAPTERS.find((adapter) => adapter.id === id);
+    if (!found) {
+        throw new Error(`Unknown adapter id: ${id}`);
+    }
+    return found;
+}
+export function fieldPresent(presence, adapterId, key) {
+    switch (adapterId) {
+        case "slack":
+            return key === "signing_secret" ? presence.control_plane.adapters.slack.signing_secret : false;
+        case "discord":
+            return key === "signing_secret" ? presence.control_plane.adapters.discord.signing_secret : false;
+        case "telegram":
+            if (key === "webhook_secret")
+                return presence.control_plane.adapters.telegram.webhook_secret;
+            if (key === "bot_token")
+                return presence.control_plane.adapters.telegram.bot_token;
+            if (key === "bot_username")
+                return presence.control_plane.adapters.telegram.bot_username;
+            return false;
+    }
+}
+export function missingRequiredFields(adapter, presence) {
+    if (!presence) {
+        return adapter.fields.filter((field) => field.required).map((field) => field.key);
+    }
+    return adapter.fields
+        .filter((field) => field.required && !fieldPresent(presence, adapter.id, field.key))
+        .map((field) => field.key);
+}
+export function configured(adapter, presence) {
+    return missingRequiredFields(adapter, presence).length === 0;
+}
+export function deriveState(opts) {
+    if (opts.adapter.support === "planned")
+        return "planned";
+    if (opts.active)
+        return "active";
+    if (opts.configured)
+        return "configured_not_active";
+    return "missing_config";
+}
+export function nextStepForState(opts) {
+    switch (opts.state) {
+        case "active":
+            return "No action needed. Adapter is mounted and receiving webhooks.";
+        case "configured_not_active":
+            return "Run `/mu setup apply <adapter>` to trigger in-process control-plane reload.";
+        case "missing_config":
+            return `Set required config fields: ${opts.missing.join(", ")}.`;
+        case "planned":
+            return "Adapter is planned. Track implementation work before expecting runtime activation.";
+    }
+}

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

@@ -0,0 +1,17 @@
+/**
+ * mu-messaging-setup — Adapter configuration diagnostics + guided setup.
+ *
+ * Goals:
+ * - Make `/mu setup <adapter>` hand setup context to the active mu agent.
+ * - Keep configuration in `.mu/config.json` (no process.env mutations).
+ * - Support plan/apply/verify workflow with in-process control-plane reload.
+ */
+import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
+export type { AdapterId, AdapterCheck, AdapterPlan, RuntimeState, SetupAction } from "./types.js";
+export type { ParsedSetupCommand } from "./parser.js";
+export type MessagingSetupExtensionOpts = {
+    allowApply?: boolean;
+};
+export declare function messagingSetupExtension(pi: ExtensionAPI, opts?: MessagingSetupExtensionOpts): void;
+export default messagingSetupExtension;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/extensions/messaging-setup/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAiBlE,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAClG,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtD,MAAM,MAAM,2BAA2B,GAAG;IACzC,UAAU,CAAC,EAAE,OAAO,CAAC;CACrB,CAAC;AAEF,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,YAAY,EAAE,IAAI,GAAE,2BAAgC,QAsR/F;AAED,eAAe,uBAAuB,CAAC"}