dexto 1.0.1 → 1.1.0

package/agents/triage-demo/docs/product-features.md

@@ -0,0 +1,253 @@
+# TeamFlow Product Features & Information
+
+## Core Platform Features
+
+### Project Management
+
+#### Task Management
+- **Create & Organize**: Unlimited task creation with custom categories and tags
+- **Task Dependencies**: Link tasks with predecessor/successor relationships
+- **Subtasks**: Break down complex tasks into manageable subtasks (up to 5 levels deep)
+- **Priority Levels**: Critical, High, Medium, Low priority with visual indicators
+- **Due Dates**: Set deadlines with automatic reminders and escalation
+- **Custom Fields**: Add custom properties (text, numbers, dates, dropdowns, checkboxes)
+- **Task Templates**: Save and reuse common task structures
+
+#### Project Views
+- **Kanban Boards**: Drag-and-drop task management with customizable columns
+- **Gantt Charts**: Timeline view with critical path analysis (Pro/Enterprise)
+- **List View**: Traditional task list with sorting and filtering
+- **Calendar View**: Tasks and deadlines in calendar format
+- **Dashboard View**: Project overview with progress metrics and team activity
+
+#### Collaboration Tools
+- **Comments**: Real-time commenting on tasks and projects with @mentions
+- **File Attachments**: Attach files directly to tasks with version control
+- **Activity Feed**: Real-time updates on project activity
+- **Team Chat**: Built-in messaging with project-specific channels
+- **Screen Sharing**: Integrated video conferencing for remote teams (Pro/Enterprise)
+
+### Time Tracking & Reporting
+
+#### Time Tracking
+- **Manual Entry**: Log time spent on tasks manually
+- **Timer Integration**: Start/stop timers directly from tasks
+- **Automatic Tracking**: AI-powered time detection based on activity (Pro/Enterprise)
+- **Time Approval**: Manager approval workflow for billable hours
+- **Offline Tracking**: Mobile app continues tracking without internet connection
+
+#### Reporting & Analytics
+- **Project Reports**: Progress, budget, and timeline analysis
+- **Team Performance**: Individual and team productivity metrics
+- **Time Reports**: Detailed time tracking and billing reports
+- **Custom Dashboards**: Build personalized views with key metrics
+- **Export Options**: PDF, Excel, CSV export for all reports
+
+### Storage & File Management
+
+#### File Storage
+- **Basic Plan**: 5GB total storage per team
+- **Pro Plan**: 100GB total storage per team
+- **Enterprise Plan**: 1TB total storage per team
+- **File Types**: Support for all major file formats
+- **Version Control**: Automatic versioning with rollback capability
+
+#### File Sharing
+- **Public Links**: Share files with external stakeholders
+- **Permission Control**: Read-only, edit, or full access permissions
+- **Expiring Links**: Set expiration dates for shared files
+- **Download Tracking**: Monitor who downloads shared files
+
+## Advanced Features by Plan
+
+### Basic Plan Features
+- Up to 10 team members
+- Core project management (tasks, lists, basic boards)
+- 5GB file storage
+- Mobile apps (iOS/Android)
+- Email support
+- Basic integrations (Google Calendar, CSV import)
+- API access (1,000 requests/hour)
+
+### Pro Plan Additional Features
+- Up to 100 team members
+- Advanced project views (Gantt charts, advanced dashboards)
+- 100GB file storage
+- Custom fields and workflows
+- Time tracking and invoicing
+- Advanced integrations (Slack, GitHub, Jira, Salesforce)
+- Priority support (chat + email)
+- API access (10,000 requests/hour)
+- Team workload balancing
+- Advanced reporting and analytics
+- Custom branding (logo, colors)
+
+### Enterprise Plan Additional Features
+- Unlimited team members
+- 1TB file storage
+- Advanced security (SSO, SAML, 2FA enforcement)
+- Dedicated customer success manager
+- Phone support with 4-hour SLA
+- Unlimited API access
+- Custom integrations and white-labeling
+- Advanced admin controls and audit logs
+- On-premises deployment option
+- 99.95% uptime SLA
+- Custom workflow automation
+- Advanced permissions and role management
+
+## Integration Ecosystem
+
+### Communication Platforms
+
+#### Slack Integration (Pro/Enterprise)
+- **Two-way Sync**: Create tasks from Slack messages, get updates in channels
+- **Notification Control**: Choose which updates appear in Slack
+- **Slash Commands**: Quick task creation with `/teamflow create` command
+- **File Sync**: Automatically sync files shared in Slack to project storage
+
+#### Microsoft Teams (Pro/Enterprise)
+- **Tab Integration**: Embed TeamFlow projects directly in Teams channels
+- **Bot Commands**: Create and update tasks via Teams bot
+- **Calendar Sync**: Sync project deadlines with Teams calendar
+- **File Integration**: Access TeamFlow files from Teams file browser
+
+#### Discord (Pro/Enterprise)
+- **Channel Integration**: Link Discord channels to specific projects
+- **Role Sync**: Sync Discord roles with TeamFlow permissions
+- **Voice Channel Links**: Start Discord voice calls directly from tasks
+
+### Development Tools
+
+#### GitHub Integration (Pro/Enterprise)
+- **Commit Linking**: Link commits to specific tasks automatically
+- **Pull Request Tracking**: Track PR status within TeamFlow tasks
+- **Branch Management**: Create branches directly from tasks
+- **Release Planning**: Plan releases using TeamFlow milestones
+
+#### GitLab Integration (Pro/Enterprise)
+- **Issue Sync**: Two-way sync between GitLab issues and TeamFlow tasks
+- **Pipeline Status**: View CI/CD pipeline status in project dashboard
+- **Merge Request Workflow**: Track code reviews within project context
+
+#### Jira Integration (Pro/Enterprise)
+- **Epic/Story Mapping**: Map Jira epics to TeamFlow projects
+- **Sprint Planning**: Import Jira sprints as TeamFlow milestones
+- **Status Sync**: Automatically update task status based on Jira workflow
+
+### CRM & Sales Tools
+
+#### Salesforce Integration (Pro/Enterprise)
+- **Lead-to-Project**: Convert Salesforce leads into TeamFlow projects
+- **Account Sync**: Link projects to Salesforce accounts
+- **Opportunity Tracking**: Track project delivery against sales opportunities
+
+#### HubSpot Integration (Pro/Enterprise)
+- **Contact Sync**: Import HubSpot contacts as team members
+- **Deal Pipeline**: Track project delivery stages aligned with deal stages
+- **Marketing Campaign Tracking**: Link projects to marketing campaigns
+
+### File Storage & Productivity
+
+#### Google Workspace
+- **Google Drive**: Direct file access and sync with Google Drive
+- **Google Calendar**: Two-way calendar sync for deadlines and meetings
+- **Gmail**: Create tasks from emails with Gmail browser extension
+- **Google Sheets**: Import/export project data to Google Sheets
+
+#### Microsoft 365
+- **OneDrive**: Seamless file sync and storage integration
+- **Outlook**: Email-to-task conversion and calendar integration
+- **Excel**: Advanced reporting with Excel integration
+- **SharePoint**: Enterprise file management and compliance
+
+#### Dropbox
+- **File Sync**: Automatic sync of project files with Dropbox
+- **Paper Integration**: Convert Dropbox Paper docs to project documentation
+- **Team Folders**: Organize project files in shared Dropbox folders
+
+## Mobile Applications
+
+### iOS App Features
+- **Native Design**: Full iOS design guidelines compliance
+- **Offline Support**: Continue working without internet connection
+- **Push Notifications**: Real-time updates for mentions, deadlines, and assignments
+- **Touch ID/Face ID**: Biometric authentication for security
+- **Widgets**: Quick access to tasks and notifications from home screen
+- **Apple Watch**: Task completion and notifications on Apple Watch
+
+### Android App Features
+- **Material Design**: Full Android Material Design implementation
+- **Battery Optimization**: Efficient background sync and battery usage
+- **Quick Settings**: Add tasks and check notifications from notification panel
+- **Google Assistant**: Voice commands for task creation and status updates
+- **Adaptive Icons**: Support for Android adaptive icon system
+
+### Cross-Platform Features
+- **Real-time Sync**: Instant synchronization across all devices
+- **Offline Mode**: Full functionality without internet connection
+- **File Download**: Download and view attachments offline
+- **Voice Notes**: Record voice memos and attach to tasks
+- **Photo Capture**: Take photos and attach directly to tasks
+
+## API & Developer Tools
+
+### REST API
+- **Full Coverage**: Complete access to all platform features via API
+- **Rate Limits**: 1,000/hour (Basic), 10,000/hour (Pro), unlimited (Enterprise)
+- **Authentication**: OAuth 2.0 and API key authentication
+- **Webhooks**: Real-time event notifications for integrations
+- **GraphQL**: Alternative GraphQL endpoint for efficient data fetching
+
+### SDKs & Libraries
+- **JavaScript/Node.js**: Full-featured SDK with TypeScript support
+- **Python**: Comprehensive Python library with async support
+- **PHP**: Laravel and standard PHP integration library
+- **Ruby**: Ruby gem with Rails integration helpers
+- **REST Clients**: Postman collection and OpenAPI specification
+
+### Webhook Events
+- **Task Events**: Created, updated, completed, deleted
+- **Project Events**: Created, archived, member changes
+- **Comment Events**: New comments, mentions, reactions
+- **File Events**: Uploaded, updated, shared, deleted
+- **Team Events**: Member added, removed, role changes
+
+## Security & Compliance
+
+### Data Security
+- **Encryption**: AES-256 encryption for all data at rest and in transit
+- **HTTPS**: TLS 1.3 for all client connections
+- **API Security**: Rate limiting, request signing, and token management
+- **Database Security**: Encrypted backups with geographic redundancy
+
+### Access Control
+- **Role-Based Permissions**: Admin, Manager, Member, Viewer roles
+- **Project-Level Permissions**: Fine-grained control over project access
+- **Two-Factor Authentication**: SMS, authenticator app, hardware keys (Pro/Enterprise)
+- **Single Sign-On**: SAML 2.0 and OAuth integration (Enterprise)
+
+### Compliance Standards
+- **SOC 2 Type II**: Annual compliance audits and certification
+- **GDPR**: Full compliance with European data protection regulations
+- **ISO 27001**: Information security management certification
+- **HIPAA**: Healthcare compliance option for Enterprise customers
+
+## Getting Started Resources
+
+### Onboarding
+- **Interactive Tutorial**: Step-by-step guide for new users
+- **Sample Projects**: Pre-built templates for common use cases
+- **Video Library**: Comprehensive training videos for all features
+- **Webinar Training**: Live training sessions twice weekly
+
+### Documentation
+- **Knowledge Base**: Searchable help articles and guides
+- **API Documentation**: Complete developer reference with examples
+- **Video Tutorials**: Feature-specific how-to videos
+- **Community Forum**: User community for tips and best practices
+
+### Support Channels
+- **Basic Plan**: Email support with 24-hour response
+- **Pro Plan**: Email and chat support with 8-hour response
+- **Enterprise Plan**: Phone, email, and chat with 4-hour response and dedicated success manager 

