Skip to content

[Agents] Document @cloudflare/computer workspace - #34357

Merged
aron-cf merged 3 commits into
productionfrom
agents-computer-filesystem
Oct 15, 2026
Merged

aron-cf merged 3 commits into
productionfrom
agents-computer-filesystem

Conversation

@aron-cf

@aron-cf aron-cf commented Oct 15, 2026 •

Copy link
Copy Markdown
Contributor

Summary

Add a section on filesystem under the Tools subsection.

Screenshots (optional)

image

Documentation checklist

Add /agents/tools/filesystem/, placed above Sandbox in the Tools sidebar.
It covers adding a Cloudflare Computer workspace to a Durable Object,
giving a model the workspace file tools with createAITools(), and
optionally running JavaScript with WorkerJavaScriptBackend.
@aron-cf
aron-cf requested review from a team, irvinebroque and rita3ko as code owners October 15, 2026 11:11
@github-actions github-actions Bot added the product:agents Build and deploy AI-powered Agents on Cloudflare that can act autonomously. label Oct 15, 2026
@cloudflare-docs-bot

cloudflare-docs-bot Bot commented Oct 15, 2026 •

Copy link
Copy Markdown
Contributor

AI Review

✅ Reviewed cf8fa40 · 2 findings · incremental

👉 Fix in your agent 👈
Fix the following review findings in PR #34357 (https://github.com/cloudflare/cloudflare-docs/pull/34357).

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-0116a7d0 | src/content/docs/agents/tools/filesystem.mdx:381 | Use <TypeScriptExample> instead of a raw ```js``` fence
  This file is under `src/content/docs/`, and this bare ` ```js ` fence contains an application module that runs on the Workers runtime (Dynamic Worker) and exports a `default` async function, matching the TypeScriptExample criteria. Per the code-blocks component-alternatives rule, use `<TypeScriptExample>` instead of a raw JS fence so the example renders with a TS/JS tab pair.
- S-14ce784b | src/content/docs/agents/tools/filesystem.mdx:461 | Use <TypeScriptExample> instead of a raw ```js``` fence
  This bare ` ```js ` fence in a `src/content/docs/` file shows a module that imports from `ws:orders` and exports a `default` async function — the same pattern the code-blocks rule targets. Use `<TypeScriptExample>` instead of a raw JS fence, consistent with the other code examples on this page.

Style Guide

  • src/content/docs/agents/tools/filesystem.mdx:381 · Use <TypeScriptExample> instead of a raw js fence

    This file is under src/content/docs/, and this bare ```js fence contains an application module that runs on the Workers runtime (Dynamic Worker) and exports a default async function, matching the TypeScriptExample criteria. Per the code-blocks component-alternatives rule, use &lt;TypeScriptExample&gt; instead of a raw JS fence so the example renders with a TS/JS tab pair.

  • src/content/docs/agents/tools/filesystem.mdx:461 · Use <TypeScriptExample> instead of a raw js fence

    This bare ```js fence in a src/content/docs/ file shows a module that imports from ws:orders and exports a default async function — the same pattern the code-blocks rule targets. Use &lt;TypeScriptExample&gt; instead of a raw JS fence, consistent with the other code examples on this page.

Resolved (2) · Dismissed (0)
  • Resolved: Contraction it's in prose · Line 25 at the head reads "without filling its context window" — the possessive its, no contraction. Verified via read_repo_file; core-content contraction rule no longer violated.
  • Resolved: Missing serial comma · Line 25 at the head reads "skills, source files, and other external documents" — serial comma now present before the final and. Verified via read_repo_file; rule satisfied.
Commands
  • /review Run a review now.
  • /full-review Review the entire PR diff.
  • /disable-auto-review Stop automatic reviews.
  • /rebase Rebase against production.

@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Oct 15, 2026 •

Copy link
Copy Markdown

🚀 Deploying Preview to Cloudflare 🚀

Preview URL: https://agents-computer-filesystem.previews.developers.cloudflare.com (commit cf8fa40)

This URL reflects your latest Preview deployment

Preview Deployments by commit

Status Deployment URL Commit Updated (UTC) See this deployment's details
  • Build: Success ✅
  • Deployment: Success ✅

View logs ↗
https://5cc54e06.previews.developers.cloudflare.com cf8fa40 2026-10-15T12:58:26.570Z Visit the dashboard ↗
  • Build: Success ✅
  • Deployment: Success ✅

View logs ↗
https://d04aab1a.previews.developers.cloudflare.com 2f9d56a 2026-10-15T11:49:20.458Z Visit the dashboard ↗
  • Build: Success ✅
  • Deployment: Success ✅

View logs ↗
https://2c2655f7.previews.developers.cloudflare.com 36facb0 2026-10-15T11:20:02.556Z Visit the dashboard ↗

@github-actions

github-actions Bot commented Oct 15, 2026 •

Copy link
Copy Markdown
Contributor

Comment thread src/content/docs/agents/tools/filesystem.mdx Outdated
Comment thread src/content/docs/agents/tools/filesystem.mdx Outdated
Comment thread src/content/docs/agents/tools/filesystem.mdx Outdated
Comment thread src/content/docs/agents/tools/filesystem.mdx Outdated
Comment thread src/content/docs/agents/tools/filesystem.mdx Outdated
Comment thread src/content/docs/agents/tools/filesystem.mdx Outdated
Comment thread src/content/docs/agents/tools/filesystem.mdx Outdated
Comment thread src/content/docs/agents/tools/filesystem.mdx Outdated
Comment thread src/content/docs/agents/tools/filesystem.mdx Outdated
Comment thread src/content/docs/agents/tools/filesystem.mdx Outdated
Co-authored-by: Aron <263346377+aron-cf@users.noreply.github.com>
- Cover the Think, AI SDK, Pi, and OpenCode harnesses, with a note
  pointing to each and typed adapters for Pi Durable and OpenCode.
- Update the Think guidance for the Computer workspace that Think now
  includes (PR #34297): no useThink, workspaceBash, or createAITools().
- Add an API reference for Workspace, workspace.fs, workspace.runtime,
  the tool functions, and the host modules, and link to it.
- Link the Worker Loader binding to /dynamic-workers/ directly, which
  fixes the nimbus/internal-link redirect error.
- Fix the description, the "accesing" and "it's" typos, and wording.
@aron-cf
aron-cf added this pull request to the merge queue Oct 15, 2026
Merged via the queue into production with commit c0501f5 Oct 15, 2026
15 checks passed
@aron-cf
aron-cf deleted the agents-computer-filesystem branch October 15, 2026 14:26
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

product:agents Build and deploy AI-powered Agents on Cloudflare that can act autonomously. size/l

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants