@cxtms/cx-schema 1.8.0 → 1.8.1

package/schemas/workflows/tasks/authentication.json

@@ -34,39 +34,25 @@
     },
     "inputs": {
       "type": "object",
-      "description": "OAuth2 authentication inputs",
+      "description": "Authentication operation inputs",
       "properties": {
-        "credentials": {
-          "type": "object",
-          "description": "OAuth2 credentials object (e.g., grant_type, client_id, client_secret)",
-          "additionalProperties": true
-        },
-        "tokenUrl": {
+        "provider": {
           "type": "string",
-          "description": "Token endpoint URL"
+          "description": "OAuth2 provider name"
         },
-        "headers": {
-          "type": "array",
-          "description": "Optional HTTP headers for the token request",
-          "items": {
-            "type": "object",
-            "additionalProperties": {
-              "type": "string"
-            }
-          }
+        "clientId": {
+          "type": "string",
+          "description": "OAuth2 client ID"
         },
-        "retryOptions": {
-          "type": "object",
-          "description": "Optional retry configuration for the HTTP request",
-          "additionalProperties": true
+        "clientSecret": {
+          "type": "string",
+          "description": "OAuth2 client secret"
         },
-        "cache": {
-          "type": "boolean",
-          "description": "Enable token caching (default: true). Set to false to always fetch a new token.",
-          "default": true
+        "tokenUrl": {
+          "type": "string",
+          "description": "Token endpoint URL"
         }
       },
-      "required": ["credentials", "tokenUrl"],
       "additionalProperties": true
     },
     "outputs": {

package/schemas/workflows/tasks/edi.json

@@ -8,6 +8,8 @@
       "type": "string",
       "enum": [
         "EDI/Parse@1",
+        "EDIFACT/Parse@1",
+        "EDIFACT/Generate@1",
         "StructuredFile/Parse"
       ],
       "description": "Task type identifier"
@@ -39,11 +41,101 @@
       "properties": {
         "content": {
           "type": "string",
-          "description": "File content to parse"
+          "description": "File content to parse (EDI/Parse)"
         },
         "format": {
           "type": "string",
           "description": "EDI format (e.g., X12, EDIFACT)"
+        },
+        "edifactData": {
+          "type": "string",
+          "description": "Raw EDIFACT data string (EDIFACT/Parse, EDIFACT/Generate)"
+        },
+        "messageType": {
+          "type": "string",
+          "enum": ["IFTMIN", "CONTRL", "APERAK"],
+          "description": "EDIFACT message type for parse/generate tasks"
+        },
+        "sender": {
+          "type": "object",
+          "description": "Sender identification for EDIFACT/Generate",
+          "properties": {
+            "id": { "type": "string", "description": "Sender ID (Trading Partner ID)" },
+            "qualifier": { "type": "string", "description": "Partner ID code qualifier (e.g., ZZZ)" }
+          }
+        },
+        "recipient": {
+          "type": "object",
+          "description": "Recipient identification for EDIFACT/Generate",
+          "properties": {
+            "id": { "type": "string", "description": "Recipient ID (e.g., INTTRA)" },
+            "qualifier": { "type": "string", "description": "Partner ID code qualifier" }
+          }
+        },
+        "documentNumber": {
+          "type": "string",
+          "description": "Shipment Identification Number"
+        },
+        "messageFunctionCode": {
+          "type": "string",
+          "enum": ["5", "9"],
+          "description": "9 = Original, 5 = Replace"
+        },
+        "references": {
+          "type": "array",
+          "description": "Business references (BN=Booking, BM=B/L, etc.)",
+          "items": {
+            "type": "object",
+            "properties": {
+              "qualifier": { "type": "string" },
+              "identifier": { "type": "string" }
+            }
+          }
+        },
+        "parties": {
+          "type": "array",
+          "description": "Party details (HI=Requestor, CZ=Shipper, CA=Carrier, CN=Consignee)",
+          "items": {
+            "type": "object",
+            "properties": {
+              "functionCode": { "type": "string" },
+              "identification": { "type": "string" },
+              "name": { "type": "string" }
+            }
+          }
+        },
+        "goodsItems": {
+          "type": "array",
+          "description": "Goods item details (GID segment group). Numeric fields (itemNumber, numberOfPackages) are serialized as strings.",
+          "items": {
+            "type": "object",
+            "properties": {
+              "itemNumber": { "type": ["integer", "string"], "description": "Goods item number (GID/0). Auto-incremented." },
+              "numberOfPackages": { "type": ["integer", "string"], "description": "Number of outer packages (C213/7224)" },
+              "packageType": { "type": "string", "description": "Package type code, UN/ECE rec. 21 (C213/7065, e.g. CT, PK, PL)" },
+              "packageTypeDescription": { "type": "string", "description": "Package type description (C213/7065 text)" },
+              "packageTypeAgencyCode": { "type": "string", "description": "Code list responsible agency (C213/3055). Auto-set to '6' (UN/ECE) when packageType is provided." },
+              "packageTypeDescriptionText": { "type": "string", "description": "Package type description text for B/L printing (C213/7064)" },
+              "innerPackageCount": { "type": ["integer", "string"], "description": "Number of inner packages (second C213/7224)" },
+              "innerPackageType": { "type": "string", "description": "Inner package type code (second C213/7065)" },
+              "grossWeight": { "type": ["number", "string"], "description": "Gross weight value" },
+              "weightUnit": { "type": "string", "description": "Weight unit (KGM, LBR)" },
+              "description": { "type": "string", "description": "Goods description free text" }
+            }
+          }
+        },
+        "equipment": {
+          "type": "array",
+          "description": "Container/equipment details",
+          "items": {
+            "type": "object",
+            "properties": {
+              "equipmentQualifier": { "type": "string" },
+              "equipmentIdentification": { "type": "string" },
+              "sizeTypeCode": { "type": "string" },
+              "fullEmptyIndicator": { "type": "string" }
+            }
+          }
         }
       },
       "additionalProperties": true

package/schemas/workflows/tasks/httpRequest.json

@@ -105,6 +105,10 @@
             }
           }
         },
+        "saveToFile": {
+          "type": "boolean",
+          "description": "When true, saves response body to a temp file instead of returning it in memory. Response returns { StatusCode, Headers, FilePath } instead of body content."
+        },
         "cache": {
           "type": "object",
           "properties": {

package/schemas/workflows/tasks/order.json

@@ -69,6 +69,51 @@
         "validateOnly": {
           "type": "boolean",
           "description": "Only validate, don't persist"
+        },
+        "data": {
+          "description": "Structured import data (for Order/Import@1)",
+          "additionalProperties": true
+        },
+        "options": {
+          "type": "object",
+          "description": "Import options (for Order/Import@1)",
+          "properties": {
+            "orderMatchByFields": {
+              "type": "array",
+              "items": { "type": "string" },
+              "description": "Fields to match existing orders. If null, creates new orders."
+            },
+            "contactMatchByFields": {
+              "type": "array",
+              "items": { "type": "string" },
+              "description": "Fields to match existing contacts for order entities."
+            },
+            "contactAddressMatchByFields": {
+              "type": "array",
+              "items": { "type": "string" },
+              "description": "Fields to match existing contact addresses within order entities."
+            },
+            "inventoryItemMatchByFields": {
+              "type": "array",
+              "items": { "type": "string" },
+              "description": "Fields to match existing inventory items on commodities."
+            },
+            "tagMatchByFields": {
+              "type": "array",
+              "items": { "type": "string" },
+              "description": "Fields to match existing tags."
+            },
+            "commodityMatchByFields": {
+              "type": "array",
+              "items": { "type": "string" },
+              "description": "Fields to match existing commodities."
+            },
+            "linkTrackingEventsToCommodities": {
+              "type": "boolean",
+              "description": "When true, imported tracking events are linked to the order's first-level (non-container) commodities. Default: false."
+            }
+          },
+          "additionalProperties": true
         }
       },
       "additionalProperties": true

package/schemas/workflows/tasks/resolve-timezone.json

@@ -0,0 +1,65 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "ResolveTimezone Task",
+  "description": "Resolve IANA timezone ID and UTC offset from geographic coordinates",
+  "type": "object",
+  "properties": {
+    "task": {
+      "type": "string",
+      "enum": ["Utilities/ResolveTimezone@1"],
+      "description": "Task type identifier"
+    },
+    "name": {
+      "type": "string",
+      "description": "Step name identifier"
+    },
+    "description": {
+      "type": "string",
+      "description": "Step description"
+    },
+    "conditions": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "expression": {
+            "type": "string"
+          }
+        },
+        "required": ["expression"]
+      }
+    },
+    "continueOnError": {
+      "type": "boolean"
+    },
+    "inputs": {
+      "type": "object",
+      "description": "ResolveTimezone inputs",
+      "properties": {
+        "latitude": {
+          "type": ["string", "number"],
+          "description": "Latitude coordinate (decimal degrees)"
+        },
+        "longitude": {
+          "type": ["string", "number"],
+          "description": "Longitude coordinate (decimal degrees)"
+        }
+      },
+      "required": ["latitude", "longitude"],
+      "additionalProperties": true
+    },
+    "outputs": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "name": { "type": "string" },
+          "mapping": { "type": "string" }
+        },
+        "required": ["name", "mapping"]
+      },
+      "description": "Outputs: timezoneId (IANA timezone string, e.g. 'America/Chicago'), utcOffset (number, hours from UTC, e.g. -5)"
+    }
+  },
+  "required": ["task", "name", "inputs"]
+}

