cxtms 1.9.13

package/templates/workflow-mcp-tool.yaml

@@ -0,0 +1,112 @@
+# {{displayName}} Workflow
+# Generated by cxtms create workflow --template mcp-tool
+
+workflow:
+  workflowId: "{{uuid}}"
+  name: "{{displayName}}"
+  description: "{{displayName}} - MCP tool workflow"
+  version: "1.0"
+  executionMode: Sync
+  logLevel: Information
+  isActive: true
+  enableAudit: true
+  filePath: "{{fileName}}"
+  agentInstruction: |
+    Use this tool to {{displayName}}.
+    Inputs:
+      - orderId (required): The order ID to process
+    Returns:
+      - result: Processing outcome with success status
+  tags:
+    - "mcp-tool"
+
+inputs:
+  - name: orderId
+    type: number
+    props:
+      displayName: "Order ID"
+      description: "The ID of the order to process"
+      required: true
+
+outputs:
+  - name: result
+    mapping: "Main.SetResult.result"
+
+activities:
+  - name: Main
+    events:
+      onActivityStarted:
+        - task: "Utilities/Log@1"
+          name: LogActivityStarted
+          inputs:
+            message: "Activity Main started"
+            level: Information
+      onActivityCompleted:
+        - task: "Utilities/Log@1"
+          name: LogActivityCompleted
+          inputs:
+            message: "Activity Main completed"
+            level: Information
+      onActivityFailed:
+        - task: "Utilities/Log@1"
+          name: LogActivityFailed
+          inputs:
+            message: "Activity Main failed: {{exception.message}}"
+            level: Error
+    steps:
+      - task: "Query/GraphQL"
+        name: GetOrder
+        inputs:
+          query: |
+            query($organizationId: Int!, $orderId: Int!) {
+              order(organizationId: $organizationId, orderId: $orderId) {
+                orderId
+                orderNumber
+                status
+              }
+            }
+          variables:
+            organizationId: "\{{int organizationId}}"
+            orderId: "\{{inputs.orderId}}"
+        outputs:
+          - name: order
+            mapping: "order?"
+
+      - task: "Utilities/Error@1"
+        name: ValidateOrder
+        conditions:
+          - expression: "isNullOrEmpty([Main?.GetOrder?.order?]) = true"
+        inputs:
+          message: "Order not found: \{{inputs.orderId}}"
+
+      # TODO: Add processing logic here
+
+      - task: "Utilities/SetVariable@1"
+        name: SetResult
+        inputs:
+          variables:
+            - name: result
+              value:
+                success: true
+                orderId: "\{{inputs.orderId}}"
+                orderNumber: "\{{Main?.GetOrder?.order?.orderNumber?}}"
+
+events:
+  onWorkflowStarted:
+    - task: "Utilities/Log@1"
+      name: LogWorkflowStarted
+      inputs:
+        message: "{{displayName}} workflow started"
+        level: Information
+  onWorkflowCompleted:
+    - task: "Utilities/Log@1"
+      name: LogWorkflowCompleted
+      inputs:
+        message: "{{displayName}} workflow completed successfully"
+        level: Information
+  onWorkflowFailed:
+    - task: "Utilities/Log@1"
+      name: LogWorkflowFailed
+      inputs:
+        message: "{{displayName}} workflow failed: {{exception.message}}"
+        level: Error

package/templates/workflow-public-api.yaml

