✨ feat(console): replace Streamlit chat with React console, align API and core contracts

Introduce `apps/meeseeks_console/`, a React + Vite web frontend for
task orchestration that connects through the REST API. Remove the
obsolete Streamlit-based `apps/meeseeks_chat/` and all associated
Docker, CI, and documentation references.

Core orchestration changes:
- Wire MCP tool scoping end-to-end: `context.mcp_tools[]` from the
  frontend now filters the tool schema via a new `filter_specs()`
  function in `tool_registry.py`, threaded through SessionRuntime →
  Orchestrator → ToolUseLoop.
- Wire uploaded attachment content into the LLM system prompt via
  `ContextBuilder` (text files read from disk, capped per file/total).
- Fix user steering: switch `AgentContext` from `asyncio.Queue`/`Event`
  to stdlib `queue.Queue`/`threading.Event` for cross-thread safety;
  wire `RunHandle` steering objects through the full call chain so
  `enqueue_message()` and `interrupt_step()` work.
- Fix `summarize_session()` status mapping: `done_reason` values
  `canceled`, `error`, `max_steps_reached` now set the `status` field
  correctly instead of falling through to `completed`.
- Extract reusable `filter_specs()` from `spawn_agent._filter_tool_specs`
  into `tool_registry` (DRY).

API changes:
- Pass `allowed_tools` from `context.mcp_tools` to `start_async()` and
  `run_sync()` for both async and legacy sync endpoints.
- Add `POST /sessions/<id>/message` (user steering mid-session).
- Add `POST /sessions/<id>/interrupt` (step interruption).
- Add `GET /sessions/<id>/agents` (sub-agent tree from transcript).
- Add CORS `after_request` hook for cross-origin frontend access.
- Fix `Dockerfile.api` exposed port from 5123 to 5124.

Console frontend:
- Add `sub_agent` event rendering in logs (depth-indented start/stop).
- Fix `StatusBadge` for `max_steps_reached` done reason.
- Add `sendMessage` and `interruptStep` API client functions.
- Enable text input while session is running (steering messages).
- Add sub-agent count indicator in conversation timeline.

Infrastructure:
- Per-project Makefiles for console (npm), API (uv), and CLI (uv).
- `docker/Dockerfile.console` (multi-stage node + nginx build).
- `docker/nginx-console.conf` (reverse-proxy /api/ to backend).
- `apps/meeseeks_api/docker-compose.yml` (full API + Console stack).
- `apps/meeseeks_console/docker-compose.yml` (standalone console).
- Docker CI updated to build `meeseeks-console` image instead of chat.
- Dependabot entry added for console npm dependencies.

Documentation:
- All references to Streamlit, meeseeks_chat, Magic Patterns, and
  Codex Console branding removed across README, CLAUDE.md, docs/,
  pyproject.toml, mkdocs.yml, codecov.yml, conftest, build-install.sh,
  and AGENTS.md shim files.
- Console introduced as a current feature in README (replacing the
  "What's Next" teaser) and docs/clients-web-api.md.
- Rename `ChatConfig` fields from `streamlit_port`/`streamlit_address`
  to `port`/`address` for backward-compatible config parsing.

Author: bearlike

.github/dependabot.yml

@@ -96,16 +96,16 @@ updates:
       prefix-development: "⬆️"
       include: "scope"
 
-  - package-ecosystem: "pip"
-    directory: "/apps/meeseeks_chat"
+  - package-ecosystem: "npm"
+    directory: "/apps/meeseeks_console"
     schedule:
       interval: "weekly"
       day: "monday"
       time: "09:00"
       timezone: "America/Los_Angeles"
     open-pull-requests-limit: 3
     groups:
-      chat-python:
+      console-npm:
         patterns:
           - "*"
         update-types:

.github/workflows/docker-buildx.yml

@@ -60,11 +60,11 @@ jobs:
             type=raw,value=stable,enable=${{ steps.extract_version.outputs.release_type == 'stable' }}
             type=raw,value=dev,enable=${{ steps.extract_version.outputs.release_type == 'dev' }}
 
-      - name: Docker meta for meeseeks-chat
-        id: meta_chat
+      - name: Docker meta for meeseeks-console
+        id: meta_console
         uses: docker/metadata-action@v5
         with:
-          images: ghcr.io/bearlike/meeseeks-chat
+          images: ghcr.io/bearlike/meeseeks-console
           tags: |
             type=raw,value=${{ steps.extract_version.outputs.version }}${{ steps.extract_version.outputs.release_type == 'dev' && '-dev' || '' }}
             type=raw,value=latest,enable=${{ steps.extract_version.outputs.release_type == 'latest' }}
