@confluentinc/mcp-confluent 1.0.6 → 1.2.0

package/dist/confluent/tools/handlers/flink/catalog/catalog-resolver.js

@@ -0,0 +1,136 @@
+import { executeFlinkSql } from "../../../../../confluent/tools/handlers/flink/flink-sql-helper.js";
+import env from "../../../../../env.js";
+/**
+ * Resolves the Flink catalog name from various inputs.
+ *
+ * In Confluent Cloud Flink, the catalog name is always the environment ID (env-xxxxx).
+ * This function handles cases where a friendly name or invalid value is provided,
+ * falling back to the environment ID from config.
+ *
+ * Resolution order:
+ * 1. If catalogName is provided and looks like an env ID (starts with "env-"), use it
+ * 2. Otherwise, use FLINK_ENV_ID from environment
+ *
+ * @param catalogName - Optional catalog name from user/LLM input
+ * @returns The resolved catalog name (environment ID), or undefined if not resolvable
+ */
+export function resolveCatalogName(catalogName) {
+    // If provided value looks like an environment ID, use it
+    if (catalogName && catalogName.startsWith("env-")) {
+        return catalogName;
+    }
+    // Fall back to FLINK_ENV_ID (the actual environment ID)
+    return env.FLINK_ENV_ID;
+}
+/**
+ * Resolves the Flink database name from various inputs.
+ *
+ * In Confluent Cloud Flink, the database name can be either:
+ * - A Kafka cluster ID (lkc-xxxxx)
+ * - A friendly database name (e.g., "standard_cluster")
+ *
+ * INFORMATION_SCHEMA.TABLES uses friendly names in TABLE_SCHEMA, not cluster IDs.
+ *
+ * Resolution order:
+ * 1. If databaseName is provided and non-empty, use it (could be cluster ID or friendly name)
+ * 2. Otherwise, use KAFKA_CLUSTER_ID from environment
+ *
+ * @param databaseName - Optional database name from user/LLM input
+ * @returns The resolved database name, or undefined if not resolvable
+ */
+export function resolveDatabaseName(databaseName) {
+    // If any non-empty value is provided, use it (could be lkc-* or friendly name)
+    if (databaseName && databaseName.trim()) {
+        return databaseName.trim();
+    }
+    // Fall back to KAFKA_CLUSTER_ID
+    return env.KAFKA_CLUSTER_ID;
+}
+/**
+ * Looks up catalog mappings from INFORMATION_SCHEMA.CATALOGS.
+ * Returns a 1:1 mapping between environment IDs (CATALOG_ID) and friendly names (CATALOG_NAME).
+ */
+export async function getCatalogMapping(clientManager, catalogName, options) {
+    const sql = `SELECT \`CATALOG_ID\`, \`CATALOG_NAME\` FROM \`${catalogName}\`.\`INFORMATION_SCHEMA\`.\`CATALOGS\``;
+    const result = await executeFlinkSql(clientManager, sql, {
+        organizationId: options.organizationId,
+        environmentId: options.environmentId,
+        computePoolId: options.computePoolId,
+    });
+    if (!result.success || !result.data) {
+        return [];
+    }
+    const mappings = [];
+    for (const row of result.data) {
+        const r = row;
+        const catalogId = r?.CATALOG_ID;
+        const catalogNameValue = r?.CATALOG_NAME;
+        if (typeof catalogId === "string" && typeof catalogNameValue === "string") {
+            mappings.push({ catalogId, catalogName: catalogNameValue });
+        }
+    }
+    return mappings;
+}
+/**
+ * Resolves a catalog identifier (could be env ID or friendly name) to the friendly CATALOG_NAME.
+ *
+ * @param catalogInput - The catalog identifier (env-xxxxx or friendly name)
+ * @param mappings - The catalog mappings from getCatalogMapping()
+ * @returns The friendly CATALOG_NAME to use in queries, or the original input if no mapping found
+ */
+export function resolveToCatalogName(catalogInput, mappings) {
+    // If it looks like an environment ID, look up the friendly name
+    if (catalogInput.startsWith("env-")) {
+        const mapping = mappings.find((m) => m.catalogId === catalogInput);
+        if (mapping) {
+            return mapping.catalogName;
+        }
+    }
+    // Otherwise, assume it's already a friendly name or return as-is
+    return catalogInput;
+}
+/**
+ * Looks up schema mappings from INFORMATION_SCHEMA.SCHEMATA.
+ * Returns a 1:1 mapping between cluster IDs (SCHEMA_ID) and friendly names (SCHEMA_NAME).
+ */
+export async function getSchemaMapping(clientManager, catalogName, options) {
+    const sql = `SELECT \`SCHEMA_ID\`, \`SCHEMA_NAME\` FROM \`${catalogName}\`.\`INFORMATION_SCHEMA\`.\`SCHEMATA\` WHERE \`SCHEMA_NAME\` <> 'INFORMATION_SCHEMA'`;
+    const result = await executeFlinkSql(clientManager, sql, {
+        organizationId: options.organizationId,
+        environmentId: options.environmentId,
+        computePoolId: options.computePoolId,
+    });
+    if (!result.success || !result.data) {
+        return [];
+    }
+    const mappings = [];
+    for (const row of result.data) {
+        const r = row;
+        const schemaId = r?.SCHEMA_ID;
+        const schemaName = r?.SCHEMA_NAME;
+        if (typeof schemaId === "string" && typeof schemaName === "string") {
+            mappings.push({ schemaId, schemaName });
+        }
+    }
+    return mappings;
+}
+/**
+ * Resolves a database identifier (could be cluster ID or friendly name) to the friendly SCHEMA_NAME.
+ * INFORMATION_SCHEMA queries use SCHEMA_NAME (friendly name) in TABLE_SCHEMA, not SCHEMA_ID.
+ *
+ * @param databaseInput - The database identifier (lkc-xxxxx or friendly name)
+ * @param mappings - The schema mappings from getSchemaMapping()
+ * @returns The friendly SCHEMA_NAME to use in queries, or the original input if no mapping found
+ */
+export function resolveToSchemaName(databaseInput, mappings) {
+    // If it looks like a cluster ID, look up the friendly name
+    if (databaseInput.startsWith("lkc-")) {
+        const mapping = mappings.find((m) => m.schemaId === databaseInput);
+        if (mapping) {
+            return mapping.schemaName;
+        }
+    }
+    // Otherwise, assume it's already a friendly name or return as-is
+    return databaseInput;
+}
+//# sourceMappingURL=catalog-resolver.js.map

