@confluentinc/mcp-confluent 1.3.0 → 1.5.0

package/dist/confluent/tools/base-tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"base-tools.js","sourceRoot":"","sources":["../../../src/confluent/tools/base-tools.ts"],"names":[],"mappings":"AAYA;;;GAGG;AACH,MAAM,CAAC,MAAM,SAAS,GAAoB;IACxC,YAAY,EAAE,IAAI;CACV,CAAC;AAEX,MAAM,CAAC,MAAM,aAAa,GAAoB;IAC5C,eAAe,EAAE,KAAK;IACtB,YAAY,EAAE,KAAK;CACX,CAAC;AAEX,MAAM,CAAC,MAAM,WAAW,GAAoB;IAC1C,eAAe,EAAE,IAAI;IACrB,YAAY,EAAE,KAAK;CACX,CAAC;AAgDX,MAAM,OAAgB,eAAe;IAyCnC;;;;;;;;OAQG;IACH,oBAAoB,CAAC,OAAsB;QACzC,OAAO,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC;aAC9C,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC;aAClD,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC;IACvB,CAAC;IAED;;;;;;;;;OASG;IACH,kBAAkB,CAAC,OAAsB;QACvC,OAAO,IAAI,GAAG,CACZ,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC;YAC7D,EAAE;YACF,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;SACrB,CAAC,CACH,CAAC;IACJ,CAAC;IAED;;;;;;;;;OASG;IACO,qBAAqB,CAAC,OAAsB;QAKpD,MAAM,MAAM,GAAG,IAAI,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAE,CAAC;QACtD,OAAO;YACL,MAAM;YACN,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAE;YACzC,aAAa,EAAE,OAAO,CAAC,cAAc,CAAC,MAAM,CAAE;SAC/C,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACO,YAAY,CACpB,QAA4B,EAC5B,WAA+B,EAC/B,KAAa;QAEb,MAAM,QAAQ,GAAG,QAAQ,EAAE,IAAI,EAAE,IAAI,WAAW,EAAE,IAAI,EAAE,CAAC;QACzD,IAAI,CAAC,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,cAAc,CAAC,CAAC;QACvD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,uIAAuI;IAC7H,oBAAoB,CAC5B,QAA4B,EAC5B,WAA+B;QAE/B,OAAO,QAAQ,EAAE,IAAI,EAAE,IAAI,WAAW,EAAE,IAAI,EAAE,IAAI,SAAS,CAAC;IAC9D,CAAC;IAED,cAAc,CACZ,OAAe,EACf,UAAmB,KAAK,EACxB,KAA+B;QAE/B,MAAM,QAAQ,GAAmB;YAC/B,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,OAAO;iBACd;aACF;YACD,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,KAAK;SACb,CAAC;QACF,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF"}
+{"version":3,"file":"base-tools.js","sourceRoot":"","sources":["../../../src/confluent/tools/base-tools.ts"],"names":[],"mappings":"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"}

package/dist/confluent/tools/cluster-arg-resolvers.d.ts

@@ -10,7 +10,28 @@
  *   with `isError: true` so the agent receives a normal tool-call error
  *   rather than an RPC failure.
  */
+import { ConnectionConfig } from "../../config/models.js";
 import { ServerRuntime } from "../../server-runtime.js";
+/**
+ * Shared env + Kafka-cluster resolver for Confluent Cloud REST handlers that
+ * address a resource by environment + cluster and carry those ids in the
+ * request URL/body (Connect, Tableflow). Distinct from the native-Kafka
+ * {@link resolveKafkaClusterArgs}, which returns `undefined` on direct because
+ * the `DirectClientManager` ignores cluster args — here the handler genuinely
+ * needs the concrete ids.
+ *
+ * - Direct: explicit tool args win, falling back to the connection's
+ *   `kafka.env_id` / `kafka.cluster_id`. Throws `"Environment ID is required"` /
+ *   `"Kafka Cluster ID is required"` if either value is absent from both
+ *   sources.
+ * - OAuth: both args are required (an OAuth connection carries no `kafka` block
+ *   to fall back to). Throws a discovery hint pointing at `list-environments` /
+ *   `list-clusters` when either is missing.
+ */
+export declare function resolveEnvAndClusterArgs(conn: ConnectionConfig, envIdArg: string | undefined, clusterIdArg: string | undefined): {
+    environment_id: string;
+    kafka_cluster_id: string;
+};
 export declare function resolveKafkaClusterArgs(args: {
     cluster_id?: string;
     environment_id?: string;

package/dist/confluent/tools/cluster-arg-resolvers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cluster-arg-resolvers.d.ts","sourceRoot":"","sources":["../../../src/confluent/tools/cluster-arg-resolvers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAEvD,wBAAgB,uBAAuB,CACrC,IAAI,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CAAE,EACtD,OAAO,EAAE,aAAa,EACtB,MAAM,EAAE,MAAM,GACb;IAAE,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAe9D;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,EACpD,OAAO,EAAE,aAAa,EACtB,MAAM,EAAE,MAAM,GACb;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAqBlD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE;IAAE,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,EAChC,OAAO,EAAE,aAAa,EACtB,MAAM,EAAE,MAAM,GACb,MAAM,CAaR;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,aAAa,EACtB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE;IAAE,UAAU,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,GAC1C,OAAO,CAAC,IAAI,CAAC,CAOf;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAoBrD"}
+{"version":3,"file":"cluster-arg-resolvers.d.ts","sourceRoot":"","sources":["../../../src/confluent/tools/cluster-arg-resolvers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAmBvD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,gBAAgB,EACtB,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,YAAY,EAAE,MAAM,GAAG,SAAS,GAC/B;IAAE,cAAc,EAAE,MAAM,CAAC;IAAC,gBAAgB,EAAE,MAAM,CAAA;CAAE,CAyBtD;AAED,wBAAgB,uBAAuB,CACrC,IAAI,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CAAE,EACtD,OAAO,EAAE,aAAa,EACtB,MAAM,EAAE,MAAM,GACb;IAAE,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAe9D;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,EACpD,OAAO,EAAE,aAAa,EACtB,MAAM,EAAE,MAAM,GACb;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAqBlD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE;IAAE,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,EAChC,OAAO,EAAE,aAAa,EACtB,MAAM,EAAE,MAAM,GACb,MAAM,CAaR;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,aAAa,EACtB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE;IAAE,UAAU,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,GAC1C,OAAO,CAAC,IAAI,CAAC,CAOf;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAoBrD"}

package/dist/confluent/tools/cluster-arg-resolvers.js

@@ -12,6 +12,51 @@
  */
 import { KafkaJS } from "@confluentinc/kafka-javascript";
 import { logger } from "../../logger.js";
+/**
+ * Resolves a required string from an explicit arg, falling back to a
+ * connection-config value. Throws `"${label} is required"` when neither is
+ * present. The free-function peer of `BaseToolHandler.resolveParam`, kept here
+ * so {@link resolveEnvAndClusterArgs} stays a standalone module function rather
+ * than a handler method.
+ */
+function requireParam(argValue, configValue, label) {
+    const resolved = argValue?.trim() || configValue?.trim();
+    if (!resolved)
+        throw new Error(`${label} is required`);
+    return resolved;
+}
+/**
+ * Shared env + Kafka-cluster resolver for Confluent Cloud REST handlers that
+ * address a resource by environment + cluster and carry those ids in the
+ * request URL/body (Connect, Tableflow). Distinct from the native-Kafka
+ * {@link resolveKafkaClusterArgs}, which returns `undefined` on direct because
+ * the `DirectClientManager` ignores cluster args — here the handler genuinely
+ * needs the concrete ids.
+ *
+ * - Direct: explicit tool args win, falling back to the connection's
+ *   `kafka.env_id` / `kafka.cluster_id`. Throws `"Environment ID is required"` /
+ *   `"Kafka Cluster ID is required"` if either value is absent from both
+ *   sources.
+ * - OAuth: both args are required (an OAuth connection carries no `kafka` block
+ *   to fall back to). Throws a discovery hint pointing at `list-environments` /
+ *   `list-clusters` when either is missing.
+ */
+export function resolveEnvAndClusterArgs(conn, envIdArg, clusterIdArg) {
+    if (conn.type === "oauth") {
+        const environment_id = envIdArg?.trim();
+        const kafka_cluster_id = clusterIdArg?.trim();
+        if (!environment_id || !kafka_cluster_id) {
+            throw new Error("environmentId and clusterId are required under OAuth connection type. " +
+                "Discover via list-environments, then call list-clusters " +
+                "with environmentId to discover clusterId.");
+        }
+        return { environment_id, kafka_cluster_id };
+    }
+    return {
+        environment_id: requireParam(envIdArg, conn.kafka?.env_id, "Environment ID"),
+        kafka_cluster_id: requireParam(clusterIdArg, conn.kafka?.cluster_id, "Kafka Cluster ID"),
+    };
+}
 export function resolveKafkaClusterArgs(args, runtime, connId) {
     const conn = runtime.config.connections[connId];
     if (conn.type === "direct") {

package/dist/confluent/tools/cluster-arg-resolvers.js.map

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

package/dist/confluent/tools/connection-predicates.d.ts

@@ -52,7 +52,7 @@ export declare const hasConfluentCloudOrOAuth: ConnectionPredicate;
 /**
  * Block-level — verdict that holds only for direct connections carrying a
  * `confluent_cloud` block. Use this on handlers that are not yet OAuth-capable
- * and call `getSoleDirectConnection()` inside `handle()`. Once a handler
+ * and call `resolveDirectConnection()` inside `handle()`. Once a handler
  * widens to OAuth, switch its predicate to
  * {@linkcode hasConfluentCloudOrOAuth}.
  */
@@ -71,11 +71,19 @@ export declare function hasTelemetry(conn: ConnectionConfig): PredicateResult;
  */
 export declare function hasTableflow(conn: ConnectionConfig): PredicateResult;
 /**
- * Field-level — verdict that holds when the `schema_registry` block is
- * present and its `auth` field is `api_key`-typed. That combination is the
- * reliable signal that the SR is CCloud-hosted and therefore exposes the
- * `/catalog/v1/` endpoints. A vanilla CP SR has no auth, so it disables
- * even when the `schema_registry` block itself is present.
+ * Field-level — verdict that holds when the connection points at a Confluent
+ * Cloud-hosted Schema Registry that exposes the `/catalog/v1/` Stream Catalog
+ * endpoints. Requires three signals together:
+ *   - a `schema_registry` block, AND
+ *   - `auth.type === "api_key"` on that block, AND
+ *   - a `confluent_cloud` block (Cloud control-plane creds).
+ *
+ * The `confluent_cloud` block is required because `auth.type === "api_key"` is
+ * ambiguous on its own: a self-managed Confluent Platform deployment with HTTP
+ * Basic Auth in front of its SR also models as `auth.type === "api_key"` in
+ * the YAML schema, even though that SR does not serve `/catalog/v1/`. Without
+ * the `confluent_cloud` requirement, this predicate would over-enable Stream
+ * Catalog tools on CP deployments and they would 404 at runtime.
  */
 export declare function hasCCloudCatalogSupport(conn: ConnectionConfig): PredicateResult;
 /**
@@ -126,12 +134,53 @@ export declare const kafkaRestWithAuthOrOAuth: ConnectionPredicate;
  * `environment_id`).
  */
 export declare const hasSchemaRegistryOrOAuth: ConnectionPredicate;
+/**
+ * The Stream Catalog gate, widened to admit OAuth. Direct connections still
+ * need a CCloud-hosted Schema Registry (the `schema_registry` block with
+ * `api_key` auth plus a `confluent_cloud` block — see
+ * {@linkcode hasCCloudCatalogSupport}); OAuth connections satisfy it
+ * unconditionally because under OAuth the Schema Registry is always
+ * CCloud-hosted and the SR cluster + endpoint are auto-resolved at call time
+ * from `environment_id`. Use on the catalog/tag/search handlers.
+ */
+export declare const hasCCloudCatalogOrOAuth: ConnectionPredicate;
+/**
+ * The Telemetry gate, widened to admit OAuth. Direct connections still need a
+ * `telemetry` block; OAuth connections satisfy it unconditionally — the
+ * Telemetry REST base URL is derived from the Auth0 environment
+ * (`getTelemetryRestUrlForEnv`) and the surface is cloud-wide (no per-cluster
+ * or per-environment routing). Use on the metrics handlers (`query-metrics`,
+ * `list-metrics`).
+ */
+export declare const hasTelemetryOrOAuth: ConnectionPredicate;
+/**
+ * The Tableflow gate, widened to admit OAuth. Direct connections still need a
+ * `tableflow` block; OAuth connections satisfy it unconditionally — the
+ * Tableflow REST base URL reuses the cloud control-plane URL derived from the
+ * Auth0 environment, and the surface rides the control-plane token. The
+ * environment/cluster IDs a Tableflow call needs are supplied as explicit tool
+ * arguments under OAuth (an OAuth connection carries no `kafka` block to fall
+ * back to). Use on the Tableflow topic/catalog/region handlers.
+ */
+export declare const hasTableflowOrOAuth: ConnectionPredicate;
+/**
+ * The Flink gate, widened to admit OAuth. Direct connections still need a
+ * `flink` block; OAuth connections satisfy it unconditionally — the Flink REST
+ * host is regional and resolved at call time from the compute pool's
+ * `cloud`/`region` (`getFlinkRestClient`), and the surface rides the
+ * data-plane token. The organization/environment/compute-pool IDs a Flink call
+ * needs are supplied as explicit tool arguments under OAuth (an OAuth
+ * connection carries no `flink` block to fall back to). Used as the
+ * `FlinkToolHandler` domain-base predicate, so it gates every Flink handler —
+ * statement, catalog, and diagnostics.
+ */
+export declare const hasFlinkOrOAuth: ConnectionPredicate;
 /**
  * Gate for tools that create connectors against the direct Confluent Cloud
  * REST surface: requires both a `confluent_cloud` block (the `/connect/v1`
  * endpoint) and `kafka.auth` (the connector spec carries kafka API
  * credentials). Strict-direct — OAuth connections answer `OAuthNotDirectCapable`
- * because the handler calls `getSoleDirectConnection()`.
+ * because the handler calls `resolveDirectConnection()`.
  */
 export declare const canCreateDirectConnector: ConnectionPredicate;
 /**
@@ -140,16 +189,35 @@ export declare const canCreateDirectConnector: ConnectionPredicate;
  * `telemetry` block (to query the metrics API).
  */
 export declare const flinkWithTelemetry: ConnectionPredicate;
+/**
+ * The Flink-statement-profiling gate ({@linkcode flinkWithTelemetry}), widened
+ * to admit OAuth. Direct connections still need both the `flink` and
+ * `telemetry` blocks; OAuth connections satisfy it unconditionally — the Flink
+ * REST surface resolves its regional host at call time and the telemetry
+ * surface is already OAuth-wired (cloud-wide, data-plane token). Use on
+ * `get-flink-statement-profile`.
+ */
+export declare const flinkWithTelemetryOrOAuth: ConnectionPredicate;
 /**
  * Every reason a {@linkcode ConnectionPredicate} can return `enabled: false`.
  * The symbol is the wire-stable identifier (referenced from predicate bodies
  * and tests); the value is the human-readable phrasing surfaced to end users
  * through startup logs and diagnostic tooling.
  *
- * Adding a reason: name the symbol after what's missing from the connection
- * config (not which predicate emitted it — multiple predicates may share a
- * reason), and write the value as a declarative phrase a misconfigured user
- * could act on.
+ * Adding a reason: name the symbol after the condition it describes — what's
+ * missing from the connection config, or the policy it violates (not which
+ * predicate or overlay emitted it — multiple sites may share a reason). Write
+ * the value as a declarative phrase a misconfigured user could act on. Most
+ * reasons originate in a predicate body; three are exceptions, produced
+ * outside any predicate because they describe a condition no per-connection
+ * check can see: {@linkcode ReadOnlyConnection} (the read-only verdict overlay in
+ * `BaseToolHandler`, composing a tool's mutation posture with the connection's
+ * `read_only` flag), {@linkcode NoConnectionsConfigured} (assigned by
+ * `buildToolGatingReport` when there are no connections at all, so no
+ * connection-dependent tool has any verdict to report), and
+ * {@linkcode OperatorBlocked} (assigned by `buildToolGatingReport` when the
+ * operator's server-wide allow/block-list excludes a tool, ahead of and
+ * independent of any per-connection check).
  */
 export declare enum ToolDisabledReason {
     MissingKafkaBlock = "no 'kafka' block in connection config",
@@ -163,6 +231,9 @@ export declare enum ToolDisabledReason {
     MissingTelemetryBlock = "no 'telemetry' block in connection config",
     MissingTableflowBlock = "no 'tableflow' block in connection config",
     OAuthNoServiceBlocks = "OAuth connections carry no service blocks",
-    OAuthNotDirectCapable = "OAuth connection cannot satisfy a direct-only requirement"
+    OAuthNotDirectCapable = "OAuth connection cannot satisfy a direct-only requirement",
+    ReadOnlyConnection = "connection is marked read_only; tools that mutate state are disabled",
+    NoConnectionsConfigured = "no connections are configured",
+    OperatorBlocked = "excluded by the operator's allow/block-list"
 }
 //# sourceMappingURL=connection-predicates.d.ts.map

package/dist/confluent/tools/connection-predicates.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"connection-predicates.d.ts","sourceRoot":"","sources":["../../../src/confluent/tools/connection-predicates.ts"],"names":[],"mappings":"AA6BA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9D;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GACvB;IAAE,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAA;CAAE,GAC1B;IAAE,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAA;CAAE,CAAC;AAErE,MAAM,MAAM,mBAAmB,GAAG,CAAC,IAAI,EAAE,gBAAgB,KAAK,eAAe,CAAC;AAE9E,eAAO,MAAM,OAAO,EAAE,eAAmC,CAAC;AAM1D;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,gBAAgB,GAAG,eAAe,CAMhE;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,gBAAgB,GAAG,eAAe,CASzE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,gBAAgB,GAAG,eAAe,CAQpE;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,gBAAgB,GAAG,eAAe,CAW5E;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,gBAAgB,GAAG,eAAe,CAOzE;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,wBAAwB,EAAE,mBACL,CAAC;AAEnC;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,gBAAgB,GAAG,eAAe,CAOzE;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,gBAAgB,GAAG,eAAe,CAMhE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,gBAAgB,GAAG,eAAe,CAMpE;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,gBAAgB,GAAG,eAAe,CAMpE;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,gBAAgB,GACrB,eAAe,CAUjB;AAED;;;;GAIG;AACH,eAAO,MAAM,aAAa,EAAE,mBAAmC,CAAC;AAEhE;;;;;;;;;;GAUG;AACH,wBAAgB,KAAK,CACnB,GAAG,UAAU,EAAE,mBAAmB,EAAE,GACnC,mBAAmB,CAQrB;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,SAAS,EAAE,mBAAmB,GAC7B,mBAAmB,CAErB;AAED;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,EAAE,mBACF,CAAC;AAEnC;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB,EAAE,mBACF,CAAC;AAEtC;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,EAAE,mBACL,CAAC;AAEnC;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB,EAAE,mBAGtC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,EAAE,mBAGhC,CAAC;AAEF;;;;;;;;;;GAUG;AACH,oBAAY,kBAAkB;IAC5B,iBAAiB,0CAA0C;IAC3D,qBAAqB,0DAA0D;IAC/E,gBAAgB,6CAA6C;IAC7D,wBAAwB,sDAAsD;IAC9E,0BAA0B,oDAAoD;IAC9E,+BAA+B,yEAAyE;IACxG,0BAA0B,oDAAoD;IAC9E,iBAAiB,0CAA0C;IAC3D,qBAAqB,8CAA8C;IACnE,qBAAqB,8CAA8C;IACnE,oBAAoB,8CAA8C;IAClE,qBAAqB,8DAA8D;CACpF"}
+{"version":3,"file":"connection-predicates.d.ts","sourceRoot":"","sources":["../../../src/confluent/tools/connection-predicates.ts"],"names":[],"mappings":"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"}

package/dist/confluent/tools/connection-predicates.js

@@ -110,7 +110,7 @@ export const hasConfluentCloudOrOAuth = widenForOAuth(hasConfluentCloud);
 /**
  * Block-level — verdict that holds only for direct connections carrying a
  * `confluent_cloud` block. Use this on handlers that are not yet OAuth-capable
- * and call `getSoleDirectConnection()` inside `handle()`. Once a handler
+ * and call `resolveDirectConnection()` inside `handle()`. Once a handler
  * widens to OAuth, switch its predicate to
  * {@linkcode hasConfluentCloudOrOAuth}.
  */
@@ -154,11 +154,19 @@ export function hasTableflow(conn) {
     return ENABLED;
 }
 /**
- * Field-level — verdict that holds when the `schema_registry` block is
- * present and its `auth` field is `api_key`-typed. That combination is the
- * reliable signal that the SR is CCloud-hosted and therefore exposes the
- * `/catalog/v1/` endpoints. A vanilla CP SR has no auth, so it disables
- * even when the `schema_registry` block itself is present.
+ * Field-level — verdict that holds when the connection points at a Confluent
+ * Cloud-hosted Schema Registry that exposes the `/catalog/v1/` Stream Catalog
+ * endpoints. Requires three signals together:
+ *   - a `schema_registry` block, AND
+ *   - `auth.type === "api_key"` on that block, AND
+ *   - a `confluent_cloud` block (Cloud control-plane creds).
+ *
+ * The `confluent_cloud` block is required because `auth.type === "api_key"` is
+ * ambiguous on its own: a self-managed Confluent Platform deployment with HTTP
+ * Basic Auth in front of its SR also models as `auth.type === "api_key"` in
+ * the YAML schema, even though that SR does not serve `/catalog/v1/`. Without
+ * the `confluent_cloud` requirement, this predicate would over-enable Stream
+ * Catalog tools on CP deployments and they would 404 at runtime.
  */
 export function hasCCloudCatalogSupport(conn) {
     if (conn.type === "oauth")
@@ -169,6 +177,9 @@ export function hasCCloudCatalogSupport(conn) {
     if (conn.schema_registry.auth?.type !== "api_key") {
         return disabled(ToolDisabledReason.MissingSchemaRegistryApiKeyAuth);
     }
+    if (conn.confluent_cloud === undefined) {
+        return disabled(ToolDisabledReason.MissingConfluentCloudBlock);
+    }
     return ENABLED;
 }
 /**
@@ -230,12 +241,53 @@ export const kafkaRestWithAuthOrOAuth = widenForOAuth(hasKafkaRestWithAuth);
  * `environment_id`).
  */
 export const hasSchemaRegistryOrOAuth = widenForOAuth(hasSchemaRegistry);
+/**
+ * The Stream Catalog gate, widened to admit OAuth. Direct connections still
+ * need a CCloud-hosted Schema Registry (the `schema_registry` block with
+ * `api_key` auth plus a `confluent_cloud` block — see
+ * {@linkcode hasCCloudCatalogSupport}); OAuth connections satisfy it
+ * unconditionally because under OAuth the Schema Registry is always
+ * CCloud-hosted and the SR cluster + endpoint are auto-resolved at call time
+ * from `environment_id`. Use on the catalog/tag/search handlers.
+ */
+export const hasCCloudCatalogOrOAuth = widenForOAuth(hasCCloudCatalogSupport);
+/**
+ * The Telemetry gate, widened to admit OAuth. Direct connections still need a
+ * `telemetry` block; OAuth connections satisfy it unconditionally — the
+ * Telemetry REST base URL is derived from the Auth0 environment
+ * (`getTelemetryRestUrlForEnv`) and the surface is cloud-wide (no per-cluster
+ * or per-environment routing). Use on the metrics handlers (`query-metrics`,
+ * `list-metrics`).
+ */
+export const hasTelemetryOrOAuth = widenForOAuth(hasTelemetry);
+/**
+ * The Tableflow gate, widened to admit OAuth. Direct connections still need a
+ * `tableflow` block; OAuth connections satisfy it unconditionally — the
+ * Tableflow REST base URL reuses the cloud control-plane URL derived from the
+ * Auth0 environment, and the surface rides the control-plane token. The
+ * environment/cluster IDs a Tableflow call needs are supplied as explicit tool
+ * arguments under OAuth (an OAuth connection carries no `kafka` block to fall
+ * back to). Use on the Tableflow topic/catalog/region handlers.
+ */
+export const hasTableflowOrOAuth = widenForOAuth(hasTableflow);
+/**
+ * The Flink gate, widened to admit OAuth. Direct connections still need a
+ * `flink` block; OAuth connections satisfy it unconditionally — the Flink REST
+ * host is regional and resolved at call time from the compute pool's
+ * `cloud`/`region` (`getFlinkRestClient`), and the surface rides the
+ * data-plane token. The organization/environment/compute-pool IDs a Flink call
+ * needs are supplied as explicit tool arguments under OAuth (an OAuth
+ * connection carries no `flink` block to fall back to). Used as the
+ * `FlinkToolHandler` domain-base predicate, so it gates every Flink handler —
+ * statement, catalog, and diagnostics.
+ */
+export const hasFlinkOrOAuth = widenForOAuth(hasFlink);
 /**
  * Gate for tools that create connectors against the direct Confluent Cloud
  * REST surface: requires both a `confluent_cloud` block (the `/connect/v1`
  * endpoint) and `kafka.auth` (the connector spec carries kafka API
  * credentials). Strict-direct — OAuth connections answer `OAuthNotDirectCapable`
- * because the handler calls `getSoleDirectConnection()`.
+ * because the handler calls `resolveDirectConnection()`.
  */
 export const canCreateDirectConnector = allOf(hasConfluentCloud, hasKafkaAuth);
 /**
@@ -244,16 +296,35 @@ export const canCreateDirectConnector = allOf(hasConfluentCloud, hasKafkaAuth);
  * `telemetry` block (to query the metrics API).
  */
 export const flinkWithTelemetry = allOf(hasFlink, hasTelemetry);
+/**
+ * The Flink-statement-profiling gate ({@linkcode flinkWithTelemetry}), widened
+ * to admit OAuth. Direct connections still need both the `flink` and
+ * `telemetry` blocks; OAuth connections satisfy it unconditionally — the Flink
+ * REST surface resolves its regional host at call time and the telemetry
+ * surface is already OAuth-wired (cloud-wide, data-plane token). Use on
+ * `get-flink-statement-profile`.
+ */
+export const flinkWithTelemetryOrOAuth = widenForOAuth(flinkWithTelemetry);
 /**
  * Every reason a {@linkcode ConnectionPredicate} can return `enabled: false`.
  * The symbol is the wire-stable identifier (referenced from predicate bodies
  * and tests); the value is the human-readable phrasing surfaced to end users
  * through startup logs and diagnostic tooling.
  *
- * Adding a reason: name the symbol after what's missing from the connection
- * config (not which predicate emitted it — multiple predicates may share a
- * reason), and write the value as a declarative phrase a misconfigured user
- * could act on.
+ * Adding a reason: name the symbol after the condition it describes — what's
+ * missing from the connection config, or the policy it violates (not which
+ * predicate or overlay emitted it — multiple sites may share a reason). Write
+ * the value as a declarative phrase a misconfigured user could act on. Most
+ * reasons originate in a predicate body; three are exceptions, produced
+ * outside any predicate because they describe a condition no per-connection
+ * check can see: {@linkcode ReadOnlyConnection} (the read-only verdict overlay in
+ * `BaseToolHandler`, composing a tool's mutation posture with the connection's
+ * `read_only` flag), {@linkcode NoConnectionsConfigured} (assigned by
+ * `buildToolGatingReport` when there are no connections at all, so no
+ * connection-dependent tool has any verdict to report), and
+ * {@linkcode OperatorBlocked} (assigned by `buildToolGatingReport` when the
+ * operator's server-wide allow/block-list excludes a tool, ahead of and
+ * independent of any per-connection check).
  */
 export var ToolDisabledReason;
 (function (ToolDisabledReason) {
@@ -269,5 +340,8 @@ export var ToolDisabledReason;
     ToolDisabledReason["MissingTableflowBlock"] = "no 'tableflow' block in connection config";
     ToolDisabledReason["OAuthNoServiceBlocks"] = "OAuth connections carry no service blocks";
     ToolDisabledReason["OAuthNotDirectCapable"] = "OAuth connection cannot satisfy a direct-only requirement";
+    ToolDisabledReason["ReadOnlyConnection"] = "connection is marked read_only; tools that mutate state are disabled";
+    ToolDisabledReason["NoConnectionsConfigured"] = "no connections are configured";
+    ToolDisabledReason["OperatorBlocked"] = "excluded by the operator's allow/block-list";
 })(ToolDisabledReason || (ToolDisabledReason = {}));
 //# sourceMappingURL=connection-predicates.js.map

package/dist/confluent/tools/connection-predicates.js.map

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

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

@@ -1,9 +1,10 @@
 import { CallToolResult } from "../../../../confluent/schema.js";
-import { BaseToolHandler, ToolConfig } from "../../../../confluent/tools/base-tools.js";
+import { BaseToolHandler, ToolCategory, ToolConfig } from "../../../../confluent/tools/base-tools.js";
 import { ServerRuntime } from "../../../../server-runtime.js";
 export declare class ListBillingCostsHandler extends BaseToolHandler {
     handle(runtime: ServerRuntime, toolArguments: Record<string, unknown>): Promise<CallToolResult>;
     getToolConfig(): ToolConfig;
+    readonly category = ToolCategory.Billing;
     readonly predicate: import("../../../../confluent/tools/connection-predicates.js").ConnectionPredicate;
 }
 //# sourceMappingURL=list-billing-costs-handler.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"list-billing-costs-handler.d.ts","sourceRoot":"","sources":["../../../../../src/confluent/tools/handlers/billing/list-billing-costs-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;AA+DvD,qBAAa,uBAAwB,SAAQ,eAAe;IACpD,MAAM,CACV,OAAO,EAAE,aAAa,EACtB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACrC,OAAO,CAAC,cAAc,CAAC;IA+H1B,aAAa,IAAI,UAAU;IAS3B,QAAQ,CAAC,SAAS,8EAA4B;CAC/C"}
+{"version":3,"file":"list-billing-costs-handler.d.ts","sourceRoot":"","sources":["../../../../../src/confluent/tools/handlers/billing/list-billing-costs-handler.ts"],"names":[],"mappings":"AAAA,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;AAsHvD,qBAAa,uBAAwB,SAAQ,eAAe;IACpD,MAAM,CACV,OAAO,EAAE,aAAa,EACtB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACrC,OAAO,CAAC,cAAc,CAAC;IA+H1B,aAAa,IAAI,UAAU;IAS3B,QAAQ,CAAC,QAAQ,wBAAwB;IACzC,QAAQ,CAAC,SAAS,8EAA4B;CAC/C"}

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

@@ -1,10 +1,12 @@
-import { BaseToolHandler, READ_ONLY, } from "../../../../confluent/tools/base-tools.js";
+import { BaseToolHandler, READ_ONLY, ToolCategory, } from "../../../../confluent/tools/base-tools.js";
 import { hasConfluentCloudOrOAuth } from "../../../../confluent/tools/connection-predicates.js";
 import { ToolName } from "../../../../confluent/tools/tool-name.js";
 import { logger } from "../../../../logger.js";
 import { wrapAsPathBasedClient } from "openapi-fetch";
 import { z } from "zod";
-const listBillingCostsArguments = z.object({
+const BILLING_RANGE_MAX_DAYS = 31;
+const MS_PER_DAY = 86_400_000;
+const listBillingCostsObject = z.object({
     startDate: z
         .string()
         .regex(/^\d{4}-\d{2}-\d{2}$/, "Date must be in YYYY-MM-DD format")
@@ -25,6 +27,36 @@ const listBillingCostsArguments = z.object({
         .optional()
         .describe("Token for the next page of results"),
 });
+const listBillingCostsArguments = listBillingCostsObject
+    .refine(({ startDate, endDate }) => Number.isFinite(Date.parse(startDate)) &&
+    Number.isFinite(Date.parse(endDate)), {
+    error: (issue) => {
+        const { startDate, endDate } = issue.input;
+        const invalid = Number.isFinite(Date.parse(startDate))
+            ? `endDate=${endDate}`
+            : `startDate=${startDate}`;
+        return `Date must be a valid calendar date (got ${invalid}).`;
+    },
+    path: ["endDate"],
+})
+    .refine(({ startDate, endDate }) => Date.parse(endDate) >= Date.parse(startDate), {
+    error: (issue) => {
+        const { startDate, endDate } = issue.input;
+        return `endDate (${endDate}) must be on or after startDate (${startDate}).`;
+    },
+    path: ["endDate"],
+})
+    .refine(({ startDate, endDate }) => {
+    const diffDays = (Date.parse(endDate) - Date.parse(startDate)) / MS_PER_DAY;
+    return diffDays <= BILLING_RANGE_MAX_DAYS;
+}, {
+    error: (issue) => {
+        const { startDate, endDate } = issue.input;
+        const diffDays = (Date.parse(endDate) - Date.parse(startDate)) / MS_PER_DAY;
+        return `Date range must be ${BILLING_RANGE_MAX_DAYS} days or fewer (got ${diffDays} days). The CCloud billing API caps queries at ${BILLING_RANGE_MAX_DAYS} days.`;
+    },
+    path: ["endDate"],
+});
 /**
  * Schema for validating billing cost line items
  */
@@ -60,8 +92,8 @@ const billingCostsSchema = z.object({
 });
 export class ListBillingCostsHandler extends BaseToolHandler {
     async handle(runtime, toolArguments) {
-        const clientManager = runtime.clientManager;
         const { startDate, endDate, pageSize, pageToken } = listBillingCostsArguments.parse(toolArguments);
+        const { clientManager } = this.resolveConnection(runtime, toolArguments);
         try {
             const pathBasedClient = wrapAsPathBasedClient(clientManager.getConfluentCloudRestClient());
             const { data: response, error } = await pathBasedClient["/billing/v1/costs"].GET({
@@ -153,10 +185,11 @@ Pagination:${metadata.total_size ? `\n  Total Items: ${metadata.total_size}` : "
         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,
+            inputSchema: listBillingCostsObject.shape,
             annotations: READ_ONLY,
         };
     }
+    category = ToolCategory.Billing;
     predicate = hasConfluentCloudOrOAuth;
 }
 //# sourceMappingURL=list-billing-costs-handler.js.map

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

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

package/dist/confluent/tools/handlers/catalog/add-tags-to-topic.d.ts

@@ -1,10 +1,10 @@
 import { CallToolResult } from "../../../../confluent/schema.js";
-import { BaseToolHandler, ToolConfig } from "../../../../confluent/tools/base-tools.js";
-import { hasCCloudCatalogSupport } from "../../../../confluent/tools/connection-predicates.js";
+import { BaseToolHandler, ToolCategory, ToolConfig } from "../../../../confluent/tools/base-tools.js";
 import { ServerRuntime } from "../../../../server-runtime.js";
 export declare class AddTagToTopicHandler extends BaseToolHandler {
     handle(runtime: ServerRuntime, toolArguments: Record<string, unknown>): Promise<CallToolResult>;
     getToolConfig(): ToolConfig;
-    readonly predicate: typeof hasCCloudCatalogSupport;
+    readonly category = ToolCategory.Catalog;
+    readonly predicate: import("../../../../confluent/tools/connection-predicates.js").ConnectionPredicate;
 }
 //# sourceMappingURL=add-tags-to-topic.d.ts.map

package/dist/confluent/tools/handlers/catalog/add-tags-to-topic.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"add-tags-to-topic.d.ts","sourceRoot":"","sources":["../../../../../src/confluent/tools/handlers/catalog/add-tags-to-topic.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EACL,eAAe,EAEf,UAAU,EACX,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,uBAAuB,EAAE,MAAM,+CAA+C,CAAC;AAExF,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAqBvD,qBAAa,oBAAqB,SAAQ,eAAe;IACjD,MAAM,CACV,OAAO,EAAE,aAAa,EACtB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACrC,OAAO,CAAC,cAAc,CAAC;IAyB1B,aAAa,IAAI,UAAU;IAQ3B,QAAQ,CAAC,SAAS,iCAA2B;CAC9C"}
+{"version":3,"file":"add-tags-to-topic.d.ts","sourceRoot":"","sources":["../../../../../src/confluent/tools/handlers/catalog/add-tags-to-topic.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EACL,eAAe,EAEf,YAAY,EACZ,UAAU,EACX,MAAM,oCAAoC,CAAC;AAG5C,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AA2BvD,qBAAa,oBAAqB,SAAQ,eAAe;IACjD,MAAM,CACV,OAAO,EAAE,aAAa,EACtB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACrC,OAAO,CAAC,cAAc,CAAC;IA0B1B,aAAa,IAAI,UAAU;IAQ3B,QAAQ,CAAC,QAAQ,wBAAwB;IACzC,QAAQ,CAAC,SAAS,8EAA2B;CAC9C"}