@confluentinc/mcp-confluent 1.2.2 → 1.3.0

package/dist/confluent/tools/tool-availability.d.ts

@@ -0,0 +1,74 @@
+import { ToolHandler } from "../../confluent/tools/base-tools.js";
+import { ToolDisabledReason } from "../../confluent/tools/connection-predicates.js";
+import { ToolName } from "../../confluent/tools/tool-name.js";
+import { ServerRuntime } from "../../server-runtime.js";
+/**
+ * One bucket of disabled tools sharing a single {@linkcode ToolDisabledReason}
+ * — the unit operators use to read the diagnostic surface ("what would I add
+ * to the connection config to unlock these tools?"). Tool order within
+ * `tools` follows the order handlers were iterated.
+ */
+export interface DisabledToolsByReason {
+    readonly reason: ToolDisabledReason;
+    readonly tools: readonly ToolName[];
+}
+/**
+ * Output of {@linkcode buildToolGatingReport}; drives the
+ * `explain-disabled-tools` diagnostic tool. Tools advertised via
+ * `tools/list` are intentionally absent — the report carries the
+ * negative signal only.
+ *
+ * Single-connection scope today (the server enforces one connection; see
+ * `enforceSingleConnectionOnly()` in `src/config/models.ts`). When
+ * multi-connection support lands as part of issue #151's follow-ups the
+ * shape regrows around connections — per-connection sections plus a
+ * cross-connection-deltas section calling out tools enabled on some
+ * connections but not others.
+ */
+export interface ToolGatingReport {
+    readonly disabledGroups: readonly DisabledToolsByReason[];
+    readonly enabledCount: number;
+    readonly disabledCount: number;
+}
+/**
+ * One bucket of tools sharing the same `(connectionId, reason)` pair — the
+ * unit of one grouped log line at server startup. `toolNames` preserves
+ * input iteration order.
+ */
+export interface DisabledToolGroup {
+    readonly connectionId: string;
+    readonly reason: ToolDisabledReason;
+    readonly toolNames: ToolName[];
+}
+/**
+ * Group fully-disabled tools by `(connectionId, reason)`. A tool is "fully
+ * disabled" when every configured connection reports a non-enabled verdict;
+ * tools enabled on at least one connection are omitted entirely (they are
+ * already going to be advertised by the server, so they don't belong in a
+ * disabled-tool log line).
+ *
+ * Returned groups are sorted lexicographically by `connectionId`. Stable
+ * sort preserves the relative order of groups within the same connection.
+ */
+export declare function groupDisabledToolsByReason(handlers: Iterable<readonly [ToolName, ToolHandler]>, runtime: ServerRuntime): DisabledToolGroup[];
+/**
+ * Assemble a {@linkcode ToolGatingReport} for the given handler set against
+ * the configured connection.
+ *
+ * v1 (single-connection scope):
+ * - `disabledGroups` is sorted lex by reason; tools within a group follow
+ *   handler iteration order.
+ * - Each tool contributes once to `enabledCount` *or* `disabledCount`:
+ *   a tool whose predicate produces an `enabled: true` verdict on at
+ *   least one configured connection counts as enabled (and is omitted
+ *   from `disabledGroups`); otherwise it counts as disabled and lands
+ *   under the first disabled verdict's reason. This flatten is lossy
+ *   on a multi-connection runtime — see the handler module-doc for
+ *   the consequences and the v2 (multi-connection) shape on
+ *   {@linkcode ToolGatingReport}.
+ * - Throws `Wacky -- ...` if any handler returns an empty verdict map
+ *   (a runtime-shaped invariant violation rather than a tool-state
+ *   condition; see `classifyTool` for the rationale).
+ */
+export declare function buildToolGatingReport(handlers: Iterable<readonly [ToolName, ToolHandler]>, runtime: ServerRuntime): ToolGatingReport;
+//# sourceMappingURL=tool-availability.d.ts.map

package/dist/confluent/tools/tool-availability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-availability.d.ts","sourceRoot":"","sources":["../../../src/confluent/tools/tool-availability.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AACjE,OAAO,EAEL,kBAAkB,EACnB,MAAM,+CAA+C,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,MAAM,mCAAmC,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAEvD;;;;;GAKG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,SAAS,QAAQ,EAAE,CAAC;CACrC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,cAAc,EAAE,SAAS,qBAAqB,EAAE,CAAC;IAC1D,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,QAAQ,EAAE,CAAC;CAChC;AAED;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,QAAQ,CAAC,SAAS,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC,EACpD,OAAO,EAAE,aAAa,GACrB,iBAAiB,EAAE,CA+BrB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,QAAQ,CAAC,SAAS,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC,EACpD,OAAO,EAAE,aAAa,GACrB,gBAAgB,CA2BlB"}

package/dist/confluent/tools/tool-availability.js

