Room tools: browse and manage workspace files - Slaunt

Room is the workspace’s shared file store, useful for specs, runbooks and reference material agents should read. Items are files, folders or groups (a group is a named set of items across folders). Every item lives in one of two buckets, set by project_scope:

`project_scope`	Bucket	Writes
`workspace`	Shared across the whole workspace	Workspace admins only
`current`	Your project	Any member
`all`	Both (listing only)

All Room tools need a signed-in user.

Reading

Tool	Params
`room_items_list`	`project_scope` (default `all`), `parent_item_id` (direct children of a folder), `item_type` (`file`\|`folder`\|`group`), `limit` 1–250 (100), `offset`, `include_group_memberships` (default `false`; leave off unless you need it, it inflates the payload)
`room_item_get`	`id` required; includes group membership
`room_item_content_get`	`id` required, `max_chars` 256–20,000 (default 4,000). Text files return a preview; binary files return metadata and a download path.

Writing

Tool	Params
`room_folder_create`	`title` required, `description`, `parent_item_id`, `project_scope` (default `workspace`, so non-admins should pass `current`)
`room_group_create`	Same, plus `item_ids`; members must be in the same bucket
`room_item_update`	`id` required, `title`, `description`, `parent_item_id` (`""` moves to root), `archived`. Type and bucket can’t change; moving a folder into its own descendant is rejected.

room_file_upload_prepare

Issues an upload receipt before the file bytes are uploaded. Receipts are single-use, expire, and are tied to the user, folder and bucket, so prepare a new one if anything changes. Uploads count toward the plan’s Room upload and storage limits.

Param
`file_name`, `mime_type`, `size_bytes`	Required. Type and size must match the uploaded object exactly.
`project_scope`	Required: `current` \| `workspace`
`parent_item_id`, `extension`
`checksum_sha256`	Lowercase hex of the exact bytes