tabminal 1.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Tabminal Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,95 @@
+# Tabminal
+
+> **A modern, AI-native web terminal built for the cloud age.**
+> Seamlessly accessible from Desktop, iPad, and iPhone with a native-like experience.
+
+![Tabminal Banner](public/favicon.svg) 
+
+## ✨ Key Features
+
+### 🧠 AI-Native Integration
+Tabminal isn't just a terminal; it's an intelligent workspace paired with **Gemini 2.5 Flash**.
+*   **Context-Aware**: The AI knows your **Current Working Directory**, **Environment Variables**, and **Recent Command History**. No need to copy-paste context.
+*   **Command Hijack (`#`)**: Simply type `#` followed by your question (e.g., `# how to tar a folder`) to chat with the AI. The output streams in real-time with syntax highlighting.
+*   **Auto-Fix**: If a shell command fails (non-zero exit code), Tabminal automatically analyzes the error log and suggests a fix.
+*   **Audit Logging**: All AI interactions are logged and persisted for future context.
+
+### 📱 Ultimate Mobile Experience
+Optimized specifically for **iPadOS** and **iOS**, solving the pain points of coding on touch devices.
+*   **PWA Support**: Installable as a full-screen app. Solves the infamous iOS viewport height issues.
+*   **HHKB-Style Soft Keyboard**: A custom 12-column virtual keyboard bringing the HHKB layout to iPhone.
+    *   **Drag-to-Ctrl**: Touch and drag the `CTRL` key to perform combinations (e.g., drag to 'C' for `Ctrl+C`).
+    *   **Smart Modifiers**: `SHIFT` allows continuous entry; `SYM` toggles the full keyboard overlay.
+    *   **Responsive Layout**: Keyboard height adapts to landscape/portrait modes automatically.
+*   **Optimized UI**: Hamburger menu for sessions on small screens, resource-saving mode (no preview rendering) on iPhone.
+
+### 💻 Powerful Desktop Features
+*   **Persistent Sessions**: Close your browser, come back later, and your terminal state (and running processes) are exactly where you left them.
+*   **Built-in Editor**: Integrated **Monaco Editor** (VS Code core) with split-pane view. Edit files on the server directly.
+*   **Visual File Manager**: Sidebar file tree for easy navigation and opening of files.
+*   **Network Heartbeat**: Real-time latency visualization (capsule style on desktop, bottom-fill on mobile).
+
+## 🚀 Getting Started
+
+### Prerequisites
+*   Node.js >= 16
+*   An AI API Key (e.g., Google AI Studio / OpenRouter)
+
+### Quick Start (No Install)
+Run directly with npx:
+```bash
+npx tabminal --openrouter-key "YOUR_API_KEY" --accept-terms
+```
+
+### Installation
+
+```bash
+# Clone the repository
+git clone https://github.com/yourusername/tabminal.git
+cd tabminal
+
+# Install dependencies
+npm install
+
+# Start the server
+npm start -- --openrouter-key "YOUR_API_KEY" --accept-terms
+```
+
+### Configuration
+
+You can configure Tabminal via command-line arguments or environment variables.
+
+| Argument | Env Variable | Description | Default |
+| :--- | :--- | :--- | :--- |
+| `-p`, `--port` | `PORT` | Server port | `9846` |
+| `-h`, `--host` | `HOST` | Bind address | `127.0.0.1` |
+| `-a`, `--password` | `TABMINAL_PASSWORD` | Access password | (Randomly Generated) |
+| `-k`, `--openrouter-key` | `TABMINAL_OPENROUTER_KEY` | OpenRouter API Key | `null` |
+| `-m`, `--model` | `TABMINAL_MODEL` | AI Model ID | `gemini-2.5-flash-preview-09-2025` |
+| `-g`, `--google-key` | `TABMINAL_GOOGLE_KEY` | Google Search API Key | `null` |
+| `-c`, `--google-cx` | `TABMINAL_GOOGLE_CX` | Google Search Engine ID (CX) | `null` |
+| `-d`, `--debug` | `TABMINAL_DEBUG` | Enable debug logs | `false` |
+| `-y`, `--accept-terms` | `TABMINAL_ACCEPT` | Accept security terms | `false` |
+
+## ⌨️ Shortcuts
+
+### Physical Keyboard (Desktop/iPad)
+*   **`Ctrl + Shift + T`**: New Tab (Inherits current CWD)
+*   **`Ctrl + Shift + W`**: Close Current Tab
+*   **`Ctrl + Shift + [` / `]`**: Switch Previous/Next Tab
+*   **`Ctrl + Alt + [` / `]`**: Switch Previous/Next Open File in Editor
+*   **`Ctrl + Shift + E`**: Toggle Editor Pane
+*   **`Ctrl + Shift + ?`**: Show Shortcuts Help
+
+### Touch Gestures (Mobile)
+*   **Virtual `^C`**: Send SIGINT (Ctrl+C).
+*   **Virtual `CTRL` (Hold & Drag)**: Visualize a QWERTY overlay to quickly trigger Control combinations without lifting your finger.
+*   **Virtual `SYM`**: Toggle the full HHKB-style soft keyboard.
+
+## 🛠 Tech Stack
+*   **Backend**: Node.js, Koa, node-pty, WebSocket (ws).
+*   **Frontend**: Vanilla JS (ES Modules), xterm.js, Monaco Editor.
+*   **AI**: Integration via `utilitas`.
+
+## 📄 License
+MIT

