@cxtms/cx-schema 1.9.254 → 1.9.256

package/package.json

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

package/schemas/workflows/tasks/all.json

@@ -25,6 +25,9 @@
     {
       "$ref": "caching.json"
     },
+    {
+      "$ref": "calendar.json"
+    },
     {
       "$ref": "charge.json"
     },

package/schemas/workflows/tasks/calendar.json

@@ -0,0 +1,25 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Calendar Tasks",
+  "description": "Issue and import iCalendar feed links",
+  "type": "object",
+  "properties": {
+    "task": { "type": "string", "enum": ["Calendar/IssueLink@1", "Calendar/ImportFeed@1"] },
+    "name": { "type": "string" },
+    "description": { "type": "string" },
+    "conditions": { "type": "array" },
+    "continueOnError": { "type": "boolean" },
+    "inputs": {
+      "type": "object",
+      "properties": {
+        "organizationId": {}, "calendarId": {}, "label": {},
+        "organizationConnectionId": {}, "url": {}, "etag": {}
+      },
+      "required": ["organizationId"],
+      "additionalProperties": true
+    },
+    "outputs": { "type": "array" }
+  },
+  "required": ["task", "name", "inputs"],
+  "additionalProperties": true
+}

package/schemas/workflows/tasks/transmission.json

@@ -1,7 +1,7 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
   "title": "Transmission Tasks",
