@miragon/pulse-widget-shell 0.24.2 → 0.25.0

package/dist/composed-server.js

@@ -1,121 +1,143 @@
 /**
- * The composed-server boot sequence, single-sourced (server path only).
- *
- * Every composition root — the stock server, the composed-server template, a
- * customer fork — used to copy the same ~60 lines (selection → boot log →
- * `createFrameworkApp` → request context → logging → metrics → health →
- * listen → signals), and the copies drifted. This factory owns the ORDER;
- * the root keeps what is genuinely its own: the module list
- * (`composeModules`), the OAuth provider it decided to install, and its
- * runtime wiring (plugins with their shared resources, persistence).
- *
- * The order is load-bearing:
- * 1. env-typo warnings, the HTTP edge policy and the OAuth resource check —
- *    misconfiguration fails the boot before any I/O;
- * 2. ONE boot selection (`resolveBoot`, authenticated exactly when the root
- *    handed in an OAuth provider) and its boot log;
- * 3. the root's runtime (`setup(boot)` — e.g. database migrations);
- * 4. `createFrameworkApp` (every view-bound tool advertising the view CSP —
- *    `MCP_URL`'s origin in `resourceDomains`, where the views load their
- *    fonts from), then the mcp-use middleware (request context before
- *    metrics; request logging is mcp-use's own) and the HTTP routes: metrics first
- *    (hono only counts routes registered after its middleware), then the
- *    Host/Origin guard, then the health probes — so `/metrics` and
- *    `/health*` stay reachable by IP-addressed scrapers and probes — and the
- *    font route behind the guard;
- * 5. `listen()` (production only — `mcp-use dev` owns the socket): the
- *    body-capped Node listener with request timeouts, and the graceful drain
- *    on SIGTERM/SIGINT.
- *
- * Under `mcp-use dev` the CLI also owns the `Host` check: on its loopback
- * default it admits localhost-class names plus its own live tunnel host —
- * reserved after this entry is imported, so only the CLI knows it — and
- * `--host 0.0.0.0` is its explicit, loudly warned opt-out. The guard then
- * defers its `Host` half to the CLI (else `mcp-use dev --tunnel` answers every
- * hosted-assistant call 403) and keeps the `Origin` half, which the CLI lacks.
+ * The composed-server boot; a root hands it only its module list and its cross-module wiring.
+ * The order is load-bearing: config checks fail before any I/O; OAuth from the env (mcp-use's own
+ * `MCP_USE_OAUTH_*`); one `resolveBoot`; the plugins from the active modules;
+ * the tool guard before any plugin registers, the views primed once after the last one; metrics
+ * before other routes (hono only counts later routes), then the Host/Origin guard, then
+ * health (reachable by IP-addressed probes), fonts behind the guard; `listen()` in production only.
+ * Under `mcp-use dev` the CLI owns the `Host` check (only it knows its tunnel host), so the guard
+ * keeps just the `Origin` half; else `--tunnel` answers every hosted-assistant call 403.
  */
+import fs from "node:fs/promises";
 import http from "node:http";
-import { createFrameworkApp } from "@miragon/mcp-toolkit-core/tools";
-import { frameworkWritesAllowed } from "./composition.js";
+import { MCPServer, registerViews } from "mcp-use";
+import { composeModules, } from "./composition.js";
 import { installHealthEndpoints } from "./health.js";
 import { requestLogLevelWarning, resolvePort, swallowDevCliViewsPrime } from "./host-boot.js";
 import { describeHttpEdgePolicy, edgeRejection, HTTP_EDGE_ENV_VARS, installHttpEdgeGuard, resolveHttpEdgePolicy, } from "./http-edge.js";
 import { installMetrics } from "./metrics.js";
+import { OAUTH_ENV_VARS, oauthFromEnv } from "./oauth-env.js";
 import { createBodyLimitedListener } from "./node-listener.js";
 import { fontAssetsCsp, installFontAssets } from "./font-assets.js";
 import { installToolSchemaTrim } from "./tool-schema-trim.js";
 import { installMcpRequestContext } from "./request-context.js";
