Tighten Playground page and promote it in sidebar

Editorial polish on the v0.35.0 rewrite:
- Collapse the seven Key capabilities h3s into a bulleted list so the
  ToC stops carrying one-line subsections.
- Fix the intro's spaced-hyphen parenthetical and trailing-preposition
  catch-all.
- Split step 3 in Getting started so "After that" no longer dangles.
- Drop the redundant rejected-file toast list and the self-explanatory
  composer-placeholder block.
- "Configure client configuration" -> "Set up client configuration"
  in Next steps.

Move the Playground page above CLI access in the ToolHive UI sidebar
now that it's a primary workspace, not a test harness.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: danbarr

docs/toolhive/guides-ui/playground.mdx

@@ -8,54 +8,36 @@ description:
 import useBaseUrl from '@docusaurus/useBaseUrl';
 import ThemedImage from '@theme/ThemedImage';
 
-The ToolHive playground is a chat workspace for AI agents - built-in or your
-own - that runs inside the desktop app. Each thread runs against an agent that
-sets the system prompt and a default toolset. You can then give that agent
-specific MCP tools and skills, and chat with it directly. Testing MCP servers is
-one workflow the playground supports, alongside building skills, managing your
-ToolHive setup through chat, and any other chat-driven task you want an agent
-for.
+The ToolHive playground is a chat workspace for built-in or custom AI agents
+that runs inside the desktop app. Each thread runs against an agent that sets
+the system prompt and a default toolset. You can then give that agent specific
+MCP tools and skills, and chat with it directly. Testing MCP servers is one
+workflow the playground supports, alongside building skills and managing your
+ToolHive setup through chat.
 
 ## Key capabilities
 
-### Built-in and custom agents
-
-Switch between the built-in **ToolHive Assistant** and **Skill Engineer**
-agents, or create your own with a custom name, description, and system prompt.
-See [Choose an agent for a thread](#choose-an-agent-for-a-thread).
-
-### Per-thread context
-
-Each thread keeps its own agent, model, MCP tool selection, and skill selection,
-so switching threads doesn't reshuffle your setup. See
-[Manage chat threads](#manage-chat-threads).
-
-### Conversational ToolHive management
-
-The default ToolHive Assistant uses a built-in MCP server (`toolhive mcp`) to
-manage your other MCP servers through chat: list servers, check status, start or
-stop them, and view logs without leaving the conversation.
-
-### Detailed interaction logs
-
-See tool calls, parameters, execution status, response data, and timing inline
-in the chat so you can verify exactly what an agent is doing.
-
-### Message actions
-
-Copy any message, edit and rewind a previous user message, or queue a follow-up
-while a response is still streaming. See
-[Work with chat messages](#work-with-chat-messages).
-
-### Per-message cost
-
-For paid providers, see an estimated USD cost next to the token totals on each
-assistant message. See [See per-message cost](#see-per-message-cost).
-
-### Attachments
-
-Send images and PDFs alongside your prompt. See
-[Attach files to a message](#attach-files-to-a-message).
+- **Built-in and custom agents**: switch between the built-in **ToolHive
+  Assistant** and **Skill Engineer** agents, or create your own with a custom
+  name, description, and system prompt. See
+  [Choose an agent for a thread](#choose-an-agent-for-a-thread).
+- **Per-thread settings**: each thread keeps its own agent, model, MCP tool
+  selection, and skill selection, so switching threads doesn't reshuffle your
+  setup.
+- **Conversational ToolHive management**: the default agent uses a built-in MCP
+  server (`toolhive mcp`) to list, start, stop, and inspect your other MCP
+  servers from the chat. See
+  [Manage MCP servers through conversation](#manage-mcp-servers-through-conversation).
+- **Inline tool calls**: see tool calls, parameters, status, response data, and
+  timing in the chat so you can verify exactly what an agent is doing.
+- **Message actions**: copy any message, edit and rewind a previous user
+  message, or queue a follow-up while a response is still streaming. See
+  [Work with chat messages](#work-with-chat-messages).
+- **Per-message cost**: see an estimated USD cost next to the token totals on
+  each assistant message for paid providers. See
+  [See per-message cost](#see-per-message-cost).
+- **Attachments**: send images and PDFs alongside your prompt. See
+  [Attach files to a message](#attach-files-to-a-message).
 
 ## Getting started
 
@@ -78,10 +60,10 @@ To start using the playground:
    - **OpenRouter**: Add OpenRouter API key for access to multiple model
      providers
 
-3. **Start a thread**: Click **New chat** in the sidebar. New threads open with
-   the **ToolHive Assistant** agent the first time you use the playground, and
-   inherit the agent, model, MCP tool selection, and skill selection from the
-   thread you used most recently after that.
+3. **Start a thread**: Click **New chat** in the sidebar. The first time you use
+   the playground, new threads open with the **ToolHive Assistant** agent. After
+   that, new threads inherit the agent, model, MCP tool selection, and skill
+   selection from your most recently used thread.
 
 4. **Pick an agent (optional)**: Use the agent selector in the chat toolbar to
    switch to **Skill Engineer**, a custom agent, or open **Manage agents** to
@@ -277,35 +259,8 @@ message:
 - **PDFs** show as `📎 <FILE_NAME>` with a **Download** link so you can save the
   original file.
 
-If a file is rejected, the playground shows a toast that explains why:
-
-- When you exceed the per-message limit:
-
-  > You reached the maximum number of files
-  >
-  > You can only upload up to 5 files
-
-- When a file is over 10 MB:
-
-  > File size too large
-  >
-  > The file size must be less than 10MB
-
-- When a file isn't an image or a PDF:
-
-  > File type not supported
-  >
-  > Only images and PDFs are supported
-
-The composer placeholder reflects the playground state:
-
-- Before you select a model:
-
-  > Select an AI model to get started
-
-- After you select a model:
-
-  > Type your message...
+If a file exceeds these limits or isn't a supported type, the playground rejects
+it and shows a notification explaining why.
 
 ## Example workflows
 
@@ -413,8 +368,8 @@ details on skill formats and how to install or build your own.
 
 - Browse the [Skills](./skills.mdx) section to install or build skills you can
   enable in a thread
-- Configure [client configuration](./client-configuration.mdx) to connect
-  ToolHive to external AI applications
+- Set up [client configuration](./client-configuration.mdx) to connect ToolHive
+  to external AI applications
 - Set up [secrets management](./secrets-management.mdx) for secure handling of
   API keys and tokens
 - Explore [network isolation](./network-isolation.mdx) for enhanced security

sidebars.ts

@@ -75,8 +75,8 @@ const sidebars: SidebarsConfig = {
             'toolhive/guides-ui/skills-manage',
           ],
         },
-        'toolhive/guides-ui/cli-access',
         'toolhive/guides-ui/playground',
+        'toolhive/guides-ui/cli-access',
       ],
     },