@@ -0,0 +1,121 @@
+/**
+ * Group fully-disabled tools by `(connectionId, reason)`. A tool is "fully
+ * disabled" when every configured connection reports a non-enabled verdict;
+ * tools enabled on at least one connection are omitted entirely (they are
+ * already going to be advertised by the server, so they don't belong in a
+ * disabled-tool log line).
+ *
+ * Returned groups are sorted lexicographically by `connectionId`. Stable
+ * sort preserves the relative order of groups within the same connection.
+ */
+export function groupDisabledToolsByReason(handlers, runtime) {
+    const groups = new Map();
+    for (const [toolName, handler] of handlers) {
+        const verdicts = handler.connectionVerdicts(runtime);
+        // Single pass over the verdicts: collect disabled entries, abort on
+        // the first enabled one (the tool is partially-enabled and doesn't
+        // belong in a disabled-tool group).
+        const disabledEntries = [];
+        let partiallyEnabled = false;
+        for (const [connectionId, verdict] of verdicts) {
+            if (verdict.enabled) {
+                partiallyEnabled = true;
+                break;
+            }
+            disabledEntries.push([connectionId, verdict.reason]);
+        }
+        if (partiallyEnabled)
+            continue;
+        for (const [connectionId, reason] of disabledEntries) {
+            const key = `${connectionId}::${reason}`;
+            let group = groups.get(key);
+            if (!group) {
+                group = { connectionId, reason, toolNames: [] };
+                groups.set(key, group);
+            }
+            group.toolNames.push(toolName);
+        }
+    }
+    return Array.from(groups.values()).sort((a, b) => a.connectionId.localeCompare(b.connectionId));
+}
+/**
+ * Assemble a {@linkcode ToolGatingReport} for the given handler set against
+ * the configured connection.
+ *
+ * v1 (single-connection scope):
+ * - `disabledGroups` is sorted lex by reason; tools within a group follow
+ *   handler iteration order.
+ * - Each tool contributes once to `enabledCount` *or* `disabledCount`:
+ *   a tool whose predicate produces an `enabled: true` verdict on at
+ *   least one configured connection counts as enabled (and is omitted
+ *   from `disabledGroups`); otherwise it counts as disabled and lands
+ *   under the first disabled verdict's reason. This flatten is lossy
+ *   on a multi-connection runtime — see the handler module-doc for
+ *   the consequences and the v2 (multi-connection) shape on
+ *   {@linkcode ToolGatingReport}.
+ * - Throws `Wacky -- ...` if any handler returns an empty verdict map
+ *   (a runtime-shaped invariant violation rather than a tool-state
+ *   condition; see `classifyTool` for the rationale).
+ */
+export function buildToolGatingReport(handlers, runtime) {
+    // Map<reason, ToolName[]>; insertion order doesn't matter — the projection
+    // step below sorts groups lex by reason.
+    const groupsByReason = new Map();
+    let enabledCount = 0;
+    let disabledCount = 0;
+    for (const [toolName, handler] of handlers) {
+        const classification = classifyTool(handler.connectionVerdicts(runtime));
+        if (classification.kind === "enabled") {
+            enabledCount += 1;
+            continue;
+        }
+        disabledCount += 1;
+        let bucket = groupsByReason.get(classification.reason);
+        bucket ??= [];
+        groupsByReason.set(classification.reason, bucket);
+        bucket.push(toolName);
+    }
+    const disabledGroups = Array.from(groupsByReason.entries())
+        .map(([reason, tools]) => ({ reason, tools }))
+        .sort((a, b) => a.reason.localeCompare(b.reason));
+    return { disabledGroups, enabledCount, disabledCount };
+}
+/**
+ * Reduce a tool's per-connection verdict map to a single classification for
+ * the v1 flat report. Under the single-connection invariant the verdict map
+ * has exactly one entry, so this is a pass-through; the implementation
+ * tolerates multi-entry maps (test fixtures synthesise them) by treating
+ * "enabled on at least one connection" as enabled and otherwise reporting
+ * the first disabled verdict's reason.
+ *
+ * v2 multi-connection: drop this helper. The aggregation moves into the
+ * caller, which builds per-connection rows and cross-connection deltas
+ * directly from the verdict map.
+ */
+function classifyTool(verdicts) {
+    let firstDisabledReason;
+    for (const verdict of verdicts.values()) {
+        if (verdict.enabled)
+            return { kind: "enabled" };
+        if (firstDisabledReason === undefined) {
+            firstDisabledReason = verdict.reason;
+        }
+    }
+    if (firstDisabledReason === undefined) {
+        // Wacky -- handler returned an empty verdict map. BaseToolHandler builds
+        // verdicts directly from `runtime.config.connections`, so an empty map
+        // means there are zero configured connections, which
+        // `enforceSingleConnectionOnly()` in `src/config/models.ts` should have
+        // prevented at bootstrap. Fail loudly rather than fabricate a
+        // misleading `ToolDisabledReason` and ship it in the operator-facing
+        // report — a wrong-by-name reason is harder to diagnose than a stack
+        // trace.
+        throw new Error("Wacky -- classifyTool received an empty verdict map: a handler's " +
+            "connectionVerdicts() returned no entries. BaseToolHandler derives " +
+            "verdicts from runtime.config.connections; an empty map implies zero " +
+            "configured connections, which enforceSingleConnectionOnly() in " +
+            "src/config/models.ts should have rejected at bootstrap.");
+    }
+    return { kind: "disabled", reason: firstDisabledReason };
+}
+//# sourceMappingURL=tool-availability.js.map

package/dist/confluent/tools/tool-availability.js.map

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

package/dist/confluent/tools/tool-name.d.ts

@@ -48,6 +48,10 @@ export declare enum ToolName {
     DELETE_TABLEFLOW_CATALOG_INTEGRATION = "delete-tableflow-catalog-integration",
     LIST_BILLING_COSTS = "list-billing-costs",
     QUERY_METRICS = "query-metrics",
-    LIST_METRICS = "list-available-metrics"
+    LIST_METRICS = "list-available-metrics",
+    SEARCH_PRODUCT_DOCS = "search-product-docs",
+    GET_PRODUCT_DOC_PAGE = "get-product-doc-page",
+    LIST_ORGANIZATIONS = "list-organizations",
+    EXPLAIN_DISABLED_TOOLS = "explain-disabled-tools"
 }
 //# sourceMappingURL=tool-name.d.ts.map