package/dist/confluent/tools/handlers/flink/catalog/catalog-resolver.js.map

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

package/dist/confluent/tools/handlers/flink/catalog/describe-table-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 DescribeTableHandler extends BaseToolHandler {
+    handle(clientManager: ClientManager, toolArguments: Record<string, unknown> | undefined): Promise<CallToolResult>;
+    getToolConfig(): ToolConfig;
+    getRequiredEnvVars(): EnvVar[];
+    isConfluentCloudOnly(): boolean;
+}
+//# sourceMappingURL=describe-table-handler.d.ts.map

package/dist/confluent/tools/handlers/flink/catalog/describe-table-handler.d.ts.map

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

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

@@ -0,0 +1,111 @@
+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 describeTableArguments = 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 describe."),
+});
+export class DescribeTableHandler extends BaseToolHandler {
+    async handle(clientManager, toolArguments) {
+        const { organizationId, environmentId, computePoolId, catalogName, databaseName, tableName, baseUrl, } = describeTableArguments.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.COLUMNS for full schema details
+        // 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_SCHEMA\`, \`COLUMN_NAME\`, \`ORDINAL_POSITION\`, \`DATA_TYPE\`, \`FULL_DATA_TYPE\`, \`IS_NULLABLE\`, \`IS_HIDDEN\`, \`IS_GENERATED\`, \`GENERATION_EXPRESSION\`, \`IS_METADATA\`, \`METADATA_KEY\` FROM \`${catalog_name}\`.\`INFORMATION_SCHEMA\`.\`COLUMNS\` WHERE \`TABLE_NAME\` = '${tableName}' AND \`IS_HIDDEN\` = 'NO'${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 describe table: ${result.error}`, true);
+        }
+        const columns = result.data ?? [];
+        if (columns.length === 0) {
+            const scope = schema_name
+                ? `'${catalog_name}.${schema_name}.${tableName}'`
+                : `'${tableName}' in catalog '${catalog_name}'`;
+            return this.createResponse(`Table ${scope} not found or has no columns.`, true);
+        }
+        // Include TABLE_SCHEMA in response so user knows which database the table is in
+        return this.createResponse(`Table '${tableName}' schema:\n${JSON.stringify(columns, null, 2)}`);
+    }
+    getToolConfig() {
+        return {
+            name: ToolName.DESCRIBE_FLINK_TABLE,
+            description: "Get full schema details for a Flink table via INFORMATION_SCHEMA.COLUMNS. Returns column names, data types (including $rowtime), nullability, and metadata column info.",
+            inputSchema: describeTableArguments.shape,
+        };
+    }
+    getRequiredEnvVars() {
+        return ["FLINK_API_KEY", "FLINK_API_SECRET"];
+    }
+    isConfluentCloudOnly() {
+        return true;
+    }
+}
+//# sourceMappingURL=describe-table-handler.js.map

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

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

package/dist/confluent/tools/handlers/flink/catalog/get-table-info-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 GetTableInfoHandler extends BaseToolHandler {
+    handle(clientManager: ClientManager, toolArguments: Record<string, unknown> | undefined): Promise<CallToolResult>;
+    getToolConfig(): ToolConfig;
+    getRequiredEnvVars(): EnvVar[];
+    isConfluentCloudOnly(): boolean;
+}
+//# sourceMappingURL=get-table-info-handler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-table-info-handler.d.ts","sourceRoot":"","sources":["../../../../../../src/confluent/tools/handlers/flink/catalog/get-table-info-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;AAS5C,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AA+C5C,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;IAsF1B,aAAa,IAAI,UAAU;IAS3B,kBAAkB,IAAI,MAAM,EAAE;IAI9B,oBAAoB,IAAI,OAAO;CAGhC"}

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":"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"}

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"}