[ben-reitz]

The tool sets spread the exec tool's options across three top-level keys: exec for the backend map, execOutput for output limits, and execMetadata for run metadata, which #292 added. Review on #292 suggested grouping them under exec.

exec now takes { backends, output, metadata }, typed as ExecToolSetOptions and exported from @cloudflare/computer/tools. execOutput and execMetadata are gone.

createAITools({
  workspace,
  exec: {
    backends: { "worker-javascript": {}, container: { description: "Use for builds." } }, // omit for every backend
    output: { maxLines: 500 },
    metadata: ({ toolCallId }) => ({ conversation: this.name, toolCall: toolCallId }),
  },
});

This is a breaking change. To upgrade:

exec: { "worker-javascript": {} } →  exec: { backends: { "worker-javascript": {} } }
execOutput: { maxLines: 500 }     →  exec: { output: { maxLines: 500 } }
exec: {}  // no exec tool         →  exec: { backends: {} }

Read as the new form, an old backend map or exec: {} would quietly offer every backend, so both throw a TypeError that says what to pass instead. The deprecated shell option still works, and any exec still wins over it.

The tests cover the new form, exec without backends offering every backend, exec: { backends: {} } turning the tool off, and the two old shapes throwing. docs/09_tool_interface.md, docs/17_isolate_javascript.md, the package README, and the celld and mcp examples use the new form.

---

[changeset-bot]

🦋 Changeset detected

Latest commit: 7d81927

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 4 packages

Name	Type
@cloudflare/computer	Minor
@cloudflare/dofs	Minor
@cloudflare/computer-rpc	Minor
@cloudflare/computerd	Minor

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[devin-ai-integration]

✅ Devin Review: No Issues Found

Devin Review analyzed this PR and found no bugs or issues to report.

[pkg-pr-new]

Open in StackBlitz

npm i https://pkg.pr.new/@cloudflare/computer@300

commit: 7d81927