@confluentinc/mcp-confluent 1.0.1 → 1.0.2

package/dist/confluent/tools/handlers/kafka/alter-topic-config.d.ts

@@ -1,6 +1,7 @@
 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";
 /**
  * Handler for altering Kafka topic configurations through Confluent Cloud REST API.
  * This implementation serves as a workaround since the native Kafka
@@ -10,5 +11,7 @@ import { BaseToolHandler, ToolConfig } from "../../../../confluent/tools/base-to
 export declare class AlterTopicConfigHandler extends BaseToolHandler {
     handle(clientManager: ClientManager, toolArguments: Record<string, unknown>): Promise<CallToolResult>;
     getToolConfig(): ToolConfig;
+    getRequiredEnvVars(): EnvVar[];
+    isConfluentCloudOnly(): boolean;
 }
 //# sourceMappingURL=alter-topic-config.d.ts.map

package/dist/confluent/tools/handlers/kafka/alter-topic-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"alter-topic-config.d.ts","sourceRoot":"","sources":["../../../../../src/confluent/tools/handlers/kafka/alter-topic-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAEjE,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EACL,eAAe,EACf,UAAU,EACX,MAAM,oCAAoC,CAAC;AA8B5C;;;;;GAKG;AACH,qBAAa,uBAAwB,SAAQ,eAAe;IACpD,MAAM,CACV,aAAa,EAAE,aAAa,EAC5B,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACrC,OAAO,CAAC,cAAc,CAAC;IAsC1B,aAAa,IAAI,UAAU;CAO5B"}
+{"version":3,"file":"alter-topic-config.d.ts","sourceRoot":"","sources":["../../../../../src/confluent/tools/handlers/kafka/alter-topic-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAEjE,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;AA6B5C;;;;;GAKG;AACH,qBAAa,uBAAwB,SAAQ,eAAe;IACpD,MAAM,CACV,aAAa,EAAE,aAAa,EAC5B,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACrC,OAAO,CAAC,cAAc,CAAC;IAsC1B,aAAa,IAAI,UAAU;IAQ3B,kBAAkB,IAAI,MAAM,EAAE;IAI9B,oBAAoB,IAAI,OAAO;CAGhC"}

package/dist/confluent/tools/handlers/kafka/alter-topic-config.js

@@ -9,7 +9,7 @@ const alterTopicConfigArguments = z.object({
         .string()
         .describe("The base URL of the Confluent Cloud Kafka REST API.")
         .url()
-        .default(env.KAFKA_REST_ENDPOINT ?? "")
+        .default(() => env.KAFKA_REST_ENDPOINT ?? "")
         .optional(),
     clusterId: z
         .string()
@@ -57,5 +57,11 @@ export class AlterTopicConfigHandler extends BaseToolHandler {
             inputSchema: alterTopicConfigArguments.shape,
         };
     }
+    getRequiredEnvVars() {
+        return ["KAFKA_API_KEY", "KAFKA_API_SECRET", "BOOTSTRAP_SERVERS"];
+    }
+    isConfluentCloudOnly() {
+        return true;
+    }
 }
 //# sourceMappingURL=alter-topic-config.js.map

package/dist/confluent/tools/handlers/kafka/alter-topic-config.js.map

@@ -1 +1 @@
-{"version":3,"file":"alter-topic-config.js","sourceRoot":"","sources":["../../../../../src/confluent/tools/handlers/kafka/alter-topic-config.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAE5D,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,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,QAAQ,CAAC,qDAAqD,CAAC;SAC/D,GAAG,EAAE;SACL,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,EAAE,CAAC;SACtC,QAAQ,EAAE;IACb,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,8CAA8C,CAAC;IAC3D,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC,CAAC,QAAQ,EAAE;IACvE,YAAY,EAAE,CAAC;SACZ,KAAK,CACJ,CAAC,CAAC,MAAM,CAAC;QACP,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC,CAAC,QAAQ,EAAE;QACpE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;QAC3D,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,gBAAgB,CAAC;KAChE,CAAC,CACH;SACA,QAAQ,EAAE;IACb,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;CACzC,CAAC,CAAC;AAEH;;;;;GAKG;AACH,MAAM,OAAO,uBAAwB,SAAQ,eAAe;IAC1D,KAAK,CAAC,MAAM,CACV,aAA4B,EAC5B,aAAsC;QAEtC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,EAAE,OAAO,EAAE,GACjE,yBAAyB,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QACjD,MAAM,gBAAgB,GAAG,eAAe,CACtC,kBAAkB,EAClB,8BAA8B,EAC9B,SAAS,CACV,CAAC;QAEF,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,EAAE,EAAE,CAAC;YAC5C,aAAa,CAAC,kCAAkC,CAAC,OAAO,CAAC,CAAC;QAC5D,CAAC;QAED,MAAM,eAAe,GAAG,qBAAqB,CAC3C,aAAa,CAAC,gCAAgC,EAAE,CACjD,CAAC;QAEF,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,MAAM,eAAe,CACrD,sBAAsB,gBAAgB,WAAW,SAAS,gBAAgB,CAC3E,CAAC,IAAI,CAAC;YACL,IAAI,EAAE;gBACJ,IAAI,EAAE,YAAY;gBAClB,aAAa,EAAE,YAAY;aAC5B;SACF,CAAC,CAAC;QAEH,IAAI,KAAK,EAAE,CAAC;YACV,OAAO,IAAI,CAAC,cAAc,CACxB,iCAAiC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,EACxD,IAAI,CACL,CAAC;QACJ,CAAC;QAED,OAAO,IAAI,CAAC,cAAc,CACxB,sCAAsC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CACjE,CAAC;IACJ,CAAC;IAED,aAAa;QACX,OAAO;YACL,IAAI,EAAE,QAAQ,CAAC,kBAAkB;YACjC,WAAW,EAAE,+CAA+C;YAC5D,WAAW,EAAE,yBAAyB,CAAC,KAAK;SAC7C,CAAC;IACJ,CAAC;CACF"}
+{"version":3,"file":"alter-topic-config.js","sourceRoot":"","sources":["../../../../../src/confluent/tools/handlers/kafka/alter-topic-config.ts"],"names":[],"mappings":"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"}

package/dist/confluent/tools/handlers/kafka/consume-kafka-messages-handler.d.ts

@@ -0,0 +1,117 @@
+import { KafkaMessage } from "@confluentinc/kafka-javascript/types/kafkajs.js";
+import { SchemaRegistryClient } from "@confluentinc/schemaregistry";
+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";
+import { z } from "zod";
+declare const valueOptions: z.ZodObject<{
+    useSchemaRegistry: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    subject: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    useSchemaRegistry: boolean;
+    subject?: string | undefined;
+}, {
+    subject?: string | undefined;
+    useSchemaRegistry?: boolean | undefined;
+}>;
+declare const keyOptions: z.ZodObject<{
+    useSchemaRegistry: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    subject: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    useSchemaRegistry: boolean;
+    subject?: string | undefined;
+}, {
+    subject?: string | undefined;
+    useSchemaRegistry?: boolean | undefined;
+}>;
+type ValueOptions = z.infer<typeof valueOptions>;
+type KeyOptions = z.infer<typeof keyOptions>;
+export declare const consumeKafkaMessagesArgs: z.ZodObject<{
+    topicNames: z.ZodArray<z.ZodString, "atleastone">;
+    maxMessages: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    timeoutMs: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    value: z.ZodObject<{
+        useSchemaRegistry: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        subject: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        useSchemaRegistry: boolean;
+        subject?: string | undefined;
+    }, {
+        subject?: string | undefined;
+        useSchemaRegistry?: boolean | undefined;
+    }>;
+    key: z.ZodOptional<z.ZodObject<{
+        useSchemaRegistry: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        subject: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        useSchemaRegistry: boolean;
+        subject?: string | undefined;
+    }, {
+        subject?: string | undefined;
+        useSchemaRegistry?: boolean | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    value: {
+        useSchemaRegistry: boolean;
+        subject?: string | undefined;
+    };
+    topicNames: [string, ...string[]];
+    maxMessages: number;
+    timeoutMs: number;
+    key?: {
+        useSchemaRegistry: boolean;
+        subject?: string | undefined;
+    } | undefined;
+}, {
+    value: {
+        subject?: string | undefined;
+        useSchemaRegistry?: boolean | undefined;
+    };
+    topicNames: [string, ...string[]];
+    key?: {
+        subject?: string | undefined;
+        useSchemaRegistry?: boolean | undefined;
+    } | undefined;
+    maxMessages?: number | undefined;
+    timeoutMs?: number | undefined;
+}>;
+interface ProcessedMessage {
+    key: unknown;
+    value: unknown;
+    timestamp: string;
+    offset: string;
+    headers?: Record<string, string>;
+    topic: string;
+    partition: number;
+}
+/**
+ * Handler for consuming messages from Kafka topics with support for Schema Registry deserialization.
+ * This handler allows consuming messages from one or more topics with configurable message limits and timeouts.
+ * It supports automatic deserialization of Schema Registry encoded messages (AVRO, JSON, PROTOBUF).
+ */
+export declare class ConsumeKafkaMessagesHandler extends BaseToolHandler {
+    /**
+     * Processes a single Kafka message, handling deserialization of both key and value.
+     * @param topic - The topic the message was consumed from
+     * @param partition - The partition the message was consumed from
+     * @param message - The raw Kafka message
+     * @param registry - Optional Schema Registry client for deserialization
+     * @param valueOptions - Options for value deserialization
+     * @param keyOptions - Optional options for key deserialization
+     * @returns A processed message with deserialized key and value
+     */
+    processMessage(topic: string, partition: number, message: KafkaMessage, registry: SchemaRegistryClient | undefined, valueOptions: ValueOptions, keyOptions?: KeyOptions): Promise<ProcessedMessage>;
+    /**
+     * Main handler for consuming messages from Kafka topics.
+     * @param clientManager - The client manager for Kafka and registry clients
+     * @param toolArguments - The arguments for the tool, including topics, message limits, and deserialization options
+     * @param sessionId - Optional session ID for Kafka consumer
+     * @returns A CallToolResult containing the consumed messages or error information
+     */
+    handle(clientManager: ClientManager, toolArguments: z.infer<typeof consumeKafkaMessagesArgs>, sessionId?: string): Promise<CallToolResult>;
+    getToolConfig(): ToolConfig;
+    getRequiredEnvVars(): EnvVar[];
+}
+export {};
+//# sourceMappingURL=consume-kafka-messages-handler.d.ts.map

package/dist/confluent/tools/handlers/kafka/consume-kafka-messages-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consume-kafka-messages-handler.d.ts","sourceRoot":"","sources":["../../../../../src/confluent/tools/handlers/kafka/consume-kafka-messages-handler.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,iDAAiD,CAAC;AAC/E,OAAO,EAAE,oBAAoB,EAAa,MAAM,8BAA8B,CAAC;AAC/E,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAKjE,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;AAE5C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAkBxB,QAAA,MAAM,YAAY;;;;;;;;;EAA4C,CAAC;AAC/D,QAAA,MAAM,UAAU;;;;;;;;;EAA4C,CAAC;AAE7D,KAAK,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AACjD,KAAK,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAE7C,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAuBnC,CAAC;AAEH,UAAU,gBAAgB;IACxB,GAAG,EAAE,OAAO,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,qBAAa,2BAA4B,SAAQ,eAAe;IAC9D;;;;;;;;;OASG;IACG,cAAc,CAClB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,YAAY,EACrB,QAAQ,EAAE,oBAAoB,GAAG,SAAS,EAC1C,YAAY,EAAE,YAAY,EAC1B,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,gBAAgB,CAAC;IAmE5B;;;;;;OAMG;IACG,MAAM,CACV,aAAa,EAAE,aAAa,EAC5B,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,EACvD,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,cAAc,CAAC;IA8E1B,aAAa,IAAI,UAAU;IAS3B,kBAAkB,IAAI,MAAM,EAAE;CAG/B"}

