@confluentinc/mcp-confluent 1.3.0 → 1.4.0

package/dist/confluent/tools/handlers/kafka/get-partition-offsets-handler.js

@@ -0,0 +1,123 @@
+import { KafkaJS } from "@confluentinc/kafka-javascript";
+import { BaseToolHandler, READ_ONLY, ToolCategory, } from "../../../../confluent/tools/base-tools.js";
+import { disposeIfOAuth, formatKafkaError, resolveKafkaClusterArgs, } from "../../../../confluent/tools/cluster-arg-resolvers.js";
+import { kafkaBootstrapOrOAuth } from "../../../../confluent/tools/connection-predicates.js";
+import { fetchPartitionWatermarks, narrowMessageCount, } from "../../../../confluent/tools/handlers/kafka/partition-watermarks.js";
+import { ToolName } from "../../../../confluent/tools/tool-name.js";
+import { logger } from "../../../../logger.js";
+import { z } from "zod";
+export const getPartitionOffsetsArgs = z.object({
+    topicName: z
+        .string()
+        .nonempty()
+        .describe("Name of the Kafka topic to fetch partition offsets for."),
+    partition: z
+        .number()
+        .int()
+        .nonnegative()
+        .optional()
+        .describe("Optional. Restrict the response to this partition (0-indexed). " +
+        "Omit to return every partition of the topic."),
+    cluster_id: z
+        .string()
+        .optional()
+        .describe("Confluent Cloud logical Kafka cluster ID (lkc-...). Discover via list-clusters."),
+    environment_id: z
+        .string()
+        .optional()
+        .describe("Confluent Cloud environment ID (env-...) that owns the cluster. Discover via list-environments."),
+});
+function mapToPartitionOffsetInfo(topicName, watermark) {
+    const low = BigInt(watermark.low);
+    const high = BigInt(watermark.high);
+    const diff = high - low;
+    return {
+        partition: watermark.partition,
+        lowWatermark: watermark.low,
+        highWatermark: watermark.high,
+        messageCount: narrowMessageCount(diff, {
+            topicName,
+            partition: watermark.partition,
+            low: watermark.low,
+            high: watermark.high,
+        }),
+    };
+}
+/**
+ * Read-only tool that returns per-partition low/high watermarks (and the
+ * derived message count) for a single Kafka topic. Thin wrapper over the
+ * broker's `Admin.fetchTopicOffsets` admin call — the metadata primitive
+ * that `consume-messages` already relies on internally for `start:
+ * "earliest" / "latest" / {timestamp} / {tail}` resolution but doesn't
+ * surface in its response.
+ */
+export class GetPartitionOffsetsHandler extends BaseToolHandler {
+    async handle(runtime, toolArguments) {
+        const parsed = getPartitionOffsetsArgs.parse(toolArguments);
+        const { connId, clientManager } = this.resolveSoleConnection(runtime);
+        const resolved = resolveKafkaClusterArgs(parsed, runtime, connId);
+        const admin = await clientManager.getKafkaAdminClient(resolved.clusterId, resolved.envId);
+        try {
+            let watermarks;
+            try {
+                watermarks = await fetchPartitionWatermarks(admin, parsed.topicName);
+            }
+            catch (err) {
+                // Two distinct librdkafka codes report the same conceptual failure:
+                //   - ERR_UNKNOWN_TOPIC_OR_PART (broker-issued, single underscore)
+                //   - ERR__UNKNOWN_TOPIC (local-side, double underscore — fires when
+                //     the client's own metadata cache rejects the topic before
+                //     reaching the broker)
+                // Only those two get the friendly "topic not found" message;
+                // everything else (auth denials, TLS failures, broker timeouts,
+                // unknown shapes) flows through formatKafkaError so callers see
+                // actionable signal instead of a misleading not-found label.
+                const isUnknownTopic = err instanceof KafkaJS.KafkaJSError &&
+                    (err.code === KafkaJS.ErrorCodes.ERR_UNKNOWN_TOPIC_OR_PART ||
+                        err.code === KafkaJS.ErrorCodes.ERR__UNKNOWN_TOPIC);
+                if (isUnknownTopic) {
+                    logger.warn({ error: err, topicName: parsed.topicName }, `fetchTopicOffsets rejected for "${parsed.topicName}" — surfacing as topic-not-found`);
+                    return this.createResponse(`Topic "${parsed.topicName}" not found on this cluster.`, true);
+                }
+                return this.createResponse(`Failed to fetch partition offsets for "${parsed.topicName}": ${formatKafkaError(err)}`, true);
+            }
+            if (watermarks.length === 0) {
+                return this.createResponse(`Topic "${parsed.topicName}" not found on this cluster.`, true);
+            }
+            if (parsed.partition !== undefined) {
+                const numPartitions = watermarks.length;
+                const requested = parsed.partition;
+                const match = watermarks.find((w) => w.partition === requested);
+                if (!match) {
+                    return this.createResponse(`Topic "${parsed.topicName}" has ${numPartitions} partition(s) ` +
+                        `(0..${numPartitions - 1}); requested partition ${requested} is out of range.`, true);
+                }
+                watermarks = [match];
+            }
+            const payload = {
+                topicName: parsed.topicName,
+                partitions: watermarks.map((w) => mapToPartitionOffsetInfo(parsed.topicName, w)),
+            };
+            const summary = `Partition offsets for "${parsed.topicName}" ` +
+                `(${payload.partitions.length} partition(s)):\n` +
+                JSON.stringify(payload, null, 2);
+            return this.createStructuredResponse(summary, payload);
+        }
+        finally {
+            await disposeIfOAuth(runtime, connId, admin);
+        }
+    }
+    getToolConfig() {
+        return {
+            name: ToolName.GET_PARTITION_OFFSETS,
+            description: "Return per-partition low/high watermarks and message counts for a Kafka topic. " +
+                "Use this to size a backfill, measure lag relative to a known offset, or check whether a topic is still receiving writes — without consuming. " +
+                "Pass `partition` to restrict the response to a single partition.",
+            inputSchema: getPartitionOffsetsArgs.shape,
+            annotations: READ_ONLY,
+        };
+    }
+    category = ToolCategory.Kafka;
+    predicate = kafkaBootstrapOrOAuth;
+}
+//# sourceMappingURL=get-partition-offsets-handler.js.map

