Backend that stores files in a LangSmith Hub agent repository.
Mutations are accepted in call order, coalesced for a short window, and pushed by one worker. Only one batch is in flight at a time; mutations that arrive during a push form the next batch. This serializes one backend instance's writes while still reducing the number of Hub commits.
Reads use an optimistic view: the last durable cache overlaid with the in-flight batch and then the pending batch. A read can therefore observe an accepted mutation before it is durable; a failed push invalidates that view and the next operation reloads from Hub.
A 409 parent conflict triggers an authoritative pull and rematerializes
the in-flight batch over the fetched tree before retrying. Edits replay their
original replacement intent; absolute writes, deletes, and uploads replay as
absolute changes. Retries are bounded by MAX_CONFLICT_RETRIES.