package/dist/confluent/tools/tool-name.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-name.d.ts","sourceRoot":"","sources":["../../../src/confluent/tools/tool-name.ts"],"names":[],"mappings":"AAAA,oBAAY,QAAQ;IAClB,WAAW,gBAAgB;IAC3B,aAAa,kBAAkB;IAC/B,aAAa,kBAAkB;IAC/B,eAAe,oBAAoB;IACnC,gBAAgB,qBAAqB;IACrC,qBAAqB,0BAA0B;IAC/C,sBAAsB,2BAA2B;IACjD,oBAAoB,yBAAyB;IAC7C,uBAAuB,4BAA4B;IACnD,8BAA8B,mCAAmC;IACjE,mBAAmB,wBAAwB;IAC3C,oBAAoB,yBAAyB;IAC7C,iBAAiB,sBAAsB;IACvC,oBAAoB,yBAAyB;IAC7C,oBAAoB,yBAAyB;IAC7C,4BAA4B,iCAAiC;IAC7D,6BAA6B,kCAAkC;IAC/D,2BAA2B,gCAAgC;IAC3D,eAAe,oBAAoB;IACnC,cAAc,mBAAmB;IACjC,gBAAgB,qBAAqB;IACrC,gBAAgB,qBAAqB;IACrC,oBAAoB,yBAAyB;IAC7C,qBAAqB,0BAA0B;IAC/C,iBAAiB,sBAAsB;IACvC,UAAU,eAAe;IACzB,sBAAsB,2BAA2B;IACjD,iBAAiB,sBAAsB;IACvC,SAAS,cAAc;IACvB,kBAAkB,uBAAuB;IACzC,aAAa,kBAAkB;IAC/B,iBAAiB,sBAAsB;IACvC,gBAAgB,qBAAqB;IACrC,YAAY,iBAAiB;IAC7B,aAAa,kBAAkB;IAC/B,gBAAgB,qBAAqB;IACrC,sBAAsB,2BAA2B;IACjD,sBAAsB,2BAA2B;IACjD,qBAAqB,0BAA0B;IAC/C,oBAAoB,yBAAyB;IAC7C,sBAAsB,2BAA2B;IACjD,sBAAsB,2BAA2B;IACjD,oCAAoC,yCAAyC;IAC7E,mCAAmC,wCAAwC;IAC3E,kCAAkC,uCAAuC;IACzE,oCAAoC,yCAAyC;IAC7E,oCAAoC,yCAAyC;IAC7E,kBAAkB,uBAAuB;IACzC,aAAa,kBAAkB;IAC/B,YAAY,2BAA2B;CACxC"}
+{"version":3,"file":"tool-name.d.ts","sourceRoot":"","sources":["../../../src/confluent/tools/tool-name.ts"],"names":[],"mappings":"AAAA,oBAAY,QAAQ;IAClB,WAAW,gBAAgB;IAC3B,aAAa,kBAAkB;IAC/B,aAAa,kBAAkB;IAC/B,eAAe,oBAAoB;IACnC,gBAAgB,qBAAqB;IACrC,qBAAqB,0BAA0B;IAC/C,sBAAsB,2BAA2B;IACjD,oBAAoB,yBAAyB;IAC7C,uBAAuB,4BAA4B;IACnD,8BAA8B,mCAAmC;IACjE,mBAAmB,wBAAwB;IAC3C,oBAAoB,yBAAyB;IAC7C,iBAAiB,sBAAsB;IACvC,oBAAoB,yBAAyB;IAC7C,oBAAoB,yBAAyB;IAC7C,4BAA4B,iCAAiC;IAC7D,6BAA6B,kCAAkC;IAC/D,2BAA2B,gCAAgC;IAC3D,eAAe,oBAAoB;IACnC,cAAc,mBAAmB;IACjC,gBAAgB,qBAAqB;IACrC,gBAAgB,qBAAqB;IACrC,oBAAoB,yBAAyB;IAC7C,qBAAqB,0BAA0B;IAC/C,iBAAiB,sBAAsB;IACvC,UAAU,eAAe;IACzB,sBAAsB,2BAA2B;IACjD,iBAAiB,sBAAsB;IACvC,SAAS,cAAc;IACvB,kBAAkB,uBAAuB;IACzC,aAAa,kBAAkB;IAC/B,iBAAiB,sBAAsB;IACvC,gBAAgB,qBAAqB;IACrC,YAAY,iBAAiB;IAC7B,aAAa,kBAAkB;IAC/B,gBAAgB,qBAAqB;IACrC,sBAAsB,2BAA2B;IACjD,sBAAsB,2BAA2B;IACjD,qBAAqB,0BAA0B;IAC/C,oBAAoB,yBAAyB;IAC7C,sBAAsB,2BAA2B;IACjD,sBAAsB,2BAA2B;IACjD,oCAAoC,yCAAyC;IAC7E,mCAAmC,wCAAwC;IAC3E,kCAAkC,uCAAuC;IACzE,oCAAoC,yCAAyC;IAC7E,oCAAoC,yCAAyC;IAC7E,kBAAkB,uBAAuB;IACzC,aAAa,kBAAkB;IAC/B,YAAY,2BAA2B;IACvC,mBAAmB,wBAAwB;IAC3C,oBAAoB,yBAAyB;IAC7C,kBAAkB,uBAAuB;IACzC,sBAAsB,2BAA2B;CAClD"}

