@confluentinc/mcp-confluent 1.1.0 → 1.2.0

package/dist/confluent/tools/handlers/flink/catalog/get-table-info-handler.js

@@ -0,0 +1,110 @@
+import { getEnsuredParam } from "../../../../../confluent/helpers.js";
+import { BaseToolHandler, } from "../../../../../confluent/tools/base-tools.js";
+import { resolveCatalogName, resolveDatabaseName, getSchemaMapping, resolveToSchemaName, } from "../../../../../confluent/tools/handlers/flink/catalog/catalog-resolver.js";
+import { executeFlinkSql } from "../../../../../confluent/tools/handlers/flink/flink-sql-helper.js";
+import { ToolName } from "../../../../../confluent/tools/tool-name.js";
+import env from "../../../../../env.js";
+import { z } from "zod";
+const getTableInfoArguments = z.object({
+    baseUrl: z
+        .string()
+        .describe("The base URL of the Flink REST API.")
+        .url()
+        .default(() => env.FLINK_REST_ENDPOINT ?? "")
+        .optional(),
+    organizationId: z
+        .string()
+        .trim()
+        .optional()
+        .describe("The unique identifier for the organization."),
+    environmentId: z
+        .string()
+        .trim()
+        .optional()
+        .describe("The unique identifier for the environment."),
+    computePoolId: z
+        .string()
+        .trim()
+        .optional()
+        .describe("The id associated with the compute pool in context."),
+    catalogName: z
+        .string()
+        .trim()
+        .optional()
+        .describe("The Flink catalog name (environment ID, e.g., env-xxxxx). Omit to use defaults."),
+    databaseName: z
+        .string()
+        .trim()
+        .optional()
+        .describe("The database/schema name. Can be cluster ID (lkc-xxxxx) or friendly name. Optional."),
+    tableName: z
+        .string()
+        .trim()
+        .nonempty()
+        .describe("The name of the table to get info for."),
+});
+export class GetTableInfoHandler extends BaseToolHandler {
+    async handle(clientManager, toolArguments) {
+        const { organizationId, environmentId, computePoolId, catalogName, databaseName, tableName, baseUrl, } = getTableInfoArguments.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 compute_pool_id = getEnsuredParam("FLINK_COMPUTE_POOL_ID", "Compute Pool ID is required", computePoolId);
+        // Smart resolution: only accept env-* format, otherwise fall back to FLINK_ENV_ID
+        const catalog_name = resolveCatalogName(catalogName);
+        if (!catalog_name) {
+            return this.createResponse("Catalog name could not be resolved. Set FLINK_ENV_ID or provide a valid environment ID (env-xxxxx).", true);
+        }
+        // Database name is optional - if provided, resolve it to friendly SCHEMA_NAME
+        const database_input = resolveDatabaseName(databaseName);
+        if (baseUrl !== undefined && baseUrl !== "") {
+            clientManager.setConfluentCloudFlinkEndpoint(baseUrl);
+        }
+        // If a database was specified, resolve cluster ID to friendly name
+        let schema_name;
+        if (database_input) {
+            const mappings = await getSchemaMapping(clientManager, catalog_name, {
+                organizationId: organization_id,
+                environmentId: environment_id,
+                computePoolId: compute_pool_id,
+            });
+            schema_name = resolveToSchemaName(database_input, mappings);
+        }
+        // Query INFORMATION_SCHEMA.TABLES for table metadata including watermarks
+        // Must fully qualify with catalog and use backticks per Confluent Cloud requirements
+        // If schema_name is provided, filter by it; otherwise search all databases for the table
+        const schemaFilter = schema_name
+            ? ` AND \`TABLE_SCHEMA\` = '${schema_name}'`
+            : "";
+        const sql = `SELECT \`TABLE_CATALOG\`, \`TABLE_SCHEMA\`, \`TABLE_NAME\`, \`TABLE_TYPE\`, \`IS_DISTRIBUTED\`, \`DISTRIBUTION_ALGORITHM\`, \`DISTRIBUTION_BUCKETS\`, \`IS_WATERMARKED\`, \`WATERMARK_COLUMN\`, \`WATERMARK_EXPRESSION\`, \`WATERMARK_IS_HIDDEN\`, \`COMMENT\` FROM \`${catalog_name}\`.\`INFORMATION_SCHEMA\`.\`TABLES\` WHERE \`TABLE_NAME\` = '${tableName}'${schemaFilter}`;
+        const result = await executeFlinkSql(clientManager, sql, {
+            organizationId: organization_id,
+            environmentId: environment_id,
+            computePoolId: compute_pool_id,
+        });
+        if (!result.success) {
+            return this.createResponse(`Failed to get table info: ${result.error}`, true);
+        }
+        const tables = result.data ?? [];
+        if (tables.length === 0) {
+            const scope = schema_name
+                ? `'${catalog_name}.${schema_name}.${tableName}'`
+                : `'${tableName}' in catalog '${catalog_name}'`;
+            return this.createResponse(`Table ${scope} not found.`, true);
+        }
+        return this.createResponse(`Table info for '${tableName}':\n${JSON.stringify(tables[0], null, 2)}`);
+    }
+    getToolConfig() {
+        return {
+            name: ToolName.GET_FLINK_TABLE_INFO,
+            description: "Get table metadata via INFORMATION_SCHEMA.TABLES. Returns watermark configuration, distribution info, and table type.",
+            inputSchema: getTableInfoArguments.shape,
+        };
+    }
+    getRequiredEnvVars() {
+        return ["FLINK_API_KEY", "FLINK_API_SECRET"];
+    }
+    isConfluentCloudOnly() {
+        return true;
+    }
+}
+//# sourceMappingURL=get-table-info-handler.js.map

