@cxtms/cx-schema 1.1.0 → 1.2.1

package/.claude/skills/cx-workflow/ref-entity.md

@@ -0,0 +1,162 @@
+# Entity CRUD Tasks Reference
+
+All entity tasks follow the `Namespace/Operation@Version` pattern. Outputs are stored as `ActivityName.StepName.outputKey`.
+
+## Generic Entity Change
+
+| Task | Description |
+|------|-------------|
+| `Entity/Change` | Generic entity change (works for any entity type) |
+
+## Order
+
+| Task | Description |
+|------|-------------|
+| `Order/Create` | Create a new order |
+| `Order/Update` (v1, v2) | Update order fields |
+| `Order/Delete` | Delete an order |
+| `Order/Get` | Get order by ID |
+| `Order/Copy` | Copy/duplicate an order |
+| `Order/Split` | Split order into multiple |
+| `Order/Purge` | Purge order data |
+| `Order/Import` | Import order from external data |
+| `Order/RecalculateCharges` | Recalculate all charges |
+| `Order/GenerateTrackingNumber` | Generate tracking number |
+| `Order/GetCargoMovementByPalletQuery` | Query cargo movements by pallet |
+
+```yaml
+- task: "Order/Create@1"
+  name: CreateOrder
+  inputs:
+    orderType: "ParcelShipment"
+    entity:
+      customer: "{{ inputs.customerId }}"
+      status: "Draft"
+  outputs:
+    - name: order
+      mapping: "order"
+```
+
+```yaml
+- task: "Order/Update@2"
+  name: UpdateOrder
+  inputs:
+    orderId: "{{ inputs.orderId }}"
+    entity:
+      status: "Active"
+      notes: "Updated by workflow"
+```
+
+## Contact
+
+| Task | Description |
+|------|-------------|
+| `Contact/Create` | Create contact |
+| `Contact/Update` | Update contact |
+| `Contact/Delete` | Delete contact |
+
+## Contact Address
+
+| Task | Description |
+|------|-------------|
+| `ContactAddress/Create` | Create address |
+| `ContactAddress/Update` | Update address |
+| `ContactAddress/Delete` | Delete address |
+| `ContactAddress/Import` | Bulk import addresses |
+
+## Contact Payment Method
+
+| Task | Description |
+|------|-------------|
+| `ContactPaymentMethod/Create` | Create payment method |
+| `ContactPaymentMethod/Update` | Update payment method |
+| `ContactPaymentMethod/SendChargedAmount` | Send charged amount notification |
+| `ContactPaymentMethod/VerifyChargedAmount` | Verify charged amount |
+
+## Commodity
+
+| Task | Description |
+|------|-------------|
+| `Commodity/Create` | Create commodity |
+| `Commodity/Update` (v1, v2) | Update commodity |
+| `Commodity/Split` | Split commodity into multiple |
+| `Commodity/Repack` | Repack commodities |
+| `Commodity/Unpack` | Unpack commodity |
+
+## Commodity Tracking Number
+
+| Task | Description |
+|------|-------------|
+| `CommodityTrackingNumber/Create` | Create tracking number |
+| `CommodityTrackingNumber/Update` | Update tracking number |
+| `CommodityTrackingNumber/Delete` | Delete tracking number |
+
+## Job
+
+| Task | Description |
+|------|-------------|
+| `Job/Create` | Create job |
+| `Job/Update` | Update job |
+| `Job/Delete` | Delete job |
+| `Job/Assign` | Assign job to user/driver |
+| `Job/Unassign` | Unassign job |
+
+## Charge
+
+| Task | Description |
+|------|-------------|
+| `Charge/Create` | Create charge |
+| `Charge/Update` | Update charge |
+| `Charge/Delete` | Delete charge |
+| `Charge/DynamicUpdate` | Dynamic update (partial fields) |
+| `Charge/Calculate` | Calculate charge amount |
+
+```yaml
+- task: "Charge/Create@1"
+  name: CreateCharge
+  inputs:
+    orderId: "{{ inputs.orderId }}"
+    chargeType: "Freight"
+    amount: "{{ Data.GetRate.rate.amount }}"
+    currency: "USD"
+  outputs:
+    - name: charge
+      mapping: "charge"
+```
+
+## Discount
+
+| Task | Description |
+|------|-------------|
+| `Discount/Update` | Update discount |
+
+## Order Sub-Entities
+
+| Task | Description |
+|------|-------------|
+| `OrderCommodity/Create` | Link commodity to order |
+| `OrderCommodity/Update` | Update order-commodity link |
+| `OrderCommodity/Delete` | Remove commodity from order |
+| `OrderCharge/Create` | Create order charge |
+| `OrderDocument/Create` | Create order document |
+| `OrderDocument/Send` | Send order document |
+| `OrderTrackingEvent/Create` | Create tracking event |
+| `OrderEntity/ChangeCustomValue` | Change custom field value |
+
+## Inventory
+
+| Task | Description |
+|------|-------------|
+| `InventoryItem/Create` | Create inventory item |
+| `InventoryItem/Update` | Update inventory item |
+| `InventoryItem/Delete` | Delete inventory item |
+
+## Other
+
+| Task | Description |
+|------|-------------|
+| `Movement/Create` | Create cargo movement |
+| `Country/Create`, `Country/Update`, `Country/Delete` | Country CRUD |
+| `Cities/Import` | Import cities |
+| `Rate/Update` | Update rate |
+| `TrackingEvent/Import` | Import tracking events |

