[User: Check order status]
         │
         ▼
[Collect Order Number]
         │
         ▼
[Validate Order Number]
         │
    ┌────┴────┐
    ▼         ▼
[Valid]   [Invalid]
    │         │
    ▼         ▼
[Fetch    [Request
 Status]   Again]
    │
    ▼
[Deliver Response]

Agent Flow: Research Assistant
Capabilities:
  - search_web
  - analyze_documents
  - summarize_findings
Behavior: |
  Research the user's question using available tools.
  Synthesize findings into a comprehensive answer.
  Cite sources when providing information.

Sub-Dialog: Collect Address
Entities required:
  - street_address
  - city
  - state
  - zip_code
Validation: address_verification_api
Reusable: true

Node: Welcome Message
Type: message
Content:
  text: "Hello! I'm your order assistant. How can I help you today?"
  quick_replies:
    - "Check order status"
    - "Start a return"
    - "Track my package"
Transitions:
  - intent: check_order → order_status_flow
  - intent: start_return → return_flow
  - default → fallback

Entity: OrderNumber
Type: regex
Pattern: "(?:order|ORD)?[-#]?(\d{5,8})"
Validation: |
  length >= 5 AND length <= 8
  starts_with_digit
Prompts:
  initial: "What's your order number?"
  retry: "I didn't catch that. Order numbers are usually 5-8 digits."
Max retries: 3

Disambiguation: Size
Values: ["small", "medium", "large"]
On ambiguity:
  type: confirm
  message: "Did you mean {{matched_value}}?"
On multiple:
  type: select
  message: "Which size? Small, medium, or large?"

// Set context
context.session.orderNumber = "12345"
context.session.customerTier = "premium"

// Use in messages
"Your order {{context.session.orderNumber}} is being processed."

// Use in conditions
if (context.session.customerTier === "premium") {
  // Premium customer handling
}

Interruption Handling:
  allow_interruptions: true
  hold_and_resume:
    enabled: true
    message: "No problem, let me help with that first."
  implicit_confirmation: true
  max_depth: 3

Test Suite: Order Status Flow
Tests:
  - name: "Valid order number"
    utterance: "Where is my order 123456?"
    expected:
      intent: check_order_status
      entities:
        order_number: "123456"
      response_contains: "order status"

  - name: "Missing order number"
    utterance: "Where is my order?"
    expected:
      intent: check_order_status
      next_prompt: "order number"