@confluentinc/mcp-confluent 1.2.2 → 1.4.0

package/dist/confluent/tools/handlers/flink/read-flink-statement-handler.d.ts

@@ -1,11 +1,9 @@
-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 ReadFlinkStatementHandler extends BaseToolHandler {
-    handle(clientManager: ClientManager, toolArguments: Record<string, unknown> | undefined): Promise<CallToolResult>;
+import { ToolConfig } from "../../../../confluent/tools/base-tools.js";
+import { FlinkToolHandler } from "../../../../confluent/tools/handlers/flink/flink-tool-handler.js";
+import { ServerRuntime } from "../../../../server-runtime.js";
+export declare class ReadFlinkStatementHandler extends FlinkToolHandler {
+    handle(runtime: ServerRuntime, toolArguments: Record<string, unknown> | undefined): Promise<CallToolResult>;
     getToolConfig(): ToolConfig;
-    getRequiredEnvVars(): readonly EnvVar[];
-    isConfluentCloudOnly(): boolean;
 }
 //# sourceMappingURL=read-flink-statement-handler.d.ts.map

package/dist/confluent/tools/handlers/flink/read-flink-statement-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"read-flink-statement-handler.d.ts","sourceRoot":"","sources":["../../../../../src/confluent/tools/handlers/flink/read-flink-statement-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAEjE,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EACL,eAAe,EAEf,UAAU,EACX,MAAM,oCAAoC,CAAC;AAE5C,OAAO,EAAE,MAAM,EAA2B,MAAM,oBAAoB,CAAC;AAoCrE,qBAAa,yBAA0B,SAAQ,eAAe;IACtD,MAAM,CACV,aAAa,EAAE,aAAa,EAC5B,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GACjD,OAAO,CAAC,cAAc,CAAC;IAgE1B,aAAa,IAAI,UAAU;IAS3B,kBAAkB,IAAI,SAAS,MAAM,EAAE;IAIvC,oBAAoB,IAAI,OAAO;CAGhC"}
+{"version":3,"file":"read-flink-statement-handler.d.ts","sourceRoot":"","sources":["../../../../../src/confluent/tools/handlers/flink/read-flink-statement-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAa,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAC3E,OAAO,EAAE,gBAAgB,EAAE,MAAM,2DAA2D,CAAC;AAE7F,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAoCvD,qBAAa,yBAA0B,SAAQ,gBAAgB;IACvD,MAAM,CACV,OAAO,EAAE,aAAa,EACtB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GACjD,OAAO,CAAC,cAAc,CAAC;IA6D1B,aAAa,IAAI,UAAU;CAQ5B"}

package/dist/confluent/tools/handlers/flink/read-flink-statement-handler.js

@@ -1,7 +1,6 @@
-import { getEnsuredParam } from "../../../../confluent/helpers.js";
-import { BaseToolHandler, READ_ONLY, } from "../../../../confluent/tools/base-tools.js";
+import { READ_ONLY } from "../../../../confluent/tools/base-tools.js";
+import { FlinkToolHandler } from "../../../../confluent/tools/handlers/flink/flink-tool-handler.js";
 import { ToolName } from "../../../../confluent/tools/tool-name.js";
-import { FLINK_REQUIRED_ENV_VARS } from "../../../../env-schema.js";
 import { wrapAsPathBasedClient } from "openapi-fetch";
 import { z } from "zod";
 const readFlinkStatementArguments = z.object({
@@ -27,11 +26,12 @@ const readFlinkStatementArguments = z.object({
         .default(60000)
         .describe("The function implements pagination. It will continue to fetch results using the next page token until either there are no more results or the timeout is reached. Tables backed by kafka topics can be thought of as never-ending streams as data could be continuously produced in near real-time. Therefore, if you wish to sample values from a stream, you may want to set a timeout. If you are reading a statement after creating it, you may need to retry a couple times to ensure that the statement is ready and receiving data."),
 });
-export class ReadFlinkStatementHandler extends BaseToolHandler {
-    async handle(clientManager, toolArguments) {
+export class ReadFlinkStatementHandler extends FlinkToolHandler {
+    async handle(runtime, toolArguments) {
+        const clientManager = runtime.clientManager;
         const { timeoutInMilliseconds, statementName, environmentId, organizationId, } = readFlinkStatementArguments.parse(toolArguments);
-        const organization_id = getEnsuredParam("FLINK_ORG_ID", "Organization ID is required", organizationId);
-        const environment_id = getEnsuredParam("FLINK_ENV_ID", "Environment ID is required", environmentId);
+        const flink = this.getFlinkDirectConfig(runtime.config);
+        const { organization_id, environment_id } = this.resolveOrgAndEnvIds(flink, organizationId, environmentId);
         const pathBasedClient = wrapAsPathBasedClient(clientManager.getConfluentCloudFlinkRestClient());
         let allResults = [];
         let nextToken = undefined;
@@ -71,11 +71,5 @@ export class ReadFlinkStatementHandler extends BaseToolHandler {
             annotations: READ_ONLY,
         };
     }
-    getRequiredEnvVars() {
-        return FLINK_REQUIRED_ENV_VARS;
-    }
-    isConfluentCloudOnly() {
-        return true;
-    }
 }
 //# sourceMappingURL=read-flink-statement-handler.js.map

package/dist/confluent/tools/handlers/flink/read-flink-statement-handler.js.map

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

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

@@ -1,7 +1,6 @@
-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 { BaseToolHandler, ToolCategory, ToolConfig } from "../../../../confluent/tools/base-tools.js";
+import { ServerRuntime } from "../../../../server-runtime.js";
 /**
  * Handler for altering Kafka topic configurations through Confluent Cloud REST API.
  * This implementation serves as a workaround since the native Kafka
@@ -9,9 +8,9 @@ import { EnvVar } from "../../../../env-schema.js";
  * Instead, we utilize Confluent's REST API endpoints to achieve this functionality.
  */
 export declare class AlterTopicConfigHandler extends BaseToolHandler {
-    handle(clientManager: ClientManager, toolArguments: Record<string, unknown>): Promise<CallToolResult>;
+    handle(runtime: ServerRuntime, toolArguments: Record<string, unknown>): Promise<CallToolResult>;
     getToolConfig(): ToolConfig;
-    getRequiredEnvVars(): readonly EnvVar[];
-    isConfluentCloudOnly(): boolean;
+    readonly category = ToolCategory.Kafka;
+    readonly predicate: import("../../../../confluent/tools/connection-predicates.js").ConnectionPredicate;
 }
 //# 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,EAEf,UAAU,EACX,MAAM,oCAAoC,CAAC;AAE5C,OAAO,EAAE,MAAM,EAAgC,MAAM,oBAAoB,CAAC;AAsB1E;;;;;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;IAkC1B,aAAa,IAAI,UAAU;IAS3B,kBAAkB,IAAI,SAAS,MAAM,EAAE;IAIvC,oBAAoB,IAAI,OAAO;CAGhC"}
+{"version":3,"file":"alter-topic-config.d.ts","sourceRoot":"","sources":["../../../../../src/confluent/tools/handlers/kafka/alter-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;AA8BvD;;;;;GAKG;AACH,qBAAa,uBAAwB,SAAQ,eAAe;IACpD,MAAM,CACV,OAAO,EAAE,aAAa,EACtB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACrC,OAAO,CAAC,cAAc,CAAC;IAgC1B,aAAa,IAAI,UAAU;IAQ3B,QAAQ,CAAC,QAAQ,sBAAsB;IACvC,QAAQ,CAAC,SAAS,8EAA4B;CAC/C"}

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

@@ -1,14 +1,10 @@
-import { getEnsuredParam } from "../../../../confluent/helpers.js";
-import { BaseToolHandler, CREATE_UPDATE, } from "../../../../confluent/tools/base-tools.js";
+import { BaseToolHandler, CREATE_UPDATE, 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";
-import { KAFKA_REST_REQUIRED_ENV_VARS } from "../../../../env-schema.js";
 import { wrapAsPathBasedClient } from "openapi-fetch";
 import { z } from "zod";
 const alterTopicConfigArguments = z.object({
-    clusterId: z
-        .string()
-        .optional()
-        .describe("The unique identifier for the Kafka cluster."),
     topicName: z.string().describe("Name of the topic to alter").nonempty(),
     topicConfigs: z
         .array(z.object({
@@ -18,6 +14,14 @@ const alterTopicConfigArguments = z.object({
     }))
         .nonempty(),
     validateOnly: z.boolean().default(false),
+    clusterId: z
+        .string()
+        .optional()
+        .describe("Confluent Cloud logical Kafka cluster ID (lkc-...). Discover via list-clusters."),
+    environmentId: z
+        .string()
+        .optional()
+        .describe("Confluent Cloud environment ID (env-...) that owns the cluster. Discover via list-environments."),
 });
 /**
  * Handler for altering Kafka topic configurations through Confluent Cloud REST API.
@@ -26,14 +30,16 @@ const alterTopicConfigArguments = z.object({
  * Instead, we utilize Confluent's REST API endpoints to achieve this functionality.
  */
 export class AlterTopicConfigHandler extends BaseToolHandler {
-    async handle(clientManager, toolArguments) {
-        const { clusterId, topicName, topicConfigs, validateOnly } = alterTopicConfigArguments.parse(toolArguments);
-        const kafka_cluster_id = getEnsuredParam("KAFKA_CLUSTER_ID", "Kafka Cluster ID is required", clusterId);
-        const pathBasedClient = wrapAsPathBasedClient(clientManager.getConfluentCloudKafkaRestClient());
-        const { data: response, error } = await pathBasedClient[`/kafka/v3/clusters/${kafka_cluster_id}/topics/${topicName}/configs:alter`].POST({
+    async handle(runtime, toolArguments) {
+        const parsed = alterTopicConfigArguments.parse(toolArguments);
+        const { connId, clientManager } = this.resolveSoleConnection(runtime);
+        const { clusterId, envId } = resolveKafkaRestArgs(parsed, runtime, connId);
+        const restClient = await clientManager.getConfluentCloudKafkaRestClient(clusterId, envId);
+        const pathBasedClient = wrapAsPathBasedClient(restClient);
+        const { data: response, error } = await pathBasedClient[`/kafka/v3/clusters/${clusterId}/topics/${parsed.topicName}/configs:alter`].POST({
             body: {
-                data: topicConfigs,
-                validate_only: validateOnly,
+                data: parsed.topicConfigs,
+                validate_only: parsed.validateOnly,
             },
         });
         if (error) {
@@ -49,11 +55,7 @@ export class AlterTopicConfigHandler extends BaseToolHandler {
             annotations: CREATE_UPDATE,
         };
     }
-    getRequiredEnvVars() {
-        return KAFKA_REST_REQUIRED_ENV_VARS;
-    }
-    isConfluentCloudOnly() {
-        return true;
-    }
+    category = ToolCategory.Kafka;
+    predicate = kafkaRestWithAuthOrOAuth;
 }
 //# 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,EACf,aAAa,GAEd,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,mCAAmC,CAAC;AAC7D,OAAO,EAAU,4BAA4B,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,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,GACxD,yBAAyB,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QACjD,MAAM,gBAAgB,GAAG,eAAe,CACtC,kBAAkB,EAClB,8BAA8B,EAC9B,SAAS,CACV,CAAC;QAEF,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;YAC5C,WAAW,EAAE,aAAa;SAC3B,CAAC;IACJ,CAAC;IAED,kBAAkB;QAChB,OAAO,4BAA4B,CAAC;IACtC,CAAC;IAED,oBAAoB;QAClB,OAAO,IAAI,CAAC;IACd,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

@@ -1,42 +1,214 @@
-import { KafkaMessage } from "@confluentinc/kafka-javascript/types/kafkajs.js";
+import { KafkaJS } from "@confluentinc/kafka-javascript";
+import type { 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 { BaseToolHandler, ToolCategory, ToolConfig } from "../../../../confluent/tools/base-tools.js";
+import { ServerRuntime } from "../../../../server-runtime.js";
 import { z } from "zod";
-declare const valueOptions: z.ZodObject<{
-    useSchemaRegistry: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
-    subject: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
-declare const keyOptions: z.ZodObject<{
-    useSchemaRegistry: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+declare const schemaRegistryOptions: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+    disableSchemaRegistry: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     subject: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>>;
+type ValueOptions = z.infer<typeof schemaRegistryOptions>;
+type KeyOptions = z.infer<typeof schemaRegistryOptions>;
+/**
+ * Per-topic consume options. `name` is the only required field. `partition`
+ * optionally restricts to one partition; `start` optionally picks the
+ * starting position. Both are independent — `partition` answers WHICH
+ * partition(s), `start` answers WHERE in them to begin.
+ */
+declare const topicConsumeOptions: z.ZodObject<{
+    name: z.ZodString;
+    partition: z.ZodOptional<z.ZodNumber>;
+    start: z.ZodDefault<z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"earliest">, z.ZodLiteral<"latest">, z.ZodObject<{
+        offset: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        timestamp: z.ZodUnion<readonly [z.ZodISODateTime, z.ZodNumber]>;
+    }, z.core.$strict>, z.ZodObject<{
+        tail: z.ZodNumber;
+    }, z.core.$strict>]>>>;
 }, z.core.$strip>;
-type ValueOptions = z.infer<typeof valueOptions>;
-type KeyOptions = z.infer<typeof keyOptions>;
 export declare const consumeKafkaMessagesArgs: z.ZodObject<{
-    topicNames: z.ZodArray<z.ZodString>;
+    topics: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        partition: z.ZodOptional<z.ZodNumber>;
+        start: z.ZodDefault<z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"earliest">, z.ZodLiteral<"latest">, z.ZodObject<{
+            offset: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            timestamp: z.ZodUnion<readonly [z.ZodISODateTime, z.ZodNumber]>;
+        }, z.core.$strict>, z.ZodObject<{
+            tail: z.ZodNumber;
+        }, z.core.$strict>]>>>;
+    }, z.core.$strip>>;
     maxMessages: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     timeoutMs: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
-    value: z.ZodObject<{
-        useSchemaRegistry: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    valueFormat: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+        disableSchemaRegistry: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
         subject: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>;
-    key: z.ZodOptional<z.ZodObject<{
-        useSchemaRegistry: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    }, z.core.$strip>>>;
+    keyFormat: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+        disableSchemaRegistry: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
         subject: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>>;
+    }, z.core.$strip>>>;
+    cluster_id: z.ZodOptional<z.ZodString>;
+    environment_id: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
-interface ProcessedMessage {
+export interface ProcessedMessage {
     key: unknown;
     value: unknown;
+    /**
+     * Message timestamp, normalized by {@link formatMessageTimestamp}.
+     * Usual case: an ISO 8601 UTC string like `"2026-03-01T17:00:00.000Z"`
+     * — surfaced in this format so an LLM consumer can immediately spot
+     * mismatches between a requested `start: {timestamp}` filter and the
+     * delivered records (ms-since-epoch makes such drift invisible
+     * without arithmetic). Two non-ISO outcomes are possible:
+     *
+     * - The literal sentinel `"(no timestamp)"` when the underlying
+     *   Kafka message has no timestamp (Kafka's `-1` sentinel for
+     *   pre-0.10.0 message formats, or any record whose producer didn't
+     *   set one).
+     * - The raw input string passed through unchanged when
+     *   `Number(input)` is non-finite — a defensive escape hatch for
+     *   degenerate library inputs.
+     */
     timestamp: string;
     offset: string;
     headers?: Record<string, string>;
     topic: string;
     partition: number;
 }
+/**
+ * Format a Kafka message's `message.timestamp` (a string of ms-since-epoch
+ * per kafkajs) into an ISO 8601 UTC string. Returns `"(no timestamp)"` for
+ * undefined or Kafka's `-1` sentinel (message format pre-0.10.0 or
+ * timestamp unset by the producer). Exported for direct unit-test coverage
+ * of the four branches plus the empty-string edge case (`Number("")` is
+ * `0`, which is finite, so an empty timestamp string formats as epoch).
+ */
+export declare function formatMessageTimestamp(ts: string | undefined): string;
+/**
+ * Internal normalized form for the per-topic consume options. Each parsed
+ * `topics` entry's `start` union collapses into one of these tagged
+ * variants so downstream code switches on `start.kind` instead of probing
+ * for which optional field happens to be set.
+ */
+type NormalizedStart = {
+    kind: "earliest";
+} | {
+    kind: "latest";
+} | {
+    kind: "offset";
+    value: string;
+} | {
+    kind: "timestamp";
+    ms: number;
+} | {
+    kind: "tail";
+    count: number;
+};
+/**
+ * Result of {@link buildPreflightPlan}: the canonical list of topics to
+ * subscribe to plus the partition-keep set and per-partition seek targets
+ * that the post-assignment dance will apply.
+ */
+interface PreflightPlan {
+    /** Unique topic names to subscribe to (deduplicated across entries). */
+    topicNames: string[];
+    /**
+     * If a topic appears here, only the listed partitions are kept active;
+     * any other partition the broker assigns is paused. Absent topic means
+     * "keep every assigned partition for that topic."
+     */
+    keepPartitions: Map<string, Set<number>>;
+    /** Per-(topic, partition) seek targets. */
+    seeks: {
+        topic: string;
+        partition: number;
+        offset: string;
+    }[];
+}
+/**
+ * Collapse the parsed `start` union into the internal tagged form.
+ * ISO 8601 timestamps normalize to ms-since-epoch at this boundary so
+ * downstream code only sees numbers. Exported so the timestamp-arm's
+ * string-vs-number branch can be unit-tested directly (the handler-level
+ * tests only exercise the string path).
+ */
+export declare function normalizeStart(start: z.infer<typeof topicConsumeOptions>["start"]): NormalizedStart;
+/**
+ * Poll `consumer.assignment()` until it returns a non-empty array or the
+ * supplied deadline passes. Returns the assignment, or `null` if the
+ * deadline was hit first. The kafkajs-compat consumer only populates its
+ * assignment after `consumer.run()` triggers the first poll, so this is
+ * the well-defined seam to wait on before issuing per-partition seeks.
+ * Exported so the three branches (immediate-return, polled-populate,
+ * polled-timeout) can be exercised directly under fake timers.
+ */
+export declare function waitForAssignment(consumer: KafkaJS.Consumer, deadline: number): Promise<{
+    topic: string;
+    partition: number;
+}[] | null>;
+/**
+ * Drive the post-`consumer.run()` pause step: poll for an assignment up
+ * to `deadlineMs`, then pause partitions outside the keep-set. Signals
+ * completion via callbacks rather than its return value because the
+ * orchestrator's `Promise.race` only cares about success (`onApplied`)
+ * vs. assignment-deadline-elapsed (`onAssignmentTimedOut`); internal
+ * pause failures propagate as a rejection so the race can surface them
+ * via `rejectOnly`.
+ */
+export declare function applyPostAssignmentHook(opts: {
+    consumer: KafkaJS.Consumer;
+    plan: PreflightPlan;
+    deadlineMs: number;
+    onApplied: () => void;
+    onAssignmentTimedOut: () => void;
+}): Promise<void>;
+/**
+ * Build the `eachMessage` callback `consumer.run` invokes per record.
+ * Pulled out of the orchestrator so the synchronous gates and the
+ * "did we hit `maxMessages`?" signal are individually testable.
+ *
+ * The synchronous boolean/predicate getters (`isAccepting`,
+ * `isPreflightApplied`, `shouldKeepDuringPrePause`) intentionally stay
+ * synchronous — `await`ing a Deferred in their place would change
+ * behavior, because pre-pause deliveries from librdkafka's fetch buffer
+ * must be filtered on arrival rather than queued through.
+ *
+ * Pre-pause gate semantics: before the post-assignment pause step has
+ * run, drop a delivery **only** when its `(topic, partition)` is one
+ * we'd pause anyway (i.e. outside the topic's keep-set). Keep-set
+ * deliveries arriving during the brief window between assignment-landing
+ * and pause-being-applied are real records the caller asked for; the
+ * pre-run-stashed seeks have already positioned the consumer, so
+ * librdkafka can hand them to `eachMessage` immediately. Dropping them
+ * would be silent data loss. After `preflightApplied` flips, the gate
+ * doesn't fire (pause has already kept the unwanted partitions silent).
+ */
+export declare function createEachMessageHandler(opts: {
+    state: {
+        consumedMessages: ProcessedMessage[];
+        isAccepting: () => boolean;
+        isPreflightApplied: () => boolean;
+        /**
+         * Returns `true` if this `(topic, partition)` is in the topic's
+         * keep-set (or the topic has no partition restriction at all). Used
+         * by the pre-pause gate to let legitimate caller-requested records
+         * through immediately while still dropping the about-to-be-paused
+         * partitions that librdkafka may deliver in the assignment-to-pause
+         * window.
+         */
+        shouldKeepDuringPrePause: (topic: string, partition: number) => boolean;
+    };
+    maxMessages: number;
+    onMaxReached: () => void;
+    processMessage: (topic: string, partition: number, message: KafkaMessage) => Promise<ProcessedMessage>;
+}): (payload: {
+    topic: string;
+    partition: number;
+    message: KafkaMessage;
+}) => Promise<void>;
 /**
  * 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.
@@ -49,21 +221,35 @@ export declare class ConsumeKafkaMessagesHandler extends BaseToolHandler {
      * @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
+     * @param valueOptions - Options for value-side deserialization
+     * @param keyOptions - Options for key-side 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>;
+    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
+     * Consume messages from one or more Kafka topics, honoring per-topic
+     * `partition` and `start` controls. Resolves when one of four exit
+     * conditions wins a `Promise.race`: `maxMessages` records have been
+     * collected, the `timeoutMs` budget elapses, `consumer.run()` rejects,
+     * or the post-assignment hook rejects. On the timeout path the
+     * partial set collected so far is returned (success-shaped response,
+     * not an error).
+     *
+     * @param runtime - The {@link ServerRuntime} (config + active client
+     *   manager + OAuth holder). Supplied by the MCP server dispatcher;
+     *   the handler resolves cluster/env/registry clients off of it.
+     * @param toolArguments - Parsed args matching `consumeKafkaMessagesArgs`.
+     *   The handler re-parses internally to apply defaults at the
+     *   boundary.
+     * @returns A {@link CallToolResult}. Success path emits a text block
+     *   summarizing the consumed messages; failures (build/preflight/run
+     *   errors) surface via `createResponse(text, true)` with the
+     *   formatted Kafka error.
      */
-    handle(clientManager: ClientManager, toolArguments: z.infer<typeof consumeKafkaMessagesArgs>, sessionId?: string): Promise<CallToolResult>;
+    handle(runtime: ServerRuntime, toolArguments: z.infer<typeof consumeKafkaMessagesArgs>): Promise<CallToolResult>;
     getToolConfig(): ToolConfig;
-    getRequiredEnvVars(): EnvVar[];
+    readonly category = ToolCategory.Kafka;
+    readonly predicate: import("../../../../confluent/tools/connection-predicates.js").ConnectionPredicate;
 }
 export {};
 //# sourceMappingURL=consume-kafka-messages-handler.d.ts.map

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

@@ -1 +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,EAEf,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;;;iBAA4C,CAAC;AAC/D,QAAA,MAAM,UAAU;;;iBAA4C,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;;;;;;;;;;;;iBAuBnC,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;IAU3B,kBAAkB,IAAI,MAAM,EAAE;CAG/B"}
+{"version":3,"file":"consume-kafka-messages-handler.d.ts","sourceRoot":"","sources":["../../../../../src/confluent/tools/handlers/kafka/consume-kafka-messages-handler.ts"],"names":[],"mappings":"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"}