Batch Tool Result Retry Split

Splits an agent's batch tool result into what must be retried and what must not, and refuses when the result cannot support that decision. Pure function over the result you already have.

THE SILENT FAILURE. An agent's tool call operates over a batch -- send 5 emails, write 10 rows, publish 20 notifications -- and gets back a per-item result where some succeeded and some failed. The retry has to re-send exactly the failures. Every way of getting this wrong is silent. Retry the whole batch and the successful items happen TWICE: five emails become ten, and nothing in the log looks abnormal. Index the results against the wrong array and the retry set is misaligned -- you re-send item 3 for item 4's failure. Read a truthy `status` field that means 'the call completed' rather than 'the item succeeded' and every failure is dropped on the floor, permanently, with a clean success log above it.

PARTIAL SUCCESS IS THE DEFAULT CASE, NOT THE EDGE CASE. Batch APIs return it constantly and the agent frameworks around them mostly model a call as succeeded-or-failed. This package treats a batch result as a set of independent outcomes and produces a retry set with the reason each item is in it.

IT REFUSES A BATCH IT CANNOT ALIGN. If the result cannot be put in correspondence with the request -- counts differ, ids are missing, an item carries no determinate outcome -- it returns a refusal naming the problem rather than a retry set that looks actionable and is misaligned. A confidently wrong retry set is the expensive failure here.

WHAT VERIFICATION CHANGED. A rival implementation built from the README failed one test, and the test was wrong: it pinned the ARRAY ORDER of the reasons attached to an item, which is an accident of implementation rather than a contract. It now asserts presence and determinism, so the suite survives a rewrite of the code underneath it.

VERIFIED: 86 tests, measured by running the suite, every mutation observed FAILING before restore.

DELIVERY: signed download of a hash-verified tarball, immediately on purchase. Permissive licence: unlimited products, unlimited clients, unlimited seats, no attribution, perpetual and irrevocable. One restriction, do not republish the source as source.

Interface

What you call, and what comes back. Types and signatures only — the implementation ships with the source.

  export function classifyItem(item: BatchItemResult): ItemVerdict;
  export function splitBatchForRetry(input: unknown): BatchRetrySplitResult;
  export function validateBatch(input: unknown): ValidationOk | ValidationFail;

  export type BatchItemStatus = "success" | "failure" | "unknown";
  export type ItemRetryDisposition = "done" | "retry";