package/dist/confluent/tools/handlers/kafka/get-partition-offsets-handler.js.map

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

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

@@ -1,5 +1,5 @@
 import { CallToolResult } from "../../../../confluent/schema.js";
-import { BaseToolHandler, ToolConfig } from "../../../../confluent/tools/base-tools.js";
+import { BaseToolHandler, ToolCategory, ToolConfig } from "../../../../confluent/tools/base-tools.js";
 import { ServerRuntime } from "../../../../server-runtime.js";
 /**
  * Handler for retrieving Kafka topic configurations through Confluent Cloud REST API.
@@ -9,6 +9,7 @@ import { ServerRuntime } from "../../../../server-runtime.js";
 export declare class GetTopicConfigHandler extends BaseToolHandler {
     handle(runtime: ServerRuntime, toolArguments: Record<string, unknown>): Promise<CallToolResult>;
     getToolConfig(): ToolConfig;
+    readonly category = ToolCategory.Kafka;
     readonly predicate: import("../../../../confluent/tools/connection-predicates.js").ConnectionPredicate;
 }
 //# sourceMappingURL=get-topic-config.d.ts.map

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

@@ -1 +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,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EACL,eAAe,EAEf,UAAU,EACX,MAAM,oCAAoC,CAAC;AAI5C,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAuBvD;;;;GAIG;AACH,qBAAa,qBAAsB,SAAQ,eAAe;IAClD,MAAM,CACV,OAAO,EAAE,aAAa,EACtB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACrC,OAAO,CAAC,cAAc,CAAC;IAgD1B,aAAa,IAAI,UAAU;IAQ3B,QAAQ,CAAC,SAAS,8EAA4B;CAC/C"}
+{"version":3,"file":"get-topic-config.d.ts","sourceRoot":"","sources":["../../../../../src/confluent/tools/handlers/kafka/get-topic-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EACL,eAAe,EAEf,YAAY,EACZ,UAAU,EACX,MAAM,oCAAoC,CAAC;AAI5C,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAuBvD;;;;GAIG;AACH,qBAAa,qBAAsB,SAAQ,eAAe;IAClD,MAAM,CACV,OAAO,EAAE,aAAa,EACtB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACrC,OAAO,CAAC,cAAc,CAAC;IAgD1B,aAAa,IAAI,UAAU;IAQ3B,QAAQ,CAAC,QAAQ,sBAAsB;IACvC,QAAQ,CAAC,SAAS,8EAA4B;CAC/C"}

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

@@ -1,4 +1,4 @@
-import { BaseToolHandler, READ_ONLY, } from "../../../../confluent/tools/base-tools.js";
+import { BaseToolHandler, READ_ONLY, ToolCategory, } from "../../../../confluent/tools/base-tools.js";
 import { resolveKafkaRestArgs } from "../../../../confluent/tools/cluster-arg-resolvers.js";
 import { kafkaRestWithAuthOrOAuth } from "../../../../confluent/tools/connection-predicates.js";
 import { ToolName } from "../../../../confluent/tools/tool-name.js";
@@ -55,6 +55,7 @@ export class GetTopicConfigHandler extends BaseToolHandler {
             annotations: READ_ONLY,
         };
     }
+    category = ToolCategory.Kafka;
     predicate = kafkaRestWithAuthOrOAuth;
 }
 //# sourceMappingURL=get-topic-config.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"get-topic-config.js","sourceRoot":"","sources":["../../../../../src/confluent/tools/handlers/kafka/get-topic-config.ts"],"names":[],"mappings":"AACA,OAAO,EACL,eAAe,EACf,SAAS,GAEV,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,oBAAoB,EAAE,MAAM,+CAA+C,CAAC;AACrF,OAAO,EAAE,wBAAwB,EAAE,MAAM,+CAA+C,CAAC;AACzF,OAAO,EAAE,QAAQ,EAAE,MAAM,mCAAmC,CAAC;AAE7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,QAAQ,CAAC,4CAA4C,CAAC;SACtD,QAAQ,EAAE;IACb,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,iFAAiF,CAClF;IACH,aAAa,EAAE,CAAC;SACb,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,iGAAiG,CAClG;CACJ,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,OAAO,qBAAsB,SAAQ,eAAe;IACxD,KAAK,CAAC,MAAM,CACV,OAAsB,EACtB,aAAsC;QAEtC,MAAM,MAAM,GAAG,uBAAuB,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QAC5D,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,GAAG,IAAI,CAAC,qBAAqB,CAAC,OAAO,CAAC,CAAC;QACtE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,oBAAoB,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QAE3E,MAAM,UAAU,GAAG,MAAM,aAAa,CAAC,gCAAgC,CACrE,SAAS,EACT,KAAK,CACN,CAAC;QACF,MAAM,eAAe,GAAG,qBAAqB,CAAC,UAAU,CAAC,CAAC;QAE1D,2BAA2B;QAC3B,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,EAAE,GAC1C,MAAM,eAAe,CACnB,sBAAsB,SAAS,WAAW,MAAM,CAAC,SAAS,EAAE,CAC7D,CAAC,GAAG,EAAE,CAAC;QAEV,IAAI,UAAU,EAAE,CAAC;YACf,OAAO,IAAI,CAAC,cAAc,CACxB,qCAAqC,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE,EACjE,IAAI,CACL,CAAC;QACJ,CAAC;QAED,iCAAiC;QACjC,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,EAAE,GAC5C,MAAM,eAAe,CACnB,sBAAsB,SAAS,WAAW,MAAM,CAAC,SAAS,UAAU,CACrE,CAAC,GAAG,EAAE,CAAC;QAEV,IAAI,WAAW,EAAE,CAAC;YAChB,OAAO,IAAI,CAAC,cAAc,CACxB,2CAA2C,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,EAAE,EACxE,IAAI,CACL,CAAC;QACJ,CAAC;QAED,iEAAiE;QACjE,MAAM,QAAQ,GAAG;YACf,YAAY,EAAE,SAAS;YACvB,WAAW,EAAE,UAAU;SACxB,CAAC;QAEF,OAAO,IAAI,CAAC,cAAc,CACxB,4BAA4B,MAAM,CAAC,SAAS,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CACvF,CAAC;IACJ,CAAC;IAED,aAAa;QACX,OAAO;YACL,IAAI,EAAE,QAAQ,CAAC,gBAAgB;YAC/B,WAAW,EAAE,4DAA4D;YACzE,WAAW,EAAE,uBAAuB,CAAC,KAAK;YAC1C,WAAW,EAAE,SAAS;SACvB,CAAC;IACJ,CAAC;IACQ,SAAS,GAAG,wBAAwB,CAAC;CAC/C"}
+{"version":3,"file":"get-topic-config.js","sourceRoot":"","sources":["../../../../../src/confluent/tools/handlers/kafka/get-topic-config.ts"],"names":[],"mappings":"AACA,OAAO,EACL,eAAe,EACf,SAAS,EACT,YAAY,GAEb,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,oBAAoB,EAAE,MAAM,+CAA+C,CAAC;AACrF,OAAO,EAAE,wBAAwB,EAAE,MAAM,+CAA+C,CAAC;AACzF,OAAO,EAAE,QAAQ,EAAE,MAAM,mCAAmC,CAAC;AAE7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,QAAQ,CAAC,4CAA4C,CAAC;SACtD,QAAQ,EAAE;IACb,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,iFAAiF,CAClF;IACH,aAAa,EAAE,CAAC;SACb,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,iGAAiG,CAClG;CACJ,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,OAAO,qBAAsB,SAAQ,eAAe;IACxD,KAAK,CAAC,MAAM,CACV,OAAsB,EACtB,aAAsC;QAEtC,MAAM,MAAM,GAAG,uBAAuB,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QAC5D,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,GAAG,IAAI,CAAC,qBAAqB,CAAC,OAAO,CAAC,CAAC;QACtE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,oBAAoB,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QAE3E,MAAM,UAAU,GAAG,MAAM,aAAa,CAAC,gCAAgC,CACrE,SAAS,EACT,KAAK,CACN,CAAC;QACF,MAAM,eAAe,GAAG,qBAAqB,CAAC,UAAU,CAAC,CAAC;QAE1D,2BAA2B;QAC3B,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,EAAE,GAC1C,MAAM,eAAe,CACnB,sBAAsB,SAAS,WAAW,MAAM,CAAC,SAAS,EAAE,CAC7D,CAAC,GAAG,EAAE,CAAC;QAEV,IAAI,UAAU,EAAE,CAAC;YACf,OAAO,IAAI,CAAC,cAAc,CACxB,qCAAqC,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE,EACjE,IAAI,CACL,CAAC;QACJ,CAAC;QAED,iCAAiC;QACjC,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,EAAE,GAC5C,MAAM,eAAe,CACnB,sBAAsB,SAAS,WAAW,MAAM,CAAC,SAAS,UAAU,CACrE,CAAC,GAAG,EAAE,CAAC;QAEV,IAAI,WAAW,EAAE,CAAC;YAChB,OAAO,IAAI,CAAC,cAAc,CACxB,2CAA2C,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,EAAE,EACxE,IAAI,CACL,CAAC;QACJ,CAAC;QAED,iEAAiE;QACjE,MAAM,QAAQ,GAAG;YACf,YAAY,EAAE,SAAS;YACvB,WAAW,EAAE,UAAU;SACxB,CAAC;QAEF,OAAO,IAAI,CAAC,cAAc,CACxB,4BAA4B,MAAM,CAAC,SAAS,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CACvF,CAAC;IACJ,CAAC;IAED,aAAa;QACX,OAAO;YACL,IAAI,EAAE,QAAQ,CAAC,gBAAgB;YAC/B,WAAW,EAAE,4DAA4D;YACzE,WAAW,EAAE,uBAAuB,CAAC,KAAK;YAC1C,WAAW,EAAE,SAAS;SACvB,CAAC;IACJ,CAAC;IACQ,QAAQ,GAAG,YAAY,CAAC,KAAK,CAAC;IAC9B,SAAS,GAAG,wBAAwB,CAAC;CAC/C"}

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

@@ -0,0 +1,45 @@
+import { CallToolResult } from "../../../../confluent/schema.js";
+import { BaseToolHandler, ToolCategory, ToolConfig } from "../../../../confluent/tools/base-tools.js";
+import { ServerRuntime } from "../../../../server-runtime.js";
+import { z } from "zod";
+export declare const listConsumerGroupsArgs: z.ZodObject<{
+    matchStates: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        Unknown: "Unknown";
+        PreparingRebalance: "PreparingRebalance";
+        CompletingRebalance: "CompletingRebalance";
+        Stable: "Stable";
+        Dead: "Dead";
+        Empty: "Empty";
+    }>>>;
+    matchType: z.ZodOptional<z.ZodEnum<{
+        Classic: "Classic";
+        Consumer: "Consumer";
+    }>>;
+    cluster_id: z.ZodOptional<z.ZodString>;
+    environment_id: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Wire-format response payload. `Record<string, unknown>` compatibility lets it
+ * thread cleanly through MCP's `structuredContent` channel without a boundary
+ * cast at the call site.
+ */
+export type ListConsumerGroupsResponse = {
+    groups: Array<{
+        groupId: string;
+        state: string;
+        type: string;
+        protocolType: string;
+        isSimpleConsumerGroup: boolean;
+    }>;
+    errors: Array<{
+        message: string;
+        code?: number;
+    }>;
+} & Record<string, unknown>;
+export declare class ListConsumerGroupsHandler extends BaseToolHandler {
+    readonly category = ToolCategory.Kafka;
+    readonly predicate: import("../../../../confluent/tools/connection-predicates.js").ConnectionPredicate;
+    getToolConfig(): ToolConfig;
+    handle(runtime: ServerRuntime, toolArguments: Record<string, unknown>): Promise<CallToolResult>;
+}
+//# sourceMappingURL=list-consumer-groups-handler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"list-consumer-groups-handler.d.ts","sourceRoot":"","sources":["../../../../../src/confluent/tools/handlers/kafka/list-consumer-groups-handler.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EACL,eAAe,EAEf,YAAY,EACZ,UAAU,EACX,MAAM,oCAAoC,CAAC;AAe5C,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;iBA6BjC,CAAC;AAEH;;;;GAIG;AACH,MAAM,MAAM,0BAA0B,GAAG;IACvC,MAAM,EAAE,KAAK,CAAC;QACZ,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,YAAY,EAAE,MAAM,CAAC;QACrB,qBAAqB,EAAE,OAAO,CAAC;KAChC,CAAC,CAAC;IACH,MAAM,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACnD,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE5B,qBAAa,yBAA0B,SAAQ,eAAe;IAC5D,QAAQ,CAAC,QAAQ,sBAAsB;IACvC,QAAQ,CAAC,SAAS,8EAAyB;IAE3C,aAAa,IAAI,UAAU;IAcrB,MAAM,CACV,OAAO,EAAE,aAAa,EACtB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACrC,OAAO,CAAC,cAAc,CAAC;CA2D3B"}

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

