@confluentinc/mcp-confluent 1.0.6 → 1.2.0

package/dist/confluent/tools/handlers/billing/list-billing-costs-handler.js

@@ -0,0 +1,174 @@
+import { BaseToolHandler, } from "../../../../confluent/tools/base-tools.js";
+import { ToolName } from "../../../../confluent/tools/tool-name.js";
+import env from "../../../../env.js";
+import { logger } from "../../../../logger.js";
+import { wrapAsPathBasedClient } from "openapi-fetch";
+import { z } from "zod";
+const listBillingCostsArguments = z.object({
+    baseUrl: z
+        .string()
+        .describe("The base URL of the Confluent Cloud REST API.")
+        .url()
+        .default(() => env.CONFLUENT_CLOUD_REST_ENDPOINT ?? "")
+        .optional(),
+    startDate: z
+        .string()
+        .regex(/^\d{4}-\d{2}-\d{2}$/, "Date must be in YYYY-MM-DD format")
+        .describe("Start date for billing costs in YYYY-MM-DD format"),
+    endDate: z
+        .string()
+        .regex(/^\d{4}-\d{2}-\d{2}$/, "Date must be in YYYY-MM-DD format")
+        .describe("End date for billing costs in YYYY-MM-DD format"),
+    pageSize: z
+        .number()
+        .int()
+        .positive()
+        .max(1000)
+        .optional()
+        .describe("Number of results per page (max 1000)"),
+    pageToken: z
+        .string()
+        .optional()
+        .describe("Token for the next page of results"),
+});
+/**
+ * Schema for validating billing cost line items
+ */
+const costLineItemSchema = z.object({
+    start_date: z.string(),
+    end_date: z.string(),
+    product: z.string(),
+    type: z.string().optional(),
+    price: z.number().optional(),
+    unit: z.string().optional(),
+    quantity: z.number().optional(),
+    original_amount: z.number(),
+    discount_amount: z.number().optional(),
+    amount: z.number(),
+    network_access_type: z.string().optional(),
+});
+/**
+ * Schema for validating Confluent Cloud billing costs responses
+ */
+const billingCostsSchema = z.object({
+    api_version: z.literal("v1"),
+    kind: z.literal("CostList"),
+    metadata: z
+        .object({
+        first: z.string().optional(),
+        last: z.string().optional(),
+        prev: z.string().optional(),
+        next: z.string().optional(),
+        total_size: z.number().optional(),
+    })
+        .optional(),
+    data: z.array(costLineItemSchema),
+});
+export class ListBillingCostsHandler extends BaseToolHandler {
+    async handle(clientManager, toolArguments) {
+        const { baseUrl, startDate, endDate, pageSize, pageToken } = listBillingCostsArguments.parse(toolArguments);
+        try {
+            if (baseUrl !== undefined && baseUrl !== "") {
+                clientManager.setConfluentCloudRestEndpoint(baseUrl);
+            }
+            const pathBasedClient = wrapAsPathBasedClient(clientManager.getConfluentCloudRestClient());
+            const { data: response, error } = await pathBasedClient["/billing/v1/costs"].GET({
+                params: {
+                    query: {
+                        start_date: startDate,
+                        end_date: endDate,
+                        page_size: pageSize,
+                        page_token: pageToken,
+                    },
+                },
+            });
+            if (error) {
+                logger.error({ error }, "API Error");
+                return this.createResponse(`Failed to fetch billing costs: ${JSON.stringify(error)}`, true, { error });
+            }
+            try {
+                const validatedResponse = billingCostsSchema.parse(response);
+                // Calculate totals and group by product
+                const productCosts = new Map();
+                let totalAmount = 0;
+                let totalOriginalAmount = 0;
+                let totalDiscountAmount = 0;
+                validatedResponse.data.forEach((item) => {
+                    totalAmount += item.amount;
+                    totalOriginalAmount += item.original_amount;
+                    totalDiscountAmount += item.discount_amount || 0;
+                    const currentProductCost = productCosts.get(item.product) || 0;
+                    productCosts.set(item.product, currentProductCost + item.amount);
+                });
+                // Format cost details for display
+                const costSummary = `
+Cost Summary (${startDate} to ${endDate}):
+  Total Amount: $${totalAmount.toFixed(2)}
+  Original Amount: $${totalOriginalAmount.toFixed(2)}
+  Total Discount: $${totalDiscountAmount.toFixed(2)}
+  Total Line Items: ${validatedResponse.data.length}
+`;
+                const productBreakdown = productCosts.size > 0
+                    ? `
+Product Breakdown:
+${Array.from(productCosts.entries())
+                        .sort((a, b) => b[1] - a[1])
+                        .map(([product, amount]) => `  ${product}: $${amount.toFixed(2)}`)
+                        .join("\n")}
+`
+                    : "";
+                const metadata = validatedResponse.metadata;
+                const paginationInfo = metadata
+                    ? `
+Pagination:${metadata.total_size ? `\n  Total Items: ${metadata.total_size}` : ""}${metadata.first ? `\n  First Page: ${metadata.first}` : ""}${metadata.last ? `\n  Last Page: ${metadata.last}` : ""}${metadata.prev ? `\n  Previous Page: ${metadata.prev}` : ""}${metadata.next ? `\n  Next Page: ${metadata.next}` : ""}
+`
+                    : "";
+                return this.createResponse(`Successfully retrieved billing costs:\n${costSummary}${productBreakdown}${paginationInfo}`, false, {
+                    costs: validatedResponse.data,
+                    summary: {
+                        total_amount: totalAmount,
+                        original_amount: totalOriginalAmount,
+                        discount_amount: totalDiscountAmount,
+                        line_item_count: validatedResponse.data.length,
+                        date_range: {
+                            start: startDate,
+                            end: endDate,
+                        },
+                    },
+                    product_breakdown: Object.fromEntries(productCosts),
+                    total: metadata?.total_size,
+                    pagination: metadata
+                        ? {
+                            first: metadata.first,
+                            last: metadata.last,
+                            prev: metadata.prev,
+                            next: metadata.next,
+                        }
+                        : undefined,
+                });
+            }
+            catch (validationError) {
+                logger.error({ error: validationError }, "Billing costs validation error");
+                return this.createResponse(`Invalid billing costs data: ${validationError instanceof Error ? validationError.message : String(validationError)}`, true, { error: validationError });
+            }
+        }
+        catch (error) {
+            logger.error({ error }, "Error in ListBillingCostsHandler");
+            return this.createResponse(`Failed to fetch billing costs: ${error instanceof Error ? error.message : String(error)}`, true, { error: error instanceof Error ? error.message : String(error) });
+        }
+    }
+    getToolConfig() {
+        return {
+            name: ToolName.LIST_BILLING_COSTS,
+            description: "Retrieve billing cost data for a Confluent Cloud organization within a specified date range with pagination support",
+            inputSchema: listBillingCostsArguments.shape,
+        };
+    }
+    getRequiredEnvVars() {
+        return ["CONFLUENT_CLOUD_API_KEY", "CONFLUENT_CLOUD_API_SECRET"];
+    }
+    isConfluentCloudOnly() {
+        return true;
+    }
+}
+//# sourceMappingURL=list-billing-costs-handler.js.map

