profclaw 0.0.1-beta.3 → 2.3.0

package/README.md

@@ -1,6 +1,12 @@
 <p align="center">
-  <h1 align="center">profClaw</h1>
-  <p align="center">Smart, lightweight AI agent engine. Run locally on anything from a $10 board to a VPS.</p>
+  <img src="ui/public/brand/profclaw-appicon.svg" alt="profClaw" width="120" height="120">
+</p>
+
+<h1 align="center">profClaw</h1>
+
+<p align="center">
+  <b>Self-hosted AI agent engine for developers.</b><br>
+  35 providers · 72 tools · 22 channels · runs on anything.
 </p>
 
 <p align="center">
@@ -8,6 +14,9 @@
   <a href="LICENSE"><img src="https://img.shields.io/badge/License-AGPL--3.0-blue.svg?style=for-the-badge" alt="License: AGPL-3.0"></a>
   <img src="https://img.shields.io/badge/Node.js-22%2B-339933?style=for-the-badge&logo=node.js&logoColor=white" alt="Node.js 22+">
   <a href="https://github.com/profclaw/profclaw/pkgs/container/profclaw"><img src="https://img.shields.io/badge/Docker-ghcr.io-2496ED?style=for-the-badge&logo=docker&logoColor=white" alt="Docker"></a>
+  <img src="https://img.shields.io/badge/providers-35-f43f5e?style=for-the-badge" alt="35 providers">
+  <img src="https://img.shields.io/badge/tools-72-fb7185?style=for-the-badge" alt="72 tools">
+  <img src="https://img.shields.io/badge/channels-22-e11d48?style=for-the-badge" alt="22 channels">
 </p>
 
 <p align="center">
@@ -18,47 +27,87 @@
 
 ---
 
-profClaw is a local-first AI agent that talks to your tools. Connect it to Slack, Discord, Telegram, or any of 22 supported chat channels. Point it at your GitHub, Jira, or Linear. Give it an AI provider (Anthropic, OpenAI, Ollama, or 30+ others). It handles the rest - executing tasks, managing workflows, and automating your dev life through natural language.
+<p align="center">
+  <img src="docs-local/demos/hero-chat.gif" alt="profClaw chat with Gemma 4, local and free" width="700">
+</p>
 
