@confluentinc/mcp-confluent 1.2.2 → 1.3.0

package/dist/confluent/tools/handlers/docs/get-product-doc-page-handler.js

@@ -0,0 +1,234 @@
+import { nodeFetch } from "../../../../confluent/node-deps.js";
+import { BaseToolHandler, READ_ONLY, } from "../../../../confluent/tools/base-tools.js";
+import { alwaysEnabled } from "../../../../confluent/tools/connection-predicates.js";
+import { ToolName } from "../../../../confluent/tools/tool-name.js";
+import { logger } from "../../../../logger.js";
+import * as cheerio from "cheerio";
+import TurndownService from "turndown";
+import { z } from "zod";
+const ALLOWED_HOSTS = new Set([
+    "docs.confluent.io",
+    "developer.confluent.io",
+    "support.confluent.io",
+]);
+const USER_AGENT = "mcp-confluent/get-product-doc-page";
+const REQUEST_TIMEOUT_MS = 10_000;
+const getProductDocPageArguments = z.object({
+    url: z
+        .url()
+        .describe("Absolute URL of a page under https://docs.confluent.io/, https://developer.confluent.io/, or https://support.confluent.io/. Prefer URLs returned by search-product-docs."),
+});
+export class GetProductDocPageHandler extends BaseToolHandler {
+    turndown = new TurndownService({
+        headingStyle: "atx",
+        codeBlockStyle: "fenced",
+        bulletListMarker: "-",
+    });
+    async handle(_runtime, toolArguments) {
+        const { url } = getProductDocPageArguments.parse(toolArguments);
+        const parsed = new URL(url);
+        if (parsed.protocol !== "https:" ||
+            !ALLOWED_HOSTS.has(parsed.hostname)) {
+            return this.createResponse(`Hostname '${parsed.hostname}' is not allowed. Only docs.confluent.io, developer.confluent.io, and support.confluent.io are supported.`, true);
+        }
+        try {
+            switch (parsed.hostname) {
+                case "docs.confluent.io":
+                    return await this.fetchFromDocsConfluent(parsed);
+                case "developer.confluent.io":
+                    return await this.fetchFromDeveloperConfluent(parsed);
+                case "support.confluent.io":
+                    return await this.fetchFromSupportZendesk(parsed);
+            }
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            logger.warn({ url, error: message }, "get-product-doc-page fetch failed");
+            return this.createResponse(`Failed to fetch ${url}: ${message}`, true);
+        }
+    }
+    // Sphinx publishes a .md twin at the same path; HTML scrape is the fallback.
+    async fetchFromDocsConfluent(parsed) {
+        const mdResponse = await fetchWithTimeout(toMarkdownTwin(parsed), {
+            headers: { "user-agent": USER_AGENT, accept: "text/markdown,text/plain" },
+        });
+        if (mdResponse.ok &&
+            (mdResponse.headers.get("content-type") ?? "")
+                .toLowerCase()
+                .includes("markdown")) {
+            const body = (await mdResponse.text()).trim();
+            return this.formatResponse(parsed, undefined, body);
+        }
+        // 404s on docs.confluent.io soft-redirect to /index.html; reject path
+        // changes so we don't return the homepage as if it were the requested page.
+        const html = await this.fetchHtml(parsed, { rejectRedirect: true });
+        const $ = cheerio.load(html);
+        const main = $("div.rst-content").first();
+        const target = main.length > 0 ? main : $("body");
+        return this.formatResponse(parsed, undefined, this.toMarkdown(target.html()));
+    }
+    // Gatsby site has hashed CSS classes; key off stable data-swiftype-* attributes.
+    async fetchFromDeveloperConfluent(parsed) {
+        const html = await this.fetchHtml(parsed);
+        const $ = cheerio.load(html);
+        // <section data-test-id="section"> wraps both content and footer chrome
+        // (Cloud promo, newsletter). Real content is 3KB+ text; chrome is < 1KB.
+        $('section[data-test-id="section"]').each((_, el) => {
+            if ($(el).text().trim().length < 1500)
+                $(el).remove();
+        });
+        const title = $('[data-swiftype-name="title"]').first().text().trim();
+        let bodyHtml = null;
+        const swiftypeBody = $('[data-swiftype-name="body"]').first();
+        if (swiftypeBody.length > 0) {
+            swiftypeBody.find('[data-swiftype-index="false"]').remove();
+            bodyHtml = swiftypeBody.html();
+        }
+        else {
+            const fromPageData = await this.fetchFromGatsbyPageData(parsed);
+            if (fromPageData)
+                return fromPageData;
+            // Quickstart pages have no Swiftype body — content lives in <section> blocks.
+            const sections = $('section[data-test-id="section"]');
+            if (sections.length > 0) {
+                sections.find('[data-swiftype-index="false"]').remove();
+                bodyHtml = sections
+                    .map((_, el) => $.html(el))
+                    .get()
+                    .join("\n");
+            }
+            else {
+                // Tutorial pages (/confluent-tutorials/...) have neither marker —
+                // strip <body> chrome and keep the rest.
+                const body = $("body");
+                body
+                    .find('header, footer, nav, script, style, noscript, [data-swiftype-index="false"]')
+                    .remove();
+                const stripped = body.html()?.trim();
+                if (stripped)
+                    bodyHtml = stripped;
+            }
+        }
+        if (!bodyHtml) {
+            return this.createResponse(`Could not locate article body for ${parsed.toString()}. The page structure may have changed.`, true);
+        }
+        return this.formatResponse(parsed, title || undefined, this.toMarkdown(bodyHtml));
+    }
+    // Zendesk Help Center: prefer the public JSON API for clean body; HTML scrape is the fallback.
+    async fetchFromSupportZendesk(parsed) {
+        const articleId = parsed.pathname.match(/\/articles\/(\d+)/)?.[1];
+        if (articleId) {
+            const apiResponse = await fetchWithTimeout(`https://support.confluent.io/api/v2/help_center/articles/${articleId}.json`, {
+                headers: { "user-agent": USER_AGENT, accept: "application/json" },
+            });
+            if (apiResponse.ok) {
+                const { article } = (await apiResponse.json());
+                if (article?.body) {
+                    return this.formatResponse(parsed, article.title, this.toMarkdown(article.body));
+                }
+            }
+        }
+        const html = await this.fetchHtml(parsed);
+        const $ = cheerio.load(html);
+        const article = $("article#main-content").first();
+        if (article.length === 0) {
+            return this.createResponse(`Could not locate article body for ${parsed.toString()}. ` +
+                `This URL may be a Help Center index or category page; only article URLs (containing "/articles/<id>") are supported.`, true);
+        }
+        return this.formatResponse(parsed, undefined, this.toMarkdown(article.html()));
+    }
+    // CSR pages (e.g. /get-started/<lang>/) expose their real content as JSON
+    // at /page-data/<path>/page-data.json instead of in the SSR HTML.
+    async fetchFromGatsbyPageData(parsed) {
+        const pageDataUrl = `${parsed.origin}/page-data${parsed.pathname.replace(/\/?$/, "/")}page-data.json`;
+        const resp = await fetchWithTimeout(pageDataUrl, {
+            headers: { "user-agent": USER_AGENT, accept: "application/json" },
+        });
+        if (!resp.ok)
+            return null;
+        let data;
+        try {
+            data = (await resp.json());
+        }
+        catch {
+            return null;
+        }
+        const ctx = data?.result?.pageContext;
+        const cm = ctx?.contentMappings;
+        if (!cm || typeof cm !== "object")
+            return null;
+        // If the URL has a fragment (e.g. #produce-events), return only that section.
+        const sections = parsed.hash && cm[parsed.hash] ? [cm[parsed.hash]] : Object.values(cm);
+        const html = sections.join("\n");
+        if (!html)
+            return null;
+        const title = ctx?.hero?.title ?? ctx?.seo?.title;
+        return this.formatResponse(parsed, title || undefined, this.toMarkdown(html));
+    }
+    async fetchHtml(parsed, opts) {
+        const response = await fetchWithTimeout(parsed.toString(), {
+            headers: { "user-agent": USER_AGENT },
+        });
+        if (!response.ok) {
+            throw new Error(`${response.status} ${response.statusText}`);
+        }
+        if (opts?.rejectRedirect) {
+            const finalPath = new URL(response.url || parsed.toString()).pathname;
+            if (finalPath !== parsed.pathname) {
+                throw new Error(`${parsed.toString()} redirected to ${finalPath}; page may have been moved or removed.`);
+            }
+        }
+        return response.text();
+    }
+    toMarkdown(html) {
+        return this.turndown.turndown(html ?? "").trim();
+    }
+    formatResponse(parsed, title, body) {
+        const heading = title ? `# ${title}\n\n` : "";
+        return this.createResponse(`# Source: ${parsed.toString()}\n\n${heading}${body}`);
+    }
+    getToolConfig() {
+        return {
+            name: ToolName.GET_PRODUCT_DOC_PAGE,
+            description: "Fetch the full markdown content of a Confluent product documentation page. Accepts URLs under https://docs.confluent.io/, https://developer.confluent.io/, or https://support.confluent.io/. Use this after search-product-docs to read a result's full content.",
+            inputSchema: getProductDocPageArguments.shape,
+            annotations: READ_ONLY,
+        };
+    }
+    predicate = alwaysEnabled;
+}
+function toMarkdownTwin(parsed) {
+    const twin = new URL(parsed.toString());
+    if (twin.pathname.endsWith(".html")) {
+        twin.pathname = twin.pathname.slice(0, -".html".length) + ".md";
+    }
+    else if (twin.pathname.endsWith("/")) {
+        twin.pathname += "index.md";
+    }
+    else {
+        twin.pathname += ".md";
+    }
+    return twin.toString();
+}
+// Adds a 10s deadline and re-checks the post-redirect host so a 3xx
+// can't escape ALLOWED_HOSTS. Relabels TimeoutError with URL and budget.
+async function fetchWithTimeout(url, init) {
+    try {
+        const response = await nodeFetch.fetch(url, {
+            ...init,
+            signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
+        });
+        const finalHost = new URL(response.url || url).hostname;
+        if (!ALLOWED_HOSTS.has(finalHost)) {
+            throw new Error(`Request to ${url} redirected to disallowed host ${finalHost}`);
+        }
+        return response;
+    }
+    catch (err) {
+        if (err instanceof Error && err.name === "TimeoutError") {
+            throw new Error(`Request to ${url} timed out after ${REQUEST_TIMEOUT_MS}ms`);
+        }
+        throw err;
+    }
+}
+//# sourceMappingURL=get-product-doc-page-handler.js.map

