Repository navigation
[Agents] Restructure tools and MCP pages, rename File system to Workspace - #35056
mattzcarey wants to merge 4 commits into
Conversation
AI Review✅ Reviewed 👉 Fix in your agent 👈Fix the following review findings in PR #35056 (https://github.com/cloudflare/cloudflare-docs/pull/35056).
Before making changes, review each finding and present a brief summary table:
- For each finding, state whether you agree, disagree, or need clarification.
- If you disagree, explain why.
- If you need clarification before deciding, ask those questions.
- Then share your plan for which issues to tackle and in what order.
After triaging, follow this order:
1. Post a comment on this PR for any findings you are skipping, with the finding ID and your reasoning.
2. Then commit the fixes for the legitimate findings.
The comment must come before the commit because the next review reads PR comments.
## Style Guide
- S-1af32be9 | src/content/docs/agents/model-context-protocol/apis/client-api.mdx:200 | Semicolon joins two independent clauses
The bullet uses a semicolon to join two independent clauses (`Server requires OAuth` and `redirect user to authUrl`). The writing-style rules require breaking semicolon-joined independent clauses into separate sentences.
- S-0d39f36b | src/content/docs/agents/tools/web-search.mdx:20 | Contraction `you're` in prose
The writing style rules require removing contractions from prose. The added line contains `you're` in plain prose, not inside a code block or backtick span.Style Guide
Commands
|
Review coverage✅ All 4 ownership areas are covered. ✅ 4 areas already covered
CODEOWNERS mappings for displayed areas (4)
|
|
This PR changes current filenames or deletes current files. Make sure you have redirects set up to cover the following paths:
|
🚀 Deploying Preview to Cloudflare 🚀Preview URL: https://docs-agents-tools-restructure.previews.developers.cloudflare.com (commit dec0f20)This URL reflects your latest Preview deploymentPreview Deployments by commit
|
|
|
||
| ## Connect a workspace | ||
|
|
||
| OpenCode's Workers profile has no local filesystem or process, so its `read`, `write`, `edit`, `patch`, `glob`, `grep`, and `shell` tools cannot run in a Durable Object. To give OpenCode files that survive restarts, register the tools of a [Cloudflare Computer](/agents/tools/workspace/) `Workspace` through a plugin. The plugin removes OpenCode's local tools and adds the workspace tools from `createPiTools()`. Refer to [Workspace tools with OpenCode](/agents/tools/workspace/#opencode) for the plugin. |
There was a problem hiding this comment.
workers profile makes so sense. reword this without using jargon that makes. no sense
|
CI run failed: build logs |
Renames the File system page to Workspace (
/agents/tools/workspace/), adds a tools-and-adapters table to the Tools index, and shows each tool with Think as well as Pi, the AI SDK, and TanStack AI.tools/filesystembecomestools/workspace, and the MPP page moves fromtools/payments/mpp-charge-for-http-contentintotools/payments/mpp/. Both have redirects, and links across the Agents docs point to the new paths.@cloudflare/computer0.10 (CodemodeBackend,codemode:*host modules).ToolRegistrationbuilt with@earendil-works/pi-schema.agentsmain after fix(mcp): re-authorization and connection failures for the MCP client agents#2782 and Improve forced redirect example #2856: a failed server staysfaileduntilreconnectMcpServer(id)(orconnectToServer(id)on a standaloneMCPClientManager), refused authorization skips retries, requests that need the user to authorize again throwMCPAuthorizationRequiredErrorwith a link, unknown servers throwMCPConnectionNotFoundError, andtransport.headersare stored and sent on restore. The OAuth guide retries withreconnectMcpServer()instead of removing and re-adding the server. MCP package pins move to@modelcontextprotocol/clientand/server2.4.0 and/sdk1.32.2, and the capability page mentionsclientMetadataUrlfor Client ID Metadata Documents.MCPClientManagerreference and points to theMCPClientManagercapability page. The MCP tools page lists which harnesses can use MCP tools.flowchart LR core["Tool core"] --> think["Think: getTools()"] core --> pi["Pi: ToolRegistration"] core --> aisdk["AI SDK: tool()"] core --> tanstack["TanStack AI"]Code samples typecheck against
agents@0.33.0,@cloudflare/computer@0.10.0, and Pi 1.5. Internal links resolve, the pages compile as MDX, andbin/validate-redirects.tspasses. Replaces #34724.The MCP failure and re-authorization changes ship in
agents@0.34.0(cloudflare/agents#2808).