@@ -0,0 +1,86 @@
+import { BaseToolHandler, READ_ONLY, ToolCategory, } from "../../../../confluent/tools/base-tools.js";
+import { disposeIfOAuth, resolveKafkaClusterArgs, } from "../../../../confluent/tools/cluster-arg-resolvers.js";
+import { kafkaBootstrapOrOAuth } from "../../../../confluent/tools/connection-predicates.js";
+import { STATE_NAME_TO_ENUM, STATE_NAMES, stateName, TYPE_NAME_TO_ENUM, TYPE_NAMES, typeName, } from "../../../../confluent/tools/handlers/kafka/consumer-group-enums.js";
+import { ToolName } from "../../../../confluent/tools/tool-name.js";
+import { z } from "zod";
+export const listConsumerGroupsArgs = z.object({
+    matchStates: z
+        .array(z.enum(STATE_NAMES))
+        .nonempty()
+        .optional()
+        .describe("Filter to groups in any of these states. Omit to return all. " +
+        'Options: "Stable" (live), "Empty" (orphaned), "Dead", ' +
+        '"PreparingRebalance", "CompletingRebalance", "Unknown".'),
+    matchType: z
+        .enum(TYPE_NAMES)
+        .optional()
+        .describe("Filter to groups of this protocol type. Omit to return both. " +
+        'Options: "Consumer" (new, KIP-848), "Classic" (legacy generation-based).'),
+    cluster_id: z
+        .string()
+        .optional()
+        .describe("Confluent Cloud logical Kafka cluster ID (lkc-...). Discover via list-clusters."),
+    environment_id: z
+        .string()
+        .optional()
+        .describe("Confluent Cloud environment ID (env-...) that owns the cluster. Discover via list-environments."),
+});
+export class ListConsumerGroupsHandler extends BaseToolHandler {
+    category = ToolCategory.Kafka;
+    predicate = kafkaBootstrapOrOAuth;
+    getToolConfig() {
+        return {
+            name: ToolName.LIST_CONSUMER_GROUPS,
+            description: "List consumer groups on a Kafka cluster — wraps the broker's " +
+                "listGroups admin call. Optional filters narrow the result " +
+                "server-side. Response carries one entry per group with groupId, " +
+                "state, type, protocolType, and isSimpleConsumerGroup, plus an " +
+                "errors array of any per-broker partial failures.",
+            inputSchema: listConsumerGroupsArgs.shape,
+            annotations: READ_ONLY,
+        };
+    }
+    async handle(runtime, toolArguments) {
+        const parsed = listConsumerGroupsArgs.parse(toolArguments);
+        const { connId, clientManager } = this.resolveSoleConnection(runtime);
+        const { clusterId, envId } = resolveKafkaClusterArgs(parsed, runtime, connId);
+        const admin = await clientManager.getKafkaAdminClient(clusterId, envId);
+        try {
+            const options = {};
+            if (parsed.matchStates !== undefined) {
+                options.matchConsumerGroupStates = parsed.matchStates.map((name) => STATE_NAME_TO_ENUM[name]);
+            }
+            if (parsed.matchType !== undefined) {
+                options.matchConsumerGroupTypes = [TYPE_NAME_TO_ENUM[parsed.matchType]];
+            }
+            const { groups: rawGroups, errors: rawErrors } = await admin.listGroups(options);
+            const filtered = parsed.matchStates !== undefined || parsed.matchType !== undefined;
+            if (rawGroups.length === 0 && rawErrors.length > 0) {
+                return this.createResponse(rawErrors[0].message, true);
+            }
+            const payload = {
+                groups: rawGroups.map((g) => ({
+                    groupId: g.groupId,
+                    state: stateName(g.state),
+                    type: typeName(g.type),
+                    protocolType: g.protocolType,
+                    isSimpleConsumerGroup: g.isSimpleConsumerGroup,
+                })),
+                errors: rawErrors.map((e) => ({ message: e.message, code: e.code })),
+            };
+            const count = payload.groups.length;
+            const noun = count === 1 ? "group" : "groups";
+            const suffix = filtered ? " (filtered)" : "";
+            const summary = count === 0
+                ? `Found 0 consumer ${noun}${suffix}.`
+                : `Found ${count} consumer ${noun}${suffix}:\n` +
+                    JSON.stringify(payload, null, 2);
+            return this.createStructuredResponse(summary, payload);
+        }
+        finally {
+            await disposeIfOAuth(runtime, connId, admin);
+        }
+    }
+}
+//# sourceMappingURL=list-consumer-groups-handler.js.map

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

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

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