package/dist/confluent/tools/handlers/docs/get-product-doc-page-handler.js.map

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

package/dist/confluent/tools/handlers/docs/search-product-docs-handler.d.ts

@@ -0,0 +1,13 @@
+import { CallToolResult } from "../../../../confluent/schema.js";
+import { BaseToolHandler, ToolConfig } from "../../../../confluent/tools/base-tools.js";
+import { ServerRuntime } from "../../../../server-runtime.js";
+export declare class SearchProductDocsHandler extends BaseToolHandler {
+    handle(_runtime: ServerRuntime, toolArguments: Record<string, unknown>): Promise<CallToolResult>;
+    private searchSwiftype;
+    private searchDeveloperProxy;
+    /** Zendesk Help Center public search API — no auth, support hits only. */
+    private searchSupportZendesk;
+    getToolConfig(): ToolConfig;
+    readonly predicate: import("../../../../confluent/tools/connection-predicates.js").ConnectionPredicate;
+}
+//# sourceMappingURL=search-product-docs-handler.d.ts.map

package/dist/confluent/tools/handlers/docs/search-product-docs-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-product-docs-handler.d.ts","sourceRoot":"","sources":["../../../../../src/confluent/tools/handlers/docs/search-product-docs-handler.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EACL,eAAe,EAEf,UAAU,EACX,MAAM,oCAAoC,CAAC;AAI5C,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAwDvD,qBAAa,wBAAyB,SAAQ,eAAe;IACrD,MAAM,CACV,QAAQ,EAAE,aAAa,EACvB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACrC,OAAO,CAAC,cAAc,CAAC;YAkDZ,cAAc;YAgCd,oBAAoB;IA4ClC,0EAA0E;YAC5D,oBAAoB;IA6BlC,aAAa,IAAI,UAAU;IAW3B,QAAQ,CAAC,SAAS,8EAAiB;CACpC"}

