Add @cloudflare/workspace/tools entrypoint (#23)

* workspace: Add AI SDK tools entrypoint

Add @cloudflare/workspace/tools as a separate package subpath for AI SDK tool wrappers. The entrypoint exposes createAITools() plus the underlying read, write, edit, ls, exec, and share helpers, while keeping ai and zod as optional peers so the main Workspace entrypoint stays independent of the AI SDK.

Cover the tool set with focused tests for read-only mode, file operations, byte caps, backend routing, UTF-8-safe exec truncation, and asset sharing.

* examples/think: Use workspace AI tools

Replace the example's local workspace tool wrappers with createAITools() from @cloudflare/workspace/tools. The example keeps its report_update tool, passes the same backend guidance to the shared exec tool, and relies on Workspace assets for optional sharing.

Remove the now-unused diff dependencies and update the example README so the documented tool sources match the migrated wiring.

* docs: Document workspace tool interface

Update the tool interface guide for the shipped @cloudflare/workspace/tools entrypoint. The docs now cover createAITools(), fixed tool names, read-only mode, opt-in exec, asset sharing, FileStore ranges, and the validation commands for the change.

* workspace: Use a function type for remote add

Represent RemoteAddFn as a function type instead of an interface with only a call signature. This keeps the artifacts CLI type shape the same while satisfying the workspace lint rule.

* workspace, examples/think, docs: Rename publish tool

Expose the assets-backed AI tool as publish instead of share while keeping the underlying Workspace assets client unchanged. Update the package exports, tests, Think documentation, and tool interface docs so the model-facing name is consistent.

* workspace, examples/think, docs: Add Think compatibility option

Add a useThink constructor option that attaches Think's WorkspaceLike filesystem methods to the Workspace instance. This lets Think consumers assign the Workspace directly while keeping the primary API on workspace.fs.

Update the Think example to use the option, remove its local compatibility adapter, and document the new constructor option.

* workspace, examples/think, docs: Address tools review feedback

Restore model-facing exec fallback guidance, return structured exec errors, omit the publish prefix when no session id is configured, and cancel file read streams when byte-range reads stop before EOF.

Keep diff bundled as an implementation detail by removing its optional peer declaration, and fix the assets README wording and Think tools table alignment.

Author: aron-cf

docs/01_vfs.md

@@ -33,9 +33,16 @@ new Workspace({
 Workspace where `fs` works against the local SQLite store but
 `shell` throws.
 
-`WorkspaceOptions` is `{ storage, backends, now? }`. There is no
-`root`, `sandbox`, or `sessionId` field on the host facade — sandbox
-wiring lives behind a `WorkspaceBackend`.
+`WorkspaceOptions` includes the storage handle, optional backends,
+clock, session id, mounts, observer, git identity, assets, artifacts,
+and `useThink`. There is no `root` or `sandbox` field on the host
+facade — sandbox wiring lives behind a `WorkspaceBackend`.
+
+Set `useThink: true` when assigning the Workspace to
+`Think.workspace`. This adds Think's string-oriented filesystem
+compatibility methods (`readFile`, `readFileBytes`, `writeFile`,
+`readDir`, `rm`, `glob`, `mkdir`, and `stat`) directly to that
+Workspace instance while leaving the primary API on `workspace.fs`.
 
 Illustrative layout (nothing below `/` is auto-created beyond
 `ROOT_INODE` itself):