package/dist/confluent/tools/tool-name.js

@@ -50,5 +50,9 @@ export var ToolName;
     ToolName["LIST_BILLING_COSTS"] = "list-billing-costs";
     ToolName["QUERY_METRICS"] = "query-metrics";
     ToolName["LIST_METRICS"] = "list-available-metrics";
+    ToolName["SEARCH_PRODUCT_DOCS"] = "search-product-docs";
+    ToolName["GET_PRODUCT_DOC_PAGE"] = "get-product-doc-page";
+    ToolName["LIST_ORGANIZATIONS"] = "list-organizations";
+    ToolName["EXPLAIN_DISABLED_TOOLS"] = "explain-disabled-tools";
 })(ToolName || (ToolName = {}));
 //# sourceMappingURL=tool-name.js.map

package/dist/confluent/tools/tool-name.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool-name.js","sourceRoot":"","sources":["../../../src/confluent/tools/tool-name.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,QAmDX;AAnDD,WAAY,QAAQ;IAClB,uCAA2B,CAAA;IAC3B,2CAA+B,CAAA;IAC/B,2CAA+B,CAAA;IAC/B,+CAAmC,CAAA;IACnC,iDAAqC,CAAA;IACrC,2DAA+C,CAAA;IAC/C,6DAAiD,CAAA;IACjD,yDAA6C,CAAA;IAC7C,+DAAmD,CAAA;IACnD,6EAAiE,CAAA;IACjE,uDAA2C,CAAA;IAC3C,yDAA6C,CAAA;IAC7C,mDAAuC,CAAA;IACvC,yDAA6C,CAAA;IAC7C,yDAA6C,CAAA;IAC7C,yEAA6D,CAAA;IAC7D,2EAA+D,CAAA;IAC/D,uEAA2D,CAAA;IAC3D,+CAAmC,CAAA;IACnC,6CAAiC,CAAA;IACjC,iDAAqC,CAAA;IACrC,iDAAqC,CAAA;IACrC,yDAA6C,CAAA;IAC7C,2DAA+C,CAAA;IAC/C,mDAAuC,CAAA;IACvC,qCAAyB,CAAA;IACzB,6DAAiD,CAAA;IACjD,mDAAuC,CAAA;IACvC,mCAAuB,CAAA;IACvB,qDAAyC,CAAA;IACzC,2CAA+B,CAAA;IAC/B,mDAAuC,CAAA;IACvC,iDAAqC,CAAA;IACrC,yCAA6B,CAAA;IAC7B,2CAA+B,CAAA;IAC/B,iDAAqC,CAAA;IACrC,6DAAiD,CAAA;IACjD,6DAAiD,CAAA;IACjD,2DAA+C,CAAA;IAC/C,yDAA6C,CAAA;IAC7C,6DAAiD,CAAA;IACjD,6DAAiD,CAAA;IACjD,yFAA6E,CAAA;IAC7E,uFAA2E,CAAA;IAC3E,qFAAyE,CAAA;IACzE,yFAA6E,CAAA;IAC7E,yFAA6E,CAAA;IAC7E,qDAAyC,CAAA;IACzC,2CAA+B,CAAA;IAC/B,mDAAuC,CAAA;AACzC,CAAC,EAnDW,QAAQ,KAAR,QAAQ,QAmDnB"}
+{"version":3,"file":"tool-name.js","sourceRoot":"","sources":["../../../src/confluent/tools/tool-name.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,QAuDX;AAvDD,WAAY,QAAQ;IAClB,uCAA2B,CAAA;IAC3B,2CAA+B,CAAA;IAC/B,2CAA+B,CAAA;IAC/B,+CAAmC,CAAA;IACnC,iDAAqC,CAAA;IACrC,2DAA+C,CAAA;IAC/C,6DAAiD,CAAA;IACjD,yDAA6C,CAAA;IAC7C,+DAAmD,CAAA;IACnD,6EAAiE,CAAA;IACjE,uDAA2C,CAAA;IAC3C,yDAA6C,CAAA;IAC7C,mDAAuC,CAAA;IACvC,yDAA6C,CAAA;IAC7C,yDAA6C,CAAA;IAC7C,yEAA6D,CAAA;IAC7D,2EAA+D,CAAA;IAC/D,uEAA2D,CAAA;IAC3D,+CAAmC,CAAA;IACnC,6CAAiC,CAAA;IACjC,iDAAqC,CAAA;IACrC,iDAAqC,CAAA;IACrC,yDAA6C,CAAA;IAC7C,2DAA+C,CAAA;IAC/C,mDAAuC,CAAA;IACvC,qCAAyB,CAAA;IACzB,6DAAiD,CAAA;IACjD,mDAAuC,CAAA;IACvC,mCAAuB,CAAA;IACvB,qDAAyC,CAAA;IACzC,2CAA+B,CAAA;IAC/B,mDAAuC,CAAA;IACvC,iDAAqC,CAAA;IACrC,yCAA6B,CAAA;IAC7B,2CAA+B,CAAA;IAC/B,iDAAqC,CAAA;IACrC,6DAAiD,CAAA;IACjD,6DAAiD,CAAA;IACjD,2DAA+C,CAAA;IAC/C,yDAA6C,CAAA;IAC7C,6DAAiD,CAAA;IACjD,6DAAiD,CAAA;IACjD,yFAA6E,CAAA;IAC7E,uFAA2E,CAAA;IAC3E,qFAAyE,CAAA;IACzE,yFAA6E,CAAA;IAC7E,yFAA6E,CAAA;IAC7E,qDAAyC,CAAA;IACzC,2CAA+B,CAAA;IAC/B,mDAAuC,CAAA;IACvC,uDAA2C,CAAA;IAC3C,yDAA6C,CAAA;IAC7C,qDAAyC,CAAA;IACzC,6DAAiD,CAAA;AACnD,CAAC,EAvDW,QAAQ,KAAR,QAAQ,QAuDnB"}

package/dist/confluent/tools/tool-registry.d.ts

@@ -0,0 +1,18 @@
+import { ToolConfig, ToolHandler } from "../../confluent/tools/base-tools.js";
+import { ToolName } from "../../confluent/tools/tool-name.js";
+/**
+ * Central registry for all tool call handlers.
+ */
+export declare class ToolHandlerRegistry {
+    private static readonly handlers;
+    static getToolHandler(toolName: ToolName): ToolHandler;
+    static getToolConfig(toolName: ToolName): ToolConfig;
+    /**
+     * Iterable over every (ToolName, ToolHandler) pair in the registry, in
+     * declaration order. Consumed by the `explain-disabled-tools` diagnostic
+     * tool to walk the full handler set without a back-channel into the
+     * private map. Read-only — callers must not mutate the underlying map.
+     */
+    static allHandlers(): Iterable<readonly [ToolName, ToolHandler]>;
+}
+//# sourceMappingURL=tool-registry.d.ts.map

package/dist/confluent/tools/tool-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-registry.d.ts","sourceRoot":"","sources":["../../../src/confluent/tools/tool-registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AAuD7E,OAAO,EAAE,QAAQ,EAAE,MAAM,mCAAmC,CAAC;AAE7D;;GAEG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CA4E7B;IAEH,MAAM,CAAC,cAAc,CAAC,QAAQ,EAAE,QAAQ,GAAG,WAAW;IAItD,MAAM,CAAC,aAAa,CAAC,QAAQ,EAAE,QAAQ,GAAG,UAAU;IAIpD;;;;;OAKG;IACH,MAAM,CAAC,WAAW,IAAI,QAAQ,CAAC,SAAS,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;CAGjE"}

package/dist/confluent/tools/{tool-factory.js → tool-registry.js}

@@ -1,3 +1,4 @@
+import { ListBillingCostsHandler } from "../../confluent/tools/handlers/billing/list-billing-costs-handler.js";
 import { AddTagToTopicHandler } from "../../confluent/tools/handlers/catalog/add-tags-to-topic.js";
 import { CreateTopicTagsHandler } from "../../confluent/tools/handlers/catalog/create-topic-tags.js";
 import { DeleteTagHandler } from "../../confluent/tools/handlers/catalog/delete-tag.js";
@@ -8,15 +9,18 @@ import { CreateConnectorHandler } from "../../confluent/tools/handlers/connect/c
 import { DeleteConnectorHandler } from "../../confluent/tools/handlers/connect/delete-connector-handler.js";
 import { ListConnectorsHandler } from "../../confluent/tools/handlers/connect/list-connectors-handler.js";
 import { ReadConnectorHandler } from "../../confluent/tools/handlers/connect/read-connectors-handler.js";
+import { ExplainDisabledToolsHandler } from "../../confluent/tools/handlers/diagnostics/explain-disabled-tools-handler.js";
+import { GetProductDocPageHandler } from "../../confluent/tools/handlers/docs/get-product-doc-page-handler.js";
+import { SearchProductDocsHandler } from "../../confluent/tools/handlers/docs/search-product-docs-handler.js";
 import { ListEnvironmentsHandler } from "../../confluent/tools/handlers/environments/list-environments-handler.js";
 import { ReadEnvironmentHandler } from "../../confluent/tools/handlers/environments/read-environment-handler.js";
-import { CreateFlinkStatementHandler } from "../../confluent/tools/handlers/flink/create-flink-statement-handler.js";
-import { DeleteFlinkStatementHandler } from "../../confluent/tools/handlers/flink/delete-flink-statement-handler.js";
 import { DescribeTableHandler } from "../../confluent/tools/handlers/flink/catalog/describe-table-handler.js";
 import { GetTableInfoHandler } from "../../confluent/tools/handlers/flink/catalog/get-table-info-handler.js";
 import { ListCatalogsHandler } from "../../confluent/tools/handlers/flink/catalog/list-catalogs-handler.js";
 import { ListDatabasesHandler } from "../../confluent/tools/handlers/flink/catalog/list-databases-handler.js";
 import { ListTablesHandler } from "../../confluent/tools/handlers/flink/catalog/list-tables-handler.js";
+import { CreateFlinkStatementHandler } from "../../confluent/tools/handlers/flink/create-flink-statement-handler.js";
+import { DeleteFlinkStatementHandler } from "../../confluent/tools/handlers/flink/delete-flink-statement-handler.js";
 import { CheckHealthHandler } from "../../confluent/tools/handlers/flink/diagnostics/check-health-handler.js";
 import { DetectIssuesHandler } from "../../confluent/tools/handlers/flink/diagnostics/detect-issues-handler.js";
 import { QueryProfilerHandler } from "../../confluent/tools/handlers/flink/diagnostics/query-profiler-handler.js";
@@ -30,6 +34,9 @@ import { DeleteTopicsHandler } from "../../confluent/tools/handlers/kafka/delete
 import { GetTopicConfigHandler } from "../../confluent/tools/handlers/kafka/get-topic-config.js";
 import { ListTopicsHandler } from "../../confluent/tools/handlers/kafka/list-topics-handler.js";
 import { ProduceKafkaMessageHandler } from "../../confluent/tools/handlers/kafka/produce-kafka-message-handler.js";
+import { ListMetricsHandler } from "../../confluent/tools/handlers/metrics/list-metrics-handler.js";
+import { QueryMetricsHandler } from "../../confluent/tools/handlers/metrics/query-metrics-handler.js";
+import { ListOrganizationsHandler } from "../../confluent/tools/handlers/organizations/list-organizations-handler.js";
 import { DeleteSchemaHandler } from "../../confluent/tools/handlers/schema/delete-schema-handler.js";
 import { ListSchemasHandler } from "../../confluent/tools/handlers/schema/list-schemas-handler.js";
 import { SearchTopicsByTagHandler } from "../../confluent/tools/handlers/search/search-topic-by-tag-handler.js";
@@ -45,11 +52,11 @@ import { DeleteTableFlowTopicHandler } from "../../confluent/tools/handlers/tabl
 import { ListTableFlowTopicsHandler } from "../../confluent/tools/handlers/tableflow/topic/list-tableflow-topics-handler.js";
 import { ReadTableFlowTopicHandler } from "../../confluent/tools/handlers/tableflow/topic/read-tableflow-topic-handler.js";
 import { UpdateTableFlowTopicHandler } from "../../confluent/tools/handlers/tableflow/topic/update-tableflow-topic-handler.js";
-import { ListBillingCostsHandler } from "../../confluent/tools/handlers/billing/list-billing-costs-handler.js";
-import { ListMetricsHandler } from "../../confluent/tools/handlers/metrics/list-metrics-handler.js";
-import { QueryMetricsHandler } from "../../confluent/tools/handlers/metrics/query-metrics-handler.js";
 import { ToolName } from "../../confluent/tools/tool-name.js";
-export class ToolFactory {
+/**
+ * Central registry for all tool call handlers.
+ */
+export class ToolHandlerRegistry {
     static handlers = new Map([
         [ToolName.LIST_TOPICS, new ListTopicsHandler()],
         [ToolName.CREATE_TOPICS, new CreateTopicsHandler()],
@@ -116,22 +123,28 @@ export class ToolFactory {
         [ToolName.LIST_BILLING_COSTS, new ListBillingCostsHandler()],
         [ToolName.QUERY_METRICS, new QueryMetricsHandler()],
         [ToolName.LIST_METRICS, new ListMetricsHandler()],
+        [ToolName.SEARCH_PRODUCT_DOCS, new SearchProductDocsHandler()],
+        [ToolName.GET_PRODUCT_DOC_PAGE, new GetProductDocPageHandler()],
+        [ToolName.LIST_ORGANIZATIONS, new ListOrganizationsHandler()],
+        [
+            ToolName.EXPLAIN_DISABLED_TOOLS,
+            new ExplainDisabledToolsHandler(() => ToolHandlerRegistry.allHandlers()),
+        ],
     ]);
-    static createToolHandler(toolName) {
-        if (!this.handlers.has(toolName)) {
-            throw new Error(`Unknown tool name: ${toolName}`);
-        }
+    static getToolHandler(toolName) {
         return this.handlers.get(toolName);
     }
-    static getToolConfigs() {
-        // iterate through all the handlers and collect their configurations
-        return Array.from(this.handlers.values()).map((handler) => handler.getToolConfig());
-    }
     static getToolConfig(toolName) {
-        if (!this.handlers.has(toolName)) {
-            throw new Error(`Unknown tool name: ${toolName}`);
-        }
-        return this.handlers.get(toolName).getToolConfig();
+        return this.getToolHandler(toolName).getToolConfig();
+    }
+    /**
+     * Iterable over every (ToolName, ToolHandler) pair in the registry, in
+     * declaration order. Consumed by the `explain-disabled-tools` diagnostic
+     * tool to walk the full handler set without a back-channel into the
+     * private map. Read-only — callers must not mutate the underlying map.
+     */
+    static allHandlers() {
+        return this.handlers.entries();
     }
 }
-//# sourceMappingURL=tool-factory.js.map
+//# sourceMappingURL=tool-registry.js.map

package/dist/confluent/tools/tool-registry.js.map

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

package/dist/env-schema.d.ts

@@ -32,21 +32,19 @@ export declare const combinedSchema: z.ZodObject<{
     FLINK_ORG_ID: z.ZodOptional<z.ZodString>;
     FLINK_REST_ENDPOINT: z.ZodOptional<z.ZodString>;
     FLINK_COMPUTE_POOL_ID: z.ZodOptional<z.ZodString>;
+    FLINK_CATALOG_NAME: z.ZodOptional<z.ZodString>;
     FLINK_ENV_NAME: z.ZodOptional<z.ZodString>;
     FLINK_DATABASE_NAME: z.ZodOptional<z.ZodString>;
     KAFKA_CLUSTER_ID: z.ZodOptional<z.ZodString>;
     KAFKA_ENV_ID: z.ZodOptional<z.ZodString>;
-    CONFLUENT_CLOUD_REST_ENDPOINT: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+    CONFLUENT_CLOUD_REST_ENDPOINT: z.ZodOptional<z.ZodString>;
     SCHEMA_REGISTRY_ENDPOINT: z.ZodOptional<z.ZodString>;
     KAFKA_REST_ENDPOINT: z.ZodOptional<z.ZodString>;
-    TELEMETRY_ENDPOINT: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+    TELEMETRY_ENDPOINT: z.ZodOptional<z.ZodString>;
     TELEMETRY_API_KEY: z.ZodOptional<z.ZodString>;
     TELEMETRY_API_SECRET: z.ZodOptional<z.ZodString>;
+    TELEMETRY_WRITE_KEY: z.ZodOptional<z.ZodString>;
+    OAUTH_KAFKA_DEBUG: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type EnvVar = keyof z.infer<typeof combinedSchema>;
-export declare const TELEMETRY_REQUIRED_ENV_VARS: readonly ["CONFLUENT_CLOUD_API_KEY", "CONFLUENT_CLOUD_API_SECRET"];
-export declare const CCLOUD_CONTROL_PLANE_REQUIRED_ENV_VARS: readonly ["CONFLUENT_CLOUD_REST_ENDPOINT", "CONFLUENT_CLOUD_API_KEY", "CONFLUENT_CLOUD_API_SECRET"];
-export declare const CCLOUD_SCHEMA_REGISTRY_REQUIRED_ENV_VARS: readonly ["SCHEMA_REGISTRY_ENDPOINT", "SCHEMA_REGISTRY_API_KEY", "SCHEMA_REGISTRY_API_SECRET"];
-export declare const KAFKA_REST_REQUIRED_ENV_VARS: readonly ["KAFKA_REST_ENDPOINT", "KAFKA_API_KEY", "KAFKA_API_SECRET"];
-export declare const FLINK_REQUIRED_ENV_VARS: readonly ["FLINK_REST_ENDPOINT", "FLINK_API_KEY", "FLINK_API_SECRET"];
 //# sourceMappingURL=env-schema.d.ts.map

package/dist/env-schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"env-schema.d.ts","sourceRoot":"","sources":["../src/env-schema.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAsQxB,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAAgC,CAAC;AAG5D,MAAM,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAE1D,eAAO,MAAM,2BAA2B,oEAgB9B,CAAC;AAEX,eAAO,MAAM,sCAAsC,qGAIzC,CAAC;AAEX,eAAO,MAAM,wCAAwC,gGAI3C,CAAC;AAEX,eAAO,MAAM,4BAA4B,uEAI/B,CAAC;AAEX,eAAO,MAAM,uBAAuB,uEAI1B,CAAC"}
+{"version":3,"file":"env-schema.d.ts","sourceRoot":"","sources":["../src/env-schema.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA2RxB,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAAgC,CAAC;AAG5D,MAAM,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC"}

package/dist/env-schema.js

@@ -136,9 +136,16 @@ const configSchema = z
         .describe("Unique identifier for the Flink compute pool, must start with 'lfcp-' prefix")
         .trim()
         .startsWith("lfcp-"),
+    FLINK_CATALOG_NAME: z
+        .string()
+        .describe("Name of the Flink catalog used as `sql.current-catalog` in submitted statements. Typically the Confluent Cloud environment's display name.")
+        .trim()
+        .min(1),
+    // TODO: Remove FLINK_ENV_NAME in v1.4.0 — kept as a deprecated alias of
+    // FLINK_CATALOG_NAME for one release cycle. See issue #209.
     FLINK_ENV_NAME: z
         .string()
-        .describe("Human-readable name for the Flink environment used for identification and display purposes")
+        .describe("DEPRECATED: rename to FLINK_CATALOG_NAME. Will be removed in v1.4.0. Same meaning — the Flink catalog name used as `sql.current-catalog`.")
         .trim()
         .min(1),
     FLINK_DATABASE_NAME: z
@@ -160,8 +167,7 @@ const configSchema = z
         .string()
         .describe("Base URL for Confluent Cloud's REST API services")
         .trim()
-        .url()
-        .default("https://api.confluent.cloud"),
+        .url(),
     SCHEMA_REGISTRY_ENDPOINT: z
         .string()
         .describe("URL endpoint for accessing Schema Registry services to manage data schemas")
@@ -176,8 +182,7 @@ const configSchema = z
         .string()
         .describe("Base URL for Confluent Cloud Telemetry API (metrics)")
         .trim()
-        .url()
-        .default("https://api.telemetry.confluent.cloud"),
+        .url(),
     TELEMETRY_API_KEY: z
         .string()
         .describe("Optional API key for telemetry access with basic read permissions. Falls back to CONFLUENT_CLOUD_API_KEY if not set.")
@@ -188,41 +193,17 @@ const configSchema = z
         .describe("Optional API secret paired with TELEMETRY_API_KEY. Falls back to CONFLUENT_CLOUD_API_SECRET if not set.")
         .trim()
         .min(1),
+    TELEMETRY_WRITE_KEY: z
+        .string()
+        .describe("Developer-only override for the Segment write key used to emit anonymous usage analytics from this MCP server. Normal builds inject the right value at npm pack time; setting this is only useful when developing mcp-confluent against a non-production telemetry sink.")
+        .trim()
+        .min(1),
+    OAUTH_KAFKA_DEBUG: z
+        .string()
+        .describe("librdkafka `debug` contexts for the native Kafka client of an --oauth-synthesized connection. Common values: 'security,broker,protocol', 'all'. Useful when diagnosing a SASL/OAUTHBEARER handshake failure under OAuth. YAML configs supply this via the OAuth connection's kafka_debug field instead.")
+        .trim()
+        .min(1),
 })
     .partial();
 export const combinedSchema = envSchema.merge(configSchema);
-export const TELEMETRY_REQUIRED_ENV_VARS = [
-    // Configuring the telemetry client will first look for TELEMETRY_API_KEY/SECRET, then fall back to CONFLUENT_CLOUD_API_KEY/SECRET, so
-    // the only absolute required env vars for telemetry are the Confluent Cloud API key/secret.
-    // Likewise, TELEMETRY_ENDPOINT has a default value, so it's not strictly required either.
-    // The fallback behavior for the configuration of telemetry
-    // in DefaultClientManager indicates that the entire concept
-    // of BaseToolHandler.getRequiredEnvVars() is ill designed, and that tool enablement
-    // needs to be made more flexible, which should happen in conjunction with
-    // migrating configuration to primarily be YAML based, not env var based.
-    // For now, though, we describe the truly required env vars for telemetry as
-    // just the Confluent Cloud API key/secret, for better or worse.
-    "CONFLUENT_CLOUD_API_KEY",
-    "CONFLUENT_CLOUD_API_SECRET",
-];
-export const CCLOUD_CONTROL_PLANE_REQUIRED_ENV_VARS = [
-    "CONFLUENT_CLOUD_REST_ENDPOINT",
-    "CONFLUENT_CLOUD_API_KEY",
-    "CONFLUENT_CLOUD_API_SECRET",
-];
-export const CCLOUD_SCHEMA_REGISTRY_REQUIRED_ENV_VARS = [
-    "SCHEMA_REGISTRY_ENDPOINT",
-    "SCHEMA_REGISTRY_API_KEY",
-    "SCHEMA_REGISTRY_API_SECRET",
-];
-export const KAFKA_REST_REQUIRED_ENV_VARS = [
-    "KAFKA_REST_ENDPOINT",
-    "KAFKA_API_KEY",
-    "KAFKA_API_SECRET",
-];
-export const FLINK_REQUIRED_ENV_VARS = [
-    "FLINK_REST_ENDPOINT",
-    "FLINK_API_KEY",
-    "FLINK_API_SECRET",
-];
 //# sourceMappingURL=env-schema.js.map

package/dist/env-schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"env-schema.js","sourceRoot":"","sources":["../src/env-schema.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"env-schema.js","sourceRoot":"","sources":["../src/env-schema.ts"],"names":[],"mappings":"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"}

package/dist/env.d.ts

@@ -2,15 +2,22 @@ import { combinedSchema } from "./env-schema.js";
 import { z } from "zod";
 export type Environment = z.infer<typeof combinedSchema>;
 /**
- * Loads and validates environment variables
- * @returns Validated environment object
+ * Initialize environment and save the values
  */
-export declare function loadEnv(): Promise<Environment>;
+export declare function initEnv(): Environment;
 /**
- * Initialize environment and save the values
+ * Lazy proxy over the validated environment values. Reading any property
+ * before {@linkcode initEnv} has run throws — this is what catches code that
+ * tries to consult the env outside the bootstrap.
+ *
+ * The default-export shape was retired in #234 to make accidental consumers
+ * visibly fail at the import site, and an ESLint rule slams the door behind
+ * it. The intended pattern is: `main()` calls `initEnv()` once, captures the
+ * returned `Environment` into a local, and passes it explicitly to the few
+ * call sites that need it. No global env consultation lives in handler code,
+ * test infrastructure, or anywhere else.
  */
-export declare function initEnv(): Promise<Environment>;
-declare const env: {
+export declare const env: {
     HTTP_PORT: number;
     HTTP_HOST: string;
     HTTP_MCP_ENDPOINT_PATH: string;
@@ -36,6 +43,7 @@ declare const env: {
     FLINK_ORG_ID?: string | undefined;
     FLINK_REST_ENDPOINT?: string | undefined;
     FLINK_COMPUTE_POOL_ID?: string | undefined;
+    FLINK_CATALOG_NAME?: string | undefined;
     FLINK_ENV_NAME?: string | undefined;
     FLINK_DATABASE_NAME?: string | undefined;
     KAFKA_CLUSTER_ID?: string | undefined;
@@ -46,6 +54,7 @@ declare const env: {
     TELEMETRY_ENDPOINT?: string | undefined;
     TELEMETRY_API_KEY?: string | undefined;
     TELEMETRY_API_SECRET?: string | undefined;
+    TELEMETRY_WRITE_KEY?: string | undefined;
+    OAUTH_KAFKA_DEBUG?: string | undefined;
 };
-export default env;
 //# sourceMappingURL=env.d.ts.map

package/dist/env.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEpD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAMzD;;;GAGG;AACH,wBAAsB,OAAO,IAAI,OAAO,CAAC,WAAW,CAAC,CAQpD;AAED;;GAEG;AACH,wBAAsB,OAAO,IAAI,OAAO,CAAC,WAAW,CAAC,CAMpD;AAGD,QAAA,MAAM,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CASP,CAAC;AAEH,eAAe,GAAG,CAAC"}
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEpD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAoBzD;;GAEG;AACH,wBAAgB,OAAO,IAAI,WAAW,CAMrC;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CASd,CAAC"}