@fluentcommerce/fluent-mcp-extn 0.7.3 → 0.7.4

package/README.md

@@ -50,7 +50,7 @@ The official `fluent mcp server` (bundled with Fluent CLI) covers core GraphQL a
 | Auto-paginated GraphQL (`graphql_queryAll`) | | Yes |
 | GraphQL planning helpers (`graphql_planOperation` / `graphql_buildQuery` / `graphql_generateFull`) | | Yes |
 | Batch mutations (`graphql_batchMutate`) | | Yes |
-| Batch ingestion (`batch.*`) | | Yes |
+| Batch ingestion (`batch_*`) | | Yes |
 | Batch payload planning (`batch_describePayload`) | | Yes |
 | Prometheus metrics (`metrics_query`) | | Yes |
 | Metrics health assessment (`metrics_healthCheck`) | | Yes |
@@ -295,6 +295,14 @@ npx @fluentcommerce/fluent-mcp-extn
 
 This starts the MCP stdio server process. In a plain terminal it appears idle because it is waiting for MCP JSON-RPC input from your IDE/agent.
 
+To run with **Streamable HTTP** transport instead of stdio:
+
+```bash
+FLUENT_MCP_TRANSPORT=http npx @fluentcommerce/fluent-mcp-extn
+```
+
+This starts an HTTP server (default port 3100, override with `FLUENT_MCP_HTTP_PORT`). Set `FLUENT_MCP_AUTH_TOKEN` to enable bearer token authentication. Useful for remote MCP clients or multi-agent setups where stdio is not practical.
+
 Or install as a project dependency:
 
 ```bash
@@ -419,7 +427,7 @@ Example:
 }
 ```
 
-Typical category values: `config`, `health`, `connection`, `event`, `metrics`, `workflow`, `plugin`, `graphql`, `batch`, `webhook`, `entity`, `setting`, `environment`, `test`, `cache`.
+Typical category values: `config`, `health`, `time`, `connection`, `event`, `metrics`, `workflow`, `plugin`, `graphql`, `batch`, `webhook`, `entity`, `setting`, `environment`, `test`, `cache`.
 
 This is a prompt-budget optimization, not an access-control boundary. It reduces what the MCP client discovers, but it does not block an explicit low-level `tools/call` if a caller already knows a hidden tool name.
 
@@ -538,7 +546,7 @@ Compare workflow versions across retailers:
 ```
 1. workflow_get { entityType: "ORDER", entitySubtype: "HD", profile: "STAGING/UK" }
 2. workflow_get { entityType: "ORDER", entitySubtype: "HD", profile: "STAGING/US" }
-3. workflow_diff { left: <uk-workflow>, right: <us-workflow> }
+3. workflow_diff { base: <uk-workflow>, target: <us-workflow> }
 ```
 
 ### Cache
@@ -1198,7 +1206,7 @@ See the [Getting Started](https://www.npmjs.com/package/@fluentcommerce/ai-skill
 ```bash
 git clone https://bitbucket.org/fluentcommerce/fluent-mcp-extn.git
 cd fluent-mcp-extn
-npm install && npm run build && npm test   # 524 unit tests across 23 test files
+npm install && npm run build && npm test   # 601 unit tests across 25 test files
 npm run dev                                # hot-reload via tsx
 ```
 

package/dist/graphql-query-tools.js

@@ -175,6 +175,27 @@ function analyzePaginationLimits(pagination, limits) {
         warning: `Auto-pagination may be truncated by the ${reasons.join(" and ")}. Narrow the query or raise the limit if you need a complete result.`,
     };
 }
+/**
+ * Count actual edges in the merged response data.
+ * Guards against SDK metadata bugs where totalRecords is computed
+ * as totalPages × pageSize instead of the true accumulated count.
+ */
+function countConnectionEdges(result) {
+    if (!result || typeof result !== "object")
+        return null;
+    const data = result.data;
+    if (!data || typeof data !== "object")
+        return null;
+    for (const val of Object.values(data)) {
+        if (!val || typeof val !== "object")
+            continue;
+        const connection = val;
+        if (Array.isArray(connection.edges)) {
+            return connection.edges.length;
+        }
+    }
+    return null;
+}
 // ---------------------------------------------------------------------------
 // Handlers
 // ---------------------------------------------------------------------------
@@ -217,7 +238,25 @@ export async function handleGraphQLQueryAll(args, ctx) {
         errorHandling: parsed.errorHandling,
     };
     const result = await client.graphqlPaginated(payload);
-    const pagination = result.extensions?.autoPagination ?? null;
+    const rawPagination = result.extensions?.autoPagination ?? null;
+    // Reconcile SDK metadata: the SDK may report totalRecords as
+    // totalPages × pageSize instead of the true accumulated count.
+    // Count the actual edges in the merged response to detect and fix this.
+    const actualEdgeCount = countConnectionEdges(result);
+    let pagination = rawPagination;
+    if (rawPagination &&
+        typeof rawPagination === "object" &&
+        actualEdgeCount !== null) {
+        const sdkTotal = rawPagination.totalRecords;
+        if (typeof sdkTotal === "number" && sdkTotal !== actualEdgeCount) {
+            const corrected = {
+                ...rawPagination,
+                totalRecords: actualEdgeCount,
+                _sdkReportedRecords: sdkTotal,
+            };
+            pagination = corrected;
+        }
+    }
     const paginationInfo = pagination && typeof pagination === "object"
         ? pagination
         : null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fluentcommerce/fluent-mcp-extn",
-  "version": "0.7.3",
+  "version": "0.7.4",
   "description": "[Experimental] MCP (Model Context Protocol) extension server for Fluent Commerce. Exposes event dispatch, transition actions, GraphQL execution, Prometheus metrics, batch ingestion, and webhook validation as MCP tools.",
   "type": "module",
   "main": "dist/index.js",
@@ -52,7 +52,7 @@
     "node": ">=20.0.0"
   },
   "dependencies": {
-    "@fluentcommerce/fc-connect-sdk": "^0.1.54",
+    "@fluentcommerce/fc-connect-sdk": "^0.1.55",
     "@modelcontextprotocol/sdk": "^1.27.1",
     "graphql": "^16.13.1",
     "zod": "^4.3.6"