@@ -0,0 +1,135 @@
+# {{displayName}} Workflow
+# Generated by cxtms create workflow --template public-api
+#
+# This workflow exposes a public REST API endpoint.
+# The api section defines the route, method, authentication, and OpenAPI metadata.
+# Inputs use props.in to specify parameter location (path, query, header, body).
+# Outputs use props to describe the response schema for OpenAPI documentation.
+
+api:
+  path: "/orders/{orderId}"
+  method: "GET"
+  summary: "{{displayName}}"
+  description: "{{displayName}} public API endpoint"
+  document: "public"
+  category: "Orders"
+  authentication: "bearer"
+  rateLimit:
+    perSecond: 10
+    perMinute: 100
+
+workflow:
+  workflowId: "{{uuid}}"
+  name: "{{displayName}}"
+  description: "{{displayName}} - Public API endpoint"
+  version: "1.0"
+  workflowType: "PublicApi"
+  executionMode: Sync
+  logLevel: Information
+  isActive: true
+  enableAudit: true
+  filePath: "{{fileName}}"
+  tags:
+    - "public-api"
+
+inputs:
+  - name: orderId
+    type: text
+    props:
+      in: path
+      required: true
+      description: "Order ID"
+      format: "uuid"
+
+outputs:
+  - name: response
+    mapping: "Main.SetResponse.response"
+    props:
+      type: object
+      description: "Order details"
+      schema:
+        properties:
+          orderId:
+            type: integer
+          orderNumber:
+            type: string
+          status:
+            type: string
+  - name: statusCode
+    mapping: "Main.SetResponse.statusCode"
+
+activities:
+  - name: Main
+    events:
+      onActivityStarted:
+        - task: "Utilities/Log@1"
+          name: LogActivityStarted
+          inputs:
+            message: "Activity Main started"
+            level: Information
+      onActivityCompleted:
+        - task: "Utilities/Log@1"
+          name: LogActivityCompleted
+          inputs:
+            message: "Activity Main completed"
+            level: Information
+      onActivityFailed:
+        - task: "Utilities/Log@1"
+          name: LogActivityFailed
+          inputs:
+            message: "Activity Main failed: {{exception.message}}"
+            level: Error
+    steps:
+      - task: "Query/GraphQL"
+        name: GetOrder
+        inputs:
+          query: |
+            query($organizationId: Int!, $orderId: String!) {
+              order(organizationId: $organizationId, orderId: $orderId) {
+                orderId
+                orderNumber
+                status
+              }
+            }
+          variables:
+            organizationId: "\{{int organizationId}}"
+            orderId: "\{{inputs.orderId}}"
+        outputs:
+          - name: order
+            mapping: "order?"
+
+      - task: "Utilities/Error@1"
+        name: ValidateOrder
+        conditions:
+          - expression: "isNullOrEmpty([Main?.GetOrder?.order?]) = true"
+        inputs:
+          message: "Order not found"
+
+      - task: "Utilities/SetVariable@1"
+        name: SetResponse
+        inputs:
+          variables:
+            - name: response
+              value: "\{{Main?.GetOrder?.order?}}"
+            - name: statusCode
+              value: 200
+
+events:
+  onWorkflowStarted:
+    - task: "Utilities/Log@1"
+      name: LogWorkflowStarted
+      inputs:
+        message: "{{displayName}} workflow started"
+        level: Information
+  onWorkflowCompleted:
+    - task: "Utilities/Log@1"
+      name: LogWorkflowCompleted
+      inputs:
+        message: "{{displayName}} workflow completed successfully"
+        level: Information
+  onWorkflowFailed:
+    - task: "Utilities/Log@1"
+      name: LogWorkflowFailed
+      inputs:
+        message: "{{displayName}} workflow failed: {{exception.message}}"
+        level: Error

package/templates/workflow-scheduled-execute.yaml

