claudedesk 4.5.0 → 4.6.0

package/CHANGELOG.md

@@ -13,6 +13,35 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ---
 
+## [4.6.0] - 2026-02-19
+
+### Added
+- **LaunchTunnel integration** — Expose local ports to the internet via LaunchTunnel (14th domain)
+  - `TunnelManager` with hybrid REST API + CLI (`lt preview`) process management
+  - API key management with validation, stored in `~/.claudedesk/tunnel-settings.json`
+  - Tunnel list with 30s cache, status mapping (API snake_case → camelCase)
+  - Account info section (email, plan badge, status)
+  - Request log viewer with method/path/status/duration/size columns
+  - TunnelPanel (4 views: setup/main/settings/logs), TunnelCreateDialog, TunnelRequestLogs
+  - CLI auto-detection via `where`/`which`, `shell: true` for cross-platform spawn
+  - Ctrl+Shift+U keyboard shortcut, ToolsDropdown entry with active count badge
+  - 17 IPC methods (`tunnel:*`): 13 invoke + 4 events
+
+### Fixed
+- **Tunnel spawn ENOENT** — Use `shell: true` in spawn for cross-platform `.cmd` shim compatibility
+- **Tunnel status mapping** — API returns `"active"` not `"connected"`; added to `mapApiStatus`
+- **Tunnel CLI subcommand** — Fixed `lt preview --port` (was missing `preview` subcommand)
+- **Tunnel URL parsing** — Match `URL:` output format from LaunchTunnel CLI (not `your url is:`)
+- **API snake_case mapping** — Map `created_at`, `status_code`, `duration_ms` etc. to camelCase
+- **Account response unwrapping** — API returns `{"user": {...}}` wrapper; now unwrapped correctly
+- **Request logs endpoint** — Reverted from `/requests` back to correct `/logs` path
+
+### Changed
+- **IPC contract** — Expanded from 149 to ~166 methods (added 17 tunnel methods)
+- **Project scale** — ~150 source files, ~49,000 LOC, 14 domains, 14 managers
+
+---
+
 ## [4.5.0] - 2026-02-17
 
 ### Added
@@ -251,7 +280,8 @@ See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines on suggesting changes and
 
 ---
 
-[Unreleased]: https://github.com/carloluisito/claudedesk/compare/v4.5.0...HEAD
+[Unreleased]: https://github.com/carloluisito/claudedesk/compare/v4.6.0...HEAD
+[4.6.0]: https://github.com/carloluisito/claudedesk/compare/v4.5.0...v4.6.0
 [4.5.0]: https://github.com/carloluisito/claudedesk/compare/v4.4.1...v4.5.0
 [4.4.1]: https://github.com/carloluisito/claudedesk/compare/v4.3.1...v4.4.1
 [4.3.1]: https://github.com/carloluisito/claudedesk/compare/v4.3.0...v4.3.1

package/CLAUDE.md

@@ -2,6 +2,10 @@
 
 Electron desktop app wrapping Claude Code CLI with multi-session terminals, split views, and agent team visualization.
 
+## Workflow Rule
+
+**Always run the `requirements-clarifier` agent (via the Task tool) on the user's initial prompt before planning or implementing.** This ensures requirements are analyzed, ambiguities are surfaced, and acceptance criteria are established before any work begins. Skip only for trivial tasks (typo fixes, single-line changes, or purely informational questions).
+
 ## Tech Stack
 
 Electron 28 | React 18 | TypeScript | xterm.js | node-pty | Tailwind CSS | reactflow