package/schemas/workflows/tasks/transmission.json

@@ -93,7 +93,7 @@
             },
             "status": {
               "type": ["string", "integer"],
-              "enum": ["Pending", "InProgress", "Sent", "Received", "Delivered", "Acknowledged", "Rejected", "Error", "RetryScheduled", "Cancelled", "Expired", 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10],
+              "enum": ["Pending", "InProgress", "Sent", "Received", "Delivered", "Acknowledged", "Rejected", "Error", "RetryScheduled", "Cancelled", "Expired", "Accepted", 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11],
               "description": "Transmission status"
             },
             "endpoint": {

package/schemas/workflows/tasks/unzip-file.json

@@ -0,0 +1,68 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "UnzipFile Task",
+  "description": "Extract files from a ZIP archive (local path or URL)",
+  "type": "object",
+  "properties": {
+    "task": {
+      "type": "string",
+      "enum": ["Utilities/UnzipFile@1"],
+      "description": "Task type identifier"
+    },
+    "name": {
+      "type": "string",
+      "description": "Step name identifier"
+    },
+    "description": {
+      "type": "string",
+      "description": "Step description"
+    },
+    "conditions": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "expression": {
+            "type": "string"
+          }
+        },
+        "required": ["expression"]
+      }
+    },
+    "continueOnError": {
+      "type": "boolean"
+    },
+    "inputs": {
+      "type": "object",
+      "description": "UnzipFile inputs — provide either filePath or fileUrl",
+      "properties": {
+        "filePath": {
+          "type": "string",
+          "description": "Local file path to ZIP archive (from saveToFile or previous step)"
+        },
+        "fileUrl": {
+          "type": "string",
+          "description": "URL to ZIP archive (file://, http://, https://)"
+        },
+        "filePattern": {
+          "type": "string",
+          "description": "Glob-style pattern to filter extracted files (e.g. '*.csv', 'data_*.json'). If omitted, all files returned."
+        }
+      },
+      "additionalProperties": true
+    },
+    "outputs": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "name": { "type": "string" },
+          "mapping": { "type": "string" }
+        },
+        "required": ["name", "mapping"]
+      },
+      "description": "Outputs: Files (string[] — full paths to extracted files), Count (int — number of matched files)"
+    }
+  },
+  "required": ["task", "name", "inputs"]
+}