@@ -0,0 +1,75 @@
+# {{displayName}} Workflow
+# Generated by cxtms create workflow --template scheduled-execute
+
+workflow:
+  workflowId: "{{uuid}}"
+  name: "{{displayName}}"
+  description: "{{displayName}} - schedules another workflow on a cron schedule"
+  version: "1.0"
+  executionMode: Async
+  logLevel: Information
+  isActive: true
+  enableAudit: true
+  filePath: "{{fileName}}"
+  tags:
+    - "generated"
+    - "scheduled"
+
+schedules:
+  - cron: "0 * * * *"
+    displayName: "{{displayName}} - Hourly"
+
+activities:
+  - name: ExecuteWorkflow
+    events:
+      onActivityStarted:
+        - task: "Utilities/Log@1"
+          name: LogActivityStarted
+          inputs:
+            message: "Activity ExecuteWorkflow started"
+            level: Information
+      onActivityCompleted:
+        - task: "Utilities/Log@1"
+          name: LogActivityCompleted
+          inputs:
+            message: "Activity ExecuteWorkflow completed"
+            level: Information
+      onActivityFailed:
+        - task: "Utilities/Log@1"
+          name: LogActivityFailed
+          inputs:
+            message: "Activity ExecuteWorkflow failed: {{exception.message}}"
+            level: Error
+    steps:
+      - task: "Workflow/Execute@1"
+        name: RunTargetWorkflow
+        inputs:
+          workflowName: "Target Workflow Name"
+          async: true
+          workflowInputs: {}
+
+      - task: "Utilities/Log@1"
+        name: LogComplete
+        inputs:
+          message: "{{displayName}} completed"
+          level: Information
+
+events:
+  onWorkflowStarted:
+    - task: "Utilities/Log@1"
+      name: LogWorkflowStarted
+      inputs:
+        message: "{{displayName}} workflow started"
+        level: Information
+  onWorkflowCompleted:
+    - task: "Utilities/Log@1"
+      name: LogWorkflowCompleted
+      inputs:
+        message: "{{displayName}} workflow completed successfully"
+        level: Information
+  onWorkflowFailed:
+    - task: "Utilities/Log@1"
+      name: LogWorkflowFailed
+      inputs:
+        message: "{{displayName}} workflow failed: {{exception.message}}"
+        level: Error

package/templates/workflow-scheduled.yaml

@@ -0,0 +1,125 @@
+# {{displayName}} Workflow
+# Generated by cxtms create workflow --template scheduled
+
+workflow:
+  workflowId: "{{uuid}}"
+  name: "{{displayName}}"
+  description: "{{displayName}} scheduled workflow"
+  version: "1.0"
+  executionMode: Async
+  logLevel: Information
+  isActive: true
+  enableAudit: true
+  filePath: "{{fileName}}"
+  tags:
+    - "generated"
+    - "scheduled"
+
+variables:
+  - name: pageSize
+    value: 50
+  - name: offset
+    value: 0
+  - name: hasMorePages
+    value: true
+
+schedules:
+  - cron: "0 * * * *"
+    displayName: "{{displayName}} - Hourly"
+
+activities:
+  - name: BatchProcess
+    events:
+      onActivityStarted:
+        - task: "Utilities/Log@1"
+          name: LogActivityStarted
+          inputs:
+            message: "Activity BatchProcess started"
+            level: Information
+      onActivityCompleted:
+        - task: "Utilities/Log@1"
+          name: LogActivityCompleted
+          inputs:
+            message: "Activity BatchProcess completed"
+            level: Information
+      onActivityFailed:
+        - task: "Utilities/Log@1"
+          name: LogActivityFailed
+          inputs:
+            message: "Activity BatchProcess failed: {{exception.message}}"
+            level: Error
+    steps:
+      - task: "while"
+        name: PageLoop
+        conditions:
+          - expression: "[hasMorePages] = true"
+        maxIterations: 100
+        steps:
+          - task: "Query/GraphQL"
+            name: GetPage
+            inputs:
+              query: |
+                query($organizationId: Int!, $first: Int!, $offset: Int!) {
+                  orders(organizationId: $organizationId, first: $first, offset: $offset, filter: "status:Active") {
+                    totalCount
+                    items {
+                      orderId
+                      orderNumber
+                    }
+                  }
+                }
+              variables:
+                organizationId: "\{{organizationId}}"
+                first: "\{{pageSize}}"
+                offset: "\{{offset}}"
+            outputs:
+              - name: result
+                mapping: "orders?"
+
+          - task: "foreach"
+            name: ProcessItems
+            collection: "BatchProcess?.PageLoop?.GetPage?.result?.items?"
+            item: "currentOrder"
+            steps:
+              - task: "Utilities/Log@1"
+                name: LogItem
+                inputs:
+                  message: "Processing order: \{{currentOrder.orderNumber}}"
+                  level: Information
+
+          - task: "Utilities/SetVariable@1"
+            name: UpdatePagination
+            inputs:
+              variables:
+                - name: offset
+                  value:
+                    expression: "[offset] + [pageSize]"
+                - name: hasMorePages
+                  value:
+                    expression: "[offset] < [BatchProcess?.PageLoop?.GetPage?.result?.totalCount?]"
+
+      - task: "Utilities/Log@1"
+        name: LogComplete
+        inputs:
+          message: "{{displayName}} completed"
+          level: Information
+
+events:
+  onWorkflowStarted:
+    - task: "Utilities/Log@1"
+      name: LogWorkflowStarted
+      inputs:
+        message: "{{displayName}} workflow started"
+        level: Information
+  onWorkflowCompleted:
+    - task: "Utilities/Log@1"
+      name: LogWorkflowCompleted
+      inputs:
+        message: "{{displayName}} workflow completed successfully"
+        level: Information
+  onWorkflowFailed:
+    - task: "Utilities/Log@1"
+      name: LogWorkflowFailed
+      inputs:
+        message: "{{displayName}} workflow failed: {{exception.message}}"
+        level: Error