@@ -11,9 +15,9 @@ Electron 28 | React 18 | TypeScript | xterm.js | node-pty | Tailwind CSS | react
 ```
 ┌─────────────────────────────────────────────┐
 │  Main Process (Node.js)                     │
-│  13 managers + IPC handlers + session pool  │
+│  14 managers + IPC handlers + session pool  │
 └──────────────────┬──────────────────────────┘
-                   │ IPC (149 methods)
+                   │ IPC (~166 methods)
 ┌──────────────────┴──────────────────────────┐
 │  Preload (auto-derived context bridge)      │
 └──────────────────┬──────────────────────────┘
@@ -26,7 +30,7 @@ Electron 28 | React 18 | TypeScript | xterm.js | node-pty | Tailwind CSS | react
 
 **3-layer pattern per domain:** Manager (main) → Hook (renderer) → Components (renderer)
 
-**IPC contract** (`src/shared/ipc-contract.ts`) is the single source of truth — 149 methods. The preload bridge and `ElectronAPI` type are auto-derived from it.
+**IPC contract** (`src/shared/ipc-contract.ts`) is the single source of truth — ~166 methods. The preload bridge and `ElectronAPI` type are auto-derived from it.
 
 ## Domain Map
 
@@ -44,6 +48,7 @@ Electron 28 | React 18 | TypeScript | xterm.js | node-pty | Tailwind CSS | react
 | Atlas | atlas-manager | useAtlas, AtlasPanel | types/atlas-types.ts | `atlas:*` |
 | Git | git-manager | useGit, useDiffViewer, GitPanel, DiffViewer, DiffFileNav, DiffViewerHeader, DiffContentArea, CommitDialog, WorktreePanel, WorktreeCleanupDialog, diff-parser | types/git-types.ts | `git:*` |
 | Playbooks | playbook-manager, playbook-executor, built-in-playbooks | usePlaybooks, PlaybookPicker, PlaybookParameterDialog, PlaybookProgressPanel, PlaybookPanel, PlaybookEditor | types/playbook-types.ts | `playbook:*` |
+| Tunnels | tunnel-manager | useTunnel, TunnelPanel, TunnelCreateDialog, TunnelRequestLogs | types/tunnel-types.ts | `tunnel:*` |
 | Window | index.ts | ConfirmDialog, SettingsDialog, AboutDialog, TitleBarBranding | ipc-types.ts | `window:*`, `dialog:*` |
 
 ## Adding a New IPC Method

package/dist/main/index.js

@@ -51,6 +51,7 @@ const model_history_manager_1 = require("./model-history-manager");
 const git_manager_1 = require("./git-manager");
 const playbook_manager_1 = require("./playbook-manager");
 const playbook_executor_1 = require("./playbook-executor");
+const tunnel_manager_1 = require("./tunnel-manager");
 const ipc_handlers_1 = require("./ipc-handlers");
 // Prevent EPIPE crashes when stdout/stderr pipe breaks (e.g., renderer window closes while PTY is active)
 process.stdout?.on?.('error', (err) => { if (err.code !== 'EPIPE')
@@ -75,6 +76,7 @@ let modelHistoryManager = null;
 let gitManager = null;
 let playbookManager = null;
 let playbookExecutor = null;
+let tunnelManager = null;
 const CONFIG_DIR = path.join(electron_1.app.getPath('home'), '.claudedesk');
 const WINDOW_STATE_FILE = path.join(CONFIG_DIR, 'window-state.json');
 function ensureConfigDir() {
@@ -187,6 +189,9 @@ function createWindow() {
     // Initialize playbook manager + executor
     playbookManager = new playbook_manager_1.PlaybookManager();
     playbookExecutor = new playbook_executor_1.PlaybookExecutor(sessionManager, checkpointManager, playbookManager);
+    // Initialize tunnel manager
+    tunnelManager = new tunnel_manager_1.TunnelManager();
+    tunnelManager.setMainWindow(mainWindow);
     // Initialize command registry
     commandRegistry = new command_registry_1.CommandRegistry();
     // Initialize agent team manager
@@ -198,7 +203,7 @@ function createWindow() {
         agentTeamManager?.onSessionClosed(sessionId);
     });
     // Setup IPC handlers with pool reference
-    (0, ipc_handlers_1.setupIPCHandlers)(mainWindow, sessionManager, settingsManager, templatesManager, historyManager, checkpointManager, sessionPool, agentTeamManager, atlasManager, layoutPresetsManager, commandRegistry, modelHistoryManager, gitManager, playbookManager, playbookExecutor);
+    (0, ipc_handlers_1.setupIPCHandlers)(mainWindow, sessionManager, settingsManager, templatesManager, historyManager, checkpointManager, sessionPool, agentTeamManager, atlasManager, layoutPresetsManager, commandRegistry, modelHistoryManager, gitManager, playbookManager, playbookExecutor, tunnelManager);
     // Initialize pool (delayed, async)
     setTimeout(() => {
         if (sessionPool) {
@@ -243,6 +248,10 @@ function createWindow() {
     });
     mainWindow.on('closed', () => {
         (0, ipc_handlers_1.removeIPCHandlers)();
+        if (tunnelManager) {
+            tunnelManager.destroy();
+            tunnelManager = null;
+        }
         if (modelHistoryManager) {
             modelHistoryManager.shutdown();
             modelHistoryManager = null;

package/dist/main/ipc-handlers.js

@@ -43,7 +43,7 @@ const file_dragdrop_handler_1 = require("./file-dragdrop-handler");
 const ipc_emitter_1 = require("./ipc-emitter");
 const ipc_registry_1 = require("./ipc-registry");
 let registry = null;
-function setupIPCHandlers(mainWindow, sessionManager, settingsManager, templatesManager, historyManager, checkpointManager, sessionPool, agentTeamManager, atlasManager, layoutPresetsManager, commandRegistry, modelHistoryManager, gitManager, playbookManager, playbookExecutor) {
+function setupIPCHandlers(mainWindow, sessionManager, settingsManager, templatesManager, historyManager, checkpointManager, sessionPool, agentTeamManager, atlasManager, layoutPresetsManager, commandRegistry, modelHistoryManager, gitManager, playbookManager, playbookExecutor, tunnelManager) {
     // Connect managers to window
     sessionManager.setMainWindow(mainWindow);
     checkpointManager.setMainWindow(mainWindow);
@@ -1028,6 +1028,112 @@ function setupIPCHandlers(mainWindow, sessionManager, settingsManager, templates
             claudeVersion,
         };
     });
+    // ── LaunchTunnel ──
+    registry.handle('tunnelList', async () => {
+        try {
+            return await tunnelManager.list();
+        }
+        catch (err) {
+            console.error('Failed to list tunnels:', err);
+            throw err;
+        }
+    });
+    registry.handle('tunnelCreate', async (_e, request) => {
+        try {
+            return await tunnelManager.create(request);
+        }
+        catch (err) {
+            console.error('Failed to create tunnel:', err);
+            throw err;
+        }
+    });
+    registry.handle('tunnelStop', async (_e, tunnelId) => {
+        try {
+            return await tunnelManager.stop(tunnelId);
+        }
+        catch (err) {
+            console.error('Failed to stop tunnel:', err);
+            throw err;
+        }
+    });
+    registry.handle('tunnelGetInfo', async (_e, tunnelId) => {
+        try {
+            return await tunnelManager.getInfo(tunnelId);
+        }
+        catch (err) {
+            console.error('Failed to get tunnel info:', err);
+            throw err;
+        }
+    });
+    registry.handle('tunnelGetLogs', async (_e, tunnelId, limit) => {
+        try {
+            return await tunnelManager.getLogs(tunnelId, limit);
+        }
+        catch (err) {
+            console.error('Failed to get tunnel logs:', err);
+            throw err;
+        }
+    });
+    registry.handle('tunnelGetSettings', async () => {
+        return tunnelManager.getSettings();
+    });
+    registry.handle('tunnelUpdateSettings', async (_e, settings) => {
+        try {
+            return tunnelManager.updateSettings(settings);
+        }
+        catch (err) {
+            console.error('Failed to update tunnel settings:', err);
+            throw err;
+        }
+    });
+    registry.handle('tunnelGetAccount', async () => {
+        try {
+            return await tunnelManager.getAccount();
+        }
+        catch (err) {
+            console.error('Failed to get tunnel account:', err);
+            throw err;
+        }
+    });
+    registry.handle('tunnelGetUsage', async (_e, tunnelId) => {
+        try {
+            return await tunnelManager.getUsage(tunnelId);
+        }
+        catch (err) {
+            console.error('Failed to get tunnel usage:', err);
+            throw err;
+        }
+    });
+    registry.handle('tunnelRefresh', async () => {
+        try {
+            return await tunnelManager.refresh();
+        }
+        catch (err) {
+            console.error('Failed to refresh tunnels:', err);
+            throw err;
+        }
+    });
+    registry.handle('tunnelDetectBinary', async () => {
+        return tunnelManager.detectBinary();
+    });
+    registry.handle('tunnelValidateKey', async (_e, apiKey) => {
+        try {
+            return await tunnelManager.validateKey(apiKey);
+        }
+        catch (err) {
+            console.error('Failed to validate tunnel API key:', err);
+            throw err;
+        }
+    });
+    registry.handle('tunnelStopAll', async () => {
+        try {
+            return await tunnelManager.stopAll();
+        }
+        catch (err) {
+            console.error('Failed to stop all tunnels:', err);
+            throw err;
+        }
+    });
     // ── Session I/O (send — fire and forget) ──
     registry.on('sendSessionInput', (_e, input) => {
         sessionManager.sendInput(input.sessionId, input.data);

package/dist/main/quota-service.js

@@ -275,12 +275,14 @@ function buildBurnRateResult(rate5h, rate7d, current, history) {
         else if (recentRate < olderRate - 0.5)
             trend = 'decreasing';
     }
-    // Label based on projected time to limit
+    // Label based on projected time to limit (worst of both quotas)
     let label = 'on-track';
-    if (projectedMinutes5h !== null) {
-        if (projectedMinutes5h < 60)
+    const projections = [projectedMinutes5h, projectedMinutes7d].filter((v) => v !== null);
+    if (projections.length > 0) {
+        const minProjected = Math.min(...projections);
+        if (minProjected < 60)
             label = 'critical';
-        else if (projectedMinutes5h < 120)
+        else if (minProjected < 120)
             label = 'elevated';
     }
     return {