-Runs on your machine. Your data stays local. No cloud required.
+<p align="center"><i>Chat with Gemma 4 locally. Zero cost. Runs on your Mac.</i></p>
+
+---
+
+## Table of Contents
+
+- [Why profClaw](#why-profclaw)
+- [Features](#features)
+- [Quick Start](#quick-start)
+- [Interactive TUI](#interactive-tui)
+- [Slash Commands](#slash-commands)
+- [Headless Mode](#headless-mode)
+- [Deployment Modes](#deployment-modes)
+- [Where It Runs](#where-it-runs)
+- [Configuration](#configuration)
+- [AI Providers](#ai-providers)
+- [Chat Channels](#chat-channels)
+- [Integrations](#integrations)
+- [Architecture](#architecture)
+- [Development](#development)
+- [License](#license)
+
+---
+
+## Why profClaw
+
+Most AI coding tools are cloud-only (Cursor, Devin) or single-purpose CLIs (Aider, SWE-Agent). profClaw runs on your machine, talks to 35 providers (or none, Ollama works offline), and does more than chat.
+
+- Local-first. Your data stays on your hardware.
+- 35 AI providers, including Ollama for fully offline usage.
+- Interactive TUI with streaming markdown, syntax highlighting, and a model switcher.
+- Routes tasks to the right agent based on capability scoring.
+- Real task queue with retry, backoff, and dead letter handling (BullMQ + Redis).
+- 22 chat channels: Slack, Discord, Telegram, WhatsApp, Teams, and more.
+- Per-token cost tracking with budget alerts.
+- 72 built-in tools: file ops, git, browser automation, cron, web search, voice.
+- Pico mode runs on a Raspberry Pi Zero 2W in ~140MB RAM.
 
 ## Features
 
 | | |
 |---|---|
-| **35 AI providers** | Anthropic, OpenAI, Google, Groq, Ollama, DeepSeek, Bedrock, and more |
-| **22 chat channels** | Slack, Discord, Telegram, WhatsApp, iMessage, Matrix, Teams, and 15 more |
-| **72 built-in tools** | File ops, git, browser automation, cron, web search, canvas, voice |
-| **50 skills** | Coding agent, GitHub issues, Notion, Obsidian, image gen, and more |
-| **MCP server** | Native Model Context Protocol - connect to any MCP-compatible client |
-| **Voice I/O** | STT (Whisper) + TTS (ElevenLabs/OpenAI/system) + Talk Mode |
-| **Plugin SDK** | Build and share third-party plugins via npm or ClawHub |
-| **3 deployment modes** | Pico (~140MB), Mini (~180MB), Pro (full features) |
+| 35 AI providers | Anthropic, OpenAI, Google, Groq, Ollama, DeepSeek, Bedrock, and 28 more |
+| 22 chat channels | Slack, Discord, Telegram, WhatsApp, iMessage, Matrix, Teams, and 15 more |
+| 72 built-in tools | File ops, git, browser automation, cron, web search, canvas, voice |
+| 50 skills | Coding agent, GitHub issues, Notion, Obsidian, image gen, and more |
+| Interactive TUI | Streaming markdown, syntax highlighting, slash picker, model selector |
+| MCP server | Model Context Protocol. Works with Claude Desktop, Cursor, any MCP client |
+| Voice I/O | Whisper STT + TTS (ElevenLabs/OpenAI/system) + talk mode |
+| Plugin SDK | Build and share plugins via npm or ClawHub |
+| 3 deployment modes | Pico (~140MB), Mini (~145MB), Pro (full features) |
 
-## Deployment Modes
+## Quick Start
 
-profClaw scales from a Raspberry Pi to a full production server:
+```bash
+npm install -g profclaw
+profclaw init
+profclaw chat --tui
+```
 
-| Mode | What you get | RAM | Best for |
-|------|-------------|-----|----------|
-| **pico** | Agent + tools + chat. No UI. | ~140MB | IoT, home automation, $10 boards |
-| **mini** | + Dashboard, basic cron, 1-2 channels | ~180MB | Personal dev server, VPS |
-| **pro** | + All channels, Redis queues, plugins, sandbox | ~200MB | Teams, production |
+```bash
+# Verify
+curl http://localhost:3000/health
+```
 
-Set via `PROFCLAW_MODE=pico|mini|pro` environment variable.
+`profclaw init` scans your project, detects your stack, and writes a `PROFCLAW.md` context file. It picks up any AI provider keys already in your environment.
 
-## Quick Start
+`profclaw chat --tui` opens the terminal UI with streaming responses, code highlighting, slash commands, and a model selector.
 
-### npm
+### Full setup wizard
 
 ```bash
-npx profclaw onboard  # Zero-to-running wizard
-# or
-npm install -g profclaw@latest
-profclaw setup        # Interactive config
-profclaw serve        # Start the agent
+npx profclaw onboard
 ```
 
+Walks you through provider setup, config, and server start. Takes about 5 minutes.
+
 ### Docker
 
 ```bash
@@ -74,11 +123,11 @@ docker run -d \
 ```bash
 git clone https://github.com/profclaw/profclaw.git
 cd profclaw
-cp .env.example .env    # Add your API key
+cp .env.example .env
 docker compose up -d
 ```
 
-**Free local AI?** Add Ollama:
+Want free local AI? Add Ollama:
 
 ```bash
 docker compose --profile ai up -d
@@ -90,9 +139,127 @@ docker compose --profile ai up -d
 curl -fsSL https://raw.githubusercontent.com/profclaw/profclaw/main/install.sh | bash
 ```
 
+## Interactive TUI
+
+<p align="center">
+  <img src="docs-local/demos/tasks-demo.gif" alt="profClaw task management" width="700">
+</p>
+
+profClaw has a full terminal UI. No browser needed.
+
+```bash
+profclaw chat --tui
+# or
+profclaw tui
+```
+
+What you get:
+
+- Streaming markdown rendered as the model responds
+- Syntax-highlighted code blocks (100+ languages)
+- Slash command picker: type `/` to browse skills
+- Model selector: switch providers mid-conversation with `Ctrl+M`
+- Tool execution panel showing every call, argument, and result
+- Session history and full keyboard navigation
+
+```
+┌─ profClaw v2.x.x ─────────────────────────────────────────────┐
+│  [Chat]                               [Tools]                  │
+│                                                                 │
+│  You: Review src/auth.ts for security issues                    │
+│                                                                 │
+│  Agent: I'll analyze auth.ts for security issues.     read_file │
+│                                                       ───────── │
+│  ## Security Analysis                                 auth.ts   │
+│                                                                 │
+│  **Critical**: JWT secret read from env without      analyze   │
+│  fallback guard on line 42. If `JWT_SECRET` is       ──────── │
+│  undefined the app will sign tokens with `undefined`. auth.ts  │
+│  ...                                                            │
+└─────────────────────────────── [claude-sonnet-4-6] [pro] ──────┘
+```
+
+## Slash Commands
+
+Type `/` in any chat to run a skill. Skills are plain Markdown files, easy to create your own.
+
+| Command | What it does |
+|---|---|
+| `/commit` | Write a conventional commit message for staged changes |
+| `/review-pr 42` | Full code review of a pull request |
+| `/deploy` | Run your deploy script with rollback awareness |
+| `/summarize src/` | Summarize all files in a directory |
+| `/web-research "topic"` | Research a topic across the web |
+| `/analyze-code file.ts` | Security, performance, and style analysis |
+| `/ticket PROJ-123` | Pull ticket context into the conversation |
+| `/image "prompt"` | Generate an image via configured image provider |
+| `/help` | List all available slash commands |
+| `/exit` | Exit the current session |
+
+See [Skills docs](https://profclaw.ai/docs/skills/overview) for all 50 built-in skills and how to create your own with a plain Markdown file.
+
+## Headless Mode
+
+<p align="center">
+  <img src="docs-local/demos/tools-demo.gif" alt="profClaw agentic tool calling" width="700">
+</p>
+
+Run agents from scripts, CI pipelines, or other services:
+
+```bash
+# One-shot message
+profclaw chat "Summarize the last 10 git commits"
+
+# JSON output for scripting
+profclaw chat "List open TODOs in src/" --output json
+
+# Run a skill headlessly
+profclaw skill run commit --message "feat: add auth"
+
+# Agent task with file context
+profclaw agent run "Review src/ for security issues" --files src/
+
+# Verify your setup
+profclaw doctor
+```
+
+REST API:
+
+```bash
+curl -X POST http://localhost:3000/api/chat/message \
+  -H "Content-Type: application/json" \
+  -d '{"message": "List open GitHub issues", "provider": "anthropic"}'
+```
+
+## Deployment Modes
+
+Same binary, different scale. Set `PROFCLAW_MODE` and go:
+
+| Mode | What you get | RAM | Best for |
+|------|-------------|-----|----------|
+| **pico** | Agent + tools + 1 chat channel + cron. No UI. | ~140MB | Raspberry Pi, $5 VPS, home server |
+| **mini** | + Dashboard, integrations, 3 channels | ~145MB | Personal dev server, small VPS |
+| **pro** | + All channels, Redis queues, plugins, browser tools | ~200MB | Teams, production |
+
+Set via `PROFCLAW_MODE=pico|mini|pro` environment variable.
+
+## Where It Runs
+
+| Hardware | RAM | Recommended mode |
+|----------|-----|-----------------|
+| Raspberry Pi Zero 2W | 512MB | pico |
+| Raspberry Pi 3/4/5 | 1-8GB | mini or pro |
+| Orange Pi / Rock Pi | 1-4GB | mini or pro |
+| $5/mo VPS (Hetzner, OVH) | 512MB-1GB | pico or mini |
+| Old laptop / home PC | 4-16GB | pro |
+| Docker (alongside other services) | 512MB+ | any mode |
+| Old Android phone (Termux) | 1-2GB | pico |
+
+profClaw requires Node.js 22+. For bare-metal embedded devices (ESP32, Arduino), see [MimiClaw](https://github.com/mimiclaw) (C) or [PicoClaw](https://github.com/picoclaw) (Go).
+
 ## Configuration
 
-The setup wizard (`profclaw setup`) handles everything interactively. Or set environment variables:
+The setup wizard (`profclaw onboard`) handles everything interactively. Or set environment variables:
 
 ```bash
 # AI Provider (pick one)
@@ -101,34 +268,16 @@ OPENAI_API_KEY=sk-xxx
 OLLAMA_BASE_URL=http://localhost:11434
 
 # Deployment
-PROFCLAW_MODE=mini          # pico | mini | pro
-PORT=3000                   # HTTP server port
+PROFCLAW_MODE=mini
+PORT=3000
 
 # Optional
 REDIS_URL=redis://localhost:6379   # Required for pro mode
 ```
 
-See [`.env.example`](.env.example) for all options.
+Run `profclaw doctor` to verify your configuration at any time.
 
-## Architecture
-
-```
-src/
-  adapters/       AI agent adapters (tool calling, streaming)
-  chat/           Chat engine + execution pipeline
-    providers/    Slack, Discord, Telegram, WhatsApp, WebChat, ...
-    execution/    Tool executor, sandbox, agentic loop
-  core/           Deployment modes, feature flags
-  integrations/   GitHub, Jira, Linear webhooks
-  queue/          BullMQ (pro) + in-memory (pico/mini) task queue
-  providers/      35 AI SDK providers
-  skills/         Skill loader and registry
-  mcp/            MCP server (stdio + SSE)
-  types/          Shared TypeScript types
-
-ui/src/           React 19 + Vite dashboard (mini/pro only)
-skills/           Built-in skill definitions
-```
+See [`.env.example`](.env.example) for all 130+ options.
 
 ## AI Providers
 
@@ -145,31 +294,78 @@ skills/           Built-in skill definitions
 | DeepSeek | V3, R1 | No |
 | Azure OpenAI | GPT-4o | No |
 | xAI | Grok | No |
-| Zhipu AI | GLM-4, GLM-5 | No |
-| Moonshot | Kimi | No |
-| Qwen API | Qwen 2.5 | No |
+| OpenRouter | Any model | No |
 | Together | Open models | No |
 | Fireworks | Open models | No |
 | Mistral | Mistral Large, Codestral | No |
-| OpenRouter | Any model | No |
-| Replicate | Open models | No |
-| ... and 18 more | HuggingFace, NVIDIA NIM, Watsonx, Volcengine, etc. | |
+| LM Studio | Local models | Yes |
+| ... and 21 more | HuggingFace, NVIDIA NIM, Cerebras, Replicate, Zhipu, Moonshot, Qwen, etc. | |
+
+## Chat Channels
+
+| Channel | Protocol |
+|---------|----------|
+| Slack | Bolt SDK |
+| Discord | HTTP Interactions |
+| Telegram | Bot API |
+| WhatsApp | Cloud API |
+| WebChat | SSE (browser-based) |
+| Matrix | Client-Server API |
+| Google Chat | Webhook + API |
+| Microsoft Teams | Bot Framework |
+| iMessage | BlueBubbles |
+| Signal | signald bridge |
+| IRC | TLS, RFC 1459 |
+| LINE | Messaging API |
+| Mattermost | REST API v4 |
+| DingTalk | OpenAPI + webhook |
+| WeCom | WeChat Work API |
+| Feishu/Lark | Open Platform |
+| QQ | Bot API |
+| Nostr | Relay protocol |
+| Twitch | Helix API + IRC |
+| Zalo | OA API v3 |
+| Nextcloud Talk | OCS API |
+| Synology Chat | Webhook |
 
 ## Integrations
 
 | Platform | Features |
 |----------|----------|
-| **GitHub** | Webhooks, OAuth, issue sync, PR automation |
-| **Jira** | Webhooks, OAuth, issue sync, transitions |
-| **Linear** | Webhooks, OAuth, issue sync |
-| **Slack** | Slash commands, DM pairing, thread replies |
-| **Discord** | Bot commands, channel routing |
-| **Telegram** | Bot API, inline commands |
-| **WhatsApp** | Cloud API or Baileys |
-| **WebChat** | Browser-based SSE chat, embeddable widget |
-| **Matrix** | Room-based, Client-Server API |
-| **Google Chat** | Webhook + service account, Cards v2 |
-| **MS Teams** | Bot Framework, Adaptive Cards |
+| GitHub | Webhooks, OAuth, issue sync, PR automation |
+| Jira | Webhooks, OAuth, issue sync, transitions |
+| Linear | Webhooks, OAuth, issue sync |
+| Cloudflare | Workers deployment, KV, D1 |
+| Tailscale | Private network access |
+
+## Architecture
+
+```
+src/
+  adapters/       AI agent adapters (tool calling, streaming)
+  chat/           Chat engine + execution pipeline
+    providers/    Slack, Discord, Telegram, WhatsApp, WebChat, ...
+    execution/    Tool executor, sandbox, agentic loop
+  core/           Deployment modes, feature flags
+  integrations/   GitHub, Jira, Linear webhooks
+  queue/          BullMQ (pro) + in-memory (pico/mini) task queue
+  providers/      35 AI SDK providers
+  skills/         Skill loader and registry
+  mcp/            MCP server (stdio + SSE)
+  tui/            Interactive terminal UI (ink + blessed)
+  types/          Shared TypeScript types
+
+ui/src/           React 19 + Vite dashboard (mini/pro only)
+skills/           Built-in skill definitions (Markdown)
+```
+
+Design decisions:
+- Same binary scales from pico to pro. Features are gated at runtime.
+- Adding an AI provider is one file implementing `ModelAdapter`.
+- Skills are plain `.md` files. No code needed.
+- BullMQ for production queues, in-memory fallback for pico/mini.
+
+See [Architecture docs](https://profclaw.ai/docs/architecture/overview) for a deep dive.
 
 ## Development
 
@@ -187,10 +383,13 @@ See [CONTRIBUTING.md](CONTRIBUTING.md) for full guidelines.
 
 See [SECURITY.md](SECURITY.md) for our security policy and how to report vulnerabilities.
 
-## Docs & Website
+## Need help?
 
-Documentation and marketing site live in a separate repo: [`profclaw-site`](https://github.com/profclaw/profclaw-site)
+- [Quickstart guide](https://docs.profclaw.ai/guides/quickstart)
+- [Full docs](https://docs.profclaw.ai)
+- [Report a bug](https://github.com/profclaw/profclaw/issues/new?template=bug_report.md)
+- [Discord](https://discord.gg/profclaw)
 
 ## License
 
-[AGPL-3.0](LICENSE) -- profclaw contributors, 2024-2026
+[AGPL-3.0](LICENSE)

package/dist/agents/agent-summary.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Agent Summary Tracker
+ *
+ * Provides real-time 1-2 word progress summaries of what agents are doing,
+ * suitable for display in CLI/UI progress indicators.
+ */
+export interface AgentSummary {
+    sessionId: string;
+    status: 'idle' | 'thinking' | 'executing' | 'waiting';
+    currentAction: string;
+    lastToolName?: string;
+    lastToolArgs?: string;
+    stepCount: number;
+    tokensUsed: number;
+    startedAt: number;
+    updatedAt: number;
+}
+type SseBroadcaster = (eventType: string, data: Record<string, unknown>) => void;
+export declare class AgentSummaryTracker {
+    private summaries;
+    private broadcaster;
+    registerSSEBroadcaster(broadcaster: SseBroadcaster): void;
+    start(sessionId: string): void;
+    update(sessionId: string, updates: Partial<AgentSummary>): void;
+    /**
+     * Auto-generate a human-readable summary from a tool call.
+     *
+     * Examples:
+     *   read_file({ path: '/src/auth.ts' })       → "Reading auth.ts"
+     *   write_file({ path: '/src/fix.ts' })        → "Writing fix.ts"
+     *   bash({ command: 'npm test' })              → "Running npm test"
+     *   search_files({ query: 'login' })           → "Searching for 'login'"
+     *   git_commit({ message: 'fix: auth' })       → "Committing changes"
+     *   complete_task                              → "Completing task"
+     *   default                                    → "Using {toolName}"
+     */
+    summarizeToolCall(sessionId: string, toolName: string, args: unknown): string;
+    get(sessionId: string): AgentSummary | undefined;
+    getAll(): AgentSummary[];
+    end(sessionId: string): void;
+}
+export declare function getAgentSummaryTracker(): AgentSummaryTracker;
+export {};
+//# sourceMappingURL=agent-summary.d.ts.map

package/dist/agents/agent-summary.js

@@ -0,0 +1,176 @@
+/**
+ * Agent Summary Tracker
+ *
+ * Provides real-time 1-2 word progress summaries of what agents are doing,
+ * suitable for display in CLI/UI progress indicators.
+ */
+import path from 'node:path';
+function extractFilename(filePath) {
+    if (typeof filePath !== 'string' || filePath.length === 0)
+        return undefined;
+    return path.basename(filePath);
+}
+function extractCommand(command) {
+    if (typeof command !== 'string' || command.length === 0)
+        return undefined;
+    // Truncate long commands to first 40 chars
+    const trimmed = command.trim();
+    return trimmed.length > 40 ? `${trimmed.substring(0, 40)}…` : trimmed;
+}
+function extractQuery(query) {
+    if (typeof query !== 'string' || query.length === 0)
+        return undefined;
+    const trimmed = query.trim();
+    return trimmed.length > 30 ? `${trimmed.substring(0, 30)}…` : trimmed;
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null;
+}
+function toArgs(input) {
+    return isRecord(input) ? input : {};
+}
+export class AgentSummaryTracker {
+    summaries = new Map();
+    broadcaster;
+    registerSSEBroadcaster(broadcaster) {
+        this.broadcaster = broadcaster;
+    }
+    start(sessionId) {
+        const now = Date.now();
+        const summary = {
+            sessionId,
+            status: 'idle',
+            currentAction: 'Starting',
+            stepCount: 0,
+            tokensUsed: 0,
+            startedAt: now,
+            updatedAt: now,
+        };
+        this.summaries.set(sessionId, summary);
+        this.broadcaster?.('agent:summary', summary);
+    }
+    update(sessionId, updates) {
+        const existing = this.summaries.get(sessionId);
+        if (!existing)
+            return;
+        const updated = {
+            ...existing,
+            ...updates,
+            sessionId, // always preserve original sessionId
+            updatedAt: Date.now(),
+        };
+        this.summaries.set(sessionId, updated);
+        this.broadcaster?.('agent:summary', updated);
+    }
+    /**
+     * Auto-generate a human-readable summary from a tool call.
+     *
+     * Examples:
+     *   read_file({ path: '/src/auth.ts' })       → "Reading auth.ts"
+     *   write_file({ path: '/src/fix.ts' })        → "Writing fix.ts"
+     *   bash({ command: 'npm test' })              → "Running npm test"
+     *   search_files({ query: 'login' })           → "Searching for 'login'"
+     *   git_commit({ message: 'fix: auth' })       → "Committing changes"
+     *   complete_task                              → "Completing task"
+     *   default                                    → "Using {toolName}"
+     */
+    summarizeToolCall(sessionId, toolName, args) {
+        const argsRecord = toArgs(args);
+        // File reads
+        if (toolName === 'read_file' || toolName === 'Read') {
+            const filename = extractFilename(argsRecord['path'] ?? argsRecord['file_path']);
+            return filename ? `Reading ${filename}` : 'Reading file';
+        }
+        // File writes
+        if (toolName === 'write_file' || toolName === 'Write' || toolName === 'create_file') {
+            const filename = extractFilename(argsRecord['path'] ?? argsRecord['file_path']);
+            return filename ? `Writing ${filename}` : 'Writing file';
+        }
+        // File edits
+        if (toolName === 'edit_file' || toolName === 'Edit' || toolName === 'str_replace_editor') {
+            const filename = extractFilename(argsRecord['path'] ?? argsRecord['file_path']);
+            return filename ? `Editing ${filename}` : 'Editing file';
+        }
+        // Bash/shell execution
+        if (toolName === 'bash' || toolName === 'Bash' || toolName === 'execute_command' || toolName === 'run_command') {
+            const cmd = extractCommand(argsRecord['command'] ?? argsRecord['cmd']);
+            return cmd ? `Running ${cmd}` : 'Running command';
+        }
+        // File search / glob
+        if (toolName === 'search_files' || toolName === 'Glob' || toolName === 'glob') {
+            const query = extractQuery(argsRecord['query'] ?? argsRecord['pattern']);
+            return query ? `Searching for '${query}'` : 'Searching files';
+        }
+        // Content search / grep
+        if (toolName === 'grep' || toolName === 'Grep' || toolName === 'search_content') {
+            const query = extractQuery(argsRecord['query'] ?? argsRecord['pattern']);
+            return query ? `Searching for '${query}'` : 'Searching content';
+        }
+        // Git operations
+        if (toolName === 'git_commit' || toolName === 'git_push') {
+            return 'Committing changes';
+        }
+        if (toolName === 'git_status') {
+            return 'Checking git status';
+        }
+        if (toolName === 'git_diff') {
+            return 'Reviewing changes';
+        }
+        // Task completion
+        if (toolName === 'complete_task') {
+            return 'Completing task';
+        }
+        // Web fetch / browse
+        if (toolName === 'web_fetch' || toolName === 'WebFetch' || toolName === 'fetch_url' || toolName === 'browse') {
+            const url = argsRecord['url'] ?? argsRecord['href'];
+            if (typeof url === 'string' && url.length > 0) {
+                try {
+                    const { hostname } = new URL(url);
+                    return `Fetching ${hostname}`;
+                }
+                catch {
+                    // malformed URL - fall through to default
+                }
+            }
+            return 'Fetching URL';
+        }
+        // Task tool — spawn sub-agent
+        if (toolName === 'Task' || toolName === 'task') {
+            return 'Spawning agent';
+        }
+        // Default fallback: humanize camelCase/snake_case tool name
+        const humanized = toolName
+            .replace(/_/g, ' ')
+            .replace(/([a-z])([A-Z])/g, '$1 $2')
+            .toLowerCase();
+        return `Using ${humanized}`;
+    }
+    get(sessionId) {
+        return this.summaries.get(sessionId);
+    }
+    getAll() {
+        return Array.from(this.summaries.values());
+    }
+    end(sessionId) {
+        const existing = this.summaries.get(sessionId);
+        if (existing) {
+            this.broadcaster?.('agent:summary', {
+                ...existing,
+                status: 'idle',
+                currentAction: 'Done',
+                updatedAt: Date.now(),
+                ended: true,
+            });
+        }
+        this.summaries.delete(sessionId);
+    }
+}
+// Singleton instance
+let tracker;
+export function getAgentSummaryTracker() {
+    if (!tracker) {
+        tracker = new AgentSummaryTracker();
+    }
+    return tracker;
+}
+//# sourceMappingURL=agent-summary.js.map