package/.claude/skills/cx-workflow/ref-expressions.md

@@ -0,0 +1,239 @@
+# Variable References & Expressions
+
+There are **two distinct syntaxes** for referencing variables, used in different contexts.
+
+## Template Expressions: `{{ path }}` (in step inputs)
+
+Used in step `inputs` values. Resolves variable paths from scoped variables.
+
+```yaml
+inputs:
+  orderId: "{{ inputs.orderId }}"                    # Simple reference
+  url: "{{ chopinConfig.baseUrl }}/api/v1"           # String interpolation
+  order: "{{ Data.GetOrder.order }}"                 # Raw object (single {{ }})
+  name: "Order {{ Data.GetOrder.order.orderNumber }}" # String interpolation (multiple)
+```
+
+**Key behavior**: A single `{{ path }}` returns the **raw object** (preserving type). Multiple `{{ }}` in a string returns string interpolation (each resolved value is `.ToString()`).
+
+### Type Converters (prefix in {{ }})
+
+```yaml
+organizationId: "{{ int organizationId }}"
+amount: "{{ decimal totalAmount }}"
+isActive: "{{ bool isActive }}"
+flag: "{{ boolOrFalse someFlag }}"        # null -> false
+flagOn: "{{ boolOrTrue someFlag }}"       # null -> true
+notes: "{{ emptyIfNull notes }}"          # null -> ""
+notes: "{{ nullIfEmpty notes }}"          # "" or whitespace -> null
+config: "{{ fromJson configJsonString }}" # JSON string -> dict/array
+payload: "{{ toJson someObject }}"        # object -> JSON string
+name: "{{ trim value }}"
+search: "{{ luceneString query }}"        # escape & quote for Lucene
+```
+
+| Converter | Returns | Null handling |
+|-----------|---------|---------------|
+| `string` | `string` | null. Reads `Stream` to string if value is Stream |
+| `int` | `int` | Throws on null |
+| `decimal` | `decimal` | Throws on null |
+| `bool` | `bool` | Throws on null |
+| `boolOrFalse` | `bool` | `false` if null |
+| `boolOrTrue` | `bool` | `true` if null |
+| `datetime` | `DateTime` | Throws on null |
+| `emptyIfNull` | same type | `""` if null, `0` for int?, `0m` for decimal? |
+| `nullIfEmpty` | same type | `null` if empty/whitespace string or empty collection |
+| `luceneString` | `string` | null |
+| `transliterate` | `string` | null (Unicode -> ASCII via Unidecode) |
+| `transliterateUa` | `string` | null (Ukrainian-specific rules) |
+| `fromJson` | `dict` or `array` | null. Empty string -> empty dict |
+| `toJson` | `string` | `""` if null |
+| `trim` | `string` | null |
+
+### Value Directives (in YAML input mappings)
+
+**`expression`** -- Evaluate NCalc expression as a value:
+```yaml
+amount:
+  expression: "[price] * [quantity]"
+```
+
+**`coalesce`** -- First non-null value from a list:
+```yaml
+displayName:
+  coalesce:
+    - "{{ customer.name? }}"
+    - "{{ customer.email? }}"
+    - "Unknown"
+```
+
+**`foreach`** (value context) -- Transform collections inline:
+```yaml
+commodities:
+  foreach: "sourceCommodities"
+  item: "item"                             # default: "item"
+  conditions: "[item.isActive] = true"     # optional NCalc filter per item
+  continueOnError: false                   # optional, skip errors
+  mapping:                                 # dict -> List<dict>, string -> List<object>
+    name: "{{ item.name }}"
+    quantity: "{{ item.qty }}"
+```
+
+**`switch`** (value context) -- Value-based switch (case-insensitive match):
+```yaml
+perLb:
+  switch: "{{ contact.commissionTier }}"
+  cases:
+    "tier1": "{{ rate.customValues.commission_per_lb_tier1 }}"
+    "tier2": "{{ rate.customValues.commission_per_lb_tier2 }}"
+  default: "0"
+```
+
+**`extends`** -- Extend/merge an existing object or array:
+```yaml
+orderData:
+  extends: "{{ existingOrder }}"           # base object or array
+  defaultIfNull: {}                        # fallback if extends is null
+  mapping:                                 # dict: merge overrides. array: append items
+    status: "Updated"
+    notes: "{{ newNotes }}"
+```
+
+**`$raw`** -- Prevent template parsing (pass as-is):
+```yaml
+template:
+  $raw: "This {{ won't }} be parsed"
+```
+
+**`$eval`** -- Parse JSON string then evaluate as template:
+```yaml
+dynamicConfig:
+  $eval: "{{ configJsonString }}"
+```
+
+**`decrypt`** / **`encrypt`** -- AES-CBC encryption (optional key/IV, has defaults):
+```yaml
+apiKey:
+  decrypt:
+    encryptedValue: "{{ encryptedApiKey }}"
+    key: "{{ encryptionKey }}"             # optional Base64 AES key
+    initializationVector: "{{ iv }}"       # optional Base64 IV
+```
+
+---
+
+## NCalc Expressions: `[variable]` (in conditions and expression directives)
+
+Used in `conditions[].expression`, `switch` case `when`, and `expression:` value directives. Variables use **square bracket** `[name]` syntax.
+
+```yaml
+conditions:
+  - expression: "[status] = 'Active' AND [amount] > 100"
+  - expression: "isNullOrEmpty([Data.GetOrder.order?]) = false"
+  - expression: "any([changes], [each.key] = 'Status') = true"
+```
+
+**Parameter resolution rules**:
+- Empty strings are converted to `null` (so `""` is treated as no value)
+- Numeric strings are auto-converted to `decimal` when needed (e.g., `[price] > 100` works even if price is the string `"150"`)
+- Dot paths resolve deep: `[Activity.Step.output.nested.field]`
+- Optional suffix `?` prevents errors: `[order.customer?.name?]`
+
+### Operators
+
+| Type | Operators |
+|------|-----------|
+| Comparison | `=`, `!=`, `<>`, `<`, `>`, `<=`, `>=` |
+| Logical | `AND`, `OR`, `NOT` (also `&&`, `\|\|`, `!`) |
+| Arithmetic | `+`, `-`, `*`, `/`, `%` |
+| Ternary | `if(condition, trueVal, falseVal)` |
+| Membership | `in(value, val1, val2, ...)` |
+
+### Iterator Variables
+
+Functions use two iterator variable names:
+- **`[each.*]`** -- used by: `any`, `all`, `sum`, `join` (3-arg)
+- **`[item.*]`** -- used by: `first`, `last`, `groupBy`
+
+### Collection Functions
+
+| Function | Description |
+|----------|-------------|
+| `any([items], [each.prop] = 'val')` | True if any item matches expression. Without expression: checks if collection contains the value |
+| `all([items], [each.prop] > 0)` | True if all items match. Returns `false` for null/empty collections |
+| `count([items])` | Count items in list or JToken. Returns `0` for non-collections |
+| `sum([items], [each.amount])` | Sum values as `decimal`. Optional `[each.*]` accessor. Skips nulls |
+| `first([items])` or `first([items], [item.name])` | First item or evaluate expression on first item. Returns `""` if empty |
+| `last([items])` or `last([items], [item.name])` | Last item or evaluate expression on last item. Returns `""` if empty |
+| `distinct([items])` | Remove duplicates. Uses deep comparison for dictionaries |
+| `reverse([items])` | Reverse collection or string |
+| `contains([source], 'needle')` | String contains, JArray contains, list contains, or dict key/value contains |
+| `removeEmpty([items])` | Remove null and whitespace-only items |
+| `concat([list1], [list2], ...)` | Concatenate multiple collections into flat list. Variadic args. Skips nulls |
+| `groupBy([items], [item.cat])` | Group by one or more key expressions. Returns `[{key, items}]`. Multi-key: keys joined with `\|` |
+| `join([items], [each.name], ',')` | Join collection with `[each.*]` accessor and separator (3-arg) |
+| `join([items], ',')` | Join collection directly with separator (2-arg) |
+| `split([str], ' ')` | Split string by first character of separator. Returns `List<string>` |
+
+### String Functions
+
+| Function | Description |
+|----------|-------------|
+| `isNullOrEmpty([var])` | True if null, empty string, or empty list |
+| `length([var])` | String length or collection count. `0` for null strings and non-collections |
+| `lower([name])` / `upper([code])` | Case conversion. Handles string, JToken, any `.ToString()` |
+| `left([code], 3)` / `right([code], 3)` | Left/right N characters. Returns full string if shorter than N |
+| `replace([str], 'old', 'new')` | String replacement. Returns null if any arg is null |
+| `trim([value])` | Trim whitespace. Returns `""` for null |
+| `format('{0}-{1}', [prefix], [id])` | String.Format style. Variadic args. Returns null if format is null |
+| `base64([value])` / `fromBase64([encoded])` | Base64 encode/decode. Handles string, byte[], JToken |
+| `bool([value])` | Convert to boolean: null->`false`, empty string->`false`, "true"/"false"->parsed, non-zero number->`true`, any object->`true` |
+| `transliterate([value])` | Unicode to ASCII (Unidecode). Returns `""` for null |
+| `transliterateUa([value])` | Ukrainian-specific transliteration. Returns `""` for null |
+| `parseAddress([address])` | Parse address -> `{StreetNumber, StreetName}`. Handles US and EU formats |
+
+### Date Functions
+
+| Function | Description |
+|----------|-------------|
+| `now()` | Current UTC `DateTime` |
+| `now('yyyy-MM-dd', 'en-US')` | Formatted current time as string |
+| `addDays([date], 30)` | Add days (decimal, can be negative). Accepts DateTime, DateTimeOffset, string |
+| `addHours([date], 2)` | Add hours (decimal, can be negative). Same type handling |
+| `formatDate([date], 'dd/MM/yyyy', 'en-US')` | Format date with culture. Accepts DateTime or string |
+| `dateFromUnix([unixTime])` | Unix timestamp (seconds) -> `DateTimeOffset`. Accepts int, long, decimal, string |
+| `dateToUtc([date])` or `dateToUtc([date], 'en-US')` | Convert to UTC. Optional culture for string parsing |
+
+### Math Functions (NCalc built-in)
+
+`Abs(x)`, `Ceiling(x)`, `Floor(x)`, `Round(x, decimals)`, `Min(x, y)`, `Max(x, y)`, `Pow(x, y)`, `Sqrt(x)`, `Truncate(x)`
+
+Custom: `ceiling([value])` -- same as `Ceiling` but handles type conversion to double.
+
+### Domain Functions
+
+| Function | Description |
+|----------|-------------|
+| `convertWeight([weight], 'Kg', 'Lb')` | Weight unit conversion. Returns `decimal` rounded to 5 places |
+| `convertDimension([length], 'Cm', 'In')` | Dimension unit conversion. Returns `decimal` rounded to 3 places |
+
+---
+
+## Property Path Syntax (in collection, mapping, variable paths)
+
+Used in `collection:` (foreach), `mapping:` (outputs), and variable resolution.
+
+| Pattern | Description | Example |
+|---------|-------------|---------|
+| `a.b.c` | Dot-separated nested path | `order.customer.name` |
+| `prop?` | Optional access (null if missing) | `order.customer?.name?` |
+| `list[0]` | Array index | `items[0]` |
+| `list[^1]` | Index from end (last item) | `items[^1]` |
+| `list[*]` | Flatten/wildcard (all items) | `containers[*].commodities` |
+| `list[**]` | Recursive flatten (all depths) | `containerCommodities[**]` |
+| `list[-1]` | Depth filter (leaves only) | `tree[**][-1]` |
+| `list[condition]` | Filter by condition | `items[status=Active]` |
+| `dict['key']` | Dictionary key access | `customValues['myField']` |
+| `list[*].{f1 f2}` | Field selector (projection) | `items[*].{name description}` |
+| `list[*].{alias:source}` | Field selector with alias | `items[*].{id:commodityId}` |
+| `list[*].{alias:_.parent}` | Field selector referencing parent | `items[*].{parentId:_.orderId}` |

