@cxtms/cx-schema 1.9.246 → 1.9.248

package/package.json

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

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-entity-order.md

@@ -74,8 +74,8 @@ Order GraphQL quick search (`orders(search:)` and `orderGroupBy(search:)`) match
 | `orderCarriers` | `[OrderCarrier]` | |
 | `dispatchRouteStopOrders` | `[DispatchRouteStopOrder]` | Stop membership links for this order; expand `dispatchRouteStop` to inspect route, stop status, or stop tracking events |
 | `allTags` | `[OrderAllTagsView]` | View: all tags including from commodities |
-| `allRelatedOrders` | `[OrderRelatedOrdersView]` | Orders sharing commodities |
-| `relatedOrdersV3` | `[OrderRelatedOrdersV3View]` | Filter/sort navigation backed by the non-recursive V3 view; use paths such as `relatedOrdersV3[relatedOrder.orderType:BookingOrder].relatedOrder.trackingNumber` |
+| `allRelatedOrders` | `[OrderRelatedOrdersView]` | Organization-scoped related orders backed by the kinship view; preferred filter/sort navigation, e.g. `allRelatedOrders[relatedOrder.orderType:BookingOrder].relatedOrder.trackingNumber` |
+| `relatedOrdersV3` | `[OrderRelatedOrdersV3View]` | Compatibility navigation over the same relation for existing module paths |
 | `relatedDispatchRoutes` | `[DispatchRoute]` | Routes linked through dispatch route stop order attachments; supports `filter` and `orderBy`; draft orders return an empty list |
 | `attachmentsSummary` | `OrderAttachmentSummaryView?` | DB view: `.totalCount`, `.hasAny` (active attachments) |
 | `notesSummary` | `OrderNoteSummaryView?` | DB view: `.totalCount`, `.hasAny` (non-deleted notes) |

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-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.