Plan from a description
planReads a description of the work (a prompt, tags, attachment types and sizes) into a need, then resolves it as resolve does. Use resolve when you can state the task or purpose yourself; use this when you only have the user's words. Counts as more than one call. The answer depends on these goals; have the ones that matter in hand from the plan, the repository or the user before calling: cost (optimize, max_price, budget, calls_per_user_month); depth (optimize, quality_margin, min_quality, budget, shape, needs); maker_origin (origin, origin_strict); data_region (regions); languages (languages); data_kind (needs); accounts (providers). Send them as strings in constraints; only providers and shape go at the top level.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"providers": "<providers>"
},
"name": "plan"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tags | No | Free tags, e.g. ["vision", "read receipts", "usa", "medium"]. | |
| shape | No | As in /v1/resolve, or auto: a team purpose's team and an escalation purpose's ladder; else a team when the reading says several models would help (ensemble_helps), an escalation when the request gives length, else single. | |
| device | No | The device's memory, GPU memory and free disk in GB, for local runtimes: facts that become max_memory_gb, max_vram_gb and max_disk_gb unless constraints set them. | |
| prompt | No | The request to read. Sent only to the decision model you choose; never stored or logged. | |
| decision | No | ||
| providers | Yes | Required. Provider names, in order of preference for ties. | |
| attachments | No | ||
| constraints | No | Any /v1/resolve query parameter except providers, as strings; these win over the reading. When these and the recognised tags settle the task or purpose and the budget, give needs (even empty), no tag is unrecognised, and no shape is left to the reading, the prompt is not read: the reading is empty and decision.model is local. |