@confluentinc/mcp-confluent 1.0.1 → 1.0.2

package/dist/confluent/middleware.d.ts

@@ -1,15 +1,16 @@
 import { Middleware } from "openapi-fetch";
+export interface ConfluentEndpoints {
+    cloud?: string;
+    flink?: string;
+    schemaRegistry?: string;
+    kafka?: string;
+}
+export interface ConfluentAuth {
+    apiKey: string;
+    apiSecret: string;
+}
 /**
- * Middleware to add Authorization header to every request.
- *
- * This middleware intercepts each request and adds an Authorization header
- * using the Flink API key and secret from the environment variables.
- *
- * @param {Object} request - The request object.
- * @returns {Object} The modified request object with the Authorization header.
+ * Creates a middleware that adds Authorization header using the provided auth credentials
  */
-export declare const confluentCloudFlinkAuthMiddleware: Middleware;
-export declare const confluentCloudAuthMiddleware: Middleware;
-export declare const confluentCloudSchemaRegistryAuthMiddleware: Middleware;
-export declare const confluentCloudKafkaAuthMiddleware: Middleware;
+export declare const createAuthMiddleware: (auth: ConfluentAuth) => Middleware;
 //# sourceMappingURL=middleware.d.ts.map

package/dist/confluent/middleware.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../src/confluent/middleware.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C;;;;;;;;GAQG;AACH,eAAO,MAAM,iCAAiC,EAAE,UAU/C,CAAC;AAEF,eAAO,MAAM,4BAA4B,EAAE,UAU1C,CAAC;AAEF,eAAO,MAAM,0CAA0C,EAAE,UAUxD,CAAC;AAEF,eAAO,MAAM,iCAAiC,EAAE,UAU/C,CAAC"}
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../src/confluent/middleware.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE3C,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,eAAO,MAAM,oBAAoB,GAAI,MAAM,aAAa,KAAG,UASzD,CAAC"}

package/dist/confluent/middleware.js

@@ -1,43 +1,12 @@
-import env from "../env.js";
+import { logger } from "../logger.js";
 /**
- * Middleware to add Authorization header to every request.
- *
- * This middleware intercepts each request and adds an Authorization header
- * using the Flink API key and secret from the environment variables.
- *
- * @param {Object} request - The request object.
- * @returns {Object} The modified request object with the Authorization header.
+ * Creates a middleware that adds Authorization header using the provided auth credentials
  */
-export const confluentCloudFlinkAuthMiddleware = {
+export const createAuthMiddleware = (auth) => ({
     async onRequest({ request }) {
-        console.error(`${JSON.stringify(request)}`);
-        // add Authorization header to every request
-        request.headers.set("Authorization", `Basic ${Buffer.from(`${env.FLINK_API_KEY}:${env.FLINK_API_SECRET}`).toString("base64")}`);
+        logger.debug({ request }, "Processing request");
+        request.headers.set("Authorization", `Basic ${Buffer.from(`${auth.apiKey}:${auth.apiSecret}`).toString("base64")}`);
         return request;
     },
-};
-export const confluentCloudAuthMiddleware = {
-    async onRequest({ request }) {
-        console.error(`${JSON.stringify(request)}`);
-        // add Authorization header to every request
-        request.headers.set("Authorization", `Basic ${Buffer.from(`${env.CONFLUENT_CLOUD_API_KEY}:${env.CONFLUENT_CLOUD_API_SECRET}`).toString("base64")}`);
-        return request;
-    },
-};
-export const confluentCloudSchemaRegistryAuthMiddleware = {
-    async onRequest({ request }) {
-        console.error(`${JSON.stringify(request)}`);
-        // add Authorization header to every request
-        request.headers.set("Authorization", `Basic ${Buffer.from(`${env.SCHEMA_REGISTRY_API_KEY}:${env.SCHEMA_REGISTRY_API_SECRET}`).toString("base64")}`);
-        return request;
-    },
-};
-export const confluentCloudKafkaAuthMiddleware = {
-    async onRequest({ request }) {
-        console.error(`${JSON.stringify(request)}`);
-        // add Authorization header to every request
-        request.headers.set("Authorization", `Basic ${Buffer.from(`${env.KAFKA_API_KEY}:${env.KAFKA_API_SECRET}`).toString("base64")}`);
-        return request;
-    },
-};
+});
 //# sourceMappingURL=middleware.js.map

package/dist/confluent/middleware.js.map