-import { honorWidgetMetaDefaults } from "./widget-meta-defaults.js";
+import { installToolRegistration } from "./tool-registration.js";
+import { viewPrelude } from "./protocol/view-name.js";
 /** Below Fly's default 5 s kill timeout and Docker's 10 s stop grace. */
 export const DEFAULT_DRAIN_TIMEOUT_MS = 4000;
 /** Far above any MCP client's upload, far below Node's 300 s default. */
 export const DEFAULT_REQUEST_TIMEOUT_MS = 30_000;
+/**
+ * What the boot itself reads: the HTTP edge, the OAuth provider variables, the module selection
+ * and mcp-use's request-log level (read by mcp-use; the boot warns at debug/trace).
+ */
+const BOOT_ENV_VARS = [
+    ...HTTP_EDGE_ENV_VARS,
+    ...OAUTH_ENV_VARS,
+    "MCP_ACTIVE_MODULES",
+    "MCP_USE_LOG_LEVEL",
+];
+const composeFor = (label, modules, envVarHint) => composeModules({ label, modules, appEnvVars: BOOT_ENV_VARS, envVarHint });
+/** Every variable a boot over `modules` reads: the boot's own plus each module's `knownEnvVars`. */
+export function composedEnvVars(modules) {
+    return composeFor("env", modules).knownEnvVars;
+}
+/**
+ * Every variable the modules retired (`retired.envVars`), which a boot over them refuses while it
+ * is set. A neutral test env clears these next to `composedEnvVars`, so a value a shell still
+ * exports never reaches the boot.
+ */
+export function retiredEnvVars(modules) {
+    return new Set(composeFor("env", modules).retiredEnvVars.keys());
+}
 const HEALTH_PATH = "/health";
 const METRICS_PATH = "/metrics";
-/** The read-only operational routes: probes and scrapers reach them by container IP. */
 const EXEMPT_PATHS = [HEALTH_PATH, METRICS_PATH];
-/**
- * The policy the guard enforces: the resolved edge, except that under
- * `mcp-use dev` the `Host` half is the CLI's (see the module comment).
- */
 function guardPolicyFor(edge, env) {
     return env.MCP_USE_DEV_CLI ? { ...edge, allowedHosts: "*" } : edge;
 }
-/**
- * mcp-use resolves the OAuth resource (RFC 8707 audience) from the provider
- * or `MCP_URL`; behind our own listener there is no localhost fallback, and a
- * missing resource would only surface as a failure on the first `/mcp` call.
- */
+/** Behind our own listener a missing OAuth resource would only surface on the first `/mcp` call. */
 function assertOAuthResource(oauth, env, label) {
     if (oauth && oauth.resource === undefined && !env.MCP_URL?.trim()) {
-        throw new Error(`[${label}] OAuth needs MCP_URL — the server's public base URL, which is also the token audience (RFC 8707).`);
+        throw new Error(`[${label}] OAuth needs MCP_URL, the server's public base URL, which is also the token audience (RFC 8707).`);
     }
 }
