- Add name, position, color fields to agents (backend + frontend)

- Replace 3D character buttons with styled AgentButton components
- Add draggable/resizable floating chat panel (no Dialog overlay)
- Collapsible session history sidebar, closed by default
- 3D GLTF character renders on top of clicked agent button
- Context-aware chat with page location indicator
- Agent Island config in AI Settings with GM pre-selected
- Workspace teardown endpoint for vector DB cleanup
- Color picker and position field in agent config modal

Author: freacatt

agent-platform/api/__pycache__/agents.cpython-312.pyc

@@ -39,6 +39,8 @@ class AgentResponse(BaseModel):
     user_id: str
     name: str
     type: str
+    position: str = ""
+    color: str = ""
     model_mode: str
     model_provider: str | None = None
     model_name: str | None = None
@@ -57,6 +59,8 @@ class AgentCreateRequest(BaseModel):
     workspace_id: str
     name: str
     type: str = "custom"
+    position: str = ""
+    color: str = ""
     model_mode: str = "auto"
     model_provider: str | None = None
     model_name: str | None = None
@@ -70,6 +74,8 @@ class AgentCreateRequest(BaseModel):
 
 class AgentUpdateRequest(BaseModel):
     name: str | None = None
+    position: str | None = None
+    color: str | None = None
     model_mode: str | None = None
     model_provider: str | None = None
     model_name: str | None = None
@@ -168,6 +174,8 @@ def _to_response(agent_data: dict) -> AgentResponse:
         user_id=agent_data.get("userId", ""),
         name=agent_data.get("name", ""),
         type=agent_data.get("type", "custom"),
+        position=agent_data.get("position", ""),
+        color=agent_data.get("color", ""),
         model_mode=agent_data.get("modelMode", "auto"),
         model_provider=agent_data.get("modelProvider"),
         model_name=agent_data.get("modelName"),

agent-platform/api/__pycache__/workspaces.cpython-312.pyc

@@ -3,6 +3,8 @@
 from fastapi import APIRouter, Depends, status
 from pydantic import BaseModel
 
+from google.cloud.firestore_v1.base_query import FieldFilter
+
 from core.firestore import get_firestore_client
 from core.exceptions import AppError, NotFoundError
 from services.auth import AuthedUser, get_current_user
@@ -106,6 +108,47 @@ def setup_workspace(
     )
 
 
