create_record_room_tool
Mint a recording room with guest and producer /rec/ links, revoke earlier room links, and optionally save an unsaved take before minting.
Instructions
Mint a recording room: guest + producer /rec/ links; revokes earlier rooms' links (docs/recording-session.md).
If the current room has a stopped take not saved to the episode, the result says so (unlanded_take, unlanded_takes, unlanded_saving, unlanded_stalled, land_first_possible, warning) and the mint still happens. Pass land_first to save that take first (result adds landed_first; audio that never finished uploading cannot be saved; every mint that leaves audio the server detected as never finished reports left_behind (a count) and left_behind_message). Land-first mints nothing and keeps the old links when uploads are still saving (wait until 10 minutes pass with no upload and no rejoin from that person since Stop, or mint without it), when the room's staged session was already accepted or skipped and something is landable or saving, or when the land leaves a take unsaved.
target is where the session lands: end (the default), start (the front of the episode), or an insert/replace JSON object
that stages the session as a suggestion.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "create_record_room_tool"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| target | No | ||
| expires_at | No | ||
| land_first | No | ||
| project_path | No | ||
| public_base_url | No | http://127.0.0.1:8765 |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |