dexto 1.0.2 → 1.1.0

package/agents/triage-demo/technical-support-agent.yml

@@ -0,0 +1,71 @@
+# Technical Support Agent Configuration
+# Specializes in technical issues, troubleshooting, and bug reports
+
+systemPrompt:
+  contributors:
+    - id: base-prompt
+      type: static
+      priority: 0
+      content: |
+        You are a specialized Technical Support Agent for TeamFlow, a cloud-based project management and team collaboration platform.
+
+        Your primary responsibilities:
+        - Diagnose and resolve technical problems, bugs, and system issues
+        - Provide step-by-step troubleshooting guidance
+        - Analyze error logs, system configurations, and performance issues
+        - Escalate complex technical issues when necessary
+        - Document common issues and their solutions
+
+        Your approach:
+        - Always ask for specific details: error messages, system info, steps to reproduce
+        - Provide clear, step-by-step instructions
+        - Verify solutions work before considering the issue resolved
+        - Be patient and explain technical concepts in simple terms
+        - When unsure, ask clarifying questions or escalate to senior technical support
+
+        Tools available to you:
+        - Filesystem access for log analysis and configuration checks
+        - Terminal access for system diagnostics and troubleshooting commands
+        - Browser automation for testing web-based issues
+
+        You have access to comprehensive technical documentation and troubleshooting guides for TeamFlow's platform, API, mobile apps, and integrations. Use this knowledge to provide accurate, specific solutions.
+
+        Remember: Your goal is to resolve technical issues efficiently while educating the user about TeamFlow's features and capabilities.
+    
+    - id: company-overview
+      type: file
+      priority: 10
+      files:
+        - "${{dexto.agent_dir}}/docs/company-overview.md"
+      options:
+        includeFilenames: true
+        errorHandling: skip
+    
+    - id: technical-docs
+      type: file
+      priority: 20
+      files:
+        - "${{dexto.agent_dir}}/docs/technical-documentation.md"
+      options:
+        includeFilenames: true
+        errorHandling: skip
+
+mcpServers:
+  filesystem:
+    type: stdio
+    command: npx
+    args:
+      - -y
+      - "@modelcontextprotocol/server-filesystem"
+      - .
+  puppeteer:
+    type: stdio
+    command: npx
+    args:
+      - -y
+      - "@truffle-ai/puppeteer-server"
+
+llm:
+  provider: openai
+  model: gpt-4o
+  apiKey: $OPENAI_API_KEY 

package/agents/triage-demo/test-scenarios.md