package/dist/confluent/tools/handlers/kafka/consume-kafka-messages-handler.js

@@ -0,0 +1,177 @@
+import { KafkaJS } from "@confluentinc/kafka-javascript";
+import { SerdeType } from "@confluentinc/schemaregistry";
+import { deserializeMessage, getLatestSchemaIfExists, } from "../../../../confluent/schema-registry-helper.js";
+import { BaseToolHandler, } from "../../../../confluent/tools/base-tools.js";
+import { ToolName } from "../../../../confluent/tools/tool-name.js";
+import { logger } from "../../../../logger.js";
+import { z } from "zod";
+const messageOptions = z.object({
+    useSchemaRegistry: z
+        .boolean()
+        .optional()
+        .default(false)
+        .describe("Whether to use schema registry for deserialization. If false, messages will be returned as raw."),
+    subject: z
+        .string()
+        .optional()
+        .describe("Schema registry subject. Defaults to 'topicName-value' or 'topicName-key'."),
+});
+const valueOptions = z.object({}).extend(messageOptions.shape);
+const keyOptions = z.object({}).extend(messageOptions.shape);
+export const consumeKafkaMessagesArgs = z.object({
+    topicNames: z
+        .array(z.string())
+        .nonempty()
+        .describe("Names of the Kafka topics to consume from."),
+    maxMessages: z
+        .number()
+        .int()
+        .positive()
+        .optional()
+        .default(10)
+        .describe("Maximum number of messages to consume before stopping."),
+    timeoutMs: z
+        .number()
+        .int()
+        .positive()
+        .optional()
+        .default(10000)
+        .describe("Maximum time in milliseconds to wait for messages before stopping."),
+    value: valueOptions,
+    key: keyOptions.optional(),
+});
+/**
+ * Handler for consuming messages from Kafka topics with support for Schema Registry deserialization.
+ * This handler allows consuming messages from one or more topics with configurable message limits and timeouts.
+ * It supports automatic deserialization of Schema Registry encoded messages (AVRO, JSON, PROTOBUF).
+ */
+export class ConsumeKafkaMessagesHandler extends BaseToolHandler {
+    /**
+     * Processes a single Kafka message, handling deserialization of both key and value.
+     * @param topic - The topic the message was consumed from
+     * @param partition - The partition the message was consumed from
+     * @param message - The raw Kafka message
+     * @param registry - Optional Schema Registry client for deserialization
+     * @param valueOptions - Options for value deserialization
+     * @param keyOptions - Optional options for key deserialization
+     * @returns A processed message with deserialized key and value
+     */
+    async processMessage(topic, partition, message, registry, valueOptions, keyOptions) {
+        let processedKey = message.key?.toString();
+        let processedValue = message.value?.toString();
+        const deserializeWithOptions = async (buffer, options, serdeType) => {
+            if (!options.useSchemaRegistry || !registry) {
+                return buffer?.toString();
+            }
+            const subject = options.subject ||
+                `${topic}-${serdeType === SerdeType.KEY ? "key" : "value"}`;
+            const schema = await getLatestSchemaIfExists(registry, subject);
+            if (!schema || !schema.schemaType) {
+                return buffer?.toString();
+            }
+            try {
+                return await deserializeMessage(topic, buffer, schema.schemaType, registry, serdeType);
+            }
+            catch (err) {
+                logger.error({ error: err, topic, schemaType: schema.schemaType, serdeType }, `Error deserializing message ${serdeType} for topic ${topic}`);
+                return buffer?.toString();
+            }
+        };
+        processedValue = await deserializeWithOptions(message.value, valueOptions, SerdeType.VALUE);
+        if (message.key && keyOptions) {
+            processedKey = await deserializeWithOptions(message.key, keyOptions, SerdeType.KEY);
+        }
+        return {
+            key: processedKey,
+            value: processedValue,
+            timestamp: message.timestamp,
+            offset: message.offset,
+            headers: message.headers
+                ? Object.fromEntries(Object.entries(message.headers).map(([key, value]) => [
+                    key,
+                    value?.toString() || "",
+                ]))
+                : undefined,
+            topic,
+            partition,
+        };
+    }
+    /**
+     * Main handler for consuming messages from Kafka topics.
+     * @param clientManager - The client manager for Kafka and registry clients
+     * @param toolArguments - The arguments for the tool, including topics, message limits, and deserialization options
+     * @param sessionId - Optional session ID for Kafka consumer
+     * @returns A CallToolResult containing the consumed messages or error information
+     */
+    async handle(clientManager, toolArguments, sessionId) {
+        const { topicNames, maxMessages, timeoutMs, value, key } = consumeKafkaMessagesArgs.parse(toolArguments);
+        const consumedMessages = [];
+        let timeoutReached = false;
+        let consumer;
+        const registry = value.useSchemaRegistry || (key && key.useSchemaRegistry)
+            ? clientManager.getSchemaRegistryClient()
+            : undefined;
+        try {
+            consumer = await clientManager.getConsumer(sessionId);
+            await consumer.connect();
+            await consumer.subscribe({ topics: topicNames });
+            const consumePromise = new Promise((resolve, reject) => {
+                if (!consumer) {
+                    reject(new Error("Consumer was unexpectedly undefined"));
+                    return;
+                }
+                consumer
+                    .run({
+                    eachMessage: async ({ topic, partition, message }) => {
+                        if (timeoutReached)
+                            return;
+                        const processed = await this.processMessage(topic, partition, message, registry, value, key);
+                        consumedMessages.push(processed);
+                        if (consumedMessages.length >= maxMessages) {
+                            timeoutReached = true;
+                            resolve();
+                        }
+                    },
+                })
+                    .catch((error) => {
+                    reject(error);
+                });
+                setTimeout(() => {
+                    timeoutReached = true;
+                    resolve();
+                }, timeoutMs);
+            });
+            await consumePromise;
+            return this.createResponse(`Consumed ${consumedMessages.length} messages from topics ${topicNames.join(", ")}.\nConsumed messages: ${JSON.stringify(consumedMessages, null, 2)}`, false);
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error
+                ? error.message
+                : error instanceof KafkaJS.KafkaJSError
+                    ? `Kafka error (${error.code}): ${error.message}`
+                    : String(error);
+            return this.createResponse(`Failed to consume messages: ${errorMessage}`, true);
+        }
+        finally {
+            if (consumer) {
+                try {
+                    await consumer.disconnect();
+                }
+                catch (error) {
+                    logger.error({ error }, "Error cleaning up consumer");
+                }
+            }
+        }
+    }
+    getToolConfig() {
+        return {
+            name: ToolName.CONSUME_MESSAGES,
+            description: "Consumes messages from one or more Kafka topics. Supports automatic deserialization of Schema Registry encoded messages (AVRO, JSON, PROTOBUF).",
+            inputSchema: consumeKafkaMessagesArgs.shape,
+        };
+    }
+    getRequiredEnvVars() {
+        return ["KAFKA_API_KEY", "KAFKA_API_SECRET", "BOOTSTRAP_SERVERS"];
+    }
+}
+//# sourceMappingURL=consume-kafka-messages-handler.js.map