package/dist/confluent/tools/handlers/flink/catalog/get-table-info-handler.js.map

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

package/dist/confluent/tools/handlers/flink/catalog/list-catalogs-handler.d.ts

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

package/dist/confluent/tools/handlers/flink/catalog/list-catalogs-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-catalogs-handler.d.ts","sourceRoot":"","sources":["../../../../../../src/confluent/tools/handlers/flink/catalog/list-catalogs-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;AAI5C,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AA0B5C,qBAAa,mBAAoB,SAAQ,eAAe;IAChD,MAAM,CACV,aAAa,EAAE,aAAa,EAC5B,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GACjD,OAAO,CAAC,cAAc,CAAC;IA2D1B,aAAa,IAAI,UAAU;IAS3B,kBAAkB,IAAI,MAAM,EAAE;IAI9B,oBAAoB,IAAI,OAAO;CAGhC"}

package/dist/confluent/tools/handlers/flink/catalog/list-catalogs-handler.js

@@ -0,0 +1,74 @@
+import { getEnsuredParam } from "../../../../../confluent/helpers.js";
+import { BaseToolHandler, } from "../../../../../confluent/tools/base-tools.js";
+import { resolveCatalogName } from "../../../../../confluent/tools/handlers/flink/catalog/catalog-resolver.js";
+import { executeFlinkSql } from "../../../../../confluent/tools/handlers/flink/flink-sql-helper.js";
+import { ToolName } from "../../../../../confluent/tools/tool-name.js";
+import { z } from "zod";
+const listCatalogsArguments = z.object({
+    baseUrl: z
+        .string()
+        .describe("The base URL of the Flink REST API.")
+        .url()
+        .optional(),
+    organizationId: z
+        .string()
+        .trim()
+        .optional()
+        .describe("The unique identifier for the organization."),
+    environmentId: z
+        .string()
+        .trim()
+        .optional()
+        .describe("The unique identifier for the environment."),
+    computePoolId: z
+        .string()
+        .trim()
+        .optional()
+        .describe("The id associated with the compute pool in context."),
+});
+export class ListCatalogsHandler extends BaseToolHandler {
+    async handle(clientManager, toolArguments) {
+        const { organizationId, environmentId, computePoolId, baseUrl } = listCatalogsArguments.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 compute_pool_id = getEnsuredParam("FLINK_COMPUTE_POOL_ID", "Compute Pool ID is required", computePoolId);
+        // Smart resolution: use FLINK_ENV_ID as the catalog name
+        const catalog_name = resolveCatalogName();
+        if (!catalog_name) {
+            return this.createResponse("Catalog name could not be resolved. Set FLINK_ENV_ID.", true);
+        }
+        if (baseUrl !== undefined && baseUrl !== "") {
+            clientManager.setConfluentCloudFlinkEndpoint(baseUrl);
+        }
+        // Query INFORMATION_SCHEMA.CATALOGS for all available catalogs
+        // Must fully qualify with catalog and use backticks per Confluent Cloud requirements
+        const sql = `SELECT \`CATALOG_NAME\` FROM \`${catalog_name}\`.\`INFORMATION_SCHEMA\`.\`CATALOGS\``;
+        const result = await executeFlinkSql(clientManager, sql, {
+            organizationId: organization_id,
+            environmentId: environment_id,
+            computePoolId: compute_pool_id,
+        });
+        if (!result.success) {
+            return this.createResponse(`Failed to list catalogs: ${result.error}`, true);
+        }
+        const catalogs = result.data ?? [];
+        if (catalogs.length === 0) {
+            return this.createResponse("No catalogs found.");
+        }
+        return this.createResponse(`Catalogs:\n${JSON.stringify(catalogs, null, 2)}`);
+    }
+    getToolConfig() {
+        return {
+            name: ToolName.LIST_FLINK_CATALOGS,
+            description: "List all catalogs available in the Flink environment via INFORMATION_SCHEMA.CATALOGS.",
+            inputSchema: listCatalogsArguments.shape,
+        };
+    }
+    getRequiredEnvVars() {
+        return ["FLINK_API_KEY", "FLINK_API_SECRET"];
+    }
+    isConfluentCloudOnly() {
+        return true;
+    }
+}
+//# sourceMappingURL=list-catalogs-handler.js.map

package/dist/confluent/tools/handlers/flink/catalog/list-catalogs-handler.js.map

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

package/dist/confluent/tools/handlers/flink/catalog/list-databases-handler.d.ts

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

package/dist/confluent/tools/handlers/flink/catalog/list-databases-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-databases-handler.d.ts","sourceRoot":"","sources":["../../../../../../src/confluent/tools/handlers/flink/catalog/list-databases-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;AAI5C,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAmC5C,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;IAgE1B,aAAa,IAAI,UAAU;IAS3B,kBAAkB,IAAI,MAAM,EAAE;IAI9B,oBAAoB,IAAI,OAAO;CAGhC"}

package/dist/confluent/tools/handlers/flink/catalog/list-databases-handler.js

@@ -0,0 +1,81 @@
+import { getEnsuredParam } from "../../../../../confluent/helpers.js";
+import { BaseToolHandler, } from "../../../../../confluent/tools/base-tools.js";
+import { resolveCatalogName } from "../../../../../confluent/tools/handlers/flink/catalog/catalog-resolver.js";
+import { executeFlinkSql } from "../../../../../confluent/tools/handlers/flink/flink-sql-helper.js";
+import { ToolName } from "../../../../../confluent/tools/tool-name.js";
+import env from "../../../../../env.js";
+import { z } from "zod";
+const listDatabasesArguments = z.object({
+    baseUrl: z
+        .string()
+        .describe("The base URL of the Flink REST API.")
+        .url()
+        .default(() => env.FLINK_REST_ENDPOINT ?? "")
+        .optional(),
+    organizationId: z
+        .string()
+        .trim()
+        .optional()
+        .describe("The unique identifier for the organization."),
+    environmentId: z
+        .string()
+        .trim()
+        .optional()
+        .describe("The unique identifier for the environment."),
+    computePoolId: z
+        .string()
+        .trim()
+        .optional()
+        .describe("The id associated with the compute pool in context."),
+    catalogName: z
+        .string()
+        .trim()
+        .optional()
+        .describe("The Flink catalog name (environment ID, e.g., env-xxxxx). Omit to use defaults."),
+});
+export class ListDatabasesHandler extends BaseToolHandler {
+    async handle(clientManager, toolArguments) {
+        const { organizationId, environmentId, computePoolId, catalogName, baseUrl, } = listDatabasesArguments.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 compute_pool_id = getEnsuredParam("FLINK_COMPUTE_POOL_ID", "Compute Pool ID is required", computePoolId);
+        // Smart resolution: only accept env-* format, otherwise fall back to FLINK_ENV_ID
+        const catalog_name = resolveCatalogName(catalogName);
+        if (!catalog_name) {
+            return this.createResponse("Catalog name could not be resolved. Set FLINK_ENV_ID or provide a valid environment ID (env-xxxxx).", true);
+        }
+        if (baseUrl !== undefined && baseUrl !== "") {
+            clientManager.setConfluentCloudFlinkEndpoint(baseUrl);
+        }
+        // Build SQL query for INFORMATION_SCHEMA.SCHEMATA
+        // Must fully qualify with catalog and use backticks per Confluent Cloud requirements
+        const sql = `SELECT \`SCHEMA_ID\`, \`SCHEMA_NAME\` FROM \`${catalog_name}\`.\`INFORMATION_SCHEMA\`.\`SCHEMATA\` WHERE \`SCHEMA_NAME\` <> 'INFORMATION_SCHEMA'`;
+        const result = await executeFlinkSql(clientManager, sql, {
+            organizationId: organization_id,
+            environmentId: environment_id,
+            computePoolId: compute_pool_id,
+        });
+        if (!result.success) {
+            return this.createResponse(`Failed to list databases: ${result.error}`, true);
+        }
+        const databases = result.data ?? [];
+        if (databases.length === 0) {
+            return this.createResponse("No databases found.");
+        }
+        return this.createResponse(`Databases:\n${JSON.stringify(databases, null, 2)}`);
+    }
+    getToolConfig() {
+        return {
+            name: ToolName.LIST_FLINK_DATABASES,
+            description: "List all databases (schemas) in a Flink catalog via INFORMATION_SCHEMA.SCHEMATA. Returns catalog and database names.",
+            inputSchema: listDatabasesArguments.shape,
+        };
+    }
+    getRequiredEnvVars() {
+        return ["FLINK_API_KEY", "FLINK_API_SECRET"];
+    }
+    isConfluentCloudOnly() {
+        return true;
+    }
+}
+//# sourceMappingURL=list-databases-handler.js.map

