@confluentinc/mcp-confluent 1.2.2 → 1.4.0

package/dist/confluent/base-client-manager.js

@@ -0,0 +1,188 @@
+/**
+ * @fileoverview Abstract {@link BaseClientManager} that owns every Confluent Cloud
+ * REST client and the Schema Registry SDK client. Concrete subclasses live in
+ * sibling files ({@link DirectClientManager} for api-key auth + native Kafka,
+ * plus the OAuth variant introduced in the OAuth wiring ticket).
+ */
+import { SchemaRegistryClient } from "@confluentinc/schemaregistry";
+import { createAuthMiddleware, } from "../confluent/middleware.js";
+import { Lazy } from "../lazy.js";
+import { logger } from "../logger.js";
+import createClient from "openapi-fetch";
+/**
+ * Holds every Confluent Cloud REST client (cloud, tableflow, flink,
+ * schema-registry REST, kafka REST, telemetry) and the Schema Registry SDK
+ * client. Native Kafka admin/producer/consumer clients are declared abstract
+ * here so subclasses can supply the implementation that fits their auth model:
+ * api-key + SASL/PLAIN in {@link DirectClientManager}, or DPAT +
+ * SASL/OAUTHBEARER in OAuthClientManager.
+ *
+ * The `getSchemaRegistrySdkClient(envId?)` accessor has a default
+ * implementation that delegates to the no-arg `getSchemaRegistryClient()`.
+ * That covers direct connections (the arg is ignored). OAuth subclasses
+ * override it to auto-resolve the SR cluster from the supplied environment
+ * id (single SR per environment is the CCloud invariant) and build a
+ * bearer-authenticated SDK client per call.
+ */
+export class BaseClientManager {
+    confluentCloudBaseUrl;
+    confluentCloudFlinkBaseUrl;
+    confluentCloudSchemaRegistryBaseUrl;
+    confluentCloudKafkaRestBaseUrl;
+    confluentCloudTelemetryBaseUrl;
+    confluentCloudFlinkRestClient;
+    confluentCloudRestClient;
+    confluentCloudTableflowRestClient;
+    confluentCloudSchemaRegistryRestClient;
+    confluentCloudKafkaRestClient;
+    confluentCloudTelemetryRestClient;
+    schemaRegistryClient;
+    constructor(config) {
+        this.confluentCloudBaseUrl = config.endpoints.cloud;
+        this.confluentCloudFlinkBaseUrl = config.endpoints.flink;
+        this.confluentCloudSchemaRegistryBaseUrl = config.endpoints.schemaRegistry;
+        this.confluentCloudKafkaRestBaseUrl = config.endpoints.kafka;
+        this.confluentCloudTelemetryBaseUrl = config.endpoints.telemetry;
+        this.confluentCloudRestClient = new Lazy(() => {
+            if (!this.confluentCloudBaseUrl) {
+                throw new Error("Confluent Cloud REST endpoint not configured");
+            }
+            logger.info(`Initializing Confluent Cloud REST client for base URL ${this.confluentCloudBaseUrl}`);
+            const client = createClient({
+                baseUrl: this.confluentCloudBaseUrl,
+            });
+            client.use(createAuthMiddleware(config.auth.cloud));
+            return client;
+        });
+        this.confluentCloudTableflowRestClient = new Lazy(() => {
+            if (!this.confluentCloudBaseUrl) {
+                throw new Error("Confluent Cloud Tableflow REST endpoint not configured");
+            }
+            logger.info(`Initializing Confluent Cloud Tableflow REST client for base URL ${this.confluentCloudBaseUrl}`);
+            const client = createClient({
+                baseUrl: this.confluentCloudBaseUrl,
+            });
+            client.use(createAuthMiddleware(config.auth.tableflow));
+            return client;
+        });
+        this.confluentCloudFlinkRestClient = new Lazy(() => {
+            if (!this.confluentCloudFlinkBaseUrl) {
+                throw new Error("Confluent Cloud Flink REST endpoint not configured");
+            }
+            logger.info(`Initializing Confluent Cloud Flink REST client for base URL ${this.confluentCloudFlinkBaseUrl}`);
+            const client = createClient({
+                baseUrl: this.confluentCloudFlinkBaseUrl,
+            });
+            client.use(createAuthMiddleware(config.auth.flink));
+            return client;
+        });
+        this.confluentCloudSchemaRegistryRestClient = new Lazy(() => {
+            if (!this.confluentCloudSchemaRegistryBaseUrl) {
+                throw new Error("Confluent Cloud Schema Registry REST endpoint not configured");
+            }
+            logger.info(`Initializing Confluent Cloud Schema Registry REST client for base URL ${this.confluentCloudSchemaRegistryBaseUrl}`);
+            const client = createClient({
+                baseUrl: this.confluentCloudSchemaRegistryBaseUrl,
+            });
+            client.use(createAuthMiddleware(config.auth.schemaRegistry));
+            return client;
+        });
+        this.confluentCloudKafkaRestClient = new Lazy(() => {
+            if (!this.confluentCloudKafkaRestBaseUrl) {
+                throw new Error("Confluent Cloud Kafka REST endpoint not configured");
+            }
+            logger.info(`Initializing Confluent Cloud Kafka REST client for base URL ${this.confluentCloudKafkaRestBaseUrl}`);
+            const client = createClient({
+                baseUrl: this.confluentCloudKafkaRestBaseUrl,
+            });
+            client.use(createAuthMiddleware(config.auth.kafka));
+            return client;
+        });
+        this.confluentCloudTelemetryRestClient = new Lazy(() => {
+            if (!this.confluentCloudTelemetryBaseUrl) {
+                throw new Error("Confluent Cloud Telemetry endpoint not configured");
+            }
+            logger.info(`Initializing Confluent Cloud Telemetry REST client for base URL ${this.confluentCloudTelemetryBaseUrl}`);
+            const client = createClient({
+                baseUrl: this.confluentCloudTelemetryBaseUrl,
+            });
+            client.use(createAuthMiddleware(config.auth.telemetry));
+            return client;
+        });
+        this.schemaRegistryClient = new Lazy(() => {
+            if (!this.confluentCloudSchemaRegistryBaseUrl) {
+                throw new Error("Schema Registry endpoint not configured");
+            }
+            const schemaRegistryAuth = config.auth.schemaRegistry;
+            if (schemaRegistryAuth.type === "oauth") {
+                throw new Error("Schema Registry OAuth authentication requires the cluster-aware accessor: " +
+                    "call getSchemaRegistrySdkClient(envId) instead. The no-arg " +
+                    "getSchemaRegistryClient() does not have access to the logical SR cluster ID " +
+                    "(needed for the target-sr-cluster header) under OAuth; the cluster is " +
+                    "auto-resolved from envId.");
+            }
+            const { apiKey, apiSecret } = schemaRegistryAuth;
+            const clientConfig = {
+                baseURLs: [this.confluentCloudSchemaRegistryBaseUrl],
+            };
+            if (apiKey && apiSecret) {
+                clientConfig.basicAuthCredentials = {
+                    credentialsSource: "USER_INFO",
+                    userInfo: `${apiKey}:${apiSecret}`,
+                };
+            }
+            else if (apiKey || apiSecret) {
+                const missing = apiKey
+                    ? "SCHEMA_REGISTRY_API_SECRET"
+                    : "SCHEMA_REGISTRY_API_KEY";
+                throw new Error(`Partial credentials: ${missing} not set. Both SCHEMA_REGISTRY_API_KEY and SCHEMA_REGISTRY_API_SECRET are required for Schema Registry authentication.`);
+            }
+            return new SchemaRegistryClient(clientConfig);
+        });
+    }
+    /** @inheritdoc */
+    getConfluentCloudFlinkRestClient() {
+        return this.confluentCloudFlinkRestClient.get();
+    }
+    /** @inheritdoc */
+    getConfluentCloudRestClient() {
+        return this.confluentCloudRestClient.get();
+    }
+    /** @inheritdoc */
+    getConfluentCloudTableflowRestClient() {
+        return this.confluentCloudTableflowRestClient.get();
+    }
+    /** @inheritdoc */
+    getConfluentCloudSchemaRegistryRestClient() {
+        return this.confluentCloudSchemaRegistryRestClient.get();
+    }
+    /** @inheritdoc */
+    async getSchemaRegistryRestClient(_envId) {
+        return this.confluentCloudSchemaRegistryRestClient.get();
+    }
+    /** @inheritdoc */
+    async getConfluentCloudKafkaRestClient(_clusterId, _envId) {
+        return this.confluentCloudKafkaRestClient.get();
+    }
+    /** @inheritdoc */
+    getConfluentCloudTelemetryRestClient() {
+        return this.confluentCloudTelemetryRestClient.get();
+    }
+    /** @inheritdoc */
+    getSchemaRegistryClient() {
+        return this.schemaRegistryClient.get();
+    }
+    /**
+     * Environment-aware Schema Registry SDK client accessor. Under direct, the
+     * arg is ignored and the existing single-instance Lazy is returned. Under
+     * OAuth, `envId` (`env-...`) is required; the SR cluster (`lsrc-...`) is
+     * auto-resolved from the environment (single SR per environment is the
+     * CCloud invariant). The SR client itself is built per-call (no cache)
+     * because the DPAT is captured in the SDK's axios headers at construction
+     * time; endpoint resolution happens fresh on every call too.
+     */
+    async getSchemaRegistrySdkClient(_envId) {
+        return this.getSchemaRegistryClient();
+    }
+}
+//# sourceMappingURL=base-client-manager.js.map