package/schemas/workflows/variable.json

@@ -1,7 +1,7 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
   "title": "Workflow Variable",
-  "description": "Definition of a workflow variable. Valid properties: name, value, fromConfig.",
+  "description": "Definition of a workflow variable. Valid properties: name, value, fromConfig, expression.",
   "type": "object",
   "properties": {
     "name": {
@@ -12,6 +12,10 @@
     "value": {
       "description": "Static variable value or template expression"
     },
+    "expression": {
+      "type": "string",
+      "description": "NCalc expression to evaluate at runtime. Has access to all previously resolved variables. Mutually exclusive with value and fromConfig."
+    },
     "fromConfig": {
       "oneOf": [
         {

package/schemas/workflows/workflow.json

@@ -102,6 +102,10 @@
           "type": "string",
           "description": "AI agent instruction describing how to use this workflow, expected inputs, and returned outputs"
         },
+        "fileName": {
+          "type": "string",
+          "description": "Path to the workflow YAML file (deprecated, use filePath)"
+        },
         "actionEvent": {
           "type": "object",
           "description": "Workflow action event configuration",

package/scripts/postinstall.js

@@ -182,7 +182,7 @@ function main() {
 
   console.log('✓ CX Schema Validator installed successfully!');
   console.log('\nUsage:');
-  console.log('  npx cxtms modules/your-module.yaml');
+  console.log('  npx cx-cli modules/your-module.yaml');
   console.log('  node .cx-schema/validate.js modules/your-module.yaml');
   console.log('  /cx-module <description>   (Claude Code skill - UI modules)');
   console.log('  /cx-workflow <description>  (Claude Code skill - workflows)');

package/templates/module-configuration.yaml

@@ -1,5 +1,5 @@
 # {{displayName}} Configuration Module
-# Generated by cxtms create module --template configuration
+# Generated by cx-cli create module --template configuration
 
 module:
   name: "{{displayNameNoSpaces}}"
@@ -8,37 +8,103 @@ module:
     en-US: "{{displayName}}"
   description:
     en-US: "{{displayName}} configuration module"
-  application: System
+  application: CargoXplorer
+  fileName: "{{fileName}}"
 
 components:
-  - name: Configurations/{{displayNameNoSpaces}}
+  - name: {{displayNameNoSpaces}}/Configuration
     displayName:
-      en-US: "{{displayName}} Config"
-    platforms:
-      - web
+      en-US: "{{displayName}}"
     layout:
-      component: layout
-      name: {{displayNameNoSpaces}}ConfigLayout
+      component: form
+      name: {{name}}Form
       props:
-        cols: 1
         title:
-          en-US: "{{displayName}} Configuration"
-        icon: Create
-        permission: System/OrganizationConfigs/Update
+          en-US: "{{displayName}}"
+        queries:
+          - name: getConfiguration
+            query:
+              command: |
+                query GetConfiguration($organizationId: Int!) {
+                  configuration(organizationId: $organizationId) {
+                    settingName
+                    maxRetries
+                    enableNotifications
+                  }
+                }
+              variables:
+                organizationId: "\{{organizationId}}"
+        initialValues:
+          fromQuery:
+            name: getConfiguration
+            path: configuration
+          append:
+            settingName: "Default Setting"
+            maxRetries: 3
+            enableNotifications: true
+        validationSchema:
+          settingName:
+            type: string
+            required: true
+          maxRetries:
+            type: number
+            required: true
+          enableNotifications:
+            type: boolean
+        onSubmit:
+          - type: mutation
+            props:
+              command: |
+                mutation SaveConfiguration($organizationId: Int!, $input: ConfigurationInput!) {
+                  saveConfiguration(organizationId: $organizationId, input: $input) {
+                    success
+                  }
+                }
+              variables:
+                organizationId: "\{{organizationId}}"
+                input: "\{{formValues}}"
+          - type: notification
+            props:
+              message:
+                en-US: "{{displayName}} saved successfully"
+              severity: success
       children:
         - component: field
-          name: customValues.enabled
+          name: settingName
+          props:
+            label:
+              en-US: "Setting Name"
+            type: text
+            required: true
+        - component: field
+          name: maxRetries
+          props:
+            label:
+              en-US: "Max Retries"
+            type: number
+        - component: field
+          name: enableNotifications
           props:
-            type: checkbox
             label:
-              en-US: "Enable {{displayName}}"
+              en-US: "Enable Notifications"
+            type: checkbox
 
-configurations:
-  - configName: "apps.{{name}}"
+routes:
+  - name: configuration
+    path: /{{name}}
+    component: {{displayNameNoSpaces}}/Configuration
+    props:
+      title:
+        en-US: "{{displayName}}"
+
+permissions:
+  - name: "{{displayNameNoSpaces}}/View"
     displayName:
-      en-US: "{{displayName}}"
-    description:
-      en-US: "{{displayName}} configuration"
-    component: "Configurations/{{displayNameNoSpaces}}"
-    defaultValue:
-      enabled: false
+      en-US: "View {{displayName}}"
+    roles:
+      - Admin
+  - name: "{{displayNameNoSpaces}}/Edit"
+    displayName:
+      en-US: "Edit {{displayName}}"
+    roles:
+      - Admin

package/templates/module-form.yaml

@@ -1,5 +1,5 @@
 # {{displayName}} Form Module
-# Generated by cxtms create module --template form
+# Generated by cx-cli create module --template form
 
 module:
   name: "{{displayNameNoSpaces}}"
@@ -8,8 +8,8 @@ module:
     en-US: "{{displayName}}"
   description:
     en-US: "{{displayName}} module"
-  application: System
-  filePath: "{{fileName}}"
+  application: CargoXplorer
+  fileName: "{{fileName}}"
 
 components:
   - name: {{displayNameNoSpaces}}/Detail

package/templates/module-grid.yaml

@@ -1,5 +1,5 @@
 # {{displayName}} Module
-# Generated by cxtms create module --template grid
+# Generated by cx-cli create module --template grid
 
 module:
   name: "{{displayNameNoSpaces}}"
@@ -8,8 +8,8 @@ module:
     en-US: "{{displayName}}"
   description:
     en-US: "{{displayName}} module"
-  application: System
-  filePath: "{{fileName}}"
+  application: CargoXplorer
+  fileName: "{{fileName}}"
 
 components:
   - name: {{displayNameNoSpaces}}/List

package/templates/module-select.yaml

@@ -1,5 +1,5 @@
 # {{displayName}} Select Module
-# Generated by cxtms create module --template select
+# Generated by cx-cli create module --template select
 
 module:
   name: "{{displayNameNoSpaces}}"
@@ -8,8 +8,8 @@ module:
     en-US: "{{displayName}}"
   description:
     en-US: "{{displayName}} async select component"
-  application: System
-  filePath: "{{fileName}}"
+  application: CargoXplorer
+  fileName: "{{fileName}}"
 
 components:
   - name: {{displayNameNoSpaces}}/Select

package/templates/module.yaml

@@ -1,5 +1,5 @@
 # {{displayName}} Module
-# Generated by cxtms create module
+# Generated by cx-cli create module
 
 module:
   name: "{{name}}"
@@ -8,8 +8,7 @@ module:
   description: "{{displayName}} module"
   icon: "folder"
   version: "1.0"
-  application: System
-  filePath: "{{fileName}}"
+  fileName: "{{fileName}}"
 
 entities:
   - name: {{name}}

package/templates/workflow-api-tracking.yaml

@@ -1,5 +1,5 @@
 # {{displayName}} Workflow
-# Generated by cxtms create workflow --template api-tracking
+# Generated by cx-cli create workflow --template api-tracking
 
 workflow:
   workflowId: "{{uuid}}"

package/templates/workflow-basic.yaml

@@ -1,5 +1,5 @@
 # {{displayName}} Workflow
-# Generated by cxtms create workflow --template basic
+# Generated by cx-cli create workflow --template basic
 
 workflow:
   workflowId: "{{uuid}}"

package/templates/workflow-document.yaml

@@ -1,5 +1,5 @@
 # {{displayName}} Workflow
-# Generated by cxtms create workflow --template document
+# Generated by cx-cli create workflow --template document
 
 workflow:
   workflowId: "{{uuid}}"

package/templates/workflow-entity-trigger.yaml

@@ -1,5 +1,5 @@
 # {{displayName}} Workflow
-# Generated by cxtms create workflow --template entity-trigger
+# Generated by cx-cli create workflow --template entity-trigger
 
 workflow:
   workflowId: "{{uuid}}"

package/templates/workflow-ftp-edi.yaml

@@ -1,5 +1,5 @@
 # {{displayName}} Workflow
-# Generated by cxtms create workflow --template ftp-edi
+# Generated by cx-cli create workflow --template ftp-edi
 
 workflow:
   workflowId: "{{uuid}}"