@@ -106,15 +106,15 @@ jobs:
           tags: ${{ steps.meta_base.outputs.tags }}
           labels: ${{ steps.meta_base.outputs.labels }}
 
-      - name: Build and push meeseeks-chat
+      - name: Build and push meeseeks-console
         uses: docker/build-push-action@v5
         with:
           context: .
-          file: docker/Dockerfile.chat
+          file: docker/Dockerfile.console
           platforms: linux/amd64,linux/arm64
           push: ${{ github.event_name != 'pull_request' }}
-          tags: ${{ steps.meta_chat.outputs.tags }}
-          labels: ${{ steps.meta_chat.outputs.labels }}
+          tags: ${{ steps.meta_console.outputs.tags }}
+          labels: ${{ steps.meta_console.outputs.labels }}
           build-args: |
             BASE_IMAGE=ghcr.io/bearlike/meeseeks-base:${{ steps.extract_version.outputs.version }}${{ steps.extract_version.outputs.release_type == 'dev' && '-dev' || '' }}
 

.gitignore

@@ -154,6 +154,8 @@ apps/meeseeks_cli/data/
 # Local config files (MCP/tool manifests, secrets)
 **/app.json
 **/*config.json
+!apps/meeseeks_console/tsconfig.json
+!apps/meeseeks_console/tsconfig.node.json
 configs/*.toml
 configs/*.yaml
 configs/*.yml

CLAUDE.md

@@ -1,7 +1,7 @@
 # Agents Guide - Personal Assistant (Meeseeks)
 
 ## What this codebase is
-Meeseeks is a multi-agent LLM personal assistant with an async sub-agent hypervisor. The core engine uses a single async `ToolUseLoop` that the LLM drives via native `bind_tools` / `tool_use`. Sub-agents are spawned via a `spawn_agent` tool, tracked by an `AgentHypervisor`, and cleaned up via structured concurrency. It ships multiple interfaces (CLI, chat UI, REST API, Home Assistant) that share the same core engine.
+Meeseeks is a multi-agent LLM personal assistant with an async sub-agent hypervisor. The core engine uses a single async `ToolUseLoop` that the LLM drives via native `bind_tools` / `tool_use`. Sub-agents are spawned via a `spawn_agent` tool, tracked by an `AgentHypervisor`, and cleaned up via structured concurrency. It ships multiple interfaces (CLI, web console, REST API, Home Assistant) that share the same core engine.
 
 ## Core entry points
 - `packages/meeseeks_core/src/meeseeks_core/tool_use_loop.py`: async tool-use conversation loop (`ToolUseLoop`) — the core execution engine
@@ -16,7 +16,7 @@ Meeseeks is a multi-agent LLM personal assistant with an async sub-agent hypervi
 - `packages/meeseeks_core/src/meeseeks_core/session_store.py`: transcript storage, tags, and archive state
 - `packages/meeseeks_core/src/meeseeks_core/config.py`: `AppConfig` including `AgentConfig` (max_depth, max_concurrent, allowed_models, etc.)
 - `packages/meeseeks_tools/src/meeseeks_tools/`: tool implementations and integration glue
-- `apps/meeseeks_chat/src/meeseeks_chat/chat_master.py`: Streamlit UI
+- `apps/meeseeks_console/`: Web console (React + Vite, connects via REST API)
 - `apps/meeseeks_api/src/meeseeks_api/backend.py`: Flask API
 - `apps/meeseeks_cli/src/meeseeks_cli/cli_master.py`: terminal CLI with Rich Live agent display
 - `meeseeks_ha_conversation/`: Home Assistant integration
@@ -135,8 +135,8 @@ Official library/framework documentation and code examples.
 - Local dev uses `uv` with `configs/app.json` (and `configs/mcp.json` when using MCP).
 - Core-only install: `uv sync`.
 - Full dev install: `uv sync --all-extras --all-groups`.
-- Run interfaces from repo root with `uv run meeseeks`, `uv run meeseeks-api`, or `uv run meeseeks-chat`.
-- Dockerfiles live under `docker/` for base, chat, and API; Compose is supported when needed.
+- Run interfaces from repo root with `uv run meeseeks`, `uv run meeseeks-api`, or `cd apps/meeseeks_console && npm run dev`.
+- Dockerfiles live under `docker/` for base, console, and API; Compose is supported when needed.
 
 ## Linting & formatting
 - Primary linting uses `ruff` (root + subpackages). Auto-fix with `.venv/bin/ruff check --fix .`.

Makefile

@@ -6,7 +6,7 @@ bootstrap:
 	uv venv $(VENV)
 	uv pip install -e .[dev]
 	uv pip install -e packages/meeseeks_core -e packages/meeseeks_tools \
-		-e apps/meeseeks_api -e apps/meeseeks_chat -e apps/meeseeks_cli \
+		-e apps/meeseeks_api -e apps/meeseeks_cli \
 		-e meeseeks_ha_conversation
 
 lint:

README.md

@@ -8,7 +8,6 @@
     <a href="https://github.com/bearlike/Assistant/actions/workflows/docs.yml"><img alt="Docs" src="https://github.com/bearlike/Assistant/actions/workflows/docs.yml/badge.svg"></a>
     <a href="https://codecov.io/gh/bearlike/Assistant"><img src="https://codecov.io/gh/bearlike/Assistant/graph/badge.svg?token=OJ2YUCIZ2I" alt="Codecov"></a>
     <a href="https://github.com/bearlike/Assistant/releases"><img src="https://img.shields.io/github/v/release/bearlike/Assistant" alt="GitHub Release"></a>
-    <a href="https://github.com/bearlike/Assistant/pkgs/container/meeseeks-chat"><img src="https://img.shields.io/badge/ghcr.io-bearlike/meeseeks--chat:latest-blue?logo=docker&logoColor=white" alt="Docker Image"></a>
     <a href="https://github.com/bearlike/Assistant/pkgs/container/meeseeks-api"><img src="https://img.shields.io/badge/ghcr.io-bearlike/meeseeks--api:latest-blue?logo=docker&logoColor=white" alt="Docker Image"></a>
 </p>
 
@@ -36,23 +35,21 @@ Meeseeks is an AI task agent assistant built on a single async tool-use loop dri
     <tr>
         <th>Answer questions and interpret sensor information</th>
         <th>Control devices and entities</th>
-        <th>Web chat interface</th>
     </tr>
     <tr>
         <td align="center"><img src="docs/screenshot_ha_assist_1.png" alt="Screenshot" height="512px"></td>
         <td align="center"><img src="docs/screenshot_ha_assist_2.png" alt="Screenshot" height="512px"></td>
-        <td align="center"><img src="docs/screenshot_chat_app_1.png" alt="Screenshot of Meeseks WebUI" height="512px"></td>
     </tr>
 </table>
 
-## What's next (Meeseeks Console)
+## Meeseeks Console
 
-We are upgrading the API backend to better support a task-orchestration frontend. Next up: finalize the API shape, then polish the frontend and ship the full console experience.
+The web console provides a task orchestration frontend backed by the REST API. It supports session management, real-time event polling, tool selection, and execution trace viewing.
 
 <table align="center">
     <tr>
-        <th>Task detail page (coming soon)</th>
-        <th>Landing console (coming soon)</th>
+        <th>Task detail page</th>
+        <th>Console landing page</th>
     </tr>
     <tr>
         <td align="center"><img src="docs/meeseeks-console-02-tasks.jpg" alt="Meeseeks task detail page preview" height="512px"></td>
@@ -83,7 +80,7 @@ We are upgrading the API backend to better support a task-orchestration frontend
 - (✅) **Local file + shell tools:** Built-in Aider adapters for edit blocks, read files, list dirs, and shell commands (approval-gated). Edit blocks require strict SEARCH/REPLACE format; the tool returns format guidance on mismatches.
 - (✅) **Home Assistant:** Ships a Conversation integration for voice control and entity actions.
 - (✅) **REST API:** Exposes the assistant over HTTP for third-party integration.
-- (✅) **Web chat UI:** Streamlit interface with plans, tool input types, and responses.
+- (✅) **Web console:** Task orchestration frontend backed by the REST API (React + Vite).
 - (✅) **Terminal CLI:** Fast interactive shell with plan visibility and tool result cards.
 
 ## Safety and observability
@@ -100,7 +97,7 @@ Optional features that can be installed when needed.
 - **CLI layout adapts to terminal width.** Headers and tool result cards adjust to small and wide shells.
 - **Interactive CLI controls.** Use a model picker, MCP browser, session summary, and token budget commands.
 - **Inline approvals.** Rich-based approval prompts render with padded, dotted borders and clear after input.
-- **Unified experience.** Web, API, Home Assistant, and CLI interfaces share the same core engine to reduce duplicated maintenance.
+- **Unified experience.** Console, API, Home Assistant, and CLI interfaces share the same core engine to reduce duplicated maintenance.
 - **Shared session runtime.** The API exposes polling endpoints; the CLI runs the same runtime in-process for sync execution, cancellation, and summaries.
 - **Event payloads.** `action_plan` steps are `{title, description}`; `tool_result`/`permission` use `tool_id`, `operation`, and `tool_input`.
 
@@ -109,7 +106,7 @@ Optional features that can be installed when needed.
 - `packages/meeseeks_core/`: orchestration loop, schemas, session storage, compaction, tool registry.
 - `packages/meeseeks_tools/`: tool implementations and integrations (including Home Assistant and MCP).
 - `apps/meeseeks_api/`: Flask REST API for programmatic access.
-- `apps/meeseeks_chat/`: Streamlit UI for interactive chat.
+- `apps/meeseeks_console/`: Web console for task orchestration (React + Vite).
 - `apps/meeseeks_cli/`: Terminal CLI frontend for interactive sessions.
 - `meeseeks_ha_conversation/`: Home Assistant integration that routes voice to the API.
 - `packages/meeseeks_core/src/meeseeks_core/prompts/`: planner prompts and tool instructions.
@@ -123,7 +120,7 @@ flowchart LR
   subgraph Clients["Clients / Interfaces"]
     User[User]
     CLI["CLI\n(apps/meeseeks_cli)"]
-    Chat["Chat UI\n(apps/meeseeks_chat)"]
+    Console["Console\n(apps/meeseeks_console)"]
     API["REST API\n(apps/meeseeks_api)"]
     HA["Home Assistant\n(meeseeks_ha_conversation)"]
   end
@@ -167,12 +164,12 @@ flowchart LR
   end
 
   User --> CLI
-  User --> Chat
+  User --> Console
   User --> API
   HA --> API
 
   CLI --> SessionRuntime
-  Chat --> SessionRuntime
+  Console --> API
   API --> SessionRuntime
 
   SessionRuntime --> TaskMaster
@@ -235,7 +232,7 @@ Optional components:
 ```bash
 uv sync --extra cli   # CLI
 uv sync --extra api   # REST API
-uv sync --extra chat  # Streamlit UI
+cd apps/meeseeks_console && npm install  # Web console
 uv sync --extra ha    # Home Assistant integration
 ```
 

apps/meeseeks_api/AGENTS.md

@@ -1,3 +1,3 @@
-This is a shim file for Codex/OpenAI agents.
+This is a shim file for external agents.
 
 Read and follow [@CLAUDE.md](./CLAUDE.md) in this directory as the source of truth for project instructions.

apps/meeseeks_api/Makefile

@@ -0,0 +1,13 @@
+.PHONY: install dev lint test
+
+install:          ## Install package in editable mode
+	uv pip install -e .
+
+dev:              ## Start the API server
+	uv run meeseeks-api
+
+lint:             ## Run ruff on source
+	ruff check src/
+
+test:             ## Run tests
+	uv run pytest tests/ -q

apps/meeseeks_api/README.md

@@ -1,6 +1,6 @@
 # Meeseeks API Server
 <p align="center">
-    <a href="https://github.com/bearlike/Assistant/pkgs/container/meeseeks-chat"><img src="https://img.shields.io/badge/ghcr.io-bearlike/meeseeks&#x2212;api:latest-blue?style=for-the-badge&logo=docker&logoColor=white" alt="Docker Image"></a>
+    <a href="https://github.com/bearlike/Assistant/pkgs/container/meeseeks-api"><img src="https://img.shields.io/badge/ghcr.io-bearlike/meeseeks&#x2212;api:latest-blue?style=for-the-badge&logo=docker&logoColor=white" alt="Docker Image"></a>
     <a href="https://github.com/bearlike/Assistant/releases"><img src="https://img.shields.io/github/v/release/bearlike/Assistant?style=for-the-badge&" alt="GitHub Release"></a>
 </p>
 
@@ -32,3 +32,17 @@ uv run meeseeks-api
 - `GET /api/share/{token}` fetch shared session data
 
 [Link to GitHub Repository](https://github.com/bearlike/Assistant)
+
+## Docker Compose
+
+Deploy the API and console together:
+
+```bash
+docker compose up --build
+```
+
+This starts:
+- **API** on port 5124
+- **Console** on port 3000 (proxies `/api/` to the API container)
+
+Set `MASTER_API_TOKEN` in the environment or `.env` file to override the default API key.

apps/meeseeks_api/docker-compose.yml

@@ -0,0 +1,24 @@
+services:
+  api:
+    build:
+      context: ../..
+      dockerfile: docker/Dockerfile.api
+    ports:
+      - "5124:5124"
+    volumes:
+      - ../../configs:/app/configs:ro
+      - api-data:/app/data
+    environment:
+      - MASTER_API_TOKEN=${MASTER_API_TOKEN:-msk-strong-password}
+
+  console:
+    build:
+      context: ../..
+      dockerfile: docker/Dockerfile.console
+    ports:
+      - "3000:3000"
+    depends_on:
+      - api
+
+volumes:
+  api-data: