@confluentinc/mcp-confluent 1.2.2 → 1.4.0

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

@@ -0,0 +1,135 @@
+import { BaseToolHandler, READ_ONLY, ToolCategory, } from "../../../../confluent/tools/base-tools.js";
+import { alwaysEnabled } from "../../../../confluent/tools/connection-predicates.js";
+import { buildToolGatingReport, disabledToolGroupKey, } from "../../../../confluent/tools/tool-availability.js";
+import { ToolName } from "../../../../confluent/tools/tool-name.js";
+import { z } from "zod";
+const explainDisabledToolsArguments = z.object({
+    group_by: z
+        .enum(["reason", "category"])
+        .default("reason")
+        .describe('Axis to bucket disabled tools by. "reason" (default) answers "what config piece would unlock these?" — each bucket is a ToolDisabledReason (MissingKafkaBlock, MissingFlinkBlock, …). "category" answers "which functional area is offline?" — each bucket is a ToolCategory (kafka, flink, schema-registry, …). Flip to "category" when triaging a misconfigured connection by functional area instead of by missing config piece.'),
+});
+/**
+ * Diagnostic tool that surfaces *why* tools are absent from `tools/list`.
+ *
+ * The MCP protocol already advertises the enabled tool set via `tools/list`;
+ * what it does not surface is the predicate-driven decision behind every
+ * absence — which config piece is missing, and which tools each gap would
+ * unlock. This handler returns that view.
+ *
+ * v1 scope (today's release): the server enforces a single configured
+ * connection (see `enforceSingleConnectionOnly()` in
+ * `src/config/models.ts`), so the output is a flat list of disabled tools
+ * grouped by the missing config piece (kafka block, flink block, schema
+ * registry block, …). Tools enabled on the active connection are
+ * intentionally absent — `tools/list` already advertises them.
+ *
+ * v2 plan (when multi-connection support lands — issue #151's follow-ups):
+ * regrow output around connections. The text body becomes one block per
+ * connection (header + per-connection gaps) plus a `Cross-connection
+ * deltas` section that surfaces tools enabled on some connections but not
+ * others — the canonical "what does connection B need to reach parity with
+ * connection A?" view. The structured `_meta` shape mirrors that change;
+ * see the {@linkcode ToolGatingReport} JSDoc in `tool-availability.ts` for
+ * the exact target type.
+ *
+ * Until v2 lands, the helper accepts a multi-connection runtime without
+ * crashing, but the v1 flatten is *lossy*: a tool whose predicate is
+ * enabled on at least one configured connection is reported as enabled
+ * (and therefore omitted from `disabledGroups` entirely), and a tool
+ * disabled on multiple connections with different reasons is bucketed
+ * under the first disabled verdict its iteration produces — the
+ * cross-connection asymmetry vanishes from the output. Today's
+ * single-connection invariant means neither lossy case can fire in
+ * production; this paragraph exists so a future reader does not mistake
+ * defensive iteration for parity reporting.
+ *
+ * Always enabled (predicate is `alwaysEnabled`) so an operator can call it
+ * to diagnose a config that left every other tool disabled.
+ *
+ * The handlers iterable is supplied at construction time via a thunk so
+ * this module does not need to import `ToolHandlerRegistry`. Importing the
+ * registry from a registered handler would create an ESM cycle, leaving
+ * the registry's static initializer running before this class's binding
+ * is set. The thunk is invoked at request time, after every module is
+ * fully loaded, sidestepping the cycle entirely.
+ */
+export class ExplainDisabledToolsHandler extends BaseToolHandler {
+    listHandlers;
+    constructor(listHandlers) {
+        super();
+        this.listHandlers = listHandlers;
+    }
+    handle(runtime, toolArguments) {
+        const { group_by } = explainDisabledToolsArguments.parse(toolArguments ?? {});
+        const report = buildToolGatingReport(this.listHandlers(), runtime, group_by);
+        return this.createResponse(renderReport(report), false, { ...report });
+    }
+    getToolConfig() {
+        return {
+            name: ToolName.EXPLAIN_DISABLED_TOOLS,
+            description: 'Call when the user asks why a tool is missing or unavailable (e.g., "why can\'t I list Kafka topics?", "where are the Flink tools?"). Returns disabled tools grouped by the config gap each one is waiting on, so you can tell the user the exact YAML block or field to add. Pass group_by="category" to regroup by functional area (kafka, flink, schema-registry, …) when the user\'s question is framed by what\'s offline rather than by what\'s missing from config. Prefer this over guessing about credentials, network, or auth.',
+            inputSchema: explainDisabledToolsArguments.shape,
+            annotations: READ_ONLY,
+        };
+    }
+    category = ToolCategory.McpServerDiagnostics;
+    predicate = alwaysEnabled;
+}
+/**
+ * Render a {@linkcode ToolGatingReport} as the human-readable text body of
+ * the tool's response. Format is stable — handler tests pin specific
+ * substrings so the AI/script-facing structure does not drift silently.
+ *
+ * The heading line varies by `report.groupBy`:
+ *
+ *   - `"reason"`: "{disabled} of {total} tools disabled for the following reasons:"
+ *   - `"category"`: "{disabled} of {total} tools disabled across the following categories:"
+ *
+ * Body shape is identical for both axes — one header line per bucket
+ * followed by indented `- {tool}` bullets, separated by a blank line:
+ *
+ *   {disabled} of {total} tools disabled for the following reasons:
+ *
+ *     {reason or category} ({n}):
+ *       - {tool}
+ *       - {tool}
+ *       …
+ *
+ *     {next bucket} ({n}):
+ *       - {tool}
+ *       …
+ *
+ *   {enabled} tools advertised via tools/list.
+ *
+ * Two-space indent on the bucket header, four-space indent on the bullets.
+ *
+ * v2 (multi-connection): grow a connection header per per-connection
+ * section and an optional `Cross-connection deltas` section. See the
+ * handler's class JSDoc for the migration sketch.
+ */
+function renderReport(report) {
+    const total = report.enabledCount + report.disabledCount;
+    if (report.disabledCount === 0) {
+        return `All ${total} registered tools are advertised via tools/list.`;
+    }
+    const headingTail = report.groupBy === "reason"
+        ? "for the following reasons"
+        : "across the following categories";
+    // Each group's render contains its own header line + indented bullets;
+    // joining with a blank line separates groups visually so long bullet
+    // lists from one group don't bleed into the next.
+    return [
+        `${report.disabledCount} of ${total} tools disabled ${headingTail}:`,
+        "",
+        report.disabledGroups.map(renderGroup).join("\n\n"),
+        "",
+        `${report.enabledCount} tools advertised via tools/list.`,
+    ].join("\n");
+}
+function renderGroup(group) {
+    const header = `  ${disabledToolGroupKey(group)} (${group.tools.length}):`;
+    const bullets = group.tools.map((tool) => `    - ${tool}`);
+    return [header, ...bullets].join("\n");
+}
+//# sourceMappingURL=explain-disabled-tools-handler.js.map

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

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

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

