Package Exports

blax

Readme

Blax v3.0 - HMS-Powered Multi-Agent Platform

🚀 Enterprise-grade multi-agent collaboration platform with integrated government analysis, deep research, and workflow orchestration.

🌟 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

npm install -g blax@latest

Launch HMS-Powered Interface

# Launch tmux-style interface with HMS integration
blax tmux

# Or use the classic interactive mode
blax interactive

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

Basic Usage

# 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

┌─────────────────────────────────────────────────────────────────┐
│                         Blax 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

📖 Commands Reference

Tmux Interface Commands

# 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

# Interactive modes
blax interactive              # Classic full-screen mode
blax tmux                    # Split-panel tmux-style interface

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

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

# Agent operations
blax agents list             # List available agents
blax cloud status            # Check HMS cloud status

⚙️ Configuration

Environment Variables

# HMS-NET Configuration (optional - uses defaults)
HMS_NET_URL=https://hms-net.herokuapp.com
HMS_NET_API_KEY=your_api_key

# HMS-NFO Configuration (optional - uses defaults)  
HMS_NFO_URL=https://hms-nfo-2b4dbb6f7d60.herokuapp.com
HMS_NFO_API_KEY=your_api_key

# System Configuration
NODE_ENV=production
DEBUG=false

🔧 Development

Setup

git clone <repository>
cd blax
npm install
npm run build

Scripts

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
Fallback System	None	✅ Graceful degradation

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for details.

📝 License

MIT License - see LICENSE file for details.

🆘 Support

Documentation: HMS-OPM Documentation
Issues: GitHub Issues
Email: support@hms-opm.com

Built with ❤️ by the HMS-OPM Team

Transform your workflow with enterprise-grade AI agent orchestration.