@@ -0,0 +1,209 @@
+# TeamFlow Triage Agent Test Scenarios
+
+Use these realistic TeamFlow customer support scenarios to test the triage agent's **complete customer support workflow**. The triage agent will analyze each request, route to the appropriate specialist agent, execute the specialist via MCP tools, and provide complete customer responses.
+
+## 🔧 Technical Support Scenarios
+
+### Scenario T1: API Integration Issue
+```
+Hi, I'm trying to integrate the TeamFlow API with our system but I keep getting a 401 unauthorized error even though I'm using the correct API key. I've checked the documentation but can't figure out what's wrong. Our rate limit should be 10,000/hour on our Pro plan. Can you help?
+```
+**Expected Route**: Technical Support Agent  
+**Expected Response**: Complete troubleshooting guide including API key validation steps, common 401 causes, rate limit verification, and Pro plan API specifications  
+**Tool Execution**: `chat_with_agent` → Technical Support provides detailed debugging steps
+
+### Scenario T2: App Crash  
+```
+My TeamFlow mobile app crashes every time I try to export project data. It worked fine last week but now it just freezes and closes. I'm using iPhone 15 with iOS 17.2. This is really urgent as I need this data for a client presentation tomorrow.
+```
+**Expected Route**: Technical Support Agent  
+**Expected Response**: Complete crash resolution including device-specific troubleshooting, export alternatives, and immediate workarounds for urgent timeline  
+**Tool Execution**: `chat_with_agent` → Technical Support provides iOS-specific fixes and emergency data export options
+
+### Scenario T3: Performance Issue
+```
+Your web dashboard has been extremely slow for the past 3 days. Pages take 30+ seconds to load and sometimes timeout completely. My internet connection is fine and other websites work normally.
+```
+**Expected Route**: Technical Support Agent  
+**Expected Response**: Complete performance troubleshooting including browser optimization, cache clearing, system status check, and escalation to infrastructure team if needed  
+**Tool Execution**: `chat_with_agent` → Technical Support provides systematic performance diagnosis steps
+
+## 💳 Billing Support Scenarios
+
+### Scenario B1: Double Charge
+```
+I just checked my credit card statement and I was charged twice for this month's subscription - once on the 1st for $49.99 and again on the 3rd for the same amount. I need the duplicate charge refunded immediately.
+```
+**Expected Route**: Billing Agent  
+**Expected Response**: Complete refund process including charge verification, refund timeline (3-5 business days), and account credit options for immediate resolution  
+**Tool Execution**: `chat_with_agent` → Billing Agent provides specific refund procedures and account investigation steps
+
+### Scenario B2: Subscription Management
+```
+I want to upgrade from the Basic plan to Pro plan but I'm confused about the pricing. Will I be charged the full Pro amount or just the difference? Also, when would the upgrade take effect?
+```
+**Expected Route**: Billing Agent  
+**Expected Response**: Complete upgrade explanation including prorated billing calculation, immediate feature access, next billing cycle details, and upgrade procedure  
+**Tool Execution**: `chat_with_agent` → Billing Agent provides detailed prorated pricing explanation and upgrade process
+
+### Scenario B3: Payment Failure
+```
+My payment failed this morning and now my account is suspended. I updated my credit card last week so I'm not sure why it didn't work. How can I get my account reactivated quickly?
+```
+**Expected Route**: Billing Agent  
+**Expected Response**: Complete reactivation process including payment method verification, retry options, account status restoration timeline, and prevention steps  
+**Tool Execution**: `chat_with_agent` → Billing Agent provides immediate account reactivation steps and payment troubleshooting
+
+## 📖 Product Information Scenarios
+
+### Scenario P1: Feature Comparison
+```
+What's the difference between TeamFlow's Pro and Enterprise plans? I specifically need to know about API rate limits, user management features, and data export capabilities. We're a team of 25 people and currently on the Basic plan.
+```
+**Expected Route**: Product Info Agent  
+**Expected Response**: Complete plan comparison including detailed feature matrix, specific API limits (Pro: 10K/hour, Enterprise: 100K/hour), user management differences, and upgrade recommendation for 25-person team  
+**Tool Execution**: `chat_with_agent` → Product Info Agent provides comprehensive plan comparison with team-size specific recommendations
+
+### Scenario P2: How-To Question
+```
+How do I set up automated reports to be sent to my team every Monday? I see the reporting feature but can't figure out how to schedule them. Is this available in my current plan?
+```
+**Expected Route**: Product Info Agent  
+**Expected Response**: Complete setup guide including step-by-step report scheduling instructions, plan feature verification, and links to relevant documentation  
+**Tool Execution**: `chat_with_agent` → Product Info Agent provides detailed automated reporting setup walkthrough
+
+### Scenario P3: Integration Capabilities
+```
+Does TeamFlow integrate with Salesforce and Slack? I need to sync customer project data and get notifications in our Slack channels. What's the setup process like and are there any limitations I should know about? We're on the Pro plan.
+```
+**Expected Route**: Product Info Agent  
+**Expected Response**: Complete integration overview including supported Salesforce/Slack features, Pro plan limitations, setup documentation links, and configuration best practices  
+**Tool Execution**: `chat_with_agent` → Product Info Agent provides comprehensive integration capabilities and setup guidance
+
+## 🚨 Escalation Scenarios
+
+### Scenario E1: Legal Threat
+```
+This is my fourth email about data privacy violations. Your service exposed my customer data to unauthorized parties and I'm considering legal action. I need to speak with a manager immediately about this data breach.
+```
+**Expected Route**: Escalation Agent  
+**Expected Response**: Complete escalation including immediate management contact information, legal/compliance team connection, incident escalation procedure, and 2-hour response commitment  
+**Tool Execution**: `chat_with_agent` → Escalation Agent provides senior management contact and legal compliance escalation process
+
+### Scenario E2: Business Impact
+```
+Your system outage yesterday caused my e-commerce site to be down for 6 hours during Black Friday. This resulted in approximately $50,000 in lost sales. I need compensation for this business interruption and want to discuss SLA violations.
+```
+**Expected Route**: Escalation Agent  
+**Expected Response**: Complete business impact assessment including SLA review, compensation evaluation process, senior account manager contact, and formal incident investigation  
+**Tool Execution**: `chat_with_agent` → Escalation Agent provides business impact claim process and executive contact information
+
+### Scenario E3: Service Quality Complaint
+```
+I've been a customer for 3 years and the service quality has declined dramatically. Multiple support tickets have been ignored, features are constantly broken, and I'm considering switching to a competitor. I want to speak with someone who can actually resolve these ongoing issues.
+```
+**Expected Route**: Escalation Agent  
+**Expected Response**: Complete retention process including account review, senior support contact, service improvement plan, and customer success manager assignment  
+**Tool Execution**: `chat_with_agent` → Escalation Agent provides customer retention specialist contact and service quality improvement plan
+
+## 🤔 Mixed/Complex Scenarios
+
+### Scenario M1: Technical + Billing
+```
+My API requests started failing yesterday with 429 rate limit errors, but I'm on the Pro plan which should have higher limits. Did my plan get downgraded? I'm still being charged the Pro price but getting Basic plan limits.
+```
+**Expected Route**: Technical Support Agent (primary) or Billing Agent  
+**Expected Response**: Complete investigation including API limit verification, account status check, billing verification, and either technical resolution or billing escalation  
+**Tool Execution**: `chat_with_agent` → Technical Support investigates API limits and coordinates with billing if needed
+
+### Scenario M2: Product + Escalation
+```
+I was promised during the sales call that your Enterprise plan includes custom integrations. However, after upgrading, I'm being told this requires an additional $10,000 implementation fee. This contradicts what I was told by your sales team.
+```
+**Expected Route**: Escalation Agent  
+**Expected Response**: Complete sales promise review including sales team consultation, Enterprise feature verification, implementation fee clarification, and senior sales manager contact  
+**Tool Execution**: `chat_with_agent` → Escalation Agent provides sales promise investigation and senior management contact
+
+### Scenario M3: Vague Request
+```
+Hi, I'm having trouble with your service. Can you help me?
+```
+**Expected Route**: Should ask for clarification before routing  
+**Expected Response**: Polite clarification request with specific questions to help identify the issue type and appropriate specialist  
+**Tool Execution**: Triage agent asks clarifying questions without executing specialist tools
+
+## 🎯 Testing Instructions
+
+### Interactive Testing
+
+1. **Start the complete triage system**:
+   ```bash
+   npx dexto --agent agents/triage-demo/triage-agent.yml
+   ```
+
+2. **Copy and paste** scenarios from above into the chat
+
+3. **Observe the complete workflow**:
+   - **Routing analysis** (which specialist is chosen and why)
+   - **Tool execution** (`chat_with_agent` tool calls)  
+   - **Complete customer response** (routing confirmation + specialist answer)
+   - **Response quality** (specificity, completeness, helpfulness)
+
+### One-Shot Testing
+
+Test scenarios quickly with command-line execution:
+
+```bash
+# Test Technical Support scenario
+npx dexto --agent agents/triage-demo/triage-agent.yml "My TeamFlow mobile app crashes every time I try to export project data. I'm using iPhone 15 with iOS 17.2. This is urgent."
+
+# Test Billing scenario  
+npx dexto --agent agents/triage-demo/triage-agent.yml "I want to upgrade from Basic to Pro but confused about pricing. Will I be charged the full amount?"
+
+# Test Product Info scenario
+npx dexto --agent agents/triage-demo/triage-agent.yml "What's the difference between Pro and Enterprise plans? I need API access for 25 people."
+
+# Test Escalation scenario
+npx dexto --agent agents/triage-demo/triage-agent.yml "Your system outage cost my business $50,000 in lost sales. I need compensation and want to discuss SLA violations."
+```
+
+### Expected Response Quality
+
+For each test, verify that responses include:
+
+1. **Brief routing confirmation** (one sentence about which specialist was consulted)
+2. **Complete specialist answer** with specific, actionable information
+3. **Relevant details** from TeamFlow's business documentation
+4. **Appropriate tone** (professional, helpful, empathetic when needed)
+5. **Follow-up invitation** (offering additional help if needed)
+
+## 📊 Expected Results Summary
+
+| Category | Count | Expected Workflow |
+|----------|-------|-------------------|
+| Technical | 3 | Route → Execute Technical Support → Complete troubleshooting response |
+| Billing | 3 | Route → Execute Billing Agent → Complete billing/payment resolution |
+| Product Info | 3 | Route → Execute Product Info Agent → Complete feature/plan information |
+| Escalation | 3 | Route → Execute Escalation Agent → Complete escalation with contacts |
+| Mixed/Complex | 3 | Route → Execute Primary Agent → Complete investigation/resolution |
+
+## 🔍 Success Criteria
+
+The triage system should demonstrate:
+
+- **95%+ routing accuracy** to appropriate specialist agents
+- **100% tool execution** success (no failed `chat_with_agent` calls)
+- **Complete responses** that directly address customer needs
+- **Professional tone** with empathy for customer situations
+- **Specific information** from TeamFlow business context (plans, policies, features)
+- **Clear next steps** for customer resolution
+
+## 🚫 Common Issues to Watch For
+
+- **Routing without execution**: Agent identifies correct specialist but doesn't call `chat_with_agent`
+- **Tool confirmation prompts**: Should auto-approve due to configuration
+- **Incomplete responses**: Missing specialist answers or generic routing messages
+- **Wrong specialist**: Incorrect routing based on request analysis
+- **Multiple tool calls**: Unnecessary repeated calls to specialists
+
+The complete triage system should provide **seamless, professional customer support** that customers would expect from a real enterprise support team! 

