CHANGELOG.md

Changelog

[0.1.8] - 2026-03-22

Added

• Demo video in documentation

Fixed

• Bevy MC cards growing too tall with many tasks/activity — capped card max height to 300px and truncated task summary and activity detail text to 60 chars
• Bevy 3D keyboard shortcuts (M, j/k, zoom) stealing input from message dialog — all MC key handlers now check input_state.active before processing

[0.1.7] - 2026-03-18

Added

• TUI overhaul — complete terminal UI redesign: centered/scaled world view filling available space, styled sidebar with solid dark background, enhanced detail panel with state badges, speech bubbles with rounded borders, colored message log with Unicode arrows, status bar with mode badge
• TUI Mission Control — full MC dashboard in terminal with agent cards (per-agent tasks/activity from SQLite), activity feed, and task list — matching Bevy 3D layout
• TUI MC navigation — Tab cycles panels (Agents→Activity→Tasks), j/k or arrows select items, Enter opens detail popup (agent info+inbox or task detail), Esc closes popup, M exits MC
• TUI auto-scroll — all MC panels auto-scroll to keep selected item visible when navigating beyond view
• TUI sidebar toggle — H key toggles sidebar across all modes (World, Detail, MessageLog); sidebar resizes world via Layout split
• Bevy MC keyboard navigation — j/k or arrow keys navigate agent cards with border highlight, Enter selects/deselects agent (filters activity+tasks), Esc deselects
• TUI furniture sprites — all tile types (desks, vending machines, coffee, couches, treadmills, arcade, etc.) rendered with ASCII art
• TUI agent labels — agent names displayed below sprites in world view
• 23 new TUI tests, 254 tests across 11 modules

Fixed

• TUI crash on multi-byte UTF-8 chars (em dash —) in trunc() and string slicing — now uses chars().take() instead of byte indexing
• Bevy MC agent cards not scrollable — individual cards had McScrollable+Interaction stealing hover from parent container
• TUI sidebar overlapping world view — now resizes via Layout split instead of overlay
• TUI sidebar transparent background — solid dark fill applied
• TUI MC cards breaking box-drawing borders on narrow panels — width-aware rendering with text truncation
• TUI MC showing empty data — reads tasks/activity from SQLite DB
• Agents sidebar heading unreadable in light mode

[0.1.6] - 2026-03-17

Added

• MC Inbox viewer — click the msg badge on agent cards to open a scrollable popup listing all messages (sender, time ago, full text); press Escape to close
• Task scope field — optional scope field on task API for full task descriptions beyond summary; displayed in MC task popup between Summary and Timestamps
• Authorization: Bearer auth — standard Authorization: Bearer <token> header (legacy X-API-Key still accepted for backward compatibility)
• API accepts agent names — all {id} endpoints also accept agent name; UUID/prefix tried first, then name fallback
• Task state filter — GET /agents/{id}/tasks?state=running filters tasks by state
• Agent ID on MC cards — short ID (8 chars) displayed on each Mission Control agent card
• Agent card scrolling — MC agent cards scroll for long content (tasks, activity, scope)
• VPS deployment docs — nginx reverse proxy config with SSE support, systemd service file, Let's Encrypt HTTPS one-liner
• 5 new DB tests (scope persistence), 2 new API tests (scope round-trip) — 231 tests across 10 modules

Fixed

• Agents randomly walking/eating while working on API tasks (api_locked agents skip random goal assignment, path/goal cleared when API locks)
• Sidebar and status bar rendering on top of Mission Control overlay (hidden when MC opens, restored on close)
• Sidebar top padding and Agents title left padding alignment

[0.1.5] - 2026-03-17

Added

• Mission Control scrolling — all panels (agent cards, activity feed, task list, popup dialog) now scroll via mouse wheel with Interaction-based hover detection and Bevy 0.18 ScrollPosition wiring
• Mission Control zoom — Ctrl+/Ctrl- scales all text, padding, gaps, borders, and widths; fully responsive layout
• See All / Show Less — activity and task panels show limited items by default with expandable toggle buttons
• Task duration tracking — completed/failed tasks show human-readable duration (e.g. "3m 23s") in both task list rows and detail popup, calculated from submitted_at to last_updated
• Task detail popup — click any task row to open a centered dialog with full task info (ID, agent, state badge, summary, timestamps, duration); press Esc to close
• Clickable agent cards — click an agent card in MC to filter the activity feed and task list to that agent; click again to deselect
• DELETE task endpoint — DELETE /agents/{id}/tasks/{task_id} removes a task from DB and observer
• Agent state sync with tasks — task reports auto-set agent visual state (submitted→Thinking, running→Working, completed→Idle) with api_locked flag preventing simulation override
• Concurrent task management — completing one task no longer clears api_locked when other tasks are still running/submitted
• Task reporting API docs — README now documents the task reporting endpoint with curl, Python, and TypeScript examples
• Test count: 226 tests across 10 modules