@@ -0,0 +1,18 @@
+import { CallToolResult } from "../../../../confluent/schema.js";
+import { BaseToolHandler, ToolCategory, ToolConfig } from "../../../../confluent/tools/base-tools.js";
+import { ServerRuntime } from "../../../../server-runtime.js";
+export declare class GetProductDocPageHandler extends BaseToolHandler {
+    private readonly turndown;
+    handle(_runtime: ServerRuntime, toolArguments: Record<string, unknown>): Promise<CallToolResult>;
+    private fetchFromDocsConfluent;
+    private fetchFromDeveloperConfluent;
+    private fetchFromSupportZendesk;
+    private fetchFromGatsbyPageData;
+    private fetchHtml;
+    private toMarkdown;
+    private formatResponse;
+    getToolConfig(): ToolConfig;
+    readonly category = ToolCategory.Docs;
+    readonly predicate: import("../../../../confluent/tools/connection-predicates.js").ConnectionPredicate;
+}
+//# sourceMappingURL=get-product-doc-page-handler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-product-doc-page-handler.d.ts","sourceRoot":"","sources":["../../../../../src/confluent/tools/handlers/docs/get-product-doc-page-handler.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EACL,eAAe,EAEf,YAAY,EACZ,UAAU,EACX,MAAM,oCAAoC,CAAC;AAI5C,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AA2BvD,qBAAa,wBAAyB,SAAQ,eAAe;IAC3D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAItB;IAEG,MAAM,CACV,QAAQ,EAAE,aAAa,EACvB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACrC,OAAO,CAAC,cAAc,CAAC;YA8BZ,sBAAsB;YA4BtB,2BAA2B;YA2D3B,uBAAuB;YAyCvB,uBAAuB;YAgCvB,SAAS;IAqBvB,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,cAAc;IAWtB,aAAa,IAAI,UAAU;IAU3B,QAAQ,CAAC,QAAQ,qBAAqB;IACtC,QAAQ,CAAC,SAAS,8EAAiB;CACpC"}

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

@@ -0,0 +1,235 @@
+import { nodeFetch } from "../../../../confluent/node-deps.js";
+import { BaseToolHandler, READ_ONLY, ToolCategory, } 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,
+        };
+    }
+    category = ToolCategory.Docs;
+    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,14 @@
+import { CallToolResult } from "../../../../confluent/schema.js";
+import { BaseToolHandler, ToolCategory, 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 category = ToolCategory.Docs;
+    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,YAAY,EACZ,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;IAU3B,QAAQ,CAAC,QAAQ,qBAAqB;IAEtC,QAAQ,CAAC,SAAS,8EAAiB;CACpC"}