@enfyra/mcp-server 0.0.103 → 0.0.104

package/README.md

@@ -186,7 +186,7 @@ The MCP server includes safety guards for LLM callers:
 - `validate_dynamic_script` checks handler, hook, flow, websocket, GraphQL, and bootstrap script source without saving.
 - `validate_extension_code` checks Enfyra admin extension code through `/enfyra_extension/preview` without saving.
 - `compiledCode` is generated from `sourceCode` and may differ textually because macros are expanded; the MCP server never accepts hand-written `compiledCode`.
-- JSON responses include `compressionStats` with estimated token savings for the columnar response format.
+- JSON responses include `compressionStats` with estimated token savings. Arrays of objects are converted to columnar form only when the compact shape is smaller than raw JSON.
 - Relation tools reject physical FK/junction names.
 - Generated code should use relation property names such as `conversation`, `sender`, and `member` instead of physical FK fields such as `conversationId`, `senderId`, or `memberId`.
 - Custom route tools reject `mainTableId` unless the route is the canonical table route.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@enfyra/mcp-server",
-  "version": "0.0.103",
+  "version": "0.0.104",
   "description": "MCP server for Enfyra - manage Enfyra instances from MCP-compatible coding tools",
   "type": "module",
   "license": "MIT",

package/src/lib/mcp-instructions.js

@@ -35,7 +35,7 @@ export function buildMcpServerInstructions(apiBaseUrl) {
     '- Validate behavior with `test_rest_endpoint`, `run_admin_test`, `test_flow_step`, or the route-specific tool before claiming a dynamic feature works.',
     '',
     '### Core Contracts',
-    '- Tool JSON responses use `responseFormat: "json+columnar-v1"`. Any array of objects is encoded as `{ format: "columnar-v1", columns: [...], rows: [[...]], rowCount }`; read each row value by matching `columns[index]` to `rows[n][index]`. Do not guess object keys inside `rows`. `compressionStats` estimates token savings from the compact response; use it only when the user asks about savings.',
+    '- Tool JSON responses use `responseFormat: "json+columnar-v1"`. Large arrays of objects may be encoded as `{ format: "columnar-v1", columns: [...], rows: [[...]], rowCount }` only when that is smaller than raw JSON; read each row value by matching `columns[index]` to `rows[n][index]`. Do not guess object keys inside `rows`. `compressionStats` estimates token savings and includes whether compression was applied; use it only when the user asks about savings.',
     '- `query_table` and `get_all_routes` require explicit intent: pass `limit` for bounded reads or `all: true` for a complete list. Do not invent arbitrary limits such as 30 or 50.',
     '- Read tools are minimal by default. Pass explicit `fields`; use metadata inspection before guessing field/relation names. Field exclusion mode exists: `fields=-compiledCode`, and `fields=id,-compiledCode` still means all readable fields except `compiledCode`.',
     '- Mutations return ids/status by default. Re-read with `find_one_record` or `query_table` and explicit `fields` when the saved row matters.',

package/src/lib/response-format.js

@@ -66,60 +66,73 @@ function estimateTokens(jsonText) {
   return Math.ceil(jsonText.length / 4);
 }
 
-function buildCompressionStats(originalPayload, compactPayload) {
+function buildCompressionStats(originalPayload, candidatePayload, selectedPayload, applied) {
   const originalTokens = estimateTokens(safeJsonStringify(originalPayload));
-  const compactTokens = estimateTokens(safeJsonStringify(compactPayload));
-  const savedTokens = originalTokens - compactTokens;
+  const candidateTokens = estimateTokens(safeJsonStringify(candidatePayload));
+  const responseTokens = estimateTokens(safeJsonStringify(selectedPayload));
+  const candidateSavedTokens = originalTokens - candidateTokens;
+  const candidateSavedPercent = originalTokens > 0
+    ? Number(((candidateSavedTokens / originalTokens) * 100).toFixed(2))
+    : 0;
+  const savedTokens = originalTokens - responseTokens;
   const savedPercent = originalTokens > 0
     ? Number(((savedTokens / originalTokens) * 100).toFixed(2))
     : 0;
   return {
     originalTokens,
-    compactTokens,
+    compactTokens: responseTokens,
     savedTokens,
     savedPercent,
+    applied,
+    candidateCompactTokens: candidateTokens,
+    candidateSavedTokens,
+    candidateSavedPercent,
   };
 }
 
-function attachCompressionStats(originalPayload, formattedPayload) {
+function attachCompressionStats(originalPayload, candidatePayload, selectedPayload, applied) {
   if (
-    isPlainObject(formattedPayload)
-    && formattedPayload.responseFormat === RESPONSE_FORMAT
-    && formattedPayload[COMPRESSION_STATS_FIELD]
+    isPlainObject(selectedPayload)
+    && selectedPayload.responseFormat === RESPONSE_FORMAT
+    && selectedPayload[COMPRESSION_STATS_FIELD]
   ) {
-    return formattedPayload;
+    return selectedPayload;
   }
-  if (!isPlainObject(formattedPayload)) {
-    const compactPayload = {
-      responseFormat: RESPONSE_FORMAT,
-      value: formattedPayload,
-    };
+  return {
+    ...selectedPayload,
+    [COMPRESSION_STATS_FIELD]: buildCompressionStats(originalPayload, candidatePayload, selectedPayload, applied),
+  };
+}
+
+function wrapPayload(payload) {
+  if (!isPlainObject(payload)) {
     return {
-      ...compactPayload,
-      [COMPRESSION_STATS_FIELD]: buildCompressionStats(originalPayload, compactPayload),
+      responseFormat: RESPONSE_FORMAT,
+      value: payload,
     };
   }
   return {
-    ...formattedPayload,
-    [COMPRESSION_STATS_FIELD]: buildCompressionStats(originalPayload, formattedPayload),
+    responseFormat: RESPONSE_FORMAT,
+    ...payload,
   };
 }
 
 export function formatJsonPayload(payload) {
-  const formatted = toColumnar(payload);
-  if (!isPlainObject(formatted)) {
-    return attachCompressionStats(payload, {
-      responseFormat: RESPONSE_FORMAT,
-      value: formatted,
-    });
-  }
-  if (formatted.responseFormat === RESPONSE_FORMAT) {
-    return attachCompressionStats(payload, formatted);
+  if (
+    isPlainObject(payload)
+    && payload.responseFormat === RESPONSE_FORMAT
+    && payload[COMPRESSION_STATS_FIELD]
+  ) {
+    return payload;
   }
-  return attachCompressionStats(payload, {
-    responseFormat: RESPONSE_FORMAT,
-    ...formatted,
-  });
+
+  const originalPayload = wrapPayload(payload);
+  const columnarPayload = wrapPayload(toColumnar(payload));
+  const originalTokens = estimateTokens(safeJsonStringify(originalPayload));
+  const candidateTokens = estimateTokens(safeJsonStringify(columnarPayload));
+  const shouldApplyColumnar = candidateTokens < originalTokens;
+  const selectedPayload = shouldApplyColumnar ? columnarPayload : originalPayload;
+  return attachCompressionStats(originalPayload, columnarPayload, selectedPayload, shouldApplyColumnar);
 }
 
 export function jsonContent(payload, { pretty = false } = {}) {