package/build.mjs

@@ -0,0 +1,156 @@
+import fsPromises from 'node:fs/promises';
+import fs from 'node:fs';
+import path from 'node:path';
+import https from 'node:https';
+import { fileURLToPath } from 'node:url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const PUBLIC_ICONS_DIR = path.join(__dirname, 'public', 'icons');
+
+// Fallback to PKief's repo which is often stable for raw access, or use material-extensions
+const BASE_URL = 'https://raw.githubusercontent.com/PKief/vscode-material-icon-theme/main/icons';
+
+// Ensure icons directory exists
+await fsPromises.mkdir(PUBLIC_ICONS_DIR, { recursive: true });
+
+const downloadFile = (url, dest) => {
+    return new Promise((resolve, reject) => {
+        const stream = fs.createWriteStream(dest);
+        https.get(url, (res) => {
+            if (res.statusCode !== 200) {
+                stream.close();
+                fsPromises.unlink(dest).catch(() => {});
+                console.warn(`Failed to download: ${url} (${res.statusCode})`);
+                resolve(false); 
+                return;
+            }
+            res.pipe(stream);
+            stream.on('finish', () => {
+                stream.close();
+                resolve(true);
+            });
+        }).on('error', (err) => {
+            fsPromises.unlink(dest).catch(() => {});
+            reject(err);
+        });
+    });
+};
+
+async function main() {
+    console.log('🏗️  Starting build process (Fallback Mode)...');
+    
+    // Hardcoded map for stability
+    const fileMap = {
+        extensions: {
+            'html': 'html',
+            'htm': 'html',
+            'css': 'css',
+            'js': 'javascript',
+            'mjs': 'javascript',
+            'cjs': 'javascript',
+            'ts': 'typescript',
+            'tsx': 'react_ts',
+            'jsx': 'react',
+            'json': 'json',
+            'md': 'markdown',
+            'py': 'python',
+            'rb': 'ruby',
+            'go': 'go',
+            'rs': 'rust',
+            'php': 'php',
+            'java': 'java',
+            'c': 'c',
+            'cpp': 'cpp',
+            'h': 'cpp',
+            'png': 'image',
+            'jpg': 'image',
+            'jpeg': 'image',
+            'gif': 'image',
+            'svg': 'svg',
+            'xml': 'xml',
+            'yaml': 'yaml',
+            'yml': 'yaml',
+            'sh': 'console',
+            'bash': 'console',
+            'zsh': 'console',
+            'txt': 'document',
+            'lock': 'lock'
+        },
+        filenames: {
+            'package.json': 'nodejs',
+            'package-lock.json': 'nodejs',
+            'tsconfig.json': 'tsconfig',
+            '.gitignore': 'git',
+            '.gitattributes': 'git',
+            '.env': 'tune',
+            'readme.md': 'readme',
+            'license': 'certificate',
+            'dockerfile': 'docker',
+            'docker-compose.yml': 'docker'
+        },
+        default: 'document',
+        folder: 'folder-src',
+        folderOpen: 'folder-src-open'
+    };
+
+    const iconsToDownload = new Set([
+        'folder-src', 'folder-src-open',
+        ...Object.values(fileMap.extensions),
+        ...Object.values(fileMap.filenames)
+    ]);
+
+    console.log(`🔍 Need ${iconsToDownload.size} icons.`);
+    console.log('⬇️  Downloading SVGs...');
+
+    const downloadQueue = Array.from(iconsToDownload);
+    const batchSize = 10;
+    
+    for (let i = 0; i < downloadQueue.length; i += batchSize) {
+        const batch = downloadQueue.slice(i, i + batchSize);
+        await Promise.all(batch.map(async (iconName) => {
+            const fileName = `${iconName}.svg`;
+            const dest = path.join(PUBLIC_ICONS_DIR, fileName);
+            
+            try {
+                await fsPromises.access(dest);
+                return;
+            } catch {}
+
+            const url = `${BASE_URL}/${fileName}`;
+            await downloadFile(url, dest);
+        }));
+        process.stdout.write(`\rProgress: ${Math.min(i + batchSize, downloadQueue.length)}/${downloadQueue.length}`);
+    }
+    console.log('\n✅ Icons downloaded.');
+
+    await fsPromises.writeFile(path.join(PUBLIC_ICONS_DIR, 'map.json'), JSON.stringify(fileMap, null, 2));
+    console.log('✅ Map generated at public/icons/map.json');
+
+    // Copy Fonts
+    console.log('⬇️  Copying Fonts...');
+    const fontsDir = path.join(__dirname, 'public', 'fonts');
+    const fontSourceDir = path.join(__dirname, 'node_modules', '@fontsource', 'monaspace-neon', 'files');
+    
+    await fsPromises.mkdir(fontsDir, { recursive: true });
+
+    const fontsToCopy = [
+        { src: 'monaspace-neon-latin-400-normal.woff2', dest: 'MonaspaceNeon-Regular.woff2' },
+        { src: 'monaspace-neon-latin-700-normal.woff2', dest: 'MonaspaceNeon-Bold.woff2' }
+    ];
+
+    for (const font of fontsToCopy) {
+        const srcPath = path.join(fontSourceDir, font.src);
+        const destPath = path.join(fontsDir, font.dest);
+        try {
+            await fsPromises.copyFile(srcPath, destPath);
+            console.log(`   Copied ${font.dest}`);
+        } catch (e) {
+            console.warn(`   Failed to copy ${font.dest}:`, e.message);
+            console.warn('   Make sure you have run "npm install" and @fontsource/monaspace-neon is installed.');
+        }
+    }
+    console.log('✅ Fonts copied.');
+}
+
+main().catch(console.error);

