@cloudflare/computer

Minor Changes

• getWorkspace() now returns a lazy client immediately which resolves on the first call. useThink and the Think compatibility methods are removed; @cloudflare/think 0.21 and later take a Workspace as it is.

• WorkerJavaScriptBackend keeps its Durable Object alive while executions run, and adds a maxCpuMs option.

• just-bash is now an optional peer dependency and should be installed manually when using @cloudflare/computer/backends/worker-shell.

Patch Changes

• getWorkspace() accepts any Durable Object stub whose class has __getWorkspaceStub(), without a cast.

• WorkspaceProxy and WorkspaceServiceProxy wake their host Durable Object by name, so ctx.id.name survives a wake caused by a container or Dynamic Worker callback. WorkspaceRef, WorkspaceProxyProps and WorkspaceServiceProxyProps accept an optional name, filled in from ctx.id.name when the backend runs in the host object itself.

• deprecated

  Workspace, its filesystem, the worker-javascript backend, mounts, agent tools, Git, Assets, and Artifacts are now stable; LegacyContainerBackend is deprecated in favor of ContainerBackend; the container and worker-shell backends, ws:container, sync, and computerd stay experimental.

Patch Changes

• Add forAISDKTools() in @cloudflare/computer/tools/ai-sdk to serve an AI SDK tool set to isolate JavaScript as ws:tools; see ws:tools documentation.

• The edit tool bounds its diff with maxDiffLines and maxDiffBytes and reports diffTruncated; see edit tool documentation.

• Fix issue when creating a host module with no functions in the JavaScriptWorkerBackend; see host module documentation.

• The exec tool's input is an object rather than any JSON value; see exec tool documentation.

• The exec tool parses an input object sent as a string of JSON; see exec tool documentation.

• Tool sets take execOutput: { maxLines, maxBytes } for the exec tool's output limits; see tool option documentation.

• Host module factories receive the Workspace's assets client as host.assets; see host module documentation.

• WorkerJavaScriptBackend now lazily reads each host module's description; see module documentation.

• Mounts can now declare a version to support schema migrations; see mount version documentation.

• createPiTools results carry each tool's own output as details; see pi documentation.

• Add ws:tools to provide the JavaScript worker backend programmatic access to tools; see ws:tools documentation.

• The grep tool's include and exclude, and the find tool's exclude, take one glob or a list; see grep tool documentation.

• Add @cloudflare/computer/tools/core, which exports defineExec without an agent library; see tool documentation.

• Tool sets take root to confine the file tools to one directory; see root documentation.

• Add WorkerBundle, a read-only mount that copies files from the deployed bundle or an imported file tree; see mount documentation.

• Add @cloudflare/computer/vite with a computerBundle() plugin that bundles a directory into a Vite-built worker for WorkerBundle; see mount documentation.

• ws:artifacts adds createToken and share for minting git tokens and clone URLs; see ws:artifacts documentation.

• Add ws:assets so isolate JavaScript can publish a Workspace file to a time-limited URL; see ws:assets documentation.

• createContainerModule({ maxOutputLines }) limits each ws:container stream by lines as well as bytes; see ws:container documentation.

• createContainerModule({ prelude }) runs shell text such as set -o pipefail before each ws:container command; see ws:container documentation.

• ws:container now keeps the end of each stream for a Workspace with output: false; see ws:container documentation.

• ws:tools lists the tools code can import in its description; see ws:tools documentation.

Minor Changes

• createAITools moves to @cloudflare/computer/tools/ai-sdk; see tool wiring documentation.

• The exec option (now ExecBackendOptions) has been refactored to use runtime.backends(); see tool option documentation.

• The exec tool shows the last maxLines (2000) lines or maxBytes of each stream with a pointer to the full output on disk; see exec tool documentation.

• ws:git and ws:artifacts are no longer installed by default: add createGitModule() and createArtifactsModule(); see ws:git documentation.

• Remove WorkerJavaScriptBackend's maxConcurrentExecutions option, leaving the platform's own limit on concurrent Dynamic Workers; see execution limit documentation.

• Consolidate trustedModules with modules in WorkerJavaScriptBackend; see module documentation.

• runtime.exec results keep only the last 2000 lines or 64 KiB of each stream and save the full output to a Workspace file, configured with new Workspace({ output }) or turned off with output: false; see long output documentation.

• Fix an issue in JavaScriptWorkerBackend where a source module could import a Workspace file; see source module documentation.

Patch Changes

• JavaScriptWorkerBackend now supports absolute imports e.g. /workspace/lib/util.js; see import documentation.

• Improve WorkerShellBackend and ContainerBackend tool descriptions including egress information; see exec tool documentation.

• Add runtime.backends() to WorkspaceClient allowing tools to be created from workspace stubs; see tool wiring documentation.

• The exec tool now tells the model to put module code in an export default async function (input) shape.

• The exec tool only documents backend and input when needed; see exec tool documentation.

• A cyclic argument to a node:fs or host module call fails with a "must be acyclic" error; see execution limit documentation.

• Isolate JavaScript modules now need a default export, and fail before running without one.

• Isolate JavaScript code can now import Node.js built-ins such as node:path, node:crypto, and node:zlib.

• The JavaScript backend now creates its root directory (/workspace) if the Workspace doesn't have one.

• The JavaScriptWorkerBackend now strips non-serializable return values matching JSON.stringify(); see isolate JavaScript documentation.

• Isolate JavaScript runs now fail on I/O at module scope or an unhandled rejection, instead of completing silently, with no output.

• JavaScriptWorkerBackend now uses native RPC for modules bindings; see execution limit documentation.

• Imports of ws:* and other configured modules work when compatibilityFlags includes new_module_registry; see module documentation.

• Tools built from a remote getWorkspace() client of a Workspace without an assets publisher no longer offer a publish tool; see tool wiring documentation.

• Add workspace.runtime.backends(), which lists each backend's id, protocol, whether it is callable, and its description for a model, including the modules a WorkerJavaScriptBackend can import; see backend routing documentation.

• Each JavaScriptWorkerBackend now only stores each module once, so a large bundle counts once; see module documentation.

• A DO's ctx.storage can now be passed to a Workspace without casting.

• Workspace filesystem errors no longer repeat the path.

• Add ws:container so isolate JavaScript can run shell commands in the Workspace's ContainerBackend; see ws:container documentation.

• ws:git's cli accepts a leading -C <path> as its working directory; see ws:git documentation.

Minor Changes

• Rename the platform-scheduled container backend to LegacyContainerBackend; see container backend documentation.

• Add Workspace tool sets for pi (createPiTools from @cloudflare/computer/tools/pi-ai) and TanStack AI (createTanStackTools from @cloudflare/computer/tools/tanstack-ai); see the tool interface docs.

Patch Changes

• Keep configured paths local to the container instead of syncing them with the Durable Object using ContainerBackend.ignore; see local-only path documentation.

• Add ContainerBackend for durable-object-scheduled containers; see container backend documentation.

• Expand ws:git with full-history clones by default and additional cat-file, log, and command-specific help options; see Git interface documentation.