package/agents/triage-demo/docs/technical-documentation.md

@@ -0,0 +1,226 @@
+# TeamFlow Technical Documentation
+
+## System Requirements
+
+### Web Application
+- **Supported Browsers**: Chrome 90+, Firefox 88+, Safari 14+, Edge 90+
+- **Minimum Screen Resolution**: 1024x768
+- **Internet Connection**: Broadband (1 Mbps minimum, 5 Mbps recommended)
+- **JavaScript**: Must be enabled
+
+### Mobile Applications
+
+#### iOS App
+- **Minimum Version**: iOS 13.0 or later
+- **Compatible Devices**: iPhone 6s and newer, iPad Air 2 and newer
+- **Storage**: 150MB free space required
+- **Network**: 3G/4G/5G or Wi-Fi connection
+
+#### Android App
+- **Minimum Version**: Android 8.0 (API level 26)
+- **RAM**: 2GB minimum, 4GB recommended
+- **Storage**: 200MB free space required
+- **Network**: 3G/4G/5G or Wi-Fi connection
+
+## API Documentation
+
+### Authentication
+```
+Authorization: Bearer <your_api_token>
+Content-Type: application/json
+```
+
+### Base URL
+- **Production**: `https://api.teamflow.com/v1`
+- **Sandbox**: `https://sandbox-api.teamflow.com/v1`
+
+### Rate Limits
+- **Basic Plan**: 1,000 requests/hour
+- **Pro Plan**: 10,000 requests/hour  
+- **Enterprise Plan**: Unlimited
+- **Rate Limit Headers**:
+  - `X-RateLimit-Limit`: Total requests allowed
+  - `X-RateLimit-Remaining`: Requests remaining in current window
+  - `X-RateLimit-Reset`: Unix timestamp when window resets
+
+### Common Error Codes
+- **400**: Bad Request - Invalid parameters or request format
+- **401**: Unauthorized - Invalid or missing API token
+- **403**: Forbidden - Insufficient permissions
+- **404**: Not Found - Resource doesn't exist
+- **422**: Unprocessable Entity - Validation errors
+- **429**: Too Many Requests - Rate limit exceeded
+- **500**: Internal Server Error - Contact support
+- **502/503**: Service Unavailable - Temporary outage
+
+## Common Technical Issues & Solutions
+
+### 1. Login and Authentication Issues
+
+#### "Invalid credentials" error
+**Symptoms**: User cannot log in, receives "Invalid email or password" message
+**Common Causes**:
+- Incorrect email/password combination
+- Account locked due to multiple failed attempts
+- Browser caching old session data
+
+**Solutions**:
+1. Verify email address (check for typos, extra spaces)
+2. Try password reset flow
+3. Clear browser cookies and cache
+4. Try incognito/private browsing mode
+5. Check if account is locked (wait 15 minutes or contact support)
+
+#### Two-Factor Authentication (2FA) issues
+**Symptoms**: 2FA code not working or not received
+**Solutions**:
+1. Ensure device clock is synchronized
+2. Try generating a new code (codes expire every 30 seconds)
+3. Check authenticator app is configured correctly
+4. Use backup codes if available
+5. Contact support to reset 2FA if backup codes exhausted
+
+### 2. Performance Issues
+
+#### Slow loading pages
+**Symptoms**: Pages take >10 seconds to load, timeouts
+**Troubleshooting Steps**:
+1. Check internet connection speed (minimum 1 Mbps required)
+2. Test on different networks (mobile data vs. Wi-Fi)
+3. Clear browser cache and cookies
+4. Disable browser extensions temporarily
+5. Try different browser
+6. Check TeamFlow status page: status.teamflow.com
+
+#### Mobile app crashes
+**Symptoms**: App closes unexpectedly, freezes during use
+**Solutions**:
+1. Force close and restart the app
+2. Restart device
+3. Update app to latest version
+4. Clear app cache (Android) or offload/reinstall app (iOS)
+5. Check available storage space (minimum 500MB recommended)
+6. Report crash with device logs
+
+### 3. API Integration Issues
+
+#### 401 Unauthorized errors
+**Diagnostic Steps**:
+1. Verify API token is correct and not expired
+2. Check token has required permissions
+3. Ensure proper Authorization header format
+4. Test with different API endpoints
+
+#### 429 Rate limit exceeded
+**Solutions**:
+1. Implement exponential backoff in API calls
+2. Check current rate limit status in response headers
+3. Consider upgrading plan for higher limits
+4. Cache responses when possible to reduce API calls
+
+#### Webhook delivery failures
+**Common Issues**:
+- Endpoint URL not accessible from internet
+- SSL certificate issues
+- Timeout (webhook endpoint must respond within 10 seconds)
+- Incorrect response status (must return 2xx status code)
+
+### 4. File Upload Issues
+
+#### "File too large" errors
+**File Size Limits**:
+- Basic Plan: 25MB per file
+- Pro Plan: 100MB per file
+- Enterprise Plan: 500MB per file
+
+**Solutions**:
+1. Compress files using zip/rar
+2. Use cloud storage links for large files
+3. Split large files into smaller chunks
+4. Consider plan upgrade for larger limits
+
+#### Unsupported file formats
+**Supported Formats**: 
+- Images: JPG, PNG, GIF, SVG, WebP
+- Documents: PDF, DOC, DOCX, XLS, XLSX, PPT, PPTX
+- Archives: ZIP, RAR, 7Z
+- Text: TXT, CSV, MD
+- Code: JS, HTML, CSS, JSON, XML
+
+### 5. Integration Problems
+
+#### Slack integration not working
+**Setup Requirements**:
+1. Slack workspace admin permissions
+2. TeamFlow Pro or Enterprise plan
+3. Proper webhook configuration
+
+**Troubleshooting**:
+1. Verify Slack workspace URL is correct
+2. Check webhook permissions in Slack admin
+3. Test with simple message first
+4. Ensure both apps are updated to latest versions
+
+#### GitHub integration issues
+**Common Problems**:
+- Repository access permissions
+- Webhook authentication failures
+- Branch protection rules blocking commits
+
+**Solutions**:
+1. Verify GitHub personal access token has correct scopes
+2. Check repository permissions for TeamFlow app
+3. Review webhook logs in GitHub settings
+4. Test with public repository first
+
+## Browser-Specific Issues
+
+### Chrome
+- **File download issues**: Check download settings and blocked downloads
+- **Extension conflicts**: Disable ad blockers and privacy extensions temporarily
+
+### Safari
+- **Cookie issues**: Enable cross-site tracking prevention exceptions
+- **Local storage**: Ensure not in private browsing mode
+
+### Firefox
+- **Security settings**: Adjust strict enhanced tracking protection
+- **Add-on conflicts**: Test in safe mode
+
+## Server Infrastructure
+
+### Data Centers
+- **Primary**: AWS US-West-2 (Oregon)
+- **Secondary**: AWS EU-West-1 (Ireland)
+- **CDN**: CloudFlare global network
+
+### Maintenance Windows
+- **Scheduled Maintenance**: Sundays 2:00-4:00 AM PST
+- **Emergency Maintenance**: As needed with 30-minute notice
+- **Status Updates**: status.teamflow.com and @TeamFlowStatus on Twitter
+
+## Escalation Criteria
+
+Escalate to Level 2 Support when:
+- Data loss or corruption suspected
+- Security breach indicators
+- API downtime affecting multiple customers
+- Integration partner (Slack, GitHub, etc.) reporting issues
+- Customer reports SLA violations
+- Enterprise customer experiencing any service disruption
+
+## Diagnostic Tools
+
+### Browser Developer Tools
+1. **Console Errors**: Check for JavaScript errors (F12 → Console)
+2. **Network Tab**: Monitor failed requests and response times
+3. **Application Tab**: Check local storage and cookies
+
+### API Testing
+- Use Postman or curl to test API endpoints
+- Check response headers for rate limit information
+- Verify request format matches API documentation
+
+### Mobile Debugging
+- iOS: Connect device to Xcode for detailed crash logs
+- Android: Enable developer options and use ADB logcat 

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

