helixmind 0.1.2 → 0.2.1

package/README.md

@@ -1,207 +1,346 @@
-<div align="center">
-
-# 🧠 HelixMind
-
-**AI Coding Assistant with Persistent Spiral Memory**
-
-[![npm version](https://img.shields.io/npm/v/helixmind?color=blue&logo=npm)](https://www.npmjs.com/package/helixmind)
-[![License](https://img.shields.io/badge/License-AGPL_3.0-blue?logo=gnu)](LICENSE)
-[![Node](https://img.shields.io/badge/Node-18%2B-green?logo=node.js)](https://nodejs.org)
-[![TypeScript](https://img.shields.io/badge/TypeScript-5.0%2B-blue?logo=typescript)](https://www.typescriptlang.org/)
-
-*Remembers context across sessions. Learns from every interaction.*
-
-[Installation](#-installation) • [Features](#-features) • [Quick Start](#-quick-start) • [Documentation](#-documentation)
-
-</div>
-
----
-
-## ✨ Features
-
-<table>
-<tr>
-<td width="50%">
-
-### 🔄 Spiral Memory
-**5-level hierarchical memory** that persists across sessions. Context flows between levels based on relevance and recency.
-
-</td>
-<td width="50%">
-
-### 🤖 Multi-Provider
-**Claude, GPT-4, Ollama** and more. Switch seamlessly between AI providers.
-
-</td>
-</tr>
-<tr>
-<td width="50%">
-
-### ⚡ Autonomous Mode
-AI can **edit files, run commands, and commit changes** — fully autonomous when needed.
-
-</td>
-<td width="50%">
-
-### 🎯 Smart Context
-**Auto-assembles relevant code** from your project. Understands dependencies and patterns.
-
-</td>
-</tr>
-</table>
-
----
-
-## 🚀 Installation
-
-```bash
-# Run directly (no install needed)
-npx helixmind
-
-# Or install globally
-npm install -g helixmind
-helixmind
-```
-
----
-
-## 🎮 Quick Start
-
-```bash
-# Start interactive chat
-npx helixmind
-
-# Initialize in current project
-npx helixmind init
-
-# Run autonomous task
-npx helixmind "fix all lint errors in src/"
-
-# Continue last session
-npx helixmind --continue
-
-# Use specific model
-npx helixmind --model claude-sonnet-4-20250514
-```
-
----
-
-## 📋 Commands
-
-| Command | Description |
-|:--------|:------------|
-| `helixmind` | 🎯 Start interactive chat |
-| `helixmind init` | ⚙️ Initialize HelixMind in project |
-| `helixmind --continue` | ▶️ Resume last session |
-| `helixmind --model <name>` | 🤖 Use specific model |
-| `helixmind --help` | ❓ Show all options |
-
-### ⌨️ Keyboard Shortcuts
-
-| Key | Action |
-|:----|:-------|
-| `Ctrl+C` | 🛑 Exit |
-| `Ctrl+L` | 🧹 Clear screen |
-| `Ctrl+D` | 🐛 Toggle debug mode |
-| `Tab` | ✨ Autocomplete command |
-
----
-
-## 🧠 Memory Architecture
-
-```
-┌─────────────────────────────────────────────────────┐
-│  Level 1 — 🔍 Focus                                 │
-│  Most relevant, recent context                      │
-├─────────────────────────────────────────────────────┤
-│  Level 2 — ⚡ Active                                │
-│  Related files, dependencies                        │
-├─────────────────────────────────────────────────────┤
-│  Level 3 — 📚 Reference                             │
-│  Decisions, patterns, code structure                │
-├─────────────────────────────────────────────────────┤
-│  Level 4 — 📦 Archive                               │
-│  Compressed summaries, old sessions                 │
-├─────────────────────────────────────────────────────┤
-│  Level 5 — 🗄️ Deep Archive                          │
-│  Long-term knowledge, project history               │
-└─────────────────────────────────────────────────────┘
-```
-
-Context automatically flows between levels based on relevance and recency.
-
----
-
-## ⚙️ Configuration
-
-Create `.helixmind/config.json` in your project:
-
-```json
-{
-  "provider": "anthropic",
-  "model": "claude-sonnet-4-20250514",
-  "brainEnabled": true,
-  "permissions": {
-    "writeFiles": true,
-    "runCommands": true,
-    "gitCommit": true
-  }
-}
-```
-
-### 🔑 Environment Variables
-
-```bash
-ANTHROPIC_API_KEY=sk-ant-...    # For Claude
-OPENAI_API_KEY=sk-...           # For OpenAI/GPT
-```
-
----
-
-## 🛠️ Tech Stack
-
-| Category | Technology |
-|:---------|:-----------|
-| Language | ![TypeScript](https://img.shields.io/badge/TypeScript-strict-blue) |
-| AI SDKs | ![Anthropic](https://img.shields.io/badge/Anthropic-SDK-orange) ![OpenAI](https://img.shields.io/badge/OpenAI-SDK-green) |
-| Database | ![SQLite](https://img.shields.io/badge/SQLite-better--sqlite3-lightgrey) |
-| Embeddings | ![Transformers](https://img.shields.io/badge/HuggingFace-Transformers-yellow) |
-| Testing | ![Vitest](https://img.shields.io/badge/Vitest-testing-yellowgreen) |
-
----
-
-## 🏗️ Development
-
-```bash
-# Clone repo
-git clone https://github.com/DancingTedDanson011/HelixMind.git
-cd HelixMind
-
-# Install dependencies
-npm install
-
-# Build
-npm run build
-
-# Run in dev mode
-npm run dev
-
-# Run tests
-npm test
-```
-
----
-
-## 📄 License
-
-[AGPL-3.0](LICENSE) — Free for open-source use. Commercial licenses available.
-
----
-
-<div align="center">
-
-**Made with ❤️ by [HelixMind](https://github.com/DancingTedDanson011)**
-
-[⬆ Back to Top](#-helixmind)
-
-</div>
+<div align="center">
+
+# 🧠 HelixMind
+
+**AI Coding Assistant with Persistent Spiral Memory**
+
+[![npm version](https://img.shields.io/npm/v/helixmind?color=blue&logo=npm)](https://www.npmjs.com/package/helixmind)
+[![License](https://img.shields.io/badge/License-AGPL_3.0-blue?logo=gnu)](LICENSE)
+[![Node](https://img.shields.io/badge/Node-18%2B-green?logo=node.js)](https://nodejs.org)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.0%2B-blue?logo=typescript)](https://www.typescriptlang.org/)
+
+*Remembers context across sessions. Learns from every interaction. Full SaaS platform with CLI + Web Dashboard.*
+
+[Installation](#-installation) • [Features](#-features) • [Quick Start](#-quick-start) • [Web Platform](#-web-platform) • [Documentation](#-documentation)
+
+</div>
+
+---
+
+## ✨ Features
+
+<table>
+<tr>
+<td width="50%">
+
+### 🔄 Spiral Memory
+**5-level hierarchical memory** that persists across sessions. Context flows between levels based on relevance and recency.
+
+</td>
+<td width="50%">
+
+### 🤖 Multi-Provider
+**Claude, GPT-4, Ollama** and more. Switch seamlessly between AI providers with rate limiting and model limits.
+
+</td>
+</tr>
+<tr>
+<td width="50%">
+
+### ⚡ Autonomous Agent
+AI can **edit files, run commands, commit changes, and browse the web** — with a permission system and sandbox for safety.
+
+</td>
+<td width="50%">
+
+### 🎯 Smart Context
+**Auto-assembles relevant code** from your project. Session buffer, context trimming, and dependency tracking.
+
+</td>
+</tr>
+<tr>
+<td width="50%">
+
+### 🌐 Web Dashboard
+**Next.js 15 platform** with 3D brain visualization, admin panel, billing (Stripe), support tickets, and CLI remote control.
+
+</td>
+<td width="50%">
+
+### 🔬 Validation Matrix
+**Automatic output validation** with static checks, dynamic checks, spiral checks, autofix, and quality classification.
+
+</td>
+</tr>
+<tr>
+<td width="50%">
+
+### 📊 SWE-Bench Integration
+**Built-in benchmark suite** — run SWE-bench Lite/Verified, compare runs, measure Spiral Memory impact.
+
+</td>
+<td width="50%">
+
+### 🌍 Web Knowledge
+**Cloud-enriched context** — topic detection, web search, content extraction, and automatic knowledge integration.
+
+</td>
+</tr>
+<tr>
+<td width="50%">
+
+### 🐛 Bug Tracking
+**Automatic bug detection** and persistent journal — track bugs across sessions with evidence and status.
+
+</td>
+<td width="50%">
+
+### 💾 Checkpoints & Sessions
+**Save and revert** to any checkpoint, multi-session tab view, session lifecycle management.
+
+</td>
+</tr>
+<tr>
+<td width="50%">
+
+### 🌐 Browser Automation
+**Puppeteer-based browser control** — navigate, click, type, screenshot, visual analysis with Chrome integration.
+
+</td>
+<td width="50%">
+
+### 🔐 Authentication & Security
+**OAuth login, API keys, feature gating** — secure access control with subscription tier enforcement.
+
+</td>
+</tr>
+</table>
+
+---
+
+## 🚀 Installation
+
+```bash
+# Run directly (no install needed)
+npx helixmind
+
+# Or install globally
+npm install -g helixmind
+helixmind
+```
+
+---
+
+## 🎮 Quick Start
+
+```bash
+# Start interactive chat (default command)
+npx helixmind
+
+# Initialize in current project
+npx helixmind init
+
+# Send a single message
+npx helixmind chat -m "fix all lint errors in src/"
+
+# YOLO mode — auto-approve everything
+npx helixmind chat --yolo
+
+# Skip permission prompts
+npx helixmind chat -s
+
+# Feed files into spiral memory
+npx helixmind feed src/ --deep
+
+# Watch files and update spiral live
+npx helixmind feed src/ --watch
+```
+
+---
+
+## 📋 CLI Commands
+
+| Command | Description |
+|:--------|:------------|
+| `helixmind` / `helixmind chat` | 🎯 Start interactive chat (default) |
+| `helixmind helix` | 🎯 Alias for interactive chat |
+| `helixmind init` | ⚙️ Initialize HelixMind in project |
+| `helixmind chat -m "..."` | 💬 Send a single message |
+| `helixmind chat --yolo` | 🚀 Auto-approve all operations |
+| `helixmind chat --no-validation` | 🔇 Disable output validation |
+| `helixmind chat --validation-verbose` | 🔍 Detailed validation output |
+| `helixmind chat --validation-strict` | 🚫 Treat validation warnings as errors |
+| `helixmind feed [paths...]` | 📂 Feed files/dirs into spiral |
+| `helixmind feed --deep` | 🔍 Deep analysis with intent detection |
+| `helixmind feed --watch` | 👁️ Watch and auto-update spiral |
+| `helixmind spiral status` | 📊 Show spiral metrics |
+| `helixmind spiral search <query>` | 🔎 Search spiral context |
+| `helixmind spiral compact` | 🗜️ Trigger spiral compaction |
+| `helixmind config set <k> <v>` | ⚙️ Set config value |
+| `helixmind config get <key>` | 📖 Get config value |
+| `helixmind config list` | 📋 Show all config |
+| `helixmind export [dir]` | 📦 Export spiral to .helixmind.zip |
+| `helixmind import <zip>` | 📥 Import spiral from archive |
+| `helixmind login` | 🔑 Authenticate with web platform |
+| `helixmind logout` | 🚪 Remove stored auth |
+| `helixmind whoami` | 👤 Show auth status |
+| `helixmind bench run` | 🏋️ Run SWE-bench benchmark |
+| `helixmind bench results` | 📈 Show benchmark results |
+| `helixmind bench compare` | ⚖️ Compare benchmark runs |
+| `helixmind bench list` | 📋 List past runs |
+
+### ⌨️ Keyboard Shortcuts
+
+| Key | Action |
+|:----|:-------|
+| `Ctrl+C` | 🛑 Exit |
+| `Ctrl+L` | 🧹 Clear screen |
+| `Ctrl+D` | 🐛 Toggle debug mode |
+| `Tab` | ✨ Autocomplete command |
+
+---
+
+## 🧠 Memory Architecture
+
+```
+┌─────────────────────────────────────────────────────┐
+│  Level 1 — 🔍 Focus                                 │
+│  Most relevant, recent context                      │
+├─────────────────────────────────────────────────────┤
+│  Level 2 — ⚡ Active                                │
+│  Related files, dependencies                        │
+├─────────────────────────────────────────────────────┤
+│  Level 3 — 📚 Reference                             │
+│  Decisions, patterns, code structure                │
+├─────────────────────────────────────────────────────┤
+│  Level 4 — 📦 Archive                               │
+│  Compressed summaries, old sessions                 │
+├─────────────────────────────────────────────────────┤
+│  Level 5 — 🗄️ Deep Archive                          │
+│  Long-term knowledge, project history               │
+└─────────────────────────────────────────────────────┘
+```
+
+Context automatically flows between levels based on relevance and recency. Cloud enrichment adds web knowledge via topic detection and content extraction.
+
+---
+
+## 🌐 Web Platform
+
+The web dashboard (`web/`) is a full **Next.js 15** application:
+
+| Feature | Description |
+|:--------|:------------|
+| **3D Brain View** | Interactive Three.js visualization of your spiral memory |
+| **Dashboard** | Manage API keys, billing, profile, and CLI connections |
+| **Admin Panel** | User management, ticket system, plans, settings, stats |
+| **CLI Integration** | WebSocket bridge — control your CLI from the browser |
+| **Support System** | Built-in ticket system with detail views |
+| **Blog & Docs** | MDX-based with i18n (DE/EN), sidebar navigation |
+| **Auth** | NextAuth with OAuth, staff login, CLI authorization |
+| **Billing** | Stripe checkout, portal, webhooks |
+| **PWA** | Service worker, install prompt, offline support |
+| **Cookie Consent** | GDPR-compliant cookie banner and settings |
+
+### Web Setup
+
+```bash
+cd web
+npm install
+cp .env.example .env    # Configure database, auth, stripe
+npx prisma db push      # Set up database
+npm run db:seed          # Seed initial data
+npm run dev              # Start dev server (Turbopack)
+```
+
+---
+
+## ⚙️ Configuration
+
+Create `.helixmind/config.json` in your project:
+
+```json
+{
+  "provider": "anthropic",
+  "model": "claude-sonnet-4-20250514",
+  "brainEnabled": true,
+  "permissions": {
+    "writeFiles": true,
+    "runCommands": true,
+    "gitCommit": true
+  }
+}
+```
+
+### 🔑 Environment Variables
+
+```bash
+ANTHROPIC_API_KEY=sk-ant-...    # For Claude
+OPENAI_API_KEY=sk-...           # For OpenAI/GPT
+# Ollama: no key needed (local)
+```
+
+---
+
+## 🛠️ Tech Stack
+
+### CLI
+
+| Category | Technology |
+|:---------|:-----------|
+| Language | ![TypeScript](https://img.shields.io/badge/TypeScript-strict-blue) |
+| AI SDKs | ![Anthropic](https://img.shields.io/badge/Anthropic-SDK-orange) ![OpenAI](https://img.shields.io/badge/OpenAI-SDK-green) ![Ollama](https://img.shields.io/badge/Ollama-local-purple) |
+| Database | ![SQLite](https://img.shields.io/badge/SQLite-better--sqlite3-lightgrey) ![sqlite-vec](https://img.shields.io/badge/sqlite--vec-vectors-blue) |
+| Embeddings | ![Transformers](https://img.shields.io/badge/HuggingFace-Transformers-yellow) |
+| Browser | ![Puppeteer](https://img.shields.io/badge/Puppeteer-headless-green) |
+| Testing | ![Vitest](https://img.shields.io/badge/Vitest-70%2B_tests-yellowgreen) |
+| MCP | ![MCP](https://img.shields.io/badge/MCP-SDK-blue) |
+
+### Web
+
+| Category | Technology |
+|:---------|:-----------|
+| Framework | ![Next.js](https://img.shields.io/badge/Next.js-15-black) ![React](https://img.shields.io/badge/React-19-blue) |
+| 3D | ![Three.js](https://img.shields.io/badge/Three.js-R3F-green) |
+| Database | ![Prisma](https://img.shields.io/badge/Prisma-6-purple) |
+| Auth | ![NextAuth](https://img.shields.io/badge/NextAuth-v5-orange) |
+| Payments | ![Stripe](https://img.shields.io/badge/Stripe-17-blue) |
+| Styling | ![Tailwind](https://img.shields.io/badge/Tailwind-4-cyan) |
+| i18n | ![next-intl](https://img.shields.io/badge/next--intl-DE%2FEN-yellow) |
+| PWA | ![Serwist](https://img.shields.io/badge/Serwist-PWA-green) |
+
+---
+
+## 🏗️ Development
+
+```bash
+# Clone repo
+git clone https://github.com/DancingTedDanson011/HelixMind.git
+cd HelixMind
+
+# Install dependencies (CLI)
+npm install
+
+# Build CLI
+npm run build
+
+# Run CLI in dev mode
+npm run dev
+
+# Run tests
+npm test
+
+# Run tests with coverage
+npm run test:coverage
+
+# Web dashboard
+cd web
+npm install
+npm run dev
+```
+
+---
+
+## 📄 License
+
+[AGPL-3.0](LICENSE) — Free for open-source use. Commercial licenses available.
+
+---
+
+<div align="center">
+
+**Made with ❤️ by [HelixMind](https://github.com/DancingTedDanson011)**
+
+[⬆ Back to Top](#-helixmind)
+
+</div>

package/dist/cli/agent/loop.d.ts

@@ -22,6 +22,10 @@ export interface AgentLoopOptions {
     onThinking?: () => void;
     /** Called before rendering the final answer — use to stop activity */
     onBeforeAnswer?: () => void;
+    /** Called when the LLM produces a text block — used by web chat to stream text */
+    onTextBlock?: (text: string) => void;
+    /** Called when a tool call is about to execute — used by web chat to stream tool details */
+    onToolCallDetail?: (stepNum: number, name: string, input: Record<string, unknown>) => void;
     maxIterations?: number;
 }
 export interface AgentLoopResult {

package/dist/cli/agent/loop.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loop.d.ts","sourceRoot":"","sources":["../../../src/cli/agent/loop.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,WAAW,EAIZ,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAkC,KAAK,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvF,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAGrD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE/D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAIlE,qBAAa,eAAgB,SAAQ,KAAK;gBAC5B,OAAO,GAAE,MAAwB;CAI9C;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,WAAW,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,iBAAiB,CAAC;IAC/B,WAAW,EAAE,WAAW,CAAC;IACzB,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACvD,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACjE,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1F,0EAA0E;IAC1E,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;IACxB,sEAAsE;IACtE,cAAc,CAAC,EAAE,MAAM,IAAI,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9C,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,6EAA6E;IAC7E,cAAc,EAAE,WAAW,EAAE,CAAC;CAC/B;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAChC,WAAW,EAAE,MAAM,EACnB,mBAAmB,EAAE,WAAW,EAAE,EAClC,OAAO,EAAE,gBAAgB,EACzB,UAAU,CAAC,EAAE,eAAe,GAC3B,OAAO,CAAC,eAAe,CAAC,CAyR1B;AA6BD;;;;;GAKG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,gBAAgB,CAA0C;IAClE,OAAO,CAAC,YAAY,CAA6B;IAEjD,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,iEAAiE;IACjE,IAAI,MAAM,IAAI,WAAW,CAExB;IAED,KAAK,IAAI,IAAI;IAIb,MAAM,IAAI,IAAI;IASd;;;;;OAKG;IACH,KAAK,IAAI,IAAI;IAUP,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAcjC,kEAAkE;IAClE,KAAK,IAAI,IAAI;CAMd"}
+{"version":3,"file":"loop.d.ts","sourceRoot":"","sources":["../../../src/cli/agent/loop.ts"],"names":[],"mappings":"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"}

package/dist/cli/agent/loop.js

@@ -18,7 +18,7 @@ export class AgentAbortError extends Error {
  * AbortController cancels in-flight HTTP requests on emergency stop.
  */
 export async function runAgentLoop(userMessage, conversationHistory, options, controller) {
-    const { provider, systemPrompt, permissions, toolContext, checkpointStore, sessionBuffer, onTokensUsed, onToolCall, onStepStart, onStepEnd, onThinking, onBeforeAnswer, maxIterations = 200, } = options;
+    const { provider, systemPrompt, permissions, toolContext, checkpointStore, sessionBuffer, onTokensUsed, onToolCall, onStepStart, onStepEnd, onThinking, onBeforeAnswer, onTextBlock, onToolCallDetail, maxIterations = 200, } = options;
     const tools = getAllToolDefinitions();
     resetToolCounter();
     const messages = [...conversationHistory];
@@ -108,6 +108,7 @@ export async function runAgentLoop(userMessage, conversationHistory, options, co
         for (const block of response.content) {
             if (block.type === 'text' && block.text) {
                 totalText += block.text;
+                onTextBlock?.(block.text);
             }
             if (block.type === 'tool_use') {
                 hasToolUse = true;
@@ -132,6 +133,7 @@ export async function runAgentLoop(userMessage, conversationHistory, options, co
                 const stepNum = totalToolCalls;
                 const stepLabel = summarizeToolForStep(block.name, block.input);
                 onToolCall?.(block.name);
+                onToolCallDetail?.(stepNum, block.name, block.input);
                 onStepStart?.(stepNum, block.name, stepLabel);
                 sessionBuffer?.addToolCall(block.name, block.input);
                 renderToolCall(block.name, block.input);
@@ -262,6 +264,12 @@ function summarizeToolForStep(name, input) {
         case 'spiral_store': return 'storing in spiral';
         case 'bug_report': return `bug ${input.action || 'update'}`;
         case 'bug_list': return 'listing bugs';
+        case 'browser_open': return `opening browser${input.url ? ': ' + String(input.url).slice(0, 30) : ''}`;
+        case 'browser_navigate': return `navigating to ${String(input.url || '').slice(0, 40)}`;
+        case 'browser_screenshot': return 'taking screenshot';
+        case 'browser_click': return `clicking ${input.selector}`;
+        case 'browser_type': return `typing in ${input.selector}`;
+        case 'browser_close': return 'closing browser';
         default: return name;
     }
 }