Fixed

• Scroll wheel no longer hijacks MC zoom (scroll is for content, Ctrl+/- for zoom)
• Task duration showing "0s" — DB now uses ON CONFLICT to preserve original submitted_at
• Agent state flickering during concurrent tasks (checks for other active tasks before unlocking)
• Camera zoom/pan blocked when Mission Control is open
• MC content clipping instead of scrolling (proper height constraints + ScrollPosition)
• send().await replaced with try_send() in API handlers to prevent channel blocking

[0.1.4] - 2026-03-16

Added

• SQLite persistence — agents, messages, activity logs, tasks, and heartbeats survive restarts; stored at ~/.config/agentverse/agentverse.db with WAL mode for concurrent reads
• Mission Control panel — press M to open full-screen overlay with GitHub-style agent cards (status dot, kind badge, inbox count), activity feed, and task list
• Dynamic Mission Control theme — panel follows system light/dark mode in real-time with full color palette (backgrounds, cards, borders, text, badges)
• Agent restore on startup — external agents are restored from SQLite with original UUIDs, inbox messages, and valid positions
• 15 Bevy ECS tests for Mission Control (state, colors, setup hierarchy, update behavior, DB integration)
• 18 SQLite persistence tests (agents, messages, activity, tasks, heartbeats, purge, restore)
• Test count: 217 tests across 10 modules

Fixed

• Agent name labels rendering on top of sidebar and status bar (added ZIndex(100))
• Agent name labels overlapping Mission Control overlay (hidden when MC open)
• Agent list padding inconsistent with detail panel (6px → 14px)

[0.1.3] - 2026-03-16

Added

• Speech bubbles — messages sent via sidebar now appear as floating bubbles above agents in the 3D world
• Inbox delivery — sidebar messages push to agent inbox so external agents can retrieve them via API
• Resizable sidebar — drag left edge to resize width (200–600px), drag separator to resize detail panel height
• Resize cursor feedback — col-resize / row-resize cursors on hover over drag handles
• Live dark/light mode — all world materials (floors, walls, furniture, equipment) tint for dark mode, not just background
• System theme detection — polls macOS/Windows OS appearance every 2 seconds, auto-switches

Changed

• Bevy 3D is now the default renderer — no --bevy flag needed, just run agentverse
• Upgraded all dependencies — Bevy 0.15→0.18, rand 0.9→0.10, reqwest 0.12→0.13, toml 0.8→1.0, and more
• Rust minimum version bumped to 1.94
• Repository URL changed to github.com/adolfousier/agentverse
• Updated all descriptions: "Isometric 3D world... built for teams, built in Rust with Bevy"
• Sidebar width persists to config file across restarts
• 3D controls listed first in README, TUI secondary

Removed

• GTK4 renderer — 12 source files (2,700+ lines) deleted; Bevy fully replaces it
• gui feature flag and gtk4 dependency removed from Cargo.toml
• --gui CLI flag removed

Fixed

• UI invisible after Bevy 0.18 upgrade (missing bevy_ui_render feature)
• Agent name labels vanished after upgrade (IsDefaultUiCamera marker needed)
• Meeting table accidentally replaced by plant during layout refactor
• Sidebar header padding misaligned with detail panel
• All Bevy 0.18 breaking changes: EventReader→MessageReader, get_single()→single(), despawn_recursive()→despawn(), AmbientLight as Component, BorderRadius in Node, ScalingMode moved

[0.1.2] - 2026-03-15

Added

Bevy 3D Renderer

• Full 3D world renderer using Bevy 0.15 (--bevy flag, bevy3d feature)
• Isometric camera with orbit controls (right-click drag to rotate, scroll to zoom)
• 3D furniture: desks with monitors and keyboards, vending machines, arcade cabinets, coffee machines, couches, armchairs, plants, floor lamps, whiteboards, kitchen counters, gym equipment
• Voxel-style 3D agents with body, head, hair, arms, legs, eyes, and shadow
• Agent color coding and floating name labels
• Walking animation with arm/leg swing and body bob
• Activity animations: typing (working), eating motion, exercise bounce, playing
• Click-to-select agents with highlight ring
• Sidebar overlay with agent list and detail panel
• Message input box for sending messages to selected agents
• Real-time sync between simulation state and 3D scene

Meeting Table

• Round meeting table with 4 chairs at cardinal positions
• Capacity system: meeting table supports 4 simultaneous agents
• GoToMeeting agent goal for meeting table destinations

Changed

• Simulation runs inside Bevy's game loop as a chained system (eliminates lock contention between render and sim threads)
• Furniture faces camera (+z direction) for proper isometric viewing
• Desk monitors face camera with keyboard in front
• Agent adjacency placement prefers front-facing positions at furniture
• README updated from GTK4 2D to Bevy 3D throughout
• Crate description updated for crates.io

