Skip to content

declare batch in .supertool.json, so the op that collapses N calls into one is discoverable - #337

Merged
fdaviddpt merged 2 commits into
mainfrom
chore/builtin-ops-listing
Aug 8, 2026
Merged

declare batch in .supertool.json, so the op that collapses N calls into one is discoverable#337
fdaviddpt merged 2 commits into
mainfrom
chore/builtin-ops-listing

Conversation

@fdaviddpt

Copy link
Copy Markdown
Contributor

batch runs an array of ops in one call. A supertool call carries one @- payload, so without it N edits cost N calls — and every call re-reads the caller's whole context, which is where the cost actually is.

It was not discoverable from this repo. .supertool.json here declares no builtin-ops section at all, so ops listed 33 entries, every one of them a preset. An agent working in this repo could not find batch, and could not find read, grep or edit either.

Verified before and after, rather than assumed:

before:  33 ops listed,  `batch` absent
after:   34 ops listed,  `- `batch:@file.json` — Run array of ops in one call…

Context

claude-supertool#1124 measured 232 agent transcripts and found 1.45 ops per call against a documented 6–7, with 70–73% of calls carrying exactly one op. Of the single-op calls, 39% are payload mutations — structurally single unless the author knows batch.

That issue's fix (claude-supertool#1133) makes ops derive its own gaps, so any dispatchable op no config describes names itself. Once that ships, this repo will surface the rest automatically. This adds the one that matters most, now.

Scope

One key, eight added lines, nothing removed. The wider gap — this repo describes none of the core ops — is left for the derived listing to solve rather than hand-maintained here, since a hand-written list of 36 ops is the thing that rots.

… one is discoverable

Co-Authored-By: Max <noreply>
…eflowed every inline array

Co-Authored-By: Max <noreply>
@fdaviddpt
fdaviddpt merged commit a7d508a into main Aug 8, 2026
12 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant