@confluentinc/mcp-confluent 1.2.1 → 1.3.0

package/dist/confluent/tools/handlers/connect/create-connector-handler.js

@@ -1,17 +1,10 @@
-import { getEnsuredParam } from "../../../../confluent/helpers.js";
-import { BaseToolHandler, } from "../../../../confluent/tools/base-tools.js";
+import { CREATE_UPDATE } from "../../../../confluent/tools/base-tools.js";
+import { canCreateDirectConnector } from "../../../../confluent/tools/connection-predicates.js";
+import { ConnectToolHandler } from "../../../../confluent/tools/handlers/connect/connect-tool-handler.js";
 import { ToolName } from "../../../../confluent/tools/tool-name.js";
-import env from "../../../../env.js";
 import { wrapAsPathBasedClient } from "openapi-fetch";
 import { z } from "zod";
 const createConnectorArguments = z.object({
-    baseUrl: z
-        .string()
-        .trim()
-        .describe("The base URL of the Kafka Connect REST API.")
-        .url()
-        .default(() => env.CONFLUENT_CLOUD_REST_ENDPOINT ?? "")
-        .optional(),
     environmentId: z
         .string()
         .optional()
@@ -53,28 +46,34 @@ const createConnectorArguments = z.object({
         // Allow additional string properties
         .catchall(z.string()),
 });
-export class CreateConnectorHandler extends BaseToolHandler {
-    async handle(clientManager, toolArguments) {
-        const { clusterId, environmentId, connectorName, connectorConfig, baseUrl, } = createConnectorArguments.parse(toolArguments);
-        const environment_id = getEnsuredParam("KAFKA_ENV_ID", "Environment ID is required", environmentId);
-        const kafka_cluster_id = getEnsuredParam("KAFKA_CLUSTER_ID", "Kafka Cluster ID is required", clusterId);
-        if (baseUrl !== undefined && baseUrl !== "") {
-            clientManager.setConfluentCloudRestEndpoint(baseUrl);
-        }
+/**
+ * Creates a new Confluent Cloud connector.
+ * Requires `kafka.auth` in the connection config to supply the Kafka API
+ * credentials embedded in the connector body.
+ */
+export class CreateConnectorHandler extends ConnectToolHandler {
+    async handle(runtime, toolArguments) {
+        const clientManager = runtime.clientManager;
+        const { clusterId, environmentId, connectorName, connectorConfig } = createConnectorArguments.parse(toolArguments);
+        const conn = runtime.config.getSoleDirectConnection();
+        const { environment_id, kafka_cluster_id } = this.resolveConnectEnvAndClusterId(conn, environmentId, clusterId);
+        // The canCreateDirectConnector predicate guarantees kafka.auth is present.
+        const kafkaApiKey = this.resolveParam(undefined, conn.kafka?.auth?.key, "Kafka API Key");
+        const kafkaApiSecret = this.resolveParam(undefined, conn.kafka?.auth?.secret, "Kafka API Secret");
         const pathBasedClient = wrapAsPathBasedClient(clientManager.getConfluentCloudRestClient());
         const { data: response, error } = await pathBasedClient["/connect/v1/environments/{environment_id}/clusters/{kafka_cluster_id}/connectors"].POST({
             params: {
                 path: {
-                    environment_id: environment_id,
-                    kafka_cluster_id: kafka_cluster_id,
+                    environment_id,
+                    kafka_cluster_id,
                 },
             },
             body: {
                 name: connectorName,
                 config: {
                     name: connectorName,
-                    "kafka.api.key": getEnsuredParam("KAFKA_API_KEY", "Kafka API Key is required to create the connector. Check if env vars are properly set"),
-                    "kafka.api.secret": getEnsuredParam("KAFKA_API_SECRET", "Kafka API Secret is required to create the connector. Check if env vars are properly set"),
+                    "kafka.api.key": kafkaApiKey,
+                    "kafka.api.secret": kafkaApiSecret,
                     ...connectorConfig,
                 },
             },
@@ -89,18 +88,9 @@ export class CreateConnectorHandler extends BaseToolHandler {
             name: ToolName.CREATE_CONNECTOR,
             description: "Create a new connector. Returns the new connector information if successful.",
             inputSchema: createConnectorArguments.shape,
+            annotations: CREATE_UPDATE,
         };
     }
-    getRequiredEnvVars() {
-        return [
-            "CONFLUENT_CLOUD_API_KEY",
-            "CONFLUENT_CLOUD_API_SECRET",
-            "KAFKA_API_KEY",
-            "KAFKA_API_SECRET",
-        ];
-    }
-    isConfluentCloudOnly() {
-        return true;
-    }
+    predicate = canCreateDirectConnector;
 }
 //# sourceMappingURL=create-connector-handler.js.map

package/dist/confluent/tools/handlers/connect/create-connector-handler.js.map

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

package/dist/confluent/tools/handlers/connect/delete-connector-handler.d.ts

@@ -1,11 +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 DeleteConnectorHandler extends BaseToolHandler {
-    handle(clientManager: ClientManager, toolArguments: Record<string, unknown> | undefined): Promise<CallToolResult>;
+import { ToolConfig } from "../../../../confluent/tools/base-tools.js";
+import { ConnectToolHandler } from "../../../../confluent/tools/handlers/connect/connect-tool-handler.js";
+import { ServerRuntime } from "../../../../server-runtime.js";
+/** Deletes a named connector from the given environment and cluster. */
+export declare class DeleteConnectorHandler extends ConnectToolHandler {
+    handle(runtime: ServerRuntime, toolArguments: Record<string, unknown> | undefined): Promise<CallToolResult>;
     getToolConfig(): ToolConfig;
-    getRequiredEnvVars(): EnvVar[];
-    isConfluentCloudOnly(): boolean;
 }
 //# sourceMappingURL=delete-connector-handler.d.ts.map

package/dist/confluent/tools/handlers/connect/delete-connector-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"delete-connector-handler.d.ts","sourceRoot":"","sources":["../../../../../src/confluent/tools/handlers/connect/delete-connector-handler.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,qBAAa,sBAAuB,SAAQ,eAAe;IACnD,MAAM,CACV,aAAa,EAAE,aAAa,EAC5B,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GACjD,OAAO,CAAC,cAAc,CAAC;IA4C1B,aAAa,IAAI,UAAU;IAS3B,kBAAkB,IAAI,MAAM,EAAE;IAI9B,oBAAoB,IAAI,OAAO;CAGhC"}
+{"version":3,"file":"delete-connector-handler.d.ts","sourceRoot":"","sources":["../../../../../src/confluent/tools/handlers/connect/delete-connector-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAe,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAC7E,OAAO,EAAE,kBAAkB,EAAE,MAAM,+DAA+D,CAAC;AAEnG,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAqBvD,wEAAwE;AACxE,qBAAa,sBAAuB,SAAQ,kBAAkB;IACtD,MAAM,CACV,OAAO,EAAE,aAAa,EACtB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GACjD,OAAO,CAAC,cAAc,CAAC;IAmC1B,aAAa,IAAI,UAAU;CAS5B"}

package/dist/confluent/tools/handlers/connect/delete-connector-handler.js

@@ -1,17 +1,9 @@
-import { getEnsuredParam } from "../../../../confluent/helpers.js";
-import { BaseToolHandler, } from "../../../../confluent/tools/base-tools.js";
+import { DESTRUCTIVE } from "../../../../confluent/tools/base-tools.js";
+import { ConnectToolHandler } from "../../../../confluent/tools/handlers/connect/connect-tool-handler.js";
 import { ToolName } from "../../../../confluent/tools/tool-name.js";
-import env from "../../../../env.js";
 import { wrapAsPathBasedClient } from "openapi-fetch";
 import { z } from "zod";
 const deleteConnectorArguments = z.object({
-    baseUrl: z
-        .string()
-        .trim()
-        .describe("The base URL of the Kafka Connect REST API.")
-        .url()
-        .default(() => env.CONFLUENT_CLOUD_REST_ENDPOINT ?? "")
-        .optional(),
     environmentId: z
         .string()
         .optional()
@@ -25,20 +17,19 @@ const deleteConnectorArguments = z.object({
         .nonempty()
         .describe("The name of the connector to delete."),
 });
-export class DeleteConnectorHandler extends BaseToolHandler {
-    async handle(clientManager, toolArguments) {
-        const { clusterId, environmentId, connectorName, baseUrl } = deleteConnectorArguments.parse(toolArguments);
-        const environment_id = getEnsuredParam("KAFKA_ENV_ID", "Environment ID is required", environmentId);
-        const kafka_cluster_id = getEnsuredParam("KAFKA_CLUSTER_ID", "Kafka Cluster ID is required", clusterId);
-        if (baseUrl !== undefined && baseUrl !== "") {
-            clientManager.setConfluentCloudRestEndpoint(baseUrl);
-        }
+/** Deletes a named connector from the given environment and cluster. */
+export class DeleteConnectorHandler extends ConnectToolHandler {
+    async handle(runtime, toolArguments) {
+        const clientManager = runtime.clientManager;
+        const { clusterId, environmentId, connectorName } = deleteConnectorArguments.parse(toolArguments);
+        const conn = runtime.config.getSoleDirectConnection();
+        const { environment_id, kafka_cluster_id } = this.resolveConnectEnvAndClusterId(conn, environmentId, clusterId);
         const pathBasedClient = wrapAsPathBasedClient(clientManager.getConfluentCloudRestClient());
         const { error } = await pathBasedClient["/connect/v1/environments/{environment_id}/clusters/{kafka_cluster_id}/connectors/{connector_name}"].DELETE({
             params: {
                 path: {
-                    environment_id: environment_id,
-                    kafka_cluster_id: kafka_cluster_id,
+                    environment_id,
+                    kafka_cluster_id,
                     connector_name: connectorName,
                 },
             },
@@ -53,13 +44,8 @@ export class DeleteConnectorHandler extends BaseToolHandler {
             name: ToolName.DELETE_CONNECTOR,
             description: "Delete an existing connector. Returns success message if deletion was successful.",
             inputSchema: deleteConnectorArguments.shape,
+            annotations: DESTRUCTIVE,
         };
     }
-    getRequiredEnvVars() {
-        return ["CONFLUENT_CLOUD_API_KEY", "CONFLUENT_CLOUD_API_SECRET"];
-    }
-    isConfluentCloudOnly() {
-        return true;
-    }
 }
 //# sourceMappingURL=delete-connector-handler.js.map

package/dist/confluent/tools/handlers/connect/delete-connector-handler.js.map

@@ -1 +1 @@
-{"version":3,"file":"delete-connector-handler.js","sourceRoot":"","sources":["../../../../../src/confluent/tools/handlers/connect/delete-connector-handler.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;AAE7D,OAAO,GAAG,MAAM,aAAa,CAAC;AAC9B,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,IAAI,EAAE;SACN,QAAQ,CAAC,6CAA6C,CAAC;SACvD,GAAG,EAAE;SACL,OAAO,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,6BAA6B,IAAI,EAAE,CAAC;SACtD,QAAQ,EAAE;IACb,aAAa,EAAE,CAAC;SACb,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,qEAAqE,CACtE;IACH,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,8CAA8C,CAAC;IAC3D,aAAa,EAAE,CAAC;SACb,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,sCAAsC,CAAC;CACpD,CAAC,CAAC;AAEH,MAAM,OAAO,sBAAuB,SAAQ,eAAe;IACzD,KAAK,CAAC,MAAM,CACV,aAA4B,EAC5B,aAAkD;QAElD,MAAM,EAAE,SAAS,EAAE,aAAa,EAAE,aAAa,EAAE,OAAO,EAAE,GACxD,wBAAwB,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QAChD,MAAM,cAAc,GAAG,eAAe,CACpC,cAAc,EACd,4BAA4B,EAC5B,aAAa,CACd,CAAC;QACF,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,6BAA6B,CAAC,OAAO,CAAC,CAAC;QACvD,CAAC;QAED,MAAM,eAAe,GAAG,qBAAqB,CAC3C,aAAa,CAAC,2BAA2B,EAAE,CAC5C,CAAC;QACF,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,eAAe,CACrC,mGAAmG,CACpG,CAAC,MAAM,CAAC;YACP,MAAM,EAAE;gBACN,IAAI,EAAE;oBACJ,cAAc,EAAE,cAAc;oBAC9B,gBAAgB,EAAE,gBAAgB;oBAClC,cAAc,EAAE,aAAa;iBAC9B;aACF;SACF,CAAC,CAAC;QAEH,IAAI,KAAK,EAAE,CAAC;YACV,OAAO,IAAI,CAAC,cAAc,CACxB,8BAA8B,aAAa,KAAK,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,EACvE,IAAI,CACL,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC,cAAc,CACxB,kCAAkC,aAAa,EAAE,CAClD,CAAC;IACJ,CAAC;IAED,aAAa;QACX,OAAO;YACL,IAAI,EAAE,QAAQ,CAAC,gBAAgB;YAC/B,WAAW,EACT,mFAAmF;YACrF,WAAW,EAAE,wBAAwB,CAAC,KAAK;SAC5C,CAAC;IACJ,CAAC;IAED,kBAAkB;QAChB,OAAO,CAAC,yBAAyB,EAAE,4BAA4B,CAAC,CAAC;IACnE,CAAC;IAED,oBAAoB;QAClB,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}
+{"version":3,"file":"delete-connector-handler.js","sourceRoot":"","sources":["../../../../../src/confluent/tools/handlers/connect/delete-connector-handler.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAc,MAAM,oCAAoC,CAAC;AAC7E,OAAO,EAAE,kBAAkB,EAAE,MAAM,+DAA+D,CAAC;AACnG,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,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,aAAa,EAAE,CAAC;SACb,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,qEAAqE,CACtE;IACH,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,8CAA8C,CAAC;IAC3D,aAAa,EAAE,CAAC;SACb,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,sCAAsC,CAAC;CACpD,CAAC,CAAC;AAEH,wEAAwE;AACxE,MAAM,OAAO,sBAAuB,SAAQ,kBAAkB;IAC5D,KAAK,CAAC,MAAM,CACV,OAAsB,EACtB,aAAkD;QAElD,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;QAC5C,MAAM,EAAE,SAAS,EAAE,aAAa,EAAE,aAAa,EAAE,GAC/C,wBAAwB,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QAEhD,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,uBAAuB,EAAE,CAAC;QACtD,MAAM,EAAE,cAAc,EAAE,gBAAgB,EAAE,GACxC,IAAI,CAAC,6BAA6B,CAAC,IAAI,EAAE,aAAa,EAAE,SAAS,CAAC,CAAC;QAErE,MAAM,eAAe,GAAG,qBAAqB,CAC3C,aAAa,CAAC,2BAA2B,EAAE,CAC5C,CAAC;QACF,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,eAAe,CACrC,mGAAmG,CACpG,CAAC,MAAM,CAAC;YACP,MAAM,EAAE;gBACN,IAAI,EAAE;oBACJ,cAAc;oBACd,gBAAgB;oBAChB,cAAc,EAAE,aAAa;iBAC9B;aACF;SACF,CAAC,CAAC;QAEH,IAAI,KAAK,EAAE,CAAC;YACV,OAAO,IAAI,CAAC,cAAc,CACxB,8BAA8B,aAAa,KAAK,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,EACvE,IAAI,CACL,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC,cAAc,CACxB,kCAAkC,aAAa,EAAE,CAClD,CAAC;IACJ,CAAC;IAED,aAAa;QACX,OAAO;YACL,IAAI,EAAE,QAAQ,CAAC,gBAAgB;YAC/B,WAAW,EACT,mFAAmF;YACrF,WAAW,EAAE,wBAAwB,CAAC,KAAK;YAC3C,WAAW,EAAE,WAAW;SACzB,CAAC;IACJ,CAAC;CACF"}

package/dist/confluent/tools/handlers/connect/list-connectors-handler.d.ts

@@ -1,11 +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 ListConnectorsHandler extends BaseToolHandler {
-    handle(clientManager: ClientManager, toolArguments: Record<string, unknown> | undefined): Promise<CallToolResult>;
+import { ToolConfig } from "../../../../confluent/tools/base-tools.js";
+import { ConnectToolHandler } from "../../../../confluent/tools/handlers/connect/connect-tool-handler.js";
+import { ServerRuntime } from "../../../../server-runtime.js";
+/** Lists the names of active connectors for a given environment and cluster. */
+export declare class ListConnectorsHandler extends ConnectToolHandler {
+    handle(runtime: ServerRuntime, toolArguments: Record<string, unknown> | undefined): Promise<CallToolResult>;
     getToolConfig(): ToolConfig;
-    getRequiredEnvVars(): EnvVar[];
-    isConfluentCloudOnly(): boolean;
 }
 //# sourceMappingURL=list-connectors-handler.d.ts.map

package/dist/confluent/tools/handlers/connect/list-connectors-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list-connectors-handler.d.ts","sourceRoot":"","sources":["../../../../../src/confluent/tools/handlers/connect/list-connectors-handler.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;AA2B5C,qBAAa,qBAAsB,SAAQ,eAAe;IAClD,MAAM,CACV,aAAa,EAAE,aAAa,EAC5B,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GACjD,OAAO,CAAC,cAAc,CAAC;IA0C1B,aAAa,IAAI,UAAU;IAS3B,kBAAkB,IAAI,MAAM,EAAE;IAI9B,oBAAoB,IAAI,OAAO;CAGhC"}
+{"version":3,"file":"list-connectors-handler.d.ts","sourceRoot":"","sources":["../../../../../src/confluent/tools/handlers/connect/list-connectors-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAa,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,+DAA+D,CAAC;AAEnG,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAmBvD,gFAAgF;AAChF,qBAAa,qBAAsB,SAAQ,kBAAkB;IACrD,MAAM,CACV,OAAO,EAAE,aAAa,EACtB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GACjD,OAAO,CAAC,cAAc,CAAC;IAoC1B,aAAa,IAAI,UAAU;CAS5B"}

package/dist/confluent/tools/handlers/connect/list-connectors-handler.js

@@ -1,17 +1,9 @@
-import { getEnsuredParam } from "../../../../confluent/helpers.js";
-import { BaseToolHandler, } from "../../../../confluent/tools/base-tools.js";
+import { READ_ONLY } from "../../../../confluent/tools/base-tools.js";
+import { ConnectToolHandler } from "../../../../confluent/tools/handlers/connect/connect-tool-handler.js";
 import { ToolName } from "../../../../confluent/tools/tool-name.js";
-import env from "../../../../env.js";
 import { wrapAsPathBasedClient } from "openapi-fetch";
 import { z } from "zod";
 const listConnectorArguments = z.object({
-    baseUrl: z
-        .string()
-        .trim()
-        .describe("The base URL of the Kafka Connect REST API.")
-        .url()
-        .default(() => env.CONFLUENT_CLOUD_REST_ENDPOINT ?? "")
-        .optional(),
     environmentId: z
         .string()
         .trim()
@@ -23,40 +15,37 @@ const listConnectorArguments = z.object({
         .optional()
         .describe("The unique identifier for the Kafka cluster."),
 });
-export class ListConnectorsHandler extends BaseToolHandler {
-    async handle(clientManager, toolArguments) {
-        const { clusterId, environmentId, baseUrl } = listConnectorArguments.parse(toolArguments);
-        const environment_id = getEnsuredParam("KAFKA_ENV_ID", "Environment ID is required", environmentId);
-        const kafka_cluster_id = getEnsuredParam("KAFKA_CLUSTER_ID", "Kafka Cluster ID is required", clusterId);
-        if (baseUrl !== undefined && baseUrl !== "") {
-            clientManager.setConfluentCloudRestEndpoint(baseUrl);
-        }
+/** Lists the names of active connectors for a given environment and cluster. */
+export class ListConnectorsHandler extends ConnectToolHandler {
+    async handle(runtime, toolArguments) {
+        const clientManager = runtime.clientManager;
+        const { clusterId, environmentId } = listConnectorArguments.parse(toolArguments);
+        const conn = runtime.config.getSoleDirectConnection();
+        const { environment_id, kafka_cluster_id } = this.resolveConnectEnvAndClusterId(conn, environmentId, clusterId);
         const pathBasedClient = wrapAsPathBasedClient(clientManager.getConfluentCloudRestClient());
         const { data: response, error } = await pathBasedClient["/connect/v1/environments/{environment_id}/clusters/{kafka_cluster_id}/connectors"].GET({
             params: {
                 path: {
-                    environment_id: environment_id,
-                    kafka_cluster_id: kafka_cluster_id,
+                    environment_id,
+                    kafka_cluster_id,
                 },
             },
         });
         if (error) {
-            return this.createResponse(`Failed to list Confluent Cloud connectors for ${clusterId}: ${JSON.stringify(error)}`, true);
+            return this.createResponse(`Failed to list Confluent Cloud connectors for ${kafka_cluster_id}: ${JSON.stringify(error)}`, true);
         }
-        return this.createResponse(`Active Connectors: ${JSON.stringify(response?.join(","))}`);
+        const names = response ?? [];
+        return this.createResponse(names.length > 0
+            ? `Active Connectors:\n${names.join("\n")}`
+            : "Active Connectors: (none)");
     }
     getToolConfig() {
         return {
             name: ToolName.LIST_CONNECTORS,
             description: 'Retrieve a list of "names" of the active connectors. You can then make a read request for a specific connector by name.',
             inputSchema: listConnectorArguments.shape,
+            annotations: READ_ONLY,
         };
     }
-    getRequiredEnvVars() {
-        return ["CONFLUENT_CLOUD_API_KEY", "CONFLUENT_CLOUD_API_SECRET"];
-    }
-    isConfluentCloudOnly() {
-        return true;
-    }
 }
 //# sourceMappingURL=list-connectors-handler.js.map

package/dist/confluent/tools/handlers/connect/list-connectors-handler.js.map

@@ -1 +1 @@
-{"version":3,"file":"list-connectors-handler.js","sourceRoot":"","sources":["../../../../../src/confluent/tools/handlers/connect/list-connectors-handler.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;AAE7D,OAAO,GAAG,MAAM,aAAa,CAAC;AAC9B,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,IAAI,EAAE;SACN,QAAQ,CAAC,6CAA6C,CAAC;SACvD,GAAG,EAAE;SACL,OAAO,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,6BAA6B,IAAI,EAAE,CAAC;SACtD,QAAQ,EAAE;IACb,aAAa,EAAE,CAAC;SACb,MAAM,EAAE;SACR,IAAI,EAAE;SACN,QAAQ,EAAE;SACV,QAAQ,CACP,qEAAqE,CACtE;IACH,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,IAAI,EAAE;SACN,QAAQ,EAAE;SACV,QAAQ,CAAC,8CAA8C,CAAC;CAC5D,CAAC,CAAC;AAEH,MAAM,OAAO,qBAAsB,SAAQ,eAAe;IACxD,KAAK,CAAC,MAAM,CACV,aAA4B,EAC5B,aAAkD;QAElD,MAAM,EAAE,SAAS,EAAE,aAAa,EAAE,OAAO,EAAE,GACzC,sBAAsB,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QAE9C,MAAM,cAAc,GAAG,eAAe,CACpC,cAAc,EACd,4BAA4B,EAC5B,aAAa,CACd,CAAC;QACF,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,6BAA6B,CAAC,OAAO,CAAC,CAAC;QACvD,CAAC;QAED,MAAM,eAAe,GAAG,qBAAqB,CAC3C,aAAa,CAAC,2BAA2B,EAAE,CAC5C,CAAC;QACF,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,MAAM,eAAe,CACrD,kFAAkF,CACnF,CAAC,GAAG,CAAC;YACJ,MAAM,EAAE;gBACN,IAAI,EAAE;oBACJ,cAAc,EAAE,cAAc;oBAC9B,gBAAgB,EAAE,gBAAgB;iBACnC;aACF;SACF,CAAC,CAAC;QACH,IAAI,KAAK,EAAE,CAAC;YACV,OAAO,IAAI,CAAC,cAAc,CACxB,iDAAiD,SAAS,KAAK,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,EACtF,IAAI,CACL,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC,cAAc,CACxB,sBAAsB,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAC5D,CAAC;IACJ,CAAC;IACD,aAAa;QACX,OAAO;YACL,IAAI,EAAE,QAAQ,CAAC,eAAe;YAC9B,WAAW,EACT,yHAAyH;YAC3H,WAAW,EAAE,sBAAsB,CAAC,KAAK;SAC1C,CAAC;IACJ,CAAC;IAED,kBAAkB;QAChB,OAAO,CAAC,yBAAyB,EAAE,4BAA4B,CAAC,CAAC;IACnE,CAAC;IAED,oBAAoB;QAClB,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}
+{"version":3,"file":"list-connectors-handler.js","sourceRoot":"","sources":["../../../../../src/confluent/tools/handlers/connect/list-connectors-handler.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAc,MAAM,oCAAoC,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,+DAA+D,CAAC;AACnG,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,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,aAAa,EAAE,CAAC;SACb,MAAM,EAAE;SACR,IAAI,EAAE;SACN,QAAQ,EAAE;SACV,QAAQ,CACP,qEAAqE,CACtE;IACH,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,IAAI,EAAE;SACN,QAAQ,EAAE;SACV,QAAQ,CAAC,8CAA8C,CAAC;CAC5D,CAAC,CAAC;AAEH,gFAAgF;AAChF,MAAM,OAAO,qBAAsB,SAAQ,kBAAkB;IAC3D,KAAK,CAAC,MAAM,CACV,OAAsB,EACtB,aAAkD;QAElD,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;QAC5C,MAAM,EAAE,SAAS,EAAE,aAAa,EAAE,GAChC,sBAAsB,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QAE9C,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,uBAAuB,EAAE,CAAC;QACtD,MAAM,EAAE,cAAc,EAAE,gBAAgB,EAAE,GACxC,IAAI,CAAC,6BAA6B,CAAC,IAAI,EAAE,aAAa,EAAE,SAAS,CAAC,CAAC;QAErE,MAAM,eAAe,GAAG,qBAAqB,CAC3C,aAAa,CAAC,2BAA2B,EAAE,CAC5C,CAAC;QACF,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,MAAM,eAAe,CACrD,kFAAkF,CACnF,CAAC,GAAG,CAAC;YACJ,MAAM,EAAE;gBACN,IAAI,EAAE;oBACJ,cAAc;oBACd,gBAAgB;iBACjB;aACF;SACF,CAAC,CAAC;QACH,IAAI,KAAK,EAAE,CAAC;YACV,OAAO,IAAI,CAAC,cAAc,CACxB,iDAAiD,gBAAgB,KAAK,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,EAC7F,IAAI,CACL,CAAC;QACJ,CAAC;QACD,MAAM,KAAK,GAAG,QAAQ,IAAI,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC,cAAc,CACxB,KAAK,CAAC,MAAM,GAAG,CAAC;YACd,CAAC,CAAC,uBAAuB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;YAC3C,CAAC,CAAC,2BAA2B,CAChC,CAAC;IACJ,CAAC;IAED,aAAa;QACX,OAAO;YACL,IAAI,EAAE,QAAQ,CAAC,eAAe;YAC9B,WAAW,EACT,yHAAyH;YAC3H,WAAW,EAAE,sBAAsB,CAAC,KAAK;YACzC,WAAW,EAAE,SAAS;SACvB,CAAC;IACJ,CAAC;CACF"}

package/dist/confluent/tools/handlers/connect/read-connectors-handler.d.ts

@@ -1,11 +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 ReadConnectorHandler extends BaseToolHandler {
-    handle(clientManager: ClientManager, toolArguments: Record<string, unknown> | undefined): Promise<CallToolResult>;
+import { ToolConfig } from "../../../../confluent/tools/base-tools.js";
+import { ConnectToolHandler } from "../../../../confluent/tools/handlers/connect/connect-tool-handler.js";
+import { ServerRuntime } from "../../../../server-runtime.js";
+/** Fetches full details for a single named connector. */
+export declare class ReadConnectorHandler extends ConnectToolHandler {
+    handle(runtime: ServerRuntime, toolArguments: Record<string, unknown> | undefined): Promise<CallToolResult>;
     getToolConfig(): ToolConfig;
-    getRequiredEnvVars(): EnvVar[];
-    isConfluentCloudOnly(): boolean;
 }
 //# sourceMappingURL=read-connectors-handler.d.ts.map

package/dist/confluent/tools/handlers/connect/read-connectors-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"read-connectors-handler.d.ts","sourceRoot":"","sources":["../../../../../src/confluent/tools/handlers/connect/read-connectors-handler.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;AAgC5C,qBAAa,oBAAqB,SAAQ,eAAe;IACjD,MAAM,CACV,aAAa,EAAE,aAAa,EAC5B,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GACjD,OAAO,CAAC,cAAc,CAAC;IAyC1B,aAAa,IAAI,UAAU;IAQ3B,kBAAkB,IAAI,MAAM,EAAE;IAI9B,oBAAoB,IAAI,OAAO;CAGhC"}
+{"version":3,"file":"read-connectors-handler.d.ts","sourceRoot":"","sources":["../../../../../src/confluent/tools/handlers/connect/read-connectors-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAa,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,+DAA+D,CAAC;AAEnG,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAwBvD,yDAAyD;AACzD,qBAAa,oBAAqB,SAAQ,kBAAkB;IACpD,MAAM,CACV,OAAO,EAAE,aAAa,EACtB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GACjD,OAAO,CAAC,cAAc,CAAC;IAkC1B,aAAa,IAAI,UAAU;CAQ5B"}

package/dist/confluent/tools/handlers/connect/read-connectors-handler.js

@@ -1,17 +1,9 @@
-import { getEnsuredParam } from "../../../../confluent/helpers.js";
-import { BaseToolHandler, } from "../../../../confluent/tools/base-tools.js";
+import { READ_ONLY } from "../../../../confluent/tools/base-tools.js";
+import { ConnectToolHandler } from "../../../../confluent/tools/handlers/connect/connect-tool-handler.js";
 import { ToolName } from "../../../../confluent/tools/tool-name.js";
-import env from "../../../../env.js";
 import { wrapAsPathBasedClient } from "openapi-fetch";
 import { z } from "zod";
 const readConnectorArguments = z.object({
-    baseUrl: z
-        .string()
-        .trim()
-        .describe("The base URL of the Kafka Connect REST API.")
-        .url()
-        .default(() => env.CONFLUENT_CLOUD_REST_ENDPOINT ?? "")
-        .optional(),
     environmentId: z
         .string()
         .trim()
@@ -28,21 +20,20 @@ const readConnectorArguments = z.object({
         .nonempty()
         .describe("The unique name of the connector."),
 });
-export class ReadConnectorHandler extends BaseToolHandler {
-    async handle(clientManager, toolArguments) {
-        const { clusterId, environmentId, connectorName, baseUrl } = readConnectorArguments.parse(toolArguments);
-        const environment_id = getEnsuredParam("KAFKA_ENV_ID", "Environment ID is required", environmentId);
-        const kafka_cluster_id = getEnsuredParam("KAFKA_CLUSTER_ID", "Kafka Cluster ID is required", clusterId);
-        if (baseUrl !== undefined && baseUrl !== "") {
-            clientManager.setConfluentCloudRestEndpoint(baseUrl);
-        }
+/** Fetches full details for a single named connector. */
+export class ReadConnectorHandler extends ConnectToolHandler {
+    async handle(runtime, toolArguments) {
+        const clientManager = runtime.clientManager;
+        const { clusterId, environmentId, connectorName } = readConnectorArguments.parse(toolArguments);
+        const conn = runtime.config.getSoleDirectConnection();
+        const { environment_id, kafka_cluster_id } = this.resolveConnectEnvAndClusterId(conn, environmentId, clusterId);
         const pathBasedClient = wrapAsPathBasedClient(clientManager.getConfluentCloudRestClient());
         const { data: response, error } = await pathBasedClient["/connect/v1/environments/{environment_id}/clusters/{kafka_cluster_id}/connectors/{connector_name}"].GET({
             params: {
                 path: {
                     connector_name: connectorName,
-                    environment_id: environment_id,
-                    kafka_cluster_id: kafka_cluster_id,
+                    environment_id,
+                    kafka_cluster_id,
                 },
             },
         });
@@ -56,13 +47,8 @@ export class ReadConnectorHandler extends BaseToolHandler {
             name: ToolName.READ_CONNECTOR,
             description: "Get information about the connector.",
             inputSchema: readConnectorArguments.shape,
+            annotations: READ_ONLY,
         };
     }
-    getRequiredEnvVars() {
-        return ["CONFLUENT_CLOUD_API_KEY", "CONFLUENT_CLOUD_API_SECRET"];
-    }
-    isConfluentCloudOnly() {
-        return true;
-    }
 }
 //# sourceMappingURL=read-connectors-handler.js.map

package/dist/confluent/tools/handlers/connect/read-connectors-handler.js.map

@@ -1 +1 @@
-{"version":3,"file":"read-connectors-handler.js","sourceRoot":"","sources":["../../../../../src/confluent/tools/handlers/connect/read-connectors-handler.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;AAE7D,OAAO,GAAG,MAAM,aAAa,CAAC;AAC9B,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,IAAI,EAAE;SACN,QAAQ,CAAC,6CAA6C,CAAC;SACvD,GAAG,EAAE;SACL,OAAO,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,6BAA6B,IAAI,EAAE,CAAC;SACtD,QAAQ,EAAE;IACb,aAAa,EAAE,CAAC;SACb,MAAM,EAAE;SACR,IAAI,EAAE;SACN,QAAQ,EAAE;SACV,QAAQ,CACP,qEAAqE,CACtE;IACH,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,IAAI,EAAE;SACN,QAAQ,EAAE;SACV,QAAQ,CAAC,8CAA8C,CAAC;IAC3D,aAAa,EAAE,CAAC;SACb,MAAM,EAAE;SACR,IAAI,EAAE;SACN,QAAQ,EAAE;SACV,QAAQ,CAAC,mCAAmC,CAAC;CACjD,CAAC,CAAC;AAEH,MAAM,OAAO,oBAAqB,SAAQ,eAAe;IACvD,KAAK,CAAC,MAAM,CACV,aAA4B,EAC5B,aAAkD;QAElD,MAAM,EAAE,SAAS,EAAE,aAAa,EAAE,aAAa,EAAE,OAAO,EAAE,GACxD,sBAAsB,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QAC9C,MAAM,cAAc,GAAG,eAAe,CACpC,cAAc,EACd,4BAA4B,EAC5B,aAAa,CACd,CAAC;QACF,MAAM,gBAAgB,GAAG,eAAe,CACtC,kBAAkB,EAClB,8BAA8B,EAC9B,SAAS,CACV,CAAC;QACF,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,EAAE,EAAE,CAAC;YAC5C,aAAa,CAAC,6BAA6B,CAAC,OAAO,CAAC,CAAC;QACvD,CAAC;QAED,MAAM,eAAe,GAAG,qBAAqB,CAC3C,aAAa,CAAC,2BAA2B,EAAE,CAC5C,CAAC;QACF,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,MAAM,eAAe,CACrD,mGAAmG,CACpG,CAAC,GAAG,CAAC;YACJ,MAAM,EAAE;gBACN,IAAI,EAAE;oBACJ,cAAc,EAAE,aAAa;oBAC7B,cAAc,EAAE,cAAc;oBAC9B,gBAAgB,EAAE,gBAAgB;iBACnC;aACF;SACF,CAAC,CAAC;QACH,IAAI,KAAK,EAAE,CAAC;YACV,OAAO,IAAI,CAAC,cAAc,CACxB,6CAA6C,aAAa,KAAK,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,EACtF,IAAI,CACL,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC,cAAc,CACxB,yBAAyB,aAAa,KAAK,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CACtE,CAAC;IACJ,CAAC;IACD,aAAa;QACX,OAAO;YACL,IAAI,EAAE,QAAQ,CAAC,cAAc;YAC7B,WAAW,EAAE,sCAAsC;YACnD,WAAW,EAAE,sBAAsB,CAAC,KAAK;SAC1C,CAAC;IACJ,CAAC;IAED,kBAAkB;QAChB,OAAO,CAAC,yBAAyB,EAAE,4BAA4B,CAAC,CAAC;IACnE,CAAC;IAED,oBAAoB;QAClB,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}
+{"version":3,"file":"read-connectors-handler.js","sourceRoot":"","sources":["../../../../../src/confluent/tools/handlers/connect/read-connectors-handler.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAc,MAAM,oCAAoC,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,+DAA+D,CAAC;AACnG,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,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,aAAa,EAAE,CAAC;SACb,MAAM,EAAE;SACR,IAAI,EAAE;SACN,QAAQ,EAAE;SACV,QAAQ,CACP,qEAAqE,CACtE;IACH,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,IAAI,EAAE;SACN,QAAQ,EAAE;SACV,QAAQ,CAAC,8CAA8C,CAAC;IAC3D,aAAa,EAAE,CAAC;SACb,MAAM,EAAE;SACR,IAAI,EAAE;SACN,QAAQ,EAAE;SACV,QAAQ,CAAC,mCAAmC,CAAC;CACjD,CAAC,CAAC;AAEH,yDAAyD;AACzD,MAAM,OAAO,oBAAqB,SAAQ,kBAAkB;IAC1D,KAAK,CAAC,MAAM,CACV,OAAsB,EACtB,aAAkD;QAElD,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;QAC5C,MAAM,EAAE,SAAS,EAAE,aAAa,EAAE,aAAa,EAAE,GAC/C,sBAAsB,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QAE9C,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,uBAAuB,EAAE,CAAC;QACtD,MAAM,EAAE,cAAc,EAAE,gBAAgB,EAAE,GACxC,IAAI,CAAC,6BAA6B,CAAC,IAAI,EAAE,aAAa,EAAE,SAAS,CAAC,CAAC;QAErE,MAAM,eAAe,GAAG,qBAAqB,CAC3C,aAAa,CAAC,2BAA2B,EAAE,CAC5C,CAAC;QACF,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,MAAM,eAAe,CACrD,mGAAmG,CACpG,CAAC,GAAG,CAAC;YACJ,MAAM,EAAE;gBACN,IAAI,EAAE;oBACJ,cAAc,EAAE,aAAa;oBAC7B,cAAc;oBACd,gBAAgB;iBACjB;aACF;SACF,CAAC,CAAC;QACH,IAAI,KAAK,EAAE,CAAC;YACV,OAAO,IAAI,CAAC,cAAc,CACxB,6CAA6C,aAAa,KAAK,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,EACtF,IAAI,CACL,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC,cAAc,CACxB,yBAAyB,aAAa,KAAK,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CACtE,CAAC;IACJ,CAAC;IAED,aAAa;QACX,OAAO;YACL,IAAI,EAAE,QAAQ,CAAC,cAAc;YAC7B,WAAW,EAAE,sCAAsC;YACnD,WAAW,EAAE,sBAAsB,CAAC,KAAK;YACzC,WAAW,EAAE,SAAS;SACvB,CAAC;IACJ,CAAC;CACF"}

package/dist/confluent/tools/handlers/diagnostics/explain-disabled-tools-handler.d.ts

@@ -0,0 +1,57 @@
+import { CallToolResult } from "../../../../confluent/schema.js";
+import { BaseToolHandler, ToolConfig, ToolHandler } from "../../../../confluent/tools/base-tools.js";
+import { ToolName } from "../../../../confluent/tools/tool-name.js";
+import { ServerRuntime } from "../../../../server-runtime.js";
+/**
+ * Diagnostic tool that surfaces *why* tools are absent from `tools/list`.
+ *
+ * The MCP protocol already advertises the enabled tool set via `tools/list`;
+ * what it does not surface is the predicate-driven decision behind every
+ * absence — which config piece is missing, and which tools each gap would
+ * unlock. This handler returns that view.
+ *
+ * v1 scope (today's release): the server enforces a single configured
+ * connection (see `enforceSingleConnectionOnly()` in
+ * `src/config/models.ts`), so the output is a flat list of disabled tools
+ * grouped by the missing config piece (kafka block, flink block, schema
+ * registry block, …). Tools enabled on the active connection are
+ * intentionally absent — `tools/list` already advertises them.
+ *
+ * v2 plan (when multi-connection support lands — issue #151's follow-ups):
+ * regrow output around connections. The text body becomes one block per
+ * connection (header + per-connection gaps) plus a `Cross-connection
+ * deltas` section that surfaces tools enabled on some connections but not
+ * others — the canonical "what does connection B need to reach parity with
+ * connection A?" view. The structured `_meta` shape mirrors that change;
+ * see the {@linkcode ToolGatingReport} JSDoc in `tool-availability.ts` for
+ * the exact target type.
+ *
+ * Until v2 lands, the helper accepts a multi-connection runtime without
+ * crashing, but the v1 flatten is *lossy*: a tool whose predicate is
+ * enabled on at least one configured connection is reported as enabled
+ * (and therefore omitted from `disabledGroups` entirely), and a tool
+ * disabled on multiple connections with different reasons is bucketed
+ * under the first disabled verdict its iteration produces — the
+ * cross-connection asymmetry vanishes from the output. Today's
+ * single-connection invariant means neither lossy case can fire in
+ * production; this paragraph exists so a future reader does not mistake
+ * defensive iteration for parity reporting.
+ *
+ * Always enabled (predicate is `alwaysEnabled`) so an operator can call it
+ * to diagnose a config that left every other tool disabled.
+ *
+ * The handlers iterable is supplied at construction time via a thunk so
+ * this module does not need to import `ToolHandlerRegistry`. Importing the
+ * registry from a registered handler would create an ESM cycle, leaving
+ * the registry's static initializer running before this class's binding
+ * is set. The thunk is invoked at request time, after every module is
+ * fully loaded, sidestepping the cycle entirely.
+ */
+export declare class ExplainDisabledToolsHandler extends BaseToolHandler {
+    private readonly listHandlers;
+    constructor(listHandlers: () => Iterable<readonly [ToolName, ToolHandler]>);
+    handle(runtime: ServerRuntime): CallToolResult;
+    getToolConfig(): ToolConfig;
+    readonly predicate: import("../../../../confluent/tools/connection-predicates.js").ConnectionPredicate;
+}
+//# sourceMappingURL=explain-disabled-tools-handler.d.ts.map

package/dist/confluent/tools/handlers/diagnostics/explain-disabled-tools-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explain-disabled-tools-handler.d.ts","sourceRoot":"","sources":["../../../../../src/confluent/tools/handlers/diagnostics/explain-disabled-tools-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EACL,eAAe,EAEf,UAAU,EACV,WAAW,EACZ,MAAM,oCAAoC,CAAC;AAO5C,OAAO,EAAE,QAAQ,EAAE,MAAM,mCAAmC,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAKvD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,qBAAa,2BAA4B,SAAQ,eAAe;IAC9D,OAAO,CAAC,QAAQ,CAAC,YAAY,CAE3B;gBAEU,YAAY,EAAE,MAAM,QAAQ,CAAC,SAAS,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;IAK1E,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,cAAc;IAK9C,aAAa,IAAI,UAAU;IAU3B,QAAQ,CAAC,SAAS,8EAAiB;CACpC"}