package/.claude/skills/cx-workflow/ref-filetransfer.md

@@ -0,0 +1,80 @@
+# File Transfer Tasks Reference
+
+SFTP/FTP file transfer operations. Use `FileTransfer/Connect` to establish a session, perform file operations, then `FileTransfer/Disconnect`.
+
+## Connection Lifecycle
+
+```yaml
+activities:
+  - name: Transfer
+    steps:
+      - task: "FileTransfer/Connect@1"
+        name: Connect
+        inputs:
+          host: "{{ sftpConfig.host }}"
+          port: "{{ sftpConfig.port }}"
+          username: "{{ sftpConfig.username }}"
+          password: "{{ sftpConfig.password }}"
+          protocol: "sftp"
+        outputs:
+          - name: connection
+            mapping: "connection"
+
+      - task: "FileTransfer/ListFiles@1"
+        name: ListFiles
+        inputs:
+          connection: "{{ Transfer.Connect.connection }}"
+          path: "/incoming"
+        outputs:
+          - name: files
+            mapping: "files"
+
+      - task: foreach
+        name: ProcessFiles
+        collection: "Transfer.ListFiles.files"
+        item: "file"
+        steps:
+          - task: "FileTransfer/DownloadFile@1"
+            name: Download
+            inputs:
+              connection: "{{ Transfer.Connect.connection }}"
+              path: "{{ file.path }}"
+            outputs:
+              - name: content
+                mapping: "content"
+
+          - task: "FileTransfer/MoveFile@1"
+            name: Archive
+            inputs:
+              connection: "{{ Transfer.Connect.connection }}"
+              sourcePath: "{{ file.path }}"
+              destinationPath: "/processed/{{ file.name }}"
+
+      - task: "FileTransfer/Disconnect@1"
+        name: Disconnect
+        inputs:
+          connection: "{{ Transfer.Connect.connection }}"
+```
+
+## Available Tasks
+
+| Task | Description |
+|------|-------------|
+| `FileTransfer/Connect` | Establish SFTP/FTP connection |
+| `FileTransfer/Disconnect` | Close connection |
+| `FileTransfer/ListFiles` | List files in remote directory |
+| `FileTransfer/DownloadFile` | Download file content |
+| `FileTransfer/UploadFile` | Upload file to remote |
+| `FileTransfer/MoveFile` | Move/rename remote file |
+| `FileTransfer/DeleteFile` | Delete remote file |
+
+## Upload Example
+
+```yaml
+- task: "FileTransfer/UploadFile@1"
+  name: Upload
+  inputs:
+    connection: "{{ Transfer.Connect.connection }}"
+    path: "/outgoing/report.csv"
+    content: "{{ GenerateReport.Export.file }}"
+```