package/dist/confluent/tools/handlers/billing/list-billing-costs-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-billing-costs-handler.js","sourceRoot":"","sources":["../../../../../src/confluent/tools/handlers/billing/list-billing-costs-handler.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,eAAe,GAEhB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,mCAAmC,CAAC;AAE7D,OAAO,GAAG,MAAM,aAAa,CAAC;AAC9B,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACxC,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,QAAQ,CAAC,+CAA+C,CAAC;SACzD,GAAG,EAAE;SACL,OAAO,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,6BAA6B,IAAI,EAAE,CAAC;SACtD,QAAQ,EAAE;IACb,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,KAAK,CAAC,qBAAqB,EAAE,mCAAmC,CAAC;SACjE,QAAQ,CAAC,mDAAmD,CAAC;IAChE,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,KAAK,CAAC,qBAAqB,EAAE,mCAAmC,CAAC;SACjE,QAAQ,CAAC,iDAAiD,CAAC;IAC9D,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,GAAG,EAAE;SACL,QAAQ,EAAE;SACV,GAAG,CAAC,IAAI,CAAC;SACT,QAAQ,EAAE;SACV,QAAQ,CAAC,uCAAuC,CAAC;IACpD,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,oCAAoC,CAAC;CAClD,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IACtB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE;IAC3B,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACtC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,mBAAmB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC3C,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;IAC5B,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC;IAC3B,QAAQ,EAAE,CAAC;SACR,MAAM,CAAC;QACN,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC5B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC3B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC3B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC3B,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KAClC,CAAC;SACD,QAAQ,EAAE;IACb,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,kBAAkB,CAAC;CAClC,CAAC,CAAC;AAIH,MAAM,OAAO,uBAAwB,SAAQ,eAAe;IAC1D,KAAK,CAAC,MAAM,CACV,aAA4B,EAC5B,aAAsC;QAEtC,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,GACxD,yBAAyB,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QAEjD,IAAI,CAAC;YACH,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,EAAE,EAAE,CAAC;gBAC5C,aAAa,CAAC,6BAA6B,CAAC,OAAO,CAAC,CAAC;YACvD,CAAC;YAED,MAAM,eAAe,GAAG,qBAAqB,CAC3C,aAAa,CAAC,2BAA2B,EAAE,CAC5C,CAAC;YAEF,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,MAAM,eAAe,CACrD,mBAAmB,CACpB,CAAC,GAAG,CAAC;gBACJ,MAAM,EAAE;oBACN,KAAK,EAAE;wBACL,UAAU,EAAE,SAAS;wBACrB,QAAQ,EAAE,OAAO;wBACjB,SAAS,EAAE,QAAQ;wBACnB,UAAU,EAAE,SAAS;qBACtB;iBACF;aACF,CAAC,CAAC;YAEH,IAAI,KAAK,EAAE,CAAC;gBACV,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,EAAE,WAAW,CAAC,CAAC;gBACrC,OAAO,IAAI,CAAC,cAAc,CACxB,kCAAkC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,EACzD,IAAI,EACJ,EAAE,KAAK,EAAE,CACV,CAAC;YACJ,CAAC;YAED,IAAI,CAAC;gBACH,MAAM,iBAAiB,GAAG,kBAAkB,CAAC,KAAK,CAChD,QAAQ,CACW,CAAC;gBAEtB,wCAAwC;gBACxC,MAAM,YAAY,GAAG,IAAI,GAAG,EAAkB,CAAC;gBAC/C,IAAI,WAAW,GAAG,CAAC,CAAC;gBACpB,IAAI,mBAAmB,GAAG,CAAC,CAAC;gBAC5B,IAAI,mBAAmB,GAAG,CAAC,CAAC;gBAE5B,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;oBACtC,WAAW,IAAI,IAAI,CAAC,MAAM,CAAC;oBAC3B,mBAAmB,IAAI,IAAI,CAAC,eAAe,CAAC;oBAC5C,mBAAmB,IAAI,IAAI,CAAC,eAAe,IAAI,CAAC,CAAC;oBAEjD,MAAM,kBAAkB,GAAG,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;oBAC/D,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;gBACnE,CAAC,CAAC,CAAC;gBAEH,kCAAkC;gBAClC,MAAM,WAAW,GAAG;gBACZ,SAAS,OAAO,OAAO;mBACpB,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC;sBACnB,mBAAmB,CAAC,OAAO,CAAC,CAAC,CAAC;qBAC/B,mBAAmB,CAAC,OAAO,CAAC,CAAC,CAAC;sBAC7B,iBAAiB,CAAC,IAAI,CAAC,MAAM;CAClD,CAAC;gBAEM,MAAM,gBAAgB,GACpB,YAAY,CAAC,IAAI,GAAG,CAAC;oBACnB,CAAC,CAAC;;EAEZ,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC;yBACjC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;yBAC3B,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,KAAK,OAAO,MAAM,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;yBACjE,IAAI,CAAC,IAAI,CAAC;CACZ;oBACW,CAAC,CAAC,EAAE,CAAC;gBAET,MAAM,QAAQ,GAAG,iBAAiB,CAAC,QAAQ,CAAC;gBAC5C,MAAM,cAAc,GAAG,QAAQ;oBAC7B,CAAC,CAAC;aACC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,oBAAoB,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,mBAAmB,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,kBAAkB,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,sBAAsB,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,kBAAkB,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE;CAC3T;oBACS,CAAC,CAAC,EAAE,CAAC;gBAEP,OAAO,IAAI,CAAC,cAAc,CACxB,0CAA0C,WAAW,GAAG,gBAAgB,GAAG,cAAc,EAAE,EAC3F,KAAK,EACL;oBACE,KAAK,EAAE,iBAAiB,CAAC,IAAI;oBAC7B,OAAO,EAAE;wBACP,YAAY,EAAE,WAAW;wBACzB,eAAe,EAAE,mBAAmB;wBACpC,eAAe,EAAE,mBAAmB;wBACpC,eAAe,EAAE,iBAAiB,CAAC,IAAI,CAAC,MAAM;wBAC9C,UAAU,EAAE;4BACV,KAAK,EAAE,SAAS;4BAChB,GAAG,EAAE,OAAO;yBACb;qBACF;oBACD,iBAAiB,EAAE,MAAM,CAAC,WAAW,CAAC,YAAY,CAAC;oBACnD,KAAK,EAAE,QAAQ,EAAE,UAAU;oBAC3B,UAAU,EAAE,QAAQ;wBAClB,CAAC,CAAC;4BACE,KAAK,EAAE,QAAQ,CAAC,KAAK;4BACrB,IAAI,EAAE,QAAQ,CAAC,IAAI;4BACnB,IAAI,EAAE,QAAQ,CAAC,IAAI;4BACnB,IAAI,EAAE,QAAQ,CAAC,IAAI;yBACpB;wBACH,CAAC,CAAC,SAAS;iBACd,CACF,CAAC;YACJ,CAAC;YAAC,OAAO,eAAe,EAAE,CAAC;gBACzB,MAAM,CAAC,KAAK,CACV,EAAE,KAAK,EAAE,eAAe,EAAE,EAC1B,gCAAgC,CACjC,CAAC;gBACF,OAAO,IAAI,CAAC,cAAc,CACxB,+BAA+B,eAAe,YAAY,KAAK,CAAC,CAAC,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,eAAe,CAAC,EAAE,EACrH,IAAI,EACJ,EAAE,KAAK,EAAE,eAAe,EAAE,CAC3B,CAAC;YACJ,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,EAAE,kCAAkC,CAAC,CAAC;YAC5D,OAAO,IAAI,CAAC,cAAc,CACxB,kCAAkC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAC1F,IAAI,EACJ,EAAE,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAClE,CAAC;QACJ,CAAC;IACH,CAAC;IAED,aAAa;QACX,OAAO;YACL,IAAI,EAAE,QAAQ,CAAC,kBAAkB;YACjC,WAAW,EACT,qHAAqH;YACvH,WAAW,EAAE,yBAAyB,CAAC,KAAK;SAC7C,CAAC;IACJ,CAAC;IAED,kBAAkB;QAChB,OAAO,CAAC,yBAAyB,EAAE,4BAA4B,CAAC,CAAC;IACnE,CAAC;IAED,oBAAoB;QAClB,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

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