package/templates/workflow-utility.yaml

@@ -0,0 +1,96 @@
+# {{displayName}} Workflow
+# Generated by cxtms create workflow --template utility
+
+workflow:
+  workflowId: "{{uuid}}"
+  name: "{{displayName}}"
+  description: "{{displayName}} reusable utility workflow"
+  version: "1.0"
+  executionMode: Sync
+  logLevel: Information
+  isActive: true
+  filePath: "{{fileName}}"
+  tags:
+    - "generated"
+    - "utility"
+
+inputs:
+  - name: orderId
+    type: number
+    props:
+      displayName: "Order ID"
+      description: "The ID of the order to process"
+      required: true
+
+outputs:
+  - name: result
+    mapping: "Main.Process.result"
+
+activities:
+  - name: Main
+    events:
+      onActivityStarted:
+        - task: "Utilities/Log@1"
+          name: LogActivityStarted
+          inputs:
+            message: "Activity Main started"
+            level: Information
+      onActivityCompleted:
+        - task: "Utilities/Log@1"
+          name: LogActivityCompleted
+          inputs:
+            message: "Activity Main completed"
+            level: Information
+      onActivityFailed:
+        - task: "Utilities/Log@1"
+          name: LogActivityFailed
+          inputs:
+            message: "Activity Main failed: {{exception.message}}"
+            level: Error
+    steps:
+      - task: "Query/GraphQL"
+        name: GetData
+        inputs:
+          query: |
+            query($organizationId: Int!, $orderId: Int!) {
+              order(organizationId: $organizationId, orderId: $orderId) {
+                orderId
+                orderNumber
+                status
+              }
+            }
+          variables:
+            organizationId: "\{{organizationId}}"
+            orderId: "\{{inputs.orderId}}"
+        outputs:
+          - name: order
+            mapping: "order?"
+
+      - task: "Utilities/SetVariable@1"
+        name: Process
+        inputs:
+          variables:
+            - name: result
+              value:
+                success: true
+                orderId: "\{{inputs.orderId}}"
+
+events:
+  onWorkflowStarted:
+    - task: "Utilities/Log@1"
+      name: LogWorkflowStarted
+      inputs:
+        message: "{{displayName}} workflow started"
+        level: Information
+  onWorkflowCompleted:
+    - task: "Utilities/Log@1"
+      name: LogWorkflowCompleted
+      inputs:
+        message: "{{displayName}} workflow completed successfully"
+        level: Information
+  onWorkflowFailed:
+    - task: "Utilities/Log@1"
+      name: LogWorkflowFailed
+      inputs:
+        message: "{{displayName}} workflow failed: {{exception.message}}"
+        level: Error

package/templates/workflow-webhook.yaml