-/** The root's preamble, then every active module's snippet — blank-line separated. */
-function serverInstructions(options, boot) {
-    const parts = [options.info.instructions?.trim(), options.composition.instructions(boot)];
+function serverInstructions(info, modules) {
+    const parts = [info.instructions?.trim(), modules];
     const text = parts.filter((part) => Boolean(part)).join("\n\n");
     return text || undefined;
 }
-async function buildFrameworkApp(options, boot, builder, runtime, env) {
-    const { info, oauth } = options;
-    const { title, websiteUrl } = info;
-    const instructions = serverInstructions(options, boot);
-    // The font origin, on render-view's view and — through each plugin's
-    // widget defaults — on every module's view-bound tool.
-    const csp = fontAssetsCsp(env);
-    const frameworkOptions = {
+function createServer(info, instructions, oauth) {
+    // No `baseUrl`: mcp-use resolves the serving origin from the request or `MCP_URL`.
+    const config = {
+        ...(info.title ? { title: info.title } : {}),
+        ...(info.websiteUrl ? { websiteUrl: info.websiteUrl } : {}),
+        ...(instructions ? { instructions } : {}),
         name: info.name,
         version: info.version,
         description: info.description,
-        serverOptions: {
-            ...(title ? { title } : {}),
-            ...(websiteUrl ? { websiteUrl } : {}),
-            ...(instructions ? { instructions } : {}),
-        },
-        // Cast: the toolkit types `plugins` unparameterized (TServer = unknown);
-        // the factories return `AppPlugin<MCPServer>`, which is what the
-        // framework passes at runtime.
-        plugins: runtime.plugins.map(honorWidgetMetaDefaults),
-        appConfig: { activeApps: boot.entries, pipelines: {} },
-        app: {
-            bundle: options.bundle,
-            builder,
-            dashboardStore: runtime.dashboardStore,
-            ...(csp ? { csp } : {}),
-        },
+        host: "localhost",
     };
-    // Two calls because the oauth/no-oauth overloads are distinct.
-    return oauth
-        ? await createFrameworkApp({ ...frameworkOptions, oauth })
-        : await createFrameworkApp(frameworkOptions);
+    return oauth ? new MCPServer({ ...config, oauth }) : new MCPServer(config);
+}
+/** A missing file only warns, so a dev server boots before the first bundle build. */
+async function readBundleFile(filePath, label) {
+    try {
+        return await fs.readFile(filePath, "utf-8");
+    }
+    catch {
+        console.warn(`[${label}] No widget bundle at ${filePath}: views render empty until the bundle is built and the server restarts.`);
+        return "";
+    }
+}
+/** Priming is one-shot in mcp-use, so it runs once every plugin bound its views: all share ONE bundle, each behind its name's prelude. */
+async function primeViews(server, viewNames, bundle, label) {
+    if (viewNames.size === 0)
+        return;
+    const js = await readBundleFile(bundle.jsPath, label);
+    const css = bundle.cssPath ? await readBundleFile(bundle.cssPath, label) : "";
+    // The prelude names the view before the bundle runs (`mountViews` reads it).
+    const manifest = Object.fromEntries([...viewNames].map((name) => [name, { kind: "inline", js: viewPrelude(name) + js, css }]));
+    server[registerViews](manifest);
+}
+/** The one selection of this boot, with everything it logs: config checks fail before any I/O. */
+function resolveSelection(options, composition, env) {
+    const label = options.info.name;
+    // A renamed setting first: an operator upgrading with old settings reads the rename, not a
+    // later check's failure.
+    composition.refuseRetired(env);
+    composition.warnUnknownEnvVars(env);
+    const edge = resolveHttpEdgePolicy(env);
+    const oauth = options.oauth ?? oauthFromEnv(env, label);
+    assertOAuthResource(oauth, env, label);
+    // The same test `createServer` installs OAuth on: a boot is authenticated only with the bearer gate.
+    const boot = composition.resolveBoot(env, { authenticated: Boolean(oauth) });
+    composition.emitBootWarnings(env);
+    const logLevel = requestLogLevelWarning(env);
+    if (logLevel)
+        console.warn(`[${label}] ${logLevel}`);
+    composition.logEffectiveToolsets(boot);
+    console.info(`[${label}] ${describeHttpEdgePolicy(edge)}`);
+    return { edge, oauth, boot };
+}
+async function buildServer(options, composition, selection, env) {
+    const { info } = options;
+    const { boot, oauth } = selection;
+    const app = createServer(info, serverInstructions(info, composition.instructions(boot)), oauth);
+    // Registrars take the OAuth-less type: no handler reads `ctx.auth`, only the request middleware.
+    const server = app;
+    const registration = installToolRegistration(server, fontAssetsCsp(env));
+    const shared = options.shared?.(boot.entries) ?? {};
+    for (const plugin of composition.pluginsFor(boot.entries, shared))
+        registration.register(plugin);
+    await primeViews(server, registration.viewNames, options.bundle, info.name);
+    return app;
 }
 const displayHost = (host) => {
     if (host === "0.0.0.0" || host === "::")
         return "localhost";
     return host.includes(":") ? `[${host}]` : host;
 };
-/** Resolves `true` when `promise` settles within `ms`, `false` on timeout. */
 async function settlesWithin(promise, ms) {
     let timer;
     const timeout = new Promise((resolve) => {
@@ -131,28 +153,22 @@ async function settlesWithin(promise, ms) {
 async function drain(ctx) {
     const { label, app, server, listener } = ctx;
     ctx.state.draining = true;
-    console.info(`[${label}] Draining — ${listener.inFlight} request(s) in flight`);
+    console.info(`[${label}] Draining: ${listener.inFlight} request(s) in flight`);
     const closed = new Promise((resolve) => server.close(() => resolve()));
     server.closeIdleConnections();
     if (!(await settlesWithin(listener.idle(), ctx.drainTimeoutMs))) {
-        console.warn(`[${label}] Drain timed out after ${ctx.drainTimeoutMs}ms — closing ${listener.inFlight} request(s)`);
+        console.warn(`[${label}] Drain timed out after ${ctx.drainTimeoutMs}ms: closing ${listener.inFlight} request(s)`);
     }
-    // Closes the MCP handler (open subscription streams included) before the
-    // sockets go, so streams end cleanly instead of being reset.
+    // Closing the MCP handler before the sockets ends streams cleanly instead of resetting them.
     await app.close().catch((error) => console.error(`[${label}] close failed:`, error));
     server.closeAllConnections();
     await closed;
-    await ctx.runtime.shutdown?.();
 }
-function installSignalHandlers(shutdown, label) {
+/** The drain never rejects: a failing `app.close()` only logs, so the process exits 0 after it. */
+function installSignalHandlers(shutdown) {
     // `once`: a second signal during the drain kills the process the default way.
     for (const signal of ["SIGTERM", "SIGINT"]) {
-        process.once(signal, () => {
-            shutdown().then(() => process.exit(0), (error) => {
-                console.error(`[${label}] shutdown failed:`, error);
-                process.exit(1);
-            });
-        });
+        process.once(signal, () => void shutdown().then(() => process.exit(0)));
     }
 }
 async function listen(ctx, options) {
@@ -162,7 +178,7 @@ async function listen(ctx, options) {
     const listener = createBodyLimitedListener(app, {
         maxBodyBytes: guard.maxBodyBytes,
         maxInFlightBodyBytes: guard.maxInFlightBodyBytes,
-        // The guard refuses these whatever their body says — never buffer it.
+        // The guard refuses these whatever their body says: never buffer it.
         refusedBeforeBody: (req) => edgeRejection({
             method: (req.method ?? "GET").toUpperCase(),
             path: (req.url ?? "/").split("?")[0],
@@ -175,7 +191,6 @@ async function listen(ctx, options) {
     const server = http.createServer({
         requestTimeout,
         headersTimeout: requestTimeout,
-        // Node checks the timeouts on this interval (default 30 s).
         connectionsCheckingInterval: Math.min(requestTimeout, 5000),
     }, listener);
     await new Promise((resolve, reject) => {
@@ -196,65 +211,43 @@ async function listen(ctx, options) {
         drainTimeoutMs: options.drainTimeoutMs ?? DEFAULT_DRAIN_TIMEOUT_MS,
     }));
     if (options.handleSignals)
-        installSignalHandlers(shutdown, label);
+        installSignalHandlers(shutdown);
     return { port: bound, url, shutdown };
 }
-/**
- * Boot a composed server — see the module comment for the sequence. Returns
- * BEFORE listening: `mcp-use dev` serves `app` itself, production calls
- * `listen({ handleSignals: true })`.
- */
-export async function createComposedServer(options) {
-    const { label, composition, oauth, env = process.env } = options;
-    // mcp-use ships anonymized telemetry enabled by default — an ops server
-    // must not phone home unless explicitly opted in.
-    process.env.MCP_USE_ANONYMIZED_TELEMETRY ??= "false";
-    composition.warnUnknownEnvVars(env, [...HTTP_EDGE_ENV_VARS, ...(options.extraKnownEnvVars ?? [])]);
-    const edge = resolveHttpEdgePolicy(env);
-    assertOAuthResource(oauth, env, label);
-    const boot = composition.resolveBoot(env, { authenticated: oauth !== undefined });
-    const builder = frameworkWritesAllowed(boot);
-    composition.emitBootWarnings(env);
-    const logLevel = requestLogLevelWarning(env);
-    if (logLevel)
-        console.warn(`[${label}] ${logLevel}`);
-    composition.logEffectiveToolsets(boot);
-    if (!builder) {
-        console.info(`[${label}] Dashboard builder off (needs OAuth and no read-only module) — render-view stays.`);
-    }
-    console.info(`[${label}] ${describeHttpEdgePolicy(edge)}`);
+async function boot(options, composition, env) {
+    const label = options.info.name;
+    const selection = resolveSelection(options, composition, env);
+    const { edge, boot } = selection;
     const guard = guardPolicyFor(edge, env);
     if (guard !== edge) {
         console.info(`[${label}] mcp-use dev: the CLI checks Host (localhost-class + its tunnel); Origin is checked here.`);
     }
-    const runtime = await options.setup(boot);
-    const app = await buildFrameworkApp(options, boot, builder, runtime, env);
+    const app = await buildServer(options, composition, selection, env);
     const state = { draining: false };
-    // Ambient per-request info (OAuth caller, Authorization header) for the
-    // consumers without a handler `ctx`; input schemas trimmed of keys a model
-    // never needs (`$schema`, safe-integer bounds); the dev-CLI views-prime
-    // workaround (no-op outside `mcp-use dev`). Request logging is mcp-use's
-    // own (`MCP_USE_LOG_LEVEL`, see `requestLogLevelWarning`).
+    // Request logging is mcp-use's own (`MCP_USE_LOG_LEVEL`).
     installMcpRequestContext(app);
     installToolSchemaTrim(app);
     swallowDevCliViewsPrime(app, env);
     installMetrics(app, { path: METRICS_PATH, token: edge.metricsToken });
     installHttpEdgeGuard(app, guard, { exemptPaths: EXEMPT_PATHS });
-    installHealthEndpoints(app, {
-        path: HEALTH_PATH,
-        readiness: runtime.readiness,
-        label,
-        draining: () => state.draining,
-    });
-    // Geist + Geist Mono for the views — behind the guard (a font GET passes
-    // the Origin half, a foreign Host does not), counted by the metrics.
+    installHealthEndpoints(app, { path: HEALTH_PATH, label, draining: () => state.draining });
+    // Behind the guard: a font GET passes the Origin half, a foreign Host does not.
     installFontAssets(app, { label });
     return {
         app,
         boot,
-        builder,
-        edge,
-        listen: (listenOptions = {}) => listen({ label, app, guard, env, runtime, state }, listenOptions),
+        listen: (listenOptions = {}) => listen({ label, app, guard, env, state }, listenOptions),
     };
 }
+/**
+ * Composes the modules, installs OAuth from the env and builds the plugins. Returns BEFORE
+ * listening: `mcp-use dev` serves `app` itself, production calls `listen()`.
+ */
+export async function createComposedServer(options) {
+    const { info, env = process.env } = options;
+    // mcp-use telemetry is on by default; an ops server must not phone home unless opted in.
+    process.env.MCP_USE_ANONYMIZED_TELEMETRY ??= "false";
+    const composition = composeFor(info.name, options.modules, options.envVarHint);
+    return boot(options, composition, env);
+}
 //# sourceMappingURL=composed-server.js.map

package/dist/composed-server.js.map

@@ -1 +1 @@
-{"version":3,"file":"composed-server.js","sourceRoot":"","sources":["../src/composed-server.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"composed-server.js","sourceRoot":"","sources":["../src/composed-server.ts"],"names":[],"mappings":"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"}

package/dist/composition.d.ts

@@ -1,155 +1,105 @@
-import type { AppConfig, AppConfigEntry, AppPlugin } from "@miragon/mcp-toolkit-core";
 import type { MCPServer } from "mcp-use";
 import type { ToolsetSource, ToolsetVocabulary } from "./toolsets.js";
+/** What a module hands the boot. */
+export interface ModulePlugin {
+    /** The module name; the boot's duplicate tool-name guard names it. */
+    name: string;
+    /**
+     * Registers all of the module's tools, prompts and resources on the server the boot owns.
+     * The boot installs the ambient request info (`callerCacheKey`, passthrough auth) on that
+     * server for every module.
+     */
+    register(server: MCPServer): void;
+}
+/** One active module as the boot resolved it; `config` carries the effective `toolset`. */
+export interface ModuleEntry {
+    app: string;
+    config: Record<string, unknown>;
+}
 /**
- * The composition-root machinery every server (the stock app AND a customer's
- * composed server) previously copied: module selection via
- * `MCP_ACTIVE_MODULES` (with the `module:toolset` suffix), the env-typo
- * warner, boot warnings, and the mcp-use `AppConfig`/plugin assembly.
- *
- * The module PORT SHAPE lives here ({@link ComposableModule}); what stays
- * app-owned by design is its instantiation: each composition root declares its
- * own shared-resources type (`ComposableModule<MyShared>`), its module list,
- * and the cross-module wiring — which module's capability reaches which other
- * module is configuration knowledge, never a module-to-module import.
- * Modules keep conforming STRUCTURALLY and never import this type.
+ * Composition-root machinery. Each root declares its own shared-resources type, module list and
+ * cross-module wiring; modules conform STRUCTURALLY and never import this type.
  */
 export interface ComposableModule<TShared> {
-    /** Module key used in `MCP_ACTIVE_MODULES` and as the `activeApps` entry name. */
+    /** Key in `MCP_ACTIVE_MODULES` and the `app` of its `ModuleEntry`. */
     name: string;
-    /** Pure env → raw-config mapping; must not read `process.env` or perform I/O side effects beyond config sources. */
+    /** Pure env → raw-config mapping; no `process.env`, no I/O side effects. */
     configFromEnv(env: NodeJS.ProcessEnv): Record<string, unknown>;
-    /** Env vars this module reads — composed into the root's unknown-var typo warner. */
     knownEnvVars: readonly string[];
-    /**
-     * The module's toolset vocabulary (`createToolsetVocabulary`). Declaring it
-     * opts the module into the `module:toolset` suffix: the composition resolves
-     * ONE concrete toolset per boot — the suffix, or the auth-dependent default,
-     * never "everything" — and threads it into `config.toolset`. Absent = the
-     * module has no toolsets: a suffix is ignored (with a warning) and its config
-     * never carries a `toolset`.
-     */
+    /** Opts into the `module:toolset` suffix; absent = a suffix is ignored with a warning. */
     toolsets?: ToolsetVocabulary<string>;
-    /** Optional boot-time hints (returned, and logged by the root) for active deployments. */
     bootWarnings?(env: NodeJS.ProcessEnv): string[];
-    /**
-     * Optional model-facing usage notes for this module — routing rules,
-     * argument conventions, which tool answers which question — joined into
-     * the server `instructions` ({@link ModuleComposition.instructions}), so
-     * the rule is stated ONCE instead of in every tool description. Receives
-     * the module's boot config (incl. its effective `toolset`) and the boot's
-     * auth mode; `undefined` contributes nothing.
-     */
-    instructions?(config: Record<string, unknown>, context: InstructionsContext): string | undefined;
-    /** Validates the raw config and builds the plugin; receives the shared resources. */
-    createPlugin(config: Record<string, unknown>, shared: TShared): AppPlugin<MCPServer>;
-}
-/** What a module's {@link ComposableModule.instructions} may depend on besides its config. */
-export interface InstructionsContext {
-    /** Whether the root installed OAuth — a caller identity (and per-user saves) exists. */
-    authenticated: boolean;
+    /** Model-facing usage notes joined into the server `instructions`, stated ONCE instead of per tool. */
+    instructions?(config: Record<string, unknown>): string | undefined;
+    createPlugin(config: Record<string, unknown>, shared: TShared): ModulePlugin;
+    /** Names this module carried before: the boot refuses each while it is set, naming its replacement. */
+    retired?: {
+        /** Former names in `MCP_ACTIVE_MODULES`. */
+        names?: readonly string[];
+        /** Former environment variables, each with the variable that replaces it. */
+        envVars?: Readonly<Record<string, string>>;
+        /**
+         * Former variables a shell may still export for another tool (a credential the CLI's docs
+         * name, say): the boot warns, naming the replacement, instead of refusing.
+         */
+        warnedEnvVars?: Readonly<Record<string, string>>;
+    };
 }
-export interface ActiveModuleRef {
+interface ActiveModuleRef {
     name: string;
-    /**
-     * The raw toolset suffix from the `module:toolset` syntax, e.g.
-     * `camunda7:read-only` — trimmed, and kept even when EMPTY (`camunda7:` →
-     * `""`), so an empty suffix fails closed like an unknown one instead of
-     * reading as "no suffix". Absent = no suffix: the auth-dependent default.
-     */
+    /** Kept even when EMPTY (`engine:` → `""`), so an empty suffix fails closed like an unknown one. */
     toolset?: string;
 }
-/** The toolset one active module runs with — one entry of the boot log. */
-export interface EffectiveToolset {
+interface EffectiveToolset {
     module: string;
-    /** The concrete toolset; absent for a module without toolsets. */
     toolset?: string;
-    /**
-     * Why: the suffix named it, the auth-dependent default applied, an empty or
-     * unknown suffix fell back to the floor — or `none` for a module without
-     * toolsets.
-     */
     source: ToolsetSource | "none";
-    /**
-     * Whether the toolset permits durable writes. A module without toolsets
-     * declares no restriction (`true`).
-     */
-    durableWrites: boolean;
 }
-/** One boot's module selection, resolved ONCE by the composition root. */
 export interface ResolvedBoot {
-    /** Whether the root installed OAuth (a caller identity exists). */
     authenticated: boolean;
-    /** The active modules' mcp-use config entries, each carrying its effective toolset. */
-    entries: AppConfigEntry[];
+    entries: ModuleEntry[];
     toolsets: EffectiveToolset[];
 }
-export interface ResolveBootOptions {
+interface ResolveBootOptions {
     /**
-     * Whether the composition root INSTALLED OAuth on `/mcp`. Only the root
-     * knows — never infer it from an env var the root may not honor (a server
-     * without OAuth wiring would read a stray `MCP_OAUTH` as authenticated and
-     * fail open). Omitted = `false`, the fail-closed reading.
+     * Only the boot knows whether it INSTALLED OAuth; reading `MCP_USE_OAUTH_*` here would count a
+     * boot without the bearer gate as authenticated and fail open. Omitted = `false`.
      */
     authenticated?: boolean;
 }
-/**
- * All members are `this`-free closures (function properties, not methods), so
- * composition roots may destructure or re-export them directly
- * (`export const warnUnknownEnvVars = composition.warnUnknownEnvVars`).
- */
+/** What the boot (`createComposedServer`) composes the modules into; no root sees it. */
 export interface ModuleComposition<TShared> {
-    /** Every known env var: the root's own plus each module's slice. */
+    /** The one source of the variables a boot reads (`composedEnvVars`). */
     knownEnvVars: ReadonlySet<string>;
-    /** The `MCP_ACTIVE_MODULES` selection (unset/`all` = every module); unknown names warn and are skipped. */
-    activeModules: (env?: NodeJS.ProcessEnv) => ActiveModuleRef[];
     /**
-     * Resolve the boot ONCE: every toolset-bearing module gets a concrete
-     * effective toolset in its config (suffix → itself; empty/unknown → the
-     * module's floor, with one warning; none → the floor without OAuth, the
-     * module's standard toolset with it). Call it once per boot and derive
-     * plugins, `AppConfig` and the boot log from the result.
+     * Every module's retired variable with the one that replaces it (`retiredEnvVars`), refused or
+     * warned about; never read.
+     */
+    retiredEnvVars: ReadonlyMap<string, string>;
+    /**
+     * Throws ONCE on every retired variable that is set (blank included) and every retired module
+     * name in `MCP_ACTIVE_MODULES`, naming each replacement, so one failed boot names every rename.
+     * The boot calls it first, before any other setting is checked; `resolveBoot` refuses the same,
+     * `activeModules` the module names.
      */
+    refuseRetired: (env?: NodeJS.ProcessEnv) => void;
+    /** Unset/`all` = every module; unknown names warn and are skipped. */
+    activeModules: (env?: NodeJS.ProcessEnv) => ActiveModuleRef[];
+    /** Call once per boot; derive the plugins and the boot log from the result. */
     resolveBoot: (env?: NodeJS.ProcessEnv, options?: ResolveBootOptions) => ResolvedBoot;
-    /** `resolveBoot(env, options).entries`. */
-    appEntries: (env?: NodeJS.ProcessEnv, options?: ResolveBootOptions) => AppConfigEntry[];
-    appConfig: (env?: NodeJS.ProcessEnv, options?: ResolveBootOptions) => AppConfig;
-    /** Instantiate the active modules' plugins with the root's shared resources. */
-    pluginsFor: (entries: AppConfigEntry[], shared: TShared) => AppPlugin<MCPServer>[];
-    /** Report unknown env vars under any watched prefix; returns the offenders. */
+    pluginsFor: (entries: ModuleEntry[], shared: TShared) => ModulePlugin[];
     warnUnknownEnvVars: (env?: NodeJS.ProcessEnv, extraKnown?: Iterable<string>) => string[];
-    /** Collect + log the active modules' boot-time hints. */
     emitBootWarnings: (env?: NodeJS.ProcessEnv) => string[];
-    /** Log (console.info) and return the one boot line that states each active module's effective toolset. */
     logEffectiveToolsets: (boot: ResolvedBoot) => string;
-    /**
-     * The active modules' instruction snippets for this boot, in module order,
-     * joined by a blank line — `undefined` when none contributes. The root
-     * prepends its own preamble (`createComposedServer` does).
-     */
     instructions: (boot: ResolvedBoot) => string | undefined;
 }
 export declare function composeModules<TShared>(options: {
-    /** Log prefix for every warning, e.g. `pulse`. */
     label: string;
     modules: readonly ComposableModule<TShared>[];
-    /** The root's own env vars (module vars come from each module's `knownEnvVars`). */
     appEnvVars?: readonly string[];
-    /**
-     * Prefixes owned by dependencies, exempt from the typo warner
-     * (mcp-use itself + the dev inspector by default).
-     */
+    /** Prefixes owned by dependencies, exempt from the typo warner. */
     foreignEnvPrefixes?: readonly string[];
-    /** Optional pointer appended to the unknown-var warning, e.g. `see docs/operations.md`. */
     envVarHint?: string;
 }): ModuleComposition<TShared>;
-/**
- * Whether the server may register FRAMEWORK durable writes — the toolkit
- * builder's `save-dashboard`/`delete-dashboard` and the shell's
- * `shell_save_settings`, which no module toolset filters. Only with a caller
- * identity (records are keyed by user; without OAuth every record is shared
- * and ownerless) and only when no active module sits on its read-only floor:
- * the most restrictive module wins.
- */
-export declare function frameworkWritesAllowed(boot: ResolvedBoot): boolean;
+export {};
 //# sourceMappingURL=composition.d.ts.map