@fluentcommerce/fluent-mcp-extn 0.7.0 → 0.7.3

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).
@@ -63,9 +63,9 @@ export const SettingGetInputSchema = z.object({
         .number()
         .int()
         .min(1)
-        .max(100)
-        .default(10)
-        .describe("Max results (default: 10, max: 100)."),
+        .max(500)
+        .default(25)
+        .describe("Max results per page (default: 25, max: 500). Auto-paginates wildcard queries using edge cursors."),
     digest: z
         .boolean()
         .default(false)
@@ -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",
@@ -320,7 +320,10 @@ function digestSetting(setting) {
         digest,
     };
 }
-function buildSettingGetResponse(parsed, settings, cacheMeta) {
+function buildSettingGetResponse(parsed, settings, cacheMeta, truncated = false) {
+    const truncationWarning = truncated
+        ? `Results truncated at ${settings.length} settings. More exist on the server. Use graphql_queryAll with a settings query to fetch all, or narrow your filter.`
+        : undefined;
     if (settings.length === 0) {
         return {
             ok: true,
@@ -370,6 +373,7 @@ function buildSettingGetResponse(parsed, settings, cacheMeta) {
             count: settings.length,
             savedTo: outputDir,
             files: savedFiles,
+            ...(truncationWarning ? { warning: truncationWarning } : {}),
             ...(cacheMeta ? { _cache: cacheMeta } : {}),
             settings: settings.map((s) => ({
                 id: s.id,
@@ -387,6 +391,7 @@ function buildSettingGetResponse(parsed, settings, cacheMeta) {
             ok: true,
             count: settings.length,
             digested: true,
+            ...(truncationWarning ? { warning: truncationWarning } : {}),
             ...(cacheMeta ? { _cache: cacheMeta } : {}),
             settings: settings.map((s) => digestSetting(s)),
         };
@@ -394,6 +399,7 @@ function buildSettingGetResponse(parsed, settings, cacheMeta) {
     return {
         ok: true,
         count: settings.length,
+        ...(truncationWarning ? { warning: truncationWarning } : {}),
         ...(cacheMeta ? { _cache: cacheMeta } : {}),
         settings: settings.map((s) => ({
             id: s.id,
@@ -554,7 +560,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) {
@@ -565,7 +571,7 @@ export async function handleSettingGet(args, ctx) {
     if (cacheable && ctx.cache) {
         const cached = await ctx.cache.get(cacheKey);
         if (cached.hit && Array.isArray(cached.data)) {
-            return buildSettingGetResponse(parsed, cached.data, { hit: true, ageMs: cached.ageMs ?? 0 });
+            return buildSettingGetResponse(parsed, cached.data, { hit: true, ageMs: cached.ageMs ?? 0 }, false);
         }
     }
     // Build variables — only include context/contextId if provided
@@ -585,10 +591,11 @@ export async function handleSettingGet(args, ctx) {
     else if (parsed.context === "ACCOUNT") {
         variables.contextId = [0];
     }
-    // Build query — include lobValue for full content
-    const query = `query GetSettings($name: [String!], $context: [String!], $contextId: [Int!], $first: Int) {
-  settings(name: $name, context: $context, contextId: $contextId, first: $first) {
+    // Build query — edge cursors for Fluent-style pagination
+    const query = `query GetSettings($name: [String!], $context: [String!], $contextId: [Int!], $first: Int, $after: String) {
+  settings(name: $name, context: $context, contextId: $contextId, first: $first, after: $after) {
     edges {
+      cursor
       node {
         id
         name
@@ -599,23 +606,52 @@ export async function handleSettingGet(args, ctx) {
         valueType
       }
     }
+    pageInfo {
+      hasNextPage
+    }
   }
 }`;
-    const response = await client.graphql({
-        query,
-        variables: variables,
-    });
-    const data = response?.data;
-    const connection = data?.settings;
-    const edges = (connection?.edges ?? []);
-    const settings = edges.map((e) => e.node);
+    // Auto-paginate wildcard queries using edge cursors; single-page for exact names
+    const MAX_TOTAL = 500;
+    const isWildcard = isWildcardSettingName(parsed.name);
+    const allSettings = [];
+    let cursor = null;
+    let hasNextPage = true;
+    while (hasNextPage && allSettings.length < MAX_TOTAL) {
+        const pageVars = { ...variables };
+        if (cursor)
+            pageVars.after = cursor;
+        const response = await client.graphql({
+            query,
+            variables: pageVars,
+        });
+        const data = response?.data;
+        const connection = data?.settings;
+        const edges = (connection?.edges ?? []);
+        const pageInfo = connection?.pageInfo;
+        for (const edge of edges) {
+            if (allSettings.length >= MAX_TOTAL)
+                break;
+            allSettings.push(edge.node);
+        }
+        hasNextPage = Boolean(pageInfo?.hasNextPage) && edges.length > 0;
+        // Fluent pagination: cursor lives on the edge, not in pageInfo
+        if (hasNextPage && edges.length > 0) {
+            cursor = edges[edges.length - 1].cursor ?? null;
+        }
+        // Non-wildcard: one page is enough
+        if (!isWildcard)
+            break;
+    }
+    const settings = allSettings;
+    const truncated = hasNextPage && allSettings.length >= MAX_TOTAL;
     if (cacheable && ctx.cache) {
         await ctx.cache.set(cacheKey, "setting", settings);
     }
-    return buildSettingGetResponse(parsed, settings, cacheable && ctx.cache ? { hit: false, stored: true } : undefined);
+    return buildSettingGetResponse(parsed, settings, cacheable && ctx.cache ? { hit: false, stored: true } : undefined, truncated);
 }
 /**
- * Handle setting.upsert tool call.
+ * Handle setting_upsert tool call.
  */
 export async function handleSettingUpsert(args, ctx) {
     const parsed = SettingUpsertInputSchema.parse(args);
@@ -678,7 +714,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);