@@ -1,9 +1,10 @@
 import { CallToolResult } from "../../../../confluent/schema.js";
-import { BaseToolHandler, ToolConfig } from "../../../../confluent/tools/base-tools.js";
+import { BaseToolHandler, ToolCategory, ToolConfig } from "../../../../confluent/tools/base-tools.js";
 import { ServerRuntime } from "../../../../server-runtime.js";
 export declare class ListTopicsHandler extends BaseToolHandler {
     handle(runtime: ServerRuntime, toolArguments: Record<string, unknown>): Promise<CallToolResult>;
     getToolConfig(): ToolConfig;
+    readonly category = ToolCategory.Kafka;
     readonly predicate: import("../../../../confluent/tools/connection-predicates.js").ConnectionPredicate;
 }
 //# 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,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EACL,eAAe,EAEf,UAAU,EACX,MAAM,oCAAoC,CAAC;AAO5C,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAkBvD,qBAAa,iBAAkB,SAAQ,eAAe;IAC9C,MAAM,CACV,OAAO,EAAE,aAAa,EACtB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACrC,OAAO,CAAC,cAAc,CAAC;IAgB1B,aAAa,IAAI,UAAU;IAS3B,QAAQ,CAAC,SAAS,8EAAyB;CAC5C"}
+{"version":3,"file":"list-topics-handler.d.ts","sourceRoot":"","sources":["../../../../../src/confluent/tools/handlers/kafka/list-topics-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EACL,eAAe,EAEf,YAAY,EACZ,UAAU,EACX,MAAM,oCAAoC,CAAC;AAO5C,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAkBvD,qBAAa,iBAAkB,SAAQ,eAAe;IAC9C,MAAM,CACV,OAAO,EAAE,aAAa,EACtB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACrC,OAAO,CAAC,cAAc,CAAC;IAgB1B,aAAa,IAAI,UAAU;IAS3B,QAAQ,CAAC,QAAQ,sBAAsB;IACvC,QAAQ,CAAC,SAAS,8EAAyB;CAC5C"}

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

@@ -1,4 +1,4 @@
-import { BaseToolHandler, READ_ONLY, } from "../../../../confluent/tools/base-tools.js";
+import { BaseToolHandler, READ_ONLY, ToolCategory, } from "../../../../confluent/tools/base-tools.js";
 import { disposeIfOAuth, resolveKafkaClusterArgs, } from "../../../../confluent/tools/cluster-arg-resolvers.js";
 import { kafkaBootstrapOrOAuth } from "../../../../confluent/tools/connection-predicates.js";
 import { ToolName } from "../../../../confluent/tools/tool-name.js";
@@ -35,6 +35,7 @@ export class ListTopicsHandler extends BaseToolHandler {
             annotations: READ_ONLY,
         };
     }
+    category = ToolCategory.Kafka;
     predicate = kafkaBootstrapOrOAuth;
 }
 //# 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":"AACA,OAAO,EACL,eAAe,EACf,SAAS,GAEV,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EACL,cAAc,EACd,uBAAuB,GACxB,MAAM,+CAA+C,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,+CAA+C,CAAC;AACtF,OAAO,EAAE,QAAQ,EAAE,MAAM,mCAAmC,CAAC;AAE7D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7B,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,iFAAiF,CAClF;IACH,cAAc,EAAE,CAAC;SACd,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,iGAAiG,CAClG;CACJ,CAAC,CAAC;AAEH,MAAM,OAAO,iBAAkB,SAAQ,eAAe;IACpD,KAAK,CAAC,MAAM,CACV,OAAsB,EACtB,aAAsC;QAEtC,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QAClD,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,GAAG,IAAI,CAAC,qBAAqB,CAAC,OAAO,CAAC,CAAC;QACtE,MAAM,QAAQ,GAAG,uBAAuB,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QAClE,MAAM,KAAK,GAAG,MAAM,aAAa,CAAC,mBAAmB,CACnD,QAAQ,CAAC,SAAS,EAClB,QAAQ,CAAC,KAAK,CACf,CAAC;QACF,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,UAAU,EAAE,CAAC;YACxC,OAAO,IAAI,CAAC,cAAc,CAAC,iBAAiB,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAClE,CAAC;gBAAS,CAAC;YACT,MAAM,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IAED,aAAa;QACX,OAAO;YACL,IAAI,EAAE,QAAQ,CAAC,WAAW;YAC1B,WAAW,EAAE,uCAAuC;YACpD,WAAW,EAAE,aAAa,CAAC,KAAK;YAChC,WAAW,EAAE,SAAS;SACvB,CAAC;IACJ,CAAC;IAEQ,SAAS,GAAG,qBAAqB,CAAC;CAC5C"}
