@fluentcommerce/fluent-mcp-extn 0.7.0 → 0.7.2

package/dist/graphql-query-tools.js

@@ -2,12 +2,12 @@
  * GraphQL Query Execution Tools
  *
  * Four query/mutation execution tools:
- *   graphql.query        — execute a single GraphQL query or mutation
- *   graphql.queryAll     — execute with SDK auto-pagination
- *   graphql.batchMutate  — execute multiple mutations in a single aliased request
- *   graphql.introspect   — inspect the schema via introspection service
+ *   graphql_query        — execute a single GraphQL query or mutation
+ *   graphql_queryAll     — execute with SDK auto-pagination
+ *   graphql_batchMutate  — execute multiple mutations in a single aliased request
+ *   graphql_introspect   — inspect the schema via introspection service
  *
- * NOTE: graphql-schema-tools.ts handles graphql.listRoots/buildQuery/validate/generateFull.
+ * NOTE: graphql-schema-tools.ts handles graphql_listRoots/buildQuery/validate/generateFull.
  * This file handles the query execution tools.
  */
 import { z } from "zod";
@@ -58,7 +58,7 @@ export const GraphQLIntrospectInputSchema = z.object({
 // ---------------------------------------------------------------------------
 export const GRAPHQL_QUERY_TOOL_DEFINITIONS = [
     {
-        name: "graphql.query",
+        name: "graphql_query",
         description: "Execute a GraphQL query or mutation. Relay pagination: first/after with cursors on edges.",
         annotations: {
             title: "GraphQL Query",
@@ -69,8 +69,8 @@ export const GRAPHQL_QUERY_TOOL_DEFINITIONS = [
         },
     },
     {
-        name: "graphql.queryAll",
-        description: "Auto-paginated GraphQL query. Follows cursors, merges edges, deduplicates. Use instead of graphql.query when you need all records.",
+        name: "graphql_queryAll",
+        description: "Auto-paginated GraphQL query. Follows cursors, merges edges, deduplicates. Use instead of graphql_query when you need all records.",
         annotations: {
             title: "GraphQL Query All",
             readOnlyHint: true,
@@ -80,7 +80,7 @@ export const GRAPHQL_QUERY_TOOL_DEFINITIONS = [
         },
     },
     {
-        name: "graphql.batchMutate",
+        name: "graphql_batchMutate",
         description: "Execute up to 50 mutations in one aliased request. Provide mutation name, inputs array, and returnFields.",
         annotations: {
             title: "GraphQL Batch Mutate",
@@ -91,7 +91,7 @@ export const GRAPHQL_QUERY_TOOL_DEFINITIONS = [
         },
     },
     {
-        name: "graphql.introspect",
+        name: "graphql_introspect",
         description: "Inspect GraphQL schema. Modes: type, mutation, listMutations, listQueries. Cached 24h, force=true to refresh.",
         annotations: {
             title: "Introspect Schema",
@@ -143,7 +143,7 @@ function introspectCacheKey(input) {
 }
 function requireClient(ctx) {
     if (!ctx.client) {
-        throw new ToolError("CONFIG_ERROR", "SDK client is not available. Run config.validate and fix auth/base URL.");
+        throw new ToolError("CONFIG_ERROR", "SDK client is not available. Run config_validate and fix auth/base URL.");
     }
     return ctx.client;
 }
@@ -151,7 +151,7 @@ function requireClient(ctx) {
 // Handlers
 // ---------------------------------------------------------------------------
 /**
- * Handle graphql.query tool call.
+ * Handle graphql_query tool call.
  */
 export async function handleGraphQLQuery(args, ctx) {
     const client = requireClient(ctx);
@@ -171,7 +171,7 @@ export async function handleGraphQLQuery(args, ctx) {
     return { ok: true, response: result };
 }
 /**
- * Handle graphql.queryAll tool call.
+ * Handle graphql_queryAll tool call.
  */
 export async function handleGraphQLQueryAll(args, ctx) {
     const client = requireClient(ctx);
@@ -199,7 +199,7 @@ export async function handleGraphQLQueryAll(args, ctx) {
     return { ok: true, response: result, pagination };
 }
 /**
- * Handle graphql.batchMutate tool call.
+ * Handle graphql_batchMutate tool call.
  */
 export async function handleGraphQLBatchMutate(args, ctx) {
     const client = requireClient(ctx);
@@ -249,7 +249,7 @@ export async function handleGraphQLBatchMutate(args, ctx) {
     };
 }
 /**
- * Handle graphql.introspect tool call.
+ * Handle graphql_introspect tool call.
  */
 export async function handleGraphQLIntrospect(args, ctx) {
     const client = requireClient(ctx);

package/dist/graphql-schema-tools.js

@@ -2,10 +2,10 @@
  * GraphQL Schema Tools
  *
  * Four schema-aware tools that close the gap with the official MCP server:
- *   graphql.listRoots    — list query & mutation root fields
- *   graphql.buildQuery   — generate a query/mutation string from structured inputs
- *   graphql.validate     — validate a GraphQL document against the live schema
- *   graphql.generateFull — generate a maximal-selection query for a root field
+ *   graphql_listRoots    — list query & mutation root fields
+ *   graphql_buildQuery   — generate a query/mutation string from structured inputs
+ *   graphql_validate     — validate a GraphQL document against the live schema
+ *   graphql_generateFull — generate a maximal-selection query for a root field
  *
  * All tools share a single SchemaService instance (cached, with force-refresh).
  */
@@ -346,7 +346,7 @@ function getSchemaService(ctx) {
 // ---------------------------------------------------------------------------
 export const GRAPHQL_SCHEMA_TOOL_DEFINITIONS = [
     {
-        name: "graphql.listRoots",
+        name: "graphql_listRoots",
         description: "List all query and mutation root fields from the live schema.",
         annotations: {
             title: "List Schema Roots",
@@ -357,7 +357,7 @@ export const GRAPHQL_SCHEMA_TOOL_DEFINITIONS = [
         },
     },
     {
-        name: "graphql.planOperation",
+        name: "graphql_planOperation",
         description: "Inspect a query/mutation root field and return required args, nested input shape, variables template, and a ready-to-run document scaffold. Use when the model is unsure which inputs are mandatory.",
         annotations: {
             title: "Plan GraphQL Operation",
@@ -368,7 +368,7 @@ export const GRAPHQL_SCHEMA_TOOL_DEFINITIONS = [
         },
     },
     {
-        name: "graphql.buildQuery",
+        name: "graphql_buildQuery",
         description: "Generate a GraphQL query/mutation from { rootField, fields, args }. Auto-validates against live schema.",
         annotations: {
             title: "Build GraphQL Query",
@@ -379,7 +379,7 @@ export const GRAPHQL_SCHEMA_TOOL_DEFINITIONS = [
         },
     },
     {
-        name: "graphql.validate",
+        name: "graphql_validate",
         description: "Validate a GraphQL document against the live schema. Returns OK or validation errors.",
         annotations: {
             title: "Validate GraphQL",
@@ -390,7 +390,7 @@ export const GRAPHQL_SCHEMA_TOOL_DEFINITIONS = [
         },
     },
     {
-        name: "graphql.generateFull",
+        name: "graphql_generateFull",
         description: "Generate a maximal-field query for a root field with recursive introspection (depth 1-5, default 2).",
         annotations: {
             title: "Generate Full Query",
@@ -434,7 +434,7 @@ export async function handlePlanOperation(args, ctx) {
     }
     const field = rootType.getFields()[parsed.rootField];
     if (!field) {
-        throw new ToolError("VALIDATION_ERROR", `Root field '${parsed.rootField}' not found. Use graphql.listRoots to discover available fields.`);
+        throw new ToolError("VALIDATION_ERROR", `Root field '${parsed.rootField}' not found. Use graphql_listRoots to discover available fields.`);
     }
     const argPlans = (field.args ?? []).map((arg) => {
         const described = describeInputField(schema, arg.type, arg.name);
@@ -466,8 +466,8 @@ export async function handlePlanOperation(args, ctx) {
         variablesTemplate,
         selectionTemplate: includeSelectionSet ? selectionLines : [],
         recommendedExecutionTool: parsed.kind === "query" && selectionLines.some((line) => line.startsWith("edges {"))
-            ? "graphql.queryAll"
-            : "graphql.query",
+            ? "graphql_queryAll"
+            : "graphql_query",
         document,
     };
 }
@@ -538,7 +538,7 @@ export async function handleGenerateFull(args, ctx) {
     }
     const field = rootType.getFields()[parsed.rootField];
     if (!field) {
-        throw new ToolError("VALIDATION_ERROR", `Root field '${parsed.rootField}' not found. Use graphql.listRoots to discover available fields.`);
+        throw new ToolError("VALIDATION_ERROR", `Root field '${parsed.rootField}' not found. Use graphql_listRoots to discover available fields.`);
     }
     const returnTypeName = unwrapNamed(field.type).name;
     const selection = buildMaxSelection(schema, returnTypeName, parsed.depth);
@@ -548,7 +548,7 @@ export async function handleGenerateFull(args, ctx) {
 }
 /**
  * Force-clear the schema cache for the current client.
- * Exposed for use by graphql.introspect's force param.
+ * Exposed for use by graphql_introspect's force param.
  */
 export function clearSchemaCache(ctx) {
     if (!ctx.client)

package/dist/metrics-tools.js

@@ -1,6 +1,6 @@
 /**
- * Metrics tools: metrics.query, metrics.topEvents, metrics.healthCheck,
- * metrics.sloReport, metrics.labelCatalog, metrics.catalog
+ * Metrics tools: metrics_query, metrics_topEvents, metrics_healthCheck,
+ * metrics_sloReport, metrics_labelCatalog, metrics.catalog
  *
  * Prometheus-backed observability plus Event API fallback for
  * health assessment, SLO reporting, label discovery, and metric planning.
@@ -151,52 +151,52 @@ export const MetricsMutationAuditInputSchema = z.object({
 // ---------------------------------------------------------------------------
 export const METRICS_TOOL_DEFINITIONS = [
     {
-        name: "metrics.query",
+        name: "metrics_query",
         description: "Query Prometheus metrics via GraphQL (instant or range). Requires METRICS_VIEW permission.",
         annotations: { title: "Query Metrics", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true },
     },
     {
-        name: "metrics.topEvents",
+        name: "metrics_topEvents",
         description: "Aggregate events by name+entityType+status in a time window. Returns top-N rankings.",
         annotations: { title: "Top Events", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true },
     },
     {
-        name: "metrics.healthCheck",
+        name: "metrics_healthCheck",
         description: "Single-call health assessment via Prometheus. Checks failure rate, NO_MATCH, PENDING, dominance. Falls back to Event API.",
         annotations: { title: "Health Check", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true },
     },
     {
-        name: "metrics.sloReport",
+        name: "metrics_sloReport",
         description: "SLO snapshot: event volume, failure/no-match/pending rates, p95 latency. Prometheus with Event API fallback.",
         annotations: { title: "SLO Report", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true },
     },
     {
-        name: "metrics.labelCatalog",
+        name: "metrics_labelCatalog",
         description: "Discover labels for a Prometheus metric with live sampling and known Fluent hints.",
         annotations: { title: "Label Catalog", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true },
     },
     {
-        name: "metrics.metricCatalog",
+        name: "metrics_metricCatalog",
         description: "List known Fluent metric families with labels, variants, and example PromQL. Can optionally probe live metric names and labels.",
         annotations: { title: "Metric Catalog", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true },
     },
     {
-        name: "metrics.planQuery",
-        description: "Plan PromQL for a metric family: validates labels, picks the right histogram variant, and returns a ready-to-run metrics.query payload.",
+        name: "metrics_planQuery",
+        description: "Plan PromQL for a metric family: validates labels, picks the right histogram variant, and returns a ready-to-run metrics_query payload.",
         annotations: { title: "Plan Metric Query", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
     },
     {
-        name: "metrics.snapshot",
+        name: "metrics_snapshot",
         description: "Dashboard snapshot: runs parallel queries to show event volume, failure rates, breakdowns by entity type, avg latency, and p95 in one call. Uses delta pattern for accurate window counts.",
         annotations: { title: "Metrics Snapshot", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true },
     },
     {
-        name: "metrics.compare",
+        name: "metrics_compare",
         description: "Compare a metric across two adjacent time windows (e.g. last 30m vs preceding 30m). Returns current/previous values, absolute delta, and percentage change per group.",
         annotations: { title: "Compare Windows", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true },
     },
     {
-        name: "metrics.mutationAudit",
+        name: "metrics_mutationAudit",
         description: "Audit GraphQL create/update mutation traffic by domain and subdomain. Discovers mutations locally, counts each operation over a fixed window, and aggregates results.",
         annotations: { title: "Mutation Audit", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true },
     },
@@ -363,7 +363,7 @@ const KNOWN_METRIC_LABELS = {
         "env_tag",
         "environment",
     ],
-    "graphql.query": [
+    "graphql_query": [
         "account.name",
         "query.type",
         "field.name",
@@ -533,12 +533,12 @@ const KNOWN_METRIC_FAMILIES = {
         ],
         examples: [],
     },
-    "graphql.query": {
-        family: "graphql.query",
+    "graphql_query": {
+        family: "graphql_query",
         category: "graphql_micrometer",
         kind: "timer",
         description: "Micrometer timer for GraphQL field-level execution.",
-        labels: KNOWN_METRIC_LABELS["graphql.query"],
+        labels: KNOWN_METRIC_LABELS["graphql_query"],
         safeGroupBy: ["query.type", "field.name", "account.name"],
         queryable: false,
         notes: [
@@ -970,8 +970,8 @@ function summarizeKnownMetricFamily(family, includeExamples) {
 // parseWindowMs imported from ./time-window.js (single source of truth)
 /**
  * Fetch events from the Event API with pagination, then aggregate by
- * (name|entityType|status). Shared by metrics.topEvents and the
- * metrics.healthCheck Event API fallback path.
+ * (name|entityType|status). Shared by metrics_topEvents and the
+ * metrics_healthCheck Event API fallback path.
  */
 async function aggregateEventsFromApi(client, params) {
     const baseParams = {
@@ -1049,7 +1049,7 @@ function rankTopEvents(groups, totalEvents, topN) {
 // ---------------------------------------------------------------------------
 function requireClient(ctx) {
     if (!ctx.client) {
-        throw new ToolError("CONFIG_ERROR", "SDK client is not available. Run config.validate and fix auth/base URL.");
+        throw new ToolError("CONFIG_ERROR", "SDK client is not available. Run config_validate and fix auth/base URL.");
     }
     return ctx.client;
 }
@@ -1057,7 +1057,7 @@ function requireClient(ctx) {
 // Handlers
 // ---------------------------------------------------------------------------
 /**
- * Handle metrics.query tool call.
+ * Handle metrics_query tool call.
  */
 export async function handleMetricsQuery(args, ctx) {
     const parsed = MetricsQueryInputSchema.parse(args);
@@ -1081,7 +1081,7 @@ export async function handleMetricsQuery(args, ctx) {
     };
 }
 /**
- * Handle metrics.healthCheck tool call.
+ * Handle metrics_healthCheck tool call.
  */
 export async function handleMetricsHealthCheck(args, ctx) {
     const parsed = MetricsHealthCheckInputSchema.parse(args);
@@ -1212,7 +1212,7 @@ export async function handleMetricsHealthCheck(args, ctx) {
     // Build recommendations
     const recommendations = [];
     if (findings.some((f) => f.type === "HIGH_FAILURE_RATE")) {
-        recommendations.push("Run event.list({ eventStatus: \"FAILED\", from: \"<recent>\", count: 50 }) to identify failing events");
+        recommendations.push("Run event_list({ eventStatus: \"FAILED\", from: \"<recent>\", count: 50 }) to identify failing events");
         recommendations.push("Hand off to /fluent-trace for root cause analysis");
     }
     if (findings.some((f) => f.type === "NO_MATCH_PRESENT")) {
@@ -1243,7 +1243,7 @@ export async function handleMetricsHealthCheck(args, ctx) {
     };
 }
 /**
- * Handle metrics.sloReport tool call.
+ * Handle metrics_sloReport tool call.
  */
 export async function handleMetricsSloReport(args, ctx) {
     const parsed = MetricsSloReportInputSchema.parse(args);
@@ -1386,16 +1386,16 @@ export async function handleMetricsSloReport(args, ctx) {
     }
     const recommendations = [];
     if (findings.some((f) => f.type === "HIGH_FAILURE_RATE")) {
-        recommendations.push("Run metrics.topEvents with eventStatus=FAILED and investigate top failures via /fluent-trace.");
+        recommendations.push("Run metrics_topEvents with eventStatus=FAILED and investigate top failures via /fluent-trace.");
     }
     if (findings.some((f) => f.type === "HIGH_NO_MATCH_RATE")) {
         recommendations.push("Validate event names against workflow rulesets using /fluent-workflow-analyzer.");
     }
     if (findings.some((f) => f.type === "HIGH_PENDING_RATE")) {
-        recommendations.push("Check orchestration backlog and re-run metrics.sloReport over shorter windows (e.g., 15m).");
+        recommendations.push("Check orchestration backlog and re-run metrics_sloReport over shorter windows (e.g., 15m).");
     }
     if (findings.some((f) => f.type === "HIGH_RUNTIME_P95" || f.type === "HIGH_INFLIGHT_P95")) {
-        recommendations.push("Use metrics.query to break down latency by event_name/entity_type and isolate slow workflows.");
+        recommendations.push("Use metrics_query to break down latency by event_name/entity_type and isolate slow workflows.");
     }
     return {
         ok: true,
@@ -1433,7 +1433,7 @@ export async function handleMetricsSloReport(args, ctx) {
     };
 }
 /**
- * Handle metrics.labelCatalog tool call.
+ * Handle metrics_labelCatalog tool call.
  */
 export async function handleMetricsLabelCatalog(args, ctx) {
     const parsed = MetricsLabelCatalogInputSchema.parse(args);
@@ -1449,7 +1449,7 @@ export async function handleMetricsLabelCatalog(args, ctx) {
     let sampled = null;
     const warnings = [];
     if (!sampling.queryable) {
-        warnings.push("This documented metric is a Micrometer meter name, not a guaranteed Prometheus family. Use metrics.metricCatalog with includeLiveMetrics=true to inspect exported metric names first.");
+        warnings.push("This documented metric is a Micrometer meter name, not a guaranteed Prometheus family. Use metrics_metricCatalog with includeLiveMetrics=true to inspect exported metric names first.");
     }
     else {
         sampled = await sampleMetricLabels(client, sampling.metrics, parsed.window, parsed.maxValuesPerLabel, knownLabels);
@@ -1478,7 +1478,7 @@ export async function handleMetricsLabelCatalog(args, ctx) {
     };
 }
 /**
- * Handle metrics.metricCatalog tool call.
+ * Handle metrics_metricCatalog tool call.
  */
 export async function handleMetricsMetricCatalog(args, ctx) {
     const parsed = MetricsMetricCatalogInputSchema.parse(args);
@@ -1572,7 +1572,7 @@ export async function handleMetricsMetricCatalog(args, ctx) {
     };
 }
 /**
- * Handle metrics.planQuery tool call.
+ * Handle metrics_planQuery tool call.
  */
 export async function handleMetricsPlanQuery(args) {
     const parsed = MetricsPlanQueryInputSchema.parse(args);
@@ -1585,7 +1585,7 @@ export async function handleMetricsPlanQuery(args) {
             metric: parsed.metric,
             warnings: [
                 "Metric is not in the built-in catalog.",
-                "Use metrics.metricCatalog with includeLiveMetrics=true to inspect live metric names before building PromQL.",
+                "Use metrics_metricCatalog with includeLiveMetrics=true to inspect live metric names before building PromQL.",
             ],
         };
     }
@@ -1761,7 +1761,7 @@ export async function handleMetricsPlanQuery(args) {
         query,
         recommendedQueryType: parsed.goal === "delta" || parsed.goal === "recency" || parsed.goal === "raw" ? "instant" : "instant",
         executeWith: {
-            tool: "metrics.query",
+            tool: "metrics_query",
             arguments: {
                 query,
                 type: "instant",
@@ -1772,7 +1772,7 @@ export async function handleMetricsPlanQuery(args) {
             recommendedStep: recommendStep(parseWindowMs(parsed.window)).step,
             estimatedPoints: recommendStep(parseWindowMs(parsed.window)).estimatedPoints,
             executeWith: {
-                tool: "metrics.query",
+                tool: "metrics_query",
                 arguments: {
                     query,
                     type: "range",
@@ -1785,14 +1785,14 @@ export async function handleMetricsPlanQuery(args) {
                 countAudit: {
                     ...countAudit,
                     resetAuditExecuteWith: {
-                        tool: "metrics.query",
+                        tool: "metrics_query",
                         arguments: {
                             query: countAudit.resetAuditQuery,
                             type: "instant",
                         },
                     },
                     comparisonExecuteWith: {
-                        tool: "metrics.query",
+                        tool: "metrics_query",
                         arguments: {
                             query: countAudit.comparisonQuery,
                             type: "instant",
@@ -1819,7 +1819,7 @@ export async function handleMetricsPlanQuery(args) {
     };
 }
 /**
- * Handle metrics.topEvents tool call.
+ * Handle metrics_topEvents tool call.
  */
 export async function handleMetricsTopEvents(args, ctx) {
     const parsed = MetricsTopEventsInputSchema.parse(args);
@@ -1852,7 +1852,7 @@ export async function handleMetricsTopEvents(args, ctx) {
     };
 }
 // ---------------------------------------------------------------------------
-// metrics.snapshot — compound dashboard in one call
+// metrics_snapshot — compound dashboard in one call
 // ---------------------------------------------------------------------------
 export async function handleMetricsSnapshot(args, ctx) {
     const parsed = MetricsSnapshotInputSchema.parse(args);
@@ -1981,7 +1981,7 @@ export async function handleMetricsSnapshot(args, ctx) {
     };
 }
 // ---------------------------------------------------------------------------
-// metrics.compare — compare two adjacent time windows
+// metrics_compare — compare two adjacent time windows
 // ---------------------------------------------------------------------------
 export async function handleMetricsCompare(args, ctx) {
     const parsed = MetricsCompareInputSchema.parse(args);
@@ -1993,7 +1993,7 @@ export async function handleMetricsCompare(args, ctx) {
             ok: true,
             valid: false,
             metric: parsed.metric,
-            error: { code: "UNKNOWN_METRIC", message: "Metric not in catalog or not queryable. Use metrics.metricCatalog to discover available metrics." },
+            error: { code: "UNKNOWN_METRIC", message: "Metric not in catalog or not queryable. Use metrics_metricCatalog to discover available metrics." },
         };
     }
     const family = resolved.family;

package/dist/profile-registry.js

@@ -2,12 +2,12 @@
  * Multi-profile registry for simultaneous Fluent Commerce environment access.
  *
  * Supports lazy client initialization, runtime profile management
- * (connection.add/remove/list/switch), and per-tool-call profile resolution
+ * (connection_add/remove/list/switch), and per-tool-call profile resolution
  * via the optional `profile` parameter on every tool.
  *
  * Profiles can be:
  * - Pre-loaded at startup via FLUENT_ADDITIONAL_PROFILES env var (comma-separated names)
- * - Added at runtime via the connection.add tool
+ * - Added at runtime via the connection_add tool
  */
 import { detectAuthStrategy, loadConfigForProfile, buildExplicitConfig, } from "./config.js";
 import { initSDKClient } from "./sdk-client.js";

package/dist/response-shaper.js

@@ -143,7 +143,7 @@ function deepShape(value, budget, stats) {
     // Object
     const obj = value;
     const keys = Object.keys(obj);
-    // Summarize large objects (e.g., plugin.list with 597 rule keys)
+    // Summarize large objects (e.g., plugin_list with 597 rule keys)
     if (keys.length > budget.maxArrayElements && !hasProtectedStructure(obj)) {
         return summarizeObject(obj, keys, budget.sampleSize, stats);
     }

package/dist/settings-tools.js

@@ -1,5 +1,5 @@
 /**
- * Settings management tools: setting.upsert, setting.bulkUpsert
+ * Settings management tools: setting_upsert, setting_bulkUpsert
  *
  * Closes the configuration loop — agents can create and update
  * settings that workflows depend on (webhook URLs, feature flags, thresholds).
@@ -84,7 +84,7 @@ export const SettingBulkUpsertInputSchema = z.object({
 // ---------------------------------------------------------------------------
 export const SETTING_TOOL_DEFINITIONS = [
     {
-        name: "setting.get",
+        name: "setting_get",
         description: [
             "Fetch settings by name (% wildcards supported). Use outputFile to save large values to disk.",
             "Use digest=true for structural summary instead of raw content (Mystique-aware).",
@@ -98,7 +98,7 @@ export const SETTING_TOOL_DEFINITIONS = [
         },
     },
     {
-        name: "setting.upsert",
+        name: "setting_upsert",
         description: "Create or update a setting. Use lobValue for large JSON. For fc.mystique.* settings, set valueType: \"JSON\".",
         annotations: {
             title: "Upsert Setting",
@@ -109,7 +109,7 @@ export const SETTING_TOOL_DEFINITIONS = [
         },
     },
     {
-        name: "setting.bulkUpsert",
+        name: "setting_bulkUpsert",
         description: "Batch upsert up to 50 settings in one call. Returns per-setting results.",
         annotations: {
             title: "Bulk Upsert Settings",
@@ -122,7 +122,7 @@ export const SETTING_TOOL_DEFINITIONS = [
 ];
 function requireSettingClient(ctx) {
     if (!ctx.client) {
-        throw new ToolError("CONFIG_ERROR", "SDK client is not available. Run config.validate and fix auth/base URL.");
+        throw new ToolError("CONFIG_ERROR", "SDK client is not available. Run config_validate and fix auth/base URL.");
     }
     return ctx.client;
 }
@@ -168,7 +168,7 @@ function isWildcardSettingName(name) {
 }
 function buildSettingGetCacheKey(input) {
     return [
-        "setting:get",
+        "setting_get",
         input.name,
         input.context ?? "_all",
         input.contextId !== undefined ? String(input.contextId) : "_all",
@@ -554,7 +554,7 @@ async function updateSetting(client, input) {
     return setting;
 }
 /**
- * Handle setting.get tool call.
+ * Handle setting_get tool call.
  * Fetches settings by name (with wildcard support) and optionally writes to file.
  */
 export async function handleSettingGet(args, ctx) {
@@ -615,7 +615,7 @@ export async function handleSettingGet(args, ctx) {
     return buildSettingGetResponse(parsed, settings, cacheable && ctx.cache ? { hit: false, stored: true } : undefined);
 }
 /**
- * Handle setting.upsert tool call.
+ * Handle setting_upsert tool call.
  */
 export async function handleSettingUpsert(args, ctx) {
     const parsed = SettingUpsertInputSchema.parse(args);
@@ -678,7 +678,7 @@ export async function handleSettingUpsert(args, ctx) {
     return result;
 }
 /**
- * Handle setting.bulkUpsert tool call.
+ * Handle setting_bulkUpsert tool call.
  */
 export async function handleSettingBulkUpsert(args, ctx) {
     const parsed = SettingBulkUpsertInputSchema.parse(args);

package/dist/test-tools.js

@@ -1,5 +1,5 @@
 /**
- * Test tools: test.assert
+ * Test tools: test_assert
  *
  * Entity state assertion with optional polling for agentic verify loops.
  */
@@ -67,7 +67,7 @@ export const TestAssertInputSchema = z.object({
 // ---------------------------------------------------------------------------
 export const TEST_TOOL_DEFINITIONS = [
     {
-        name: "test.assert",
+        name: "test_assert",
         description: "Assert entity state (status, type, attributes, edge counts). Set poll=true to retry until pass or timeout (for async state changes).",
         annotations: {
             title: "Assert Entity State",
@@ -224,7 +224,7 @@ function evaluateAssertions(entity, assertions) {
 }
 function requireTestClient(ctx) {
     if (!ctx.client) {
-        throw new ToolError("CONFIG_ERROR", "SDK client is not available. Run config.validate and fix auth/base URL.");
+        throw new ToolError("CONFIG_ERROR", "SDK client is not available. Run config_validate and fix auth/base URL.");
     }
     return ctx.client;
 }
@@ -253,7 +253,7 @@ function sleep(ms) {
     return new Promise((resolve) => setTimeout(resolve, ms));
 }
 /**
- * Handle test.assert tool call.
+ * Handle test_assert tool call.
  */
 export async function handleTestAssert(args, ctx) {
     const parsed = TestAssertInputSchema.parse(args);