# 🐝 Hive Agent v0.10.0: The Colony

> ⚠️ **Breaking change.** This is a large architectural refactor of how agents work in Hive. **Old agents are no longer compatible.** Existing workspaces, custom agents, and saved sessions from pre-v0.10.0 builds will need to be recreated.

---

## ✨ Highlights

The **Colony** introduces a new way of working: a group of specialized workers operating together to run and scale your business.

The role of the **Queen** has evolved. Instead of only orchestrating, the Queen now **executes work first** to deliver immediate value, then **builds systems around that work** to create stable, repeatable business processes.

You now have a full leadership team of eight Queens, each with their own identity, expertise, and voice:

| Queen | Role |
| --- | --- |
| **Sophia** | Head of Brand & Design |
| **Charlotte** | Head of Finance & Fundraising |
| **Victoria** | Head of Growth |
| **Eleanor** | Head of Legal |
| **Rachel** | Head of Operations |
| **Isabella** | Head of Product Strategy |
| **Amelia** | Head of Talent |
| **Alexandra** | Head of Technology |

Start automating your business processes with your Queens today.

---

## 🏛️ The Colony Architecture

### Queens as Identities, Not Just Orchestrators

- **Queen profiles** — each queen is a YAML-backed persona (`~/.hive/agents/queens/{queen_id}/profile.yaml`) with core traits, hidden background, psychological profile, behavior triggers, and skill sets. Profiles are injected into the system prompt at session start.
- **CEO-style queen selection** — an LLM classifier routes every new user request to the best-matching queen based on the task at hand, with structured routing diagnostics (`QueenSelection`).
- **Queen DMs** — direct-message pages for each queen with a dedicated session flow, session switcher, and prompt library integration.
- **Independent / PM mode** — queens run in an independent mode for planning-phase work, with a "think out loud" internal monologue surfaced through internal tags.
- **Queen memory v2** — simplified memory implementation with reflection agent, cooldown-gated reflections, user identity, doppelganger wiring, and recall-selector for targeted retrieval.
- **Queen lifecycle tools** — first-class tools for escalation, queen reply, and session handoff.

### Colony Runtime

- **Grand architecture revamp** — the framework, agent loop, runtime, graph, pipeline, executor, and node worker layers have been rewritten from the ground up. Deprecated shims and legacy orchestration paths have been removed.
- **Colony creation flow** — colonies are created via skill, with reliable event bus subscription, worker spawning, and post-creation list refresh.
- **Scheduled triggers** — colonies can now be woken on a cron schedule, with triggers firing directly into the owning queen's session.
- **Simple fork** for agents, stable credential states, and improved worker execution reliability.

---

## 🆕 What's New

### Colony & Queens

- 8 default queen personas (Alexandra, Victoria, Isabella, Charlotte, Eleanor, Sophia, Amelia, Rachel) with profile YAML, examples, and behavior triggers
- LLM-based queen selector with reasoning output
- Queen DM page, queen session switcher, and sidebar queen item
- Queen scope memory, role examples, and identity loading
- Reflection agent with cooldown and improved reflection runner
- Queen orchestrator + `routes_queens` API
- Natural chat replies and cleaner home-prompt bootstrap
- Queen identity for new sessions
- `ask_user` / `ask_user_multiple` tools available in queen prompt
- Escalation and queen-reply tools

### Skills & Tools

- **Learned default skills** — skills the queen has learned become part of her baseline
- **Tool-gated skill activation** — skills only activate when their required tools are present
- **Skills for colonies** — per-colony skill registration and loading
- **Text-only model filter** — image-producing tools and vision-only prompt blocks are hidden from text-only models
- **Browser skills upgrade** — improved click reliability, screenshot capture, and credential filtering
- **Deprecated-tool removal** and alignment of Hive tool names across the codebase
- **Ask-user widget** with fallback rendering and preserved tool pill mapping across turn boundaries for deferred completions
- **Improved tool-call reliability** across the board (tool limit removed, tool blacklist, tool credential filter)
- **MCP** — efficient MCP loading at initialization, default MCP bootstrapping, registered available MCP tools, fixed MCP tool initialization and registry pipeline stage

### LLM & Credentials

