docs: add inline GitHub source links per guidelines (agent-server.mdx)\n\nCo-authored-by: openhands <openhands@all-hands.dev>

Author: enyst

sdk/arch/agent-server.mdx

@@ -11,11 +11,11 @@ Source: [`openhands-agent-server/`](https://github.com/OpenHands/software-agent-
 
 The server provides:
 
-1. **Conversation lifecycle API** - Create, run, pause, delete conversations (source: openhands/agent_server/conversation_router.py)
-2. **Event access** - Search, count, get, batch-get conversation events; WebSocket event streaming (source: openhands/agent_server/event_router.py, openhands/agent_server/sockets.py)
-3. **Execution utilities** - Start and monitor bash commands; file upload/download; simple Git ops (source: openhands/agent_server/bash_router.py, file_router.py, git_router.py)
-4. **Tool registry listing** - Introspect available tools on the server (source: openhands/agent_server/tool_router.py)
-5. **Server details** - Health, alive, and server info endpoints (source: openhands/agent_server/server_details_router.py)
+1. **Conversation lifecycle API** - Create, run, pause, delete conversations ([conversation_router.py](https://github.com/OpenHands/software-agent-sdk/blob/HEAD/openhands-agent-server/openhands/agent_server/conversation_router.py))
+2. **Event access** - Search, count, get, batch-get conversation events; WebSocket event streaming ([event_router.py](https://github.com/OpenHands/software-agent-sdk/blob/HEAD/openhands-agent-server/openhands/agent_server/event_router.py), [sockets.py](https://github.com/OpenHands/software-agent-sdk/blob/HEAD/openhands-agent-server/openhands/agent_server/sockets.py))
+3. **Execution utilities** - Start and monitor bash commands; file upload/download; simple Git ops ([bash_router.py](https://github.com/OpenHands/software-agent-sdk/blob/HEAD/openhands-agent-server/openhands/agent_server/bash_router.py), [file_router.py](https://github.com/OpenHands/software-agent-sdk/blob/HEAD/openhands-agent-server/openhands/agent_server/file_router.py), [git_router.py](https://github.com/OpenHands/software-agent-sdk/blob/HEAD/openhands-agent-server/openhands/agent_server/git_router.py))
+4. **Tool registry listing** - Introspect available tools on the server ([tool_router.py](https://github.com/OpenHands/software-agent-sdk/blob/HEAD/openhands-agent-server/openhands/agent_server/tool_router.py))
+5. **Server details** - Health, alive, and server info endpoints ([server_details_router.py](https://github.com/OpenHands/software-agent-sdk/blob/HEAD/openhands-agent-server/openhands/agent_server/server_details_router.py))
 
 ## Architecture
 
@@ -57,13 +57,13 @@ flowchart TB
 ```
 
 - App construction and route wiring happen in [`api.py`](https://github.com/OpenHands/software-agent-sdk/blob/main/openhands-agent-server/openhands/agent_server/api.py): the app mounts a single `/api` router that includes conversation, event, tool, bash, git, file, vscode, and desktop routers.
-- Event and VSCode/Desktop services are initialized in the lifespan context (source: openhands/agent_server/api.py).
+- Event and VSCode/Desktop services are initialized in the lifespan context ([api.py](https://github.com/OpenHands/software-agent-sdk/blob/HEAD/openhands-agent-server/openhands/agent_server/api.py)).
 
 ## Authentication
 
-- HTTP requests: header `X-Session-API-Key` if session keys are configured (source: openhands/agent_server/dependencies.py, `create_session_api_key_dependency`)
-- WebSocket: query parameter `session_api_key` (source: openhands/agent_server/dependencies.py, sockets.py)
-- Configuration source: environment-driven `Config` (source: openhands/agent_server/config.py)
+- HTTP requests: header `X-Session-API-Key` if session keys are configured ([dependencies.py](https://github.com/OpenHands/software-agent-sdk/blob/HEAD/openhands-agent-server/openhands/agent_server/dependencies.py))
+- WebSocket: query parameter `session_api_key` ([dependencies.py](https://github.com/OpenHands/software-agent-sdk/blob/HEAD/openhands-agent-server/openhands/agent_server/dependencies.py), [sockets.py](https://github.com/OpenHands/software-agent-sdk/blob/HEAD/openhands-agent-server/openhands/agent_server/sockets.py))
+- Configuration source: environment-driven `Config` ([config.py](https://github.com/OpenHands/software-agent-sdk/blob/HEAD/openhands-agent-server/openhands/agent_server/config.py))
 
 ```mermaid
 flowchart LR
@@ -75,7 +75,7 @@ flowchart LR
 
 All REST endpoints are mounted under `/api` unless noted.
 
-- Conversations (source: openhands/agent_server/conversation_router.py)
+- Conversations ([conversation_router.py](https://github.com/OpenHands/software-agent-sdk/blob/HEAD/openhands-agent-server/openhands/agent_server/conversation_router.py))
   - `GET /api/conversations/search` – list
   - `GET /api/conversations/count` – count
   - `GET /api/conversations/{conversation_id}` – get
@@ -91,43 +91,43 @@ All REST endpoints are mounted under `/api` unless noted.
   - `POST /api/conversations/{id}/security_analyzer` – set analyzer
   - `POST /api/conversations/{id}/ask_agent` – question-only (no state change)
 
-- Events (source: openhands/agent_server/event_router.py)
+- Events ([event_router.py](https://github.com/OpenHands/software-agent-sdk/blob/HEAD/openhands-agent-server/openhands/agent_server/event_router.py))
   - `GET /api/conversations/{conversation_id}/events/search`
   - `GET /api/conversations/{conversation_id}/events/count`
   - `GET /api/conversations/{conversation_id}/events/{event_id}`
   - `GET /api/conversations/{conversation_id}/events?event_ids=...`
   - `POST /api/conversations/{conversation_id}/events` – send `Message`
 
-- Bash (source: openhands/agent_server/bash_router.py)
+- Bash ([bash_router.py](https://github.com/OpenHands/software-agent-sdk/blob/HEAD/openhands-agent-server/openhands/agent_server/bash_router.py))
   - `POST /api/bash/start_bash_command`
   - `POST /api/bash/execute_bash_command`
   - `GET /api/bash/bash_events/search|{event_id}|` (list/get)
   - `DELETE /api/bash/bash_events` – clear
 
-- Files (source: openhands/agent_server/file_router.py)
+- Files ([file_router.py](https://github.com/OpenHands/software-agent-sdk/blob/HEAD/openhands-agent-server/openhands/agent_server/file_router.py))
   - `POST /api/file/upload/{path}` – upload to absolute path
   - `GET /api/file/download/{path}` – download absolute path
   - `GET /api/file/download-trajectory/{conversation_id}` – zip state
 
-- Git (source: openhands/agent_server/git_router.py)
+- Git ([git_router.py](https://github.com/OpenHands/software-agent-sdk/blob/HEAD/openhands-agent-server/openhands/agent_server/git_router.py))
   - `GET /api/git/changes/{path}`
   - `GET /api/git/diff/{path}`
 
-- Tools (source: openhands/agent_server/tool_router.py)
+- Tools ([tool_router.py](https://github.com/OpenHands/software-agent-sdk/blob/HEAD/openhands-agent-server/openhands/agent_server/tool_router.py))
   - `GET /api/tools/` – list registered tools
 
-- Server details (source: openhands/agent_server/server_details_router.py)
+- Server details ([server_details_router.py](https://github.com/OpenHands/software-agent-sdk/blob/HEAD/openhands-agent-server/openhands/agent_server/server_details_router.py))
   - `GET /alive`, `GET /health`, `GET /server_info`
 
-- WebSockets (source: openhands/agent_server/sockets.py)
+- WebSockets ([sockets.py](https://github.com/OpenHands/software-agent-sdk/blob/HEAD/openhands-agent-server/openhands/agent_server/sockets.py))
   - `WS /sockets/events/{conversation_id}?session_api_key=...&resend_all=bool`
   - `WS /sockets/bash-events?session_api_key=...&resend_all=bool`
 
 ## Design Notes
 
-- The server itself does not manage Docker containers. Containerization and lifecycle are handled by workspace implementations such as `DockerWorkspace` in the `openhands-workspace` package, which run this server inside the container and connect via HTTP (source: openhands-workspace/openhands/workspace/docker/workspace.py).
-- Request/response models are Pydantic classes in `models.py` (source: openhands/agent_server/models.py).
-- Security: schema-level API key checks, path validation for file ops (absolute path enforcement), and typed payloads (sources: dependencies.py, file_router.py).
+- The server itself does not manage Docker containers. Containerization and lifecycle are handled by workspace implementations such as `DockerWorkspace` in the `openhands-workspace` package, which run this server inside the container and connect via HTTP ([docker/workspace.py](https://github.com/OpenHands/software-agent-sdk/blob/HEAD/openhands-workspace/openhands/workspace/docker/workspace.py)).
+- Request/response models are Pydantic classes in `models.py` ([models.py](https://github.com/OpenHands/software-agent-sdk/blob/HEAD/openhands-agent-server/openhands/agent_server/models.py)).
+- Security: schema-level API key checks, path validation for file ops (absolute path enforcement), and typed payloads ([dependencies.py](https://github.com/OpenHands/software-agent-sdk/blob/HEAD/openhands-agent-server/openhands/agent_server/dependencies.py), [file_router.py](https://github.com/OpenHands/software-agent-sdk/blob/HEAD/openhands-agent-server/openhands/agent_server/file_router.py)).
 
 ## Component Relationships