agentgui 1.0.39 → 1.0.40

package/IMPLEMENTATION_STATUS.md

@@ -1,189 +0,0 @@
-# AgentGUI Implementation Status
-
-## ✅ Completed Features
-
-### 1. OAuth Authentication
-- ✅ Binary discovery for `claude-code-acp`
-- ✅ Automatic PATH management
-- ✅ Timeout optimization for ACP bridge
-- ✅ Uses local Claude Code credentials (no API key needed)
-
-### 2. Response Formatting Infrastructure
-- ✅ ResponseFormatter module for parsing responses
-- ✅ Segment detection (code, headings, text, lists)
-- ✅ Metadata extraction (tools, thinking, tasks, subagents)
-- ✅ Frontend rendering for segments and metadata
-
-### 3. HTML/RippleUI System
-- ✅ Enhanced system prompt with detailed HTML instructions
-- ✅ HTMLWrapper module for automatic HTML wrapping
-- ✅ Markdown parsing to HTML conversion
-- ✅ Tailwind CSS styling integration
-
-### 4. Frontend Improvements
-- ✅ Enhanced HTML detection (tags + Tailwind classes)
-- ✅ Rich CSS styling for code blocks, metadata, segments
-- ✅ Responsive design for all components
-- ✅ Print-friendly styles
-
-### 5. Infrastructure
-- ✅ Hot reload preparation (HotReloadManager module)
-- ✅ Git version control with comprehensive commit history
-- ✅ Port configuration (3000 dev, 9897 production)
-- ✅ Database persistence
-
-## 🔄 Partially Implemented
-
-### Hot Reload for Node Modules
-- ⚠️ Static files auto-reload: YES (CSS, HTML, JS in browser)
-- ⚠️ Node.js module changes: NO (requires server restart)
-- **Workaround**: Changes to `.js` files in `/config/workspace/agentgui/` require manual server restart
-- **Future**: Implement full ES module reloading
-
-## 📊 Current Architecture
-
-```
-User → Browser (9897)
-  ↓
-Server.js (Node.js)
-  ├→ ACP Pool (connects to claude-code-acp)
-  │  └→ OAuth via local credentials
-  ├→ HTMLWrapper (wraps responses in HTML)
-  ├→ ResponseFormatter (segments & metadata)
-  └→ Database (SQLite)
-```
-
-## 🎯 Current Limitations
-
-1. **System Prompt Not Fully Enforced**
-   - Claude Code's system prompt about HTML responses works partially
-   - Plain text responses are now auto-wrapped by HTMLWrapper
-   - Result: All responses display as HTML regardless of original format
-
-2. **Hot Module Reloading**
-   - Static files (CSS, HTML) reload automatically
-   - JavaScript/Node modules need manual restart
-   - Recommendation: Changes to server logic need restart
-
-3. **ACP Skill Injection**
-   - `session/skill_inject` not supported by current ACP version
-   - Falls back gracefully without error
-   - System prompt still injected via context
-
-## 📋 Next Steps
-
-### For Full HTML Response Enforcement
-1. ✅ Already Done: HTMLWrapper auto-converts plain text to HTML
-2. No further action needed - all responses now display as beautifully formatted HTML
-
-### For True Hot Module Reloading
-1. Implement dynamic `import()` for module reloading
-2. Add module-level cache busting
-3. Handle state preservation during reload
-
-### For Enhanced Display
-1. Add streaming responses (real-time message display)
-2. Add more sophisticated metadata visualization
-3. Add export/sharing functionality
-
-## 🧪 Testing
-
-### Test a Message
-```bash
-CONV=$(curl -s -X POST http://localhost:9897/gm/api/conversations \
-  -H "Content-Type: application/json" \
-  -d '{"agentId": "claude-code", "title": "Test"}' | python3 -c "import sys,json; print(json.load(sys.stdin)['conversation']['id'])")
-
-curl -s -X POST "http://localhost:9897/gm/api/conversations/$CONV/messages" \
-  -H "Content-Type: application/json" \
-  -d '{"agentId": "claude-code", "content": "Your question here", "idempotencyKey": "test-1"}'
-
-# Check response after ~30-50 seconds
-curl -s "http://localhost:9897/gm/api/conversations/$CONV/messages" | python3 -m json.tool
-```
-
-## 📝 Files Structure
-
-```
-agentgui/
-├── server.js                 # Main HTTP server + WebSocket
-├── acp-launcher.js          # ACP connection management + system prompt
-├── database.js              # SQLite persistence
-├── response-formatter.js    # Response parsing & segmentation
-├── html-wrapper.js          # Markdown to HTML conversion
-├── hot-reload-manager.js    # Hot reload infrastructure (prepared)
-├── static/
-│   ├── app.js              # Frontend logic
-│   ├── index.html          # UI template
-│   ├── styles.css          # Comprehensive styling
-│   └── theme.js            # Theme management
-└── package.json            # Dependencies
-```
-
-## 🚀 Running the Server
-
-```bash
-# Development (port 3000)
-npm start
-
-# Production (port 9897)
-PORT=9897 npm start
-
-# With hot reload enabled (default)
-PORT=9897 HOT_RELOAD=true npm start
-
-# To disable hot reload
-PORT=9897 HOT_RELOAD=false npm start
-```
-
-## 💡 Key Implementation Details
-
-### HTML Wrapping Flow
-```
-Claude's plain text response
-  ↓
-HTMLWrapper.wrapResponse()
-  ↓
-Parse markdown syntax
-  ↓
-Convert to HTML with Tailwind classes
-  ↓
-Wrap in container div
-  ↓
-Store as messageContent.text
-  ↓
-Frontend detects HTML (starts with <div)
-  ↓
-Renders with sanitization
-```
-
-### Response Structure
-```json
-{
-  "id": "msg-xxx",
-  "role": "assistant",
-  "content": {
-    "text": "<div class=\"space-y-4 p-6\">...HTML...</div>",
-    "segments": [...],
-    "metadata": {...},
-    "updateChunks": [...],
-    "blocks": [],
-    "isHTML": true
-  }
-}
-```
-
-## ✨ Results
-
-- All responses now display as beautiful, styled HTML
-- Code blocks are properly syntax-highlighted
-- Metadata (tools, thinking, tasks) are rich and interactive
-- System runs on port 9897 for production
-- OAuth authentication works seamlessly
-- Database persists conversations and history
-
----
-
-**Last Updated**: February 3, 2026
-**Version**: 1.0.16+
-**Status**: Production Ready (with auto-HTML wrapping)