- **Key pool** for credential management with stable credential states
- **Aden credentials storage adapter** and subscription-based LLM config activation endpoint
- **Consolidated model config** with unified model catalog
- **New providers** — Kimi, Hive, and Aden added to the model catalog
- **Model switcher** UI with runtime model switching API
- **LLM key validation endpoint** with agent errors surfaced via SSE
- **BYOK modal** import fixes for subscription token detection

### Frontend

- **Home redesign** — new home, credentials, and org chart pages
- **Colony chat** and **queen DM** pages
- **Sidebar + header** components and global app layout/routing
- **Model switcher, settings modal, template card**
- **Prompt library** with search, category filtering, and UI polish
- **Side panel** fixes and sub-agent pane light-mode support
- **Flowchart** light-mode support and normalized settings modal sizing
- **User profile settings** and UI enhancements
- **Sync user profile** to global memory as `user-profile.md`; queen profile API transformation
- Removed the old workspace GUI and its dependencies

### Framework & Runtime

- Architecture revamp: new runtime config, simplified agent loading, new infra for queen
- Home hive directory structure refactor
- Agent loading pipeline fixes, MCP registry pipeline stage fix
- Session resume improvements: separate resume vs new-session flow for queen sessions, edge-case fix for message injection in resumed sessions
- Strip internal tags from user-visible output
- Colony event bus subscription fixes and shared event bus for parent visibility
- Worker spawn and stop-worker fixes
- Default log level and extra logging hooks

---

## 🐛 Bug Fixes

- **Ask-user widget** — fallback when widget fails to mount
- **Skill loading** for colonies and proper skill resolution across queen sessions
- **Model switching** and new-chat flow no longer carry stale state
- **Tool pill mapping** preserved across turn boundary for deferred `ask_user` completions
- **Tool limit** removed (was capping legitimate long tool lists)
- **Queen loading** stability fixes
- **Side panel** rendering issues
- **Deprecated graphs** removed from UI
- **Home-page prompts** now reach the queen directly without waiting for the greeting to finish
- **Colony creation** link, reframing, and post-creation refresh
- **Build error** in colony creation path
- **GCU system prompt** tuning
- **Tool credential filter** correctness
- **Screenshot** capture and browser click reliability
- **Queen message injection** when resuming a session
- **Internal-tag diction** fixes in surfaced output
- **MCP tool initialization** on cold start
- **Frontend DM** edge cases
- **Prompt library** new-session handling for new chat
- **Config validation** and unavailable Minimax model handling
- **Queen identity** loading on cold boot
- **Extra text** in queen selector JSON response parsed safely
- **Outdated queen communication prompt** removed

---

## 🧹 Refactor & Cleanup

- **Shatter the Eld\*n ring** — top-to-bottom refactor of the runtime core
- **Grand clean-up** of deprecated code paths
- **Remove deprecated shims** and old session-status tools
- **Big test cleanup** — integration tests and component tests rewritten around the new architecture
- **Update references** for orchestrator / host / loader renames
- **Consolidate tests** for queen state machine and verified outcomes
- **Remove old workspace GUI** and its dependencies
- **Remove old "new agent" button** and deprecated entry points
- **Home hive directory** structure refactor

---

## ⚠️ Breaking Changes

- **Old agents are not compatible.** Custom agents authored against the pre-v0.10.0 framework will need to be re-authored against the new Queen/Colony runtime.
- **Session format** — pre-v0.10.0 sessions cannot be resumed.
- **Deprecated tools removed** and Hive tool names have been realigned; any external scripts referencing old tool names must be updated.
- **Old session-status tools** removed in favor of the new queen lifecycle tools.
- **Workspace GUI removed** — the legacy workspace UI is gone; use the new home, colony chat, and queen DM pages.
- **MCP registry pipeline** — MCP configurations now load through the new registry; custom MCP setups may need to be re-registered.

---

## 🚀 Upgrading

Because this release rewrites the agent runtime, the recommended upgrade path is:

1. Back up `~/.hive/` if you have sessions or custom agents you want to reference.
2. Pull `main` at the v0.10.0 tag.
3. Let Hive initialize the new queen profiles under `~/.hive/agents/queens/`.
4. Re-create any custom agents as colonies/queens against the new framework.
5. Re-register any custom MCP servers through the new MCP registry.

Welcome to the Colony. 🐝
