slaunt
DOCUMENTATION

Room tools

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_scopeBucketWrites
workspaceShared across the whole workspaceWorkspace admins only
currentYour projectAny member
allBoth (listing only)

All Room tools need a signed-in user.

Reading

ToolParams
room_items_listproject_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_getid required; includes group membership
room_item_content_getid required, max_chars 256–20,000 (default 4,000). Text files return a preview; binary files return metadata and a download path.

Writing

ToolParams
room_folder_createtitle required, description, parent_item_id, project_scope (default workspace, so non-admins should pass current)
room_group_createSame, plus item_ids; members must be in the same bucket
room_item_updateid 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_bytesRequired. Type and size must match the uploaded object exactly.
project_scopeRequired: current | workspace
parent_item_id, extension
checksum_sha256Lowercase hex of the exact bytes