@@ -13,23 +13,23 @@ Control several automated players in the game https://www.spacemolt.com/. Each i
1313 - Custom framework to expose internal orchestration tools via MCP.
1414 - **Orchestration:**
1515 - Capability to broadcast shared objectives to the entire swarm simultaneously.
16- - Targeted messaging/tasking for individual swarm members.
16+ - Targeted messaging/tasking for individual Myses.
1717 - **Command Center TUI:**
18- - **Aggregated Dashboard:** High-level swarm status, health, swarm message history, and agent list.
19- - **Focus Mode:** Detailed conversation logs and direct control for individual agents.
18+ - **Aggregated Dashboard:** High-level swarm status, health, swarm message history, and Mysis list.
19+ - **Focus Mode:** Detailed conversation logs and direct control for individual Myses.
2020 - **Aesthetic:** Retro-futuristic (80s/90s) CRT-style visuals with reactive animations.
2121
2222 ### Dashboard Layout
2323
2424 ```
2525 ╔═══ ZOEA NOVA COMMAND CENTER ═══╗
26-● 2 ○ 1 ◌ 0 ✖ 0 ← Agent state counts (running/idle/stopped/errored)
26+● 2 ○ 1 ◌ 0 ✖ 0 ← Mysis state counts (running/idle/stopped/errored)
2727 ─── Swarm Messages ─── ← Recent broadcast messages (up to 10)
2828 14:30:05 Hello everyone, mine!
2929 14:32:12 Check your inventories
30-─── Agents ─── ← Agent list with status and last message
31-⠋ agent-1 running [ollama] │ I found some ore...
32-○ agent-2 idle [ollama] │ Ready to start
30+─── Myses ─── ← Mysis list with status and last message
31+⠋ mysis-1 running [ollama] │ I found some ore...
32+○ mysis-2 idle [ollama] │ Ready to start
3333 Press ? for help
3434 ```
3535
@@ -61,8 +61,8 @@ Scrollable conversation viewport showing full message history with role-based st
6161 Example `config.toml`:
6262 ```toml
6363 [swarm]
64-default_agents = 4
65-max_agents = 16
64+default_myses = 4
65+max_myses = 16
6666
6767 [providers.ollama]
6868 endpoint = "http://localhost:11434"
@@ -79,15 +79,15 @@ upstream = "https://game.spacemolt.com/mcp"
7979 ## State & Persistence
8080
8181 - **Database:** Single SQLite file at `$HOME/.zoea-nova/zoea.db`.
82-- **Scope:** Agent memories, conversation history, swarm state, per-agent provider config, and user preferences.
82+- **Scope:** Mysis memories, conversation history, swarm state, per-Mysis provider config, and user preferences.
8383 - **Migrations:** Schema managed via embedded SQL migrations (e.g., `golang-migrate` or manual versioning). Never support backwards, never write data migrations. If we change the schema we create a new db fresh.
8484 - **Backup:** Consider periodic WAL checkpoints; SQLite handles crash recovery.
8585
86-### Database Schema (v2)
86+### Database Schema (v3)
8787
8888 ```sql
89--- Agents table
90-CREATE TABLE agents (
89+-- Myses table
90+CREATE TABLE myses (
9191 id TEXT PRIMARY KEY,
9292 name TEXT NOT NULL,
9393 provider TEXT NOT NULL,
@@ -100,50 +100,50 @@ CREATE TABLE agents (
100100 -- Memories table (conversation history)
101101 CREATE TABLE memories (
102102 id INTEGER PRIMARY KEY AUTOINCREMENT,
103- agent_id TEXT NOT NULL,
103+ mysis_id TEXT NOT NULL,
104104 role TEXT NOT NULL, -- system, user, assistant, tool
105105 source TEXT NOT NULL, -- direct, broadcast, system, llm, tool
106106 content TEXT NOT NULL,
107107 created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
108- FOREIGN KEY (agent_id) REFERENCES agents(id) ON DELETE CASCADE
108+ FOREIGN KEY (mysis_id) REFERENCES myses(id) ON DELETE CASCADE
109109 );
110110 ```
111111
112112 **Memory Sources:**
113-- `direct` — Message sent directly to a specific agent
114-- `broadcast` — Message broadcast to all agents (swarm command)
113+- `direct` — Message sent directly to a specific Mysis
114+- `broadcast` — Message broadcast to all Myses (swarm command)
115115 - `system` — System prompts
116116 - `llm` — LLM-generated responses
117117 - `tool` — Tool call results
118118
119-## Agent Lifecycle
119+## Mysis Lifecycle
120120
121-- **Ownership:** The Commander (orchestrator) owns all agent lifecycles.
122-- **Creation:** User creates agents via TUI controls. Default swarm size: **4 agents**.
123-- **Limits:** Configurable `max_agents` (default 16). Enforced at Commander level, but user controls count from TUI.
121+- **Ownership:** The Commander (orchestrator) owns all Mysis lifecycles.
122+- **Creation:** User creates Myses via TUI controls. Default swarm size: **4 Myses**.
123+- **Limits:** Configurable `max_myses` (default 16). Enforced at Commander level, but user controls count from TUI.
124124 - **States:** `idle` → `running` → `stopped` / `errored`.
125125 - **TUI Controls:**
126- - **Create:** Spawn a new agent (if under limit).
127- - **Relaunch:** Restart a stopped/errored agent.
128- - **Force Stop:** Immediately halt an agent.
129- - **Delete:** Remove agent and optionally purge its memories.
130- - **Broadcast Message:** Send a message/objective to all agents.
131- - **Direct Message:** Send a message to a specific agent.
132- - **Configure Agent:** Set model/provider per agent (Ollama or OpenCode Zen).
133-- **Recovery:** On application restart, agents are rehydrated from SQLite in `stopped` state; user must explicitly relaunch.
126+ - **Create:** Spawn a new Mysis (if under limit).
127+ - **Relaunch:** Restart a stopped/errored Mysis.
128+ - **Force Stop:** Immediately halt a Mysis.
129+ - **Delete:** Remove Mysis and optionally purge its memories.
130+ - **Broadcast Message:** Send a message/objective to all Myses.
131+ - **Direct Message:** Send a message to a specific Mysis.
132+ - **Configure Mysis:** Set model/provider per Mysis (Ollama or OpenCode Zen).
133+- **Recovery:** On application restart, Myses are rehydrated from SQLite in `stopped` state; user must explicitly relaunch.
134134
135135 ## Keyboard Shortcuts
136136
137137 Minimal set matching TUI controls:
138138 - `q` / `Ctrl+C` — Quit
139-- `n` — New agent
140-- `d` — Delete selected agent
141-- `r` — Relaunch selected agent
142-- `s` — Stop selected agent
139+- `n` — New Mysis
140+- `d` — Delete selected Mysis
141+- `r` — Relaunch selected Mysis
142+- `s` — Stop selected Mysis
143143 - `b` — Broadcast message to all
144-- `m` — Message selected agent
145-- `c` — Configure selected agent
146-- `Tab` / `Shift+Tab` — Navigate between agents
144+- `m` — Message selected Mysis
145+- `c` — Configure selected Mysis
146+- `Tab` / `Shift+Tab` — Navigate between Myses
147147 - `?` — Help overlay
148148
149149 ## Build & Operations
@@ -171,7 +171,7 @@ Minimal set matching TUI controls:
171171 - `internal/provider`: LLM provider implementations (Ollama, OpenCode Zen).
172172 - `internal/config`: Configuration loading (TOML + ENV merge).
173173 - `internal/store`: SQLite repository layer and migrations.
174-- **Concurrency Model:** Each agent operates in an isolated goroutine. State updates are pushed to the TUI via a central command/message bus to ensure thread-safety.
174+- **Concurrency Model:** Each Mysis operates in an isolated goroutine. State updates are pushed to the TUI via a central command/message bus to ensure thread-safety.
175175 - **Interface-Driven:** All external dependencies (LLMs, MCP servers) must be hidden behind interfaces to facilitate unit testing and future-proofing.
176176 - **Testing:** Mandatory unit tests for `internal/core` logic. TUI components should be tested using `bubbletea`'s testing utilities. Aim for above 80% test coverage. No flaky tests.
177177 - **Warnings and Errors** Fix all that you see, even if it's from your current changes.