@@ -0,0 +1,82 @@
+# Escalation Agent Configuration
+# Handles complex issues requiring human intervention or management approval
+
+systemPrompt:
+  contributors:
+    - id: base-prompt
+      type: static
+      priority: 0
+      content: |
+        You are a specialized Escalation Agent for TeamFlow, responsible for handling complex, sensitive, or high-priority issues that require management intervention.
+
+        Your primary responsibilities:
+        - Manage escalated cases from other support agents
+        - Handle Enterprise customer issues and urgent requests
+        - Process complaints, disputes, and sensitive matters
+        - Coordinate with management and specialized teams
+        - Document incident reports and follow-up actions
+
+        Your approach:
+        - Take detailed notes of the issue history and previous resolution attempts
+        - Gather all relevant context and supporting documentation
+        - Assess urgency level and potential business impact
+        - Communicate clearly with both customers and internal teams
+        - Follow up promptly on all escalated matters
+
+        Types of issues you handle:
+        - Unresolved technical issues after multiple attempts
+        - Billing disputes requiring management approval
+        - Enterprise customer feature requests and contract issues
+        - Security incidents and data privacy concerns
+        - Legal or compliance-related inquiries (GDPR, SOC 2, etc.)
+        - Customer complaints about service quality
+
+        You have access to comprehensive escalation policies, procedures, and contact information for TeamFlow's management team, including security incident protocols and legal compliance procedures.
+
+        Tools available to you:
+        - Email and communication tools for coordinating with teams
+        - Filesystem access for documentation and case management
+        - Web research for regulatory and legal information
+
+        Remember: Maintain professionalism, document everything thoroughly, and ensure proper follow-up on all escalated cases according to TeamFlow's escalation policies.
+    
+    - id: company-overview
+      type: file
+      priority: 10
+      files:
+        - "${{dexto.agent_dir}}/docs/company-overview.md"
+      options:
+        includeFilenames: true
+        errorHandling: skip
+    
+    - id: escalation-policies
+      type: file
+      priority: 20
+      files:
+        - "${{dexto.agent_dir}}/docs/escalation-policies.md"
+      options:
+        includeFilenames: true
+        errorHandling: skip
+
+mcpServers:
+  filesystem:
+    type: stdio
+    command: npx
+    args:
+      - -y
+      - "@modelcontextprotocol/server-filesystem"
+      - .
+  tavily:
+    type: stdio
+    command: npx
+    args:
+      - -y
+      - tavily-mcp@0.1.3
+    env:
+      TAVILY_API_KEY: $TAVILY_API_KEY
+    connectionMode: lenient
+
+llm:
+  provider: openai
+  model: gpt-4o
+  apiKey: $OPENAI_API_KEY 

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

