foxctl File Reservations

File locking prevents multi-agent edit conflicts by managing advisory reservations that let actors claim exclusive or shared access to specific paths before modifying them, ensuring only the intended actor edits during a task window.

To reserve a file path for exclusive write access, you request a reservation in exclusive mode for your actor via the reserve operation, optionally specifying duration and task metadata to coordinate safe read/write access across sessions.

You need concurrency control for multi-agent workspace coordination when multiple processes may modify the same files simultaneously, requiring safe read/write access planning to detect conflicting edits before tasks execute and prevent data corruption.

Yes, you can check for existing file reservations before assigning a write task by running the check_conflicts operation, which verifies whether requested paths and access modes conflict with active exclusive or shared reservations in the workspace.

Exclusive file lock modes allow only the reserving actor to modify or access a path, while shared modes permit multiple actors to hold concurrent read access, enabling safe coordination based on whether a task requires reading or writing shared files.

You release a file lock after a multi-agent task completes by running the release operation for the reserved file paths, freeing the advisory reservations so other actors can safely claim access and modify the workspace resources.