package/dist/confluent/tools/handlers/flink/catalog/list-databases-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-databases-handler.js","sourceRoot":"","sources":["../../../../../../src/confluent/tools/handlers/flink/catalog/list-databases-handler.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAE5D,OAAO,EACL,eAAe,GAEhB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,iEAAiE,CAAC;AACrG,OAAO,EAAE,eAAe,EAAE,MAAM,yDAAyD,CAAC;AAC1F,OAAO,EAAE,QAAQ,EAAE,MAAM,mCAAmC,CAAC;AAE7D,OAAO,GAAG,MAAM,aAAa,CAAC;AAC9B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,QAAQ,CAAC,qCAAqC,CAAC;SAC/C,GAAG,EAAE;SACL,OAAO,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,mBAAmB,IAAI,EAAE,CAAC;SAC5C,QAAQ,EAAE;IACb,cAAc,EAAE,CAAC;SACd,MAAM,EAAE;SACR,IAAI,EAAE;SACN,QAAQ,EAAE;SACV,QAAQ,CAAC,6CAA6C,CAAC;IAC1D,aAAa,EAAE,CAAC;SACb,MAAM,EAAE;SACR,IAAI,EAAE;SACN,QAAQ,EAAE;SACV,QAAQ,CAAC,4CAA4C,CAAC;IACzD,aAAa,EAAE,CAAC;SACb,MAAM,EAAE;SACR,IAAI,EAAE;SACN,QAAQ,EAAE;SACV,QAAQ,CAAC,qDAAqD,CAAC;IAClE,WAAW,EAAE,CAAC;SACX,MAAM,EAAE;SACR,IAAI,EAAE;SACN,QAAQ,EAAE;SACV,QAAQ,CACP,iFAAiF,CAClF;CACJ,CAAC,CAAC;AAEH,MAAM,OAAO,oBAAqB,SAAQ,eAAe;IACvD,KAAK,CAAC,MAAM,CACV,aAA4B,EAC5B,aAAkD;QAElD,MAAM,EACJ,cAAc,EACd,aAAa,EACb,aAAa,EACb,WAAW,EACX,OAAO,GACR,GAAG,sBAAsB,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QAEhD,MAAM,eAAe,GAAG,eAAe,CACrC,cAAc,EACd,6BAA6B,EAC7B,cAAc,CACf,CAAC;QACF,MAAM,cAAc,GAAG,eAAe,CACpC,cAAc,EACd,4BAA4B,EAC5B,aAAa,CACd,CAAC;QACF,MAAM,eAAe,GAAG,eAAe,CACrC,uBAAuB,EACvB,6BAA6B,EAC7B,aAAa,CACd,CAAC;QACF,kFAAkF;QAClF,MAAM,YAAY,GAAG,kBAAkB,CAAC,WAAW,CAAC,CAAC;QACrD,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,OAAO,IAAI,CAAC,cAAc,CACxB,qGAAqG,EACrG,IAAI,CACL,CAAC;QACJ,CAAC;QAED,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,EAAE,EAAE,CAAC;YAC5C,aAAa,CAAC,8BAA8B,CAAC,OAAO,CAAC,CAAC;QACxD,CAAC;QAED,kDAAkD;QAClD,qFAAqF;QACrF,MAAM,GAAG,GAAG,gDAAgD,YAAY,sFAAsF,CAAC;QAE/J,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,aAAa,EAAE,GAAG,EAAE;YACvD,cAAc,EAAE,eAAe;YAC/B,aAAa,EAAE,cAAc;YAC7B,aAAa,EAAE,eAAe;SAC/B,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,OAAO,IAAI,CAAC,cAAc,CACxB,6BAA6B,MAAM,CAAC,KAAK,EAAE,EAC3C,IAAI,CACL,CAAC;QACJ,CAAC;QAED,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QACpC,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3B,OAAO,IAAI,CAAC,cAAc,CAAC,qBAAqB,CAAC,CAAC;QACpD,CAAC;QAED,OAAO,IAAI,CAAC,cAAc,CACxB,eAAe,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CACpD,CAAC;IACJ,CAAC;IAED,aAAa;QACX,OAAO;YACL,IAAI,EAAE,QAAQ,CAAC,oBAAoB;YACnC,WAAW,EACT,sHAAsH;YACxH,WAAW,EAAE,sBAAsB,CAAC,KAAK;SAC1C,CAAC;IACJ,CAAC;IAED,kBAAkB;QAChB,OAAO,CAAC,eAAe,EAAE,kBAAkB,CAAC,CAAC;IAC/C,CAAC;IAED,oBAAoB;QAClB,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/dist/confluent/tools/handlers/flink/catalog/list-tables-handler.d.ts

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

