Skip to main content
Glama
bompus

Swarmail

by bompus
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Local

file_reservation_paths

Reserve repository-relative paths or globs so other agents know what you are editing. Returns {granted, conflicts}; grants include reservation ids and expiry times, while conflicts name the requested path and its holders.

Instructions

Reserve repository-relative paths or globs so other agents know what you are editing. Returns {granted, conflicts}; grants include reservation ids and expiry times, while conflicts name the requested path and its holders. Conflicts do not fail the call, and nothing blocks the edit itself; the optional git guard refuses commits touching another agent's exclusive reservation. Reserving a path you already hold updates it. Extend with renew_file_reservations and release with release_file_reservations when done.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
pathsYesRepository-relative paths or globs.
reasonNoShown to agents whose reservation conflicts.
exclusiveNoDefault true. Shared reservations conflict only with exclusive ones.
agent_nameYesYour registered agent name.
project_keyYesAbsolute path of the repository's primary checkout.
ttl_secondsNoSeconds, default 3600, at most 2592000 (30 days).
idempotency_keyNoNonempty key for this tool and agent. Identical arguments replay with idempotent_replay:true; different arguments fail with IDEMPOTENCY_KEY_CONFLICT. Cleanup runs at server startup and hourly, removing keys older than 7 days. Retries can replay until removal; afterward a retry may perform the operation again.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changedv0.3.1
    • changedInput schema / properties / idempotency_key / description
      Previous value: -"Nonempty key for this tool and agent. Identical arguments replay with idempotent_replay:true; different arguments fail with IDEMPOTENCY_KEY_CONFLICT. Hourly cleanup removes keys older than 7 days. Retries can replay until removal; afterward a retry may perform the operation again."New value: +"Nonempty key for this tool and agent. Identical arguments replay with idempotent_replay:true; different arguments fail with IDEMPOTENCY_KEY_CONFLICT. Cleanup runs at server startup and hourly, removing keys older than 7 days. Retries can replay until removal; afterward a retry may perform the operation again."
  2. Changed1 schema field changedv0.2.5
    • changedInput schema / properties / idempotency_key / description
      Previous value: -"Any string. A retry with the same key and arguments returns the first result."New value: +"Nonempty key for this tool and agent. Identical arguments replay with idempotent_replay:true; different arguments fail with IDEMPOTENCY_KEY_CONFLICT. Hourly cleanup removes keys older than 7 days. Retries can replay until removal; afterward a retry may perform the operation again."
  3. Changed4 schema fields changedv0.2.2
    • changedInput schema / properties / exclusive / description
      Previous value: -"Default true."New value: +"Default true. Shared reservations conflict only with exclusive ones."
    • addedInput schema / properties / idempotency_key / description
      Added value: +"Any string. A retry with the same key and arguments returns the first result."
    • addedInput schema / properties / paths / description
      Added value: +"Repository-relative paths or globs."
    • addedInput schema / properties / reason / description
      Added value: +"Shown to agents whose reservation conflicts."
  4. First observedv0.2.1

TDQS

Score is being calculated.

Deploy Server

Other Tools