package/.claude/skills/cx-workflow/ref-flow.md

@@ -0,0 +1,180 @@
+# Flow Workflow YAML Reference
+
+Flow workflows are declarative state machines for entity lifecycle management. Use `workflowType: Flow` in the workflow section.
+
+## Top-Level Structure
+
+```yaml
+workflow:
+  workflowId: "<uuid>"
+  name: "Flow Workflow Name"
+  workflowType: Flow                        # Required - identifies this as a Flow workflow
+  executionMode: Async
+  isActive: true
+  priority: 75                              # 0-100, default 50
+  tags: ["tag1"]
+  agentInstruction: "AI guidance"           # Optional
+  concurrency:
+    enabled: true
+    group: "groupName"
+    waitTime: 30
+
+entity:                                     # Required for Flow (replaces activities)
+  name: <EntityName>
+  type: <EntityType>                        # Required for Order, AccountingTransaction, Contact
+  includes: [<navigation-paths>]            # Optional
+  query: "<graphql-query>"                  # Optional
+
+states: [...]                               # Required, at least 1 state
+transitions: [...]                          # Required, at least 1 transition
+aggregations: [...]                         # Optional
+```
+
+## Entity Section
+
+Specifies which entity's lifecycle this flow manages.
+
+### Valid Entity Names
+Order, Commodity, AccountingTransaction, Workflow, OrganizationConfig, Contact, AppModule, Attachment, OrderCommodity, TrackingEvent, JobOrder
+
+### Entity Types (required for specific entities)
+
+**Order** requires type: Brokerage, ParcelShipment, Quote, WarehouseReceipt, AirShipmentOrder, OceanShipmentOrder, LoadOrder, DeliveryOrder
+**AccountingTransaction** requires type: Invoice, Bill, CreditMemo
+**Contact** requires type: Customer, Carrier, Vendor, Driver, Employee
+
+```yaml
+entity:
+  name: Order
+  type: ParcelShipment
+  includes:
+    - Commodities
+    - Customer
+    - Charges
+  query: "{ commodities { id, quantity }, customer { name, email } }"
+```
+
+## States Section
+
+Each state represents a status in the entity lifecycle.
+
+```yaml
+states:
+  - name: Draft                             # Required, unique
+    stage: Entry                            # Optional grouping label
+    isInitial: true                         # At most 1 initial state
+  - name: Active
+    stage: Processing
+  - name: AwaitingPickup
+    parent: Active                          # Hierarchical state
+  - name: InTransit
+    parent: Active
+    onEnter:                                # Steps on entering this state
+      - task: "Email/Send"
+        inputs:
+          template: in_transit_notification
+    onExit:                                 # Steps on exiting this state
+      - task: "Utilities/Log@1"
+        inputs:
+          message: "Leaving InTransit"
+  - name: Delivered
+    stage: Complete
+    isFinal: true                           # Terminal state, no outgoing transitions
+    requireConfirmation: true               # User must confirm before entering
+    query: "{ charges { id, amount } }"     # State-specific data query
+```
+
+### State Rules
+- **name**: Required, must be unique across all states
+- **isInitial**: At most one state can be initial
+- **isFinal**: Final states cannot be transition sources
+- **parent**: References another state; parent cannot be initial or final; children inherit parent transitions
+
+## Transitions Section
+
+Define how entities move between states.
+
+```yaml
+transitions:
+  - name: submit                            # Required, unique
+    displayName: "Submit Order"             # Optional UI label
+    from: Draft                             # Single state
+    to: Submitted                           # Must be a leaf state (no children)
+    trigger: manual                         # manual | auto | event
+
+  - name: auto_approve
+    from: Submitted
+    to: Approved
+    trigger: auto                           # Evaluated automatically
+    priority: 10                            # Higher = checked first (default 50)
+    conditions:
+      - expression: "Order.Amount < 1000"
+
+  - name: payment_received
+    from: AwaitingPayment
+    to: Paid
+    trigger: event                          # External event-driven
+    eventName: PaymentConfirmed             # Required when trigger is 'event'
+
+  - name: bulk_transition
+    from:                                   # Array of source states
+      - Draft
+      - Submitted
+    to: Cancelled
+    trigger: manual
+
+  - name: force_cancel
+    from: "*"                               # Wildcard: any non-final state
+    to: Cancelled
+    trigger: manual
+    steps:                                  # Steps during transition
+      - task: "Utilities/Log@1"
+        inputs:
+          message: "Force cancelled"
+```
+
+### Trigger Types
+- **manual**: User-initiated or API call
+- **auto**: Automatic evaluation based on conditions; sorted by priority descending
+- **event**: External event-driven; requires `eventName`
+
+### From States
+- Single state: `from: Draft`
+- Multiple states: `from: [Draft, Submitted]`
+- Wildcard (any non-final state): `from: "*"`
+
+### Execution Order
+1. Validate transition from current state
+2. Execute `onExit` steps (from source state)
+3. Execute transition `steps`
+4. Update entity status
+5. Execute `onEnter` steps (on target state)
+
+## Aggregations Section
+
+Reusable data queries for conditions.
+
+```yaml
+aggregations:
+  - name: allItemsReceived                  # Required, unique
+    expression: "all(Order.Commodities, item.ReceivedQuantity >= item.Quantity)"
+  - name: totalWeight
+    expression: "sum(Order.Commodities, item.Weight)"
+  - name: hasAnyDamaged
+    expression: "any(Order.Commodities, item.IsDamaged)"
+  - name: itemCount
+    expression: "count(Order.Commodities)"
+  - name: chargesByType
+    expression: "sum(Order.Charges, item.Amount)"
+    parameter: chargeType                   # Optional parameter
+```
+
+### Valid Aggregation Functions
+- **all(collection, predicate)** - All items match
+- **any(collection, predicate)** - At least one matches
+- **sum(collection, selector)** - Sum values
+- **count(collection)** - Count items
+- **first(collection)** - First item
+- **last(collection)** - Last item
+- **distinct(collection, selector)** - Unique values
+- **groupBy(collection, selector)** - Group by value