@cxtms/cx-schema 1.9.244 → 1.9.246

package/package.json

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

package/schemas/components/tabs.json

@@ -21,6 +21,21 @@
             "$ref": "../schemas.json#/definitions/component"
           }
         },
+        "header": {
+          "type": "object",
+          "description": "Component areas rendered above the tab strip",
+          "properties": {
+            "icon": { "$ref": "../schemas.json#/definitions/componentChildren" },
+            "title": { "$ref": "../schemas.json#/definitions/componentChildren" },
+            "subTitle": { "$ref": "../schemas.json#/definitions/componentChildren" },
+            "buttons": { "$ref": "../schemas.json#/definitions/componentChildren" }
+          },
+          "additionalProperties": false
+        },
+        "useNavigationForTabs": {
+          "type": "boolean",
+          "description": "Push tab changes into browser history instead of replacing the current entry"
+        },
         "defaultTab": {
           "type": "string",
           "description": "Default active tab name"

package/skills/cxtms-developer/ref-entity-organization.md

@@ -20,6 +20,8 @@ Core tenant entity. Each organization represents a company/tenant in the system.
 | `slug` | `string?` | URL-friendly identifier for Public API routes (lowercase, hyphenated) |
 | `organizationType` | `OrganizationType` | `Regular` (0) or platform-managed `SystemAdministration` (1) |
 | `isDeleted` | `bool` | Soft delete |
+| `isInactive` | `bool` | Operational inactive flag; remains visible |
+| `activeUserCount` | `int` | GraphQL projection of active licensed people |
 | `customValues` | `Dictionary?` | jsonb, merged on update; incoming keys overwrite existing keys while unrelated keys are preserved |
 | `created` / `lastModified` | `DateTime` | Audit fields (from `AuditableEntity`) |
 | `createdBy` / `lastModifiedBy` | `string` | Audit fields |
@@ -40,4 +42,5 @@ Used by `PublicApiOrganizationResolver` to resolve org by slug or GUID in Public
 - `ChangeCompanyName(string)`, `ChangeAddressLine(string?)`, etc.
 - `ChangeCustomValues(Dictionary?)` — initializes `CustomValues` when needed, merges incoming values into the existing dictionary, and overwrites matching keys without dropping unrelated keys
 - `DeleteOrganization()` — sets `IsDeleted = true`
+- `ChangeIsInactive(bool)` — toggles operational inactivity
 - `ChangeOrganizationType(OrganizationType)` — platform-only; ignored by dynamic update mutations

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

@@ -436,6 +436,7 @@ the slot name are resolved from component variables and store values before look
 |------|------|-------------|
 | `options` | `object` | Additional props spread to Tab elements |
 | `toolbar` | `component[]` | Action components next to tab list |
+| `header` | `{icon?, title?, subTitle?, buttons?}` | Component arrays rendered above the tab strip |
 | `useNavigationForTabs` | `boolean` | Push to history instead of replace |
 
 **Tab children props:**
@@ -518,7 +519,7 @@ MUI Card container with optional header, content, and actions.
 | `className` | `string` | — | Additional CSS class |
 | `bgcolor` | `string` | — | Background color |
 | `color` | `string` | — | Text color |
-| `header` | `{title?, subheader?, sx?}` | — | Renders MUI CardHeader |
+| `header` | `{title?, subheader?, icon?, iconColor?, sx?}` | — | Renders MUI CardHeader; icon is its avatar |
 | `disableContentWrapper` | `boolean` | `false` | Skip CardContent wrapper |
 | `contentSx` | `SxProps` | — | CardContent styles |
 | `contentClassName` | `string` | `card-content` | CardContent CSS class |

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

@@ -45,6 +45,7 @@ npx cxtms create workflow <name> --template <template>
 | `api-tracking` | Fetch tracking from carrier API |
 | `webhook` | HTTP endpoint for external callers |
 | `public-api` | REST API endpoint with OpenAPI docs |
+| `mcp-tool` | Synchronous tool exposed through the organization MCP server |
 
 ### Step 2: Read the generated file
 
@@ -70,6 +71,8 @@ npx cxtms create workflow <name> --template <template>
 
 **`public-api`** — requires a top-level `api` section defining the REST endpoint. Set `api.path` with route params (e.g., `/orders/{orderId}`), `api.method` (GET/POST/PUT/PATCH/DELETE), `api.authentication` (`none`, `bearer`, `apiKey`), `api.document` (swagger doc name, default `"public"`), and `api.category` (swagger tag). Configure `api.rateLimit` with `perSecond`/`perMinute`. Each input uses `props.in` (`path`, `query`, `header`, `body`) to specify where the parameter comes from, and `props.format` for OpenAPI type hints (e.g., `uuid`, `date-time`). Body inputs may define `props.schema` with recursive OpenAPI schema fields (`type`, `properties`, `required`, `items`, `format`, `description`, `enum`); body inputs without a schema render as an object request body. Prefer `api.responses` for response documentation. Legacy `response` outputs can still use `props.type`, `props.description`, and recursive `props.schema` to describe the single `200` response. Must use `executionMode: Sync`. Control HTTP response via `response` and `statusCode` outputs.
 
+**`mcp-tool`** — scaffolds a synchronous `McpTool` workflow. MCP resources use `workflowType: McpResource` and require `mcp.uri`. The resource URI must be absolute and spell out its scheme (for example, `tms://docs/shipping-terms`); relative and filesystem-style paths are invalid on every operating system. MCP tools and prompts use `mcp.name`, which must match `^[a-zA-Z0-9_-]{1,64}$`.
+
 **All templates** include workflow-level `events` (`onWorkflowStarted`, `onWorkflowCompleted`, `onWorkflowFailed`) and activity-level `events` (`onActivityStarted`, `onActivityCompleted`, `onActivityFailed`) with Log steps. Replace/extend these with notification tasks (Email/Send, HttpRequest, Workflow/Execute) as needed. (`onWorkflowExecuted` is a deprecated alias for `onWorkflowCompleted` — use `onWorkflowCompleted` in new workflows.)
 
 **Flow workflows** — scaffold with `basic` then set `workflowType: Flow`, remove `activities`/`triggers`, add `entity`, `states`, `transitions`, `aggregations`. Load Flow reference: `!cat skills/cxtms-workflow-builder/ref-flow.md`
@@ -100,7 +103,7 @@ workflow:
   isActive: true
   enableAudit: true
   filePath: "workflows/<name>.yaml"
-  workflowType: Document | Quote | Flow | Webhook | PublicApi  # omit for standard process workflows
+  workflowType: Document | Quote | Flow | Webhook | PublicApi | McpTool | McpResource | McpPrompt  # omit for standard process workflows
   runAs: "system"                           # Optional elevated permissions
   tags: ["tag1", "tag2"]
   concurrency:                              # Optional

package/skills/cxtms-workflow-builder/ref-expressions-ncalc.md

@@ -62,6 +62,7 @@ Functions use two iterator variable names:
 | `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 |
+| `prune([object])` | Recursively omit blank strings and empty object branches; preserve null, false, 0, and arrays |
 | `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) |