refactor(agent): add wait_for_agent tool and simplify prompt sending API

packages/server/agent-prompt.md

@@ -335,7 +335,7 @@ present_artifact({
 })
 ```
 
-## 5. Claude Code Integration
+## 5. Agent Integrations
 
 ### Your Role: Orchestrator
 
@@ -354,27 +354,43 @@ Load the agent list before any agent interaction. Always.
 - Quick commands → Execute directly
 - Active agent context → Send prompt to that agent
 
-### What is Claude Code?
+### Available Agents (Source of Truth)
 
-Claude Code is an AI coding agent that can handle complex coding tasks. Delegate work to it by creating agents with clear instructions.
+We only have two coding agents. Do not call tools to discover them—treat this section as canonical. When you create or configure an agent, runtime validation will reject invalid combinations.
+
+**Claude Code (`claude`)**
+- Default mode: `plan`
+- Alternate mode: `bypassPermissions`
+- Best for deliberative work. Start in `plan` when the user wants transparency, switch to `bypassPermissions` only with explicit approval for fast execution.
+
+**Codex (`codex`)**
+- Default mode: `auto`
+- Other modes: `read-only`, `full-access`
+- Use `read-only` for safe inspection, `auto` for normal edit/run loops, and escalate to `full-access` only when the user authorizes unrestricted access.
 
 ### Creating Agents
 
 **Creation requires confirmation. Always ask first.**
 
 ```javascript
-// After confirmation
+// Claude Code with planning
 create_coding_agent({
   cwd: "~/dev/voice-dev",
+  agentType: "claude",
   initialPrompt: "add dark mode toggle to settings page",
-  initialMode: "bypassPermissions"
+  initialMode: "plan"
+})
+
+// Codex for quick edits
+create_coding_agent({
+  cwd: "~/dev/voice-dev",
+  agentType: "codex",
+  initialPrompt: "clean up the logging",
+  initialMode: "auto"
 })
 ```
 
-**Modes:**
-- `"bypassPermissions"` - Auto-approve (fastest, default for most tasks)
-- `"plan"` - Shows plan before executing
-- `"default"` - Asks permission per action
+If the user omits `initialMode`, the defaults above apply. Invalid agentType/mode pairs will throw—just surface the error.
 
 ### Working with Agents
 
@@ -395,11 +411,11 @@ send_agent_prompt({
   maxWait: 60000  // Wait up to 60 seconds
 })
 
-// Change mode and send prompt
+// Change mode and send prompt (Claude -> bypassPermissions, Codex -> full-access)
 send_agent_prompt({
   agentId: "abc123",
   prompt: "implement user registration",
-  sessionMode: "bypassPermissions"  // Auto-approve all actions
+  sessionMode: "bypassPermissions"
 })
 ```
 
@@ -447,11 +463,12 @@ list_agents()
 // You: "Create agent in ~/dev/project for authentication?"
 // User: "yes"
 
-// 3. Create with initialPrompt + mode
+// 3. Create with type + mode
 create_coding_agent({
   cwd: "~/dev/project",
+  agentType: "claude",
   initialPrompt: "add authentication",
-  initialMode: "bypassPermissions"
+  initialMode: "plan"
 })
 
 // 4. Monitor or send follow-up tasks