tlnt/README.md

TLNT - HMS-Powered Multi-Agent Platform with Government Agency Analysis, Deep Research, and Enterprise-Ready Deployment. Self-optimizing multi-domain AI agent with continuous learning and enterprise-grade performance monitoring.

# TLNT v3.0 - HMS-Powered Multi-Agent Platform

🚀 **Self-optimizing multi-domain AI agent with continuous learning, enhanced installation experience, and enterprise-grade performance monitoring for coding, accounting, legal, and all professional tasks.**

[![npm version](https://badge.fury.io/js/tlnt.svg)](https://badge.fury.io/js/tlnt)
[![Node.js](https://img.shields.io/badge/node-%3E%3D18-brightgreen.svg)](https://nodejs.org/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

## 🌟 What's New in v3.0

### 🔥 HMS Integration - No Local LLM Keys Required!
- **HMS-NET Integration**: Agent orchestration and workflow management
- **HMS-NFO Integration**: Government data processing and deep research
- **Zero Setup**: No OpenAI or Anthropic API keys needed
- **Enterprise Ready**: Production-grade security and compliance

### 🏛️ Government & Agency Analysis
- Pre-configured analysis for EPA, FDA, CDC, HHS, DOE, and more
- State-specific regulatory compliance
- Automated HMS component recommendations
- Real-time policy and regulation updates

### 🔬 Advanced Research Capabilities
- **CoRT Analysis**: Chain of Recursive Thought for complex research
- Multi-source data aggregation
- Confidence scoring and source verification
- Academic, government, and industry data synthesis

### 🖥️ Tmux-Style Interface
- Split-panel terminal interface (70% main, 30% info)
- Real-time system status monitoring
- Interactive command processing
- Responsive design with live updates

## 🚀 Quick Start

### Installation
```bash
npm install -g tlnt@latest
```

### Launch HMS-Powered Interface
```bash
# Launch tmux-style interface with HMS integration
tlnt tmux

# Or use the classic interactive mode
tlnt interactive

# One-shot queries
tlnt ask "Analyze EPA water quality regulations"
```

### Basic Usage
```bash
# Government agency analysis
> analyze EPA water quality compliance requirements

# Deep research with CoRT analysis  
> research healthcare data integration standards

# System status
> /status

# Available commands
> /help
```

## 🏗️ Architecture

```
┌─────────────────────────────────────────────────────────────────┐
│                         TLNT v3.0                               │
├─────────────────────────────────────────────────────────────────┤
│  🖥️ Tmux Interface        🤖 HMS Agent Hub                      │
│  ┌─────────────────┐     ┌─────────────────────────────────────┐ │
│  │ Main Panel (70%)│     │ • Smart Routing                     │ │
│  │ • Chat          │     │ • Auto Fallback                    │ │
│  │ • Commands      │     │ • Research Mode                     │ │
│  │ • Results       │     │ • Agency Analysis                   │ │
│  └─────────────────┘     └─────────────────────────────────────┘ │
│  ┌─────────────────┐     ┌─────────────────────────────────────┐ │
│  │ Info Panel (30%)│     │ HMS Integrated Client               │ │
│  │ • System Status │     │ ┌─────────────┐ ┌─────────────────┐ │ │
│  │ • Active Agents │     │ │ HMS-NET     │ │ HMS-NFO         │ │ │
│  │ • Workflows     │     │ │ Client      │ │ Client          │ │ │
│  │ • Health        │     │ └─────────────┘ └─────────────────┘ │ │
│  └─────────────────┘     └─────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────────┘
                                  │
                                  ▼
┌─────────────────────────────────────────────────────────────────┐
│                        HMS Ecosystem                            │
├─────────────────────────────────────────────────────────────────┤
│  🔧 HMS-NET                      📊 HMS-NFO                     │
│  (Agent Network)                 (Data Processing)              │
│  • Agent Orchestration          • Government Data ETL          │
│  • Workflow Management          • Agency Issue Analysis        │
│  • Real-time Coordination       • Deep Research Engine         │
│  • Network Topology             • CoRT Analysis                │
└─────────────────────────────────────────────────────────────────┘
```

## 🎯 Key Features

### 🤖 **Intelligent Agent Orchestration**
- Multi-agent coordination via HMS-NET
- Automatic agent selection and routing
- Real-time performance monitoring
- Workflow dependency management

### 📚 **Deep Research Engine**
- CoRT (Chain of Recursive Thought) analysis
- Multi-source information synthesis
- Government and academic data integration
- Confidence scoring and verification

### 🏛️ **Government Agency Integration**
- **EPA**: Environmental regulations and compliance
- **FDA**: Medical device and pharmaceutical guidelines
- **CDC**: Public health data and guidelines
- **HHS**: Healthcare policy and requirements
- **DOE**: Energy sector regulations
- **DOT**: Transportation standards
- **USDA**: Agricultural compliance

### 🔄 **Workflow Orchestration**
- Multi-step process automation
- Parallel and sequential execution
- Real-time status monitoring
- Error handling and recovery

### 🛡️ **Enterprise Security**
- API key-based authentication
- Secure HMS system communication
- Audit logging and compliance
- Rate limiting and circuit breakers

### 💼 **Professional Domain Expertise**
- **Coding**: Software development and debugging
- **Accounting**: Financial analysis and compliance
- **Legal**: Regulatory research and documentation
- **Healthcare**: Clinical workflow optimization
- **Government**: Policy analysis and compliance

## 📖 Commands Reference

### Tmux Interface Commands
```bash
# System commands (prefix with /)
/help          # Show available commands
/status        # System health and status
/agents        # List active agents  
/deals         # Show active deals
/clear         # Clear main panel

# Navigation
Tab            # Switch between main and info panels
Ctrl+M         # Cycle through modes (chat/command/status)
Ctrl+C         # Exit interface

# Direct queries (no prefix needed)
analyze FDA AI medical device guidelines
research state healthcare data privacy laws
what are the latest EPA water quality standards
```

### CLI Commands
```bash
# Interactive modes
tlnt interactive              # Classic full-screen mode
tlnt tmux                    # Split-panel tmux-style interface

# One-shot operations
tlnt ask "query"             # Quick question
tlnt ask "analyze EPA" --json # JSON output

# System management
tlnt system start            # Start system services
tlnt system status           # Check system health
tlnt demo                    # Run interactive demo
tlnt config                  # Show configuration

# Agent operations
tlnt agents list             # List available agents
tlnt cloud status            # Check HMS cloud status
```

## ⚙️ Configuration

### Environment Variables
```bash
# HMS-NET Configuration (optional - uses production defaults)
HMS_NET_URL=https://kädəfī.com
HMS_NET_API_KEY=your_api_key

# HMS-NFO Configuration (optional - uses production defaults)  
HMS_NFO_URL=https://kōdəfī.com
HMS_NFO_API_KEY=your_api_key

# System Configuration
NODE_ENV=production
DEBUG=false
```

## 🔧 Development

### Setup
```bash
git clone <repository>
cd tlnt
npm install
npm run build
```

### Scripts
```bash
npm run dev              # Development mode
npm run build            # Build TypeScript
npm run test             # Run tests
npm run lint             # Code linting
npm run typecheck        # Type checking
npm run tmux             # Launch tmux interface
```

## 🏆 Benefits Over v2.x

| Feature | v2.x | v3.0 |
|---------|------|------|
| **LLM Setup** | Required API keys | ❌ No keys needed |
| **Government Analysis** | Basic | ✅ Full agency integration |
| **Research Capabilities** | Limited | ✅ CoRT-powered deep research |
| **UI Experience** | Single pane | ✅ Tmux-style split panels |
| **Agent Coordination** | Single agent | ✅ Multi-agent orchestration |
| **Workflow Management** | Manual | ✅ Automated with dependencies |
| **Enterprise Features** | Basic | ✅ Full compliance & security |
| **Professional Domains** | General purpose | ✅ Specialized expertise |
| **Continuous Learning** | Static | ✅ Self-optimizing with OODA cycle |
| **Performance Monitoring** | None | ✅ Enterprise-grade telemetry |

## 🤝 Contributing

We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.

## 📝 License

MIT License - see [LICENSE](LICENSE) file for details.

## 🆘 Support

- **Documentation**: [HMS-OPM Documentation](https://docs.hms-opm.com)
- **Issues**: [GitHub Issues](https://github.com/HMS-OPM/tlnt/issues)
- **Email**: support@hms-opm.com

---

**Built with ❤️ by the HMS-OPM Team**

*Transform your professional workflow with enterprise-grade AI agent orchestration.*