+{"version":3,"file":"list-topics-handler.js","sourceRoot":"","sources":["../../../../../src/confluent/tools/handlers/kafka/list-topics-handler.ts"],"names":[],"mappings":"AACA,OAAO,EACL,eAAe,EACf,SAAS,EACT,YAAY,GAEb,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EACL,cAAc,EACd,uBAAuB,GACxB,MAAM,+CAA+C,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,+CAA+C,CAAC;AACtF,OAAO,EAAE,QAAQ,EAAE,MAAM,mCAAmC,CAAC;AAE7D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7B,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,iFAAiF,CAClF;IACH,cAAc,EAAE,CAAC;SACd,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,iGAAiG,CAClG;CACJ,CAAC,CAAC;AAEH,MAAM,OAAO,iBAAkB,SAAQ,eAAe;IACpD,KAAK,CAAC,MAAM,CACV,OAAsB,EACtB,aAAsC;QAEtC,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QAClD,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,GAAG,IAAI,CAAC,qBAAqB,CAAC,OAAO,CAAC,CAAC;QACtE,MAAM,QAAQ,GAAG,uBAAuB,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QAClE,MAAM,KAAK,GAAG,MAAM,aAAa,CAAC,mBAAmB,CACnD,QAAQ,CAAC,SAAS,EAClB,QAAQ,CAAC,KAAK,CACf,CAAC;QACF,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,UAAU,EAAE,CAAC;YACxC,OAAO,IAAI,CAAC,cAAc,CAAC,iBAAiB,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAClE,CAAC;gBAAS,CAAC;YACT,MAAM,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IAED,aAAa;QACX,OAAO;YACL,IAAI,EAAE,QAAQ,CAAC,WAAW;YAC1B,WAAW,EAAE,uCAAuC;YACpD,WAAW,EAAE,aAAa,CAAC,KAAK;YAChC,WAAW,EAAE,SAAS;SACvB,CAAC;IACJ,CAAC;IAEQ,QAAQ,GAAG,YAAY,CAAC,KAAK,CAAC;IAC9B,SAAS,GAAG,qBAAqB,CAAC;CAC5C"}

package/dist/confluent/tools/handlers/kafka/partition-watermarks.d.ts

@@ -0,0 +1,54 @@
+import { KafkaJS } from "@confluentinc/kafka-javascript";
+/**
+ * Per-partition low/high watermark pair, normalized to the fields the
+ * consume handler and the standalone `get-partition-offsets` tool both
+ * read. The upstream `admin.fetchTopicOffsets` response also carries a
+ * committed `offset` field (the next-to-be-committed group offset, not
+ * the partition end-of-log), which neither caller uses; this type drops
+ * it so a shared response shape governs both surfaces.
+ */
+export interface PartitionWatermark {
+    partition: number;
+    low: string;
+    high: string;
+}
+/**
+ * Narrow a {@link BigInt} difference to a JS `Number`, saturating at
+ * {@link Number.MAX_SAFE_INTEGER} or {@link Number.MIN_SAFE_INTEGER}
+ * when the result would lose precision. The narrow path is the only one
+ * expected to fire in practice (even a million-msg/sec partition with
+ * infinite retention takes ~285 years to exceed 2^53 - 1); the
+ * saturation arms are defensive sentinels — hence the `Wacky --` log
+ * signaling "this branch firing means something genuinely surprising
+ * happened". Symmetric guards on both ends of the safe range so a `diff`
+ * produced by an unexpected caller pattern (e.g. a far-ahead committed
+ * offset, or a cross-partition sum of many negative lags) can't silently
+ * lose precision.
+ *
+ * `context` is forwarded verbatim into the log payload so each caller
+ * can name the dimensions it knows about (`{topicName, partition}` for
+ * the standalone watermark tool, `{groupId, topic, partition}` for the
+ * consumer-group lag tool) without this helper hard-coding either.
+ */
+export declare function narrowMessageCount(diff: bigint, context: Record<string, unknown>): number;
+/**
+ * Thin wrapper around `admin.fetchTopicOffsets(topic)` that normalizes
+ * the response to {@link PartitionWatermark}. Shared seam between the
+ * consume handler's per-call watermark cache (see
+ * {@link createWatermarkCache}) and standalone
+ * `get-partition-offsets` tool — single source of truth for the
+ * response shape both surfaces see.
+ */
+export declare function fetchPartitionWatermarks(admin: KafkaJS.Admin, topic: string): Promise<PartitionWatermark[]>;
+/**
+ * Lazy per-topic memoized watermark fetcher. The consume handler hits
+ * `admin.fetchTopicOffsets` from four independent resolution paths
+ * within a single tool call (explicit-offset bounds check, timestamp's
+ * silent-substitution cross-check, earliest-minority low-watermark
+ * seek, and tail-mode seek resolution); the cache keeps the admin
+ * round-trip count linear in the number of distinct topics rather than
+ * the number of resolution sites.
+ */
+export type WatermarkCache = (topic: string) => Promise<PartitionWatermark[]>;
+export declare function createWatermarkCache(admin: KafkaJS.Admin): WatermarkCache;
+//# sourceMappingURL=partition-watermarks.d.ts.map

