@celigo/api-specs 0.2.46 → 0.2.47

package/dist/export.yml

@@ -12683,6 +12683,13 @@ components:
               There are two main parsing strategies available:
               - **Automatic parsing**: Simple but produces more complex output
               - **Custom parsing**: More control over the resulting JSON structure
+            x-celigo-ai-guidance:
+              - |-
+                With V0_json false, an empty element (`<FirstName></FirstName>`, `<FirstName/>`) parses to
+                an empty object `{}` under every setting here, not an empty string. A Handlebars template
+                that outputs the field renders `[object Object]`; guard it with
+                `{{#if (eq (typeOf FirstName) "string")}}{{FirstName}}{{/if}}` — a bare `{{#if FirstName}}`
+                does not skip it because `{}` is truthy.
             properties:
               V0_json:
                 type: boolean
@@ -12704,22 +12711,29 @@ components:
               listNodes:
                 type: array
                 description: |
-                  Specifies which XML nodes should be treated as arrays (lists) in the output JSON.
-
-                  It's not always possible to automatically determine if an XML node should be a single value
-                  or an array. Use this field to explicitly identify nodes that should be treated as arrays,
-                  even if they appear only once in the XML.
-
-                  Each entry should be a simplified XPath expression pointing to the node that should be
-                  treated as an array.
-
-                  Only relevant when V0_json is set to false (Custom parsing).
+                  Paths of elements that always parse as arrays. An element that can repeat parses as an
+                  object when it occurs once and as an array when it occurs more than once, so list every
+                  repeating element here to give each record the same shape regardless of item count.
+                  Each entry is the element's full path from the record element selected by the resource
+                  path (from the document root when there is no resource path), with an optional leading
+                  slash. Only relevant when V0_json is set to false (Custom parsing).
                 items:
                   type: string
                 examples:
                   - - /product-lineitems/product-lineitem
                     - /shipping-lineitems/shipping-lineitem
                     - /shipments/shipment
+                x-celigo-ai-guidance:
+                  - |-
+                    Add every element that can repeat. Left out, a one-item record parses it as an object:
+                    a Handlebars `{{#each}}` over it iterates the object's fields (each field reference
+                    renders empty) and mappings or filters written against an array find nothing.
+                  - |-
+                    Write the full path from the record element: `Items/LineItemInfo` for records at
+                    resource path `/Orders/Order`. A bare descendant name (`LineItemInfo`) or a
+                    document-rooted path (`/Orders/Order/Items/LineItemInfo`) matches nothing while a
+                    resource path is set; without a resource path the path must start at the document
+                    root. `//Element` descendant paths never match.
               includeNodes:
                 type: array
                 description: |

package/dist/processor.yml

@@ -195,9 +195,14 @@ paths:
                                     items:
                                       type: string
                                     description: |-
-                                      Element names that should always be arrays in the
-                                      output, even when containing a single item. Only
-                                      active when `V0_json` is `false`.
+                                      Paths of elements that always parse as arrays. An
+                                      element that occurs once otherwise parses as an
+                                      object, and as an array only when it repeats. Each
+                                      entry is the element's full path from the record
+                                      element selected by `resourcePath` (from the
+                                      document root when `resourcePath` is unset), with
+                                      an optional leading slash; `//` descendant paths do
+                                      not match. Only active when `V0_json` is `false`.
                                   includeNodes:
                                     type: array
                                     items:

package/dist/tool.yml

@@ -35639,6 +35639,13 @@ components:
               There are two main parsing strategies available:
               - **Automatic parsing**: Simple but produces more complex output
               - **Custom parsing**: More control over the resulting JSON structure
+            x-celigo-ai-guidance:
+              - |-
+                With V0_json false, an empty element (`<FirstName></FirstName>`, `<FirstName/>`) parses to
+                an empty object `{}` under every setting here, not an empty string. A Handlebars template
+                that outputs the field renders `[object Object]`; guard it with
+                `{{#if (eq (typeOf FirstName) "string")}}{{FirstName}}{{/if}}` — a bare `{{#if FirstName}}`
+                does not skip it because `{}` is truthy.
             properties:
               V0_json:
                 type: boolean
@@ -35660,22 +35667,29 @@ components:
               listNodes:
                 type: array
                 description: |
-                  Specifies which XML nodes should be treated as arrays (lists) in the output JSON.
-
-                  It's not always possible to automatically determine if an XML node should be a single value
-                  or an array. Use this field to explicitly identify nodes that should be treated as arrays,
-                  even if they appear only once in the XML.
-
-                  Each entry should be a simplified XPath expression pointing to the node that should be
-                  treated as an array.
-
-                  Only relevant when V0_json is set to false (Custom parsing).
+                  Paths of elements that always parse as arrays. An element that can repeat parses as an
+                  object when it occurs once and as an array when it occurs more than once, so list every
+                  repeating element here to give each record the same shape regardless of item count.
+                  Each entry is the element's full path from the record element selected by the resource
+                  path (from the document root when there is no resource path), with an optional leading
+                  slash. Only relevant when V0_json is set to false (Custom parsing).
                 items:
                   type: string
                 examples:
                   - - /product-lineitems/product-lineitem
                     - /shipping-lineitems/shipping-lineitem
                     - /shipments/shipment
+                x-celigo-ai-guidance:
+                  - |-
+                    Add every element that can repeat. Left out, a one-item record parses it as an object:
+                    a Handlebars `{{#each}}` over it iterates the object's fields (each field reference
+                    renders empty) and mappings or filters written against an array find nothing.
+                  - |-
+                    Write the full path from the record element: `Items/LineItemInfo` for records at
+                    resource path `/Orders/Order`. A bare descendant name (`LineItemInfo`) or a
+                    document-rooted path (`/Orders/Order/Items/LineItemInfo`) matches nothing while a
+                    resource path is set; without a resource path the path must start at the document
+                    root. `//Element` descendant paths never match.
               includeNodes:
                 type: array
                 description: |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@celigo/api-specs",
-  "version": "0.2.46",
+  "version": "0.2.47",
   "private": false,
   "description": "Public OpenAPI bundles (dist/) and the celigo-cli lint schema pack (schemas.json).",
   "keywords": [

package/schemas.json

@@ -1,8 +1,8 @@
 {
 	"provenance": {
 		"repo": "celigo/integrator-api-specs",
-		"iasCommit": "ddd3cac",
-		"generatedAt": "2026-09-22"
+		"iasCommit": "f237220",
+		"generatedAt": "2026-09-23"
 	},
 	"roots": {
 		"aiagent": 133,