-  "description": "Create, update, and delete transmission records linked to orders",
+  "description": "Create, update, and delete transmission records linked to orders or addressed to contacts",
   "type": "object",
   "properties": {
     "task": {
@@ -55,7 +55,11 @@
             "orderIds": {
               "type": ["array", "string"],
               "items": { "type": ["integer", "string"] },
-              "description": "Order IDs to link (required for Create, at least one)"
+              "description": "Optional order IDs to link"
+            },
+            "contactId": {
+              "type": ["integer", "string", "null"],
+              "description": "Partner contact used for delivery and channel defaults"
             },
             "channel": {
               "type": "string",
@@ -145,7 +149,31 @@
             },
             "payloadRef": {
               "type": ["string", "null"],
-              "description": "Reference to stored payload (e.g. blob URI)"
+              "description": "Reference to a stored payload; mutually exclusive with payload"
+            },
+            "payload": {
+              "description": "JSON, text, or binary/base64 payload uploaded to storage"
+            },
+            "payloadContentType": {
+              "type": ["string", "null"],
+              "description": "Content type override for payload"
+            },
+            "attachments": {
+              "type": ["array", "string", "null"],
+              "description": "Attachment inputs; each uses exactly one source",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "attachmentId": { "type": ["integer", "string", "null"] },
+                  "attachmentGuid": { "type": ["string", "null"], "format": "uuid" },
+                  "url": { "type": ["string", "null"] },
+                  "data": { "description": "Raw bytes or base64 data" },
+                  "fileName": { "type": ["string", "null"] },
+                  "contentType": { "type": ["string", "null"] },
+                  "metadata": { "type": ["object", "string", "null"] }
+                },
+                "additionalProperties": false
+              }
             },
             "scheduledAt": {
               "type": ["string", "null"],

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

@@ -53,6 +53,8 @@ npx cxtms create workflow <name> --template <template>
 
 **All templates** — update `name`, `description`, `tags`, `inputs`, `variables`, replace placeholder steps.
 
+**Workflow overrides** — active workflows in the same organization with the same case-insensitive `workflow.name` form an override group. Only the highest `workflow.priority` is effective (default 50; lowest workflow ID wins ties). Use a higher priority to replace a base-app workflow without modifying it. The rule covers triggers, schedules, execution by name, MCP surfaces, public API routes, and document workflows; deactivating or deleting the winner restores the next-highest definition.
+
 **`entity-trigger`** — set `entityName`, `eventType` (Modified/Created/Deleted), `position` (Before/After), `conditions` on `changes`. Access entity via `{{ entity.* }}`. Before: use `Validation/Validate@1`. After: cascade changes.
 
 **`document`** — keep `file`/`fileName`/`fileDisposition` outputs. Update `Document/Render@1`: `engine` (handlebars/jsrender), `recipe` (chrome-pdf/html-to-xlsx), `content` (HTML template), `data` mapping.

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

@@ -18,9 +18,21 @@
 - Notification tasks (Create)
 - Note tasks (Create, Update, Delete, Import, Export, RenameThread)
 - AccountingTransaction/ApplyCredit task
+- Calendar feed tasks (IssueLink, ImportFeed)
 
 All entity tasks follow the `Namespace/Operation@Version` pattern. Outputs are stored as `ActivityName.StepName.outputKey`.
 
+## Calendar feeds
+
+| Task | Description |
+|------|-------------|
+| `Calendar/IssueLink@1` | Issue a user or organization-connection iCalendar feed link |
+| `Calendar/ImportFeed@1` | Reconcile an iCalendar feed into a local mirror calendar |
+
+`Calendar/IssueLink@1` requires `organizationId` and `calendarId`; optional `label` and `organizationConnectionId` create a labeled user link or an idempotent system link. Outputs: `calendarLinkId`, `url`, `isSystem`. The URL contains the token and must be stored securely.
+
+`Calendar/ImportFeed@1` requires `organizationId` and accepts `url`, prior mirror `calendarId`, and prior `etag`. Outputs: `status`, `reason`, `calendarId`, `etag`, `businessHours`, and `availabilityBlocks`. Status is `ok`, `unchanged`, `revoked`, `error`, or `skipped`. Persist the returned calendar ID and ETag after successful calls; do not delete a previous mirror on `error`.
+
 ## PostalCodes
 
 | Task | Description |
@@ -479,11 +491,11 @@ Output `result`: `{ added, updated, skipped, failed, total, errors[] }`.
 
 | Task | Description |
 |------|-------------|
-| `Transmission/Create` | Create transmission record linked to orders |
+| `Transmission/Create` | Create a transmission, optionally linked to orders or addressed to a contact |
 | `Transmission/Update` | Update transmission fields (dynamic) |
 | `Transmission/Delete` | Delete transmission record |
 
-Records inbound/outbound message transmissions (EDI, API, Email, Webhook) linked to orders.
+Records inbound/outbound message transmissions (EDI, API, Email, Webhook). Contact-addressed outbound records can carry stored payloads and attachments and are queued for delivery.
 
 ```yaml
 - task: "Transmission/Create@1"
@@ -492,14 +504,10 @@ Records inbound/outbound message transmissions (EDI, API, Email, Webhook) linked
     organizationId: "{{ int organizationId }}"
     transmission:
       orderIds: "{{ orderIds }}"
-      channel: "EDI"
-      direction: "Outbound"
+      contactId: "{{ int partnerContactId }}"
       messageType: "214"
-      sender: "{{ senderISA }}"
-      receiver: "{{ receiverISA }}"
-      status: "Pending"
-      endpoint: "{{ endpoint }}"
-      protocol: "SFTP"
+      payload: "{{ orderPayload }}"
+      payloadContentType: "application/json"
   outputs:
     - name: transmission
       mapping: "transmission"
@@ -527,12 +535,14 @@ Records inbound/outbound message transmissions (EDI, API, Email, Webhook) linked
       mapping: "success"
 ```
 
-**Create inputs:** `organizationId` (int, required), `transmission` object — `orderIds` (required, at least one), `channel`, `direction` (Inbound/Outbound), `messageType`, `sender`, `receiver`, `status`, `endpoint`, `protocol`, `correlationId` (auto-generated if omitted), `parentId`, `httpStatus`, `byteSize`, `retryCount`, `maxRetries`, `nextRetryAt`, `errorCode`, `errorMessage`, `customValues`, `headers`, `payloadRef`, `scheduledAt`, `startedAt`, `completedAt`, `durationMs`.
+**Create inputs:** `organizationId` (int, required), `transmission` object — optional `orderIds`; `contactId`; `channel` (required without `contactId`); `direction` (Inbound/Outbound, defaults to Outbound); `messageType`, `sender`, `receiver`, `status`, `endpoint`, `protocol`, `correlationId` (auto-generated if omitted), `parentId`, `httpStatus`, `byteSize`, `retryCount`, `maxRetries`, `nextRetryAt`, `errorCode`, `errorMessage`, `customValues`, `headers`, `payloadRef`, `payload`, `payloadContentType`, `attachments`, `scheduledAt`, `startedAt`, `completedAt`, `durationMs`. `payload` and `payloadRef` are mutually exclusive. Each attachment uses exactly one of `attachmentId`, `attachmentGuid`, `url`, or `data`; URL/data entries require `fileName`.
 
 **Create outputs:** `transmission` (full TransmissionDto).
 **Update inputs:** `organizationId`, `transmissionId`, `transmission` (dynamic partial fields).
 **Delete outputs:** `success` (boolean).
 
+Contact-addressed transmissions with a supported transport are queued through the outbox. Transmission entity triggers expose decoded `entity.payload` (within the server preload limit) and `entity.attachments` with download URLs.
+
 **Status enum:** Pending, InProgress, Sent, Received, Delivered, Acknowledged, Rejected, Error, RetryScheduled, Cancelled, Expired, Accepted.
 
 ## Accounting Transaction (Additional)