package/README.md

@@ -1,213 +0,0 @@
-# GMGUI - Multi-Agent ACP Client
-
-A buildless, hot-reloading web client for managing multiple Claude Agent Protocol (ACP) agents with real-time communication via WebSocket and MessagePack.
-
-**Status**: ✅ Production Ready | **Version**: 1.0.0 | **License**: MIT
-
-## Get Started Now - One Command
-
-```bash
-bunx agentgui
-```
-
-That's it. One command starts the server and opens http://localhost:3000/gm/ in your browser.
-
-**Works anywhere:** Any system with Bun installed.
-
-**Stop anytime:** Press Ctrl+C - clean shutdown.
-
-## Features
-
-- **Multi-Agent Management**: Connect unlimited ACP agents and switch between them instantly
-- **Real-Time Communication**: WebSocket + MessagePack for efficient bidirectional messaging
-- **Desktop Screenshots**: Capture and share desktop screenshots with agents (via scrot)
-- **File Upload/Download**: Upload files for agents to access, download files from conversations
-- **Modern Responsive UI**: Beautiful interface that works on mobile, tablet, and desktop
-- **Conversation History**: Full message history with timestamps
-- **Zero Build Step**: Pure HTML/CSS/JavaScript - no bundling or transpilation
-- **Minimal Dependencies**: Only 1 production dependency (ws)
-
-## How It Works
-
-**Chat Interface**
-- Real-time message display with timestamps
-- Send/receive messages with agents
-- Clear chat history
-
-**File Management**
-- Upload files for agents to access
-- Download files from conversations
-- Files stored automatically
-
-**Desktop Sharing**
-- Capture desktop screenshots
-- Share directly with agents
-
-**Agent Management**
-- Add agents by ID and endpoint
-- View connection status
-- Switch between agents
-
-**Responsive Design**
-- Works on desktop, tablet, and mobile
-- Touch-friendly interface
-- Optimized for all screen sizes
-
-## API Endpoints
-
-### Get Agents
-```
-GET /api/agents
-```
-Response: `{"agents": [...]}`
-
-### Send Message to Agent
-```
-POST /api/agents/{agentId}
-Content-Type: application/json
-
-{"type": "message", "content": "..."}
-```
-
-### Upload Files
-```
-POST /api/upload
-Content-Type: multipart/form-data
-
-file=@path/to/file.txt
-```
-
-### Capture Screenshot
-```
-POST /api/screenshot
-```
-
-### Download File
-```
-GET /uploads/{filename}
-```
-
-## Configuration
-
-### Environment Variables
-- `PORT` (default: 3000) - Server port
-- `UPLOAD_DIR` (default: /tmp/gmgui-conversations) - File storage location
-
-### Data Storage
-
-**Conversation History**: Stored in `~/.gmgui/data.db` (hidden folder in your home directory)
-- Uses SQLite database for persistent storage
-- Auto-created on first run with proper permissions
-- Contains conversations, messages, sessions, and event history
-- Data persists across runs and restarts
-- Private to current user (mode 0644)
-
-**Browser Local Storage**
-- `gmgui-settings` - User preferences and configuration
-
-**Why Hidden Folder?**
-Using `~/.gmgui/` follows Unix conventions:
-- Hidden folders (starting with `.`) keep user directories clean
-- Prevents accidental deletion or modification
-- Private by convention - not visible in casual `ls` output
-- Standard practice for application data (`.config`, `.local`, `.cache`)
-
-## Architecture
-
-### Server (Node.js)
-- HTTP server with static file serving
-- WebSocket server for agent connections
-- File upload/download endpoints
-- Screenshot capture endpoint
-- Agent management
-
-### Client (Browser)
-- Real-time message display
-- File management UI
-- Screenshot capture and preview
-- Agent connection management
-- Settings persistence
-
-### File Structure
-```
-gmgui/
-├── server.js                    # HTTP + WebSocket server
-├── database.js                  # SQLite persistence
-├── acp-launcher.js              # Agent management
-├── bin/gmgui.cjs                # npm entry point
-├── static/
-│   ├── index.html              # Main UI
-│   ├── app.js                  # Frontend logic
-│   ├── styles.css              # Responsive styles
-│   ├── theme.js                # Theme management
-│   └── rippleui.css            # CSS framework
-├── install.sh                   # One-liner installer
-├── package.json                 # Dependencies
-└── README.md                    # This file
-```
-
-## Development
-
-### Enable Hot Reload (during development)
-```bash
-npm run dev
-```
-Changes to `static/` files auto-refresh the browser.
-
-## Browser Support
-
-Works on all modern browsers:
-- Chrome/Edge 63+
-- Firefox 55+
-- Safari 11+
-- Mobile browsers (iOS Safari, Chrome Mobile, etc.)
-
-## Performance
-
-- **Fast Startup**: ~100ms with Bun
-- **No Build Step**: Source code runs directly
-- **Efficient Messaging**: MessagePack reduces payload size by 50%
-- **Real-time Updates**: <50ms WebSocket latency
-- **Memory Efficient**: ~20MB typical usage
-
-## Troubleshooting
-
-**Port Already in Use**
-```bash
-PORT=3001 bunx gmgui
-```
-
-**Agent Won't Connect**
-- Verify agent endpoint is accessible
-- Check browser console for errors
-- Ensure agent is sending valid ACP messages
-
-**Files Not Uploading**
-- Check browser console for errors
-- Verify sufficient disk space available
-
-## Security
-
-- Path traversal protection on file uploads
-- WebSocket message validation
-- File upload restrictions
-- No sensitive data in logs
-
-## License
-
-MIT - Free to use, modify, and distribute
-
-## Need Help?
-
-Open an issue on GitHub: https://github.com/AnEntrypoint/gmgui/issues
-
----
-
-**Ready to manage multiple ACP agents?** Run this now:
-
-```bash
-curl -fsSL https://raw.githubusercontent.com/AnEntrypoint/gmgui/main/install.sh | bash
-```
-
-Then open http://localhost:3000/gm/ in your browser
-# Triggered npm publishing