Fixed

• Lock starvation causing agents to permanently freeze (moved sim into Bevy game loop)
• Agent movement deadlocks from multiple competing write locks
• Furniture orientation: vending machines, arcade cabinets now face camera
• Agents no longer stop at sides of desks (improved adjacent floor placement)
• Floating agent labels use colored dots instead of emoji (cross-platform compatibility)
• Sidebar ghost text artifacts cleared
• Removed all dead code warnings (unused struct fields, dead ping pong rendering)

Removed

• Ping pong table (replaced by meeting table)
• PingPongTableLeft/PingPongTableRight tile variants

[0.1.1] - 2026-03-15

Added

Production-Ready API

• API key authentication via X-API-Key header — required for all endpoints except /health
• API key redacted from all debug output and logs ([REDACTED])
• Server refuses to start without api_key configured
• Rate limiting with ConcurrencyLimitLayer
• JSON error responses (ApiError enum → {"error":"...","message":"..."})
• SSE real-time event streaming (GET /events)
• Agent control endpoints: move, goal, state, agent-to-agent messaging
• Agent disconnect endpoint (DELETE /agents/{id})
• World tile map endpoint (GET /world/tiles)
• Agent ID prefix matching for convenience
• Crate-level documentation for crates.io landing page

Agent Inbox & Messaging

• In-memory inbox per agent (VecDeque<AgentMessage>, capped at 500 messages)
• GET /agents/{id}/messages — poll inbox for received messages (with ?limit=N)
• POST /agents/{id}/messages/ack — clear inbox after reading
• Webhook push delivery — messages auto-POST to agent's registered endpoint
• TUI detail panel shows inbox messages when agent is selected
• Messages include sender ID, sender name, text, and timestamp

Observability & Control Plane

• AgentObserver with ring-buffered activity logs, heartbeat tracking, task history
• 6 new endpoints: /agents/{id}/detail, /activity, /heartbeat, /status, /tasks, /dashboard
• Connection health tracking (online/stale/offline/unknown) based on heartbeat recency
• All API actions automatically record timestamped activity entries

GTK4 GUI

• Isometric 2.5D world view with Cairo rendering (--gui flag, requires gui feature)
• Isometric furniture: desks, vending machines, arcade cabinets, coffee machines, yoga mats, gym equipment, kitchen counters, ping pong tables
• Agent rendering with voxel-style bodies, name labels, and speech bubbles
• Camera controls: mouse drag to pan, scroll to zoom, R to rotate (4 angles)
• Sidebar with agent list and detail panel (toggle with H key)
• Status bar with tick count, agent count, and zoom level
• Ping pong table spans 2 grid tiles for realistic rectangular shape
• Furniture capacity system (ping pong: 2 agents, others: 1)
• Window size and sidebar state persist across restarts via config file

Testing & Docs

• 184 tests across 8 modules (api, observability, world, agent, a2a, simulation, tui, config)
• 8 inbox tests: empty, receives, multiple messages, limit, ack, self-message, 500 cap, multiple senders
• Agent integration guides: OpenCrabs (Rust), OpenClaws (Python), Hermes (TypeScript), generic HTTP
• Multi-machine setup documentation
• TESTING.md with full coverage breakdown
• README with badges, table of contents, full API docs with auth examples

Changed

• Compact world layout: 28x20 grid with thin walls and no wasted space
• Agents stay at activities longer (working: 120 ticks, eating: 50, playing: 80, exercising: 90)
• Furniture details rendered on both isometric faces for visibility from any angle
• Agents front-face furniture when stopped at activity locations
• Messaging agents auto-transition back to Idle after 30 ticks
• Shared atomic tick counter between simulation and API for accurate world snapshots
• api_key changed from optional to required in ServerConfig
• reqwest uses rustls-tls for crates.io compatibility

Fixed

• Kitchen furniture flickering during pan (switched from screen coords to grid coords for variant hashing)
• Duplicate speech log entries in sidebar
• Keyboard shortcuts (H, R, Escape) not working when sidebar has focus
• Vending machines no longer block hallway passage
• Agents no longer pile up on same furniture spot
• Removed non-functional ctrl+shift+scroll rotate binding
• Removed dead code (ViewState::new(), Camera::rotate_ccw())
• Zero clippy warnings with --all-features
• Fixed flaky walking agent test (uses pathfinding for valid targets)

[0.1.0] - 2025-12-01

Added

• Initial agentverse scaffold
• TUI world with animated agents and BFS pathfinding
• A2A client for connecting OpenCrabs agents
• HTTP API for external agent integration
• Pixel-art world with camera system
• Dynamic world sizing and dark theme