@rse/ase 2.0.6 → 2.0.7

package/dst/ase-agent-definition-api.d.ts

@@ -18,6 +18,7 @@ export interface AgentDefinition {
     lifecycle?: Many<string>;
     serial?: boolean;
     unclaimed?: boolean;
+    model?: string;
     state?: {
         incoming?: Many<string>;
         activity?: string;
@@ -175,6 +176,7 @@ export interface AgentHooks {
     ready?: (task: AgentHookTask, ctx: AgentHookContext) => Async<boolean | string>;
     prepare?: (task: AgentHookTask, job: AgentHookJob, ctx: AgentHookContext) => Async<void>;
     prompt?: (task: AgentHookTask, prompt: AgentHookPrompt, job: AgentHookJob, ctx: AgentHookContext) => Async<AgentHookPrompt | string | undefined>;
+    model?: (task: AgentHookTask, model: string, job: AgentHookJob, ctx: AgentHookContext) => Async<string | undefined>;
     verdict?: (task: AgentHookTask, result: AgentHookResult, ctx: AgentHookContext) => Async<string | undefined>;
     success?: (task: AgentHookTask, result: AgentHookResult, ctx: AgentHookContext) => Async<boolean | string>;
     settle?: (task: AgentHookTask, outcome: AgentHookOutcome, ctx: AgentHookContext) => Async<AgentHookSettlement | undefined>;

package/dst/ase-agent-definition-core.js

@@ -92,6 +92,9 @@ export const definitionOptions = [
     opt("unclaimed", "flag", "", "process the tasks of the incoming states (each adapted onto the " +
         "task lifecycle model) without claiming them, independent of their assignee and predecessors, " +
         "and without ever changing their status and assignee (for \"phase\" only)"),
+    opt("model", "value", "model", "model of the agent tool: a model for all tasks, or comma-separated " +
+        "\"<size>=<model>\" pairs per \"Effort:\" size (\"XS\", \"S\", \"M\", \"L\", \"XL\", or \"*\" for all other tasks) " +
+        "(default: the default model of the agent tool)"),
     opt("params", "list", "name=value", "value of a parameter declared by the definition (repeatable)"),
     opt("state-incoming", "list", "state", "state of the tasks to claim (mandatory for \"phase\", " +
         "repeatable with \"--unclaimed\" or \"--state-activity\" only)"),
@@ -272,7 +275,7 @@ export const flattenDefinition = (data, where) => {
     return flat;
 };
 /*  the names of the hooks of a definition (see "AgentHooks")  */
-const hookNames = ["start", "order", "passes", "ready", "prepare", "prompt", "verdict", "success", "settle", "finish", "stop"];
+const hookNames = ["start", "order", "passes", "ready", "prepare", "prompt", "model", "verdict", "success", "settle", "finish", "stop"];
 /*  normalize the parameter declarations <spec> of a definition (see "AgentParam"),
     where <where> names the definition in errors  */
 const definitionParams = (spec, where) => {
@@ -741,6 +744,24 @@ export const resolveDefinition = async (opts, name) => {
         if (loaded.hooks.passes !== undefined)
             fail("definition", "hook \"passes\" is not for \"--unclaimed\" (as an unclaimed task never waits for its predecessors)");
     }
+    /*  the model of the agent tool: a plain model (for all tasks, as size "*"),
+        or the models per "Effort:" size, where none means the default of the tool  */
+    const modelSpec = str("model").trim();
+    const sizes = {};
+    if (modelSpec !== "" && !modelSpec.includes("="))
+        sizes["*"] = modelSpec;
+    else if (modelSpec !== "") {
+        for (const pair of modelSpec.split(",").map((item) => item.trim())) {
+            const m = /^(XS|S|M|L|XL|\*)=(\S+)$/.exec(pair);
+            if (m === null)
+                fail("model", `invalid pair "${pair}" (expected "<size>=<model>" with size "XS", "S", "M", "L", "XL", or "*")`);
+            else if (Object.hasOwn(sizes, m[1]))
+                fail("model", `size "${m[1]}" given twice`);
+            else
+                sizes[m[1]] = m[2];
+        }
+    }
+    const model = { spec: modelSpec, sizes };
     /*  whether a verdict is determined (by "--verdict-label" or the hook "verdict")  */
     const verdicting = has("verdict-label") || loaded.hooks.verdict !== undefined;
     /*  the states (see "resolveStates")  */
@@ -821,10 +842,10 @@ export const resolveDefinition = async (opts, name) => {
         hence the prompt of the request), resp. uses them optionally by "{prompt}" used only
         within the conditional "{?prompt:...}", else ignores them  */
     const consumes = type === "request" && (template.required.has("prompt")
-        || ["prepare", "prompt", "finish"].some((hook) => loaded.hooks[hook] !== undefined)) ? "required" :
+        || ["prepare", "prompt", "model", "finish"].some((hook) => loaded.hooks[hook] !== undefined)) ? "required" :
         type === "request" && template.names.has("prompt") ? "optional" : "ignored";
     return {
-        name, title, description, type, workdir, lifecycles, unclaimed,
+        name, title, description, type, workdir, lifecycles, unclaimed, model,
         serial: flag("serial"),
         state: { incoming, activity, success, failure, phase, passed, verdict: verdicts },
         tag: {

package/dst/ase-agent-fleet.js

@@ -45,7 +45,7 @@ const logLevelRe = /^([^|]*\| [^:]+: \[[^\]]+\]: )\[(ERROR|WARNING|INFO|DEBUG)\]
     agents, and applied to an agent only if it supports them)  */
 const fleetKeys = ["foreground"];
 const relayKeys = ["address", "port", "token", "cors", "tls-cert", "tls-key"];
-const defaultKeys = ["tool", "parallel", "timeout", "repo", "tempdir", "agent-relay"];
+const defaultKeys = ["tool", "model", "parallel", "timeout", "repo", "tempdir", "agent-relay"];
 /*  the options not allowed in the section of an agent, as the fleet decides on them  */
 const deniedKeys = ["name", "one-shot", "foreground", "help"];
 /*  the state of the planned tasks per task lifecycle model, as estimated by the estimator  */
@@ -76,6 +76,7 @@ const initConfig = (tool, lifecycle) => [
     #   (each applied only to the agents supporting it, where an empty value omits it)
     default:
         tool:           ${tool.padEnd(16)}# agent tool ("claude", "copilot", or "codex")
+        #model:         <model>         # model of the agent tool (or "<size>=<model>" pairs per "Effort:" size)
         parallel:       1               # maximum number of tasks processed in parallel
         timeout:        60m             # maximum duration of processing a task (<number><unit> with unit "s", "m", or "h")
         #repo:          <url>           # Git repository to clone temporarily for the tasks without "worktree"

package/dst/ase-agent-runtime-engine.js

@@ -45,6 +45,15 @@ const promptOf = (value, configured) => {
     }
     throw new Error("invalid prompt (expected a string, \"{ text }\", or \"{ skill, args }\")");
 };
+/*  the model returned by the hook "model", validated, where undefined
+    keeps the configured model <configured>  */
+const modelOf = (value, configured) => {
+    if (value === undefined)
+        return configured;
+    else if (typeof value !== "string")
+        throw new Error("invalid model (expected a string)");
+    return value.trim();
+};
 /*  whether a record of an agent of a definition succeeded (where a missing one counts as failure)  */
 const recordSuccess = (record) => record !== undefined && record.fixed === "" && record.checks.every((check) => check.ok);
 /*  escape a text for its literal use in a regular expression  */
@@ -331,7 +340,7 @@ class DefinedCore {
     }
     /*  prepare the job of a task in its work <work>: render the prompt (with the request
         prompt <prompt> of a request agent), run the preparing commands, and run the hooks
-        "prepare" and "prompt", where the work is cleaned up again on a failure, and where
+        "prepare", "prompt", and "model", where the work is cleaned up again on a failure, and where
         <changed> decides preliminarily whether the plan content of a request agent changed  */
     async prepare(task, log, work, prompt, changed) {
         try {
@@ -374,7 +383,7 @@ class DefinedCore {
                     throw err;
                 }
             }
-            /*  run the hooks "prepare" and "prompt", where a failed hook fails the processing  */
+            /*  run the hooks "prepare", "prompt", and "model", where a failed hook fails the processing  */
             const job = Object.freeze({
                 dir: work.cwd,
                 dirs: Object.freeze([...work.dirs]),
@@ -392,7 +401,7 @@ class DefinedCore {
                     throw new Error(`agent: hook "${name}" failed: ${reason(err)}`, { cause: err });
                 }
             };
-            const { prepare: prepareHook, prompt: promptHook } = this.def.hooks;
+            const { prepare: prepareHook, prompt: promptHook, model: modelHook } = this.def.hooks;
             if (prepareHook !== undefined)
                 await hooked("prepare", async () => prepareHook(this.task(task), job, ctx));
             let spec = this.def.prompt.skill !== "" ?
@@ -401,10 +410,17 @@ class DefinedCore {
                 const configured = Object.freeze(spec);
                 spec = await hooked("prompt", async () => promptOf(await promptHook(this.task(task), configured, job, ctx), configured));
             }
+            const { sizes } = this.def.model;
+            let model = sizes[TaskFormat.parseEffort(task.keys.get("Effort") ?? "")?.size ?? "*"] ?? sizes["*"] ?? "";
+            if (modelHook !== undefined) {
+                const configured = model;
+                model = await hooked("model", async () => modelOf(await modelHook(this.task(task), configured, job, ctx), configured));
+            }
             return {
                 ...("skill" in spec ?
                     { cmd: `${spec.skill}${spec.args !== "" ? ` ${spec.args}` : ""}` } :
                     { prompt: spec.text }),
+                model,
                 cwd: work.cwd,
                 dirs: work.dirs,
                 finish: (log, result) => this.finish(task, log, result, work, job, env, before, changed),
@@ -714,6 +730,7 @@ class DefinedPhaseAgent extends PhaseAgent {
         };
         this.presenceTitle = def.title;
         this.presenceDesc = def.description;
+        this.modelSpec = def.model.spec;
         this.assigned = def.assign.required;
         this.finishing = def.finish.commit || def.finish.success !== "" || def.workdir === "target"
             || def.hooks.finish !== undefined;
@@ -858,6 +875,7 @@ class DefinedRequestAgent extends RequestAgent {
         this.presencePrompt = def.request.prompt;
         this.presenceTitle = def.title;
         this.presenceDesc = def.description;
+        this.modelSpec = def.model.spec;
         this.serial = def.serial;
         this.worktree = def.workdir !== "project";
         this.lifecycles = def.lifecycles;
@@ -950,7 +968,7 @@ export class DefinedAgent extends Agent {
         for (const option of definitionOptions) {
             if (option.key === "definition" && !definition)
                 continue;
-            const flags = (option.key === "definition" ? "-D, " : "") + `--${option.key}` +
+            const flags = (option.key === "definition" ? "-D, " : option.key === "model" ? "-M, " : "") + `--${option.key}` +
                 (option.kind !== "flag" ? ` <${option.arg}>` : "");
             if (option.kind === "list")
                 cmd.option(flags, option.desc, (value, prev) => [...(prev ?? []), value]);

package/dst/ase-agent-runtime-tool.js

@@ -8,20 +8,22 @@ import { stripVTControlCharacters } from "node:util";
     of the task (as an agent message can be huge, e.g. the rendering of the whole task plan,
     which would otherwise be fed back into the next rendering of the task plan)  */
 const TEXT_MAX = 20;
+/*  the "--model" option of all tools for the model <model> (none for the default model)  */
+const modelArgs = (model) => model !== "" ? ["--model", model] : [];
 /*  the per-tool headless invocation of the rendered prompt <prompt> with access to the
-    additional directories <add> (the "--add-dir" options), streaming JSONL events,
-    where risky actions are denied or automatically reviewed instead of being prompted for
+    additional directories <add> (the "--add-dir" options) and the model <model>, streaming JSONL
+    events, where risky actions are denied or automatically reviewed instead of being prompted for
     (the variadic "--add-dir" of Claude has to precede the other options to not consume the prompt)  */
 export const toolArgs = {
-    "claude": (prompt, add) => [
-        ...add, "-p", "--output-format", "stream-json", "--verbose", "--disallowedTools", "AskUserQuestion",
+    "claude": (prompt, add, model) => [
+        ...add, ...modelArgs(model), "-p", "--output-format", "stream-json", "--verbose", "--disallowedTools", "AskUserQuestion",
         "--permission-mode", "auto", "--permission-prompts", "none", prompt
     ],
-    "copilot": (prompt, add) => [
-        ...add, "--allow-all-tools", "--no-ask-user", "--no-color", "--output-format", "json", "-p", prompt
+    "copilot": (prompt, add, model) => [
+        ...add, ...modelArgs(model), "--allow-all-tools", "--no-ask-user", "--no-color", "--output-format", "json", "-p", prompt
     ],
-    "codex": (prompt, add) => [
-        "exec", ...add, "--json", "--approve-for-me", "--color", "never", prompt
+    "codex": (prompt, add, model) => [
+        "exec", ...add, ...modelArgs(model), "--json", "--approve-for-me", "--color", "never", prompt
     ]
 };
 /*  the per-tool rendering of the invocation of the skill <skill> with the arguments <args>:

package/dst/ase-agent-runtime.js

@@ -145,6 +145,8 @@ export class Agent {
     /*  the title and the description of the operation of the agent, as announced in its presence (default: none)  */
     presenceTitle = "";
     presenceDesc = "";
+    /*  the configured model of the agent tool, as shown in the start log line (default: none)  */
+    modelSpec = "";
     /*  whether tasks are processed serially only (clamping "--parallel" to 1, and
         refusing multiple agents of the kind in a fleet, see "ase agent fleet")  */
     serial = false;
@@ -840,7 +842,8 @@ export class Agent {
         const cli = toolSpecs[tool].cli;
         const cmd = job.cmd ?? "";
         const i = cmd.indexOf(" ");
-        const args = toolArgs[tool](job.prompt ?? skillPrompt(tool, i < 0 ? cmd : cmd.slice(0, i), i < 0 ? "" : cmd.slice(i + 1)), [...new Set(job.dirs ?? [])].filter((dir) => dir !== cwd).flatMap((dir) => ["--add-dir", dir]));
+        const model = job.model ?? "";
+        const args = toolArgs[tool](job.prompt ?? skillPrompt(tool, i < 0 ? cmd : cmd.slice(0, i), i < 0 ? "" : cmd.slice(i + 1)), [...new Set(job.dirs ?? [])].filter((dir) => dir !== cwd).flatMap((dir) => ["--add-dir", dir]), model);
         await log("info", `running: ${cli} ${args.map((arg) => arg.includes(" ") ? `"${arg}"` : arg).join(" ")}`);
         const started = Date.now();
         const costs = { costToken: null, costUSD: null, cread: 0, cwrite: 0, input: 0, apiMs: null };
@@ -881,7 +884,7 @@ export class Agent {
         this.presence?.used(usage);
         /*  book the usage onto the task, if the AI usage accounting is enabled ("telemetry.enabled"),
             (the AI request time falling back to the wall time and an unreported cost to the price
-            table entry of the tool, as its model is unknown), without any human time and costs,
+            table entry of the given model, else of the tool), without any human time and costs,
             as the headless agent tool runs unattended; the times are booked in rounded minutes,
             with the (signed) rounding remainder carried over to the next booking onto the task,
             where a failed booking is only reported  */
@@ -894,7 +897,8 @@ export class Agent {
             if (cost === null) {
                 const cfg = new Config("config", configSchema, this.log);
                 cfg.read();
-                cost = tokenCost(modelPrice(parsePrices(String(cfg.get("telemetry.prices.ai") ?? "")), tool), tokens);
+                const prices = parsePrices(String(cfg.get("telemetry.prices.ai") ?? ""));
+                cost = tokenCost(modelPrice(prices, model !== "" && prices.has(model) ? model : tool), tokens);
             }
             const carry = this.unbooked.get(taskId) ?? { aiMs: 0, realMs: 0 };
             const aiMs = carry.aiMs + (costs.apiMs ?? walltimeMs);
@@ -1250,7 +1254,7 @@ export class Agent {
             if (this.repo !== "")
                 await this.cloneRepo();
             await this.write("info", this.name, `observing ${this.observing()} ` +
-                `(tool: ${tool}, parallel: ${parallel}, timeout: ${this.timeoutSpec}${this.oneShot ? ", one-shot" : ""})`);
+                `(tool: ${tool}${this.modelSpec !== "" ? `, model: ${this.modelSpec}` : ""}, parallel: ${parallel}, timeout: ${this.timeoutSpec}${this.oneShot ? ", one-shot" : ""})`);
             let finished = false;
             let failure = null;
             while (!abort.signal.aborted && !finished) {

package/dst/ase-man-catalog.js

@@ -24,7 +24,7 @@ const skillGroups = [
     ["SPEC", ["ase-spec-lint", "ase-spec-edit", "ase-spec-activate"]],
     ["CODE", ["ase-code-edit", "ase-code-analyze", "ase-code-insight", "ase-code-explain", "ase-code-lint"]],
     ["REPO", ["ase-repo-review", "ase-repo-diff", "ase-repo-changelog", "ase-repo-commit",
-            "ase-repo-dissect", "ase-repo-merge", "ase-repo-resolve"]],
+            "ase-repo-dissect", "ase-repo-stage", "ase-repo-merge", "ase-repo-resolve"]],
     ["SYNC", ["ase-sync-reconcile", "ase-sync-import", "ase-sync-export"]],
     ["TASK: MANAGE", ["ase-task-list", "ase-task-rename", "ase-task-delete"]],
     ["TASK: HANDLE", ["ase-task-id", "ase-task-status", "ase-task-assign"]],

package/dst/ase-task-store-plugin-gitea.js

@@ -3,7 +3,7 @@
 **  Copyright (c) 2025-2026 Dr. Ralf S. Engelschall <rse@engelschall.com>
 **  Licensed under Apache 2.0 <https://spdx.org/licenses/Apache-2.0>
 */
-import { giteaApi } from "gitea-js";
+import { giteaApi, ContentType } from "gitea-js";
 import { LRUCache } from "lru-cache";
 import * as TaskFormat from "./ase-task-format.js";
 import * as TaskIssues from "./ase-task-store-issues.js";
@@ -396,7 +396,7 @@ class GiteaTaskStoragePlugin extends TaskIssues.IssueTaskStoragePlugin {
         for (const blocker of after) {
             if (have.has(blocker.number))
                 continue;
-            await this.call(loc, this.gt.repos.issueCreateIssueDependencies(loc.owner, loc.repo, String(issue.number), meta(blocker)))
+            await this.call(loc, this.gt.repos.issueCreateIssueDependencies(loc.owner, loc.repo, String(issue.number), meta(blocker), { type: ContentType.Json }))
                 .catch((err) => {
                 if (statusOf(err) === 404)
                     throw new Error(`Gitea rejected the dependency of issue #${issue.number} on issue #${blocker.number} ` +
@@ -406,7 +406,7 @@ class GiteaTaskStoragePlugin extends TaskIssues.IssueTaskStoragePlugin {
         }
         for (const blocker of current)
             if (!want.has(blocker.number))
-                await found(this.call(loc, this.gt.repos.issueRemoveIssueDependencies(loc.owner, loc.repo, String(issue.number), meta(blocker))));
+                await found(this.call(loc, this.gt.repos.issueRemoveIssueDependencies(loc.owner, loc.repo, String(issue.number), meta(blocker), { type: ContentType.Json })));
     }
     /*  synchronize the comments with the attachments, touching changed ones only
         (see the common issue tracker parts)  */

package/dst/man/ase-agent-adhoc.md

@@ -19,6 +19,7 @@
 \[`--lifecycle` *model*\]
 \[`--serial`\]
 \[`--unclaimed`\]
+\[`-M`|`--model` *model*\]
 \[`--params` *name*`=`*value*\]
 \[`--state-`*item* *state*\]
 \[`--tag-`*item* *tag*\]
@@ -169,12 +170,12 @@ tags (except the request state tag) and, by default, gets its previous
 assignee back. An agent consumes the request prompts if its prompt
 template references `{prompt}` (except within the conditional
 `{?prompt:`*text*`}` only, which makes the prompt *optional*) or it
-has a hook `prepare`, `prompt`, or `finish` (which receive the request
-prompt in their *job*), where it then refuses a request with an empty
-prompt as failed, else it accepts requests with an empty prompt (which
-an agent with an optional prompt still passes on if non-empty), and
-announces this to the agent relay, so the task boards accept an empty
-prompt for its requests, too.
+has a hook `prepare`, `prompt`, `model`, or `finish` (which receive
+the request prompt in their *job*), where it then refuses a request
+with an empty prompt as failed, else it accepts requests with an empty
+prompt (which an agent with an optional prompt still passes on if
+non-empty), and announces this to the agent relay, so the task boards
+accept an empty prompt for its requests, too.
 
 Only the prompt (and `--state-incoming` for `--type phase`) is
 mandatory, while all other options default to the safe *annotate*
@@ -431,6 +432,16 @@ and `--prompt-skill` with `--prompt-args`, and `--tag-retry` and
   `passes`, and `--workdir changeset` resp. `target` (as the task can
   be claimed by another agent meanwhile).
 
+- \[`-M`|`--model` *model*\]:
+  The model of the agent tool, passed to it as `--model` *model*
+  verbatim (e.g., an alias like `sonnet` or a full model name), either a
+  *model* for all tasks, or comma-separated *size*`=`*model* pairs per
+  `Effort:` size of the task (`XS`, `S`, `M`, `L`, `XL`, or `*` for all
+  other tasks, e.g., `XS=haiku,S=haiku,M=sonnet,*=opus`), where a task
+  without a matching pair gets the default model of the agent tool (the
+  default for all tasks). The hook `model` can override it per task (see
+  **HOOKS**).
+
 - \[`--params` *name*`=`*value*\]:
   (repeatable) The value of the parameter *name* declared by the
   definition (see **PARAMETERS**), where a later value of the same
@@ -986,6 +997,14 @@ invocation:
   `{ text }`, a plain prompt text, or `undefined` to keep the
   configured one, where a thrown error fails the processing.
 
+- `model(task, model, job, ctx)`:
+  The model of the agent tool for the job, given the configured *model*
+  of `--model` for the `Effort:` size of the task (empty for the default
+  model of the agent tool): a model (empty for the default one), or
+  `undefined` to keep the configured one, where a thrown error fails the
+  processing. This allows choosing the model per task by any means,
+  e.g., by asking a cheap model via `ctx.exec`.
+
 - `verdict(task, result, ctx)`:
   (after a successful agent tool only) The verdict of the result (an
   upper-case word, accepted only if listed by `--verdict-allow`), an

package/dst/man/ase-agent-condenser.md

@@ -9,6 +9,7 @@
 \[`-T`|`--timeout` *duration*\]
 \[`-o`|`--one-shot`\]
 \[`--agent-relay` *url*\]
+\[`-M`|`--model` *model*\]
 \[`--`*group*`-`*item* *value* \[...\]\]
 \[`-f`|`--foreground`\]
 
@@ -145,6 +146,12 @@ All other options belong to the sub-commands (see **COMMANDS**).
       (`phase` only). Built-in: not set. Not allowed, as the condenser
       claims the tasks into its activity state.
 
+    - \[`-M`|`--model` *model*\]: The model of the agent tool: a model
+      for all tasks, or comma-separated *size*`=`*model* pairs per
+      `Effort:` size (`XS`, `S`, `M`, `L`, `XL`, or `*` for all other
+      tasks), see `ase-agent-adhoc`(1). Generic default: the default
+      model of the agent tool. Built-in: none.
+
     - \[`--params` *name*`=`*value*\]: The value of a parameter
       declared by the definition (repeatable). Built-in: none declared.
 

package/dst/man/ase-agent-editor.md

@@ -11,6 +11,7 @@
 \[`--agent-relay` *url*\]
 \[`-r`|`--repo` *url*\]
 \[`-d`|`--tempdir` *dir*\]
+\[`-M`|`--model` *model*\]
 \[`--`*group*`-`*item* *value* \[...\]\]
 \[`-f`|`--foreground`\]
 
@@ -192,6 +193,12 @@ All other options belong to the sub-commands (see **COMMANDS**).
       (`phase` only). Built-in: not set. Not allowed, as the editor is
       of type `request`.
 
+    - \[`-M`|`--model` *model*\]: The model of the agent tool: a model
+      for all tasks, or comma-separated *size*`=`*model* pairs per
+      `Effort:` size (`XS`, `S`, `M`, `L`, `XL`, or `*` for all other
+      tasks), see `ase-agent-adhoc`(1). Generic default: the default
+      model of the agent tool. Built-in: none.
+
     - \[`--params` *name*`=`*value*\]: The value of a parameter
       declared by the definition (repeatable). Built-in: none declared.
 

package/dst/man/ase-agent-estimator.md

@@ -10,6 +10,7 @@
 \[`-o`|`--one-shot`\]
 \[`--agent-relay` *url*\]
 \[`-m`|`--mode` `phase`|`request`\]
+\[`-M`|`--model` *model*\]
 \[`--`*group*`-`*item* *value* \[...\]\]
 \[`-f`|`--foreground`\]
 
@@ -204,6 +205,12 @@ All other options belong to the sub-commands (see **COMMANDS**).
       (`phase` only). Built-in: enabled (mode `phase`) resp. not set
       (mode `request`).
 
+    - \[`-M`|`--model` *model*\]: The model of the agent tool: a model
+      for all tasks, or comma-separated *size*`=`*model* pairs per
+      `Effort:` size (`XS`, `S`, `M`, `L`, `XL`, or `*` for all other
+      tasks), see `ase-agent-adhoc`(1). Generic default: the default
+      model of the agent tool. Built-in: none.
+
     - \[`--params` *name*`=`*value*\]: The value of a parameter
       declared by the definition (repeatable). Built-in: none declared.
 

package/dst/man/ase-agent-fleet.md

@@ -79,7 +79,7 @@ members) or `ase agent fleet stop`.
   (with all its options commented out, so they fall back to
   `project.relay.url`, `project.relay.crt`, and `project.relay.key`),
   the section `default` (with `tool`, `parallel: 1`, and `timeout: 60m`,
-  plus `repo` and `tempdir` commented out), the edit request agent
+  plus `model`, `repo`, and `tempdir` commented out), the edit request agent
   `editor`, the effort estimation agent `estimator` (mode `phase`,
   estimating the planned tasks, i.e., the `OPEN` tasks for `solo`, the
   `PLANNING` tasks for `team`, and the `PLANNED` tasks for `enterprise`,
@@ -201,8 +201,9 @@ value omits an option, and a list repeats an option:
   `project.relay.url` selecting HTTPS requires both.
 
 - `default`:
-  (optional) The default options of all agents: `tool`, `parallel`,
-  `timeout`, `repo`, `tempdir`, and `agent-relay` (see `ase-agent`(1)),
+  (optional) The default options of all agents: `tool`, `model`,
+  `parallel`, `timeout`, `repo`, `tempdir`, and `agent-relay` (see
+  `ase-agent`(1) and `ase-agent-adhoc`(1)),
   each one applied only to the agents supporting it (e.g., `repo` not to
   `rebooter`), and overridden by the section of an agent. The option
   `agent-relay` is not allowed together with the section `relay`.
@@ -315,7 +316,8 @@ $ ase agent fleet stop
 ```
 
 A configuration `.ase/fleet.yaml` with the agent relay, the built-in
-agents, two editors of different agent tools, an agent of the
+agents (with an implementer using cheaper models for smaller tasks),
+two editors of different agent tools, an agent of the
 definition file `.ase/agents/reviewer.mts`, and an ad-hoc request
 agent:
 
@@ -329,6 +331,7 @@ default:
 rebooter:
 implementer:
     parallel: 2
+    model:    XS=haiku,S=haiku,*=sonnet
 editor-claude:
     kind:     editor
 editor-codex:

package/dst/man/ase-agent-implementer.md

@@ -12,6 +12,7 @@
 \[`-r`|`--repo` *url*\]
 \[`-d`|`--tempdir` *dir*\]
 \[`-m`|`--mode` `implement`|`draft`\]
+\[`-M`|`--model` *model*\]
 \[`--`*group*`-`*item* *value* \[...\]\]
 \[`-f`|`--foreground`\]
 
@@ -260,6 +261,12 @@ All other options belong to the sub-commands (see **COMMANDS**).
       (`phase` only). Built-in: not set. Not allowed, as the implementer
       claims the tasks into its activity state.
 
+    - \[`-M`|`--model` *model*\]: The model of the agent tool: a model
+      for all tasks, or comma-separated *size*`=`*model* pairs per
+      `Effort:` size (`XS`, `S`, `M`, `L`, `XL`, or `*` for all other
+      tasks), see `ase-agent-adhoc`(1). Generic default: the default
+      model of the agent tool. Built-in: none.
+
     - \[`--params` *name*`=`*value*\]: The value of a parameter
       declared by the definition (repeatable). Built-in: `effort-wait`
       (`true` or `false`, default: `true`), whether to wait for the

package/dst/man/ase-agent-integrator.md

@@ -12,6 +12,7 @@
 \[`-r`|`--repo` *url*\]
 \[`-d`|`--tempdir` *dir*\]
 \[`-m`|`--mode` `merge`|`rebase`|`squash`\]
+\[`-M`|`--model` *model*\]
 \[`--`*group*`-`*item* *value* \[...\]\]
 \[`-f`|`--foreground`\]
 
@@ -206,6 +207,12 @@ All other options belong to the sub-commands (see **COMMANDS**).
       (`phase` only). Built-in: not set. Not allowed, as the integrator
       claims the tasks into its activity state.
 
+    - \[`-M`|`--model` *model*\]: The model of the agent tool: a model
+      for all tasks, or comma-separated *size*`=`*model* pairs per
+      `Effort:` size (`XS`, `S`, `M`, `L`, `XL`, or `*` for all other
+      tasks), see `ase-agent-adhoc`(1). Generic default: the default
+      model of the agent tool. Built-in: none.
+
     - \[`--params` *name*`=`*value*\]: The value of a parameter
       declared by the definition (repeatable). Built-in: none declared.
 

package/dst/man/ase-agent-qualifier.md

@@ -12,6 +12,7 @@
 \[`-r`|`--repo` *url*\]
 \[`-d`|`--tempdir` *dir*\]
 \[`-m`|`--mode` `judge`|`qualify`\]
+\[`-M`|`--model` *model*\]
 \[`--`*group*`-`*item* *value* \[...\]\]
 \[`-f`|`--foreground`\]
 
@@ -187,6 +188,12 @@ All other options belong to the sub-commands (see **COMMANDS**).
       (`phase` only). Built-in: not set. Not allowed, as the qualifier
       claims the tasks into its activity state.
 
+    - \[`-M`|`--model` *model*\]: The model of the agent tool: a model
+      for all tasks, or comma-separated *size*`=`*model* pairs per
+      `Effort:` size (`XS`, `S`, `M`, `L`, `XL`, or `*` for all other
+      tasks), see `ase-agent-adhoc`(1). Generic default: the default
+      model of the agent tool. Built-in: none.
+
     - \[`--params` *name*`=`*value*\]: The value of a parameter
       declared by the definition (repeatable). Built-in: none declared.
 

package/dst/man/ase-agent-rebooter.md

@@ -9,6 +9,7 @@
 \[`-T`|`--timeout` *duration*\]
 \[`-o`|`--one-shot`\]
 \[`--agent-relay` *url*\]
+\[`-M`|`--model` *model*\]
 \[`--`*group*`-`*item* *value* \[...\]\]
 \[`-f`|`--foreground`\]
 
@@ -145,6 +146,12 @@ All other options belong to the sub-commands (see **COMMANDS**).
       (`phase` only). Built-in: not set. Not allowed, as the rebooter
       claims the tasks into its activity state.
 
+    - \[`-M`|`--model` *model*\]: The model of the agent tool: a model
+      for all tasks, or comma-separated *size*`=`*model* pairs per
+      `Effort:` size (`XS`, `S`, `M`, `L`, `XL`, or `*` for all other
+      tasks), see `ase-agent-adhoc`(1). Generic default: the default
+      model of the agent tool. Built-in: none.
+
     - \[`--params` *name*`=`*value*\]: The value of a parameter
       declared by the definition (repeatable). Built-in: none declared.
 

package/dst/man/ase-agent-researcher.md

@@ -12,6 +12,7 @@
 \[`-r`|`--repo` *url*\]
 \[`-d`|`--tempdir` *dir*\]
 \[`-m`|`--mode` `phase`|`request`\]
+\[`-M`|`--model` *model*\]
 \[`--`*group*`-`*item* *value* \[...\]\]
 \[`-f`|`--foreground`\]
 
@@ -246,6 +247,12 @@ All other options belong to the sub-commands (see **COMMANDS**).
     - \[`--unclaimed`\]: Process the tasks of the incoming states
       without claiming them (`phase` only). Built-in: not set.
 
+    - \[`-M`|`--model` *model*\]: The model of the agent tool: a model
+      for all tasks, or comma-separated *size*`=`*model* pairs per
+      `Effort:` size (`XS`, `S`, `M`, `L`, `XL`, or `*` for all other
+      tasks), see `ase-agent-adhoc`(1). Generic default: the default
+      model of the agent tool. Built-in: none.
+
     - \[`--params` *name*`=`*value*\]: The value of a parameter
       declared by the definition (repeatable). Built-in: none declared.
 

package/package.json

@@ -6,7 +6,7 @@
     "homepage":                             "https://ase.tools",
     "repository":                           { "url": "git+https://github.com/rse/ase.git", "type": "git" },
     "bugs":                                 { "url": "https://github.com/rse/ase/issues" },
-    "version":                              "2.0.6",
+    "version":                              "2.0.7",
     "license":                              "Apache-2.0",
     "author": {
         "name":                             "Dr. Ralf S. Engelschall",
@@ -86,8 +86,8 @@
         "string-width":                     "8.3.0",
         "react":                            "19.3.1",
         "chokidar":                         "6.0.0",
-        "marked":                           "18.1.2",
-        "shiki":                            "4.5.0",
+        "marked":                           "18.1.3",
+        "shiki":                            "4.6.0",
         "cli-table3":                       "0.6.5",
         "chalk":                            "6.0.1",
         "pretty-ms":                        "10.0.0",
@@ -97,7 +97,7 @@
         "zod":                              "4.6.7",
         "which":                            "7.0.0",
         "update-notifier":                  "7.3.1",
-        "semver":                           "7.8.5",
+        "semver":                           "7.8.6",
         "shell-quote":                      "1.12.0",
         "get-stdin":                        "10.0.0",
         "proper-lockfile":                  "4.1.2",
@@ -108,7 +108,7 @@
         "undici":                           "8.12.3",
         "picomatch":                        "4.0.7",
         "lru-cache":                        "11.5.3",
-        "@rse/specbook":                    "1.6.1",
+        "@rse/specbook":                    "1.6.2",
         "markdownlint":                     "0.42.0",
         "tail":                             "2.2.6",
         "source-code-error":                "1.2.0",

package/plugin/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
     "name":        "ase",
-    "version":     "2.0.6",
+    "version":     "2.0.7",
     "description": "Agentic Software Engineering (ASE)",
     "keywords":    [ "agentic", "software", "engineering" ],
     "homepage":    "https://ase.tools",

package/plugin/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
     "name":        "ase",
-    "version":     "2.0.6",
+    "version":     "2.0.7",
     "description": "Agentic Software Engineering (ASE)",
     "keywords":    [ "agentic", "software", "engineering" ],
     "homepage":    "https://ase.tools",

package/plugin/.github/plugin/plugin.json

@@ -1,6 +1,6 @@
 {
     "name":        "ase",
-    "version":     "2.0.6",
+    "version":     "2.0.7",
     "description": "Agentic Software Engineering (ASE)",
     "keywords":    [ "agentic", "software", "engineering" ],
     "homepage":    "https://ase.tools",