+@router.delete("/{workspace_id}/teardown", status_code=status.HTTP_204_NO_CONTENT)
+def teardown_workspace(
+    workspace_id: str,
+    current_user: AuthedUser = Depends(get_current_user),
+) -> None:
+    """Clean up agent-platform resources for a workspace being deleted.
+
+    Deletes: all agents, all sessions, and the Qdrant collection.
+    Called by the frontend before deleting the workspace doc from Firestore.
+    """
+    db = get_firestore_client()
+    policy = PolicyEngine(db)
+    policy.assert_workspace_owner(current_user.firebase_uid, workspace_id)
+
+    # 1. Delete all sessions for this workspace
+    session_docs = (
+        db.collection("sessions")
+        .where(filter=FieldFilter("workspaceId", "==", workspace_id))
+        .stream()
+    )
+    for doc in session_docs:
+        doc.reference.delete()
+
+    # 2. Delete all agents for this workspace
+    agent_docs = (
+        db.collection("agents")
+        .where(filter=FieldFilter("workspaceId", "==", workspace_id))
+        .stream()
+    )
+    for doc in agent_docs:
+        doc.reference.delete()
+
+    # 3. Delete Qdrant collection (best-effort)
+    try:
+        qdrant = get_qdrant_client()
+        collection_name = f"workspace_{workspace_id}"
+        qdrant.delete_collection(collection_name)
+    except Exception:
+        logger.warning("Failed to delete Qdrant collection for workspace %s (may not exist)", workspace_id)
+
+
 @router.get("/{workspace_id}", response_model=WorkspaceResponse)
 def get_workspace(
     workspace_id: str,

agent-platform/api/agents.py

@@ -97,7 +97,7 @@ agent-platform/
 
 ### agents.py — Agent Management
 - CRUD operations on `agents` Firestore collection
-- `create_default_gm_agent()`: Creates General Manager agent (isDefault=true, isOrchestrator=true)
+- `create_default_gm_agent()`: Creates GM agent named "Jeana" with position "General Manager" (isDefault=true, isOrchestrator=true)
 - Agent fields: name, type (gm|custom), modelMode, modelProvider, modelName, context (system prompt), skills, appAccess, mcpServers, orchestratorConfig
 - Cannot delete default agents
 
@@ -327,6 +327,7 @@ POST /workspaces/setup {workspace_id, name}
 ### agents/{agentId}
 ```
 workspaceId, userId, name, type ("gm"|"custom")
+position (string, e.g. "General Manager"), color (hex string, e.g. "#6366f1")
 modelMode ("auto"|"manual"), modelProvider, modelName
 skills[], context (system prompt)
 isDefault, isOrchestrator

agent-platform/api/workspaces.py

@@ -9,8 +9,10 @@
 
 
 DEFAULT_GM_AGENT = {
-    "name": "General Manager",
+    "name": "Jeana",
     "type": "gm",
+    "position": "General Manager",
+    "color": "#a855f7",
     "modelMode": "auto",
     "modelProvider": None,
     "modelName": None,
@@ -37,6 +39,8 @@ def create_agent(db: Client, workspace_id: str, user_id: str, data: dict) -> dic
         "userId": user_id,
         "name": data.get("name", "New Agent"),
         "type": data.get("type", "custom"),
+        "position": data.get("position", ""),
+        "color": data.get("color", ""),
         "modelMode": data.get("modelMode", "auto"),
         "modelProvider": data.get("modelProvider"),
         "modelName": data.get("modelName"),
@@ -94,8 +98,9 @@ def update_agent(db: Client, agent_id: str, updates: dict) -> dict:
         raise NotFoundError("agent", agent_id)
 
     allowed_fields = {
-        "name", "modelMode", "modelProvider", "modelName", "skills", "context",
-        "isOrchestrator", "appAccess", "mcpServers", "orchestratorConfig",
+        "name", "position", "color", "modelMode", "modelProvider", "modelName",
+        "skills", "context", "isOrchestrator", "appAccess", "mcpServers",
+        "orchestratorConfig",
     }
     filtered = {k: v for k, v in updates.items() if k in allowed_fields}
     filtered["updatedAt"] = datetime.now(timezone.utc)

agent-platform/architecture.md

@@ -30,7 +30,9 @@ def test_get_agent(client):
     assert resp.status_code == 200
     data = resp.json()
     assert data["id"] == gm_id
-    assert data["name"] == "General Manager"
+    assert data["name"] == "Jeana"
+    assert data["position"] == "General Manager"
+    assert data["color"] == "#a855f7"
 
 
 def test_create_custom_agent(client):

agent-platform/services/__pycache__/agents.cpython-312.pyc

@@ -43,7 +43,7 @@ app/src/
 ├── components/                 # Reusable UI components
 │   ├── ui/                     # Generic Shadcn primitives (button, card, dialog, accordion, etc.)
 │   ├── ai-elements/            # Conversation, Message, PromptInput components
-│   ├── AgentIsland/            # 3D agent bar (React Three Fiber)
+│   ├── AgentIsland/            # Floating agent bar with chat modal
 │   ├── AgentSettings/          # AgentConfigModal
 │   ├── Board/                  # PyramidBoard, Block, BlockModal
 │   ├── Chat/                   # (reserved for future chat components)
@@ -188,44 +188,47 @@ pyramids, productDefinitions, contextDocuments, directories, uiUxArchitectures,
 | Path | Page | Description |
 |------|------|-------------|
 | `/workspaces` | WorkspacesPage | Workspace list and creation |
-| `/workspace/:id/dashboard` | Dashboard | Main app selector (8 categories) |
+
+All workspace-scoped routes are nested under `/:workspaceId` using a `WorkspaceRouteSync` layout route that syncs the URL workspace ID to context.
+
+| `/:workspaceId/dashboard` | Dashboard | Main app selector (8 categories) |
 
 #### Problem Solving, Thinking and Planning (bg-indigo-600)
 | Path | Page | Description |
 |------|------|-------------|
-| `/pyramids` | PyramidsPage | Pyramid list |
-| `/pyramid/:id` | PyramidEditor | 8x8 grid editor |
-| `/diagrams` | DiagramsPage | Diagram list |
-| `/diagram/:id` | DiagramEditor | ReactFlow visual editor |
+| `/:workspaceId/pyramids` | PyramidsPage | Pyramid list |
+| `/:workspaceId/pyramid/:id` | PyramidEditor | 8x8 grid editor |
+| `/:workspaceId/diagrams` | DiagramsPage | Diagram list |
+| `/:workspaceId/diagram/:id` | DiagramEditor | ReactFlow visual editor |
 
 #### Product Design & Management (bg-teal-600 / bg-pink-600)
 | Path | Page | Description |
 |------|------|-------------|
-| `/product-definitions` | ProductDefinitionsPage | Product def list |
-| `/product-definition/:id` | ProductDefinitionEditor | Hierarchical mindmap editor |
-| `/ui-ux-architectures` | UiUxArchitecturesPage | UI/UX list |
-| `/ui-ux-architecture/:id` | UiUxArchitectureEditorPage | Theme/component/page editor |
+| `/:workspaceId/product-definitions` | ProductDefinitionsPage | Product def list |
+| `/:workspaceId/product-definition/:id` | ProductDefinitionEditor | Hierarchical mindmap editor |
+| `/:workspaceId/ui-ux-architectures` | UiUxArchitecturesPage | UI/UX list |
+| `/:workspaceId/ui-ux-architecture/:id` | UiUxArchitectureEditorPage | Theme/component/page editor |
 
 #### Knowledge Base (bg-amber-600)
 | Path | Page | Description |
 |------|------|-------------|
-| `/context-documents` | ContextDocumentsPage | Document list |
-| `/context-document/:id` | ContextDocumentEditor | Rich text editor |
-| `/directory/:id` | DirectoryDocumentsPage | Directory contents |
+| `/:workspaceId/context-documents` | ContextDocumentsPage | Document list |
+| `/:workspaceId/context-document/:id` | ContextDocumentEditor | Rich text editor |
+| `/:workspaceId/directory/:id` | DirectoryDocumentsPage | Directory contents |
 
 #### Technical (bg-purple-600 / bg-blue-600)
 | Path | Page | Description |
 |------|------|-------------|
-| `/technical-architectures` | TechnicalArchitecturesPage | Architecture list |
-| `/technical-architecture/:id` | TechnicalArchitectureEditorPage | Architecture editor |
-| `/technical-tasks` | TechnicalTaskBoard | Kanban board |
-| `/technical-task/:id` | TechnicalTaskDetail | Task detail view |
+| `/:workspaceId/technical-architectures` | TechnicalArchitecturesPage | Architecture list |
+| `/:workspaceId/technical-architecture/:id` | TechnicalArchitectureEditorPage | Architecture editor |
+| `/:workspaceId/technical-tasks` | TechnicalTaskBoard | Kanban board |
+| `/:workspaceId/technical-task/:id` | TechnicalTaskDetail | Task detail view |
 
 #### AI Apps (bg-violet-600)
 | Path | Page | Description |
 |------|------|-------------|
-| `/ai-chat` | AiChatPage | Session-based AI chat |
-| `/workspace/:id/ai-settings` | AiSettingsPage | Agent configuration |
+| `/:workspaceId/ai-chat` | AiChatPage | Session-based AI chat |
+| `/:workspaceId/ai-settings` | AiSettingsPage | Agent configuration |
 
 ---
 
@@ -445,34 +448,39 @@ agents, sessions — writes via Admin SDK (bypasses rules)
 
 ## Agent Island (3D Agent Bar)
 
-Global floating bar at center-bottom of all authenticated pages displaying workspace agents as interactive 3D characters.
+Floating glassmorphism bar at center-bottom of workspace pages. Agents rendered as blur-styled buttons with name, position, and color. Clicking an agent opens a per-agent chat modal.
 
 ### Component Tree
 ```
 AuthenticatedLayout
   └── AgentIsland (fixed bottom-center, glassmorphism)
-        └── React.lazy → AgentCharacter × N
-              └── <Canvas> (R3F)
-                    └── AgentModel (GLTF + animation cycling)
+        ├── AgentButton × N (blur/glass styled, color accent)
+        ├── "All Agents" button → /ai-chat
+        ├── "AI Settings" button → /ai-settings
+        └── AgentChatModal (Dialog with chat session)
+              └── useAgentChat hook (shared with AiChatPage)
 ```
 
 ### Files
 | File | Purpose |
 |------|---------|
-| `components/AgentIsland/AgentIsland.tsx` | Container: glassmorphism bar, lazy loading, route-based visibility |
-| `components/AgentIsland/AgentCharacter.tsx` | Per-agent 3D Canvas with GLTF model and animation cycling |
+| `components/AgentIsland/AgentIsland.tsx` | Container: glassmorphism bar, visibility logic, modal state |
+| `components/AgentIsland/AgentButton.tsx` | Per-agent blur/glass button with color, name, position, status badge |
+| `components/AgentIsland/AgentChatModal.tsx` | Dialog with session sidebar + chat area for a specific agent |
 | `components/AgentIsland/useAgentIslandAgents.ts` | Hook: fetches agents via `getAgents(workspaceId)` |
+| `components/AgentIsland/useAgentLastSessionStatus.ts` | Hook: fetches last session status per agent |
+| `hooks/useAgentChat.ts` | Extracted chat logic shared between AgentChatModal and AiChatPage |
+| `lib/agent-colors.ts` | Color palette (12 colors) + `getRandomAgentColor()` helper |
 
-### 3D Stack
-- **@react-three/fiber**: React renderer for Three.js
-- **@react-three/drei**: `useGLTF` (GLTF/Draco loading), `useAnimations` (clip management)
-- **Model**: `public/agents/gm.gltf` — shared model for all agents (Draco-compressed)
-- **Animations**: `idle`, `walk`, `happy`, `sad`, `standing_jump`, `jump_run`, `running`
+### Agent Data Model (new fields)
+- `position: string` — Agent role (e.g., "General Manager", "Designer")
+- `color: string` — Hex color from palette, used for button accent
+- Default GM agent: name "Jeana", position "General Manager", color "#6366f1"
 
 ### Behavior
-- Each agent rendered as a separate `<Canvas>` with transparent background
-- Characters overflow above the island container (upper body/head sticks out)
-- Animation cycle: `idle` → `walk` → `happy` with crossfade, staggered per agent
-- Click navigates to `/ai-chat`
-- Hidden on `/ai-chat` page, max 6 visible agents with "+N" overflow badge
-- Lazy-loaded to keep Three.js out of the initial JS bundle
+- Max 5 agents visible, configurable via `workspace.islandAgentIds` in AI Settings
+- Click agent → opens `AgentChatModal` (not navigation)
+- Right-side buttons: "All Agents" (→ /ai-chat), "AI Settings" (→ /ai-settings)
+- Status badge on agent buttons: green pulse = active session, amber = paused, none = no session
+- Hidden on `/ai-chat` page and `/workspaces` page
+- Context awareness: modal uses `useCurrentPageContext` to pass page context to agent