tweaks

Author: xingyaoww

sdk/guides/agent-server/api-sandbox.mdx

@@ -181,6 +181,6 @@ All agent execution happens on the remote runtime infrastructure.
 
 ## Next Steps
 
-- **[Docker Sandboxed Server](/sdk/guides/agent-server/docker-sandboxed-server)** - Self-hosted alternative
-- **[Local Agent Server](/sdk/guides/agent-server/local-agent-server)** - Development setup
-- **[Agent Server Package Architecture](/sdk/arch/agent-server-package)** - Architecture and design decisions
+- **[Docker Sandboxed Server](/sdk/guides/agent-server/docker-sandboxed-server)**
+- **[Local Agent Server](/sdk/guides/agent-server/local-agent-server)**
+- **[Agent Server Package Architecture](/sdk/arch/agent-server-package)**

sdk/guides/agent-server/docker-sandbox.mdx

@@ -574,6 +574,7 @@ Read the API Reference [here](/sdk/guides/agent-server/api-reference/desktop/get
 
 ## Next Steps
 
-- API Sandboxed Server: /sdk/guides/agent-server/api-sandbox
-- Local Agent Server: /sdk/guides/agent-server/local-server
-- Agent Server Overview: /sdk/guides/agent-server/overview
+- **[Local Agent Server](/sdk/guides/agent-server/local-server)**
+- **[Agent Server Overview](/sdk/guides/agent-server/overview)**
+- **[API Sandboxed Server](/sdk/guides/agent-server/api-sandbox)** - Connect to hosted API service
+- **[Agent Server Package Architecture](/sdk/arch/agent-server-package)** - Architecture and design decisions

sdk/guides/agent-server/overview.mdx

@@ -148,11 +148,9 @@ Switching from local to remote is just a matter of swapping the workspace class
 
 Explore different deployment options:
 
-- **[Local Agent Server](/sdk/guides/agent-server/local-agent-server)** - Development setup
-- **[Docker Sandboxed Server](/sdk/guides/agent-server/docker-sandboxed-server)** - Self-hosted production
-- **[API Sandboxed Server](/sdk/guides/agent-server/api-sandboxed-server)** - Managed hosting
-- **[Browser with Docker](/sdk/guides/agent-server/browser-with-docker)** - Web automation
-- **[VS Code with Docker](/sdk/guides/agent-server/vscode-with-docker)** - Code editing
+- **[Local Agent Server](/sdk/guides/agent-server/local-agent-server)**
+- **[Docker Sandboxed Server](/sdk/guides/agent-server/docker-sandboxed-server)**
+- **[API Sandboxed Server](/sdk/guides/agent-server/api-sandboxed-server)**
 
 For architectural details:
 - **[Agent Server Package Architecture](/sdk/arch/agent-server-package)** - Remote execution architecture and deployment

sdk/guides/custom-tools.mdx

@@ -17,7 +17,7 @@ tools = get_default_tools()
 agent = Agent(llm=llm, tools=tools)
 ```
 
-See [Tools Overview](/sdk/arch/tools/overview) for the complete list of available tools.
+See [Tools Package Architecture](/sdk/arch/tools-package) for the complete list of available tools and design philosophy.
 
 ## Understanding the Tool System
 
@@ -27,7 +27,7 @@ The SDK's tool system is built around three core components:
 2. **Observation** - Defines output data (what the tool returns)
 3. **Executor** - Implements the tool's logic (what the tool does)
 
-These components are tied together by a **ToolDefinition** that registers the tool with the agent. For architectural details and advanced usage patterns, see [Tool System Architecture](/sdk/arch/sdk/tool).
+These components are tied together by a **ToolDefinition** that registers the tool with the agent. For architectural details and design principles, see [SDK Package Architecture - Tool System](/sdk/arch/sdk-package#4-tool-system---typed-capabilities).
 
 ## Creating a Custom Tool
 
@@ -308,5 +308,6 @@ Create custom tools when you need to:
 
 ## Next Steps
 
-- **[Tool System Architecture](/sdk/arch/sdk/tool)** - Deep dive into the tool system
+- **[SDK Package Architecture](/sdk/arch/sdk-package)** - Deep dive into the tool system and other SDK components
+- **[Tools Package Architecture](/sdk/arch/tools-package)** - Built-in tools design philosophy
 - **[Model Context Protocol (MCP) Integration](/sdk/guides/mcp)** - Use Model Context Protocol servers

sdk/guides/mcp.mdx

@@ -242,6 +242,6 @@ mcp_config = {
 
 ## Next Steps
 
-- **[MCP Architecture](/sdk/arch/sdk/mcp)** - Technical details and internals
+- **[SDK Package Architecture - MCP](/sdk/arch/sdk-package#8-mcp---model-context-protocol)** - Technical details and design decisions
 - **[Custom Tools](/sdk/guides/custom-tools)** - Creating native SDK tools
 - **[Security Analyzer](/sdk/guides/security)** - Securing tool usage