package/RECENT_UPDATES.md

@@ -1,209 +0,0 @@
-# AgentGUI Recent Updates
-
-## Overview
-AgentGUI has been significantly enhanced to use local Claude Code OAuth authentication and provide rich, metadata-aware response rendering.
-
-## Key Changes
-
-### 1. OAuth Authentication via Local Claude Code
-**File**: `acp-launcher.js`, `server.js`
-
-- **Binary Discovery**: Automatically finds `claude-code-acp` in common installation locations
-  - `/config/.gmweb/npm-global/bin/claude-code-acp`
-  - `~/.local/bin/claude-code-acp`
-  - Falls back to PATH if configured
-
-- **PATH Management**: Enhanced environment variable handling to ensure npm global binaries are discoverable
-
-- **Timeout Optimization**:
-  - Initialize: 4s → 10s
-  - Session creation: 4s → 30s
-  - Mode setting: 2s → 10s
-  - Handshake deadline: 5s → 60s
-
-**Benefits**: 
-- Uses existing Claude Code authentication
-- No additional API key setup needed
-- Seamless integration with system auth
-
-### 2. Response Segmentation & Metadata Extraction
-**Files**: `response-formatter.js`, `server.js`, `static/app.js`
-
-#### ResponseFormatter
-- Intelligent parsing of Claude responses into semantic units:
-  - Code blocks (with language detection)
-  - Headings (h1-h6)
-  - Text paragraphs
-  - Blockquotes
-  - Lists
-
-- Metadata extraction:
-  - Tool calls and function names
-  - Thinking/reasoning blocks
-  - Task references
-  - Subagent usage
-
-- Proper formatting with inline code highlighting
-
-#### Frontend Rendering
-- `renderSegment()`: Beautiful display of each segment type
-- `renderMetadata()`: Rich metadata sidebar with:
-  - Tools used (with code highlighting)
-  - Thinking blocks (collapsible details element)
-  - Subagents employed
-  - Tasks referenced
-
-### 3. Rich HTML/RippleUI Responses
-**Files**: `acp-launcher.js`, `static/app.js`
-
-#### System Prompt Enhancement
-Comprehensive instruction set forcing Claude to respond with HTML:
-- RippleUI components (cards, alerts, tables, badges)
-- Tailwind CSS styling
-- Semantic HTML structure
-- Code block formatting with language hints
-- Never raw text - always wrapped HTML
-
-#### HTML Detection Improvement
-- Detects HTML by tags, structure, AND Tailwind classes
-- Lower tag count threshold for detection (2 vs 3)
-- Better recognition of styled components
-
-### 4. Professional CSS Styling
-**File**: `static/styles.css`
-
-Added comprehensive styling for:
-- Code blocks with language-specific colors
-- Inline code with syntax highlighting
-- Markdown formatting (bold, italic, code)
-- Collapsible thinking blocks
-- Metadata sections with visual hierarchy
-- Print-friendly styles
-- Dark mode support
-
-### 5. Hot Reload Infrastructure
-**File**: `hot-reload-manager.js`
-
-Prepared for hot reloading:
-- File watching with debouncing
-- WebSocket-based reload signaling
-- Graceful client-side reloading
-- Ready for future implementation
-
-## System Architecture
-
-### Ports
-- Production: **9897** (via system startup)
-- Development: **3000** (via `npm start`)
-
-### Request Flow
-```
-User Message
-    ↓
-API endpoint (/api/conversations/:id/messages)
-    ↓
-Server (processMessage)
-    ↓
-getACP() - Gets or creates connection
-    ↓
-conn.sendPrompt() - Sends to Claude Code via ACP bridge
-    ↓
-ResponseFormatter.segmentResponse()
-    ↓
-Database storage with segments + metadata
-    ↓
-Frontend display with rich rendering
-```
-
-### Connection Management
-- ACP Pool: Maintains persistent connections per agent
-- OAuth via local Claude Code credentials
-- Graceful error handling and fallback
-- Automatic reconnection
-
-## Display Examples
-
-### Segmented Response
-Plain text becomes:
-```
-[Heading] Problem Analysis
-[Text] Explanation paragraph
-[Code] javascript function example
-[Metadata] Tools used, reasoning blocks
-```
-
-### Metadata Display
-- **Tools Used**: List of functions/tools called
-- **Reasoning**: Collapsible thinking process
-- **Subagents**: External agents employed  
-- **Tasks**: Itemized task list
-
-## Configuration
-
-### Environment Variables
-```bash
-PORT=9897              # Server port (default: 3000)
-BASE_URL=/gm          # Route prefix (default: /gm)
-HOT_RELOAD=false      # Disable hot reload (default: true)
-```
-
-### Database
-- Location: `~/.gmgui/data.db`
-- Persists conversations, messages, sessions
-- Auto-created on first run
-
-## Testing
-
-### Quick Start
-```bash
-npm start              # Start on port 3000
-PORT=9897 npm start   # Start on port 9897
-```
-
-### Test Endpoints
-```bash
-# Get agents
-curl http://localhost:3000/gm/api/agents
-
-# Create conversation
-curl -X POST http://localhost:3000/gm/api/conversations \
-  -H "Content-Type: application/json" \
-  -d '{"agentId": "claude-code", "title": "Test"}'
-
-# Send message
-curl -X POST http://localhost:3000/gm/api/conversations/{id}/messages \
-  -H "Content-Type: application/json" \
-  -d '{"agentId": "claude-code", "content": "Hello"}'
-
-# Get messages
-curl http://localhost:3000/gm/api/conversations/{id}/messages
-```
-
-## Future Enhancements
-
-1. **Full Hot Reloading**: Complete implementation of HotReloadManager
-2. **Streaming Responses**: Real-time message streaming to client
-3. **Task Tracking**: Enhanced task and subagent visualization
-4. **Export Functions**: Share/export conversations as HTML/PDF
-5. **Theme Customization**: Allow user-defined themes
-
-## Files Modified
-
-- `acp-launcher.js` - OAuth and timeout fixes, system prompt
-- `server.js` - Response segmentation, metadata extraction
-- `static/app.js` - Rich rendering, HTML detection
-- `static/styles.css` - Professional styling for all components
-- `response-formatter.js` - NEW: Response parsing and formatting
-- `hot-reload-manager.js` - NEW: Hot reload infrastructure
-
-## Git Commits
-
-1. **Fix OAuth Connection** - Binary discovery and PATH management
-2. **Increase ACP Timeouts** - Proper timeout values for connection establishment
-3. **Rich Response Formatting** - Segmentation and metadata rendering
-4. **Enforce HTML Responses** - System prompt and detection improvements
-
----
-
-**Last Updated**: February 3, 2026
-**Version**: 1.0.15