@axiom-lattice/examples-deep_research 1.0.93 → 1.0.95

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @axiom-lattice/examples-deep_research@1.0.93 build /home/runner/work/agentic/agentic/examples/deep_research
+> @axiom-lattice/examples-deep_research@1.0.95 build /home/runner/work/agentic/agentic/examples/deep_research
 > tsup
 
 CLI Building entry: src/index.ts
@@ -9,9 +9,9 @@
 CLI Target: es2020
 CLI Cleaning output folder
 ESM Build start
-ESM dist/index.js     71.96 KB
-ESM dist/index.js.map 88.38 KB
-ESM ⚡️ Build success in 96ms
+ESM dist/index.js     78.55 KB
+ESM dist/index.js.map 97.58 KB
+ESM ⚡️ Build success in 128ms
 DTS Build start
-DTS ⚡️ Build success in 14884ms
+DTS ⚡️ Build success in 15511ms
 DTS dist/index.d.ts 13.00 B

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # @axiom-lattice/examples-deep_research
 
+## 1.0.95
+
+### Patch Changes
+
+- Updated dependencies [9571787]
+  - @axiom-lattice/core@2.1.85
+  - @axiom-lattice/gateway@2.1.97
+  - @axiom-lattice/pg-stores@1.0.76
+
+## 1.0.94
+
+### Patch Changes
+
+- Updated dependencies [f5eea72]
+  - @axiom-lattice/pg-stores@1.0.75
+  - @axiom-lattice/gateway@2.1.96
+  - @axiom-lattice/core@2.1.84
+
 ## 1.0.93
 
 ### Patch Changes

package/dist/index.js