package/dist/confluent/tools/handlers/kafka/consume-kafka-messages-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consume-kafka-messages-handler.js","sourceRoot":"","sources":["../../../../../src/confluent/tools/handlers/kafka/consume-kafka-messages-handler.ts"],"names":[],"mappings":"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"}

package/dist/confluent/tools/handlers/kafka/create-topics-handler.d.ts

@@ -1,8 +1,10 @@
 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 CreateTopicsHandler extends BaseToolHandler {
     handle(clientManager: ClientManager, toolArguments: Record<string, unknown>): Promise<CallToolResult>;
     getToolConfig(): ToolConfig;
+    getRequiredEnvVars(): EnvVar[];
 }
 //# sourceMappingURL=create-topics-handler.d.ts.map

package/dist/confluent/tools/handlers/kafka/create-topics-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-topics-handler.d.ts","sourceRoot":"","sources":["../../../../../src/confluent/tools/handlers/kafka/create-topics-handler.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;AAS5C,qBAAa,mBAAoB,SAAQ,eAAe;IAChD,MAAM,CACV,aAAa,EAAE,aAAa,EAC5B,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACrC,OAAO,CAAC,cAAc,CAAC;IAgB1B,aAAa,IAAI,UAAU;CAO5B"}
+{"version":3,"file":"create-topics-handler.d.ts","sourceRoot":"","sources":["../../../../../src/confluent/tools/handlers/kafka/create-topics-handler.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;AAQ5C,qBAAa,mBAAoB,SAAQ,eAAe;IAChD,MAAM,CACV,aAAa,EAAE,aAAa,EAC5B,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACrC,OAAO,CAAC,cAAc,CAAC;IAgB1B,aAAa,IAAI,UAAU;IAQ3B,kBAAkB,IAAI,MAAM,EAAE;CAG/B"}

package/dist/confluent/tools/handlers/kafka/create-topics-handler.js

@@ -20,9 +20,12 @@ export class CreateTopicsHandler extends BaseToolHandler {
     getToolConfig() {
         return {
             name: ToolName.CREATE_TOPICS,
-            description: "Create new topic(s) in the Kafka cluster.",
+            description: "Create one or more Kafka topics.",
             inputSchema: createTopicArgs.shape,
         };
     }
+    getRequiredEnvVars() {
+        return ["KAFKA_API_KEY", "KAFKA_API_SECRET", "BOOTSTRAP_SERVERS"];
+    }
 }
 //# sourceMappingURL=create-topics-handler.js.map

package/dist/confluent/tools/handlers/kafka/create-topics-handler.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-topics-handler.js","sourceRoot":"","sources":["../../../../../src/confluent/tools/handlers/kafka/create-topics-handler.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,eAAe,GAEhB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,mCAAmC,CAAC;AAC7D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/B,UAAU,EAAE,CAAC;SACV,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC,CAAC;SAC7D,QAAQ,EAAE;CACd,CAAC,CAAC;AACH,MAAM,OAAO,mBAAoB,SAAQ,eAAe;IACtD,KAAK,CAAC,MAAM,CACV,aAA4B,EAC5B,aAAsC;QAEtC,MAAM,EAAE,UAAU,EAAE,GAAG,eAAe,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QAC5D,MAAM,OAAO,GAAG,MAAM,CACpB,MAAM,aAAa,CAAC,cAAc,EAAE,CACrC,CAAC,YAAY,CAAC;YACb,MAAM,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;SACpD,CAAC,CAAC;QACH,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,IAAI,CAAC,cAAc,CACxB,kCAAkC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EACxD,IAAI,CACL,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC,cAAc,CAAC,yBAAyB,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC9E,CAAC;IAED,aAAa;QACX,OAAO;YACL,IAAI,EAAE,QAAQ,CAAC,aAAa;YAC5B,WAAW,EAAE,2CAA2C;YACxD,WAAW,EAAE,eAAe,CAAC,KAAK;SACnC,CAAC;IACJ,CAAC;CACF"}
+{"version":3,"file":"create-topics-handler.js","sourceRoot":"","sources":["../../../../../src/confluent/tools/handlers/kafka/create-topics-handler.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,eAAe,GAEhB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,mCAAmC,CAAC;AAE7D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/B,UAAU,EAAE,CAAC;SACV,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC,CAAC;SAC7D,QAAQ,EAAE;CACd,CAAC,CAAC;AACH,MAAM,OAAO,mBAAoB,SAAQ,eAAe;IACtD,KAAK,CAAC,MAAM,CACV,aAA4B,EAC5B,aAAsC;QAEtC,MAAM,EAAE,UAAU,EAAE,GAAG,eAAe,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QAC5D,MAAM,OAAO,GAAG,MAAM,CACpB,MAAM,aAAa,CAAC,cAAc,EAAE,CACrC,CAAC,YAAY,CAAC;YACb,MAAM,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;SACpD,CAAC,CAAC;QACH,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,IAAI,CAAC,cAAc,CACxB,kCAAkC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EACxD,IAAI,CACL,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC,cAAc,CAAC,yBAAyB,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC9E,CAAC;IAED,aAAa;QACX,OAAO;YACL,IAAI,EAAE,QAAQ,CAAC,aAAa;YAC5B,WAAW,EAAE,kCAAkC;YAC/C,WAAW,EAAE,eAAe,CAAC,KAAK;SACnC,CAAC;IACJ,CAAC;IAED,kBAAkB;QAChB,OAAO,CAAC,eAAe,EAAE,kBAAkB,EAAE,mBAAmB,CAAC,CAAC;IACpE,CAAC;CACF"}

package/dist/confluent/tools/handlers/kafka/delete-topics-handler.d.ts

@@ -1,8 +1,10 @@
 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 DeleteTopicsHandler extends BaseToolHandler {
     handle(clientManager: ClientManager, toolArguments: Record<string, unknown>): Promise<CallToolResult>;
     getToolConfig(): ToolConfig;
+    getRequiredEnvVars(): EnvVar[];
 }
 //# sourceMappingURL=delete-topics-handler.d.ts.map

package/dist/confluent/tools/handlers/kafka/delete-topics-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"delete-topics-handler.d.ts","sourceRoot":"","sources":["../../../../../src/confluent/tools/handlers/kafka/delete-topics-handler.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;AAS5C,qBAAa,mBAAoB,SAAQ,eAAe;IAChD,MAAM,CACV,aAAa,EAAE,aAAa,EAC5B,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACrC,OAAO,CAAC,cAAc,CAAC;IAQ1B,aAAa,IAAI,UAAU;CAO5B"}
+{"version":3,"file":"delete-topics-handler.d.ts","sourceRoot":"","sources":["../../../../../src/confluent/tools/handlers/kafka/delete-topics-handler.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;AAQ5C,qBAAa,mBAAoB,SAAQ,eAAe;IAChD,MAAM,CACV,aAAa,EAAE,aAAa,EAC5B,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACrC,OAAO,CAAC,cAAc,CAAC;IAQ1B,aAAa,IAAI,UAAU;IAQ3B,kBAAkB,IAAI,MAAM,EAAE;CAG/B"}

package/dist/confluent/tools/handlers/kafka/delete-topics-handler.js

@@ -19,5 +19,8 @@ export class DeleteTopicsHandler extends BaseToolHandler {
             inputSchema: deleteKafkaTopicsArguments.shape,
         };
     }
+    getRequiredEnvVars() {
+        return ["KAFKA_API_KEY", "KAFKA_API_SECRET", "BOOTSTRAP_SERVERS"];
+    }
 }
 //# sourceMappingURL=delete-topics-handler.js.map

package/dist/confluent/tools/handlers/kafka/delete-topics-handler.js.map

@@ -1 +1 @@
-{"version":3,"file":"delete-topics-handler.js","sourceRoot":"","sources":["../../../../../src/confluent/tools/handlers/kafka/delete-topics-handler.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,eAAe,GAEhB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,mCAAmC,CAAC;AAC7D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,UAAU,EAAE,CAAC;SACV,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC,CAAC;SAC7D,QAAQ,EAAE;CACd,CAAC,CAAC;AACH,MAAM,OAAO,mBAAoB,SAAQ,eAAe;IACtD,KAAK,CAAC,MAAM,CACV,aAA4B,EAC5B,aAAsC;QAEtC,MAAM,EAAE,UAAU,EAAE,GAAG,0BAA0B,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QACvE,MAAM,CACJ,MAAM,aAAa,CAAC,cAAc,EAAE,CACrC,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;QACvC,OAAO,IAAI,CAAC,cAAc,CAAC,yBAAyB,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC9E,CAAC;IAED,aAAa;QACX,OAAO;YACL,IAAI,EAAE,QAAQ,CAAC,aAAa;YAC5B,WAAW,EAAE,wCAAwC;YACrD,WAAW,EAAE,0BAA0B,CAAC,KAAK;SAC9C,CAAC;IACJ,CAAC;CACF"}
+{"version":3,"file":"delete-topics-handler.js","sourceRoot":"","sources":["../../../../../src/confluent/tools/handlers/kafka/delete-topics-handler.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,eAAe,GAEhB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,mCAAmC,CAAC;AAE7D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,UAAU,EAAE,CAAC;SACV,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC,CAAC;SAC7D,QAAQ,EAAE;CACd,CAAC,CAAC;AACH,MAAM,OAAO,mBAAoB,SAAQ,eAAe;IACtD,KAAK,CAAC,MAAM,CACV,aAA4B,EAC5B,aAAsC;QAEtC,MAAM,EAAE,UAAU,EAAE,GAAG,0BAA0B,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QACvE,MAAM,CACJ,MAAM,aAAa,CAAC,cAAc,EAAE,CACrC,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;QACvC,OAAO,IAAI,CAAC,cAAc,CAAC,yBAAyB,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC9E,CAAC;IAED,aAAa;QACX,OAAO;YACL,IAAI,EAAE,QAAQ,CAAC,aAAa;YAC5B,WAAW,EAAE,wCAAwC;YACrD,WAAW,EAAE,0BAA0B,CAAC,KAAK;SAC9C,CAAC;IACJ,CAAC;IAED,kBAAkB;QAChB,OAAO,CAAC,eAAe,EAAE,kBAAkB,EAAE,mBAAmB,CAAC,CAAC;IACpE,CAAC;CACF"}

package/dist/confluent/tools/handlers/kafka/get-topic-config.d.ts

@@ -0,0 +1,16 @@
+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";
+/**
+ * Handler for retrieving Kafka topic configurations through Confluent Cloud REST API.
+ * This implementation uses Confluent's REST API endpoints to fetch topic configuration
+ * details that aren't directly accessible through the native Kafka admin client API.
+ */
+export declare class GetTopicConfigHandler extends BaseToolHandler {
+    handle(clientManager: ClientManager, toolArguments: Record<string, unknown>): Promise<CallToolResult>;
+    getToolConfig(): ToolConfig;
+    getRequiredEnvVars(): EnvVar[];
+    isConfluentCloudOnly(): boolean;
+}
+//# sourceMappingURL=get-topic-config.d.ts.map

package/dist/confluent/tools/handlers/kafka/get-topic-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-topic-config.d.ts","sourceRoot":"","sources":["../../../../../src/confluent/tools/handlers/kafka/get-topic-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAEjE,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;AAsB5C;;;;GAIG;AACH,qBAAa,qBAAsB,SAAQ,eAAe;IAClD,MAAM,CACV,aAAa,EAAE,aAAa,EAC5B,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACrC,OAAO,CAAC,cAAc,CAAC;IAsD1B,aAAa,IAAI,UAAU;IAQ3B,kBAAkB,IAAI,MAAM,EAAE;IAI9B,oBAAoB,IAAI,OAAO;CAGhC"}

package/dist/confluent/tools/handlers/kafka/get-topic-config.js

@@ -0,0 +1,67 @@
+import { getEnsuredParam } from "../../../../confluent/helpers.js";
+import { BaseToolHandler, } from "../../../../confluent/tools/base-tools.js";
+import { ToolName } from "../../../../confluent/tools/tool-name.js";
+import env from "../../../../env.js";
+import { wrapAsPathBasedClient } from "openapi-fetch";
+import { z } from "zod";
+const getTopicConfigArguments = z.object({
+    baseUrl: z
+        .string()
+        .describe("The base URL of the Confluent Cloud Kafka REST API.")
+        .url()
+        .default(() => env.KAFKA_REST_ENDPOINT ?? "")
+        .optional(),
+    clusterId: z
+        .string()
+        .optional()
+        .describe("The unique identifier for the Kafka cluster."),
+    topicName: z
+        .string()
+        .describe("Name of the topic to get configuration for")
+        .nonempty(),
+});
+/**
+ * Handler for retrieving Kafka topic configurations through Confluent Cloud REST API.
+ * This implementation uses Confluent's REST API endpoints to fetch topic configuration
+ * details that aren't directly accessible through the native Kafka admin client API.
+ */
+export class GetTopicConfigHandler extends BaseToolHandler {
+    async handle(clientManager, toolArguments) {
+        const { clusterId, topicName, baseUrl } = getTopicConfigArguments.parse(toolArguments);
+        const kafka_cluster_id = getEnsuredParam("KAFKA_CLUSTER_ID", "Kafka Cluster ID is required", clusterId);
+        if (baseUrl !== undefined && baseUrl !== "") {
+            clientManager.setConfluentCloudKafkaRestEndpoint(baseUrl);
+        }
+        const pathBasedClient = wrapAsPathBasedClient(clientManager.getConfluentCloudKafkaRestClient());
+        // First, get topic details
+        const { data: topicData, error: topicError } = await pathBasedClient[`/kafka/v3/clusters/${kafka_cluster_id}/topics/${topicName}`].GET();
+        if (topicError) {
+            return this.createResponse(`Failed to retrieve topic details: ${JSON.stringify(topicError)}`, true);
+        }
+        // Then, get topic configurations
+        const { data: configData, error: configError } = await pathBasedClient[`/kafka/v3/clusters/${kafka_cluster_id}/topics/${topicName}/configs`].GET();
+        if (configError) {
+            return this.createResponse(`Failed to retrieve topic configuration: ${JSON.stringify(configError)}`, true);
+        }
+        // Combine topic details and configuration into a single response
+        const response = {
+            topicDetails: topicData,
+            topicConfig: configData,
+        };
+        return this.createResponse(`Topic configuration for '${topicName}':\n${JSON.stringify(response, null, 2)}`);
+    }
+    getToolConfig() {
+        return {
+            name: ToolName.GET_TOPIC_CONFIG,
+            description: "Retrieve configuration details for a specific Kafka topic.",
+            inputSchema: getTopicConfigArguments.shape,
+        };
+    }
+    getRequiredEnvVars() {
+        return ["KAFKA_API_KEY", "KAFKA_API_SECRET", "BOOTSTRAP_SERVERS"];
+    }
+    isConfluentCloudOnly() {
+        return true;
+    }
+}
+//# sourceMappingURL=get-topic-config.js.map

package/dist/confluent/tools/handlers/kafka/get-topic-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-topic-config.js","sourceRoot":"","sources":["../../../../../src/confluent/tools/handlers/kafka/get-topic-config.ts"],"names":[],"mappings":"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"}

package/dist/confluent/tools/handlers/kafka/list-topics-handler.d.ts

@@ -1,8 +1,10 @@
 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 ListTopicsHandler extends BaseToolHandler {
     handle(clientManager: ClientManager, toolArguments: Record<string, unknown>): Promise<CallToolResult>;
     getToolConfig(): ToolConfig;
+    getRequiredEnvVars(): EnvVar[];
 }
 //# sourceMappingURL=list-topics-handler.d.ts.map

package/dist/confluent/tools/handlers/kafka/list-topics-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list-topics-handler.d.ts","sourceRoot":"","sources":["../../../../../src/confluent/tools/handlers/kafka/list-topics-handler.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;AAQ5C,qBAAa,iBAAkB,SAAQ,eAAe;IAC9C,MAAM,CACV,aAAa,EAAE,aAAa,EAE5B,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACrC,OAAO,CAAC,cAAc,CAAC;IAK1B,aAAa,IAAI,UAAU;CAO5B"}
+{"version":3,"file":"list-topics-handler.d.ts","sourceRoot":"","sources":["../../../../../src/confluent/tools/handlers/kafka/list-topics-handler.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;AAO5C,qBAAa,iBAAkB,SAAQ,eAAe;IAC9C,MAAM,CACV,aAAa,EAAE,aAAa,EAE5B,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACrC,OAAO,CAAC,cAAc,CAAC;IAK1B,aAAa,IAAI,UAAU;IAQ3B,kBAAkB,IAAI,MAAM,EAAE;CAG/B"}

package/dist/confluent/tools/handlers/kafka/list-topics-handler.js

@@ -18,5 +18,8 @@ export class ListTopicsHandler extends BaseToolHandler {
             inputSchema: listTopicArgs.shape,
         };
     }
+    getRequiredEnvVars() {
+        return ["KAFKA_API_KEY", "KAFKA_API_SECRET", "BOOTSTRAP_SERVERS"];
+    }
 }
 //# sourceMappingURL=list-topics-handler.js.map

package/dist/confluent/tools/handlers/kafka/list-topics-handler.js.map

@@ -1 +1 @@
-{"version":3,"file":"list-topics-handler.js","sourceRoot":"","sources":["../../../../../src/confluent/tools/handlers/kafka/list-topics-handler.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,eAAe,GAEhB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,mCAAmC,CAAC;AAC7D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC;AAC7B,eAAe;CAChB,CAAC,CAAC;AAEH,MAAM,OAAO,iBAAkB,SAAQ,eAAe;IACpD,KAAK,CAAC,MAAM,CACV,aAA4B;IAC5B,6DAA6D;IAC7D,aAAsC;QAEtC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,aAAa,CAAC,cAAc,EAAE,CAAC,CAAC,UAAU,EAAE,CAAC;QACzE,OAAO,IAAI,CAAC,cAAc,CAAC,iBAAiB,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAClE,CAAC;IAED,aAAa;QACX,OAAO;YACL,IAAI,EAAE,QAAQ,CAAC,WAAW;YAC1B,WAAW,EAAE,uCAAuC;YACpD,WAAW,EAAE,aAAa,CAAC,KAAK;SACjC,CAAC;IACJ,CAAC;CACF"}
+{"version":3,"file":"list-topics-handler.js","sourceRoot":"","sources":["../../../../../src/confluent/tools/handlers/kafka/list-topics-handler.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,eAAe,GAEhB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,mCAAmC,CAAC;AAE7D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC;AAC7B,eAAe;CAChB,CAAC,CAAC;AAEH,MAAM,OAAO,iBAAkB,SAAQ,eAAe;IACpD,KAAK,CAAC,MAAM,CACV,aAA4B;IAC5B,6DAA6D;IAC7D,aAAsC;QAEtC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,aAAa,CAAC,cAAc,EAAE,CAAC,CAAC,UAAU,EAAE,CAAC;QACzE,OAAO,IAAI,CAAC,cAAc,CAAC,iBAAiB,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAClE,CAAC;IAED,aAAa;QACX,OAAO;YACL,IAAI,EAAE,QAAQ,CAAC,WAAW;YAC1B,WAAW,EAAE,uCAAuC;YACpD,WAAW,EAAE,aAAa,CAAC,KAAK;SACjC,CAAC;IACJ,CAAC;IAED,kBAAkB;QAChB,OAAO,CAAC,eAAe,EAAE,kBAAkB,EAAE,mBAAmB,CAAC,CAAC;IACpE,CAAC;CACF"}

package/dist/confluent/tools/handlers/kafka/produce-kafka-message-handler.d.ts

@@ -1,8 +1,38 @@
 import { ClientManager } from "../../../../confluent/client-manager.js";
+import { SchemaCheckResult } from "../../../../confluent/schema-registry-helper.js";
 import { CallToolResult } from "../../../../confluent/schema.js";
 import { BaseToolHandler, ToolConfig } from "../../../../confluent/tools/base-tools.js";
+import { EnvVar } from "../../../../env-schema.js";
+/**
+ * Handler for producing messages to a Kafka topic, with support for Confluent Schema Registry serialization (AVRO, JSON, PROTOBUF) for both key and value.
+ *
+ * - If schema registry is enabled, the handler checks if a schema is already registered for the topic's key/value subject.
+ *   - If a schema exists and none is provided, it returns the latest schema to the client for retry.
+ *   - If no schema exists and none is provided, it returns an error.
+ *   - If a schema is provided, it is registered before serialization.
+ * - Serialization is performed using the appropriate serializer for the schema type.
+ * - Produces the message to the specified Kafka topic, handling both key and value serialization as needed.
+ */
 export declare class ProduceKafkaMessageHandler extends BaseToolHandler {
+    /**
+     * Handles the result of a schema check, returning a CallToolResult if a schema issue is found, or null otherwise.
+     * @param result - The schema check result to handle
+     * @returns A CallToolResult if a schema issue is found, or null otherwise
+     */
+    handleSchemaCheckResult(result: SchemaCheckResult): CallToolResult | null;
+    /**
+     * Main handler for producing a message to a Kafka topic, including schema registry logic and serialization.
+     * Handles both value and key, and returns a CallToolResult with the outcome.
+     * @param clientManager - The client manager for Kafka and registry clients
+     * @param toolArguments - The arguments for the tool, including topic, value, and key
+     * @returns A CallToolResult describing the outcome of the produce operation
+     */
     handle(clientManager: ClientManager, toolArguments: Record<string, unknown>): Promise<CallToolResult>;
+    /**
+     * Returns the tool configuration including name, description, and input schema.
+     * @returns The tool configuration
+     */
     getToolConfig(): ToolConfig;
+    getRequiredEnvVars(): EnvVar[];
 }
 //# sourceMappingURL=produce-kafka-message-handler.d.ts.map

package/dist/confluent/tools/handlers/kafka/produce-kafka-message-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"produce-kafka-message-handler.d.ts","sourceRoot":"","sources":["../../../../../src/confluent/tools/handlers/kafka/produce-kafka-message-handler.ts"],"names":[],"mappings":"AACA,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;AAc5C,qBAAa,0BAA2B,SAAQ,eAAe;IACvD,MAAM,CACV,aAAa,EAAE,aAAa,EAC5B,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACrC,OAAO,CAAC,cAAc,CAAC;IAkB1B,aAAa,IAAI,UAAU;CAO5B"}
+{"version":3,"file":"produce-kafka-message-handler.d.ts","sourceRoot":"","sources":["../../../../../src/confluent/tools/handlers/kafka/produce-kafka-message-handler.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACjE,OAAO,EAGL,iBAAiB,EAElB,MAAM,0CAA0C,CAAC;AAClD,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;AAkD5C;;;;;;;;;GASG;AACH,qBAAa,0BAA2B,SAAQ,eAAe;IAC7D;;;;OAIG;IACH,uBAAuB,CAAC,MAAM,EAAE,iBAAiB,GAAG,cAAc,GAAG,IAAI;IAqBzE;;;;;;OAMG;IACG,MAAM,CACV,aAAa,EAAE,aAAa,EAC5B,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACrC,OAAO,CAAC,cAAc,CAAC;IAwF1B;;;OAGG;IACH,aAAa,IAAI,UAAU;IAQ3B,kBAAkB,IAAI,MAAM,EAAE;CAG/B"}