@@ -16,17 +16,7 @@ export declare const clusterSchema: z.ZodObject<{
         resource_name: z.ZodString;
         self: z.ZodString;
         updated_at: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
-        created_at: string;
-        resource_name: string;
-        self: string;
-        updated_at: string;
-    }, {
-        created_at: string;
-        resource_name: string;
-        self: string;
-        updated_at: string;
-    }>;
+    }, z.core.$strip>;
     spec: z.ZodObject<{
         api_endpoint: z.ZodString;
         availability: z.ZodString;
@@ -34,147 +24,23 @@ export declare const clusterSchema: z.ZodObject<{
         config: z.ZodObject<{
             cku: z.ZodOptional<z.ZodNumber>;
             kind: z.ZodString;
-            zones: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        }, "strip", z.ZodTypeAny, {
-            kind: string;
-            cku?: number | undefined;
-            zones?: string[] | undefined;
-        }, {
-            kind: string;
-            cku?: number | undefined;
-            zones?: string[] | undefined;
-        }>;
+            zones: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>;
         display_name: z.ZodString;
         environment: z.ZodObject<{
             id: z.ZodString;
             related: z.ZodString;
             resource_name: z.ZodString;
-        }, "strip", z.ZodTypeAny, {
-            id: string;
-            resource_name: string;
-            related: string;
-        }, {
-            id: string;
-            resource_name: string;
-            related: string;
-        }>;
+        }, z.core.$strip>;
         http_endpoint: z.ZodString;
         kafka_bootstrap_endpoint: z.ZodString;
         region: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
-        api_endpoint: string;
-        availability: string;
-        cloud: string;
-        config: {
-            kind: string;
-            cku?: number | undefined;
-            zones?: string[] | undefined;
-        };
-        display_name: string;
-        environment: {
-            id: string;
-            resource_name: string;
-            related: string;
-        };
-        http_endpoint: string;
-        kafka_bootstrap_endpoint: string;
-        region: string;
-    }, {
-        api_endpoint: string;
-        availability: string;
-        cloud: string;
-        config: {
-            kind: string;
-            cku?: number | undefined;
-            zones?: string[] | undefined;
-        };
-        display_name: string;
-        environment: {
-            id: string;
-            resource_name: string;
-            related: string;
-        };
-        http_endpoint: string;
-        kafka_bootstrap_endpoint: string;
-        region: string;
-    }>;
+    }, z.core.$strip>;
     status: z.ZodObject<{
         cku: z.ZodOptional<z.ZodNumber>;
         phase: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
-        phase: string;
-        cku?: number | undefined;
-    }, {
-        phase: string;
-        cku?: number | undefined;
-    }>;
-}, "strip", z.ZodTypeAny, {
-    status: {
-        phase: string;
-        cku?: number | undefined;
-    };
-    api_version: string;
-    id: string;
-    kind: string;
-    metadata: {
-        created_at: string;
-        resource_name: string;
-        self: string;
-        updated_at: string;
-    };
-    spec: {
-        api_endpoint: string;
-        availability: string;
-        cloud: string;
-        config: {
-            kind: string;
-            cku?: number | undefined;
-            zones?: string[] | undefined;
-        };
-        display_name: string;
-        environment: {
-            id: string;
-            resource_name: string;
-            related: string;
-        };
-        http_endpoint: string;
-        kafka_bootstrap_endpoint: string;
-        region: string;
-    };
-}, {
-    status: {
-        phase: string;
-        cku?: number | undefined;
-    };
-    api_version: string;
-    id: string;
-    kind: string;
-    metadata: {
-        created_at: string;
-        resource_name: string;
-        self: string;
-        updated_at: string;
-    };
-    spec: {
-        api_endpoint: string;
-        availability: string;
-        cloud: string;
-        config: {
-            kind: string;
-            cku?: number | undefined;
-            zones?: string[] | undefined;
-        };
-        display_name: string;
-        environment: {
-            id: string;
-            resource_name: string;
-            related: string;
-        };
-        http_endpoint: string;
-        kafka_bootstrap_endpoint: string;
-        region: string;
-    };
-}>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
 export type Cluster = z.infer<typeof clusterSchema>;
 export declare class ListClustersHandler extends BaseToolHandler {
     handle(clientManager: ClientManager, toolArguments: Record<string, unknown> | undefined): Promise<CallToolResult>;

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

@@ -1 +1 @@
-{"version":3,"file":"list-clusters-handler.d.ts","sourceRoot":"","sources":["../../../../../src/confluent/tools/handlers/clusters/list-clusters-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACjE,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;AAI5C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAgBxB;;;GAGG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiCxB,CAAC;AAEH,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAEpD,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;IAuH1B,aAAa,IAAI,UAAU;IAQ3B,kBAAkB,IAAI,MAAM,EAAE;IAI9B,oBAAoB,IAAI,OAAO;CAGhC"}
+{"version":3,"file":"list-clusters-handler.d.ts","sourceRoot":"","sources":["../../../../../src/confluent/tools/handlers/clusters/list-clusters-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACjE,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;AAI5C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAgBxB;;;GAGG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAiCxB,CAAC;AAEH,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAEpD,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;IAuH1B,aAAa,IAAI,UAAU;IAQ3B,kBAAkB,IAAI,MAAM,EAAE;IAI9B,oBAAoB,IAAI,OAAO;CAGhC"}

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

@@ -16,58 +16,12 @@ export declare const environmentSchema: z.ZodObject<{
         deleted_at: z.ZodOptional<z.ZodString>;
         resource_name: z.ZodString;
         self: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
-        created_at: string;
-        resource_name: string;
-        self: string;
-        updated_at: string;
-        deleted_at?: string | undefined;
-    }, {
-        created_at: string;
-        resource_name: string;
-        self: string;
-        updated_at: string;
-        deleted_at?: string | undefined;
-    }>;
+    }, z.core.$strip>;
     display_name: z.ZodString;
     stream_governance_config: z.ZodOptional<z.ZodObject<{
         package: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
-        package: string;
-    }, {
-        package: string;
-    }>>;
-}, "strip", z.ZodTypeAny, {
-    api_version: "org/v2";
-    id: string;
-    kind: "Environment";
-    metadata: {
-        created_at: string;
-        resource_name: string;
-        self: string;
-        updated_at: string;
-        deleted_at?: string | undefined;
-    };
-    display_name: string;
-    stream_governance_config?: {
-        package: string;
-    } | undefined;
-}, {
-    api_version: "org/v2";
-    id: string;
-    kind: "Environment";
-    metadata: {
-        created_at: string;
-        resource_name: string;
-        self: string;
-        updated_at: string;
-        deleted_at?: string | undefined;
-    };
-    display_name: string;
-    stream_governance_config?: {
-        package: string;
-    } | undefined;
-}>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
 export declare const environmentListSchema: z.ZodObject<{
     api_version: z.ZodLiteral<"org/v2">;
     kind: z.ZodLiteral<"EnvironmentList">;
@@ -77,19 +31,7 @@ export declare const environmentListSchema: z.ZodObject<{
         prev: z.ZodOptional<z.ZodString>;
         next: z.ZodOptional<z.ZodString>;
         total_size: z.ZodOptional<z.ZodNumber>;
-    }, "strip", z.ZodTypeAny, {
-        first?: string | undefined;
-        last?: string | undefined;
-        prev?: string | undefined;
-        next?: string | undefined;
-        total_size?: number | undefined;
-    }, {
-        first?: string | undefined;
-        last?: string | undefined;
-        prev?: string | undefined;
-        next?: string | undefined;
-        total_size?: number | undefined;
-    }>>;
+    }, z.core.$strip>>;
     data: z.ZodArray<z.ZodObject<{
         api_version: z.ZodLiteral<"org/v2">;
         kind: z.ZodLiteral<"Environment">;
@@ -100,111 +42,13 @@ export declare const environmentListSchema: z.ZodObject<{
             deleted_at: z.ZodOptional<z.ZodString>;
             resource_name: z.ZodString;
             self: z.ZodString;
-        }, "strip", z.ZodTypeAny, {
-            created_at: string;
-            resource_name: string;
-            self: string;
-            updated_at: string;
-            deleted_at?: string | undefined;
-        }, {
-            created_at: string;
-            resource_name: string;
-            self: string;
-            updated_at: string;
-            deleted_at?: string | undefined;
-        }>;
+        }, z.core.$strip>;
         display_name: z.ZodString;
         stream_governance_config: z.ZodOptional<z.ZodObject<{
             package: z.ZodString;
-        }, "strip", z.ZodTypeAny, {
-            package: string;
-        }, {
-            package: string;
-        }>>;
-    }, "strip", z.ZodTypeAny, {
-        api_version: "org/v2";
-        id: string;
-        kind: "Environment";
-        metadata: {
-            created_at: string;
-            resource_name: string;
-            self: string;
-            updated_at: string;
-            deleted_at?: string | undefined;
-        };
-        display_name: string;
-        stream_governance_config?: {
-            package: string;
-        } | undefined;
-    }, {
-        api_version: "org/v2";
-        id: string;
-        kind: "Environment";
-        metadata: {
-            created_at: string;
-            resource_name: string;
-            self: string;
-            updated_at: string;
-            deleted_at?: string | undefined;
-        };
-        display_name: string;
-        stream_governance_config?: {
-            package: string;
-        } | undefined;
-    }>, "many">;
-}, "strip", z.ZodTypeAny, {
-    data: {
-        api_version: "org/v2";
-        id: string;
-        kind: "Environment";
-        metadata: {
-            created_at: string;
-            resource_name: string;
-            self: string;
-            updated_at: string;
-            deleted_at?: string | undefined;
-        };
-        display_name: string;
-        stream_governance_config?: {
-            package: string;
-        } | undefined;
-    }[];
-    api_version: "org/v2";
-    kind: "EnvironmentList";
-    metadata?: {
-        first?: string | undefined;
-        last?: string | undefined;
-        prev?: string | undefined;
-        next?: string | undefined;
-        total_size?: number | undefined;
-    } | undefined;
-}, {
-    data: {
-        api_version: "org/v2";
-        id: string;
-        kind: "Environment";
-        metadata: {
-            created_at: string;
-            resource_name: string;
-            self: string;
-            updated_at: string;
-            deleted_at?: string | undefined;
-        };
-        display_name: string;
-        stream_governance_config?: {
-            package: string;
-        } | undefined;
-    }[];
-    api_version: "org/v2";
-    kind: "EnvironmentList";
-    metadata?: {
-        first?: string | undefined;
-        last?: string | undefined;
-        prev?: string | undefined;
-        next?: string | undefined;
-        total_size?: number | undefined;
-    } | undefined;
-}>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
 export type Environment = z.infer<typeof environmentSchema>;
 export type EnvironmentList = z.infer<typeof environmentListSchema>;
 export declare class ListEnvironmentsHandler extends BaseToolHandler {

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

@@ -1 +1 @@
-{"version":3,"file":"list-environments-handler.d.ts","sourceRoot":"","sources":["../../../../../src/confluent/tools/handlers/environments/list-environments-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACjE,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;AAI5C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAexB;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiB5B,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAahC,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC5D,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,qBAAa,uBAAwB,SAAQ,eAAe;IACpD,MAAM,CACV,aAAa,EAAE,aAAa,EAC5B,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACrC,OAAO,CAAC,cAAc,CAAC;IAuG1B,aAAa,IAAI,UAAU;IAS3B,kBAAkB,IAAI,MAAM,EAAE;IAI9B,oBAAoB,IAAI,OAAO;CAGhC"}
+{"version":3,"file":"list-environments-handler.d.ts","sourceRoot":"","sources":["../../../../../src/confluent/tools/handlers/environments/list-environments-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACjE,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;AAI5C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAexB;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;iBAiB5B,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;iBAahC,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC5D,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,qBAAa,uBAAwB,SAAQ,eAAe;IACpD,MAAM,CACV,aAAa,EAAE,aAAa,EAC5B,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACrC,OAAO,CAAC,cAAc,CAAC;IAuG1B,aAAa,IAAI,UAAU;IAS3B,kBAAkB,IAAI,MAAM,EAAE;IAI9B,oBAAoB,IAAI,OAAO;CAGhC"}

package/dist/confluent/tools/handlers/flink/catalog/catalog-resolver.d.ts

@@ -0,0 +1,77 @@
+import { ClientManager } from "../../../../../confluent/client-manager.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 declare function resolveCatalogName(catalogName?: string): string | undefined;
+/**
+ * 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 declare function resolveDatabaseName(databaseName?: string): string | undefined;
+export interface CatalogMapping {
+    catalogId: string;
+    catalogName: string;
+}
+export interface SchemaMapping {
+    schemaId: string;
+    schemaName: string;
+}
+/**
+ * Looks up catalog mappings from INFORMATION_SCHEMA.CATALOGS.
+ * Returns a 1:1 mapping between environment IDs (CATALOG_ID) and friendly names (CATALOG_NAME).
+ */
+export declare function getCatalogMapping(clientManager: ClientManager, catalogName: string, options: {
+    organizationId: string;
+    environmentId: string;
+    computePoolId: string;
+}): Promise<CatalogMapping[]>;
+/**
+ * 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 declare function resolveToCatalogName(catalogInput: string, mappings: CatalogMapping[]): string;
+/**
+ * Looks up schema mappings from INFORMATION_SCHEMA.SCHEMATA.
+ * Returns a 1:1 mapping between cluster IDs (SCHEMA_ID) and friendly names (SCHEMA_NAME).
+ */
+export declare function getSchemaMapping(clientManager: ClientManager, catalogName: string, options: {
+    organizationId: string;
+    environmentId: string;
+    computePoolId: string;
+}): Promise<SchemaMapping[]>;
+/**
+ * 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 declare function resolveToSchemaName(databaseInput: string, mappings: SchemaMapping[]): string;
+//# sourceMappingURL=catalog-resolver.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-resolver.d.ts","sourceRoot":"","sources":["../../../../../../src/confluent/tools/handlers/flink/catalog/catalog-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAIjE;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAQ3E;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,mBAAmB,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAQ7E;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,aAAa,EAAE,aAAa,EAC5B,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE;IACP,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;CACvB,GACA,OAAO,CAAC,cAAc,EAAE,CAAC,CAuB3B;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,cAAc,EAAE,GACzB,MAAM,CAWR;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,aAAa,EAAE,aAAa,EAC5B,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE;IACP,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;CACvB,GACA,OAAO,CAAC,aAAa,EAAE,CAAC,CAuB1B;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,aAAa,EAAE,GACxB,MAAM,CAWR"}