package/dist/confluent/tools/handlers/docs/search-product-docs-handler.js

@@ -0,0 +1,285 @@
+import { nodeFetch } from "../../../../confluent/node-deps.js";
+import { BaseToolHandler, READ_ONLY, } from "../../../../confluent/tools/base-tools.js";
+import { alwaysEnabled } from "../../../../confluent/tools/connection-predicates.js";
+import { ToolName } from "../../../../confluent/tools/tool-name.js";
+import { logger } from "../../../../logger.js";
+import { z } from "zod";
+// Public search-only key from docs.confluent.io frontend; safe to hardcode.
+const SWIFTYPE_ENGINE_KEY = "FbBthqzRNii8B32is9R2";
+const SWIFTYPE_SEARCH_URL = "https://search-api.swiftype.com/api/v1/public/engines/search.json";
+const DEVELOPER_SEARCH_URL = "https://developer.confluent.io/api/search";
+const SUPPORT_SEARCH_URL = "https://support.confluent.io/api/v2/help_center/articles/search.json";
+const ALLOWED_HOSTS = new Set([
+    "docs.confluent.io",
+    "developer.confluent.io",
+    "support.confluent.io",
+]);
+const DEVELOPER_CONTENT_TYPES = [
+    "documentation",
+    "tutorial",
+    "course",
+    "article",
+    "quickstart",
+    "recipe",
+    "pattern",
+    "faq",
+];
+const DESCRIPTION_MAX_LENGTH = 300;
+const USER_AGENT = "mcp-confluent/search-product-docs";
+const REQUEST_TIMEOUT_MS = 10_000;
+const searchProductDocsArguments = z.object({
+    query: z
+        .string()
+        .trim()
+        .min(1)
+        .describe("Keyword or phrase to search for in Confluent product docs."),
+    limit: z.coerce
+        .number()
+        .int()
+        .positive()
+        .max(50)
+        .default(10)
+        .describe("Maximum number of results to return (1-50, default 10)."),
+});
+export class SearchProductDocsHandler extends BaseToolHandler {
+    async handle(_runtime, toolArguments) {
+        const { query, limit } = searchProductDocsArguments.parse(toolArguments);
+        const [docsSettled, developerSettled, supportSettled] = await Promise.allSettled([
+            this.searchSwiftype(query, limit),
+            this.searchDeveloperProxy(query, limit),
+            this.searchSupportZendesk(query, limit),
+        ]);
+        const warnings = [];
+        // Whichever backend pushes into a bucket first leads it.
+        // dev-proxy is curated, so its hits outrank Swiftype's; Swiftype fills gaps.
+        const all = [
+            ...extractResults(developerSettled, "developer.confluent.io", warnings),
+            ...extractResults(supportSettled, "support.confluent.io", warnings),
+            ...extractResults(docsSettled, "docs.confluent.io", warnings),
+        ];
+        // Bucket by URL hostname, not backend: Swiftype indexes *.confluent.io
+        // and dev-proxy returns docs URLs, so backend→bucket would starve slots.
+        const buckets = {
+            "docs.confluent.io": [],
+            "developer.confluent.io": [],
+            "support.confluent.io": [],
+        };
+        for (const r of all)
+            buckets[r.source].push(r);
+        const merged = interleaveAndDedupe([
+            buckets["docs.confluent.io"],
+            buckets["developer.confluent.io"],
+            buckets["support.confluent.io"],
+        ], limit);
+        const payload = { results: merged, warnings };
+        if (merged.length === 0) {
+            payload.message = `No results found for "${query}".`;
+        }
+        return this.createResponse(JSON.stringify(payload, null, 2), merged.length === 0 && warnings.length > 0);
+    }
+    async searchSwiftype(query, limit) {
+        // Over-fetch: host-filtering may drop hits before we reach `limit`.
+        const params = new URLSearchParams({
+            engine_key: SWIFTYPE_ENGINE_KEY,
+            q: query,
+            per_page: String(Math.min(50, limit * 3)),
+            page: "1",
+        });
+        const json = await fetchSourceJson(`${SWIFTYPE_SEARCH_URL}?${params.toString()}`, { headers: { "user-agent": USER_AGENT, accept: "application/json" } }, "Swiftype");
+        const hits = json.records?.page ?? [];
+        return hits
+            .map((h) => {
+            const url = typeof h.url === "string" ? h.url : "";
+            const source = sourceForUrl(url);
+            if (source === null)
+                return null;
+            return {
+                title: coerceTitle(h.title) ?? url,
+                url,
+                description: buildDescription(h.highlight?.body, h.body),
+                source,
+            };
+        })
+            .filter((r) => r !== null);
+    }
+    async searchDeveloperProxy(query, limit) {
+        const json = await fetchSourceJson(DEVELOPER_SEARCH_URL, {
+            method: "POST",
+            headers: {
+                "content-type": "application/json",
+                "user-agent": USER_AGENT,
+                accept: "application/json",
+            },
+            body: JSON.stringify({
+                query,
+                page: 1,
+                perPage: limit,
+                contentTypes: DEVELOPER_CONTENT_TYPES,
+            }),
+        }, "developer.confluent.io /api/search");
+        const results = [];
+        for (const contentType of DEVELOPER_CONTENT_TYPES) {
+            const items = json[contentType]?.items ?? [];
+            for (const item of items) {
+                const url = typeof item.url === "string" ? item.url : "";
+                const source = sourceForUrl(url);
+                if (source === null)
+                    continue;
+                results.push({
+                    title: coerceTitle(item.title) ?? url,
+                    url,
+                    description: buildDescription(item.highlight?.body, item.description, item.body),
+                    source,
+                });
+            }
+        }
+        return results;
+    }
+    /** Zendesk Help Center public search API — no auth, support hits only. */
+    async searchSupportZendesk(query, limit) {
+        const params = new URLSearchParams({
+            query,
+            per_page: String(limit),
+        });
+        const json = await fetchSourceJson(`${SUPPORT_SEARCH_URL}?${params.toString()}`, { headers: { "user-agent": USER_AGENT, accept: "application/json" } }, "Zendesk");
+        const hits = json.results ?? [];
+        return hits
+            .map((h) => {
+            const url = typeof h.html_url === "string" ? h.html_url : "";
+            const source = sourceForUrl(url);
+            if (source === null)
+                return null;
+            return {
+                title: coerceTitle(h.title) ?? url,
+                url,
+                description: buildDescription(h.snippet, h.body),
+                source,
+            };
+        })
+            .filter((r) => r !== null);
+    }
+    getToolConfig() {
+        return {
+            name: ToolName.SEARCH_PRODUCT_DOCS,
+            description: "Search Confluent product documentation (docs.confluent.io, developer.confluent.io, support.confluent.io) by keyword.",
+            inputSchema: searchProductDocsArguments.shape,
+            annotations: READ_ONLY,
+        };
+    }
+    // No service-block requirement; enabled on any connection.
+    predicate = alwaysEnabled;
+}
+/** Fetches JSON with a timeout. Errors are rethrown prefixed with `label`. */
+async function fetchSourceJson(url, init, label) {
+    let response;
+    try {
+        response = await nodeFetch.fetch(url, {
+            ...init,
+            signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
+        });
+    }
+    catch (err) {
+        if (err instanceof Error && err.name === "TimeoutError") {
+            throw new Error(`${label} timed out after ${REQUEST_TIMEOUT_MS}ms`);
+        }
+        throw err;
+    }
+    if (!response.ok) {
+        throw new Error(`${label} ${response.status} ${response.statusText}`);
+    }
+    return (await response.json());
+}
+function extractResults(settled, source, warnings) {
+    if (settled.status === "fulfilled")
+        return settled.value;
+    const reason = settled.reason instanceof Error
+        ? settled.reason.message
+        : String(settled.reason);
+    warnings.push(`${source} search failed: ${reason}`);
+    logger.warn({ source, reason }, "search-product-docs source failed");
+    return [];
+}
+// Indices into [docs, developer, support]: docs and dev get 2× weight, support 1×.
+const PICKUP_PATTERN = [0, 1, 1, 0, 2];
+/** Interleaves sources per PICKUP_PATTERN, dedupes by URL, stops at `limit`. */
+function interleaveAndDedupe(sources, limit) {
+    const seen = new Set();
+    const out = [];
+    const indices = sources.map(() => 0);
+    let progressed = true;
+    while (out.length < limit && progressed) {
+        progressed = false;
+        for (const s of PICKUP_PATTERN) {
+            if (out.length >= limit)
+                break;
+            const list = sources[s];
+            while (indices[s] < list.length) {
+                const r = list[indices[s]++];
+                progressed = true;
+                if (!seen.has(r.url)) {
+                    seen.add(r.url);
+                    out.push(r);
+                    break;
+                }
+            }
+        }
+    }
+    return out;
+}
+function sourceForUrl(url) {
+    try {
+        const parsed = new URL(url);
+        if (parsed.protocol !== "https:")
+            return null;
+        if (ALLOWED_HOSTS.has(parsed.hostname))
+            return parsed.hostname;
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Title may be a string or a `[seo, display]` array; pick the shorter one
+ * (usually the cleaner display title). Returns null if no usable title.
+ */
+function coerceTitle(title) {
+    if (typeof title === "string")
+        return title.trim() || null;
+    if (Array.isArray(title)) {
+        const strings = title.filter((t) => typeof t === "string");
+        if (strings.length === 0)
+            return null;
+        const sorted = [...strings].sort((a, b) => a.length - b.length);
+        return sorted[0].trim() || null;
+    }
+    return null;
+}
+function buildDescription(...candidates) {
+    for (const candidate of candidates) {
+        if (!candidate)
+            continue;
+        const cleaned = stripHtmlAndCollapse(candidate);
+        if (cleaned.length > 0)
+            return truncate(cleaned, DESCRIPTION_MAX_LENGTH);
+    }
+    return "";
+}
+function stripHtmlAndCollapse(html) {
+    return html
+        .replaceAll(/<[^>]+>/g, " ")
+        .replaceAll("&nbsp;", " ")
+        .replaceAll("&amp;", "&")
+        .replaceAll("&lt;", "<")
+        .replaceAll("&gt;", ">")
+        .replaceAll("&quot;", '"')
+        .replaceAll("&#39;", "'")
+        .replaceAll(/\s+/g, " ")
+        .trim();
+}
+function truncate(text, max) {
+    if (text.length <= max)
+        return text;
+    return text.slice(0, max - 1).trimEnd() + "…";
+}
+//# sourceMappingURL=search-product-docs-handler.js.map

package/dist/confluent/tools/handlers/docs/search-product-docs-handler.js.map

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

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

@@ -1,7 +1,6 @@
-import { ClientManager } from "../../../../confluent/client-manager.js";
 import { CallToolResult } from "../../../../confluent/schema.js";
 import { BaseToolHandler, ToolConfig } from "../../../../confluent/tools/base-tools.js";
-import { EnvVar } from "../../../../env-schema.js";
+import { ServerRuntime } from "../../../../server-runtime.js";
 import { z } from "zod";
 /**
  * Schema for validating Confluent Cloud environment responses
@@ -52,9 +51,8 @@ export declare const environmentListSchema: z.ZodObject<{
 export type Environment = z.infer<typeof environmentSchema>;
 export type EnvironmentList = z.infer<typeof environmentListSchema>;
 export declare class ListEnvironmentsHandler extends BaseToolHandler {
-    handle(clientManager: ClientManager, toolArguments: Record<string, unknown>): Promise<CallToolResult>;
+    handle(runtime: ServerRuntime, toolArguments: Record<string, unknown>): Promise<CallToolResult>;
     getToolConfig(): ToolConfig;
-    getRequiredEnvVars(): readonly EnvVar[];
-    isConfluentCloudOnly(): boolean;
+    readonly predicate: import("../../../../confluent/tools/connection-predicates.js").ConnectionPredicate;
 }
 //# sourceMappingURL=list-environments-handler.d.ts.map

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,EAEf,UAAU,EACX,MAAM,oCAAoC,CAAC;AAE5C,OAAO,EAEL,MAAM,EACP,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AASxB;;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;IAkG1B,aAAa,IAAI,UAAU;IAU3B,kBAAkB,IAAI,SAAS,MAAM,EAAE;IAIvC,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,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EACL,eAAe,EAEf,UAAU,EACX,MAAM,oCAAoC,CAAC;AAI5C,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAEvD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AASxB;;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,OAAO,EAAE,aAAa,EACtB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACrC,OAAO,CAAC,cAAc,CAAC;IAmG1B,aAAa,IAAI,UAAU;IAS3B,QAAQ,CAAC,SAAS,8EAA4B;CAC/C"}

package/dist/confluent/tools/handlers/environments/list-environments-handler.js

@@ -1,6 +1,6 @@
 import { BaseToolHandler, READ_ONLY, } from "../../../../confluent/tools/base-tools.js";
+import { hasConfluentCloudOrOAuth } from "../../../../confluent/tools/connection-predicates.js";
 import { ToolName } from "../../../../confluent/tools/tool-name.js";
-import { CCLOUD_CONTROL_PLANE_REQUIRED_ENV_VARS, } from "../../../../env-schema.js";
 import { logger } from "../../../../logger.js";
 import { wrapAsPathBasedClient } from "openapi-fetch";
 import { z } from "zod";
@@ -46,7 +46,8 @@ export const environmentListSchema = z.object({
     data: z.array(environmentSchema),
 });
 export class ListEnvironmentsHandler extends BaseToolHandler {
-    async handle(clientManager, toolArguments) {
+    async handle(runtime, toolArguments) {
+        const clientManager = runtime.clientManager;
         const { pageToken } = listEnvironmentsArguments.parse(toolArguments);
         try {
             const pathBasedClient = wrapAsPathBasedClient(clientManager.getConfluentCloudRestClient());
@@ -119,11 +120,6 @@ Pagination:${metadata.total_size ? `\n  Total Environments: ${metadata.total_siz
             annotations: READ_ONLY,
         };
     }
-    getRequiredEnvVars() {
-        return CCLOUD_CONTROL_PLANE_REQUIRED_ENV_VARS;
-    }
-    isConfluentCloudOnly() {
-        return true;
-    }
+    predicate = hasConfluentCloudOrOAuth;
 }
 //# sourceMappingURL=list-environments-handler.js.map