package/dist/confluent/tools/handlers/kafka/partition-watermarks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"partition-watermarks.d.ts","sourceRoot":"","sources":["../../../../../src/confluent/tools/handlers/kafka/partition-watermarks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,gCAAgC,CAAC;AAGzD;;;;;;;GAOG;AACH,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,MAAM,CAkBR;AAED;;;;;;;GAOG;AACH,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE,OAAO,CAAC,KAAK,EACpB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAG/B;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAC;AAE9E,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,CAAC,KAAK,GAAG,cAAc,CAUzE"}

package/dist/confluent/tools/handlers/kafka/partition-watermarks.js

@@ -0,0 +1,56 @@
+import { logger } from "../../../../logger.js";
+/**
+ * Narrow a {@link BigInt} difference to a JS `Number`, saturating at
+ * {@link Number.MAX_SAFE_INTEGER} or {@link Number.MIN_SAFE_INTEGER}
+ * when the result would lose precision. The narrow path is the only one
+ * expected to fire in practice (even a million-msg/sec partition with
+ * infinite retention takes ~285 years to exceed 2^53 - 1); the
+ * saturation arms are defensive sentinels — hence the `Wacky --` log
+ * signaling "this branch firing means something genuinely surprising
+ * happened". Symmetric guards on both ends of the safe range so a `diff`
+ * produced by an unexpected caller pattern (e.g. a far-ahead committed
+ * offset, or a cross-partition sum of many negative lags) can't silently
+ * lose precision.
+ *
+ * `context` is forwarded verbatim into the log payload so each caller
+ * can name the dimensions it knows about (`{topicName, partition}` for
+ * the standalone watermark tool, `{groupId, topic, partition}` for the
+ * consumer-group lag tool) without this helper hard-coding either.
+ */
+export function narrowMessageCount(diff, context) {
+    const maxSafe = BigInt(Number.MAX_SAFE_INTEGER);
+    const minSafe = BigInt(Number.MIN_SAFE_INTEGER);
+    if (diff > maxSafe) {
+        logger.warn(context, "Wacky -- messageCount BigInt subtraction exceeds Number.MAX_SAFE_INTEGER; saturating to MAX_SAFE_INTEGER");
+        return Number.MAX_SAFE_INTEGER;
+    }
+    if (diff < minSafe) {
+        logger.warn(context, "Wacky -- messageCount BigInt subtraction below Number.MIN_SAFE_INTEGER; saturating to MIN_SAFE_INTEGER");
+        return Number.MIN_SAFE_INTEGER;
+    }
+    return Number(diff);
+}
+/**
+ * Thin wrapper around `admin.fetchTopicOffsets(topic)` that normalizes
+ * the response to {@link PartitionWatermark}. Shared seam between the
+ * consume handler's per-call watermark cache (see
+ * {@link createWatermarkCache}) and standalone
+ * `get-partition-offsets` tool — single source of truth for the
+ * response shape both surfaces see.
+ */
+export async function fetchPartitionWatermarks(admin, topic) {
+    const raw = await admin.fetchTopicOffsets(topic);
+    return raw.map(({ partition, low, high }) => ({ partition, low, high }));
+}
+export function createWatermarkCache(admin) {
+    const cache = new Map();
+    return async (topic) => {
+        let wm = cache.get(topic);
+        if (!wm) {
+            wm = await fetchPartitionWatermarks(admin, topic);
+            cache.set(topic, wm);
+        }
+        return wm;
+    };
+}
+//# sourceMappingURL=partition-watermarks.js.map

package/dist/confluent/tools/handlers/kafka/partition-watermarks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"partition-watermarks.js","sourceRoot":"","sources":["../../../../../src/confluent/tools/handlers/kafka/partition-watermarks.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAgBxC;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,kBAAkB,CAChC,IAAY,EACZ,OAAgC;IAEhC,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;IAChD,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;IAChD,IAAI,IAAI,GAAG,OAAO,EAAE,CAAC;QACnB,MAAM,CAAC,IAAI,CACT,OAAO,EACP,0GAA0G,CAC3G,CAAC;QACF,OAAO,MAAM,CAAC,gBAAgB,CAAC;IACjC,CAAC;IACD,IAAI,IAAI,GAAG,OAAO,EAAE,CAAC;QACnB,MAAM,CAAC,IAAI,CACT,OAAO,EACP,wGAAwG,CACzG,CAAC;QACF,OAAO,MAAM,CAAC,gBAAgB,CAAC;IACjC,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC;AACtB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,KAAoB,EACpB,KAAa;IAEb,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC;IACjD,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AAC3E,CAAC;AAaD,MAAM,UAAU,oBAAoB,CAAC,KAAoB;IACvD,MAAM,KAAK,GAAG,IAAI,GAAG,EAAgC,CAAC;IACtD,OAAO,KAAK,EAAE,KAAK,EAAE,EAAE;QACrB,IAAI,EAAE,GAAG,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC1B,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,EAAE,GAAG,MAAM,wBAAwB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;YAClD,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACvB,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC,CAAC;AACJ,CAAC"}

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

