CSL Syntax Reference

apiVersion: cascade.io/v1
kind: Application
metadata:
  name: my-app
  namespace: default
spec:
  workflows:
    - name: MyWorkflow
      start: StartState
      states:
        - name: StartState
          type: Task
          end: true

metadata:
  name: my-app                    # App name (required)
  namespace: default              # Namespace (default: default)
  labels:
    team: engineering
    version: "1.0"
  annotations:
    description: "My application"

spec:
  workflows:
    - name: ProcessOrder          # Workflow name (required)
      description: "Handle order" # Optional description
      start: ValidateOrder        # First state (required)
      timeout: 24h               # Max workflow duration
      states:
        - ...

- name: ValidateOrder
  type: Task
  description: "Validate order details"
  resource: urn:cascade:activity:validate_order
  parameters:
    order_id: "{{ workflow.input.order_id }}"
    strict: true
  result: $.validation
  resultPath: $.validation_result  # Alternative to result
  timeout: 30s
  retries:
    max_attempts: 3
    backoff:
      initial_interval: 1s
      max_interval: 60s
      multiplier: 2.0
  next: ProcessPayment
  end: false

- name: RouteLoan
  type: Choice
  choices:
    - condition: "{{ $.credit_score >= 750 }}"
      next: FastTrack
      description: "Excellent credit"
 
    - condition: "{{ $.amount <= 5000 }}"
      next: AutoApprove
      description: "Small amount"
 
  default: ManagerReview

- name: ManagerApproval
  type: HumanTask
  description: "Loan requires manager approval"
  ui:
    schema: urn:cascade:schema:approval_form
    target: appsmith           # appsmith, rjsf, echarts, tanstack
    pre_populate:
      application_id: "{{ $.app_id }}"
  assignee:
    role: loan_manager         # Role or user_id
    tags:
      department: "{{ $.dept }}"
  timeout: 24h
  timeoutAction: ESCALATE_TO_DIRECTOR
  next: ProcessDecision

- name: VerifyApplicant
  type: Parallel
  branches:
    - name: VerifyIdentity
      type: Task
      resource: urn:cascade:activity:verify_identity
      parameters:
        document_id: "{{ $.doc_id }}"
      result: $.identity
 
    - name: CheckCredit
      type: Task
      resource: urn:cascade:activity:check_credit
      parameters:
        ssn: "{{ $.ssn }}"
      result: $.credit
 
  completion_strategy: ALL
  next: CombineResults

- name: CooldownPeriod
  type: Wait
  duration: 1h              # Wait 1 hour
  next: RetryPayment
 
# Or wait until specific time
- name: WaitUntilNextDay
  type: Wait
  until: "{{ now | addDate 1 day | startOfDay }}"
  next: ResumeProcess

- name: AwaitPayment
  type: Receive
  event_name: payment_confirmed
  timeout: 5m
  timeoutAction: RETRY
  next: ProcessConfirmation

- name: CheckPolicy
  type: EvaluatePolicy
  resource: urn:cascade:policy:loan_approval
  parameters:
    credit_score: "{{ $.credit_score }}"
    amount: "{{ $.amount }}"
  result: $.policy_result
  next: ApplyDecision

retries:
  max_attempts: 3
  backoff:
    initial_interval: 1s
    max_interval: 60s
    multiplier: 2.0

parameters:
  # Direct context reference
  order_id: "{{ $.order_id }}"
  
  # Nested path
  customer_email: "{{ $.customer.email }}"
  
  # Array index
  first_item: "{{ $.items[0].sku }}"
  
  # Default value
  department: "{{ $.dept | default: 'sales' }}"
  
  # Function
  tomorrow: "{{ now | addDate 1 day }}"
  
  # Literal values
  amount: 100
  enabled: true
  items:
    - id: 1
      name: "item1"

result: $.field_name              # Top level
result: $.nested.path.value      # Nested
result: $.array[0].item          # Array element
result: $.array.item             # All array items

# Store at top level
- result: $.payment
  # Accessible as: $.payment
 
# Store nested
- result: $.verification.identity
  # Accessible as: $.verification.identity
 
# Array storage
- result: $.items[0].sku
  # Accessible as: $.items[0].sku

timeout: 1000ms      # Milliseconds
timeout: 30s         # Seconds
timeout: 5m          # Minutes
timeout: 1h          # Hours
timeout: 2h30m       # Combined

conditions:
  - "{{ $.age >= 18 }}"
  - "{{ $.amount > 1000 }}"
  - "{{ $.status == 'active' }}"
  - "{{ $.name != 'admin' }}"
  - "{{ $.score <= 100 }}"
  - "{{ $.items.length > 0 }}"
  - "{{ $.name contains 'test' }}"

urn:cascade:activity:validate_order
urn:cascade:policy:loan_approval
urn:cascade:schema:application_form
urn:cascade:service:notification

Parts:
├── urn              - Scheme (always "urn")
├── cascade          - Authority
├── resource_type    - activity, policy, schema, service
└── resource_name    - Specific resource

states:
  - name: Step1
    type: Task
    next: Step2
  
  - name: Step2
    type: Task
    next: Step3
  
  - name: Step3
    type: Task
    end: true

states:
  - name: CheckAmount
    type: Choice
    choices:
      - condition: "{{ $.amount <= 1000 }}"
        next: FastApprove
      - condition: "{{ $.amount <= 10000 }}"
        next: ManagerApprove
    default: ExecutiveApprove
  
  - name: FastApprove
    type: Task
    end: true
  
  - name: ManagerApprove
    type: Task
    end: true
  
  - name: ExecutiveApprove
    type: Task
    end: true

- name: RiskyOperation
  type: Task
  resource: urn:cascade:activity:risky_call
  retries:
    max_attempts: 3
    backoff:
      initial_interval: 5s
      max_interval: 30s
  timeout: 30s
  next: OnSuccess
 
- name: OnSuccess
  type: Task
  end: true

# Minimal state
- name: StateName
  type: Task|Choice|HumanTask|Parallel|Wait|Receive|EvaluatePolicy
  [required fields for type]
  next: NextStateName | end: true