Merge pull request #150 from spacedriveapp/feat/multi-agent-communication-graph

Multi-agent communication graph

Author: jamiepine

docs/bun.lock

@@ -89,19 +89,19 @@ The `direction` label on token counts distinguishes input tokens, output (comple
 
 Token usage and estimated costs are tracked per-request. To see total estimated spend:
 
-```promql
+```text
 sum(spacebot_llm_estimated_cost_dollars) by (agent_id)
 ```
 
 To see spend rate over the last hour:
 
-```promql
+```text
 sum(rate(spacebot_llm_estimated_cost_dollars[1h])) by (agent_id, model) * 3600
 ```
 
 To see token throughput:
 
-```promql
+```text
 sum(rate(spacebot_llm_tokens_total[5m])) by (direction)
 ```
 

docs/content/docs/(core)/agents.mdx

@@ -488,3 +488,17 @@ Persistent knowledge nodes with per-agent read/write permissions. Separate desig
 **Auditable communication.** Every inter-agent message is persisted in `conversation_messages` with full metadata. The dashboard shows the communication graph with live activity. There are no hidden side channels — everything flows through the link system.
 
 **Foundation for agent teams.** Once links and the topology API exist, the React Flow editor turns agent wiring into a visual, drag-and-drop experience. Non-technical users can design agent organizations without editing config files.
+
+## Known Issues
+
+### Webchat / Portal naming mismatch
+
+The webchat messaging adapter registers as `"webchat"` (`WebChatAdapter::name()` in `messaging/webchat.rs`), but the frontend constructs session IDs with the prefix `"portal"` (`useWebChat.ts`: `portal:chat:${agentId}`). The backend passes the frontend's `session_id` through as the `conversation_id` unchanged, so `extract_platform()` derives `platform = "portal"` from the conversation_id prefix.
+
+This means two different names refer to the same thing:
+- **Adapter source** (`message.source`): `"webchat"` — used for outbound routing
+- **Platform / conversation_id prefix**: `"portal"` — used for display, channel store
+
+The display name is hardcoded to `"portal:chat"` in `extract_display_name()`. The platform badge shows `"portal"` with no custom icon or color (falls through to gray default).
+
+These should be unified under a single name. Either rename the adapter to `"portal"`, change the frontend session prefix to `"webchat:chat:{agentId}"`, or pick a third name. Needs a decision before addressing.