@@ -1,14 +1,14 @@
 import { SchemaCheckResult } from "../../../../confluent/schema-registry-helper.js";
 import { CallToolResult } from "../../../../confluent/schema.js";
-import { BaseToolHandler, ToolConfig } from "../../../../confluent/tools/base-tools.js";
+import { BaseToolHandler, ToolCategory, ToolConfig } from "../../../../confluent/tools/base-tools.js";
 import { ServerRuntime } from "../../../../server-runtime.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 schema registry is enabled, `schemaType` is required and the handler checks if a schema is already registered for the topic's key/value subject.
  *   - If a schema is provided, it is registered before serialization.
+ *   - If no schema is provided and one is already registered, the serializer uses the latest registered version.
+ *   - If no schema is provided and none is registered, it returns an error.
  * - 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.
  */
@@ -32,6 +32,7 @@ export declare class ProduceKafkaMessageHandler extends BaseToolHandler {
      * @returns The tool configuration
      */
     getToolConfig(): ToolConfig;
+    readonly category = ToolCategory.Kafka;
     readonly predicate: import("../../../../confluent/tools/connection-predicates.js").ConnectionPredicate;
 }
 //# 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":"AAEA,OAAO,EAGL,iBAAiB,EAElB,MAAM,0CAA0C,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EACL,eAAe,EAEf,UAAU,EACX,MAAM,oCAAoC,CAAC;AAQ5C,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AA8DvD;;;;;;;;;GASG;AACH,qBAAa,0BAA2B,SAAQ,eAAe;IAC7D;;;;OAIG;IACH,uBAAuB,CAAC,MAAM,EAAE,iBAAiB,GAAG,cAAc,GAAG,IAAI;IAqBzE;;;;;;OAMG;IACG,MAAM,CACV,OAAO,EAAE,aAAa,EACtB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACrC,OAAO,CAAC,cAAc,CAAC;IAuG1B;;;OAGG;IACH,aAAa,IAAI,UAAU;IAS3B,QAAQ,CAAC,SAAS,8EAAyB;CAC5C"}
+{"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,EAGL,iBAAiB,EAElB,MAAM,0CAA0C,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EACL,eAAe,EAEf,YAAY,EACZ,UAAU,EACX,MAAM,oCAAoC,CAAC;AAQ5C,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AA8DvD;;;;;;;;;GASG;AACH,qBAAa,0BAA2B,SAAQ,eAAe;IAC7D;;;;OAIG;IACH,uBAAuB,CAAC,MAAM,EAAE,iBAAiB,GAAG,cAAc,GAAG,IAAI;IAQzE;;;;;;OAMG;IACG,MAAM,CACV,OAAO,EAAE,aAAa,EACtB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACrC,OAAO,CAAC,cAAc,CAAC;IAuG1B;;;OAGG;IACH,aAAa,IAAI,UAAU;IAS3B,QAAQ,CAAC,QAAQ,sBAAsB;IACvC,QAAQ,CAAC,SAAS,8EAAyB;CAC5C"}

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

@@ -1,6 +1,6 @@
 import { SerdeType } from "@confluentinc/schemaregistry";
 import { checkSchemaNeeded, serializeMessage, } from "../../../../confluent/schema-registry-helper.js";
-import { BaseToolHandler, CREATE_UPDATE, } from "../../../../confluent/tools/base-tools.js";
+import { BaseToolHandler, CREATE_UPDATE, ToolCategory, } from "../../../../confluent/tools/base-tools.js";
 import { disposeIfOAuth, formatKafkaError, resolveKafkaClusterArgs, } from "../../../../confluent/tools/cluster-arg-resolvers.js";
 import { kafkaBootstrapOrOAuth } from "../../../../confluent/tools/connection-predicates.js";
 import { ToolName } from "../../../../confluent/tools/tool-name.js";
@@ -49,10 +49,10 @@ const produceKafkaMessageArguments = z.object({
 /**
  * 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 schema registry is enabled, `schemaType` is required and the handler checks if a schema is already registered for the topic's key/value subject.
  *   - If a schema is provided, it is registered before serialization.
+ *   - If no schema is provided and one is already registered, the serializer uses the latest registered version.
+ *   - If no schema is provided and none is registered, it returns an error.
  * - 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.
  */
@@ -65,16 +65,7 @@ export class ProduceKafkaMessageHandler extends BaseToolHandler {
     handleSchemaCheckResult(result) {
         if (!result)
             return null;
-        if (result.type === "schema-needed") {
-            return this.createResponse(`A schema already exists for subject '${result.subject}'. Please retry with the following schema:\n${result.latestSchema}, schemaType: ${result.schemaType}`, true, {
-                latestSchema: result.latestSchema,
-                subject: result.subject,
-                schemaType: result.schemaType,
-            });
-        }
-        else {
-            return this.createResponse(`No schema registered for subject '${result.subject}', and no schema provided to register.`, true);
-        }
+        return this.createResponse(`No schema registered for subject '${result.subject}', and no schema provided to register.`, true);
     }
     /**
      * Main handler for producing a message to a Kafka topic, including schema registry logic and serialization.
@@ -162,6 +153,7 @@ export class ProduceKafkaMessageHandler extends BaseToolHandler {
             annotations: CREATE_UPDATE,
         };
     }
+    category = ToolCategory.Kafka;
     predicate = kafkaBootstrapOrOAuth;
 }
 //# sourceMappingURL=produce-kafka-message-handler.js.map

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

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