package/dist/confluent/base-client-manager.js.map

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

package/dist/confluent/client-manager.d.ts

@@ -1,11 +1,20 @@
 /**
- * @fileoverview Provides client management functionality for Kafka and Confluent Cloud services.
+ * @fileoverview Public client-manager contracts. Implementations live in sibling
+ * files: {@link BaseClientManager} (REST + Schema Registry) in
+ * `base-client-manager.ts`, and concrete subclasses ({@link DirectClientManager}
+ * for api-key auth + native Kafka, plus the OAuth variant) alongside it.
  */
-import { GlobalConfig, KafkaJS } from "@confluentinc/kafka-javascript";
-import { SchemaRegistryClient } from "@confluentinc/schemaregistry";
-import { ConfluentAuth, ConfluentEndpoints } from "../confluent/middleware.js";
-import { paths } from "@src/confluent/openapi-schema.js";
-import { Client } from "openapi-fetch";
+import { KafkaJS } from "@confluentinc/kafka-javascript";
+import type { SchemaRegistryClient } from "@confluentinc/schemaregistry";
+import type { paths } from "@src/confluent/openapi-schema.js";
+import type { Client } from "openapi-fetch";
+/**
+ * Typed openapi-fetch client over the project's OpenAPI {@link paths}.
+ * Shared alias so every REST surface in the codebase (cloud, flink,
+ * tableflow, kafka REST, schema-registry REST, telemetry) advertises and
+ * returns the same shape without restating the path-template generic.
+ */
+export type ConfluentRestClient = Client<paths, `${string}/${string}`>;
 /**
  * Interface for managing Kafka client connections and operations.
  */