package/dist/confluent/tools/handlers/flink/catalog/list-tables-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-tables-handler.d.ts","sourceRoot":"","sources":["../../../../../../src/confluent/tools/handlers/flink/catalog/list-tables-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;AAI5C,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AA0C5C,qBAAa,iBAAkB,SAAQ,eAAe;IAC9C,MAAM,CACV,aAAa,EAAE,aAAa,EAC5B,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GACjD,OAAO,CAAC,cAAc,CAAC;IAuE1B,aAAa,IAAI,UAAU;IAS3B,kBAAkB,IAAI,MAAM,EAAE;IAI9B,oBAAoB,IAAI,OAAO;CAGhC"}

package/dist/confluent/tools/handlers/flink/catalog/list-tables-handler.js

@@ -0,0 +1,90 @@
+import { getEnsuredParam } from "../../../../../confluent/helpers.js";
+import { BaseToolHandler, } from "../../../../../confluent/tools/base-tools.js";
+import { resolveCatalogName } from "../../../../../confluent/tools/handlers/flink/catalog/catalog-resolver.js";
+import { executeFlinkSql } from "../../../../../confluent/tools/handlers/flink/flink-sql-helper.js";
+import { ToolName } from "../../../../../confluent/tools/tool-name.js";
+import env from "../../../../../env.js";
+import { z } from "zod";
+const listTablesArguments = z.object({
+    baseUrl: z
+        .string()
+        .describe("The base URL of the Flink REST API.")
+        .url()
+        .default(() => env.FLINK_REST_ENDPOINT ?? "")
+        .optional(),
+    organizationId: z
+        .string()
+        .trim()
+        .optional()
+        .describe("The unique identifier for the organization."),
+    environmentId: z
+        .string()
+        .trim()
+        .optional()
+        .describe("The unique identifier for the environment."),
+    computePoolId: z
+        .string()
+        .trim()
+        .optional()
+        .describe("The id associated with the compute pool in context."),
+    catalogName: z
+        .string()
+        .trim()
+        .optional()
+        .describe("The Flink catalog name (environment ID, e.g., env-xxxxx). Omit to use defaults."),
+    databaseName: z
+        .string()
+        .trim()
+        .optional()
+        .describe("The database/schema name (Kafka cluster ID, e.g., lkc-xxxxx). Omit to list all tables across the catalog."),
+});
+export class ListTablesHandler extends BaseToolHandler {
+    async handle(clientManager, toolArguments) {
+        const { organizationId, environmentId, computePoolId, catalogName, databaseName, baseUrl, } = listTablesArguments.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 compute_pool_id = getEnsuredParam("FLINK_COMPUTE_POOL_ID", "Compute Pool ID is required", computePoolId);
+        // Smart resolution: only accept env-* format, otherwise fall back to FLINK_ENV_ID
+        const catalog_name = resolveCatalogName(catalogName);
+        if (!catalog_name) {
+            return this.createResponse("Catalog name could not be resolved. Set FLINK_ENV_ID or provide a valid environment ID (env-xxxxx).", true);
+        }
+        // Note: databaseName parameter is currently unused - we fetch all tables and let the client filter
+        // This is because TABLE_SCHEMA may contain friendly names, not cluster IDs
+        void databaseName;
+        if (baseUrl !== undefined && baseUrl !== "") {
+            clientManager.setConfluentCloudFlinkEndpoint(baseUrl);
+        }
+        // Query INFORMATION_SCHEMA.TABLES for all tables
+        // Must fully qualify with catalog and use backticks per Confluent Cloud requirements
+        // Return all tables (excluding INFORMATION_SCHEMA) - client can filter by TABLE_SCHEMA as needed
+        const sql = `SELECT \`TABLE_CATALOG\`, \`TABLE_SCHEMA\`, \`TABLE_NAME\`, \`TABLE_TYPE\` FROM \`${catalog_name}\`.\`INFORMATION_SCHEMA\`.\`TABLES\` WHERE \`TABLE_SCHEMA\` <> 'INFORMATION_SCHEMA'`;
+        const result = await executeFlinkSql(clientManager, sql, {
+            organizationId: organization_id,
+            environmentId: environment_id,
+            computePoolId: compute_pool_id,
+        });
+        if (!result.success) {
+            return this.createResponse(`Failed to list tables: ${result.error}`, true);
+        }
+        const tables = result.data ?? [];
+        if (tables.length === 0) {
+            return this.createResponse(`No tables found in catalog '${catalog_name}'.`);
+        }
+        return this.createResponse(`Tables in catalog '${catalog_name}':\n${JSON.stringify(tables, null, 2)}`);
+    }
+    getToolConfig() {
+        return {
+            name: ToolName.LIST_FLINK_TABLES,
+            description: "List all tables in a Flink database via INFORMATION_SCHEMA.TABLES. Returns table names and types.",
+            inputSchema: listTablesArguments.shape,
+        };
+    }
+    getRequiredEnvVars() {
+        return ["FLINK_API_KEY", "FLINK_API_SECRET"];
+    }
+    isConfluentCloudOnly() {
+        return true;
+    }
+}
+//# sourceMappingURL=list-tables-handler.js.map