package/agents/triage-demo/triage-agent.yml

@@ -0,0 +1,172 @@
+# Customer Support Triage Agent Configuration
+# Main coordination agent that routes requests to specialized support agents
+
+systemPrompt:
+  contributors:
+    - id: base-prompt
+      type: static
+      priority: 0
+      content: |
+        You are an intelligent Customer Support Triage Agent for TeamFlow, responsible for analyzing incoming customer requests and routing them to the most appropriate specialized support agent.
+
+        ## Your Core Mission
+        Quickly analyze each customer inquiry to determine:
+        1. The primary issue category
+        2. Urgency level 
+        3. Which specialized agent should handle it
+        4. Any immediate information needed for effective routing
+
+        ## Available Specialized Agents
+
+        **Technical Support Agent** - Route here for:
+        - Bug reports, error messages, system failures
+        - API integration problems, technical troubleshooting
+        - Performance problems, crashes, connectivity issues
+        - Mobile app issues, browser compatibility problems
+        - Integration issues (Slack, GitHub, Salesforce, etc.)
+
+        **Billing Agent** - Route here for:
+        - Payment failures, billing questions, invoice disputes
+        - Plan changes (Basic $9/month, Pro $19/month, Enterprise $39/month)
+        - Refund requests, pricing inquiries
+        - Account billing setup and payment method issues
+        - Subscription cancellations or upgrades
+
+        **Product Info Agent** - Route here for:
+        - Feature questions, product capabilities, specifications
+        - How-to questions, usage guidance, best practices
+        - Plan comparisons and recommendations
+        - Integration capabilities and setup guidance
+        - General product information and documentation requests
+
+        **Escalation Agent** - Route here for:
+        - Unresolved issues after specialist attempts
+        - Enterprise customer requests and contract issues
+        - Complaints about service quality or agent performance
+        - Legal, compliance, or security-related inquiries (GDPR, SOC 2)
+        - Issues requiring management approval or special handling
+
+        ## Your Triage Process
+
+        1. **Analyze the Request**: Read the customer's message carefully
+        2. **Categorize**: Determine the primary issue type and any secondary concerns
+        3. **Assess Urgency**: Is this urgent, normal, or low priority?
+        4. **Route Intelligently**: Choose the best-suited specialist agent
+        5. **Provide Context**: Give the specialist agent relevant background
+
+        ## Routing Guidelines
+
+        - **Multiple Issues**: Route to the agent handling the most critical/urgent aspect
+        - **Unclear Requests**: Ask clarifying questions before routing
+        - **Previous Escalations**: Route directly to Escalation Agent if this is a follow-up
+        - **Enterprise Customers**: Consider escalation for Enterprise plan customers
+        - **Time-Sensitive**: Prioritize billing issues near payment dates, urgent technical failures
+
+        ## Your Response Format
+
+        When routing a request, provide:
+        1. Brief analysis of the issue
+        2. Which agent you're routing to and why
+        3. Any additional context the specialist agent should know
+        4. Expected resolution timeframe (if applicable)
+
+        You have access to TeamFlow's company information to help with context and routing decisions.
+
+        Remember: You are the first line of intelligent support. Your accurate routing ensures TeamFlow customers get expert help quickly and efficiently.
+
+        ## Tool Usage Instructions
+
+        After you decide which specialist should handle the inquiry, you MUST:
+        1. Call the `chat_with_agent` tool with the full customer message as the `message` argument. The runtime will automatically route this call to the correct specialist agent based on the current connection mapping.
+        2. Wait for the tool to return the specialist agent’s answer.
+        3. Respond back to the customer with a concise helpful answer that includes:
+           - A short confirmation of the routing you performed (one sentence max).
+           - The detailed answer from the specialist agent.
+
+        Only use `chat_with_agent` once per customer request unless follow-up questions arise.
+
+    - id: company-overview
+      type: file
+      priority: 10
+      files:
+        - "${{dexto.agent_dir}}/docs/company-overview.md"
+      options:
+        includeFilenames: true
+        errorHandling: skip
+
+# Auto-approve tool executions so the triage agent can seamlessly delegate tasks
+
+toolConfirmation:
+  mode: auto-approve
+  allowedToolsStorage: memory
+
+mcpServers:
+  # Filesystem for logging and case management
+  filesystem:
+    type: stdio
+    command: npx
+    args:
+      - -y
+      - "@modelcontextprotocol/server-filesystem"
+      - .
+  
+  # Web research for understanding customer context and company info
+  tavily:
+    type: stdio
+    command: npx
+    args:
+      - -y
+      - tavily-mcp@0.1.3
+    env:
+      TAVILY_API_KEY: $TAVILY_API_KEY
+    connectionMode: lenient
+
+  # Specialized support agents running as MCP servers via npx
+  technical_support:
+    type: stdio
+    command: npx
+    args:
+      - dexto
+      - --mode
+      - mcp
+      - --agent
+      - "${{dexto.agent_dir}}/technical-support-agent.yml"
+    connectionMode: lenient
+  
+  billing_support:
+    type: stdio
+    command: npx
+    args:
+      - dexto
+      - --mode
+      - mcp
+      - --agent
+      - "${{dexto.agent_dir}}/billing-agent.yml"
+    connectionMode: lenient
+  
+  product_info:
+    type: stdio
+    command: npx
+    args:
+      - dexto
+      - --mode
+      - mcp
+      - --agent
+      - "${{dexto.agent_dir}}/product-info-agent.yml"
+    connectionMode: lenient
+  
+  escalation:
+    type: stdio
+    command: npx
+    args:
+      - dexto
+      - --mode
+      - mcp
+      - --agent
+      - "${{dexto.agent_dir}}/escalation-agent.yml"
+    connectionMode: lenient
+
+llm:
+  provider: openai
+  model: gpt-4o
+  apiKey: $OPENAI_API_KEY