@@ -0,0 +1,86 @@
+# Product Information Agent Configuration  
+# Specializes in product features, comparisons, and general information
+
+systemPrompt:
+  contributors:
+    - id: base-prompt
+      type: static
+      priority: 0
+      content: |
+        You are a specialized Product Information Agent for TeamFlow, with comprehensive knowledge about our project management and team collaboration platform.
+
+        Your primary responsibilities:
+        - Answer questions about TeamFlow's features, capabilities, and specifications
+        - Provide product comparisons and recommendations between Basic, Pro, and Enterprise plans
+        - Explain how to use specific features and functionalities
+        - Share information about integrations and API capabilities
+        - Guide users to appropriate documentation and resources
+
+        Your approach:
+        - Provide accurate, up-to-date product information
+        - Use clear, non-technical language when explaining complex features
+        - Offer relevant examples and use cases
+        - Suggest the best product tier or plan for user needs
+        - Direct users to detailed documentation or demos when helpful
+
+        Key information to gather:
+        - User's specific use case or requirements
+        - Current product tier or plan (if applicable)
+        - Specific features or functionality they're asking about
+        - Their technical expertise level
+
+        You have access to comprehensive product documentation covering all TeamFlow features, integrations (Slack, GitHub, Salesforce, etc.), mobile apps, API capabilities, and plan comparisons.
+
+        Tools available to you:
+        - Web research for latest product information and competitor analysis
+        - Filesystem access to read product documentation and specs
+        - Browser automation for demonstrating features
+
+        Remember: Always provide accurate information about TeamFlow and acknowledge when you need to research or verify details.
+    
+    - id: company-overview
+      type: file
+      priority: 10
+      files:
+        - "${{dexto.agent_dir}}/docs/company-overview.md"
+      options:
+        includeFilenames: true
+        errorHandling: skip
+    
+    - id: product-features
+      type: file
+      priority: 20
+      files:
+        - "${{dexto.agent_dir}}/docs/product-features.md"
+      options:
+        includeFilenames: true
+        errorHandling: skip
+
+mcpServers:
+  tavily:
+    type: stdio
+    command: npx
+    args:
+      - -y
+      - tavily-mcp@0.1.3
+    env:
+      TAVILY_API_KEY: $TAVILY_API_KEY
+    connectionMode: lenient
+  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-mini
+  apiKey: $OPENAI_API_KEY