@@ -9,7 +9,7 @@ var require_package = __commonJS({
   "package.json"(exports, module) {
     module.exports = {
       name: "@axiom-lattice/examples-deep_research",
-      version: "1.0.93",
+      version: "1.0.95",
       type: "module",
       main: "dist/index.js",
       bin: {
@@ -745,6 +745,46 @@ registerAgentLattices4(tenantId4, [sandboxAgent]);
 import z4 from "zod";
 import { registerToolLattice } from "@axiom-lattice/core";
 var BASE_URL = process.env.SAP_SERVICE_LAYER_URL || "https://b1s.alphafina.cn/b1s/v1";
+var EXPAND_FIELDS = {
+  "DocumentLines": [
+    "LineNum",
+    "ItemCode",
+    "ItemDescription",
+    "Quantity",
+    "UnitPrice",
+    "WarehouseCode",
+    "Total",
+    "Currency",
+    "TaxCode",
+    "PriceAfterVAT",
+    "UoMEntry",
+    "UoMCode"
+  ],
+  "DocumentAdditionalExpenses": [
+    "LineNum",
+    "ExpenseCode",
+    "LineTotal",
+    "TaxCode",
+    "VatGroup"
+  ]
+};
+var ENTITIES_WITH_LINES = /* @__PURE__ */ new Set([
+  "Orders",
+  "DeliveryNotes",
+  "Invoices",
+  "Quotations",
+  "CreditNotes",
+  "Returns",
+  "Drafts",
+  "PurchaseOrders",
+  "PurchaseDeliveryNotes",
+  "PurchaseInvoices",
+  "PurchaseReturns",
+  "PurchaseQuotations",
+  "DownPayments",
+  "InventoryGenEntries",
+  "InventoryGenExits"
+]);
 var API_LIST = [
   // ========== Business Partner ==========
   {
@@ -769,7 +809,9 @@ var API_LIST = [
       "SalesPersonCode",
       "PriceListNum",
       "CreditLimit",
-      "Balance",
+      "CurrentAccountBalance",
+      "OpenOrdersBalance",
+      "OpenDeliveryNotesBalance",
       "PayTermsGrpCode",
       "VatGroup",
       "VatLiable",
@@ -778,7 +820,11 @@ var API_LIST = [
       "Frozen",
       "CompanyPrivate",
       "CreateDate",
-      "UpdateDate"
+      "CreateTime",
+      "UpdateDate",
+      "UpdateTime",
+      "BPAddresses",
+      "ContactEmployees"
     ]
   },
   {
@@ -829,7 +875,9 @@ var API_LIST = [
       "Valid",
       "Frozen",
       "CreateDate",
-      "UpdateDate"
+      "UpdateDate",
+      "ItemPrices",
+      "ItemWarehouseInfoCollection"
     ]
   },
   {
@@ -903,7 +951,8 @@ var API_LIST = [
       "RoundDif",
       "DiscountPercent",
       "PaymentGroupCode",
-      "Project"
+      "Project",
+      "DocumentLines"
     ]
   },
   {
@@ -929,7 +978,8 @@ var API_LIST = [
       "Cancelled",
       "DocumentStatus",
       "Comments",
-      "NumAtCard"
+      "NumAtCard",
+      "DocumentLines"
     ]
   },
   {
@@ -956,7 +1006,8 @@ var API_LIST = [
       "DocumentStatus",
       "Comments",
       "NumAtCard",
-      "VatSum"
+      "VatSum",
+      "DocumentLines"
     ]
   },
   {
@@ -978,7 +1029,8 @@ var API_LIST = [
       "DocCurrency",
       "SalesPersonCode",
       "Comments",
-      "DocumentStatus"
+      "DocumentStatus",
+      "DocumentLines"
     ]
   },
   {
@@ -997,7 +1049,8 @@ var API_LIST = [
       "CardName",
       "DocTotal",
       "DocCurrency",
-      "Comments"
+      "Comments",
+      "DocumentLines"
     ]
   },
   {
@@ -1016,7 +1069,8 @@ var API_LIST = [
       "CardName",
       "DocTotal",
       "DocCurrency",
-      "Comments"
+      "Comments",
+      "DocumentLines"
     ]
   },
   {
@@ -1036,7 +1090,8 @@ var API_LIST = [
       "DocTotal",
       "DocCurrency",
       "DownPaymentType",
-      "DownPaymentAmount"
+      "DownPaymentAmount",
+      "DocumentLines"
     ]
   },
   {
@@ -1092,7 +1147,8 @@ var API_LIST = [
       "Cancelled",
       "DocumentStatus",
       "Comments",
-      "NumAtCard"
+      "NumAtCard",
+      "DocumentLines"
     ]
   },
   {
@@ -1110,7 +1166,8 @@ var API_LIST = [
       "CardCode",
       "CardName",
       "DocTotal",
-      "Comments"
+      "Comments",
+      "DocumentLines"
     ]
   },
   {
@@ -1130,7 +1187,8 @@ var API_LIST = [
       "CardName",
       "DocTotal",
       "DocCurrency",
-      "Comments"
+      "Comments",
+      "DocumentLines"
     ]
   },
   {
@@ -1148,7 +1206,8 @@ var API_LIST = [
       "CardCode",
       "CardName",
       "DocTotal",
-      "Comments"
+      "Comments",
+      "DocumentLines"
     ]
   },
   {
@@ -1166,7 +1225,8 @@ var API_LIST = [
       "CardCode",
       "CardName",
       "DocTotal",
-      "Comments"
+      "Comments",
+      "DocumentLines"
     ]
   },
   // ========== Inventory / Warehouse ==========
@@ -1186,7 +1246,8 @@ var API_LIST = [
       "JournalMemo",
       "Reference1",
       "Reference2",
-      "WareHouseUpdateType"
+      "WareHouseUpdateType",
+      "DocumentLines"
     ]
   },
   {
@@ -1204,7 +1265,8 @@ var API_LIST = [
       "Comments",
       "JournalMemo",
       "Reference1",
-      "Reference2"
+      "Reference2",
+      "DocumentLines"
     ]
   },
   {
@@ -1555,25 +1617,49 @@ var API_LIST = [
     ]
   }
 ];
+function mapResult(e) {
+  const r = {
+    name: e.name,
+    kind: e.kind,
+    domain: e.domain,
+    description: e.description,
+    primaryKey: e.primaryKey || null,
+    fields: e.fields,
+    readySelect: e.fields.length > 0 ? `$select=${e.fields.join(",")}` : void 0,
+    hint: e.kind === "EntitySet" ? `${e.name} \u2014 ${e.description}\u3002\u4E3B\u952E: ${e.primaryKey}\u3002\u8C03\u7528 sap_api_call \u8FDB\u884C CRUD \u64CD\u4F5C\u3002` : `${e.name} \u2014 ${e.description}\u3002\u8C03\u7528 sap_api_call \u6267\u884C\u6B64\u65B9\u6CD5\u3002`
+  };
+  if (ENTITIES_WITH_LINES.has(e.name)) {
+    r.expand = ["DocumentLines", "DocumentAdditionalExpenses"];
+    r.lineFields = ["LineNum", "ItemCode", "ItemDescription", "Quantity", "UnitPrice", "Price", "WarehouseCode", "UoMEntry", "UoMCode", "VatGroup", "Currency", "TaxCode", "PriceAfterVAT"];
+  }
+  if (e.name === "Items") {
+    r.expand = ["ItemPrices", "ItemWarehouseInfoCollection"];
+  }
+  if (e.name === "BusinessPartners") {
+    r.expand = ["BPAddresses", "ContactEmployees"];
+  }
+  return r;
+}
 registerToolLattice(
   "sap_api_search",
   {
     name: "sap_api_search",
-    description: "\u641C\u7D22 SAP B1 Service Layer API \u63A5\u53E3\u3002\u8986\u76D6\u4E1A\u52A1\u4F19\u4F34(BP)\u3001\u7269\u6599(Item)\u3001\u9500\u552E/\u91C7\u8D2D\u8BA2\u5355(Document/Order)\u3001\u5E93\u5B58(Inventory/Warehouse) \u56DB\u5927\u9886\u57DF\u3002\u8FD4\u56DE\u63A5\u53E3\u540D\u79F0\u3001\u4E3B\u952E\u3001\u5E38\u7528\u5B57\u6BB5\u5217\u8868\u53CA\u63CF\u8FF0\u3002",
+    description: "\u641C\u7D22 SAP B1 Service Layer API \u63A5\u53E3\u5143\u6570\u636E\uFF0C\u8986\u76D6 BP/\u7269\u6599/\u8BA2\u5355/\u5E93\u5B58\u56DB\u5927\u9886\u57DF\u3002\u8FD4\u56DE\u63A5\u53E3\u540D\u3001\u4E3B\u952E\u3001\u5B57\u6BB5\u5217\u8868\u3001\u53EF\u9009 expand \u5BFC\u822A\u3002\u53EF\u7528 discover \u6A21\u5F0F\u53D1\u73B0\u5173\u8054\u63A5\u53E3\uFF08\u5982\u641C SalesPerson \u4E5F\u80FD\u627E\u5230 SalesPersons API\uFF09\u3002\u641C\u7D22\u7ED3\u679C\u4E2D\u7684 readySelect \u53EF\u76F4\u63A5\u590D\u5236\u5230 $select\u3002",
     needUserApprove: false,
     schema: z4.object({
-      query: z4.string().describe(
-        "\u641C\u7D22\u5173\u952E\u8BCD\u3002\u53EF\u4EE5\u662F API \u540D\u79F0\uFF08\u5982 'BusinessPartners', 'Orders', 'Items', 'PurchaseOrders'\uFF09\u6216\u4E1A\u52A1\u63CF\u8FF0\uFF08\u5982 '\u5BA2\u6237', '\u8BA2\u5355', '\u7269\u6599', '\u5E93\u5B58', '\u91C7\u8D2D', '\u4ED3\u5E93'\uFF09"
+      query: z4.string().optional().describe(
+        "\u641C\u7D22\u5173\u952E\u8BCD\uFF08\u53EF\u9009\uFF0C\u4E0D\u4F20\u5219\u8FD4\u56DE\u5168\u90E8\u63A5\u53E3\uFF09\u3002API \u540D\u79F0\u5982 'BusinessPartners', 'Orders', 'Items', 'PurchaseOrders'\uFF0C\u6216\u4E2D\u6587\u63CF\u8FF0\u5982 '\u5BA2\u6237', '\u8BA2\u5355', '\u7269\u6599', '\u5E93\u5B58', '\u91C7\u8D2D', '\u4ED3\u5E93'"
       ),
       domain: z4.string().optional().describe(
         "\u6309\u9886\u57DF\u8FC7\u6EE4: 'BusinessPartner'(BP), 'Item / Product'(\u7269\u6599), 'Document'(\u8BA2\u5355/\u53D1\u7968), 'Inventory / Warehouse'(\u5E93\u5B58/\u4ED3\u5E93)"
       ),
-      maxResults: z4.number().optional().default(10).describe("\u6700\u5927\u8FD4\u56DE\u6761\u6570")
+      maxResults: z4.number().optional().default(20).describe("\u6700\u5927\u8FD4\u56DE\u6761\u6570")
     })
   },
   async (input) => {
-    const q = input.query.toLowerCase();
-    const max = input.maxResults ?? 10;
+    const q = input.query?.toLowerCase();
+    const max = input.maxResults ?? 20;
+    const hasQuery = q && q.trim().length > 0;
     const domainHints = {
       "\u5BA2\u6237": "BusinessPartner",
       "\u4F9B\u5E94\u5546": "BusinessPartner",
@@ -1589,6 +1675,8 @@ registerToolLattice(
       "\u4EA4\u8D27": "Document",
       "\u62A5\u4EF7": "Document",
       "\u8349\u7A3F": "Document",
+      "draft": "Document",
+      "\u6682\u5B58": "Document",
       "\u5E93\u5B58": "Inventory / Warehouse",
       "\u4ED3\u5E93": "Inventory / Warehouse",
       "\u5E93\u4F4D": "Inventory / Warehouse",
@@ -1604,12 +1692,26 @@ registerToolLattice(
       "\u6C47\u7387": "Finance / Accounting",
       "\u5230\u5CB8": "Document"
     };
-    const hintedDomain = domainHints[q] || void 0;
+    const hintedDomain = q ? domainHints[q] || void 0 : void 0;
     const effectiveDomain = input.domain || hintedDomain;
-    const scored = API_LIST.filter((e) => {
+    const filtered = API_LIST.filter((e) => {
       if (effectiveDomain && e.domain !== effectiveDomain) return false;
       return true;
-    }).map((e) => {
+    });
+    if (!q) {
+      const top2 = filtered.slice(0, max);
+      const domainCounts2 = {};
+      for (const e of top2) domainCounts2[e.domain] = (domainCounts2[e.domain] || 0) + 1;
+      return {
+        query: input.query || null,
+        domainFilter: effectiveDomain || null,
+        totalMatches: filtered.length,
+        domainsFound: domainCounts2,
+        results: top2.map(mapResult),
+        suggestion: void 0
+      };
+    }
+    const scored = filtered.map((e) => {
       let score = 0;
       const nameLo = e.name.toLowerCase();
       const descLo = e.description.toLowerCase();
@@ -1633,15 +1735,7 @@ registerToolLattice(
       domainFilter: effectiveDomain || null,
       totalMatches: scored.filter((e) => e.score > 0).length,
       domainsFound: domainCounts,
-      results: top.map((e) => ({
-        name: e.name,
-        kind: e.kind,
-        domain: e.domain,
-        description: e.description,
-        primaryKey: e.primaryKey || null,
-        fields: e.fields,
-        hint: e.kind === "EntitySet" ? `${e.name} \u2014 ${e.description}\u3002\u4E3B\u952E: ${e.primaryKey}\u3002\u8C03\u7528 sap_api_call \u8FDB\u884C CRUD \u64CD\u4F5C\u3002` : `${e.name} \u2014 ${e.description}\u3002\u8C03\u7528 sap_api_call \u6267\u884C\u6B64\u65B9\u6CD5\u3002`
-      })),
+      results: top.map(mapResult),
       suggestion: top.length === 0 ? `\u672A\u627E\u5230\u5339\u914D "${input.query}" \u7684\u63A5\u53E3\u3002\u53EF\u7528\u9886\u57DF: BusinessPartner(\u5BA2\u6237/\u4F9B\u5E94\u5546), Item / Product(\u7269\u6599), Document(\u8BA2\u5355/\u53D1\u7968), Inventory / Warehouse(\u5E93\u5B58/\u4ED3\u5E93)\u3002\u5C1D\u8BD5\u7528\u82F1\u6587\u540D\u79F0\u641C\u7D22\u3002` : void 0
     };
   }
@@ -1651,20 +1745,32 @@ registerToolLattice(
   "sap_api_call",
   {
     name: "sap_api_call",
-    description: `\u6267\u884C\u5BF9 SAP B1 Service Layer \u7684 OData API \u8C03\u7528\u3002\u76F4\u63A5\u53D1\u8D77 HTTP \u8BF7\u6C42\u5E76\u8FD4\u56DE\u54CD\u5E94\u6570\u636E\u3002\u5F53\u524D Base URL: ${BASE_URL}\u3002GET \u8BF7\u6C42\u901A\u5E38\u65E0\u9700\u8BA4\u8BC1\uFF0CPOST/PATCH/DELETE \u9700\u8BBE\u7F6E\u73AF\u5883\u53D8\u91CF SAP_B1SESSION\u3002`,
+    description: `\u6267\u884C SAP B1 Service Layer \u7684 OData API \u67E5\u8BE2/\u521B\u5EFA/\u66F4\u65B0/\u5220\u9664\u3002Base: ${BASE_URL}\u3002\u26A0\uFE0F \u5148\u786E\u8BA4\u662F\u5426\u5DF2\u901A\u8FC7 sap_api_search \u67E5\u8FC7\u5B57\u6BB5\u5217\u8868\uFF0C\u52FF\u51ED\u8BB0\u5FC6\u7F16\u5B57\u6BB5\u540D\u3002
+\u26A0\uFE0F \u8349\u7A3F/draft/\u6682\u5B58 \u2192 \u7528 Drafts \u63A5\u53E3\uFF0C\u4E0D\u662F Orders/Invoices \u7B49\u6B63\u5F0F\u5355\u636E\u3002Drafts \u901A\u8FC7 DocObjectCode \u533A\u5206\u5355\u636E\u7C7B\u578B(17=\u8BA2\u5355,13=\u53D1\u7968,16=\u4EA4\u8D27\u5355,23=\u91C7\u8D2D\u8BA2\u5355)\u3002
+$filter \u64CD\u4F5C\u7B26: eq/ne/gt/lt/ge/le/contains(f,'v')/startswith(f,'v')/endswith(f,'v')\uFF0C\u591A\u6761\u4EF6\u7528 and/or\u3002\u5B57\u7B26\u4E32\u503C\u5FC5\u987B\u5355\u5F15\u53F7\u5305\u88F9\u3002$orderby=Field desc \u6392\u5E8F\u3002
+
+\u26A0\uFE0F SAP B1 \u5B9E\u6218\u7ECF\u9A8C:
+1. \u4E0D\u8981\u7528 $expand\uFF01$expand \u6781\u6613\u89E6\u53D1 400/500\u3002\u6539\u7528 $select \u5305\u542B\u5D4C\u5957\u5B57\u6BB5\uFF0C\u5982 $select=DocEntry,DocNum,DocumentLines\uFF0C
+   DocumentLines \u4F1A\u81EA\u52A8\u4F5C\u4E3A\u5D4C\u5957 JSON \u8FD4\u56DE\u3002ItemPrices\u3001BPAddresses \u7B49\u540C\u7406\u3002
+2. \u4E0D\u8981\u7528\u4E3B\u952E\u8DEF\u5F84 /Orders('1173')\uFF0C\u6613 500\u3002\u7528 $filter=DocEntry eq 1173 \u4EE3\u66FF\u3002
+3. \u67E5\u5355\u6761\u8BB0\u5F55\u65F6\u4F18\u5148 $filter\uFF0C\u800C\u975E\u4F20 id \u53C2\u6570\u3002
+400 \u591A\u4E3A\u7279\u6B8A\u5B57\u7B26\u672A\u7F16\u7801(\u5F15\u53F7\u7528 %27)\uFF1B500 \u591A\u4E3A\u5B57\u6BB5\u4E0D\u5B58\u5728\u6216\u7528\u9519\u4E86 $expand\uFF1B\u65E0\u7ED3\u679C\u5219\u653E\u5BBD filter\u3002
+POST \u521B\u5EFA: sap_api_search \u8FD4\u56DE\u7684 lineFields \u662F DocumentLines \u5B50\u5B57\u6BB5\u3002body \u5FC5\u542B DocObjectCode(DocType)\u3001CardCode\u3001DocDate\uFF1BDocumentLines \u4E3A\u6570\u7EC4\uFF0C\u6BCF\u9879\u5FC5\u542B ItemCode\u3001Quantity\u3002PATCH \u53EA\u4F20\u53D8\u66F4\u5B57\u6BB5\uFF1BDELETE \u9700\u4F20 id\u3002
+GET \u81EA\u52A8\u6CE8\u5165 $select+$top=20\uFF0C\u624B\u52A8\u4F20\u5165\u53EF\u8986\u76D6\u3002\u5D4C\u5957\u96C6\u5408(DocumentLines\u7B49)\u81EA\u52A8\u88C1\u526A\u53EA\u4FDD\u7559\u5E38\u7528\u5B57\u6BB5\uFF0C\u9632 token \u7206\u70B8\u3002\u8BA4\u8BC1\u9700 SAP_B1SESSION \u73AF\u5883\u53D8\u91CF\u3002`,
     needUserApprove: false,
     schema: z4.object({
       entitySet: z4.string().describe("EntitySet \u540D\u79F0\uFF0C\u5982 'BusinessPartners', 'Orders', 'Items', 'PurchaseOrders'"),
       method: z4.enum(["GET", "POST", "PATCH", "DELETE"]).describe("HTTP \u65B9\u6CD5"),
       id: z4.string().optional().describe("\u4E3B\u952E\u503C\uFF0CGET/PATCH/DELETE \u5355\u4E2A\u5B9E\u4F53\u65F6\u4F7F\u7528\u3002\u5982 /BusinessPartners('C001')"),
       queryOptions: z4.string().optional().describe(
-        "OData \u67E5\u8BE2\u53C2\u6570\uFF08\u4E0D\u542B `?` \u524D\u7F00\uFF09\u3002\u5E38\u7528: $top=10, $skip=20, $select=CardCode,CardName, $filter=contains(CardName,'\u6E05\u534E'), $orderby=DocDate desc, $expand=DocumentLines"
+        "OData \u67E5\u8BE2\u53C2\u6570\uFF08\u4E0D\u542B `?` \u524D\u7F00\uFF09\u3002\u5E38\u7528: $top=10, $select=CardCode,CardName, $filter=CardName eq 'xxx' or contains(CardName,'xxx'), $orderby=DocDate desc, $expand=DocumentLines\u3002\u5B57\u7B26\u4E32\u503C\u7528\u5355\u5F15\u53F7\u3002sap_api_search \u8FD4\u56DE\u7684 readySelect \u53EF\u76F4\u63A5\u590D\u5236\u5230 $select\u3002"
       ),
       body: z4.record(z4.unknown()).optional().describe("POST/PATCH \u65F6\u7684 JSON \u8BF7\u6C42\u4F53")
     })
   },
   async (input) => {
-    const url = buildUrl(input.entitySet, input.method, input.id, input.queryOptions);
+    const queryOptions = applyDefaultSelect(input.entitySet, input.method, input.id, input.queryOptions);
+    const url = buildUrl(input.entitySet, input.method, input.id, queryOptions);
     const method = input.method;
     const headers = {
       "Content-Type": "application/json",
@@ -1677,13 +1783,15 @@ registerToolLattice(
     }
     try {
       const res = await fetch(url, fetchOptions);
-      const text = await res.text();
+      const buffer = await res.arrayBuffer();
+      const text = new TextDecoder("utf-8", { fatal: false }).decode(buffer);
       let data;
       try {
         data = JSON.parse(text);
       } catch {
         data = text;
       }
+      cleanODataNoise(data);
       const result = {
         ok: res.ok,
         status: res.status,
@@ -1706,6 +1814,63 @@ registerToolLattice(
     }
   }
 );
+function applyDefaultSelect(entitySet, method, id, queryOptions) {
+  if (method !== "GET") return queryOptions;
+  const parts = [];
+  if (!id && (!queryOptions || !/\$top\s*=/.test(queryOptions))) {
+    parts.push("$top=20");
+  }
+  if (!queryOptions || !/\$select\s*=/.test(queryOptions)) {
+    const entry = API_LIST.find(
+      (e) => e.kind === "EntitySet" && e.name === entitySet
+    );
+    if (entry && entry.fields.length > 0) {
+      parts.push(`$select=${entry.fields.join(",")}`);
+    }
+  }
+  if (queryOptions) {
+    parts.push(queryOptions);
+  }
+  return parts.length > 0 ? parts.join("&").replace(/'/g, "%27") : void 0;
+}
+function cleanODataNoise(data) {
+  if (!data || typeof data !== "object") return;
+  if (Array.isArray(data)) {
+    for (const item of data) cleanODataNoise(item);
+    return;
+  }
+  const obj = data;
+  delete obj["odata.metadata"];
+  delete obj["odata.etag"];
+  delete obj["odata.nextLink"];
+  if (Array.isArray(obj.value)) {
+    for (const record of obj.value) {
+      if (record && typeof record === "object") {
+        trimNestedCollections(record);
+        delete record["odata.etag"];
+      }
+    }
+  }
+  for (const v of Object.values(obj)) {
+    if (v && typeof v === "object") cleanODataNoise(v);
+  }
+}
+function trimNestedCollections(obj) {
+  for (const [key, val] of Object.entries(obj)) {
+    if (Array.isArray(val) && EXPAND_FIELDS[key]) {
+      const keep = new Set(EXPAND_FIELDS[key]);
+      for (const item of val) {
+        if (item && typeof item === "object") {
+          const record = item;
+          for (const k of Object.keys(record)) {
+            if (!keep.has(k)) delete record[k];
+          }
+          cleanODataNoise(item);
+        }
+      }
+    }
+  }
+}
 function buildUrl(entitySet, method, id, queryOptions) {
   let url = `${BASE_URL}/${entitySet}`;
   if (id && method !== "POST") {