@miragon/pulse-widget-shell 0.24.2 → 0.25.0

package/dist/composition.d.ts.map

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

package/dist/composition.js

@@ -2,70 +2,76 @@ export function composeModules(options) {
     const { label, modules, appEnvVars = [], foreignEnvPrefixes = ["MCP_USE_", "MCP_INSPECTOR_"], envVarHint, } = options;
     const registry = Object.fromEntries(modules.map((m) => [m.name, m]));
     const knownEnvVars = new Set([...appEnvVars, ...modules.flatMap((m) => [...m.knownEnvVars])]);
-    // Watched prefixes derive from every known var (NOTES_TITLE contributes
-    // NOTES_, PROMETHEUS_URL contributes PROMETHEUS_, …) so custom modules get
-    // the same typo coverage as the CAMUNDA_/MCP_ families — a hardcoded prefix
-    // list would silently exempt every non-Camunda module.
+    const { retiredNames, refusedEnvVars, warnedEnvVars } = retiredTables(modules, knownEnvVars);
+    const retiredEnvVars = new Map([...refusedEnvVars, ...warnedEnvVars]);
+    // Prefixes derive from every known var, so custom modules get the same typo coverage.
     const watchedPrefixes = [
         ...new Set([...knownEnvVars]
             .map((name) => name.slice(0, name.indexOf("_") + 1))
             .filter((prefix) => prefix.length > 1)),
     ];
     /**
-     * `MCP_ACTIVE_MODULES` → the known modules (with their raw suffix) and the
-     * unknown names. Deliberately not the toolkit's `parseActiveModules`: that
-     * one reads an empty qualifier (`camunda7:`) as no qualifier, which would
-     * turn it into the auth-dependent default instead of failing closed. A name
-     * that appears twice is refused — two entries would build two plugins with
-     * colliding steps, and which suffix wins would be a guess.
+     * `engine:` keeps its empty suffix, which warns and falls back to the read-only floor instead
+     * of counting as no suffix (the standard toolset under OAuth). A repeated name is refused: two
+     * plugins would collide and the winning suffix is a guess.
      */
-    const parseActiveModules = (env) => {
+    /** The entries of `MCP_ACTIVE_MODULES` as written; undefined when unset or `all`. */
+    const listedModules = (env) => {
         const envValue = env.MCP_ACTIVE_MODULES?.trim();
-        if (!envValue || envValue === "all") {
-            return { known: modules.map(({ name }) => ({ name })), unknown: [] };
-        }
-        const refs = envValue
+        if (!envValue || envValue === "all")
+            return undefined;
+        return envValue
             .split(",")
             .map((s) => s.trim())
             .filter(Boolean)
             .map((entry) => {
-            // Everything after the FIRST colon is the suffix, kept even when empty
-            // or when it contains further colons — both are then unknown toolset
-            // names and fail closed, instead of reading as "no suffix".
+            // Everything after the FIRST colon is the suffix, so extra colons fail closed too.
             const colon = entry.indexOf(":");
             if (colon === -1)
                 return { name: entry };
             return { name: entry.slice(0, colon).trim(), toolset: entry.slice(colon + 1).trim() };
         });
+    };
+    /** Every retired setting of `env` in one error: the variables, then the module names. */
+    const refuseRetired = (env) => {
+        const sentences = [
+            ...retiredEnvVarSentences(env, refusedEnvVars),
+            ...retiredNameSentences(listedModules(env) ?? [], retiredNames),
+        ];
+        if (sentences.length > 0)
+            throw new Error(`[${label}] ${sentences.join(" ")}`);
+    };
+    const parseActiveModules = (env) => {
+        const refs = listedModules(env);
+        if (refs === undefined)
+            return { known: modules.map(({ name }) => ({ name })), unknown: [] };
+        // A former name would read as unknown and boot WITHOUT the module it asks for.
+        const sentences = retiredNameSentences(refs, retiredNames);
+        if (sentences.length > 0)
+            throw new Error(`[${label}] ${sentences.join(" ")}`);
         const repeated = [...new Set(refs.map(({ name }) => name))].filter((name) => refs.filter((ref) => ref.name === name).length > 1);
         if (repeated.length > 0) {
-            throw new Error(`[${label}] MCP_ACTIVE_MODULES names ${repeated.map((name) => `"${name}"`).join(", ")} more than once — list each module once, with at most one :toolset.`);
+            throw new Error(`[${label}] MCP_ACTIVE_MODULES names ${repeated.map((name) => `"${name}"`).join(", ")} more than once. List each module once, with at most one :toolset.`);
         }
         return {
             known: refs.filter(({ name }) => registry[name]),
             unknown: refs.filter(({ name }) => !registry[name]).map(({ name }) => name),
         };
     };
-    /** The known active modules; the unknown ones warn once per boot, in `emitBootWarnings`. */
     const activeModules = (env = process.env) => parseActiveModules(env).known;
-    // The one place a suffix becomes a toolset: per module, per boot.
     const effectiveToolset = (module, suffix, authenticated) => {
         const vocabulary = module.toolsets;
         if (vocabulary) {
             const { toolset, source } = vocabulary.effective(suffix, { authenticated });
-            return {
-                module: module.name,
-                toolset,
-                source,
-                durableWrites: vocabulary.allowsDurableWrites(toolset),
-            };
+            return { module: module.name, toolset, source };
         }
         if (suffix !== undefined) {
-            console.warn(`[${label}] Module "${module.name}" has no toolsets — ignoring ":${suffix}"`);
+            console.warn(`[${label}] Module "${module.name}" has no toolsets: ignoring ":${suffix}"`);
         }
-        return { module: module.name, source: "none", durableWrites: true };
+        return { module: module.name, source: "none" };
     };
     const resolveBoot = (env = process.env, { authenticated = false } = {}) => {
+        refuseRetired(env);
         const toolsets = [];
         const entries = activeModules(env).map(({ name, toolset: suffix }) => {
             const effective = effectiveToolset(registry[name], suffix, authenticated);
@@ -81,15 +87,14 @@ export function composeModules(options) {
         });
         return { authenticated, entries, toolsets };
     };
-    const appEntries = (env, options) => resolveBoot(env, options).entries;
     return {
         knownEnvVars,
+        retiredEnvVars,
+        refuseRetired(env = process.env) {
+            refuseRetired(env);
+        },
         activeModules,
         resolveBoot,
-        appEntries,
-        appConfig(env, options) {
-            return { activeApps: appEntries(env, options), pipelines: {} };
-        },
         pluginsFor(entries, shared) {
             return entries
                 .filter((entry) => registry[entry.app])
@@ -97,26 +102,24 @@ export function composeModules(options) {
         },
         warnUnknownEnvVars(env = process.env, extraKnown = []) {
             const known = new Set([...knownEnvVars, ...extraKnown]);
-            // `<KNOWN_VAR>_*` extensions (DATABASE_URL_FILE, REDIS_URL_2, …) are
-            // conventions addressed at OTHER processes — docker secrets, sidecars —
-            // never a typo of the var they extend, so they don't warn.
+            // `<KNOWN_VAR>_*` (PROMETHEUS_PASSWORD_FILE, …) addresses OTHER processes, never a typo.
             const extendsKnownVar = (name) => [...known].some((knownName) => name.startsWith(`${knownName}_`));
             const unknown = Object.keys(env).filter((name) => watchedPrefixes.some((prefix) => name.startsWith(prefix)) &&
                 !known.has(name) &&
                 !extendsKnownVar(name) &&
                 !foreignEnvPrefixes.some((prefix) => name.startsWith(prefix)));
             for (const name of unknown) {
-                console.warn(`[${label}] Unknown environment variable "${name}" — the server does not read it; ` +
+                console.warn(`[${label}] Unknown environment variable "${name}": the server does not read it; ` +
                     `check for a typo${envVarHint ? ` (${envVarHint})` : ""}.`);
             }
             return unknown;
         },
         emitBootWarnings(env = process.env) {
-            // Deliberately separate from `configFromEnv` (which runs inside
-            // `resolveBoot` and stays side-effect free).
+            // Separate from `configFromEnv`, which stays side-effect free.
             const { known, unknown } = parseActiveModules(env);
             const warnings = [
-                ...unknown.map((name) => `Unknown module "${name}" in MCP_ACTIVE_MODULES — skipping`),
+                ...warnedEnvVarSentences(env, warnedEnvVars),
+                ...unknown.map((name) => `Unknown module "${name}" in MCP_ACTIVE_MODULES: skipping`),
                 ...known.flatMap(({ name }) => registry[name].bootWarnings?.(env) ?? []),
             ];
             for (const warning of warnings) {
@@ -125,8 +128,7 @@ export function composeModules(options) {
             return warnings;
         },
         logEffectiveToolsets(boot) {
-            // console.info, deliberately not a boot WARNING: it states the surface
-            // on every boot, the restrictive default included.
+            // console.info, not a warning: it states the surface on every boot.
             const describe = ({ module, toolset, source }) => {
                 if (toolset === undefined)
                     return `${module} (no toolsets)`;
@@ -136,28 +138,92 @@ export function composeModules(options) {
                 return `${module}:${toolset} (${source})`;
             };
             const modules = boot.toolsets.map(describe).join(", ");
-            const line = `[${label}] Toolsets — ${modules || "no active modules"}`;
+            const line = `[${label}] Toolsets: ${modules || "no active modules"}`;
             console.info(line);
             return line;
         },
         instructions(boot) {
-            const context = { authenticated: boot.authenticated };
             const snippets = boot.entries
-                .map((entry) => registry[entry.app]?.instructions?.(entry.config, context)?.trim())
+                .map((entry) => registry[entry.app]?.instructions?.(entry.config)?.trim())
                 .filter((snippet) => Boolean(snippet));
             return snippets.length > 0 ? snippets.join("\n\n") : undefined;
         },
     };
 }
 /**
- * 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.
+ * Every module's former names, each with its current one, built once per composition. A table
+ * that contradicts itself (a former name that is a current module or a variable a module reads)
+ * fails at compose time instead of refusing a working setting.
+ */
+function retiredTables(modules, knownEnvVars) {
+    // In any case: the boot matches a former name in any case.
+    const current = new Set(modules.map(({ name }) => name.toLowerCase()));
+    const retiredNames = new Map();
+    const refusedEnvVars = new Map();
+    const warnedEnvVars = new Map();
+    for (const module of modules) {
+        for (const former of module.retired?.names ?? []) {
+            if (current.has(former.toLowerCase())) {
+                throw new Error(`Module "${module.name}" retires the name "${former}", which a composed module still carries.`);
+            }
+            retiredNames.set(former, module.name);
+        }
+        const retiring = [
+            [new Map(Object.entries(module.retired?.envVars ?? {})), refusedEnvVars],
+            [new Map(Object.entries(module.retired?.warnedEnvVars ?? {})), warnedEnvVars],
+        ];
+        for (const [table, into] of retiring) {
+            for (const [former, replacement] of table) {
+                if (knownEnvVars.has(former)) {
+                    throw new Error(`Module "${module.name}" retires the variable ${former}, which a composed module still reads.`);
+                }
+                if (refusedEnvVars.has(former) || warnedEnvVars.has(former)) {
+                    throw new Error(`The variable ${former} is retired twice (module "${module.name}").`);
+                }
+                into.set(former, replacement);
+            }
+        }
+    }
+    return { retiredNames, refusedEnvVars, warnedEnvVars };
+}
+/** One warning per warned retired variable that is present: the server reads its replacement. */
+function warnedEnvVarSentences(env, warnedEnvVars) {
+    return [...warnedEnvVars.keys()]
+        .filter((name) => env[name] !== undefined)
+        .sort()
+        .map((name) => `${name} is no longer read; the server reads ${warnedEnvVars.get(name)}. Rename it if it was meant for the server.`);
+}
+/**
+ * One sentence for every retired variable that is present, blank included: its value would be
+ * ignored.
+ */
+function retiredEnvVarSentences(env, retiredEnvVars) {
+    const present = [...retiredEnvVars.keys()].filter((name) => env[name] !== undefined).sort();
+    if (present.length === 0)
+        return [];
+    const one = present.length === 1;
+    const renames = present.map((name) => `${name} becomes ${retiredEnvVars.get(name)}`).join(", ");
+    return [
+        `${present.join(", ")} ${one ? "is" : "are"} no longer read, so the server does not start ` +
+            `with ${one ? "a setting" : "settings"} it would ignore. ` +
+            `Rename ${one ? "it, the value stays" : "them, the values stay"}: ${renames}.`,
+    ];
+}
+/**
+ * One sentence per retired entry, its suffix carried over to the current name. A former name
+ * matches in any case: it means nothing else, and as an unknown name it would only warn.
  */
-export function frameworkWritesAllowed(boot) {
-    return boot.authenticated && boot.toolsets.every(({ durableWrites }) => durableWrites);
+function retiredNameSentences(refs, retiredNames) {
+    return refs.flatMap(({ name, toolset }) => {
+        const current = [...retiredNames].find(([former]) => former.toLowerCase() === name.toLowerCase())?.[1];
+        if (current === undefined)
+            return [];
+        const suffix = toolset === undefined ? "" : `:${toolset}`;
+        return [
+            `MCP_ACTIVE_MODULES names "${name}", the former name of the ${current} module, so the server ` +
+                `does not start without the module it asks for. ` +
+                `Write ${current} instead: ${name}${suffix} becomes ${current}${suffix}.`,
+        ];
+    });
 }
 //# sourceMappingURL=composition.js.map

package/dist/composition.js.map

@@ -1 +1 @@
-{"version":3,"file":"composition.js","sourceRoot":"","sources":["../src/composition.ts"],"names":[],"mappings":"AA2IA,MAAM,UAAU,cAAc,CAAU,OAavC;IACC,MAAM,EACJ,KAAK,EACL,OAAO,EACP,UAAU,GAAG,EAAE,EACf,kBAAkB,GAAG,CAAC,UAAU,EAAE,gBAAgB,CAAC,EACnD,UAAU,GACX,GAAG,OAAO,CAAA;IAEX,MAAM,QAAQ,GAA8C,MAAM,CAAC,WAAW,CAC5E,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAChC,CAAA;IACD,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,UAAU,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAA;IAE7F,wEAAwE;IACxE,2EAA2E;IAC3E,4EAA4E;IAC5E,uDAAuD;IACvD,MAAM,eAAe,GAAG;QACtB,GAAG,IAAI,GAAG,CACR,CAAC,GAAG,YAAY,CAAC;aACd,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;aACnD,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CACzC;KACF,CAAA;IAED;;;;;;;OAOG;IACH,MAAM,kBAAkB,GAAG,CACzB,GAAsB,EAC2B,EAAE;QACnD,MAAM,QAAQ,GAAG,GAAG,CAAC,kBAAkB,EAAE,IAAI,EAAE,CAAA;QAC/C,IAAI,CAAC,QAAQ,IAAI,QAAQ,KAAK,KAAK,EAAE,CAAC;YACpC,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAA;QACtE,CAAC;QACD,MAAM,IAAI,GAAG,QAAQ;aAClB,KAAK,CAAC,GAAG,CAAC;aACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;aACpB,MAAM,CAAC,OAAO,CAAC;aACf,GAAG,CAAC,CAAC,KAAK,EAAmB,EAAE;YAC9B,uEAAuE;YACvE,qEAAqE;YACrE,4DAA4D;YAC5D,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;YAChC,IAAI,KAAK,KAAK,CAAC,CAAC;gBAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAA;YACxC,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAA;QACvF,CAAC,CAAC,CAAA;QACJ,MAAM,QAAQ,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAChE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAC7D,CAAA;QACD,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CACb,IAAI,KAAK,8BAA8B,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,qEAAqE,CAC3J,CAAA;QACH,CAAC;QACD,OAAO;YACL,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YAChD,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC;SAC5E,CAAA;IACH,CAAC,CAAA;IAED,4FAA4F;IAC5F,MAAM,aAAa,GAAG,CAAC,MAAyB,OAAO,CAAC,GAAG,EAAqB,EAAE,CAChF,kBAAkB,CAAC,GAAG,CAAC,CAAC,KAAK,CAAA;IAE/B,kEAAkE;IAClE,MAAM,gBAAgB,GAAG,CACvB,MAAiC,EACjC,MAA0B,EAC1B,aAAsB,EACJ,EAAE;QACpB,MAAM,UAAU,GAAG,MAAM,CAAC,QAAQ,CAAA;QAClC,IAAI,UAAU,EAAE,CAAC;YACf,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,aAAa,EAAE,CAAC,CAAA;YAC3E,OAAO;gBACL,MAAM,EAAE,MAAM,CAAC,IAAI;gBACnB,OAAO;gBACP,MAAM;gBACN,aAAa,EAAE,UAAU,CAAC,mBAAmB,CAAC,OAAO,CAAC;aACvD,CAAA;QACH,CAAC;QACD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,OAAO,CAAC,IAAI,CAAC,IAAI,KAAK,aAAa,MAAM,CAAC,IAAI,kCAAkC,MAAM,GAAG,CAAC,CAAA;QAC5F,CAAC;QACD,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,CAAA;IACrE,CAAC,CAAA;IAED,MAAM,WAAW,GAAG,CAClB,MAAyB,OAAO,CAAC,GAAG,EACpC,EAAE,aAAa,GAAG,KAAK,KAAyB,EAAE,EACpC,EAAE;QAChB,MAAM,QAAQ,GAAuB,EAAE,CAAA;QACvC,MAAM,OAAO,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,EAAkB,EAAE;YACnF,MAAM,SAAS,GAAG,gBAAgB,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,CAAA;YACzE,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;YACxB,MAAM,EAAE,OAAO,EAAE,GAAG,SAAS,CAAA;YAC7B,OAAO;gBACL,GAAG,EAAE,IAAI;gBACT,MAAM,EAAE;oBACN,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,aAAa,CAAC,GAAG,CAAC;oBACpC,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC;iBAC9C;aACF,CAAA;QACH,CAAC,CAAC,CAAA;QACF,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAA;IAC7C,CAAC,CAAA;IAED,MAAM,UAAU,GAAG,CAAC,GAAuB,EAAE,OAA4B,EAAoB,EAAE,CAC7F,WAAW,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,OAAO,CAAA;IAEnC,OAAO;QACL,YAAY;QACZ,aAAa;QACb,WAAW;QACX,UAAU;QACV,SAAS,CAAC,GAAG,EAAE,OAAO;YACpB,OAAO,EAAE,UAAU,EAAE,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,CAAA;QAChE,CAAC;QACD,UAAU,CAAC,OAAO,EAAE,MAAM;YACxB,OAAO,OAAO;iBACX,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;iBACtC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;QAC3E,CAAC;QACD,kBAAkB,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,UAAU,GAAG,EAAE;YACnD,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,YAAY,EAAE,GAAG,UAAU,CAAC,CAAC,CAAA;YACvD,qEAAqE;YACrE,wEAAwE;YACxE,2DAA2D;YAC3D,MAAM,eAAe,GAAG,CAAC,IAAY,EAAE,EAAE,CACvC,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,SAAS,GAAG,CAAC,CAAC,CAAA;YAClE,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,CACrC,CAAC,IAAI,EAAE,EAAE,CACP,eAAe,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;gBACzD,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC;gBAChB,CAAC,eAAe,CAAC,IAAI,CAAC;gBACtB,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAChE,CAAA;YACD,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;gBAC3B,OAAO,CAAC,IAAI,CACV,IAAI,KAAK,mCAAmC,IAAI,mCAAmC;oBACjF,mBAAmB,UAAU,CAAC,CAAC,CAAC,KAAK,UAAU,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,CAC7D,CAAA;YACH,CAAC;YACD,OAAO,OAAO,CAAA;QAChB,CAAC;QACD,gBAAgB,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG;YAChC,gEAAgE;YAChE,6CAA6C;YAC7C,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAA;YAClD,MAAM,QAAQ,GAAG;gBACf,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,mBAAmB,IAAI,oCAAoC,CAAC;gBACrF,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,YAAY,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;aACzE,CAAA;YACD,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;gBAC/B,OAAO,CAAC,IAAI,CAAC,IAAI,KAAK,KAAK,OAAO,EAAE,CAAC,CAAA;YACvC,CAAC;YACD,OAAO,QAAQ,CAAA;QACjB,CAAC;QACD,oBAAoB,CAAC,IAAI;YACvB,uEAAuE;YACvE,mDAAmD;YACnD,MAAM,QAAQ,GAAG,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAoB,EAAU,EAAE;gBACzE,IAAI,OAAO,KAAK,SAAS;oBAAE,OAAO,GAAG,MAAM,gBAAgB,CAAA;gBAC3D,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;oBACzB,OAAO,GAAG,MAAM,IAAI,OAAO,aAAa,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,SAAS,CAAA;gBAC1F,CAAC;gBACD,OAAO,GAAG,MAAM,IAAI,OAAO,KAAK,MAAM,GAAG,CAAA;YAC3C,CAAC,CAAA;YACD,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YACtD,MAAM,IAAI,GAAG,IAAI,KAAK,gBAAgB,OAAO,IAAI,mBAAmB,EAAE,CAAA;YACtE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YAClB,OAAO,IAAI,CAAA;QACb,CAAC;QACD,YAAY,CAAC,IAAI;YACf,MAAM,OAAO,GAAwB,EAAE,aAAa,EAAE,IAAI,CAAC,aAAa,EAAE,CAAA;YAC1E,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO;iBAC1B,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,YAAY,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC;iBAClF,MAAM,CAAC,CAAC,OAAO,EAAqB,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAA;YAC3D,OAAO,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;QAChE,CAAC;KACF,CAAA;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAkB;IACvD,OAAO,IAAI,CAAC,aAAa,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,aAAa,EAAE,EAAE,EAAE,CAAC,aAAa,CAAC,CAAA;AACxF,CAAC"}
+{"version":3,"file":"composition.js","sourceRoot":"","sources":["../src/composition.ts"],"names":[],"mappings":"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"}

package/dist/font-assets.d.ts

@@ -1,47 +1,26 @@
-import type { AppResourceCsp } from "@miragon/mcp-toolkit-core";
+import type { AppResourceCsp } from "./tool-registration.js";
 import type { HttpRouteHost } from "./health.js";
-/** A served file: its name under the route and its bytes. */
 export interface FontAsset {
     file: string;
     body: Uint8Array<ArrayBuffer>;
 }
-/** A year, and never revalidated: a new font release is a new URL. */
+/** Never revalidated: a new font release is a new URL. */
 export declare const FONT_CACHE_CONTROL = "public, max-age=31536000, immutable";
-/**
- * Where the `@fontsource-variable` packages keep the files, by served name.
- * `require.resolve` with literal specifiers, so the dependency stays visible
- * to the dead-code check; `font-assets.test.ts` holds the names equal to
- * {@link SERVED_FONT_FILES}.
- */
+/** Literal `require.resolve` specifiers keep the dependency visible to the dead-code check. */
 export declare function servedFontPaths(): Record<string, string>;
-/** The woff2 files, read once (boot). */
 export declare function loadServedFonts(paths?: () => Record<string, string>): FontAsset[];
-/** The answer for one file — a fresh `Response` per request (a body is read once). */
+/** A fresh `Response` per request: a body is read once. */
 export declare function fontResponse(body: Uint8Array<ArrayBuffer>): Response;
 export interface FontAssetsOptions {
-    /** Route prefix (default {@link SERVED_FONT_PATH} — the views load from there). */
     path?: string;
-    /** The files (default {@link loadServedFonts}). */
     load?: () => FontAsset[];
-    /** Log prefix for the warning when the files cannot be read (default `fonts`). */
     label?: string;
 }
-/**
- * Register `GET <path>/<file>` for each served font. Returns the registered
- * routes — none when the files cannot be read: the boot goes on with a
- * warning and the views render the host's font (Geist is cosmetic, never a
- * reason to refuse service).
- */
+/** Unreadable files only warn: Geist is cosmetic, never a reason to refuse service. */
 export declare function installFontAssets(server: HttpRouteHost, options?: FontAssetsOptions): string[];
 /**
- * The view CSP that admits the font origin explicitly: `MCP_URL`'s origin in
- * `resourceDomains` — the origin a view resolves its font URLs against
- * (`servedFontBaseUrl`). Handed to `createFrameworkApp` as `app.csp`, it
- * reaches `render-view` and every module widget tool (`honorWidgetMetaDefaults`),
- * on `resources/list` too, and the Apps SDK `openai/widgetCSP`. `undefined`
- * without `MCP_URL` (local dev): mcp-use still appends the request-resolved
- * server origin on every `resources/read`, which is where the view loads from.
- * Call it after `resolveHttpEdgePolicy` validated `MCP_URL`.
+ * `undefined` without `MCP_URL` (local dev): mcp-use still appends the request-resolved origin on
+ * every `resources/read`. Call it after `resolveHttpEdgePolicy` validated `MCP_URL`.
  */
 export declare function fontAssetsCsp(env: NodeJS.ProcessEnv): AppResourceCsp | undefined;
 //# sourceMappingURL=font-assets.d.ts.map

package/dist/font-assets.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"font-assets.d.ts","sourceRoot":"","sources":["../src/font-assets.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAGhD,6DAA6D;AAC7D,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,UAAU,CAAC,WAAW,CAAC,CAAA;CAC9B;AAED,sEAAsE;AACtE,eAAO,MAAM,kBAAkB,wCAAwC,CAAA;AAIvE;;;;;GAKG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAOxD;AAED,yCAAyC;AACzC,wBAAgB,eAAe,CAC7B,KAAK,GAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAmB,GACpD,SAAS,EAAE,CAEb;AAED,sFAAsF;AACtF,wBAAgB,YAAY,CAAC,IAAI,EAAE,UAAU,CAAC,WAAW,CAAC,GAAG,QAAQ,CAapE;AAED,MAAM,WAAW,iBAAiB;IAChC,mFAAmF;IACnF,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,mDAAmD;IACnD,IAAI,CAAC,EAAE,MAAM,SAAS,EAAE,CAAA;IACxB,kFAAkF;IAClF,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,aAAa,EACrB,OAAO,GAAE,iBAAsB,GAC9B,MAAM,EAAE,CAcV;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,GAAG,cAAc,GAAG,SAAS,CAGhF"}
+{"version":3,"file":"font-assets.d.ts","sourceRoot":"","sources":["../src/font-assets.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAGhD,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,UAAU,CAAC,WAAW,CAAC,CAAA;CAC9B;AAED,0DAA0D;AAC1D,eAAO,MAAM,kBAAkB,wCAAwC,CAAA;AAIvE,+FAA+F;AAC/F,wBAAgB,eAAe,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAOxD;AAED,wBAAgB,eAAe,CAC7B,KAAK,GAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAmB,GACpD,SAAS,EAAE,CAEb;AAED,2DAA2D;AAC3D,wBAAgB,YAAY,CAAC,IAAI,EAAE,UAAU,CAAC,WAAW,CAAC,GAAG,QAAQ,CAYpE;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,SAAS,EAAE,CAAA;IACxB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,uFAAuF;AACvF,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,aAAa,EACrB,OAAO,GAAE,iBAAsB,GAC9B,MAAM,EAAE,CAcV;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,GAAG,cAAc,GAAG,SAAS,CAGhF"}

package/dist/font-assets.js

@@ -1,65 +1,39 @@
 /**
- * The font route of a composed server (server path only): Geist and Geist
- * Mono as woff2, served by THIS server so the views render the Miragon type
- * without a CDN (design system §4: self-hosted, offline-capable, GDPR-safe)
- * and without inlining ~50 KB of base64 into every view resource.
- *
- * A view runs in the host's sandboxed iframe on a foreign origin, so the
- * files travel cross-origin: the response allows any origin (CORS, CORP —
- * public static files, no credentials), and the view's CSP must admit the
- * server's origin in `resourceDomains` (`fontAssetsCsp` + mcp-use's own
- * request-resolved append). The URL is versioned (`SERVED_FONT_PATH`), so the
- * files are cached `immutable` for a year. Where a host blocks the origin or
- * cannot reach the server, `font-display: swap` keeps the text in the host's
- * font, then the system's — nothing waits for the files.
- *
- * Registered after the HTTP edge guard (`installHttpEdgeGuard`): a font GET
- * passes the `Origin` half (safe method) but not a foreign `Host`, like every
- * other non-operational route.
+ * Geist woff2 served by THIS server: no CDN (self-hosted, GDPR-safe) and no ~50 KB base64 per view.
+ * Views load cross-origin from the host's sandbox, so the response allows any origin and the view
+ * CSP admits the server origin. If a host blocks it, `font-display: swap` keeps the host's font.
  */
 import { readFileSync } from "node:fs";
 import { createRequire } from "node:module";
-import { SERVED_FONT_FILES, SERVED_FONT_PATH } from "./served-fonts.js";
-/** A year, and never revalidated: a new font release is a new URL. */
+import { SERVED_FONT_FILES, SERVED_FONT_PATH } from "./protocol/served-fonts.js";
+/** Never revalidated: a new font release is a new URL. */
 export const FONT_CACHE_CONTROL = "public, max-age=31536000, immutable";
 const require = createRequire(import.meta.url);
-/**
- * Where the `@fontsource-variable` packages keep the files, by served name.
- * `require.resolve` with literal specifiers, so the dependency stays visible
- * to the dead-code check; `font-assets.test.ts` holds the names equal to
- * {@link SERVED_FONT_FILES}.
- */
+/** Literal `require.resolve` specifiers keep the dependency visible to the dead-code check. */
 export function servedFontPaths() {
     return {
         [SERVED_FONT_FILES.sans]: require.resolve("@fontsource-variable/geist/files/geist-latin-wght-normal.woff2"),
         [SERVED_FONT_FILES.mono]: require.resolve("@fontsource-variable/geist-mono/files/geist-mono-latin-wght-normal.woff2"),
     };
 }
-/** The woff2 files, read once (boot). */
 export function loadServedFonts(paths = servedFontPaths) {
     return Object.entries(paths()).map(([file, path]) => ({ file, body: readFileSync(path) }));
 }
-/** The answer for one file — a fresh `Response` per request (a body is read once). */
+/** A fresh `Response` per request: a body is read once. */
 export function fontResponse(body) {
     return new Response(body, {
         headers: {
             "content-type": "font/woff2",
             "content-length": String(body.byteLength),
             "cache-control": FONT_CACHE_CONTROL,
-            // Fonts are fetched in CORS mode from the view's sandboxed (often
-            // opaque, `null`) origin; public files, so any origin and no credentials.
+            // CORS from the view's sandboxed (often `null`) origin; public files, no credentials.
             "access-control-allow-origin": "*",
             "cross-origin-resource-policy": "cross-origin",
             "x-content-type-options": "nosniff",
         },
     });
 }
-/**
- * Register `GET <path>/<file>` for each served font. Returns the registered
- * routes — none when the files cannot be read: the boot goes on with a
- * warning and the views render the host's font (Geist is cosmetic, never a
- * reason to refuse service).
- */
+/** Unreadable files only warn: Geist is cosmetic, never a reason to refuse service. */
 export function installFontAssets(server, options = {}) {
     const { path = SERVED_FONT_PATH, load = loadServedFonts, label = "fonts" } = options;
     let assets;
@@ -77,14 +51,8 @@ export function installFontAssets(server, options = {}) {
     });
 }
 /**
- * The view CSP that admits the font origin explicitly: `MCP_URL`'s origin in
- * `resourceDomains` — the origin a view resolves its font URLs against
- * (`servedFontBaseUrl`). Handed to `createFrameworkApp` as `app.csp`, it
- * reaches `render-view` and every module widget tool (`honorWidgetMetaDefaults`),
- * on `resources/list` too, and the Apps SDK `openai/widgetCSP`. `undefined`
- * without `MCP_URL` (local dev): mcp-use still appends the request-resolved
- * server origin on every `resources/read`, which is where the view loads from.
- * Call it after `resolveHttpEdgePolicy` validated `MCP_URL`.
+ * `undefined` without `MCP_URL` (local dev): mcp-use still appends the request-resolved origin on
+ * every `resources/read`. Call it after `resolveHttpEdgePolicy` validated `MCP_URL`.
  */
 export function fontAssetsCsp(env) {
     const url = env.MCP_URL?.trim();

package/dist/font-assets.js.map

@@ -1 +1 @@
-{"version":3,"file":"font-assets.js","sourceRoot":"","sources":["../src/font-assets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAG3C,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AAQvE,sEAAsE;AACtE,MAAM,CAAC,MAAM,kBAAkB,GAAG,qCAAqC,CAAA;AAEvE,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;AAE9C;;;;;GAKG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO;QACL,CAAC,iBAAiB,CAAC,IAAI,CAAC,EACtB,OAAO,CAAC,OAAO,CAAC,gEAAgE,CAAC;QACnF,CAAC,iBAAiB,CAAC,IAAI,CAAC,EACtB,OAAO,CAAC,OAAO,CAAC,0EAA0E,CAAC;KAC9F,CAAA;AACH,CAAC;AAED,yCAAyC;AACzC,MAAM,UAAU,eAAe,CAC7B,QAAsC,eAAe;IAErD,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAA;AAC5F,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,YAAY,CAAC,IAA6B;IACxD,OAAO,IAAI,QAAQ,CAAC,IAAI,EAAE;QACxB,OAAO,EAAE;YACP,cAAc,EAAE,YAAY;YAC5B,gBAAgB,EAAE,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC;YACzC,eAAe,EAAE,kBAAkB;YACnC,kEAAkE;YAClE,0EAA0E;YAC1E,6BAA6B,EAAE,GAAG;YAClC,8BAA8B,EAAE,cAAc;YAC9C,wBAAwB,EAAE,SAAS;SACpC;KACF,CAAC,CAAA;AACJ,CAAC;AAWD;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAC/B,MAAqB,EACrB,UAA6B,EAAE;IAE/B,MAAM,EAAE,IAAI,GAAG,gBAAgB,EAAE,IAAI,GAAG,eAAe,EAAE,KAAK,GAAG,OAAO,EAAE,GAAG,OAAO,CAAA;IACpF,IAAI,MAAmB,CAAA;IACvB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,EAAE,CAAA;IACjB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,IAAI,CAAC,IAAI,KAAK,oDAAoD,EAAE,KAAK,CAAC,CAAA;QAClF,OAAO,EAAE,CAAA;IACX,CAAC;IACD,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE;QACnC,MAAM,KAAK,GAAG,GAAG,IAAI,IAAI,IAAI,EAAE,CAAA;QAC/B,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAA;QAC3C,OAAO,KAAK,CAAA;IACd,CAAC,CAAC,CAAA;AACJ,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,aAAa,CAAC,GAAsB;IAClD,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,EAAE,IAAI,EAAE,CAAA;IAC/B,OAAO,GAAG,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAA;AACrE,CAAC"}
+{"version":3,"file":"font-assets.js","sourceRoot":"","sources":["../src/font-assets.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAG3C,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAA;AAOhF,0DAA0D;AAC1D,MAAM,CAAC,MAAM,kBAAkB,GAAG,qCAAqC,CAAA;AAEvE,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;AAE9C,+FAA+F;AAC/F,MAAM,UAAU,eAAe;IAC7B,OAAO;QACL,CAAC,iBAAiB,CAAC,IAAI,CAAC,EACtB,OAAO,CAAC,OAAO,CAAC,gEAAgE,CAAC;QACnF,CAAC,iBAAiB,CAAC,IAAI,CAAC,EACtB,OAAO,CAAC,OAAO,CAAC,0EAA0E,CAAC;KAC9F,CAAA;AACH,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,QAAsC,eAAe;IAErD,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAA;AAC5F,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,YAAY,CAAC,IAA6B;IACxD,OAAO,IAAI,QAAQ,CAAC,IAAI,EAAE;QACxB,OAAO,EAAE;YACP,cAAc,EAAE,YAAY;YAC5B,gBAAgB,EAAE,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC;YACzC,eAAe,EAAE,kBAAkB;YACnC,sFAAsF;YACtF,6BAA6B,EAAE,GAAG;YAClC,8BAA8B,EAAE,cAAc;YAC9C,wBAAwB,EAAE,SAAS;SACpC;KACF,CAAC,CAAA;AACJ,CAAC;AAQD,uFAAuF;AACvF,MAAM,UAAU,iBAAiB,CAC/B,MAAqB,EACrB,UAA6B,EAAE;IAE/B,MAAM,EAAE,IAAI,GAAG,gBAAgB,EAAE,IAAI,GAAG,eAAe,EAAE,KAAK,GAAG,OAAO,EAAE,GAAG,OAAO,CAAA;IACpF,IAAI,MAAmB,CAAA;IACvB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,EAAE,CAAA;IACjB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,IAAI,CAAC,IAAI,KAAK,oDAAoD,EAAE,KAAK,CAAC,CAAA;QAClF,OAAO,EAAE,CAAA;IACX,CAAC;IACD,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE;QACnC,MAAM,KAAK,GAAG,GAAG,IAAI,IAAI,IAAI,EAAE,CAAA;QAC/B,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAA;QAC3C,OAAO,KAAK,CAAA;IACd,CAAC,CAAC,CAAA;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,GAAsB;IAClD,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,EAAE,IAAI,EAAE,CAAA;IAC/B,OAAO,GAAG,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAA;AACrE,CAAC"}

package/dist/health.d.ts

@@ -1,59 +1,23 @@
 /**
- * HTTP health endpoints for composed-server hosts (server path only).
- *
- * Kubernetes-style split: `<path>/live` answers as soon as the process serves
- * HTTP (only a wedged event loop fails it); `<path>/ready` additionally runs
- * the host's readiness checks — the server's OWN dependencies (the profile/
- * dashboard database), deliberately never the engines or Prometheus: those
- * are upstreams whose outages the tools report as error results, and taking
- * the server out of rotation for them would turn a visible error into a
- * silent absence. The bare `<path>` aliases readiness for probes that know
- * only one URL (Docker HEALTHCHECK, Fly, Compose `service_healthy`).
- *
- * Outside mcp-use's OAuth gate by construction: the bearer check is scoped
- * to the MCP base path, so probes need no token.
- */
-/**
- * The narrow structural route surface (`server.get(path, handler)`) — hosts
- * pass an `MCPServer` without this module importing mcp-use or hono. Handlers
- * return Web-standard `Response`s, which hono passes through untouched.
+ * Readiness checks the server's OWN dependencies only: engine or Prometheus outages are reported by
+ * the tools, and pulling the server out of rotation would turn a visible error into a silent absence.
+ * The bare `<path>` aliases readiness for single-URL probes. Outside the OAuth gate, so no token.
  */
+/** Structural, so hosts pass an `MCPServer` without this module importing mcp-use or hono. */
 export interface HttpRouteHost {
     get(path: string, handler: (ctx: unknown) => Response | Promise<Response>): unknown;
 }
-/** Resolves when the dependency is usable; throws or rejects when it is not. */
-export type ReadinessCheck = () => void | Promise<void>;
+type ReadinessCheck = () => void | Promise<void>;
 export interface HealthOptions {
-    /** Route prefix (default `/health` → `/health`, `/health/live`, `/health/ready`). */
     path?: string;
-    /** Named readiness checks; every one must pass for `ready` to answer 200. */
     readiness?: Record<string, ReadinessCheck>;
-    /** Per-check budget in ms (default 2000) — a hung dependency must fail the probe, not hang it. */
+    /** A hung dependency must fail the probe, not hang it. */
     timeoutMs?: number;
-    /** Log prefix for failed checks (default `health`). */
     label?: string;
-    /**
-     * True once the host is shutting down: readiness then answers 503
-     * `draining` (liveness stays 200), so a load balancer stops routing new
-     * traffic while in-flight requests finish.
-     */
+    /** Readiness then answers 503 `draining` so a load balancer stops routing while requests finish. */
     draining?: () => boolean;
 }
-export type HealthStatus = "up" | "down";
-/** The readiness body: the overall verdict plus one entry per check. */
-export interface HealthReport {
-    /** `draining` while the host shuts down, whatever the checks say. */
-    status: HealthStatus | "draining";
-    checks: Record<string, HealthStatus>;
-}
-/**
- * Register `<path>/live`, `<path>/ready` and `<path>` (= ready). Readiness
- * answers 200 with `{ status: "up", checks }` or 503 with `status: "down"`
- * and the failing checks marked (`status: "draining"` once `draining()`
- * holds); the checks run in parallel, each under
- * `timeoutMs`. Register `installMetrics` first if probe traffic should show
- * up in the HTTP metrics (hono only wraps routes registered after the
- * middleware).
- */
+/** Register `installMetrics` first if probe traffic should be counted. */
 export declare function installHealthEndpoints(server: HttpRouteHost, options?: HealthOptions): void;
+export {};
 //# sourceMappingURL=health.d.ts.map

package/dist/health.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../src/health.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAA;CACpF;AAED,gFAAgF;AAChF,MAAM,MAAM,cAAc,GAAG,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;AAEvD,MAAM,WAAW,aAAa;IAC5B,qFAAqF;IACrF,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,6EAA6E;IAC7E,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAA;IAC1C,kGAAkG;IAClG,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,uDAAuD;IACvD,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAA;CACzB;AAED,MAAM,MAAM,YAAY,GAAG,IAAI,GAAG,MAAM,CAAA;AAExC,wEAAwE;AACxE,MAAM,WAAW,YAAY;IAC3B,qEAAqE;IACrE,MAAM,EAAE,YAAY,GAAG,UAAU,CAAA;IACjC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;CACrC;AA2CD;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,GAAE,aAAkB,GAAG,IAAI,CAmB/F"}
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../src/health.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,8FAA8F;AAC9F,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAA;CACpF;AAED,KAAK,cAAc,GAAG,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;AAEhD,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAA;IAC1C,0DAA0D;IAC1D,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,oGAAoG;IACpG,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAA;CACzB;AAkDD,0EAA0E;AAC1E,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,GAAE,aAAkB,GAAG,IAAI,CAmB/F"}