whale-code 6.5.5 → 6.5.7

package/dist/cli/services/format-server-response-formatters.js

@@ -0,0 +1,195 @@
+/**
+ * Server Response Formatter — Column priorities, formatters, and column selection
+ *
+ * Extracted from format-server-response.ts for maintainability.
+ */
+
+import { termWidth } from "../shared/markdown.js";
+
+// ============================================================================
+// COLUMN PRIORITIES — per tool category
+// ============================================================================
+
+export const PRIORITY_COLUMNS = {
+  analytics: ["name", "revenue", "quantity", "total", "count", "average", "period"],
+  products: ["name", "sku", "status", "category_name", "cost_price", "stock_quantity"],
+  inventory: ["product_name", "quantity", "location_name", "product_sku", "product_id"],
+  customers: ["first_name", "last_name", "email", "phone", "status", "loyalty_tier"],
+  orders: ["order_number", "status", "total", "customer_name", "created_at"],
+  supply_chain: ["name", "status", "quantity", "supplier", "location", "expected_delivery_date"],
+  workflows: ["name", "status", "trigger_type", "created_at", "last_run"],
+  email: ["subject", "to", "status", "sent_at", "category"],
+  locations: ["name", "city", "state", "type", "is_active", "address_line1"],
+  media: ["title", "file_name", "category", "tags", "file_type"],
+  creations: ["name", "creation_type", "status", "visibility", "slug"],
+  api_keys: ["name", "key_type", "is_active", "scopes"]
+};
+
+// Keys that are always deprioritized (shown last or hidden)
+export const LOW_PRIORITY_KEYS = new Set(["id", "store_id", "created_at", "updated_at", "deleted_at", "created_by", "updated_by", "metadata", "raw_data"]);
+
+// ============================================================================
+// FORMATTERS
+// ============================================================================
+
+export function truncateUuid(val) {
+  if (/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(val)) {
+    return val.slice(0, 8);
+  }
+  return val;
+}
+
+/** Keys whose values must never be truncated (file paths, URLs, IDs the LLM needs verbatim) */
+export const NEVER_TRUNCATE_KEYS = new Set(["id", "product_id", "category_id", "location_id", "supplier_id", "customer_id", "store_id", "order_id", "workflow_id", "schema_id", "field_schema_id", "pricing_schema_id", "transfer_id", "run_id", "step_id", "audit_id", "media_id", "creation_id", "job_id", "collection_id", "source_id", "thread_id", "form_id", "template_id", "webhook_id", "rule_id", "subscription_id", "span_id", "trace_id", "ad_id", "ad_set_id", "campaign_id", "audience_id", "pixel_id", "key_id", "catalog_id", "purchase_order_id", "primary_category_id", "parent_id", "from_location_id", "to_location_id", "local_file", "file_url", "file_path", "download", "url", "preview_url", "thumbnail_url", "audio_file", "stdout", "stderr", "command", "output"]);
+export function formatValue(val, key) {
+  if (val === null || val === undefined) return "\u2014";
+  if (typeof val === "boolean") return val ? "\u2713" : "\u2715";
+  if (typeof val === "number") {
+    if (key && isPercentageKey(key)) return `${val}%`;
+    return val.toLocaleString();
+  }
+  if (typeof val === "string") {
+    if (/^\d+\.\d{2}$/.test(val) && parseFloat(val) > 0) {
+      return `$${parseFloat(val).toLocaleString(undefined, {
+        minimumFractionDigits: 2
+      })}`;
+    }
+    if (key && NEVER_TRUNCATE_KEYS.has(key)) return val;
+    const truncated = truncateUuid(val);
+    if (/^\d{4}-\d{2}-\d{2}T/.test(val)) {
+      return val.slice(0, 10);
+    }
+    if (truncated.length > 200) return truncated.slice(0, 197) + "...";
+    return truncated;
+  }
+  if (Array.isArray(val)) {
+    if (val.length === 0) return "\u2014";
+    if (typeof val[0] === "object" && val[0] !== null) {
+      const names = val.slice(0, 3).map(v => {
+        const o = v;
+        return o.name || o.location_name || o.title || o.label;
+      }).filter(Boolean).map(String);
+      if (names.length > 0) {
+        return names.join(", ") + (val.length > 3 ? ` +${val.length - 3} more` : "");
+      }
+    }
+    return `[${val.length} items]`;
+  }
+  if (typeof val === "object") {
+    const obj = val;
+    if (typeof obj.name === "string") return obj.name;
+    if (typeof obj.title === "string") return obj.title;
+    if (typeof obj.label === "string") return obj.label;
+    if (typeof obj.id === "string") return obj.id;
+    return "{...}";
+  }
+  return String(val);
+}
+export function formatMoneyValue(val) {
+  if (typeof val === "number") {
+    return `$${val.toLocaleString(undefined, {
+      minimumFractionDigits: 2,
+      maximumFractionDigits: 2
+    })}`;
+  }
+  return formatValue(val);
+}
+export function isPercentageKey(key) {
+  return /percentage|_pct$|percent/i.test(key);
+}
+export function isMoneyKey(key) {
+  if (key === "total") return false;
+  if (/^total[_](stock|products|items|orders|units|count|quantity|customers|runs|pages|results|employees)/i.test(key)) return false;
+  return /price|cost|revenue|total_revenue|total_amount|amount|subtotal|tax|discount|budget/i.test(key);
+}
+export function prettifyKey(key) {
+  return key.replace(/_/g, " ").replace(/\bid\b/gi, "ID").replace(/\b\w/g, c => c.toUpperCase());
+}
+
+// ============================================================================
+// COLUMN SELECTION
+// ============================================================================
+
+export function selectColumns(rows, toolName) {
+  if (rows.length === 0) return [];
+  const allKeys = new Set();
+  for (const row of rows.slice(0, 5)) {
+    for (const key of Object.keys(row)) allKeys.add(key);
+  }
+  const tw = termWidth();
+  const maxCols = tw < 90 ? 4 : tw < 120 ? 6 : tw < 160 ? 8 : 10;
+  let priority = [];
+  if (toolName) {
+    for (const [category, cols] of Object.entries(PRIORITY_COLUMNS)) {
+      if (toolName.toLowerCase().includes(category)) {
+        priority = cols;
+        break;
+      }
+    }
+  }
+  const selected = [];
+  for (const col of priority) {
+    if (allKeys.has(col) && selected.length < maxCols) {
+      selected.push(col);
+    }
+  }
+  for (const key of allKeys) {
+    if (selected.length >= maxCols) break;
+    if (selected.includes(key)) continue;
+    if (LOW_PRIORITY_KEYS.has(key)) continue;
+    const sample = rows[0][key];
+    if (Array.isArray(sample)) continue;
+    if (typeof sample === "object" && sample !== null) continue;
+    selected.push(key);
+  }
+  return selected;
+}
+
+// ============================================================================
+// TABLE BUILDER
+// ============================================================================
+
+export function buildTable(rows, columns) {
+  if (columns.length === 0 || rows.length === 0) return "";
+  const headers = columns.map(prettifyKey);
+  const termW = termWidth();
+  const overhead = columns.length * 3 + 4;
+  const cellCap = Math.min(Math.max(Math.floor((termW - overhead) / columns.length), 15), 50);
+  const widths = columns.map((col, i) => {
+    let max = headers[i].length;
+    for (const row of rows) {
+      const val = isMoneyKey(col) ? formatMoneyValue(row[col]) : formatValue(row[col], col);
+      max = Math.max(max, val.length);
+    }
+    return Math.min(max, cellCap);
+  });
+  const headerRow = columns.map((_, i) => headers[i].padEnd(widths[i])).join(" | ");
+  const separator = widths.map(w => "-".repeat(w)).join(" | ");
+  const dataRows = rows.map(row => columns.map((col, i) => {
+    const val = isMoneyKey(col) ? formatMoneyValue(row[col]) : formatValue(row[col], col);
+    const isNum = typeof row[col] === "number" || isMoneyKey(col);
+    return isNum ? val.padStart(widths[i]) : val.padEnd(widths[i]);
+  }).join(" | "));
+  return [`| ${headerRow} |`, `| ${separator} |`, ...dataRows.map(r => `| ${r} |`)].join("\n");
+}
+
+// ============================================================================
+// ID REFERENCE — gives the LLM full UUIDs for follow-up calls
+// ============================================================================
+
+export function buildIdReference(rows) {
+  if (rows.length === 0) return "";
+  const idKey = ["id", "product_id", "customer_id", "order_id", "workflow_id"].find(k => rows.some(r => r[k] && typeof r[k] === "string"));
+  if (!idKey) return "";
+  const nameKey = ["name", "product_name", "first_name", "title", "subject", "label", "slug", "order_number"].find(k => rows[0][k] !== undefined) || null;
+  const entries = [];
+  for (const row of rows) {
+    const idVal = row[idKey];
+    if (!idVal || typeof idVal !== "string") continue;
+    const label = nameKey && row[nameKey] ? String(row[nameKey]) : String(idVal).slice(0, 8);
+    entries.push(`${label}=${idVal}`);
+  }
+  if (entries.length === 0) return "";
+  return `\nIDs: ${entries.join(", ")}`;
+}
+//# sourceMappingURL=format-server-response-formatters.js.map

