Files

61 lines
2.8 KiB
Python

"""Print the Agent tool's model and effort for a subagent's task: docs/decisions.md → `routing:`.
usage: subagent-rung [--plan] <model> <L>
<model> is the project's model, such as claude-opus-5-5, and <L> the task's L, the chance it holds
a defect, a level from 1 to 4 scored as for a todo.md item. It prints the rung that L picks from
the model's cheapest rung, the project's rung, in the Agent tool's words, such as `model sonnet,
effort high`. --plan, for a task that files or scores todo.md items, prints the project's rung where
that L picks a lower one, as ~/.claude/rules/todo-items.md lets only the project's rung or above
plan. For a model off the routing ladder, the tool doesn't print anything on stdout, says so on stderr,
naming the ladder's file, and exits 0; launch the subagent with no model or effort.
It reads the routing ladder of the project whose checkout it runs in: routing-ladder.json in the
folder of the project's config, ~/.claude-projects/<key>/, or else the one this setup ships, as in
a checkout no config names. loop-claude --help shows the file's shape.
Exit 1, saying why, on bad arguments, or where the project's config or its routing ladder is faulty
or cannot be read.
"""
import pathlib
import re
import sys
from failure import Failure
from model_routing.ladder import Ladder
from plan.todo_table import LEVELS
from model_routing.ladder_file import project_ladder_file, read_ladder
USAGE = f"usage: subagent-rung [--plan] <model> <L>, L a level from 1 to {LEVELS['L']}"
def agent_args(ladder: Ladder, model: str, likelihood: int, planning: bool = False) -> str | None:
"""The Agent tool's model and effort for the rung likelihood picks on ladder from model's cheapest rung, never below it when planning; None for a model off the ladder."""
project = ladder.project_rung(model)
if project is None:
return None
return (project.planning_rung if planning else project.worker_rung)(likelihood).agent_args()
def main(argv: list[str], home: pathlib.Path) -> int:
if argv[:1] in (["-h"], ["--help"]):
print(__doc__.strip())
return 0
planning = argv[:1] == ["--plan"]
operands = argv[1:] if planning else argv
if len(operands) != 2 or not re.fullmatch(r"[1-9][0-9]*", operands[1]) or int(operands[1]) > LEVELS["L"]:
print(f"subagent-rung: cannot read the arguments{' ' + ' '.join(argv) if argv else ''}; {USAGE}", file=sys.stderr)
return 1
model, likelihood = operands
file = project_ladder_file(None, home)
ladder = file if isinstance(file, Failure) else read_ladder(file)
if isinstance(ladder, Failure):
print(f"subagent-rung: {ladder.reason}", file=sys.stderr)
return 1
args = agent_args(ladder, model, int(likelihood), planning)
if args is None:
print(f"subagent-rung: {model} is not on the routing ladder {file}; pass the Agent tool no model or effort", file=sys.stderr)
else:
print(args)
return 0