dsh-routed-subagent

Usage

subagent_routed(prompt="Use the dev engineer standard to review this repository", preset="dev", description="dev review")          # background one-shot
subagent_routed(prompt="Continue the review", preset="dev-reviewer", description="follow-up", fork=true)  # inherits THIS conversation
subagent_routed(preset="dev", prompt="Audit this repo", description="audit", continuable=true)            # send_message(, ...) later

Behavior:

Modes (one tool, four shapes):

mode	how	returns
one-shot background (default)	run_in_background: true (default)	job id immediately; collect with job_output (live progress) / stop with job_kill; aborting the conversation leaves the child running
one-shot foreground	run_in_background: false	blocks until the child returns its final output
fork	fork: true	job id / run result — the child is seeded with this conversation's COMPLETED turns (inherits the context) then mounts the requested preset on top
continuable	continuable: true	durable subagent id — continue it later with send_message(subagentId, ...); the child mounts the requested preset and keeps it across resumes

Parameters:

input	behavior
preset invalid / unresolvable	error, with the roster's available preset ids
model / provider	per-call model override (fail-fast pre-check lists the provider's candidates; original error preserved as cause)
max_tokens	output/token cap for the child's LLM calls (positive integer)
tool_filter	DENY-only tool mask on top of the preset's tool surface ({ deny: string[] }, e.g. deny shell tools for a read-only audit)
max_depth not a positive integer	tool-layer validation error
fork + continuable together	supported (continuable fork seeds the parent's completed turns)
valid call	child fully mounted on the target preset