package/dist/cli/services/format-server-response-formatters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-server-response-formatters.js","names":["termWidth","PRIORITY_COLUMNS","analytics","products","inventory","customers","orders","supply_chain","workflows","email","locations","media","creations","api_keys","LOW_PRIORITY_KEYS","Set","truncateUuid","val","test","slice","NEVER_TRUNCATE_KEYS","formatValue","key","undefined","isPercentageKey","toLocaleString","parseFloat","minimumFractionDigits","has","truncated","length","Array","isArray","names","map","v","o","name","location_name","title","label","filter","Boolean","String","join","obj","id","formatMoneyValue","maximumFractionDigits","isMoneyKey","prettifyKey","replace","c","toUpperCase","selectColumns","rows","toolName","allKeys","row","Object","keys","add","tw","maxCols","priority","category","cols","entries","toLowerCase","includes","selected","col","push","sample","buildTable","columns","headers","termW","overhead","cellCap","Math","min","max","floor","widths","i","headerRow","_","padEnd","separator","w","repeat","dataRows","isNum","padStart","r","buildIdReference","idKey","find","k","some","nameKey","idVal"],"sources":["../../../src/cli/services/format-server-response-formatters.ts"],"sourcesContent":["/**\n * Server Response Formatter — Column priorities, formatters, and column selection\n *\n * Extracted from format-server-response.ts for maintainability.\n */\n\nimport { termWidth } from \"../shared/markdown.js\";\n\n// ============================================================================\n// COLUMN PRIORITIES — per tool category\n// ============================================================================\n\nexport const PRIORITY_COLUMNS: Record<string, string[]> = {\n  analytics:    [\"name\", \"revenue\", \"quantity\", \"total\", \"count\", \"average\", \"period\"],\n  products:     [\"name\", \"sku\", \"status\", \"category_name\", \"cost_price\", \"stock_quantity\"],\n  inventory:    [\"product_name\", \"quantity\", \"location_name\", \"product_sku\", \"product_id\"],\n  customers:    [\"first_name\", \"last_name\", \"email\", \"phone\", \"status\", \"loyalty_tier\"],\n  orders:       [\"order_number\", \"status\", \"total\", \"customer_name\", \"created_at\"],\n  supply_chain: [\"name\", \"status\", \"quantity\", \"supplier\", \"location\", \"expected_delivery_date\"],\n  workflows:    [\"name\", \"status\", \"trigger_type\", \"created_at\", \"last_run\"],\n  email:        [\"subject\", \"to\", \"status\", \"sent_at\", \"category\"],\n  locations:    [\"name\", \"city\", \"state\", \"type\", \"is_active\", \"address_line1\"],\n  media:        [\"title\", \"file_name\", \"category\", \"tags\", \"file_type\"],\n  creations:    [\"name\", \"creation_type\", \"status\", \"visibility\", \"slug\"],\n  api_keys:     [\"name\", \"key_type\", \"is_active\", \"scopes\"],\n};\n\n// Keys that are always deprioritized (shown last or hidden)\nexport const LOW_PRIORITY_KEYS = new Set([\n  \"id\", \"store_id\", \"created_at\", \"updated_at\", \"deleted_at\",\n  \"created_by\", \"updated_by\", \"metadata\", \"raw_data\",\n]);\n\n// ============================================================================\n// FORMATTERS\n// ============================================================================\n\nexport function truncateUuid(val: string): string {\n  if (/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(val)) {\n    return val.slice(0, 8);\n  }\n  return val;\n}\n\n/** Keys whose values must never be truncated (file paths, URLs, IDs the LLM needs verbatim) */\nexport const NEVER_TRUNCATE_KEYS = new Set([\n  \"id\", \"product_id\", \"category_id\", \"location_id\", \"supplier_id\", \"customer_id\",\n  \"store_id\", \"order_id\", \"workflow_id\", \"schema_id\", \"field_schema_id\", \"pricing_schema_id\",\n  \"transfer_id\", \"run_id\", \"step_id\", \"audit_id\", \"media_id\", \"creation_id\", \"job_id\",\n  \"collection_id\", \"source_id\", \"thread_id\", \"form_id\", \"template_id\", \"webhook_id\",\n  \"rule_id\", \"subscription_id\", \"span_id\", \"trace_id\", \"ad_id\", \"ad_set_id\", \"campaign_id\",\n  \"audience_id\", \"pixel_id\", \"key_id\", \"catalog_id\", \"purchase_order_id\",\n  \"primary_category_id\", \"parent_id\", \"from_location_id\", \"to_location_id\",\n  \"local_file\", \"file_url\", \"file_path\", \"download\", \"url\",\n  \"preview_url\", \"thumbnail_url\", \"audio_file\",\n  \"stdout\", \"stderr\", \"command\", \"output\",\n]);\n\nexport function formatValue(val: unknown, key?: string): string {\n  if (val === null || val === undefined) return \"\\u2014\";\n  if (typeof val === \"boolean\") return val ? \"\\u2713\" : \"\\u2715\";\n  if (typeof val === \"number\") {\n    if (key && isPercentageKey(key)) return `${val}%`;\n    return val.toLocaleString();\n  }\n  if (typeof val === \"string\") {\n    if (/^\\d+\\.\\d{2}$/.test(val) && parseFloat(val) > 0) {\n      return `$${parseFloat(val).toLocaleString(undefined, { minimumFractionDigits: 2 })}`;\n    }\n    if (key && NEVER_TRUNCATE_KEYS.has(key)) return val;\n    const truncated = truncateUuid(val);\n    if (/^\\d{4}-\\d{2}-\\d{2}T/.test(val)) {\n      return val.slice(0, 10);\n    }\n    if (truncated.length > 200) return truncated.slice(0, 197) + \"...\";\n    return truncated;\n  }\n  if (Array.isArray(val)) {\n    if (val.length === 0) return \"\\u2014\";\n    if (typeof val[0] === \"object\" && val[0] !== null) {\n      const names = val.slice(0, 3)\n        .map(v => {\n          const o = v as Record<string, unknown>;\n          return o.name || o.location_name || o.title || o.label;\n        })\n        .filter(Boolean)\n        .map(String);\n      if (names.length > 0) {\n        return names.join(\", \") + (val.length > 3 ? ` +${val.length - 3} more` : \"\");\n      }\n    }\n    return `[${val.length} items]`;\n  }\n  if (typeof val === \"object\") {\n    const obj = val as Record<string, unknown>;\n    if (typeof obj.name === \"string\") return obj.name;\n    if (typeof obj.title === \"string\") return obj.title;\n    if (typeof obj.label === \"string\") return obj.label;\n    if (typeof obj.id === \"string\") return obj.id;\n    return \"{...}\";\n  }\n  return String(val);\n}\n\nexport function formatMoneyValue(val: unknown): string {\n  if (typeof val === \"number\") {\n    return `$${val.toLocaleString(undefined, { minimumFractionDigits: 2, maximumFractionDigits: 2 })}`;\n  }\n  return formatValue(val);\n}\n\nexport function isPercentageKey(key: string): boolean {\n  return /percentage|_pct$|percent/i.test(key);\n}\n\nexport function isMoneyKey(key: string): boolean {\n  if (key === \"total\") return false;\n  if (/^total[_](stock|products|items|orders|units|count|quantity|customers|runs|pages|results|employees)/i.test(key)) return false;\n  return /price|cost|revenue|total_revenue|total_amount|amount|subtotal|tax|discount|budget/i.test(key);\n}\n\nexport function prettifyKey(key: string): string {\n  return key\n    .replace(/_/g, \" \")\n    .replace(/\\bid\\b/gi, \"ID\")\n    .replace(/\\b\\w/g, c => c.toUpperCase());\n}\n\n// ============================================================================\n// COLUMN SELECTION\n// ============================================================================\n\nexport function selectColumns(rows: Record<string, unknown>[], toolName?: string): string[] {\n  if (rows.length === 0) return [];\n\n  const allKeys = new Set<string>();\n  for (const row of rows.slice(0, 5)) {\n    for (const key of Object.keys(row)) allKeys.add(key);\n  }\n\n  const tw = termWidth();\n  const maxCols = tw < 90 ? 4 : tw < 120 ? 6 : tw < 160 ? 8 : 10;\n  let priority: string[] = [];\n\n  if (toolName) {\n    for (const [category, cols] of Object.entries(PRIORITY_COLUMNS)) {\n      if (toolName.toLowerCase().includes(category)) {\n        priority = cols;\n        break;\n      }\n    }\n  }\n\n  const selected: string[] = [];\n  for (const col of priority) {\n    if (allKeys.has(col) && selected.length < maxCols) {\n      selected.push(col);\n    }\n  }\n\n  for (const key of allKeys) {\n    if (selected.length >= maxCols) break;\n    if (selected.includes(key)) continue;\n    if (LOW_PRIORITY_KEYS.has(key)) continue;\n    const sample = rows[0][key];\n    if (Array.isArray(sample)) continue;\n    if (typeof sample === \"object\" && sample !== null) continue;\n    selected.push(key);\n  }\n\n  return selected;\n}\n\n// ============================================================================\n// TABLE BUILDER\n// ============================================================================\n\nexport function buildTable(rows: Record<string, unknown>[], columns: string[]): string {\n  if (columns.length === 0 || rows.length === 0) return \"\";\n\n  const headers = columns.map(prettifyKey);\n\n  const termW = termWidth();\n  const overhead = columns.length * 3 + 4;\n  const cellCap = Math.min(Math.max(Math.floor((termW - overhead) / columns.length), 15), 50);\n  const widths = columns.map((col, i) => {\n    let max = headers[i].length;\n    for (const row of rows) {\n      const val = isMoneyKey(col) ? formatMoneyValue(row[col]) : formatValue(row[col], col);\n      max = Math.max(max, val.length);\n    }\n    return Math.min(max, cellCap);\n  });\n\n  const headerRow = columns.map((_, i) => headers[i].padEnd(widths[i])).join(\" | \");\n  const separator = widths.map(w => \"-\".repeat(w)).join(\" | \");\n\n  const dataRows = rows.map(row =>\n    columns.map((col, i) => {\n      const val = isMoneyKey(col) ? formatMoneyValue(row[col]) : formatValue(row[col], col);\n      const isNum = typeof row[col] === \"number\" || isMoneyKey(col);\n      return isNum ? val.padStart(widths[i]) : val.padEnd(widths[i]);\n    }).join(\" | \")\n  );\n\n  return [\n    `| ${headerRow} |`,\n    `| ${separator} |`,\n    ...dataRows.map(r => `| ${r} |`),\n  ].join(\"\\n\");\n}\n\n// ============================================================================\n// ID REFERENCE — gives the LLM full UUIDs for follow-up calls\n// ============================================================================\n\nexport function buildIdReference(rows: Record<string, unknown>[]): string {\n  if (rows.length === 0) return \"\";\n\n  const idKey = [\"id\", \"product_id\", \"customer_id\", \"order_id\", \"workflow_id\"]\n    .find(k => rows.some(r => r[k] && typeof r[k] === \"string\"));\n  if (!idKey) return \"\";\n\n  const nameKey = [\"name\", \"product_name\", \"first_name\", \"title\", \"subject\", \"label\", \"slug\", \"order_number\"]\n    .find(k => rows[0][k] !== undefined) || null;\n\n  const entries: string[] = [];\n  for (const row of rows) {\n    const idVal = row[idKey];\n    if (!idVal || typeof idVal !== \"string\") continue;\n    const label = nameKey && row[nameKey] ? String(row[nameKey]) : String(idVal).slice(0, 8);\n    entries.push(`${label}=${idVal}`);\n  }\n\n  if (entries.length === 0) return \"\";\n  return `\\nIDs: ${entries.join(\", \")}`;\n}\n"],"mappings":"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","ignoreList":[]}

package/dist/cli/services/format-server-response-primitives-basic.test.js

@@ -0,0 +1,261 @@
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import { formatServerResponse } from "./format-server-response.js";
+
+/** Override process.stdout.columns for narrow/wide terminal simulation */
+function setTerminalWidth(cols) {
+  Object.defineProperty(process.stdout, "columns", {
+    value: cols,
+    writable: true,
+    configurable: true
+  });
+}
+describe("formatServerResponse — primitives and basic types", () => {
+  let originalColumns;
+  beforeEach(() => {
+    originalColumns = process.stdout.columns;
+    setTerminalWidth(120);
+  });
+  afterEach(() => {
+    if (originalColumns !== undefined) {
+      setTerminalWidth(originalColumns);
+    } else {
+      Object.defineProperty(process.stdout, "columns", {
+        value: originalColumns,
+        writable: true,
+        configurable: true
+      });
+    }
+  });
+  describe("string passthrough", () => {
+    it("returns strings unchanged", () => {
+      expect(formatServerResponse("hello world")).toBe("hello world");
+    });
+    it("returns empty string unchanged", () => {
+      expect(formatServerResponse("")).toBe("");
+    });
+    it("returns multi-line string unchanged", () => {
+      const multi = "line 1\nline 2\nline 3";
+      expect(formatServerResponse(multi)).toBe(multi);
+    });
+  });
+  describe("null and undefined handling", () => {
+    it("returns 'No data returned.' for null", () => {
+      expect(formatServerResponse(null)).toBe("No data returned.");
+    });
+    it("returns 'No data returned.' for undefined", () => {
+      expect(formatServerResponse(undefined)).toBe("No data returned.");
+    });
+  });
+  describe("empty array", () => {
+    it("returns 'No results found.' for empty array", () => {
+      expect(formatServerResponse([])).toBe("No results found.");
+    });
+  });
+  describe("array of objects → table", () => {
+    it("formats a simple array of objects into a markdown table", () => {
+      const data = [{
+        name: "Widget A",
+        quantity: 10
+      }, {
+        name: "Widget B",
+        quantity: 25
+      }];
+      const result = formatServerResponse(data);
+      expect(result).toContain("|");
+      expect(result).toContain("---");
+      expect(result).toContain("Widget A");
+      expect(result).toContain("Widget B");
+      expect(result).toContain("10");
+      expect(result).toContain("25");
+    });
+    it("includes a result count header", () => {
+      const data = [{
+        name: "A"
+      }, {
+        name: "B"
+      }, {
+        name: "C"
+      }];
+      const result = formatServerResponse(data);
+      expect(result).toContain("(3 results)");
+    });
+    it("uses singular 'result' for single item", () => {
+      const data = [{
+        name: "Only One"
+      }];
+      const result = formatServerResponse(data);
+      expect(result).toContain("(1 result)");
+      expect(result).not.toContain("(1 results)");
+    });
+    it("shows category label when tool name matches a known category", () => {
+      const data = [{
+        name: "Blue Dream",
+        sku: "BD-001",
+        status: "published"
+      }];
+      const result = formatServerResponse(data, "products");
+      expect(result).toContain("**Products**");
+    });
+    it("uses 'Results' label when tool name does not match any category", () => {
+      const data = [{
+        name: "Something",
+        value: 42
+      }];
+      const result = formatServerResponse(data, "unknown_tool");
+      expect(result).toContain("**Results**");
+    });
+  });
+  describe("single flat object → key-value pairs", () => {
+    it("formats a flat object as bold key-value pairs", () => {
+      const data = {
+        name: "Test Product",
+        status: "active",
+        quantity: 50
+      };
+      const result = formatServerResponse(data);
+      expect(result).toContain("**Name**: Test Product");
+      expect(result).toContain("**Status**: active");
+      expect(result).toContain("**Quantity**: 50");
+    });
+    it("filters out low-priority keys", () => {
+      const data = {
+        name: "Visible",
+        id: "some-uuid",
+        store_id: "store-uuid",
+        created_at: "2025-01-01",
+        updated_at: "2025-01-02",
+        metadata: "meta"
+      };
+      const result = formatServerResponse(data);
+      expect(result).toContain("**Name**: Visible");
+      expect(result).toContain("**ID**: some-uuid");
+      expect(result).not.toContain("**Store ID**");
+      expect(result).not.toContain("**Created At**");
+      expect(result).not.toContain("**Updated At**");
+      expect(result).not.toContain("**Metadata**");
+    });
+    it("formats money keys with dollar sign", () => {
+      const data = {
+        name: "Item",
+        price: 29.99,
+        cost: 15
+      };
+      const result = formatServerResponse(data);
+      expect(result).toContain("**Price**: $29.99");
+      expect(result).toContain("**Cost**: $15.00");
+    });
+  });
+  describe("wrapper object with nested array", () => {
+    it("extracts data from 'data' wrapper key when object has nested arrays", () => {
+      const data = {
+        count: 2,
+        meta: {
+          page: 1
+        },
+        data: [{
+          name: "A",
+          quantity: 1
+        }, {
+          name: "B",
+          quantity: 2
+        }]
+      };
+      const result = formatServerResponse(data);
+      expect(result).toContain("**Count**: 2");
+      expect(result).toContain("A");
+      expect(result).toContain("B");
+    });
+    it("extracts data from 'results' wrapper key when object is not flat", () => {
+      const data = {
+        count: 1,
+        meta: {
+          info: "x"
+        },
+        results: [{
+          name: "Found"
+        }]
+      };
+      const result = formatServerResponse(data);
+      expect(result).toContain("Found");
+      expect(result).toContain("**Count**: 1");
+    });
+    it("extracts data from 'items' wrapper key when object is not flat", () => {
+      const data = {
+        meta: {
+          info: "x"
+        },
+        items: [{
+          name: "Item 1"
+        }, {
+          name: "Item 2"
+        }]
+      };
+      const result = formatServerResponse(data);
+      expect(result).toContain("Item 1");
+      expect(result).toContain("Item 2");
+    });
+    it("extracts data from 'rows' wrapper key when object is not flat", () => {
+      const data = {
+        meta: {
+          info: "x"
+        },
+        rows: [{
+          name: "Row 1"
+        }]
+      };
+      const result = formatServerResponse(data);
+      expect(result).toContain("Row 1");
+    });
+    it("extracts data from 'records' wrapper key when object is not flat", () => {
+      const data = {
+        meta: {
+          info: "x"
+        },
+        records: [{
+          name: "Record A"
+        }]
+      };
+      const result = formatServerResponse(data);
+      expect(result).toContain("Record A");
+    });
+    it("expands nested arrays in objects as sub-tables", () => {
+      const data = {
+        count: 2,
+        items: [{
+          name: "A"
+        }, {
+          name: "B"
+        }]
+      };
+      const result = formatServerResponse(data);
+      expect(result).toContain("**Count**: 2");
+      expect(result).toContain("A");
+      expect(result).toContain("B");
+    });
+    it("includes scalar summary fields and expands nested arrays", () => {
+      const data = {
+        count: 100,
+        page: 1,
+        nested_config: {
+          key: "ignored"
+        },
+        data: [{
+          name: "X"
+        }]
+      };
+      const result = formatServerResponse(data);
+      expect(result).toContain("**Count**: 100");
+      expect(result).toContain("**Page**: 1");
+      expect(result).toContain("X");
+    });
+    it("skips empty wrapper arrays", () => {
+      const data = {
+        total: 0,
+        data: [],
+        status: "ok"
+      };
+      const result = formatServerResponse(data);
+      expect(result).toContain("**Status**: ok");
+    });
+  });
+});