@@ -26,17 +35,37 @@ export interface KafkaClientManager {
  */
 export interface ConfluentCloudRestClientManager {
     /** Gets a configured REST client for Confluent Cloud Flink operations */
-    getConfluentCloudFlinkRestClient(): Client<paths, `${string}/${string}`>;
+    getConfluentCloudFlinkRestClient(): ConfluentRestClient;
     /** Gets a configured REST client for general Confluent Cloud operations */
-    getConfluentCloudRestClient(): Client<paths, `${string}/${string}`>;
+    getConfluentCloudRestClient(): ConfluentRestClient;
     /** Gets a configured REST client for Tableflow operations */
-    getConfluentCloudTableflowRestClient(): Client<paths, `${string}/${string}`>;
+    getConfluentCloudTableflowRestClient(): ConfluentRestClient;
     /** Gets a configured REST client for Confluent Cloud Schema Registry operations */
-    getConfluentCloudSchemaRegistryRestClient(): Client<paths, `${string}/${string}`>;
-    /** Gets a configured REST client for Confluent Cloud Kafka operations */
-    getConfluentCloudKafkaRestClient(): Client<paths, `${string}/${string}`>;
+    getConfluentCloudSchemaRegistryRestClient(): ConfluentRestClient;
+    /**
+     * Env-aware REST client for Schema Registry operations. Use from handlers
+     * that need OAuth support; the existing sync getter above stays in use by
+     * direct-only handlers (catalog/tag/search) and is unaffected by this
+     * method.
+     *
+     * Under direct, `envId` is ignored; a client is built against the
+     * `schema_registry.endpoint` from the connection config (same configuration
+     * source as the sync getter). Under OAuth, `envId` is required: a fresh
+     * client is built per call against the resolved SR host for the env's SR
+     * cluster, with bearer auth + the `target-sr-cluster` default header.
+     */
+    getSchemaRegistryRestClient(envId?: string): Promise<ConfluentRestClient>;
+    /**
+     * Gets a configured REST client for Confluent Cloud Kafka operations.
+     *
+     * Under direct, args are ignored; a client is built against
+     * `conn.kafka.rest_endpoint` from the connection config. Under OAuth, both
+     * `clusterId` and `envId` are required: a fresh client is built per call
+     * against the resolved `spec.http_endpoint` for the given cluster.
+     */
+    getConfluentCloudKafkaRestClient(clusterId?: string, envId?: string): Promise<ConfluentRestClient>;
     /** Gets a configured REST client for Confluent Cloud Telemetry/Metrics API */
-    getConfluentCloudTelemetryRestClient(): Client<paths, `${string}/${string}`>;
+    getConfluentCloudTelemetryRestClient(): ConfluentRestClient;
 }
 /**
  * Interface for managing Schema Registry client connections.
@@ -47,68 +76,4 @@ export interface SchemaRegistryClientHandler {
 export interface ClientManager extends KafkaClientManager, ConfluentCloudRestClientManager, SchemaRegistryClientHandler {
     getSchemaRegistryClient(): SchemaRegistryClient;
 }
-export interface ClientManagerConfig {
-    kafka: GlobalConfig;
-    endpoints: ConfluentEndpoints;
-    auth: {
-        cloud: ConfluentAuth;
-        flink: ConfluentAuth;
-        tableflow: ConfluentAuth;
-        schemaRegistry: ConfluentAuth;
-        kafka: ConfluentAuth;
-        telemetry: ConfluentAuth;
-    };
-}
-/**
- * Default implementation of client management for Kafka and Confluent Cloud services.
- * Manages lifecycle and lazy initialization of various client connections.
- */
-export declare class DefaultClientManager implements ClientManager, SchemaRegistryClientHandler {
-    private confluentCloudBaseUrl;
-    private confluentCloudTableflowBaseUrl;
-    private confluentCloudFlinkBaseUrl;
-    private confluentCloudSchemaRegistryBaseUrl;
-    private confluentCloudKafkaRestBaseUrl;
-    private confluentCloudTelemetryBaseUrl;
-    private readonly kafkaConfig;
-    private readonly kafkaClient;
-    private readonly adminClient;
-    private readonly producer;
-    private readonly confluentCloudFlinkRestClient;
-    private readonly confluentCloudRestClient;
-    private readonly confluentCloudTableflowRestClient;
-    private readonly confluentCloudSchemaRegistryRestClient;
-    private readonly confluentCloudKafkaRestClient;
-    private readonly confluentCloudTelemetryRestClient;
-    private readonly schemaRegistryClient;
-    /**
-     * Creates a new DefaultClientManager instance.
-     * @param config - Configuration for all clients
-     */
-    constructor(config: ClientManagerConfig);
-    /** @inheritdoc */
-    getConsumer(sessionId?: string): Promise<KafkaJS.Consumer>;
-    /** @inheritdoc */
-    getKafkaClient(): KafkaJS.Kafka;
-    /** @inheritdoc */
-    getConfluentCloudFlinkRestClient(): Client<paths, `${string}/${string}`>;
-    /** @inheritdoc */
-    getConfluentCloudRestClient(): Client<paths, `${string}/${string}`>;
-    /** @inheritdoc */
-    getConfluentCloudTableflowRestClient(): Client<paths, `${string}/${string}`>;
-    /** @inheritdoc */
-    getConfluentCloudSchemaRegistryRestClient(): Client<paths, `${string}/${string}`>;
-    /** @inheritdoc */
-    getConfluentCloudKafkaRestClient(): Client<paths, `${string}/${string}`>;
-    /** @inheritdoc */
-    getConfluentCloudTelemetryRestClient(): Client<paths, `${string}/${string}`>;
-    /** @inheritdoc */
-    getAdminClient(): Promise<KafkaJS.Admin>;
-    /** @inheritdoc */
-    getProducer(): Promise<KafkaJS.Producer>;
-    /** @inheritdoc */
-    disconnect(): Promise<void>;
-    /** @inheritdoc */
-    getSchemaRegistryClient(): SchemaRegistryClient;
-}
 //# sourceMappingURL=client-manager.d.ts.map

package/dist/confluent/client-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client-manager.d.ts","sourceRoot":"","sources":["../../src/confluent/client-manager.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"client-manager.d.ts","sourceRoot":"","sources":["../../src/confluent/client-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,gCAAgC,CAAC;AACzD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACzE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kCAAkC,CAAC;AAC9D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAE5C;;;;;GAKG;AACH,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC,KAAK,EAAE,GAAG,MAAM,IAAI,MAAM,EAAE,CAAC,CAAC;AAEvE;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,0CAA0C;IAC1C,cAAc,IAAI,OAAO,CAAC,KAAK,CAAC;IAChC,wEAAwE;IACxE,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACzC,+DAA+D;IAC/D,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACzC,iEAAiE;IACjE,WAAW,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC3D,uDAAuD;IACvD,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,+BAA+B;IAC9C,yEAAyE;IACzE,gCAAgC,IAAI,mBAAmB,CAAC;IACxD,2EAA2E;IAC3E,2BAA2B,IAAI,mBAAmB,CAAC;IACnD,6DAA6D;IAC7D,oCAAoC,IAAI,mBAAmB,CAAC;IAC5D,mFAAmF;IACnF,yCAAyC,IAAI,mBAAmB,CAAC;IACjE;;;;;;;;;;;OAWG;IACH,2BAA2B,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAC1E;;;;;;;OAOG;IACH,gCAAgC,CAC9B,SAAS,CAAC,EAAE,MAAM,EAClB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAChC,8EAA8E;IAC9E,oCAAoC,IAAI,mBAAmB,CAAC;CAC7D;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,uBAAuB,IAAI,oBAAoB,CAAC;CACjD;AAED,MAAM,WAAW,aACf,SAAQ,kBAAkB,EACxB,+BAA+B,EAC/B,2BAA2B;IAC7B,uBAAuB,IAAI,oBAAoB,CAAC;CACjD"}

package/dist/confluent/client-manager.js

@@ -1,216 +1,8 @@
 /**
- * @fileoverview Provides client management functionality for Kafka and Confluent Cloud services.
+ * @fileoverview Public client-manager contracts. Implementations live in sibling
+ * files: {@link BaseClientManager} (REST + Schema Registry) in
+ * `base-client-manager.ts`, and concrete subclasses ({@link DirectClientManager}
+ * for api-key auth + native Kafka, plus the OAuth variant) alongside it.
  */
-import { KafkaJS } from "@confluentinc/kafka-javascript";
-import { SchemaRegistryClient } from "@confluentinc/schemaregistry";
-import { createAuthMiddleware, } from "../confluent/middleware.js";
-import { AsyncLazy, Lazy } from "../lazy.js";
-import { kafkaLogger, logger } from "../logger.js";
-import createClient from "openapi-fetch";
-/**
- * Default implementation of client management for Kafka and Confluent Cloud services.
- * Manages lifecycle and lazy initialization of various client connections.
- */
-export class DefaultClientManager {
-    confluentCloudBaseUrl;
-    confluentCloudTableflowBaseUrl;
-    confluentCloudFlinkBaseUrl;
-    confluentCloudSchemaRegistryBaseUrl;
-    confluentCloudKafkaRestBaseUrl;
-    confluentCloudTelemetryBaseUrl;
-    kafkaConfig;
-    kafkaClient;
-    adminClient;
-    producer;
-    confluentCloudFlinkRestClient;
-    confluentCloudRestClient;
-    confluentCloudTableflowRestClient;
-    confluentCloudSchemaRegistryRestClient;
-    confluentCloudKafkaRestClient;
-    confluentCloudTelemetryRestClient;
-    schemaRegistryClient;
-    /**
-     * Creates a new DefaultClientManager instance.
-     * @param config - Configuration for all clients
-     */
-    constructor(config) {
-        this.confluentCloudBaseUrl = config.endpoints.cloud;
-        this.confluentCloudTableflowBaseUrl = config.endpoints.cloud; // at the time of writing, apis are exposed on the same base url as confluent cloud
-        this.confluentCloudFlinkBaseUrl = config.endpoints.flink;
-        this.confluentCloudSchemaRegistryBaseUrl = config.endpoints.schemaRegistry;
-        this.confluentCloudKafkaRestBaseUrl = config.endpoints.kafka;
-        this.confluentCloudTelemetryBaseUrl = config.endpoints.telemetry;
-        this.kafkaConfig = config.kafka;
-        this.kafkaClient = new Lazy(() => new KafkaJS.Kafka({
-            ...this.kafkaConfig,
-            kafkaJS: {
-                logger: kafkaLogger,
-                // we need to do this since typescript will complain that we are missing configs like `brokers` even though we are passing them in kafkaConfig above
-                // eslint-disable-next-line @typescript-eslint/no-explicit-any
-            },
-        }));
-        this.adminClient = new AsyncLazy(async () => {
-            logger.info("Connecting Kafka Admin");
-            const admin = this.kafkaClient.get().admin();
-            await admin.connect();
-            return admin;
-        }, (admin) => admin.disconnect());
-        this.producer = new AsyncLazy(async () => {
-            logger.info("Connecting Kafka Producer");
-            const producer = this.kafkaClient.get().producer();
-            await producer.connect();
-            return producer;
-        }, (producer) => producer.disconnect());
-        this.confluentCloudRestClient = new Lazy(() => {
-            if (!this.confluentCloudBaseUrl) {
-                throw new Error("Confluent Cloud REST endpoint not configured");
-            }
-            logger.info(`Initializing Confluent Cloud REST client for base URL ${this.confluentCloudBaseUrl}`);
-            const client = createClient({
-                baseUrl: this.confluentCloudBaseUrl,
-            });
-            client.use(createAuthMiddleware(config.auth.cloud));
-            return client;
-        });
-        this.confluentCloudTableflowRestClient = new Lazy(() => {
-            if (!this.confluentCloudTableflowBaseUrl) {
-                throw new Error("Confluent Cloud Tableflow REST endpoint not configured");
-            }
-            logger.info(`Initializing Confluent Cloud Tableflow REST client for base URL ${this.confluentCloudTableflowBaseUrl}`);
-            const client = createClient({
-                baseUrl: this.confluentCloudTableflowBaseUrl,
-            });
-            client.use(createAuthMiddleware(config.auth.tableflow));
-            return client;
-        });
-        this.confluentCloudFlinkRestClient = new Lazy(() => {
-            if (!this.confluentCloudFlinkBaseUrl) {
-                throw new Error("Confluent Cloud Flink REST endpoint not configured");
-            }
-            logger.info(`Initializing Confluent Cloud Flink REST client for base URL ${this.confluentCloudFlinkBaseUrl}`);
-            const client = createClient({
-                baseUrl: this.confluentCloudFlinkBaseUrl,
-            });
-            client.use(createAuthMiddleware(config.auth.flink));
-            return client;
-        });
-        this.confluentCloudSchemaRegistryRestClient = new Lazy(() => {
-            if (!this.confluentCloudSchemaRegistryBaseUrl) {
-                throw new Error("Confluent Cloud Schema Registry REST endpoint not configured");
-            }
-            logger.info(`Initializing Confluent Cloud Schema Registry REST client for base URL ${this.confluentCloudSchemaRegistryBaseUrl}`);
-            const client = createClient({
-                baseUrl: this.confluentCloudSchemaRegistryBaseUrl,
-            });
-            client.use(createAuthMiddleware(config.auth.schemaRegistry));
-            return client;
-        });
-        this.confluentCloudKafkaRestClient = new Lazy(() => {
-            if (!this.confluentCloudKafkaRestBaseUrl) {
-                throw new Error("Confluent Cloud Kafka REST endpoint not configured");
-            }
-            logger.info(`Initializing Confluent Cloud Kafka REST client for base URL ${this.confluentCloudKafkaRestBaseUrl}`);
-            const client = createClient({
-                baseUrl: this.confluentCloudKafkaRestBaseUrl,
-            });
-            client.use(createAuthMiddleware(config.auth.kafka));
-            return client;
-        });
-        this.confluentCloudTelemetryRestClient = new Lazy(() => {
-            if (!this.confluentCloudTelemetryBaseUrl) {
-                throw new Error("Confluent Cloud Telemetry endpoint not configured");
-            }
-            logger.info(`Initializing Confluent Cloud Telemetry REST client for base URL ${this.confluentCloudTelemetryBaseUrl}`);
-            const client = createClient({
-                baseUrl: this.confluentCloudTelemetryBaseUrl,
-            });
-            client.use(createAuthMiddleware(config.auth.telemetry));
-            return client;
-        });
-        this.schemaRegistryClient = new Lazy(() => {
-            if (!this.confluentCloudSchemaRegistryBaseUrl) {
-                throw new Error("Schema Registry endpoint not configured");
-            }
-            const { apiKey, apiSecret } = config.auth.schemaRegistry;
-            const clientConfig = {
-                baseURLs: [this.confluentCloudSchemaRegistryBaseUrl],
-            };
-            if (apiKey && apiSecret) {
-                clientConfig.basicAuthCredentials = {
-                    credentialsSource: "USER_INFO",
-                    userInfo: `${apiKey}:${apiSecret}`,
-                };
-            }
-            else if (apiKey || apiSecret) {
-                const missing = apiKey
-                    ? "SCHEMA_REGISTRY_API_SECRET"
-                    : "SCHEMA_REGISTRY_API_KEY";
-                throw new Error(`Partial credentials: ${missing} not set. Both SCHEMA_REGISTRY_API_KEY and SCHEMA_REGISTRY_API_SECRET are required for Schema Registry authentication.`);
-            }
-            return new SchemaRegistryClient(clientConfig);
-        });
-    }
-    /** @inheritdoc */
-    async getConsumer(sessionId) {
-        // Build the config inline, merging with defaults
-        const baseGroupId = this.kafkaConfig["group.id"] || "mcp-confluent";
-        const groupId = sessionId ? `${baseGroupId}-${sessionId}` : baseGroupId;
-        const consumerConfig = {
-            // Spread all user-provided config
-            ...this.kafkaConfig,
-            // Override with our logic
-            "group.id": groupId,
-            "auto.offset.reset": this.kafkaConfig["auto.offset.reset"] || "earliest",
-            "allow.auto.create.topics": this.kafkaConfig["allow.auto.create.topics"] || false,
-            "enable.auto.commit": this.kafkaConfig["enable.auto.commit"] || false,
-        };
-        return this.kafkaClient.get().consumer(consumerConfig);
-    }
-    /** @inheritdoc */
-    getKafkaClient() {
-        return this.kafkaClient.get();
-    }
-    /** @inheritdoc */
-    getConfluentCloudFlinkRestClient() {
-        return this.confluentCloudFlinkRestClient.get();
-    }
-    /** @inheritdoc */
-    getConfluentCloudRestClient() {
-        return this.confluentCloudRestClient.get();
-    }
-    /** @inheritdoc */
-    getConfluentCloudTableflowRestClient() {
-        return this.confluentCloudTableflowRestClient.get();
-    }
-    /** @inheritdoc */
-    getConfluentCloudSchemaRegistryRestClient() {
-        return this.confluentCloudSchemaRegistryRestClient.get();
-    }
-    /** @inheritdoc */
-    getConfluentCloudKafkaRestClient() {
-        return this.confluentCloudKafkaRestClient.get();
-    }
-    /** @inheritdoc */
-    getConfluentCloudTelemetryRestClient() {
-        return this.confluentCloudTelemetryRestClient.get();
-    }
-    /** @inheritdoc */
-    async getAdminClient() {
-        return this.adminClient.get();
-    }
-    /** @inheritdoc */
-    async getProducer() {
-        return this.producer.get();
-    }
-    /** @inheritdoc */
-    async disconnect() {
-        await this.adminClient.close();
-        await this.producer.close();
-        this.kafkaClient.close();
-    }
-    /** @inheritdoc */
-    getSchemaRegistryClient() {
-        return this.schemaRegistryClient.get();
-    }
-}
+export {};
 //# sourceMappingURL=client-manager.js.map

package/dist/confluent/client-manager.js.map

@@ -1 +1 @@
-{"version":3,"file":"client-manager.js","sourceRoot":"","sources":["../../src/confluent/client-manager.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"client-manager.js","sourceRoot":"","sources":["../../src/confluent/client-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/confluent/config-telemetry.d.ts

@@ -0,0 +1,41 @@
+import type { CLIOptions } from "../cli.js";
+import type { MCPServerConfiguration } from "../config/models.js";
+import type { TransportType } from "../mcp/transports/types.js";
+/**
+ * Wire shape of the connection-type label on telemetry events. The internal
+ * schema discriminator uses `"direct"` and `"oauth"`; the telemetry label
+ * remaps the latter to `"ccloud-oauth"` because today's OAuth arm is
+ * specifically Confluent Cloud OAuth (PKCE against CCloud Auth0). If a
+ * non-CCloud OAuth arm ever lands, {@link buildConfigTelemetry}'s mapping
+ * needs to grow.
+ */
+export type ConnectionTelemetryType = "direct" | "ccloud-oauth";
+/**
+ * Result of {@link buildConfigTelemetry}. Three orthogonal dimensions captured
+ * once at server start and emitted as the payload of `SERVER_START`. They are
+ * boot-time invariants, so they don't ride TOOL_CALL events — warehouse joins
+ * on `serverSessionId` recover the link when slicing is needed. See #264.
+ */
+export interface ConfigTelemetry {
+    /** Which branch of `main()` built the `MCPServerConfiguration`. */
+    configSource: "yaml" | "env-vars";
+    /**
+     * Sorted list of active MCP serving listeners. Inputs are already unique by
+     * construction (Zod rejects duplicates on the YAML path; `parseTransportList`
+     * dedupes on the CLI path), so this helper does not enforce uniqueness.
+     */
+    transports: TransportType[];
+    /**
+     * Sorted list of each declared connection's wire type. Length equals the
+     * connection count; duplicates reflect multiple connections of the same
+     * type (relevant once multi-connection lands — today always length 1).
+     */
+    connectionTypes: ConnectionTelemetryType[];
+}
+/**
+ * Derive the {@link ConfigTelemetry} bundle from the inputs already in scope
+ * at the end of `main()`'s bootstrap (resolved CLI options, validated
+ * `MCPServerConfiguration`, and the resolved list of active transports).
+ */
+export declare function buildConfigTelemetry(cliOptions: CLIOptions, mcpConfig: MCPServerConfiguration, transports: readonly TransportType[]): ConfigTelemetry;
+//# sourceMappingURL=config-telemetry.d.ts.map

package/dist/confluent/config-telemetry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-telemetry.d.ts","sourceRoot":"","sources":["../../src/confluent/config-telemetry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAElE;;;;;;;GAOG;AACH,MAAM,MAAM,uBAAuB,GAAG,QAAQ,GAAG,cAAc,CAAC;AAEhE;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,mEAAmE;IACnE,YAAY,EAAE,MAAM,GAAG,UAAU,CAAC;IAClC;;;;OAIG;IACH,UAAU,EAAE,aAAa,EAAE,CAAC;IAC5B;;;;OAIG;IACH,eAAe,EAAE,uBAAuB,EAAE,CAAC;CAC5C;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,UAAU,EACtB,SAAS,EAAE,sBAAsB,EACjC,UAAU,EAAE,SAAS,aAAa,EAAE,GACnC,eAAe,CAYjB"}

package/dist/confluent/config-telemetry.js

@@ -0,0 +1,17 @@
+/**
+ * Derive the {@link ConfigTelemetry} bundle from the inputs already in scope
+ * at the end of `main()`'s bootstrap (resolved CLI options, validated
+ * `MCPServerConfiguration`, and the resolved list of active transports).
+ */
+export function buildConfigTelemetry(cliOptions, mcpConfig, transports) {
+    const byLocale = (a, b) => a.localeCompare(b);
+    const connectionTypes = Object.values(mcpConfig.connections)
+        .map((conn) => conn.type === "oauth" ? "ccloud-oauth" : "direct")
+        .sort(byLocale);
+    return {
+        configSource: cliOptions.config ? "yaml" : "env-vars",
+        transports: [...transports].sort(byLocale),
+        connectionTypes,
+    };
+}
+//# sourceMappingURL=config-telemetry.js.map