@@ -0,0 +1,128 @@
+# {{displayName}} Workflow
+# Generated by cxtms create workflow --template webhook
+#
+# Endpoint: POST /api/v2/orgs/{organizationId}/webhooks/{workflowId}
+# The endpoint is anonymous (no auth token required) and rate-limited (10/sec, 100/min per IP).
+# The workflow receives two auto-injected inputs:
+#   - payload: parsed JSON body (or raw string if not JSON)
+#   - request: { headers, body, remoteIpAddress }
+# The workflow controls the HTTP response via outputs:
+#   - response: the response body returned to the caller
+#   - statusCode: the HTTP status code (defaults to 200)
+
+workflow:
+  workflowId: "{{uuid}}"
+  name: "{{displayName}}"
+  description: "{{displayName}} - Webhook endpoint"
+  version: "1.0"
+  workflowType: "Webhook"
+  executionMode: Sync
+  logLevel: Information
+  isActive: true
+  enableAudit: true
+  filePath: "{{fileName}}"
+  runAs: "system"
+  tags:
+    - "webhook"
+  additionalProperties:
+    cors:
+      allowedOrigins:
+        - "*"
+
+inputs:
+  - name: payload
+    type: object
+    props:
+      displayName: "Payload"
+      description: "Parsed webhook request body (JSON object or raw string)"
+  - name: request
+    type: object
+    props:
+      displayName: "Request"
+      description: "HTTP request metadata: headers, body, remoteIpAddress"
+
+outputs:
+  - name: response
+    mapping: "Main.SetResponse.response"
+  - name: statusCode
+    mapping: "Main.SetResponse.statusCode"
+
+variables:
+  - name: webhookSecret
+    fromConfig:
+      configName: "apps.myApp.webhookSecret"
+
+activities:
+  - name: Main
+    events:
+      onActivityStarted:
+        - task: "Utilities/Log@1"
+          name: LogActivityStarted
+          inputs:
+            message: "Activity Main started"
+            level: Information
+      onActivityCompleted:
+        - task: "Utilities/Log@1"
+          name: LogActivityCompleted
+          inputs:
+            message: "Activity Main completed"
+            level: Information
+      onActivityFailed:
+        - task: "Utilities/Log@1"
+          name: LogActivityFailed
+          inputs:
+            message: "Activity Main failed: {{exception.message}}"
+            level: Error
+    steps:
+      - task: "Utilities/Log@1"
+        name: LogRequest
+        inputs:
+          message: "{{displayName}} webhook received from \{{request.remoteIpAddress}}"
+          level: Information
+
+      # Validate webhook secret — customize with your verification method
+      # Common patterns:
+      #   - Header secret: request.headers.x-webhook-secret vs config secret
+      #   - HMAC signature: compute HMAC of request.body, compare to X-Hub-Signature header
+      - task: "Utilities/Error@1"
+        name: ValidateWebhook
+        conditions:
+          - expression: "isNullOrEmpty([webhookSecret?]) = false and [request?.headers?.x-webhook-secret?] != [webhookSecret?]"
+        inputs:
+          message: "Unauthorized webhook request"
+
+      # TODO: Add processing logic here
+      # Access payload fields: \{{payload.fieldName}}
+      # Access raw body: \{{request.body}}
+      # Access headers: \{{request.headers.headerName}}
+
+      - task: "Utilities/SetVariable@1"
+        name: SetResponse
+        inputs:
+          variables:
+            - name: response
+              value:
+                success: true
+                message: "Webhook processed successfully"
+            - name: statusCode
+              value: 200
+
+events:
+  onWorkflowStarted:
+    - task: "Utilities/Log@1"
+      name: LogWorkflowStarted
+      inputs:
+        message: "{{displayName}} workflow started"
+        level: Information
+  onWorkflowCompleted:
+    - task: "Utilities/Log@1"
+      name: LogWorkflowCompleted
+      inputs:
+        message: "{{displayName}} workflow completed successfully"
+        level: Information
+  onWorkflowFailed:
+    - task: "Utilities/Log@1"
+      name: LogWorkflowFailed
+      inputs:
+        message: "{{displayName}} workflow failed: {{exception.message}}"
+        level: Error