{"version":"2.1.287","anchor":"cloud-turn-handoff-gains-home-files-and-file-names","canonical_anchor":"cloud-turn-handoff-gains-home-files-and-file-names","heading":"Turn handoff can name files to copy into the home directory","tier":"notice","area":"Cloud Sessions","url":"https:\/\/changelogs.core-directive.com\/v\/2.1.287\/e\/cloud-turn-handoff-gains-home-files-and-file-names","release_url":"https:\/\/changelogs.core-directive.com\/v\/2.1.287","markdown":"### Turn handoff can name files to copy into the home directory\n\nA `turn_handoff` request can now carry up to 16 file names, and workers can advertise `file_names` and `home_files` support\n\n**Unclear.** Whether the remote side of this is already in use is not known.\n\n**What**\n\nA turn handoff passes an unfinished turn to a cloud worker to finish. It gains two internal capabilities:\n\n- `file_names`: a `turn_handoff` request can carry an optional list of up to 16 entries, each `{file_uuid, name}`. A worker that announces `file_names: true` in `turn_handoff_available` copies the attached files it has already downloaded into the session's home directory under those names before the handed-off tool calls run. The names are checked when the handoff is validated.\n\n- `home_files`: a worker can announce support for `stage_file` requests to `\/uploads\/.home\/<path>`, which end up at `\/home\/claude\/<path>`.\n\n- Marked live: the last assistant message of a handed-off turn is now marked `handedOffLive`.\n\nThe schema text is marked internal, and its permission description drops the words \"ordinary\" and \"exactly as calls its own model emitted\".\n\n**Why**\n\nThis affects only cloud and remote sessions. Files can now be placed in the worker's home directory under the expected names before the handed-off work runs.\n\n- Area: Cloud Sessions\n- Tier: You'll notice\n- Useful: 2\/5\n- Signal: 3\/5"}