@confluentinc/mcp-confluent 1.3.0 → 1.5.0

package/dist/index.js

@@ -1,321 +1,98 @@
 #!/usr/bin/env node
-import { DisplayedCommandLineUsageError, getFilteredToolNames, getPackageVersion, loadDotEnvFile, parseCliArgs, } from "./cli.js";
-import { buildConfigFromEnvAndCli, loadConfigFromYaml, } from "./config/index.js";
-import { buildConfigTelemetry } from "./confluent/config-telemetry.js";
-import { buildConfig, fs, path } from "./confluent/node-deps.js";
-import { TelemetryEvent, TelemetryService } from "./confluent/telemetry.js";
-import { groupDisabledToolsByReason } from "./confluent/tools/tool-availability.js";
-import { ToolName } from "./confluent/tools/tool-name.js";
-import { ToolHandlerRegistry } from "./confluent/tools/tool-registry.js";
-import { initEnv } from "./env.js";
-import { logger, setLogLevel } from "./logger.js";
-import { generateApiKey, TransportManager } from "./mcp/transports/index.js";
-import { ServerRuntime } from "./server-runtime.js";
 /**
- * Determine the subset of ToolHandlers to register based on the filtered tool names
- * and which connections satisfy each tool's service requirements.
- **/
-export function getToolHandlersToRegister(filteredToolNames, runtime) {
-    const toolHandlers = new Map();
-    const knownIds = new Set(Object.keys(runtime.config.connections));
-    // Pass 1: drop tools excluded by the allow/block list (logged per-tool —
-    // the reason is config-driven, not predicate-driven, so it doesn't fold
-    // into the grouped warning emitted later).
-    const candidates = [];
-    for (const toolName of Object.values(ToolName)) {
-        if (!filteredToolNames.includes(toolName)) {
-            logger.warn(`Tool ${toolName} disabled due to allow/block list rules`);
-            continue;
-        }
-        candidates.push([toolName, ToolHandlerRegistry.getToolHandler(toolName)]);
-    }
-    // Pass 2: register tools that are enabled on at least one connection.
-    for (const [toolName, handler] of candidates) {
-        const enabledIds = handler.enabledConnectionIds(runtime);
-        const unknownIds = enabledIds.filter((id) => !knownIds.has(id));
-        if (unknownIds.length > 0) {
-            throw new Error(`Tool ${toolName}: enabledConnectionIds() returned unknown connection ID(s): ${unknownIds.join(", ")}`);
-        }
-        if (enabledIds.length > 0) {
-            toolHandlers.set(toolName, handler);
-            logger.info(`Tool ${toolName} enabled`);
-        }
-    }
-    // Pass 3: emit one grouped warning per (connectionId, reason) for tools
-    // that are fully disabled — readers see the missing config piece and the
-    // list of all tools blocked by it in a single line, rather than one
-    // line per tool.
-    for (const group of groupDisabledToolsByReason(candidates, runtime)) {
-        logger.warn(`Tools disabled on connection '${group.connectionId}' — ${group.reason}: ${group.toolNames.join(", ")}`);
-    }
-    // Raise an error if no tools are enabled, as the server would be non-functional without any tools.
-    if (toolHandlers.size === 0) {
-        throw new Error("No tools enabled. Please check your configuration and environment variables.");
-    }
-    return toolHandlers;
-}
-/**
- * Resolve the Segment write key handed to `TelemetryService.initialize`.
+ * Preflight shim — the package's `bin` entry point.
  *
- * Precedence: an explicit YAML `server.analytics.write_key` wins; otherwise
- * fall back to `buildConfig.TELEMETRY_WRITE_KEY` (the value `npm pack` injects
- * at release time). On unpacked / dev builds the build-time value is empty,
- * so an absent YAML field produces an empty-string fallback that
- * `TelemetryService` treats as "no key supplied" — analytics stays off.
+ * WHY THIS IS A SEPARATE FILE (and not just a check at the top of the real
+ * entry, `server-main.ts`):
  *
- * Extracted from `main()` so the precedence is unit-testable without booting
- * the full server.
- */
-export function resolveTelemetryWriteKey(mcpConfig) {
-    return (mcpConfig.server.analytics?.write_key ?? buildConfig.TELEMETRY_WRITE_KEY);
-}
-export function outputApiKey() {
-    const apiKey = generateApiKey();
-    console.log("\nGenerated MCP API Key:");
-    console.log("=".repeat(64));
-    console.log(apiKey);
-    console.log("=".repeat(64));
-    console.log("\nAdd this to your .env file:");
-    console.log(`MCP_API_KEY=${apiKey}\n`);
-}
-/**
- * Bootstrap a starter `config.yaml` in the current working directory by
- * copying one of the bundled example templates, then ensure the new file
- * is listed in `<cwd>/.gitignore` so credentials filled in later don't
- * slip into git.
+ * The server's module graph uses syntax that newer Node parses but older Node
+ * does not — most notably the JSON import attribute `import pkg from
+ * "../package.json" with { type: "json" }` in cli.ts. In ESM, the *entire*
+ * static import graph is parsed and instantiated before a single statement
+ * runs. So on an unsupported old runtime, `server-main.ts` → `cli.ts` blows up
+ * with a raw `SyntaxError` pointing at a line deep inside our dist output —
+ * before any code of ours could run, and therefore before any version check
+ * we placed inside the server could fire. That is exactly what issue #455
+ * reported: `npx mcp-confluent` dumping an inscrutable parser stack trace
+ * instead of "you need a newer Node".
  *
- * Resolved relative to `import.meta.url` (the compiled `dist/index.js`)
- * so this keeps working when invoked via `npx`, where `process.cwd()`
- * is the user's project but the example file lives next to the install.
+ * The only way to win this race is to make the FIRST module Node loads contain
+ * nothing it can't parse, do the version check there, and reach the real
+ * server only through a *dynamic* `import()` — which defers parsing of the
+ * modern-syntax graph until after the gate has passed (or bailed with a clear
+ * message). This file, and the `preflight.ts` it statically imports, are
+ * deliberately written in syntax that parses back to very old Node so the
+ * friendly error survives where the server graph cannot.
  *
- * Refuses to overwrite an existing destination so an accidental rerun
- * cannot wipe credentials the user already filled in. The write uses
- * `wx` (exclusive create) so the existence check and the create happen
- * as a single syscall — there is no TOCTOU window where another process
- * could create the file between a precheck and the write.
+ * If you're a new dev wondering why this indirection exists at all: it's the
+ * difference between a user seeing "mcp-confluent requires Node.js 22.19.0 or
+ * newer" and a user seeing a JSON-import-attribute parse error from a file
+ * they've never heard of. Don't fold this back into server-main.ts. See issue
+ * #455 for the original report.
  *
- * @param oauth When true, copy `config.oauth.example.yaml` (the minimal
- *   OAuth template); when false, copy `config.example.yaml` (the
- *   fully-annotated direct/api-key template). The CLI flag in the EEXIST
- *   error message is selected to match.
+ * This protection depends on the build staying a transpile (tsc emits one .js
+ * per .ts, preserving the dynamic-import boundary), NOT a bundle. A bundler
+ * that inlined the server graph into this entry file would drag the
+ * modern-syntax imports back into the first-parsed module and silently undo
+ * everything above. If you ever add a bundling step, keep this shim (and
+ * preflight.ts) out of it.
  */
-export function outputInitConfig(oauth = false) {
-    const sourceFileName = oauth
-        ? "config.oauth.example.yaml"
-        : "config.example.yaml";
-    const flagName = oauth ? "init-oauth-config" : "init-config";
-    const sourceUrl = new URL(`../${sourceFileName}`, import.meta.url);
-    const destPath = path.resolve("config.yaml");
-    const contents = fs.readFileSync(sourceUrl, "utf-8");
-    try {
-        fs.writeFileSync(destPath, contents, { flag: "wx" });
-    }
-    catch (err) {
-        if (err.code === "EEXIST") {
-            throw new Error(`config.yaml already exists at ${destPath}. ` +
-                `Remove or rename it before running --${flagName}.`);
-        }
-        throw err;
-    }
-    const gitignoreNote = ensureGitignoreEntry(destPath);
-    console.log(`wrote ./config.yaml (${gitignoreNote})`);
-    // OAuth has no credentials to edit; the bundled template is already
-    // runnable as-is. The api-key template, by contrast, ships placeholder
-    // values the user must fill in before the server can connect.
-    console.log(oauth
-        ? `Next: run with --config ./config.yaml`
-        : `Next: edit credentials in config.yaml and run with --config ./config.yaml`);
-}
+import { MINIMUM_NODE_VERSION, nodeVersionError } from "./preflight.js";
 /**
- * Ensure the basename of `filePath` is listed in `<dirname(filePath)>/.gitignore`.
- * Creates the gitignore if missing; appends idempotently if present (matching
- * trimmed lines verbatim — `*.yaml` globs or `/config.yaml` anchors are not
- * recognized, so a user who already wrote either form will see a duplicate
- * `config.yaml` entry, which is harmless).
+ * Gate on the Node.js runtime version, then hand off to the real server entry.
  *
- * @returns A short note describing what happened, suitable for the success message.
- */
-function ensureGitignoreEntry(filePath) {
-    const dir = path.dirname(filePath);
-    const fileName = path.basename(filePath);
-    const gitignorePath = path.join(dir, ".gitignore");
-    if (!fs.existsSync(gitignorePath)) {
-        fs.writeFileSync(gitignorePath, `${fileName}\n`);
-        return "added to .gitignore";
-    }
-    const existing = fs.readFileSync(gitignorePath, "utf-8");
-    const alreadyListed = existing
-        .split("\n")
-        .some((line) => line.trim() === fileName);
-    if (alreadyListed) {
-        return ".gitignore already excludes it";
-    }
-    const prefix = existing.length > 0 && !existing.endsWith("\n") ? "\n" : "";
-    fs.appendFileSync(gitignorePath, `${prefix}${fileName}\n`);
-    return "added to .gitignore";
-}
-export function outputToolList(filteredToolNames) {
-    const MAX_DESC_LENGTH = 120;
-    filteredToolNames.forEach((toolName) => {
-        const config = ToolHandlerRegistry.getToolConfig(toolName);
-        let desc = config.description.replaceAll(/\s+/g, " ").trim();
-        if (desc.length > MAX_DESC_LENGTH) {
-            desc = desc.slice(0, MAX_DESC_LENGTH - 3) + "...";
-        }
-        console.log(`\x1b[32m${config.name}\x1b[0m: ${desc}`);
-    });
-}
-/**
- * Dispatch the CLI's mutually-exclusive early-exit modes — generate-key,
- * init-config, init-oauth-config, and list-tools — before the server
- * bootstrap begins. Returns `{ handled: false }` when none apply, in
- * which case the caller continues with normal startup.
+ * Returns early (after printing the upgrade message and calling `exit(1)`) on an
+ * unsupported runtime; otherwise dynamically imports `server-main.ts`, which
+ * starts the server as a side effect of its own module-load (`await main()`).
+ * The dynamic import is load-bearing, not stylistic — it is what keeps the
+ * modern-syntax server graph from being parsed on a runtime that can't parse it
+ * (see the file-level comment above).
  *
- * On init-config failure, the friendly error message is returned in
- * `stderr` rather than written here, so the caller controls writing to
- * stderr and exiting.
+ * `exit` and `loadAndRunServer` are injected (defaulting to the real primitives)
+ * so the dispatch is unit-testable without spawning a subprocess or stubbing
+ * `process.exit`. The callback both loads and runs the server because importing
+ * `server-main.ts` triggers its top-level `await main()`.
+ *
+ * A failure to load or start the server (a rejected dynamic import, a throw from
+ * `main()`) is caught here and turned into `console.error` + `exit(1)` rather
+ * than allowed to propagate: the module-level trigger discards this promise, so
+ * a rejection would otherwise surface as an unhandled rejection with
+ * nondeterministic exit behavior.
  */
-export function handleEarlyExits(cliOptions) {
-    if (cliOptions.generateKey) {
-        outputApiKey();
-        return { handled: true, exitCode: 0 };
-    }
-    if (cliOptions.initConfig) {
-        return runOutputInitConfig(false);
-    }
-    if (cliOptions.initOauthConfig) {
-        return runOutputInitConfig(true);
-    }
-    if (cliOptions.listTools) {
-        outputToolList(getFilteredToolNames(cliOptions.allowTools ?? [], cliOptions.blockTools ?? []));
-        return { handled: true, exitCode: 0 };
-    }
-    return { handled: false };
-}
-function runOutputInitConfig(oauth) {
+export async function bootstrap({ currentVersion = process.versions.node, exit = (code) => process.exit(code), 
+// Relative specifier, not the `@src/*` alias used elsewhere: this is the
+// published `bin`, and its one runtime handoff shouldn't depend on tsc-alias
+// having rewritten a *dynamic* `import()` at build time.
+loadAndRunServer = () => import("./server-main.js"), } = {}) {
+    const versionError = nodeVersionError(currentVersion, MINIMUM_NODE_VERSION);
+    if (versionError) {
+        // Whoops! User is on an old Node. Print the specific version issue message and exit(1).
+        console.error(versionError);
+        exit(1);
+        return;
+    }
+    // All good — load and invoke the real server entry (the module-level await main() over in server-main.ts).
     try {
-        outputInitConfig(oauth);
-        return { handled: true, exitCode: 0 };
+        await loadAndRunServer();
     }
     catch (error) {
-        const msg = error instanceof Error ? error.message : String(error);
-        const flag = oauth ? "--init-oauth-config" : "--init-config";
-        return { handled: true, exitCode: 1, stderr: `${flag} failed: ${msg}` };
-    }
-}
-async function main() {
-    try {
-        // Parse command line arguments.(NO LONGER LOADS ENV VARS FROM -e file!)
-        const cliOptions = parseCliArgs(process.argv);
-        const earlyExit = handleEarlyExits(cliOptions);
-        if (earlyExit.handled) {
-            if (earlyExit.exitCode === 1) {
-                console.error(earlyExit.stderr);
-            }
-            process.exit(earlyExit.exitCode);
-        }
-        const filteredToolNames = getFilteredToolNames(cliOptions.allowTools ?? [], cliOptions.blockTools ?? []);
-        if (cliOptions.envFile) {
-            loadDotEnvFile(cliOptions.envFile);
-        }
-        // Convert our known env vars into a typed Environment obj.
-        const env = initEnv();
-        let mcpConfig;
-        // Load and validate configuration — from YAML file if --config provided, else from env vars + CLI overrides.
-        if (cliOptions.config) {
-            mcpConfig = loadConfigFromYaml(cliOptions.config, process.env);
-        }
-        else {
-            mcpConfig = buildConfigFromEnvAndCli(env, {
-                disableAuth: cliOptions.disableAuth,
-                allowedHosts: cliOptions.allowedHosts,
-                kafkaConfig: cliOptions.kafkaConfig,
-                oauth: cliOptions.oauth,
-                ccloudEnv: cliOptions.ccloudEnv,
-            });
-        }
-        setLogLevel(mcpConfig.server.log_level);
-        // Transport selection: YAML config is authoritative when --config is used;
-        // CLI flag (or its default) is used on the env-var path.
-        const transports = cliOptions.config
-            ? mcpConfig.server.transports
-            : cliOptions.transports;
-        // DO_NOT_TRACK is a cross-tool user preference (consoledonottrack.com);
-        // the env var acts as a floor so it is honored even when --config is used.
-        TelemetryService.initialize({
-            doNotTrack: mcpConfig.server.do_not_track || env.DO_NOT_TRACK,
-            writeKey: resolveTelemetryWriteKey(mcpConfig),
-        });
-        const telemetry = TelemetryService.getInstance();
-        logger.info(`${mcpConfig.getConnectionNames().length} connections loaded successfully`);
-        const runtime = ServerRuntime.fromConfig(mcpConfig);
-        const serverVersion = getPackageVersion();
-        telemetry.setCommonProperties({ serverVersion });
-        const toolHandlers = getToolHandlersToRegister(filteredToolNames, runtime);
-        logger.info({ enabledTools: [...toolHandlers.keys()] }, `${toolHandlers.size} tool(s) enabled`);
-        // Warn if auth is disabled
-        if (mcpConfig.server.auth.disabled) {
-            logger.warn("Authentication is DISABLED for HTTP/SSE transports. " +
-                "This should only be used in development environments.");
-        }
-        const transportManager = new TransportManager({
-            disableAuth: mcpConfig.server.auth.disabled,
-            allowedHosts: mcpConfig.server.auth.allowed_hosts,
-            apiKey: mcpConfig.server.auth.api_key,
-        });
-        const serverOptions = {
-            serverVersion,
-            toolHandlers,
-            runtime,
-            track: (props) => telemetry.track(TelemetryEvent.TOOL_CALL, {
-                ...props,
-            }),
-        };
-        // Start all transports with a single call
-        logger.info(`Starting transports: ${transports.join(", ")}`);
-        await transportManager.start({
-            serverOptions,
-            types: transports,
-            http: {
-                port: mcpConfig.server.http.port,
-                host: mcpConfig.server.http.host,
-                mcpEndpointPath: mcpConfig.server.http.mcp_endpoint,
-                sseEndpointPath: mcpConfig.server.http.sse_endpoint,
-                sseMessageEndpointPath: mcpConfig.server.http.sse_message_endpoint,
-            },
-        });
-        // Boot-time invariants (config source, active transports, connection
-        // types) ride this one-shot event rather than every TOOL_CALL — they
-        // don't change after startup, so duplicating them per tool call buys
-        // nothing. Warehouse queries join SERVER_START to TOOL_CALL on
-        // `serverSessionId` (a common property) when slicing is needed.
-        telemetry.track(TelemetryEvent.SERVER_START, {
-            ...buildConfigTelemetry(cliOptions, mcpConfig, transports),
-        });
-        // Set up cleanup handlers
-        const performCleanup = async () => {
-            logger.info("Shutting down...");
-            await telemetry.shutdown();
-            await transportManager.stop();
-            // shutdown() is race-safe with an in-flight bootstrap.
-            runtime.oauthHolder?.shutdown();
-            await runtime.clientManager.disconnect();
-            process.exit(0);
-        };
-        process.on("SIGINT", performCleanup);
-        process.on("SIGTERM", performCleanup);
-        process.on("SIGQUIT", performCleanup);
-        process.on("SIGUSR2", performCleanup);
-    }
-    catch (error) {
-        if (error instanceof DisplayedCommandLineUsageError) {
-            process.exit(0);
-        }
-        logger.error({ err: error }, "Error starting server");
-        process.exit(1);
+        console.error(error);
+        exit(1);
     }
 }
+// Call `bootstrap()` directly, NOT `await bootstrap()`. Top-level await is
+// itself modern syntax that older Node fails to *parse* — using it here would
+// reintroduce the very parse-time crash this shim exists to prevent, defeating
+// the whole point. `bootstrap()` does its own awaiting internally and handles
+// its own failures (see its docstring), then the process stays alive on the
+// transports the server starts. The `.catch` is a final backstop: any
+// unforeseen rejection still exits deterministically rather than becoming an
+// unhandled promise rejection. (`.catch` + arrow parse fine on ancient Node;
+// only top-level await does not.)
 if (process.env.NODE_ENV !== "test") {
-    await main();
+    bootstrap().catch((error) => {
+        console.error(error);
+        process.exit(1);
+    });
 }
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAEH,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAE3E;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,EAC9B,cAAc,GAAG,OAAO,CAAC,QAAQ,CAAC,IAAI,EACtC,IAAI,GAAG,CAAC,IAAY,EAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;AACjD,yEAAyE;AACzE,6EAA6E;AAC7E,yDAAyD;AACzD,gBAAgB,GAAG,GAAqB,EAAE,CAAC,MAAM,CAAC,kBAAkB,CAAC,MAKnE,EAAE;IACJ,MAAM,YAAY,GAAG,gBAAgB,CAAC,cAAc,EAAE,oBAAoB,CAAC,CAAC;IAC5E,IAAI,YAAY,EAAE,CAAC;QACjB,wFAAwF;QACxF,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QAC5B,IAAI,CAAC,CAAC,CAAC,CAAC;QACR,OAAO;IACT,CAAC;IAED,2GAA2G;IAC3G,IAAI,CAAC;QACH,MAAM,gBAAgB,EAAE,CAAC;IAC3B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACrB,IAAI,CAAC,CAAC,CAAC,CAAC;IACV,CAAC;AACH,CAAC;AAED,2EAA2E;AAC3E,8EAA8E;AAC9E,+EAA+E;AAC/E,8EAA8E;AAC9E,4EAA4E;AAC5E,sEAAsE;AACtE,6EAA6E;AAC7E,6EAA6E;AAC7E,kCAAkC;AAClC,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,MAAM,EAAE,CAAC;IACpC,SAAS,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;QAC1B,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACrB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/lazy.d.ts

@@ -56,8 +56,10 @@ export declare class AsyncLazy<T> {
      */
     get(): Promise<T>;
     /**
-     * Closes and cleans up the lazy-loaded instance if it exists
-     * If a closeHandler was provided, it will be called with the instance
+     * Closes and cleans up the lazy-loaded instance if it exists.
+     * If a closeHandler was provided, it will be called with the instance.
+     * The instance and any cached initialization promise are reset afterward,
+     * so the next get() rebuilds.
      * @returns A promise that resolves when the cleanup is complete
      */
     close(): Promise<void>;

package/dist/lazy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lazy.d.ts","sourceRoot":"","sources":["../src/lazy.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,qBAAa,IAAI,CAAC,CAAC;IACjB,qDAAqD;IACrD,OAAO,CAAC,QAAQ,CAAgB;IAEhC,6DAA6D;IAC7D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAU;IAEnC,4DAA4D;IAC5D,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAwB;IAEtD;;;;OAIG;gBACS,QAAQ,EAAE,MAAM,CAAC,EAAE,YAAY,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,IAAI;IAKnE;;;;OAIG;IACH,GAAG,IAAI,CAAC;IAYR;;;;OAIG;IACH,KAAK,IAAI,IAAI;CAYd;AAED;;;;GAIG;AACH,qBAAa,SAAS,CAAC,CAAC;IACtB,qDAAqD;IACrD,OAAO,CAAC,QAAQ,CAAgB;IAEhC,6DAA6D;IAC7D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmB;IAE5C,4DAA4D;IAC5D,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAiC;IAE/D,iGAAiG;IACjG,OAAO,CAAC,qBAAqB,CAA2B;IAExD;;;;OAIG;gBAED,QAAQ,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC1B,YAAY,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC;IAM/C;;;;OAIG;IACG,GAAG,IAAI,OAAO,CAAC,CAAC,CAAC;IAavB;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAW7B"}
+{"version":3,"file":"lazy.d.ts","sourceRoot":"","sources":["../src/lazy.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,qBAAa,IAAI,CAAC,CAAC;IACjB,qDAAqD;IACrD,OAAO,CAAC,QAAQ,CAAgB;IAEhC,6DAA6D;IAC7D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAU;IAEnC,4DAA4D;IAC5D,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAwB;IAEtD;;;;OAIG;gBACS,QAAQ,EAAE,MAAM,CAAC,EAAE,YAAY,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,IAAI;IAKnE;;;;OAIG;IACH,GAAG,IAAI,CAAC;IAcR;;;;OAIG;IACH,KAAK,IAAI,IAAI;CAYd;AAED;;;;GAIG;AACH,qBAAa,SAAS,CAAC,CAAC;IACtB,qDAAqD;IACrD,OAAO,CAAC,QAAQ,CAAgB;IAEhC,6DAA6D;IAC7D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmB;IAE5C,4DAA4D;IAC5D,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAiC;IAE/D,iGAAiG;IACjG,OAAO,CAAC,qBAAqB,CAA2B;IAExD;;;;OAIG;gBAED,QAAQ,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC1B,YAAY,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC;IAM/C;;;;OAIG;IACG,GAAG,IAAI,OAAO,CAAC,CAAC,CAAC;IAqBvB;;;;;;OAMG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAa7B"}

package/dist/lazy.js

@@ -26,12 +26,14 @@ export class Lazy {
      * @throws If the supplier function fails to initialize the value
      */
     get() {
-        try {
-            this.instance = this.supplier();
-            logger.debug(`Lazy instance created with type ${this.instance?.constructor.name || typeof this.instance}`);
-        }
-        catch (error) {
-            throw new Error(`Failed to initialize lazy instance: ${error}`);
+        if (this.instance === undefined) {
+            try {
+                this.instance = this.supplier();
+                logger.debug(`Lazy instance created with type ${this.instance?.constructor.name || typeof this.instance}`);
+            }
+            catch (error) {
+                throw new Error(`Failed to initialize lazy instance: ${error}`);
+            }
         }
         return this.instance;
     }
@@ -41,7 +43,7 @@ export class Lazy {
      * The instance is set to undefined after cleanup.
      */
     close() {
-        if (this.instance) {
+        if (this.instance !== undefined) {
             if (this.closeHandler) {
                 logger.debug(`Initiating close handler for lazy instance of type ${typeof this.instance}`);
                 this.closeHandler(this.instance);
@@ -80,27 +82,40 @@ export class AsyncLazy {
      * @throws If the supplier function fails to initialize the value
      */
     async get() {
-        if (!this.instance) {
+        if (this.instance === undefined) {
             if (!this.initializationPromise) {
                 this.initializationPromise = this.supplier();
             }
-            this.instance = await this.initializationPromise;
+            try {
+                this.instance = await this.initializationPromise;
+            }
+            catch (error) {
+                // A rejected supplier must leave the wrapper retryable: clear the
+                // cached promise so the next get() re-invokes the supplier rather
+                // than re-awaiting the same rejection forever.
+                this.initializationPromise = null;
+                throw error;
+            }
         }
         logger.debug(`Async Lazy instance created with type ${this.instance?.constructor.name || typeof this.instance}`);
         return this.instance;
     }
     /**
-     * Closes and cleans up the lazy-loaded instance if it exists
-     * If a closeHandler was provided, it will be called with the instance
+     * Closes and cleans up the lazy-loaded instance if it exists.
+     * If a closeHandler was provided, it will be called with the instance.
+     * The instance and any cached initialization promise are reset afterward,
+     * so the next get() rebuilds.
      * @returns A promise that resolves when the cleanup is complete
      */
     async close() {
-        if (this.instance) {
+        if (this.instance !== undefined) {
             if (this.closeHandler) {
                 logger.debug(`Initiating close handler for lazy instance of type ${typeof this.instance}`);
                 await this.closeHandler(this.instance);
                 logger.debug(`Lazy instance closed with type ${typeof this.instance}`);
             }
+            this.instance = undefined;
+            this.initializationPromise = null;
         }
     }
 }

package/dist/lazy.js.map

@@ -1 +1 @@
-{"version":3,"file":"lazy.js","sourceRoot":"","sources":["../src/lazy.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAExC,MAAM,OAAO,IAAI;IACf,qDAAqD;IAC7C,QAAQ,CAAgB;IAEhC,6DAA6D;IAC5C,QAAQ,CAAU;IAEnC,4DAA4D;IAC3C,YAAY,CAAyB;IAEtD;;;;OAIG;IACH,YAAY,QAAiB,EAAE,YAAoC;QACjE,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;IACnC,CAAC;IAED;;;;OAIG;IACH,GAAG;QACD,IAAI,CAAC;YACH,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;YAChC,MAAM,CAAC,KAAK,CACV,mCAAmC,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAC,IAAI,IAAI,OAAO,IAAI,CAAC,QAAQ,EAAE,CAC7F,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,uCAAuC,KAAK,EAAE,CAAC,CAAC;QAClE,CAAC;QACD,OAAO,IAAI,CAAC,QAAS,CAAC;IACxB,CAAC;IAED;;;;OAIG;IACH,KAAK;QACH,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;gBACtB,MAAM,CAAC,KAAK,CACV,sDAAsD,OAAO,IAAI,CAAC,QAAQ,EAAE,CAC7E,CAAC;gBACF,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBACjC,MAAM,CAAC,KAAK,CAAC,kCAAkC,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;YACzE,CAAC;YACD,IAAI,CAAC,QAAQ,GAAG,SAAS,CAAC;QAC5B,CAAC;IACH,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,OAAO,SAAS;IACpB,qDAAqD;IAC7C,QAAQ,CAAgB;IAEhC,6DAA6D;IAC5C,QAAQ,CAAmB;IAE5C,4DAA4D;IAC3C,YAAY,CAAkC;IAE/D,iGAAiG;IACzF,qBAAqB,GAAsB,IAAI,CAAC;IAExD;;;;OAIG;IACH,YACE,QAA0B,EAC1B,YAA6C;QAE7C,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;IACnC,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,GAAG;QACP,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,IAAI,CAAC,IAAI,CAAC,qBAAqB,EAAE,CAAC;gBAChC,IAAI,CAAC,qBAAqB,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC/C,CAAC;YACD,IAAI,CAAC,QAAQ,GAAG,MAAM,IAAI,CAAC,qBAAqB,CAAC;QACnD,CAAC;QACD,MAAM,CAAC,KAAK,CACV,yCAAyC,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAC,IAAI,IAAI,OAAO,IAAI,CAAC,QAAQ,EAAE,CACnG,CAAC;QACF,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;gBACtB,MAAM,CAAC,KAAK,CACV,sDAAsD,OAAO,IAAI,CAAC,QAAQ,EAAE,CAC7E,CAAC;gBACF,MAAM,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBACvC,MAAM,CAAC,KAAK,CAAC,kCAAkC,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;YACzE,CAAC;QACH,CAAC;IACH,CAAC;CACF"}
+{"version":3,"file":"lazy.js","sourceRoot":"","sources":["../src/lazy.ts"],"names":[],"mappings":"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"}

package/dist/mcp/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AAEjE,OAAO,EAAE,QAAQ,EAAE,MAAM,mCAAmC,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAEvD,oDAAoD;AACpD,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,QAAQ,CAAC;IACnB,mFAAmF;IACnF,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,mFAAmF;IACnF,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC;CAC7B;AAED,yEAAyE;AACzE,MAAM,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;AAI3D,MAAM,WAAW,sBAAsB;IACrC,kEAAkE;IAClE,aAAa,EAAE,MAAM,CAAC;IACtB,qEAAqE;IACrE,YAAY,EAAE,GAAG,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;IACzC,qEAAqE;IACrE,OAAO,EAAE,aAAa,CAAC;IACvB,yDAAyD;IACzD,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB;AAED,+FAA+F;AAC/F,wBAAgB,eAAe,CAAC,EAC9B,aAAa,EACb,YAAY,EACZ,OAAO,EACP,KAAiB,GAClB,EAAE,sBAAsB,GAAG,SAAS,CA0DpC"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AACjE,OAAO,EAAE,QAAQ,EAAE,MAAM,mCAAmC,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAEvD,oDAAoD;AACpD,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,QAAQ,CAAC;IACnB,mFAAmF;IACnF,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,mFAAmF;IACnF,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC;CAC7B;AAED,yEAAyE;AACzE,MAAM,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;AAI3D,MAAM,WAAW,sBAAsB;IACrC,kEAAkE;IAClE,aAAa,EAAE,MAAM,CAAC;IACtB,qEAAqE;IACrE,YAAY,EAAE,GAAG,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;IACzC,qEAAqE;IACrE,OAAO,EAAE,aAAa,CAAC;IACvB,yDAAyD;IACzD,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB;AAED,+FAA+F;AAC/F,wBAAgB,eAAe,CAAC,EAC9B,aAAa,EACb,YAAY,EACZ,OAAO,EACP,KAAiB,GAClB,EAAE,sBAAsB,GAAG,SAAS,CAkEpC"}

package/dist/mcp/server.js

@@ -1,5 +1,4 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { alwaysEnabled } from "../confluent/tools/connection-predicates.js";
 const noopTrack = () => { };
 /** Builds a fresh {@link McpServer} with every supplied {@linkcode ToolHandler} registered. */
 export function createMcpServer({ serverVersion, toolHandlers, runtime, track = noopTrack, }) {
@@ -8,11 +7,12 @@ export function createMcpServer({ serverVersion, toolHandlers, runtime, track =
         version: serverVersion,
     });
     toolHandlers.forEach((handler, name) => {
-        const config = handler.getToolConfig();
+        const config = handler.getRegisteredToolConfig(runtime);
         srv.registerTool(name, {
             description: config.description,
             inputSchema: config.inputSchema,
             annotations: config.annotations,
+            _meta: { category: handler.category },
         }, async (args, context) => {
             const startTime = Date.now();
             // per-instance lookup so concurrent HTTP sessions don't clobber each other's telemetry
@@ -23,10 +23,14 @@ export function createMcpServer({ serverVersion, toolHandlers, runtime, track =
                 clientVersion: clientInfo?.version,
             };
             try {
-                // Gate launch of the browser OAuth login flow only on the
-                // first tool call that needs Confluent OAuth tokens.
+                // Launch the browser OAuth login flow only when this call actually
+                // routes to the OAuth connection — not merely because an OAuth
+                // connection exists somewhere in the config. A call targeting a
+                // local/direct connection in a mixed setup needs no login.
+                const targetConnectionId = handler.resolvedTargetConnectionId(runtime, args);
                 if (runtime.oauthHolder !== undefined &&
-                    handler.predicate !== alwaysEnabled) {
+                    targetConnectionId !== undefined &&
+                    runtime.config.connections[targetConnectionId]?.type === "oauth") {
                     await runtime.oauthHolder.ensureLoggedIn();
                 }
                 const result = await handler.handle(runtime, args, context?.sessionId);

package/dist/mcp/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,aAAa,EAAE,MAAM,+CAA+C,CAAC;AAkB9E,MAAM,SAAS,GAAkB,GAAG,EAAE,GAAE,CAAC,CAAC;AAa1C,+FAA+F;AAC/F,MAAM,UAAU,eAAe,CAAC,EAC9B,aAAa,EACb,YAAY,EACZ,OAAO,EACP,KAAK,GAAG,SAAS,GACM;IACvB,MAAM,GAAG,GAAG,IAAI,SAAS,CAAC;QACxB,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,aAAa;KACvB,CAAC,CAAC;IAEH,YAAY,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE;QACrC,MAAM,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;QAEvC,GAAG,CAAC,YAAY,CACd,IAAI,EACJ;YACE,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,WAAW,EAAE,MAAM,CAAC,WAAW;SAChC,EACD,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE;YACtB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAC7B,uFAAuF;YACvF,MAAM,UAAU,GAAG,GAAG,CAAC,MAAM,CAAC,gBAAgB,EAAE,CAAC;YACjD,MAAM,SAAS,GAAG;gBAChB,QAAQ,EAAE,IAAI;gBACd,UAAU,EAAE,UAAU,EAAE,IAAI;gBAC5B,aAAa,EAAE,UAAU,EAAE,OAAO;aACnC,CAAC;YACF,IAAI,CAAC;gBACH,0DAA0D;gBAC1D,qDAAqD;gBACrD,IACE,OAAO,CAAC,WAAW,KAAK,SAAS;oBACjC,OAAO,CAAC,SAAS,KAAK,aAAa,EACnC,CAAC;oBACD,MAAM,OAAO,CAAC,WAAW,CAAC,cAAc,EAAE,CAAC;gBAC7C,CAAC;gBACD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,MAAM,CACjC,OAAO,EACP,IAAI,EACJ,OAAO,EAAE,SAAS,CACnB,CAAC;gBACF,KAAK,CAAC;oBACJ,GAAG,SAAS;oBACZ,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;oBAClC,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;iBAC7C,CAAC,CAAC;gBACH,OAAO,MAAM,CAAC;YAChB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,KAAK,CAAC;oBACJ,GAAG,SAAS;oBACZ,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;oBAClC,MAAM,EAAE,OAAO;iBAChB,CAAC,CAAC;gBACH,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC,CACF,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,OAAO,GAAG,CAAC;AACb,CAAC"}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAmBpE,MAAM,SAAS,GAAkB,GAAG,EAAE,GAAE,CAAC,CAAC;AAa1C,+FAA+F;AAC/F,MAAM,UAAU,eAAe,CAAC,EAC9B,aAAa,EACb,YAAY,EACZ,OAAO,EACP,KAAK,GAAG,SAAS,GACM;IACvB,MAAM,GAAG,GAAG,IAAI,SAAS,CAAC;QACxB,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,aAAa;KACvB,CAAC,CAAC;IAEH,YAAY,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE;QACrC,MAAM,MAAM,GAAG,OAAO,CAAC,uBAAuB,CAAC,OAAO,CAAC,CAAC;QAExD,GAAG,CAAC,YAAY,CACd,IAAI,EACJ;YACE,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,KAAK,EAAE,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE;SACtC,EACD,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE;YACtB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAC7B,uFAAuF;YACvF,MAAM,UAAU,GAAG,GAAG,CAAC,MAAM,CAAC,gBAAgB,EAAE,CAAC;YACjD,MAAM,SAAS,GAAG;gBAChB,QAAQ,EAAE,IAAI;gBACd,UAAU,EAAE,UAAU,EAAE,IAAI;gBAC5B,aAAa,EAAE,UAAU,EAAE,OAAO;aACnC,CAAC;YACF,IAAI,CAAC;gBACH,mEAAmE;gBACnE,+DAA+D;gBAC/D,gEAAgE;gBAChE,2DAA2D;gBAC3D,MAAM,kBAAkB,GAAG,OAAO,CAAC,0BAA0B,CAC3D,OAAO,EACP,IAAI,CACL,CAAC;gBACF,IACE,OAAO,CAAC,WAAW,KAAK,SAAS;oBACjC,kBAAkB,KAAK,SAAS;oBAChC,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,kBAAkB,CAAC,EAAE,IAAI,KAAK,OAAO,EAChE,CAAC;oBACD,MAAM,OAAO,CAAC,WAAW,CAAC,cAAc,EAAE,CAAC;gBAC7C,CAAC;gBACD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,MAAM,CACjC,OAAO,EACP,IAAI,EACJ,OAAO,EAAE,SAAS,CACnB,CAAC;gBACF,KAAK,CAAC;oBACJ,GAAG,SAAS;oBACZ,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;oBAClC,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;iBAC7C,CAAC,CAAC;gBACH,OAAO,MAAM,CAAC;YAChB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,KAAK,CAAC;oBACJ,GAAG,SAAS;oBACZ,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;oBAClC,MAAM,EAAE,OAAO;iBAChB,CAAC,CAAC;gBACH,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC,CACF,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/preflight.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Minimum full Node.js version (major.minor.patch) the server supports. Kept in
+ * lockstep with the `engines.node` field in package.json.
+ *
+ * A full version, not just a major, because the floor is dictated by a
+ * transitive dependency: undici (via cheerio) declares `engines.node
+ * >=22.19.0` and, at load time, destructures `markAsUncloneable` from
+ * `node:worker_threads` — an export that only exists from Node 22.10.0 onward.
+ * On an older 22.x (e.g. 22.0.0) undici crashes with a cryptic
+ * `webidl.util.markAsUncloneable is not a function` deep in its cache module,
+ * which is exactly the inscrutable-crash-instead-of-clear-message failure the
+ * preflight shim (src/index.ts) exists to prevent (issue #455). A major-only
+ * gate waved those runtimes straight into that crash, so the gate compares the
+ * full version. Bump this in step with undici's `engines.node` floor.
+ */
+export declare const MINIMUM_NODE_VERSION = "22.19.0";
+/**
+ * Return a human-readable error message when `currentVersion` is older than
+ * `minimumVersion`, otherwise `undefined`.
+ *
+ * Pure (no I/O) so the version gate is exhaustively unit-testable by passing
+ * `process.versions.node`-shaped strings directly. A leading "v" is tolerated.
+ * An unparseable version is treated as unsupported rather than waved through —
+ * we would rather show the upgrade message than hand control to a runtime we
+ * could not identify.
+ *
+ * Authored in syntax that parses on very old Node (no optional chaining, no
+ * import attributes): this module sits in the shim's static import graph, so a
+ * parse error here would reintroduce the very cryptic crash the shim exists to
+ * prevent.
+ */
+export declare function nodeVersionError(currentVersion: string, minimumVersion: string): string | undefined;
+//# sourceMappingURL=preflight.d.ts.map