@cxtms/cx-schema 1.9.247 → 1.9.249

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cxtms/cx-schema",
-  "version": "1.9.247",
+  "version": "1.9.249",
   "description": "Schema validation package for CXTMS YAML modules",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/schemas/components/dataGrid.json

@@ -23,6 +23,12 @@
           "description": "Name of the refresh handler",
           "x-example": "states"
         },
+        "toolbarSx": {
+          "type": "object",
+          "description": "MUI sx overrides merged onto the toolbar CardContent, useful for reducing padding in narrow hosts",
+          "additionalProperties": true,
+          "x-example": { "px": 2, "py": 1 }
+        },
         "enableStore": {
           "type": "boolean",
           "description": "Enable store for the datagrid, row data will be placed in the store"

package/schemas/schemas.json

@@ -200,6 +200,15 @@
           "type": "string",
           "description": "Default search term seeded once when the grid first loads this view. Supports template expressions; URL search parameters and user input take precedence."
         },
+        "collection": {
+          "type": "object",
+          "properties": {
+            "itemName": { "type": "string" },
+            "children": { "$ref": "#/definitions/componentChildren" },
+            "dragSource": { "type": "object", "required": ["type"], "properties": { "type": { "type": "string" }, "data": {}, "canDrag": {} }, "additionalProperties": false }
+          },
+          "additionalProperties": true
+        },
         "childViews": {
           "type": "array",
           "description": "Nested child views",

package/schemas/workflows/tasks/all.json

@@ -4,6 +4,9 @@
   "description": "Aggregator schema for all workflow task types. Uses anyOf to allow matching any known task type or falling back to generic task structure.",
   "type": "object",
   "anyOf": [
+    {
+      "$ref": "browser-run.json"
+    },
     {
       "$ref": "accounting-transaction.json"
     },

package/schemas/workflows/tasks/browser-run.json

@@ -0,0 +1,17 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Browser/Run Workflow Task",
+  "type": "object",
+  "required": ["task", "inputs"],
+  "properties": {
+    "task": { "type": "string", "pattern": "^Browser/Run(?:@1)?$" }, "name": { "type": "string" }, "description": { "type": "string" }, "continueOnError": { "type": "boolean" },
+    "inputs": { "type": "object", "required": ["actions"], "properties": {
+      "allowedDomains": { "type": "array", "items": { "type": "string" } }, "provider": { "type": "string" }, "session": { "enum": ["reuse", "new"] }, "timeout": { "type": "number", "exclusiveMinimum": 0 },
+      "actions": { "type": "array", "minItems": 1, "items": { "type": "object", "required": ["do"], "properties": {
+        "do": { "enum": ["goto", "click", "check", "uncheck", "hover", "waitFor", "fill", "press", "selectOption", "waitForNavigation", "extractText", "extractAttribute", "extractTable", "extractUrl", "screenshot", "uploadFile", "download", "llm/act"] },
+        "target": { "type": "string" }, "value": {}, "url": { "type": "string" }, "query": { "type": "object" }, "file": { "type": "object" }, "attribute": { "type": "string" }, "as": { "type": "string" }, "all": { "type": "boolean" }, "if": { "type": "string" }, "sensitive": { "type": "boolean" }, "timeout": { "type": "number", "exclusiveMinimum": 0 }, "instructions": { "type": "string" }, "model": { "type": "string" }, "maxTurns": { "type": "integer", "minimum": 1, "maximum": 20 }
+      }, "additionalProperties": false } }
+    }, "additionalProperties": false },
+    "outputs": { "type": "array", "items": { "type": "object", "additionalProperties": true } }
+  }, "additionalProperties": true
+}

package/skills/cxtms-developer/ref-graphql-query.md

@@ -36,6 +36,8 @@ Available root queries: `orders`, `contacts`, `commodities`, `accountingTransact
 
 Order quick search (`orders.search` and `orderGroupBy.search`) matches order number, bill-to, carriers, tracking numbers, order entities, commodity text/tracking numbers, and InventoryItem values linked through order commodities or child/container commodities. Inventory item matches include `sku`, `productName`, `description`, `modelNumber`, and JSON `customValues` such as color or size.
 
+Order-move quick search (`orderMoves.search`) matches the move name plus its owning order's tracking number and JSON custom values (for example, a container number). Matching is case-insensitive and accepts partial text.
+
 ## App Module Metadata Visibility
 
 GraphQL metadata queries hide rows attached to soft-deleted app modules:

package/skills/cxtms-module-builder/ref-components-data.md

@@ -49,6 +49,19 @@ props:
 
 Use `options.items` for already-loaded arrays; use `options.query` for server-side search/sort/pagination.
 
+## dataGrid collection drag sources
+
+Collection views can publish cards to planner drop targets. Configure `collection.dragSource.type`, with optional per-row `data` and `canDrag` templates. Omitted `data` sends the whole row; prefer a small JSON-safe payload. Native drag is desktop-only.
+
+```yaml
+collection:
+  itemName: item
+  dragSource:
+    type: orderMove
+    canDrag: "{{ eval !item.assignedDriverContactId }}"
+    data: { orderMoveId: "{{ item.orderMoveId }}" }
+```
+
 ---
 
 ## dataGrid conditional filter columns

package/skills/cxtms-module-builder/ref-components-display.md

@@ -26,6 +26,7 @@ Full-featured data table with views, filtering, sorting, pagination, and row act
 | Prop | Type | Description |
 |------|------|-------------|
 | `toolbar` | `component[]` | Header toolbar components |
+| `toolbarSx` | `object` | MUI `sx` overrides merged onto the toolbar `CardContent`; use this to reduce padding in narrow hosts without hiding toolbar controls |
 | `dotsMenu` | `{items[]}` | Three-dot menu per row |
 | `dotsMenu.items[]` | `{label, icon, onClick, permission, isHidden, disabled}` | Menu item |
 

package/skills/cxtms-module-builder/ref-components-specialized.md

@@ -623,3 +623,6 @@ props:
         variables: { token: "{{ token }}" }
     - notification: { message: { en-US: "Connected!" }, type: success }
 ```
+# Planner drop targets
+
+Planner `props.drop` accepts DataGrid collection drag sources. Configure `accept`, `onlyEmptyCells` (default true), `canDrop`, and `autoScroll` (default true), then handle `events.onItemDrop`. The action receives `dragItem`, `dragType`, `row`, `column`, `rowIndex`, and `columnIndex`. Keep `onCellClick` as the touch and keyboard alternative.

package/skills/cxtms-workflow-builder/SKILL.md

@@ -327,6 +327,7 @@ Implicit variable: `iteration` (zero-based).
 | File Transfer | Connect, Disconnect, ListFiles, Download, Upload, Move, Delete | `!cat skills/cxtms-workflow-builder/ref-filetransfer.md` |
 | Accounting | AccountingTransaction, Payment, Number/Generate, SequenceNumber | `!cat skills/cxtms-workflow-builder/ref-accounting.md` |
 | Other | User, Auth, Caching, X12/Parse, EDIFACT, Flow/Transition, Notes, AppModule, ActionEvent | `!cat skills/cxtms-workflow-builder/ref-other.md` |
+| Browser Automation | Browser/Run | `!cat skills/cxtms-workflow-builder/ref-browser.md` |
 
 ## Entity Field Reference (cxtms-developer)
 

package/skills/cxtms-workflow-builder/ref-browser.md

@@ -0,0 +1,17 @@
+# Browser Automation
+
+## Browser/Run@1
+
+Automates a web portal through a configured remote Chromium provider. Always restrict navigation with `allowedDomains`; use `$` inputs or `fromConfig` variables for credentials and mark credential fills `sensitive: true`.
+
+```yaml
+- task: Browser/Run@1
+  name: Portal
+  inputs:
+    allowedDomains: [portal.example.com]
+    actions:
+      - { do: goto, url: "https://portal.example.com" }
+      - { do: extractText, target: "css=.status", as: status }
+```
+
+Inputs: required `actions`; optional `allowedDomains`, `provider`, `session` (`reuse` or `new`), and `timeout`. Actions support deterministic navigation/input/extraction, screenshots, upload/download, plus `llm/act`. Locator targets require a `css=`, `xpath=`, `text=`, `label=`, `placeholder=`, or `role=` prefix. Captures use `as`; the task also returns final `url` and an action audit list.