package/dist/confluent/tools/handlers/flink/catalog/list-tables-handler.js.map

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

package/dist/confluent/tools/handlers/flink/diagnostics/check-health-handler.d.ts

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

package/dist/confluent/tools/handlers/flink/diagnostics/check-health-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-health-handler.d.ts","sourceRoot":"","sources":["../../../../../../src/confluent/tools/handlers/flink/diagnostics/check-health-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;AA+C5C,qBAAa,kBAAmB,SAAQ,eAAe;IAC/C,MAAM,CACV,aAAa,EAAE,aAAa,EAC5B,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GACjD,OAAO,CAAC,cAAc,CAAC;IAyH1B,aAAa,IAAI,UAAU;IAS3B,kBAAkB,IAAI,MAAM,EAAE;IAI9B,oBAAoB,IAAI,OAAO;CAGhC"}

package/dist/confluent/tools/handlers/flink/diagnostics/check-health-handler.js

@@ -0,0 +1,131 @@
+import { getEnsuredParam } from "../../../../../confluent/helpers.js";
+import { BaseToolHandler, } from "../../../../../confluent/tools/base-tools.js";
+import { ToolName } from "../../../../../confluent/tools/tool-name.js";
+import env from "../../../../../env.js";
+import { wrapAsPathBasedClient } from "openapi-fetch";
+import { z } from "zod";
+const checkHealthArguments = z.object({
+    baseUrl: z
+        .string()
+        .describe("The base URL of the Flink REST API.")
+        .url()
+        .default(() => env.FLINK_REST_ENDPOINT ?? "")
+        .optional(),
+    organizationId: z
+        .string()
+        .trim()
+        .optional()
+        .describe("The unique identifier for the organization."),
+    environmentId: z
+        .string()
+        .trim()
+        .optional()
+        .describe("The unique identifier for the environment."),
+    statementName: z
+        .string()
+        .regex(new RegExp("[a-z0-9]([-a-z0-9]*[a-z0-9])?(\\.[a-z0-9]([-a-z0-9]*[a-z0-9])?)*"))
+        .nonempty()
+        .max(100)
+        .describe("The name of the Flink SQL statement to check health for."),
+});
+export class CheckHealthHandler extends BaseToolHandler {
+    async handle(clientManager, toolArguments) {
+        const { statementName, environmentId, organizationId, baseUrl } = checkHealthArguments.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);
+        if (baseUrl !== undefined && baseUrl !== "") {
+            clientManager.setConfluentCloudFlinkEndpoint(baseUrl);
+        }
+        const pathBasedClient = wrapAsPathBasedClient(clientManager.getConfluentCloudFlinkRestClient());
+        // Get statement status
+        const { data: statementData, error: statusError } = await pathBasedClient["/sql/v1/organizations/{organization_id}/environments/{environment_id}/statements/{statement_name}"].GET({
+            params: {
+                path: {
+                    organization_id: organization_id,
+                    environment_id: environment_id,
+                    statement_name: statementName,
+                },
+            },
+        });
+        if (statusError) {
+            return this.createResponse(`Failed to get statement status: ${JSON.stringify(statusError)}`, true);
+        }
+        // Get exceptions
+        const { data: exceptionsData } = await pathBasedClient["/sql/v1/organizations/{organization_id}/environments/{environment_id}/statements/{statement_name}/exceptions"].GET({
+            params: {
+                path: {
+                    organization_id: organization_id,
+                    environment_id: environment_id,
+                    statement_name: statementName,
+                },
+            },
+        });
+        const phase = statementData?.status?.phase || "UNKNOWN";
+        const exceptions = exceptionsData?.data || [];
+        const latestException = exceptions[0];
+        // Determine health status
+        const health = {
+            status: "unknown",
+            phase,
+            message: "",
+            details: {
+                hasExceptions: exceptions.length > 0,
+                exceptionCount: exceptions.length,
+                latestException: latestException?.message,
+                statementSql: statementData?.spec?.statement,
+                computePoolId: statementData?.spec?.compute_pool_id,
+            },
+        };
+        switch (phase) {
+            case "RUNNING":
+                if (exceptions.length > 0) {
+                    health.status = "warning";
+                    health.message = `Statement is running but has ${exceptions.length} recent exception(s). Latest: ${latestException?.message}`;
+                }
+                else {
+                    health.status = "healthy";
+                    health.message =
+                        "Statement is running normally with no recent exceptions.";
+                }
+                break;
+            case "COMPLETED":
+                health.status = "healthy";
+                health.message = "Statement completed successfully.";
+                break;
+            case "FAILED":
+                health.status = "critical";
+                health.message = `Statement failed. ${statementData?.status?.detail || latestException?.message || "Check exceptions for details."}`;
+                break;
+            case "FAILING":
+                health.status = "critical";
+                health.message = `Statement is failing. ${latestException?.message || "Check exceptions for details."}`;
+                break;
+            case "STOPPED":
+                health.status = "warning";
+                health.message = "Statement has been stopped.";
+                break;
+            case "PENDING":
+                health.status = "warning";
+                health.message = "Statement is pending execution.";
+                break;
+            default:
+                health.status = "unknown";
+                health.message = `Statement is in ${phase} state.`;
+        }
+        return this.createResponse(`Health check for '${statementName}':\n${JSON.stringify(health, null, 2)}`);
+    }
+    getToolConfig() {
+        return {
+            name: ToolName.CHECK_FLINK_STATEMENT_HEALTH,
+            description: "Perform an aggregate health check for a Flink SQL statement. Returns status (healthy/warning/critical), current phase, recent exceptions, and diagnostic details.",
+            inputSchema: checkHealthArguments.shape,
+        };
+    }
+    getRequiredEnvVars() {
+        return ["FLINK_API_KEY", "FLINK_API_SECRET"];
+    }
+    isConfluentCloudOnly() {
+        return true;
+    }
+}
+//# sourceMappingURL=check-health-handler.js.map

package/dist/confluent/tools/handlers/flink/diagnostics/check-health-handler.js.map

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

package/dist/confluent/tools/handlers/flink/diagnostics/detect-issues-handler.d.ts

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

package/dist/confluent/tools/handlers/flink/diagnostics/detect-issues-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect-issues-handler.d.ts","sourceRoot":"","sources":["../../../../../../src/confluent/tools/handlers/flink/diagnostics/detect-issues-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;AAM5C,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAoD5C,qBAAa,mBAAoB,SAAQ,eAAe;IAChD,MAAM,CACV,aAAa,EAAE,aAAa,EAC5B,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GACjD,OAAO,CAAC,cAAc,CAAC;IAyQ1B,aAAa,IAAI,UAAU;IAS3B,kBAAkB,IAAI,MAAM,EAAE;IAI9B,oBAAoB,IAAI,OAAO;CAGhC"}