@@ -1 +1 @@
-{"version":3,"file":"middleware.js","sourceRoot":"","sources":["../../src/confluent/middleware.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,MAAM,aAAa,CAAC;AAE9B;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,iCAAiC,GAAe;IAC3D,KAAK,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE;QACzB,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC5C,4CAA4C;QAC5C,OAAO,CAAC,OAAO,CAAC,GAAG,CACjB,eAAe,EACf,SAAS,MAAM,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,aAAa,IAAI,GAAG,CAAC,gBAAgB,EAAE,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAC1F,CAAC;QACF,OAAO,OAAO,CAAC;IACjB,CAAC;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,4BAA4B,GAAe;IACtD,KAAK,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE;QACzB,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC5C,4CAA4C;QAC5C,OAAO,CAAC,OAAO,CAAC,GAAG,CACjB,eAAe,EACf,SAAS,MAAM,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,uBAAuB,IAAI,GAAG,CAAC,0BAA0B,EAAE,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAC9G,CAAC;QACF,OAAO,OAAO,CAAC;IACjB,CAAC;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,0CAA0C,GAAe;IACpE,KAAK,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE;QACzB,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC5C,4CAA4C;QAC5C,OAAO,CAAC,OAAO,CAAC,GAAG,CACjB,eAAe,EACf,SAAS,MAAM,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,uBAAuB,IAAI,GAAG,CAAC,0BAA0B,EAAE,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAC9G,CAAC;QACF,OAAO,OAAO,CAAC;IACjB,CAAC;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,iCAAiC,GAAe;IAC3D,KAAK,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE;QACzB,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC5C,4CAA4C;QAC5C,OAAO,CAAC,OAAO,CAAC,GAAG,CACjB,eAAe,EACf,SAAS,MAAM,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,aAAa,IAAI,GAAG,CAAC,gBAAgB,EAAE,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAC1F,CAAC;QACF,OAAO,OAAO,CAAC;IACjB,CAAC;CACF,CAAC"}
+{"version":3,"file":"middleware.js","sourceRoot":"","sources":["../../src/confluent/middleware.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAexC;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,IAAmB,EAAc,EAAE,CAAC,CAAC;IACxE,KAAK,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE;QACzB,MAAM,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,EAAE,oBAAoB,CAAC,CAAC;QAChD,OAAO,CAAC,OAAO,CAAC,GAAG,CACjB,eAAe,EACf,SAAS,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAC9E,CAAC;QACF,OAAO,OAAO,CAAC;IACjB,CAAC;CACF,CAAC,CAAC"}

package/dist/confluent/schema-registry-helper.d.ts

@@ -0,0 +1,134 @@
+/**
+ * This module provides helper functions for working with Confluent Schema Registry.
+ * It handles schema registration, serialization, and deserialization of messages
+ * using various schema formats (AVRO, JSON, PROTOBUF).
+ */
+import { Deserializer, SchemaRegistryClient, SerdeType, Serializer } from "@confluentinc/schemaregistry";
+/**
+ * Supported schema types for Confluent Schema Registry.
+ * AVRO: Apache Avro binary format with schema evolution support
+ * JSON: JSON Schema format with validation
+ * PROTOBUF: Protocol Buffers format with backward compatibility
+ */
+export type SchemaType = "AVRO" | "JSON" | "PROTOBUF";
+/**
+ * Common options for schema registry operations.
+ * These options control how schemas are registered and used for serialization.
+ */
+export interface SchemaRegistryOptions {
+    useSchemaRegistry?: boolean;
+    schemaType?: SchemaType;
+    schema?: string;
+    subject?: string;
+    normalize?: boolean;
+}
+/**
+ * Options for message serialization/deserialization.
+ * Includes the message payload and schema registry configuration.
+ */
+export type MessageOptions = {
+    message: Buffer | object | string;
+    useSchemaRegistry?: boolean;
+    schemaType?: SchemaType;
+    schema?: string;
+    subject?: string;
+    normalize?: boolean;
+};
+/**
+ * Result of checking if a schema is needed for a message.
+ * Can indicate:
+ * - A schema is needed and provides the latest schema details
+ * - No schema exists and needs to be provided
+ * - No schema action is needed
+ */
+export type SchemaCheckResult = {
+    type: "schema-needed";
+    latestSchema: string;
+    subject: string;
+    schemaType: string;
+} | {
+    type: "no-schema";
+    subject: string;
+} | null;
+/**
+ * Creates and returns the appropriate serializer instance based on schema type.
+ * The serializer is configured to use either a specific schema ID or the latest version.
+ *
+ * @param schemaType - The type of schema (AVRO, JSON, PROTOBUF)
+ * @param registry - The schema registry client instance
+ * @param serdeType - Whether this is for key or value serialization
+ * @param schemaId - Optional schema ID to use for serialization
+ * @returns The appropriate Serializer instance
+ * @throws Error if the schema type is unknown or unsupported
+ */
+export declare function getSerializer(schemaType: SchemaType | undefined, registry: SchemaRegistryClient, serdeType: SerdeType, schemaId?: number): Serializer;
+/**
+ * Creates and returns the appropriate deserializer instance based on schema type.
+ * The deserializer is configured to handle schema evolution and compatibility.
+ *
+ * @param schemaType - The type of schema (AVRO, JSON, PROTOBUF)
+ * @param registry - The schema registry client instance
+ * @param serdeType - Whether this is for key or value deserialization
+ * @returns The appropriate Deserializer instance
+ * @throws Error if the schema type is unknown or unsupported
+ */
+export declare function getDeserializer(schemaType: SchemaType | undefined, registry: SchemaRegistryClient, serdeType: SerdeType): Deserializer;
+/**
+ * Checks if a schema is needed for the given message options.
+ * This function determines if:
+ * 1. A schema is already registered and should be used
+ * 2. No schema exists and needs to be provided
+ * 3. No schema action is needed
+ *
+ * @param topicName - The Kafka topic name
+ * @param options - The message options including schema, type, and payload
+ * @param serdeType - Whether this is for key or value serialization
+ * @param registry - The schema registry client instance (if used)
+ * @returns An object describing the schema state, or null if no schema action is needed
+ */
+export declare function checkSchemaNeeded(topicName: string, options: MessageOptions, serdeType: SerdeType, registry: SchemaRegistryClient | undefined): Promise<SchemaCheckResult>;
+/**
+ * Fetches the latest schema string and schema type for a given subject from the schema registry.
+ * Handles 404 errors gracefully by returning null when no schema exists.
+ *
+ * @param registry - The schema registry client instance
+ * @param subject - The subject to look up in the registry
+ * @returns An object with the latest schema string and schema type, or null if not found
+ * @throws Error if there's an unexpected error from the registry
+ */
+export declare function getLatestSchemaIfExists(registry: SchemaRegistryClient, subject: string): Promise<{
+    schema: string;
+    schemaType: SchemaType;
+} | null>;
+/**
+ * Serializes a message using the provided options and schema registry configuration.
+ * This function:
+ * 1. Registers the schema if provided
+ * 2. Validates the message type
+ * 3. Creates the appropriate serializer
+ * 4. Serializes the message
+ *
+ * @param topicName - The Kafka topic name
+ * @param options - The message options including schema, type, and payload
+ * @param serdeType - Whether this is for key or value serialization
+ * @param registry - The schema registry client instance (if used)
+ * @returns The serialized message as a Buffer or string
+ * @throws Error if serialization fails, schema registration fails, or message type is invalid
+ */
+export declare function serializeMessage(topicName: string, options: MessageOptions, serdeType: SerdeType, registry: SchemaRegistryClient | undefined): Promise<Buffer | string>;
+/**
+ * Deserializes a message using Schema Registry.
+ * This function:
+ * 1. Creates the appropriate deserializer
+ * 2. Deserializes the message using the schema from the registry
+ *
+ * @param topic - The Kafka topic name
+ * @param message - The message buffer to deserialize
+ * @param schemaType - The schema type (AVRO, JSON, PROTOBUF)
+ * @param registry - The schema registry client
+ * @param serdeType - Whether this is key or value
+ * @returns The deserialized object
+ * @throws Error if deserialization fails
+ */
+export declare function deserializeMessage(topic: string, message: Buffer, schemaType: SchemaType, registry: SchemaRegistryClient, serdeType: SerdeType): Promise<unknown>;
+//# sourceMappingURL=schema-registry-helper.d.ts.map

package/dist/confluent/schema-registry-helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-registry-helper.d.ts","sourceRoot":"","sources":["../../src/confluent/schema-registry-helper.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAGL,YAAY,EAMZ,oBAAoB,EACpB,SAAS,EACT,UAAU,EAEX,MAAM,8BAA8B,CAAC;AAGtC;;;;;GAKG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,CAAC;AAEtD;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IAClC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,iBAAiB,GACzB;IACE,IAAI,EAAE,eAAe,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB,GACD;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACtC,IAAI,CAAC;AAET;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAC3B,UAAU,EAAE,UAAU,GAAG,SAAS,EAClC,QAAQ,EAAE,oBAAoB,EAC9B,SAAS,EAAE,SAAS,EACpB,QAAQ,CAAC,EAAE,MAAM,GAChB,UAAU,CAkBZ;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAC7B,UAAU,EAAE,UAAU,GAAG,SAAS,EAClC,QAAQ,EAAE,oBAAoB,EAC9B,SAAS,EAAE,SAAS,GACnB,YAAY,CAed;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,cAAc,EACvB,SAAS,EAAE,SAAS,EACpB,QAAQ,EAAE,oBAAoB,GAAG,SAAS,GACzC,OAAO,CAAC,iBAAiB,CAAC,CAoB5B;AAED;;;;;;;;GAQG;AACH,wBAAsB,uBAAuB,CAC3C,QAAQ,EAAE,oBAAoB,EAC9B,OAAO,EAAE,MAAM,GACd,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,UAAU,CAAA;CAAE,GAAG,IAAI,CAAC,CAiB5D;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,cAAc,EACvB,SAAS,EAAE,SAAS,EACpB,QAAQ,EAAE,oBAAoB,GAAG,SAAS,GACzC,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC,CAgE1B;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,UAAU,EACtB,QAAQ,EAAE,oBAAoB,EAC9B,SAAS,EAAE,SAAS,GACnB,OAAO,CAAC,OAAO,CAAC,CAOlB"}

package/dist/confluent/schema-registry-helper.js

@@ -0,0 +1,202 @@
+/**
+ * This module provides helper functions for working with Confluent Schema Registry.
+ * It handles schema registration, serialization, and deserialization of messages
+ * using various schema formats (AVRO, JSON, PROTOBUF).
+ */
+import { AvroDeserializer, AvroSerializer, JsonDeserializer, JsonSerializer, ProtobufDeserializer, ProtobufSerializer, SerdeType, } from "@confluentinc/schemaregistry";
+import { logger } from "../logger.js";
+/**
+ * Creates and returns the appropriate serializer instance based on schema type.
+ * The serializer is configured to use either a specific schema ID or the latest version.
+ *
+ * @param schemaType - The type of schema (AVRO, JSON, PROTOBUF)
+ * @param registry - The schema registry client instance
+ * @param serdeType - Whether this is for key or value serialization
+ * @param schemaId - Optional schema ID to use for serialization
+ * @returns The appropriate Serializer instance
+ * @throws Error if the schema type is unknown or unsupported
+ */
+export function getSerializer(schemaType, registry, serdeType, schemaId) {
+    const serializerConfig = typeof schemaId === "number"
+        ? { useSchemaId: schemaId }
+        : { useLatestVersion: true };
+    const serializers = {
+        AVRO: () => new AvroSerializer(registry, serdeType, serializerConfig),
+        JSON: () => new JsonSerializer(registry, serdeType, serializerConfig),
+        PROTOBUF: () => new ProtobufSerializer(registry, serdeType, serializerConfig),
+    };
+    if (!schemaType || !(schemaType in serializers)) {
+        throw new Error(`Unknown schemaType: ${schemaType}`);
+    }
+    return serializers[schemaType]();
+}
+/**
+ * Creates and returns the appropriate deserializer instance based on schema type.
+ * The deserializer is configured to handle schema evolution and compatibility.
+ *
+ * @param schemaType - The type of schema (AVRO, JSON, PROTOBUF)
+ * @param registry - The schema registry client instance
+ * @param serdeType - Whether this is for key or value deserialization
+ * @returns The appropriate Deserializer instance
+ * @throws Error if the schema type is unknown or unsupported
+ */
+export function getDeserializer(schemaType, registry, serdeType) {
+    const deserializerConfig = {};
+    const deserializers = {
+        AVRO: () => new AvroDeserializer(registry, serdeType, deserializerConfig),
+        JSON: () => new JsonDeserializer(registry, serdeType, deserializerConfig),
+        PROTOBUF: () => new ProtobufDeserializer(registry, serdeType, deserializerConfig),
+    };
+    if (!schemaType || !(schemaType in deserializers)) {
+        throw new Error(`Unknown schemaType: ${schemaType}`);
+    }
+    return deserializers[schemaType]();
+}
+/**
+ * Checks if a schema is needed for the given message options.
+ * This function determines if:
+ * 1. A schema is already registered and should be used
+ * 2. No schema exists and needs to be provided
+ * 3. No schema action is needed
+ *
+ * @param topicName - The Kafka topic name
+ * @param options - The message options including schema, type, and payload
+ * @param serdeType - Whether this is for key or value serialization
+ * @param registry - The schema registry client instance (if used)
+ * @returns An object describing the schema state, or null if no schema action is needed
+ */
+export async function checkSchemaNeeded(topicName, options, serdeType, registry) {
+    if (options.useSchemaRegistry && !options.schema) {
+        const subject = options.subject ||
+            `${topicName}-${serdeType === SerdeType.KEY ? "key" : "value"}`;
+        const latest = registry
+            ? await getLatestSchemaIfExists(registry, subject)
+            : null;
+        if (latest) {
+            return {
+                type: "schema-needed",
+                latestSchema: latest.schema,
+                subject,
+                schemaType: latest.schemaType,
+            };
+        }
+        else {
+            return { type: "no-schema", subject };
+        }
+    }
+    return null;
+}
+/**
+ * Fetches the latest schema string and schema type for a given subject from the schema registry.
+ * Handles 404 errors gracefully by returning null when no schema exists.
+ *
+ * @param registry - The schema registry client instance
+ * @param subject - The subject to look up in the registry
+ * @returns An object with the latest schema string and schema type, or null if not found
+ * @throws Error if there's an unexpected error from the registry
+ */
+export async function getLatestSchemaIfExists(registry, subject) {
+    try {
+        const latest = await registry.getLatestSchemaMetadata(subject);
+        // The docs say that when no schemaType is supplied, it's assumed to be AVRO
+        const schemaType = (latest.schemaType || "AVRO");
+        return { schema: latest.schema, schemaType };
+    }
+    catch (err) {
+        if (err &&
+            typeof err === "object" &&
+            "status" in err &&
+            err.status === 404) {
+            return null;
+        }
+        throw err;
+    }
+}
+/**
+ * Serializes a message using the provided options and schema registry configuration.
+ * This function:
+ * 1. Registers the schema if provided
+ * 2. Validates the message type
+ * 3. Creates the appropriate serializer
+ * 4. Serializes the message
+ *
+ * @param topicName - The Kafka topic name
+ * @param options - The message options including schema, type, and payload
+ * @param serdeType - Whether this is for key or value serialization
+ * @param registry - The schema registry client instance (if used)
+ * @returns The serialized message as a Buffer or string
+ * @throws Error if serialization fails, schema registration fails, or message type is invalid
+ */
+export async function serializeMessage(topicName, options, serdeType, registry) {
+    if (!options.useSchemaRegistry) {
+        if (typeof options.message !== "string") {
+            logger.warn("Warning: Sending non-string message without schema registry. This may fail if the topic expects a schema.");
+        }
+        return typeof options.message === "string"
+            ? options.message
+            : JSON.stringify(options.message);
+    }
+    if (!options.schemaType) {
+        throw new Error("schemaType is required when useSchemaRegistry is true");
+    }
+    if (!registry) {
+        throw new Error("Schema Registry client is required for serialization");
+    }
+    // Default subject naming
+    const subject = options.subject ||
+        `${topicName}-${serdeType === SerdeType.KEY ? "key" : "value"}`;
+    let schemaId;
+    // Register schema if provided
+    if (options.schema) {
+        try {
+            schemaId = await registry.register(subject, {
+                schema: options.schema,
+                schemaType: options.schemaType,
+            }, options.normalize);
+        }
+        catch (err) {
+            throw new Error(`Failed to register schema for subject '${subject}': ${err}`);
+        }
+    }
+    // Validate message type
+    if (typeof options.message !== "object" || options.message === null) {
+        throw new Error("When using schema registry, message must be an object matching the schema.");
+    }
+    let serializer;
+    try {
+        serializer = getSerializer(options.schemaType, registry, serdeType, schemaId);
+    }
+    catch (err) {
+        throw new Error(`Failed to get serializer: ${err}`);
+    }
+    try {
+        return await serializer.serialize(topicName, options.message);
+    }
+    catch (err) {
+        throw new Error(`Failed to serialize message for subject '${subject}': ${err}`);
+    }
+}
+/**
+ * Deserializes a message using Schema Registry.
+ * This function:
+ * 1. Creates the appropriate deserializer
+ * 2. Deserializes the message using the schema from the registry
+ *
+ * @param topic - The Kafka topic name
+ * @param message - The message buffer to deserialize
+ * @param schemaType - The schema type (AVRO, JSON, PROTOBUF)
+ * @param registry - The schema registry client
+ * @param serdeType - Whether this is key or value
+ * @returns The deserialized object
+ * @throws Error if deserialization fails
+ */
+export async function deserializeMessage(topic, message, schemaType, registry, serdeType) {
+    try {
+        const deserializer = getDeserializer(schemaType, registry, serdeType);
+        return await deserializer.deserialize(topic, message);
+    }
+    catch (err) {
+        throw new Error(`Failed to deserialize message: ${err}`);
+    }
+}
+//# sourceMappingURL=schema-registry-helper.js.map

package/dist/confluent/schema-registry-helper.js.map

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

package/dist/confluent/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/confluent/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EAErB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/confluent/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC"}

package/dist/confluent/schema.js

@@ -1,4 +1,2 @@
-import { ToolSchema, } from "@modelcontextprotocol/sdk/types.js";
-// eslint-disable-next-line @typescript-eslint/no-unused-vars
-const ToolInputSchema = ToolSchema.shape.inputSchema;
+export {};
 //# sourceMappingURL=schema.js.map

package/dist/confluent/schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/confluent/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,UAAU,GACX,MAAM,oCAAoC,CAAC;AAK5C,6DAA6D;AAC7D,MAAM,eAAe,GAAG,UAAU,CAAC,KAAK,CAAC,WAAW,CAAC"}
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/confluent/schema.ts"],"names":[],"mappings":""}

package/dist/confluent/tools/base-tools.d.ts

@@ -1,10 +1,38 @@
 import { ClientManager } from "../../confluent/client-manager.js";
 import { CallToolResult } from "../../confluent/schema.js";
 import { ToolName } from "../../confluent/tools/tool-name.js";
+import { EnvVar } from "../../env-schema.js";
 import { ZodRawShape } from "zod";
 export interface ToolHandler {
-    handle(clientManager: ClientManager, toolArguments: Record<string, unknown> | undefined): Promise<CallToolResult> | CallToolResult;
+    handle(clientManager: ClientManager, toolArguments: Record<string, unknown> | undefined, sessionId?: string): Promise<CallToolResult> | CallToolResult;
     getToolConfig(): ToolConfig;
+    /**
+     * Returns an array of environment variables required for this tool to function.
+     *
+     * This method is used to conditionally enable/disable tools based on the availability
+     * of required environment variables. Tools will be disabled if any of their required
+     * environment variables are not set.
+     *
+     *
+     * Example:
+     * ```typescript
+     * getRequiredEnvVars(): EnvVar[] {
+     *   return [
+     *     "KAFKA_API_KEY",
+     *     "KAFKA_API_SECRET",
+     *     "BOOTSTRAP_SERVERS"
+     *   ];
+     * }
+     * ```
+     *
+     * @returns Array of environment variable names required by this tool
+     */
+    getRequiredEnvVars(): EnvVar[];
+    /**
+     * Returns true if this tool can only be used with Confluent Cloud REST APIs.
+     * Override in subclasses for cloud-only tools.
+     */
+    isConfluentCloudOnly(): boolean;
 }
 export interface ToolConfig {
     name: ToolName;
@@ -12,8 +40,21 @@ export interface ToolConfig {
     inputSchema: ZodRawShape;
 }
 export declare abstract class BaseToolHandler implements ToolHandler {
-    abstract handle(clientManager: ClientManager, toolArguments: Record<string, unknown> | undefined): Promise<CallToolResult> | CallToolResult;
+    abstract handle(clientManager: ClientManager, toolArguments: Record<string, unknown> | undefined, sessionId?: string): Promise<CallToolResult> | CallToolResult;
     abstract getToolConfig(): ToolConfig;
+    /**
+     * Default implementation that returns an empty array, indicating no environment
+     * variables are required. Override this method in your tool handler if the tool
+     * requires specific environment variables to function.
+     *
+     * @returns Empty array by default
+     */
+    getRequiredEnvVars(): EnvVar[];
+    /**
+     * Default implementation returns false, indicating the tool is not Confluent Cloud only.
+     * Override in subclasses for cloud-only tools.
+     */
+    isConfluentCloudOnly(): boolean;
     createResponse(message: string, isError?: boolean, _meta?: Record<string, unknown>): CallToolResult;
 }
 //# sourceMappingURL=base-tools.d.ts.map

package/dist/confluent/tools/base-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base-tools.d.ts","sourceRoot":"","sources":["../../../src/confluent/tools/base-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAAE,MAAM,mCAAmC,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,KAAK,CAAC;AAClC,MAAM,WAAW,WAAW;IAC1B,MAAM,CACJ,aAAa,EAAE,aAAa,EAC5B,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GACjD,OAAO,CAAC,cAAc,CAAC,GAAG,cAAc,CAAC;IAE5C,aAAa,IAAI,UAAU,CAAC;CAC7B;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,QAAQ,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,WAAW,CAAC;CAC1B;AAED,8BAAsB,eAAgB,YAAW,WAAW;IAC1D,QAAQ,CAAC,MAAM,CACb,aAAa,EAAE,aAAa,EAC5B,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GACjD,OAAO,CAAC,cAAc,CAAC,GAAG,cAAc;IAE3C,QAAQ,CAAC,aAAa,IAAI,UAAU;IAEpC,cAAc,CACZ,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,OAAe,EACxB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,cAAc;CAalB"}
+{"version":3,"file":"base-tools.d.ts","sourceRoot":"","sources":["../../../src/confluent/tools/base-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAAE,MAAM,mCAAmC,CAAC;AAC7D,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,KAAK,CAAC;AAElC,MAAM,WAAW,WAAW;IAC1B,MAAM,CACJ,aAAa,EAAE,aAAa,EAC5B,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAClD,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,cAAc,CAAC,GAAG,cAAc,CAAC;IAE5C,aAAa,IAAI,UAAU,CAAC;IAE5B;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,kBAAkB,IAAI,MAAM,EAAE,CAAC;IAE/B;;;OAGG;IACH,oBAAoB,IAAI,OAAO,CAAC;CACjC;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,QAAQ,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,WAAW,CAAC;CAC1B;AAED,8BAAsB,eAAgB,YAAW,WAAW;IAC1D,QAAQ,CAAC,MAAM,CACb,aAAa,EAAE,aAAa,EAC5B,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAClD,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,cAAc,CAAC,GAAG,cAAc;IAE3C,QAAQ,CAAC,aAAa,IAAI,UAAU;IAEpC;;;;;;OAMG;IACH,kBAAkB,IAAI,MAAM,EAAE;IAI9B;;;OAGG;IACH,oBAAoB,IAAI,OAAO;IAI/B,cAAc,CACZ,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,OAAe,EACxB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,cAAc;CAalB"}

package/dist/confluent/tools/base-tools.js

@@ -1,4 +1,21 @@
 export class BaseToolHandler {
+    /**
+     * Default implementation that returns an empty array, indicating no environment
+     * variables are required. Override this method in your tool handler if the tool
+     * requires specific environment variables to function.
+     *
+     * @returns Empty array by default
+     */
+    getRequiredEnvVars() {
+        return [];
+    }
+    /**
+     * Default implementation returns false, indicating the tool is not Confluent Cloud only.
+     * Override in subclasses for cloud-only tools.
+     */
+    isConfluentCloudOnly() {
+        return false;
+    }
     createResponse(message, isError = false, _meta) {
         const response = {
             content: [

package/dist/confluent/tools/base-tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"base-tools.js","sourceRoot":"","sources":["../../../src/confluent/tools/base-tools.ts"],"names":[],"mappings":"AAmBA,MAAM,OAAgB,eAAe;IAQnC,cAAc,CACZ,OAAe,EACf,UAAmB,KAAK,EACxB,KAA+B;QAE/B,MAAM,QAAQ,GAAmB;YAC/B,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,OAAO;iBACd;aACF;YACD,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,KAAK;SACb,CAAC;QACF,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF"}
+{"version":3,"file":"base-tools.js","sourceRoot":"","sources":["../../../src/confluent/tools/base-tools.ts"],"names":[],"mappings":"AAmDA,MAAM,OAAgB,eAAe;IASnC;;;;;;OAMG;IACH,kBAAkB;QAChB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED;;;OAGG;IACH,oBAAoB;QAClB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,cAAc,CACZ,OAAe,EACf,UAAmB,KAAK,EACxB,KAA+B;QAE/B,MAAM,QAAQ,GAAmB;YAC/B,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,OAAO;iBACd;aACF;YACD,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,KAAK;SACb,CAAC;QACF,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF"}

package/dist/confluent/tools/handlers/catalog/add-tags-to-topic.d.ts

@@ -1,8 +1,11 @@
 import { ClientManager } from "../../../../confluent/client-manager.js";
 import { CallToolResult } from "../../../../confluent/schema.js";
 import { BaseToolHandler, ToolConfig } from "../../../../confluent/tools/base-tools.js";
+import { EnvVar } from "../../../../env-schema.js";
 export declare class AddTagToTopicHandler extends BaseToolHandler {
     handle(clientManager: ClientManager, toolArguments: Record<string, unknown>): Promise<CallToolResult>;
     getToolConfig(): ToolConfig;
+    getRequiredEnvVars(): EnvVar[];
+    isConfluentCloudOnly(): boolean;
 }
 //# sourceMappingURL=add-tags-to-topic.d.ts.map

package/dist/confluent/tools/handlers/catalog/add-tags-to-topic.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"add-tags-to-topic.d.ts","sourceRoot":"","sources":["../../../../../src/confluent/tools/handlers/catalog/add-tags-to-topic.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EACL,eAAe,EACf,UAAU,EACX,MAAM,oCAAoC,CAAC;AA6B5C,qBAAa,oBAAqB,SAAQ,eAAe;IACjD,MAAM,CACV,aAAa,EAAE,aAAa,EAC5B,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACrC,OAAO,CAAC,cAAc,CAAC;IA6B1B,aAAa,IAAI,UAAU;CAO5B"}
+{"version":3,"file":"add-tags-to-topic.d.ts","sourceRoot":"","sources":["../../../../../src/confluent/tools/handlers/catalog/add-tags-to-topic.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EACL,eAAe,EACf,UAAU,EACX,MAAM,oCAAoC,CAAC;AAE5C,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AA4B5C,qBAAa,oBAAqB,SAAQ,eAAe;IACjD,MAAM,CACV,aAAa,EAAE,aAAa,EAC5B,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACrC,OAAO,CAAC,cAAc,CAAC;IA6B1B,aAAa,IAAI,UAAU;IAQ3B,kBAAkB,IAAI,MAAM,EAAE;IAI9B,oBAAoB,IAAI,OAAO;CAGhC"}

package/dist/confluent/tools/handlers/catalog/add-tags-to-topic.js

@@ -8,7 +8,7 @@ const addTagToTopicArguments = z.object({
         .string()
         .describe("The base URL of the Schema Registry REST API.")
         .url()
-        .default(env.SCHEMA_REGISTRY_ENDPOINT ?? "")
+        .default(() => env.SCHEMA_REGISTRY_ENDPOINT ?? "")
         .optional(),
     tagAssignments: z
         .array(z.object({
@@ -43,5 +43,11 @@ export class AddTagToTopicHandler extends BaseToolHandler {
             inputSchema: addTagToTopicArguments.shape,
         };
     }
+    getRequiredEnvVars() {
+        return ["SCHEMA_REGISTRY_API_KEY", "SCHEMA_REGISTRY_API_SECRET"];
+    }
+    isConfluentCloudOnly() {
+        return true;
+    }
 }
 //# sourceMappingURL=add-tags-to-topic.js.map

package/dist/confluent/tools/handlers/catalog/add-tags-to-topic.js.map

@@ -1 +1 @@
-{"version":3,"file":"add-tags-to-topic.js","sourceRoot":"","sources":["../../../../../src/confluent/tools/handlers/catalog/add-tags-to-topic.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,eAAe,GAEhB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,mCAAmC,CAAC;AAC7D,OAAO,GAAG,MAAM,aAAa,CAAC;AAC9B,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,QAAQ,CAAC,+CAA+C,CAAC;SACzD,GAAG,EAAE;SACL,OAAO,CAAC,GAAG,CAAC,wBAAwB,IAAI,EAAE,CAAC;SAC3C,QAAQ,EAAE;IACb,cAAc,EAAE,CAAC;SACd,KAAK,CACJ,CAAC,CAAC,MAAM,CAAC;QACP,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,aAAa,CAAC;QAC7C,UAAU,EAAE,CAAC;aACV,MAAM,EAAE;aACR,QAAQ,CACP,mFAAmF,QAAQ,CAAC,qBAAqB,oDAAoD,CACtK;QACH,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;KAC3D,CAAC,CACH;SACA,QAAQ,EAAE;SACV,QAAQ,CAAC,oCAAoC,CAAC;CAClD,CAAC,CAAC;AAEH,MAAM,OAAO,oBAAqB,SAAQ,eAAe;IACvD,KAAK,CAAC,MAAM,CACV,aAA4B,EAC5B,aAAsC;QAEtC,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,GAC/B,sBAAsB,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QAE9C,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,EAAE,EAAE,CAAC;YAC5C,aAAa,CAAC,uCAAuC,CAAC,OAAO,CAAC,CAAC;QACjE,CAAC;QAED,MAAM,eAAe,GAAG,qBAAqB,CAC3C,aAAa,CAAC,yCAAyC,EAAE,CAC1D,CAAC;QAEF,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,MAAM,eAAe,CACrD,yBAAyB,CAC1B,CAAC,IAAI,CAAC;YACL,IAAI,EAAE,cAAc;SACrB,CAAC,CAAC;QAEH,IAAI,KAAK,EAAE,CAAC;YACV,OAAO,IAAI,CAAC,cAAc,CACxB,yBAAyB,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,EAChD,IAAI,CACL,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC,cAAc,CACxB,8BAA8B,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CACzD,CAAC;IACJ,CAAC;IAED,aAAa;QACX,OAAO;YACL,IAAI,EAAE,QAAQ,CAAC,iBAAiB;YAChC,WAAW,EAAE,0DAA0D;YACvE,WAAW,EAAE,sBAAsB,CAAC,KAAK;SAC1C,CAAC;IACJ,CAAC;CACF"}
+{"version":3,"file":"add-tags-to-topic.js","sourceRoot":"","sources":["../../../../../src/confluent/tools/handlers/catalog/add-tags-to-topic.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,eAAe,GAEhB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,mCAAmC,CAAC;AAE7D,OAAO,GAAG,MAAM,aAAa,CAAC;AAC9B,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,QAAQ,CAAC,+CAA+C,CAAC;SACzD,GAAG,EAAE;SACL,OAAO,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,wBAAwB,IAAI,EAAE,CAAC;SACjD,QAAQ,EAAE;IACb,cAAc,EAAE,CAAC;SACd,KAAK,CACJ,CAAC,CAAC,MAAM,CAAC;QACP,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,aAAa,CAAC;QAC7C,UAAU,EAAE,CAAC;aACV,MAAM,EAAE;aACR,QAAQ,CACP,mFAAmF,QAAQ,CAAC,qBAAqB,oDAAoD,CACtK;QACH,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;KAC3D,CAAC,CACH;SACA,QAAQ,EAAE;SACV,QAAQ,CAAC,oCAAoC,CAAC;CAClD,CAAC,CAAC;AAEH,MAAM,OAAO,oBAAqB,SAAQ,eAAe;IACvD,KAAK,CAAC,MAAM,CACV,aAA4B,EAC5B,aAAsC;QAEtC,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,GAC/B,sBAAsB,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QAE9C,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,EAAE,EAAE,CAAC;YAC5C,aAAa,CAAC,uCAAuC,CAAC,OAAO,CAAC,CAAC;QACjE,CAAC;QAED,MAAM,eAAe,GAAG,qBAAqB,CAC3C,aAAa,CAAC,yCAAyC,EAAE,CAC1D,CAAC;QAEF,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,MAAM,eAAe,CACrD,yBAAyB,CAC1B,CAAC,IAAI,CAAC;YACL,IAAI,EAAE,cAAc;SACrB,CAAC,CAAC;QAEH,IAAI,KAAK,EAAE,CAAC;YACV,OAAO,IAAI,CAAC,cAAc,CACxB,yBAAyB,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,EAChD,IAAI,CACL,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC,cAAc,CACxB,8BAA8B,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CACzD,CAAC;IACJ,CAAC;IAED,aAAa;QACX,OAAO;YACL,IAAI,EAAE,QAAQ,CAAC,iBAAiB;YAChC,WAAW,EAAE,0DAA0D;YACvE,WAAW,EAAE,sBAAsB,CAAC,KAAK;SAC1C,CAAC;IACJ,CAAC;IAED,kBAAkB;QAChB,OAAO,CAAC,yBAAyB,EAAE,4BAA4B,CAAC,CAAC;IACnE,CAAC;IAED,oBAAoB;QAClB,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/dist/confluent/tools/handlers/catalog/create-topic-tags.d.ts

@@ -1,8 +1,11 @@
 import { ClientManager } from "../../../../confluent/client-manager.js";
 import { CallToolResult } from "../../../../confluent/schema.js";
 import { BaseToolHandler, ToolConfig } from "../../../../confluent/tools/base-tools.js";
+import { EnvVar } from "../../../../env-schema.js";
 export declare class CreateTopicTagsHandler extends BaseToolHandler {
     handle(clientManager: ClientManager, toolArguments: Record<string, unknown>): Promise<CallToolResult>;
     getToolConfig(): ToolConfig;
+    getRequiredEnvVars(): EnvVar[];
+    isConfluentCloudOnly(): boolean;
 }
 //# sourceMappingURL=create-topic-tags.d.ts.map

package/dist/confluent/tools/handlers/catalog/create-topic-tags.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-topic-tags.d.ts","sourceRoot":"","sources":["../../../../../src/confluent/tools/handlers/catalog/create-topic-tags.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EACL,eAAe,EACf,UAAU,EACX,MAAM,oCAAoC,CAAC;AA2B5C,qBAAa,sBAAuB,SAAQ,eAAe;IACnD,MAAM,CACV,aAAa,EAAE,aAAa,EAC5B,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACrC,OAAO,CAAC,cAAc,CAAC;IAkC1B,aAAa,IAAI,UAAU;CAO5B"}
+{"version":3,"file":"create-topic-tags.d.ts","sourceRoot":"","sources":["../../../../../src/confluent/tools/handlers/catalog/create-topic-tags.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EACL,eAAe,EACf,UAAU,EACX,MAAM,oCAAoC,CAAC;AAE5C,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AA0B5C,qBAAa,sBAAuB,SAAQ,eAAe;IACnD,MAAM,CACV,aAAa,EAAE,aAAa,EAC5B,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACrC,OAAO,CAAC,cAAc,CAAC;IAkC1B,aAAa,IAAI,UAAU;IAQ3B,kBAAkB,IAAI,MAAM,EAAE;IAI9B,oBAAoB,IAAI,OAAO;CAGhC"}