package/config.sample.json

@@ -0,0 +1,11 @@
+{
+  "host": "0.0.0.0",
+  "port": 9846,
+  "password": "YOUR_SECURE_PASSWORD",
+  "openrouter-key": "YOUR_OPENROUTER_API_KEY",
+  "model": "gemini-2.5-flash-preview-09-2025",
+  "google-key": "YOUR_GOOGLE_SEARCH_API_KEY",
+  "google-cx": "YOUR_GOOGLE_SEARCH_ENGINE_ID",
+  "accept-terms": true,
+  "debug": false
+}

package/icon-gen.html

@@ -0,0 +1,46 @@
+<!DOCTYPE html>
+<html>
+<head>
+    <title>Icon Generator</title>
+    <style>body { background: #eee; font-family: sans-serif; padding: 20px; }</style>
+</head>
+<body>
+    <h2>Tabminal Icon Generator</h2>
+    <p>1. Allow the page to load the SVG.</p>
+    <p>2. Click the link below to download the PNG.</p>
+    <p>3. Save it as <code>public/apple-touch-icon.png</code>.</p>
+    
+    <canvas id="c180" width="180" height="180" style="border:1px solid #ccc"></canvas>
+    <div id="links" style="margin-top: 20px;"></div>
+
+    <script>
+        const img = new Image();
+        img.onload = () => {
+            const canvas = document.getElementById('c180');
+            const ctx = canvas.getContext('2d');
+            
+            // Draw Background (Solarized Base03)
+            ctx.fillStyle = '#002b36';
+            ctx.fillRect(0, 0, 180, 180);
+            
+            // Draw SVG centered and scaled
+            // Assume SVG is square. Padding 20px.
+            ctx.drawImage(img, 20, 20, 140, 140);
+            
+            const link = document.createElement('a');
+            link.href = canvas.toDataURL('image/png');
+            link.download = 'apple-touch-icon.png';
+            link.style.display = 'inline-block';
+            link.style.padding = '10px 20px';
+            link.style.background = '#268bd2';
+            link.style.color = 'white';
+            link.style.textDecoration = 'none';
+            link.style.borderRadius = '5px';
+            link.innerText = 'Download apple-touch-icon.png';
+            
+            document.getElementById('links').appendChild(link);
+        };
+        img.src = 'favicon.svg';
+    </script>
+</body>
+</html>

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "tabminal",
+  "version": "1.1.0",
+  "description": "A modern, persistent web terminal with multi-tab support and real-time system monitoring.",
+  "type": "module",
+  "bin": {
+    "tabminal": "./src/server.mjs"
+  },
+  "main": "src/server.mjs",
+  "scripts": {
+    "start": "node src/server.mjs",
+    "dev": "node --watch src/server.mjs",
+    "build": "node build.mjs",
+    "test": "node --test",
+    "test:watch": "node --test --watch",
+    "lint": "eslint ."
+  },
+  "keywords": [
+    "terminal",
+    "web-terminal",
+    "xterm.js",
+    "node-pty",
+    "websocket",
+    "monitoring",
+    "dashboard",
+    "cli"
+  ],
+  "author": "Leask Wong",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@fontsource/monaspace-neon": "^5.2.5",
+    "@koa/router": "^14.0.0",
+    "js-tiktoken": "^1.0.21",
+    "koa": "^3.1.1",
+    "koa-bodyparser": "^4.4.1",
+    "koa-static": "^5.0.0",
+    "node-ansiparser": "^2.2.1",
+    "node-pty": "^1.0.0",
+    "openai": "^6.9.1",
+    "utilitas": "^2000.3.3",
+    "ws": "^8.18.3"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/leask/tabminal.git"
+  },
+  "bugs": {
+    "url": "https://github.com/leask/tabminal/issues"
+  },
+  "homepage": "https://github.com/leask/tabminal#readme"
+}