@clipboard-health/groundcrew 4.26.0 → 4.26.1

package/dist/cli.js

@@ -14,7 +14,7 @@ import { errorMessage, parseDryRunPositionals, readEnvironmentVariable, readTask
 const REMOVED_SANDBOX_COMMAND_MESSAGE = [
     "`crew sandbox` is no longer supported.",
     "Groundcrew now launches agents inside existing sbx sandboxes but does not list, create, regenerate, authenticate, or remove them.",
-    "Use the manual `sbx` workflow in README.md#docker-sandboxes-sdx-setup, then keep `models.definitions.<model>.sandbox.agent` in crew.config.ts so launches can address the existing sandbox.",
+    "Use the manual `sbx` workflow in README.md#docker-sandboxes-sdx-setup, then keep `agents.definitions.<agent>.sandbox.agent` in crew.config.ts so launches can address the existing sandbox.",
 ].join("\n");
 const requireFromCli = createRequire(import.meta.url);
 const SETUP_REPOS_REMOVED_MESSAGE = [
@@ -112,7 +112,7 @@ async function doctorCli(argv) {
 const SUBCOMMANDS = {
     init: {
         summary: "Create a crew.config.ts in the cwd (or --global into the XDG config dir)",
-        usage: "[--global | --local] [--force] [--dry-run] [--project-dir <dir>] [--repo <repo>]... [--runner <runner>] [--model <model>]",
+        usage: "[--global | --local] [--force] [--dry-run] [--project-dir <dir>] [--repo <repo>]... [--runner <runner>] [--agent <agent>]",
         invoke: initConfigCli,
     },
     run: {

package/dist/commands/dispatcher.d.ts

@@ -9,7 +9,7 @@
 import type { Board } from "../lib/board.ts";
 import type { ResolvedConfig } from "../lib/config.ts";
 import { type BoardState, type Issue } from "../lib/taskSource.ts";
-import type { UsageByModel } from "../lib/usage.ts";
+import type { UsageByAgent } from "../lib/usage.ts";
 import type { WorktreeEntry } from "../lib/worktrees.ts";
 interface DispatcherDeps {
     config: ResolvedConfig;
@@ -20,7 +20,7 @@ export interface Dispatcher {
         state: BoardState;
         worktreeEntries: readonly WorktreeEntry[];
         /** Lazy so dispatcher can early-return on idle ticks without paying the codexbar shell-out. */
-        usage: (signal?: AbortSignal) => Promise<UsageByModel>;
+        usage: (signal?: AbortSignal) => Promise<UsageByAgent>;
         dryRun: boolean;
         signal?: AbortSignal;
         /**

package/dist/commands/dispatcher.js

@@ -19,18 +19,18 @@ function logSkip(verdict) {
         reason: verdict.eventReason,
         task: naturalIdFromCanonical(verdict.issue.id),
         blockers: verdict.blockers,
-        model: verdict.model,
+        agent: verdict.agent,
     });
 }
-function logMissingRepositorySkip(issue, model, knownRepositories) {
+function logMissingRepositorySkip(issue, agent, knownRepositories) {
     const task = naturalIdFromCanonical(issue.id);
-    log(styleWarning(`WARNING: ${issue.id} has agent "${model}" but no repository; skipping dispatch. Add --repo <repo> when creating the task, add repo:<repo> to the task line, or set defaultRepository on source "${issue.source}". Known repositories: ${formatKnownRepositories(knownRepositories)}`));
+    log(styleWarning(`WARNING: ${issue.id} has agent "${agent}" but no repository; skipping dispatch. Add --repo <repo> when creating the task, add repo:<repo> to the task line, or set defaultRepository on source "${issue.source}". Known repositories: ${formatKnownRepositories(knownRepositories)}`));
     logEvent("dispatch", {
         outcome: "skipped",
         reason: "missing_repository",
         task,
         source: issue.source,
-        model,
+        agent,
     });
 }
 export function createDispatcher(deps) {
@@ -38,7 +38,7 @@ export function createDispatcher(deps) {
     function buildExhaustedSet(usage) {
         const exhausted = new Set();
         for (const exhaustion of classifyUsageExhaustion(config, usage)) {
-            exhausted.add(exhaustion.model);
+            exhausted.add(exhaustion.agent);
             log(formatUsageExhaustion(exhaustion));
         }
         return exhausted;
@@ -47,17 +47,17 @@ export function createDispatcher(deps) {
         const { issue, recovery } = start;
         const taskId = naturalIdFromCanonical(issue.id);
         if (start.resolvedFromAny) {
-            log(`Resolved agent-any for ${taskId} → ${issue.model}`);
+            log(`Resolved agent-any for ${taskId} → ${issue.agent}`);
         }
         if (dryRun) {
             log(
             /* v8 ignore next @preserve -- classifyTodo forces recovery=false in dry-run, so the resume branch can't fire here */
-            `[dry-run] Would ${recovery ? "resume" : "start"} ${taskId} in ${issue.repository} (${issue.model})`);
+            `[dry-run] Would ${recovery ? "resume" : "start"} ${taskId} in ${issue.repository} (${issue.agent})`);
             logEvent("dispatch", {
                 outcome: "skipped",
                 reason: "dry_run",
                 task: taskId,
-                model: issue.model,
+                agent: issue.agent,
                 repository: issue.repository,
             });
             return;
@@ -70,7 +70,7 @@ export function createDispatcher(deps) {
                 const setupOptions = {
                     repository: issue.repository,
                     task: taskId,
-                    model: issue.model,
+                    agent: issue.agent,
                     details: {
                         title: issue.title,
                         description: issue.description,
@@ -85,7 +85,7 @@ export function createDispatcher(deps) {
             logEvent("dispatch", {
                 outcome: recovery ? "resumed" : "started",
                 task: taskId,
-                model: issue.model,
+                agent: issue.agent,
                 repository: issue.repository,
             });
         }
@@ -94,7 +94,7 @@ export function createDispatcher(deps) {
             logEvent("dispatch", {
                 outcome: "failed",
                 task: taskId,
-                model: issue.model,
+                agent: issue.agent,
                 repository: issue.repository,
                 error: errorMessage(error),
             });
@@ -122,9 +122,9 @@ export function createDispatcher(deps) {
         const slots = config.orchestrator.maximumInProgress - activeCount;
         const rawTodo = state.issues.filter((issue) => issue.status === "todo");
         for (const issue of rawTodo) {
-            const { model, repository } = issue;
-            if (model !== undefined && repository === undefined) {
-                logMissingRepositorySkip(issue, model, config.workspace.knownRepositories);
+            const { agent, repository } = issue;
+            if (agent !== undefined && repository === undefined) {
+                logMissingRepositorySkip(issue, agent, config.workspace.knownRepositories);
             }
         }
         // Narrow queued work to tasks that opted in with an agent and resolved a
@@ -212,10 +212,10 @@ export function createDispatcher(deps) {
             return;
         }
         const dispatchable = starts;
-        log(`Slots ${activeCount}/${config.orchestrator.maximumInProgress} used${formatActiveSlotList(active)}, starting ${dispatchable.length} task(s): ${dispatchable.map(({ issue }) => `${naturalIdFromCanonical(issue.id)}(${issue.model})`).join(", ")}`);
+        log(`Slots ${activeCount}/${config.orchestrator.maximumInProgress} used${formatActiveSlotList(active)}, starting ${dispatchable.length} task(s): ${dispatchable.map(({ issue }) => `${naturalIdFromCanonical(issue.id)}(${issue.agent})`).join(", ")}`);
         logEvent("dispatch", {
             outcome: "starting",
-            tasks: dispatchable.map(({ issue }) => `${naturalIdFromCanonical(issue.id)}:${issue.model}`),
+            tasks: dispatchable.map(({ issue }) => `${naturalIdFromCanonical(issue.id)}:${issue.agent}`),
         });
         for (const start of dispatchable) {
             // oxlint-disable-next-line no-await-in-loop -- one workspace at a time avoids racing on git
@@ -233,9 +233,9 @@ function hasRecoverableCandidate(issues, worktreeEntries) {
 function formatUsageExhaustion(exhaustion) {
     if (exhaustion.kind === "session") {
         const mins = exhaustion.resetMinutes ?? "?";
-        return `${exhaustion.model} session at ${exhaustion.usedPercentage.toFixed(0)}% (> ${exhaustion.limitPercentage}%), resets in ${mins}m — skipping its tasks`;
+        return `${exhaustion.agent} session at ${exhaustion.usedPercentage.toFixed(0)}% (> ${exhaustion.limitPercentage}%), resets in ${mins}m — skipping its tasks`;
     }
-    return `${exhaustion.model} weekly at ${exhaustion.usedPercentage.toFixed(1)}% (> ${exhaustion.allowedPercentage.toFixed(1)}% paced budget), resets in ${exhaustion.resetMinutes}m — skipping its tasks`;
+    return `${exhaustion.agent} weekly at ${exhaustion.usedPercentage.toFixed(1)}% (> ${exhaustion.allowedPercentage.toFixed(1)}% paced budget), resets in ${exhaustion.resetMinutes}m — skipping its tasks`;
 }
 /** Undefined priority sorts last. */
 function prioritySortKey(priority) {
@@ -246,7 +246,7 @@ export function formatActiveSlotList(active) {
         return "";
     }
     const entries = active
-        .map((issue) => `${naturalIdFromCanonical(issue.id)}(${issue.model ?? "?"})`)
+        .map((issue) => `${naturalIdFromCanonical(issue.id)}(${issue.agent ?? "?"})`)
         .join(", ");
     return ` [${entries}]`;
 }

package/dist/commands/doctor.js

@@ -8,13 +8,13 @@ import { buildSources, sourcesFromConfig } from "../lib/buildSources.js";
 import { loadConfigWithSource, worktreeBaseDir, } from "../lib/config.js";
 import { detectHostCapabilities, which } from "../lib/host.js";
 import { resolveLocalRunner } from "../lib/localRunner.js";
-import { gatedModels } from "../lib/usage.js";
+import { gatedAgents } from "../lib/usage.js";
 import { errorMessage, writeOutput } from "../lib/util.js";
 import { resolveWorkspaceKind } from "../lib/workspaces.js";
 // Tokenization stops after this many non-flag tokens. Two is enough to
 // catch wrapper + wrapped CLI commands like `safehouse claude --foo`.
 const MAX_TOKENS_PER_CMD = 2;
-const BUILT_IN_MODEL_NAMES = ["claude", "codex"];
+const BUILT_IN_AGENT_NAMES = ["claude", "codex"];
 const CONFIG_SOURCE_LABELS = {
     env: "GROUNDCREW_CONFIG",
     project: "project",
@@ -74,7 +74,7 @@ function checkDir(path, label) {
     };
 }
 /**
- * Tokens worth checking against PATH from a model's `cmd`:
+ * Tokens worth checking against PATH from an agent's `cmd`:
  * the executable name (first non-flag token), and any subsequent
  * non-flag, non-flag-value token until a flag is hit. Flag tokens are
  * dropped along with the token immediately following them (treated as
@@ -111,9 +111,9 @@ function commandTokensToCheck(cmd) {
 }
 function gatherToolTargets(config) {
     const all = new Map();
-    for (const [modelName, definition] of Object.entries(config.models.definitions)) {
+    for (const [agentName, definition] of Object.entries(config.agents.definitions)) {
         for (const token of commandTokensToCheck(definition.cmd)) {
-            const hint = modelCliHint(modelName, token);
+            const hint = agentCliHint(agentName, token);
             if (!all.has(token) || all.get(token) === undefined) {
                 all.set(token, hint);
             }
@@ -121,16 +121,16 @@ function gatherToolTargets(config) {
     }
     return [...all].map(([token, hint]) => (hint === undefined ? { token } : { token, hint }));
 }
-function modelCliHint(modelName, token) {
-    if (token !== modelName) {
+function agentCliHint(agentName, token) {
+    if (token !== agentName) {
         return undefined;
     }
-    if (!isBuiltInModelName(modelName)) {
+    if (!isBuiltInAgentName(agentName)) {
         return undefined;
     }
-    return `install ${token} or remove \`models.definitions.${modelName}\` from crew.config.ts`;
+    return `install ${token} or remove \`agents.definitions.${agentName}\` from crew.config.ts`;
 }
-function isBuiltInModelName(value) {
+function isBuiltInAgentName(value) {
     return value === "claude" || value === "codex";
 }
 function format(check) {
@@ -196,16 +196,16 @@ export async function doctor() {
         const check = await checkCmd(token, required, required ? hint : "required for local runs");
         checks.push(check);
     }
-    const usageGatedModels = gatedModels(config);
-    if (usageGatedModels.length > 0) {
+    const usageGatedAgents = gatedAgents(config);
+    if (usageGatedAgents.length > 0) {
         const codexbarPath = await which("codexbar");
         if (codexbarPath === undefined) {
-            const modelList = usageGatedModels.map((name) => `\`${name}\``).join(", ");
+            const agentList = usageGatedAgents.map((name) => `\`${name}\``).join(", ");
             checks.push({
                 name: "codexbar",
                 ok: false,
                 required: true,
-                hint: `required for usage gating on ${modelList} — install codexbar, or set \`models.definitions.<name>.usage\` to disable gating`,
+                hint: `required for usage gating on ${agentList} — install codexbar, or set \`agents.definitions.<name>.usage\` to disable gating`,
             });
         }
         else {

package/dist/commands/eligibility.d.ts

@@ -8,15 +8,15 @@
  */
 import { type ResolvedConfig } from "../lib/config.ts";
 import { type GroundcrewIssue } from "../lib/taskSource.ts";
-import type { UsageByModel } from "../lib/usage.ts";
+import type { UsageByAgent } from "../lib/usage.ts";
 import type { WorkspaceProbe } from "../lib/workspaces.ts";
 import type { WorktreeEntry } from "../lib/worktrees.ts";
-type SkipReason = "blocked" | "blockers_paginated" | "agent_any_capacity" | "model_exhausted" | "workspace_list_unavailable" | "workspace_missing";
+type SkipReason = "blocked" | "blockers_paginated" | "agent_any_capacity" | "agent_exhausted" | "workspace_list_unavailable" | "workspace_missing";
 export interface StartVerdict {
     kind: "start";
     issue: GroundcrewIssue;
     recovery: boolean;
-    /** Set when the verdict resolved an `agent-any` label to a concrete model. */
+    /** Set when the verdict resolved an `agent-any` label to a concrete agent. */
     resolvedFromAny: boolean;
 }
 export interface SkipVerdict {
@@ -29,23 +29,23 @@ export interface SkipVerdict {
     /** Set for `blocked` and `blockers_paginated`. */
     blockers?: string[];
     /**
-     * Set when the skip event should carry the resolved model (i.e. the
-     * verdict knew which model would have run). Omitted for blocker skips
-     * and `agent_any_capacity` where the model was either unresolved or
+     * Set when the skip event should carry the resolved agent (i.e. the
+     * verdict knew which agent would have run). Omitted for blocker skips
+     * and `agent_any_capacity` where the agent was either unresolved or
      * irrelevant.
      */
-    model?: string;
+    agent?: string;
 }
 type Verdict = StartVerdict | SkipVerdict;
-export type ModelUsageExhaustion = {
+export type AgentUsageExhaustion = {
     kind: "session";
-    model: string;
+    agent: string;
     usedPercentage: number;
     limitPercentage: number;
     resetMinutes: number | null;
 } | {
     kind: "weekly";
-    model: string;
+    agent: string;
     usedPercentage: number;
     allowedPercentage: number;
     resetMinutes: number;
@@ -61,8 +61,8 @@ export interface ClassifyArguments {
     unblocked: readonly GroundcrewIssue[];
     worktreeEntries: readonly WorktreeEntry[];
     workspaceProbe: WorkspaceProbe;
-    usage: UsageByModel;
-    /** Models flagged over `sessionLimitPercentage`. */
+    usage: UsageByAgent;
+    /** Agents flagged over `sessionLimitPercentage`. */
     exhausted: Set<string>;
     /** Maximum number of `start` verdicts to produce. */
     slots: number;
@@ -73,15 +73,15 @@ interface BlockerClassification {
     skips: SkipVerdict[];
 }
 /**
- * Pick the configured model with the most available session capacity.
- * Models flagged exhausted (over `sessionLimitPercentage`) are excluded.
- * Score is `usage[model].session` with `null`/missing treated as 0
- * (maximum headroom), so when no usage data is available every model
- * ties at 0 and the default model wins the tiebreak — `agent-any` then
+ * Pick the configured agent with the most available session capacity.
+ * Agents flagged exhausted (over `sessionLimitPercentage`) are excluded.
+ * Score is `usage[agent].session` with `null`/missing treated as 0
+ * (maximum headroom), so when no usage data is available every agent
+ * ties at 0 and the default agent wins the tiebreak — `agent-any` then
  * falls back to the default predictably.
  */
-export declare function pickBestModel(config: ResolvedConfig, usage: UsageByModel, exhausted: Set<string>): string | undefined;
-export declare function classifyUsageExhaustion(config: ResolvedConfig, usage: UsageByModel): ModelUsageExhaustion[];
+export declare function pickBestAgent(config: ResolvedConfig, usage: UsageByAgent, exhausted: Set<string>): string | undefined;
+export declare function classifyUsageExhaustion(config: ResolvedConfig, usage: UsageByAgent): AgentUsageExhaustion[];
 /**
  * Cheap pre-pass — partitions Todo into unblocked issues and blocker
  * skip verdicts. Runs before the dispatcher fetches usage or probes the

package/dist/commands/eligibility.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"eligibility.d.ts","sourceRoot":"","sources":["../../src/commands/eligibility.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAmB,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACxE,OAAO,EAAwC,KAAK,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAClG,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAOzD,KAAK,UAAU,GACX,SAAS,GACT,oBAAoB,GACpB,oBAAoB,GACpB,iBAAiB,GACjB,4BAA4B,GAC5B,mBAAmB,CAAC;AAExB,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,eAAe,CAAC;IACvB,QAAQ,EAAE,OAAO,CAAC;IAClB,8EAA8E;IAC9E,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,eAAe,CAAC;IACvB,sBAAsB;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,WAAW,EAAE,UAAU,CAAC;IACxB,kDAAkD;IAClD,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,KAAK,OAAO,GAAG,YAAY,GAAG,WAAW,CAAC;AAE1C,MAAM,MAAM,oBAAoB,GAC5B;IACE,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B,GACD;IACE,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEN,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,cAAc,CAAC;IACvB;;;;;OAKG;IACH,SAAS,EAAE,SAAS,eAAe,EAAE,CAAC;IACtC,eAAe,EAAE,SAAS,aAAa,EAAE,CAAC;IAC1C,cAAc,EAAE,cAAc,CAAC;IAC/B,KAAK,EAAE,YAAY,CAAC;IACpB,oDAAoD;IACpD,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACvB,qDAAqD;IACrD,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,UAAU,qBAAqB;IAC7B,SAAS,EAAE,eAAe,EAAE,CAAC;IAC7B,KAAK,EAAE,WAAW,EAAE,CAAC;CACtB;AAgCD;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,cAAc,EACtB,KAAK,EAAE,YAAY,EACnB,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,GACrB,MAAM,GAAG,SAAS,CAepB;AAaD,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,cAAc,EACtB,KAAK,EAAE,YAAY,GAClB,oBAAoB,EAAE,CAmCxB;AA6CD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,SAAS,eAAe,EAAE,GAAG,qBAAqB,CAYxF;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,iBAAiB,GAAG,OAAO,EAAE,CAgE5E"}
+{"version":3,"file":"eligibility.d.ts","sourceRoot":"","sources":["../../src/commands/eligibility.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAa,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClE,OAAO,EAAwC,KAAK,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAClG,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAOzD,KAAK,UAAU,GACX,SAAS,GACT,oBAAoB,GACpB,oBAAoB,GACpB,iBAAiB,GACjB,4BAA4B,GAC5B,mBAAmB,CAAC;AAExB,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,eAAe,CAAC;IACvB,QAAQ,EAAE,OAAO,CAAC;IAClB,8EAA8E;IAC9E,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,eAAe,CAAC;IACvB,sBAAsB;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,WAAW,EAAE,UAAU,CAAC;IACxB,kDAAkD;IAClD,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,KAAK,OAAO,GAAG,YAAY,GAAG,WAAW,CAAC;AAE1C,MAAM,MAAM,oBAAoB,GAC5B;IACE,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B,GACD;IACE,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEN,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,cAAc,CAAC;IACvB;;;;;OAKG;IACH,SAAS,EAAE,SAAS,eAAe,EAAE,CAAC;IACtC,eAAe,EAAE,SAAS,aAAa,EAAE,CAAC;IAC1C,cAAc,EAAE,cAAc,CAAC;IAC/B,KAAK,EAAE,YAAY,CAAC;IACpB,oDAAoD;IACpD,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACvB,qDAAqD;IACrD,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,UAAU,qBAAqB;IAC7B,SAAS,EAAE,eAAe,EAAE,CAAC;IAC7B,KAAK,EAAE,WAAW,EAAE,CAAC;CACtB;AAgCD;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,cAAc,EACtB,KAAK,EAAE,YAAY,EACnB,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,GACrB,MAAM,GAAG,SAAS,CAepB;AAaD,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,cAAc,EACtB,KAAK,EAAE,YAAY,GAClB,oBAAoB,EAAE,CAmCxB;AA6CD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,SAAS,eAAe,EAAE,GAAG,qBAAqB,CAYxF;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,iBAAiB,GAAG,OAAO,EAAE,CAgE5E"}

package/dist/commands/eligibility.js

@@ -6,7 +6,7 @@
  * The Dispatcher consumes the verdict list to drive logging and side
  * effects.
  */
-import { AGENT_ANY_MODEL } from "../lib/config.js";
+import { AGENT_ANY } from "../lib/config.js";
 import { naturalIdFromCanonical } from "../lib/taskSource.js";
 const PERCENT_FRACTION_DIVISOR = 100;
 const DAYS_PER_WEEK = 7;
@@ -40,15 +40,15 @@ function blockerVerdictFor(issue) {
     };
 }
 /**
- * Pick the configured model with the most available session capacity.
- * Models flagged exhausted (over `sessionLimitPercentage`) are excluded.
- * Score is `usage[model].session` with `null`/missing treated as 0
- * (maximum headroom), so when no usage data is available every model
- * ties at 0 and the default model wins the tiebreak — `agent-any` then
+ * Pick the configured agent with the most available session capacity.
+ * Agents flagged exhausted (over `sessionLimitPercentage`) are excluded.
+ * Score is `usage[agent].session` with `null`/missing treated as 0
+ * (maximum headroom), so when no usage data is available every agent
+ * ties at 0 and the default agent wins the tiebreak — `agent-any` then
  * falls back to the default predictably.
  */
-export function pickBestModel(config, usage, exhausted) {
-    const candidates = Object.keys(config.models.definitions).filter((name) => !exhausted.has(name));
+export function pickBestAgent(config, usage, exhausted) {
+    const candidates = Object.keys(config.agents.definitions).filter((name) => !exhausted.has(name));
     if (candidates.length === 0) {
         return undefined;
     }
@@ -57,7 +57,7 @@ export function pickBestModel(config, usage, exhausted) {
         if (candidate.score < best.score) {
             return candidate;
         }
-        if (candidate.score === best.score && candidate.name === config.models.default) {
+        if (candidate.score === best.score && candidate.name === config.agents.default) {
             return candidate;
         }
         return best;
@@ -72,11 +72,11 @@ function weeklyPacedBudgetPercentage(weekEndDuration) {
 export function classifyUsageExhaustion(config, usage) {
     const exhausted = [];
     const sessionLimit = config.orchestrator.sessionLimitPercentage;
-    for (const [model, snapshot] of Object.entries(usage)) {
+    for (const [agent, snapshot] of Object.entries(usage)) {
         if (snapshot.session !== null && snapshot.session * PERCENT_FRACTION_DIVISOR > sessionLimit) {
             exhausted.push({
                 kind: "session",
-                model,
+                agent,
                 usedPercentage: snapshot.session * PERCENT_FRACTION_DIVISOR,
                 limitPercentage: sessionLimit,
                 resetMinutes: snapshot.sessionEndDuration,
@@ -93,7 +93,7 @@ export function classifyUsageExhaustion(config, usage) {
             if (usedPercentage > allowedPercentage) {
                 exhausted.push({
                     kind: "weekly",
-                    model,
+                    agent,
                     usedPercentage,
                     allowedPercentage,
                     resetMinutes: snapshot.weekEndDuration,
@@ -172,27 +172,27 @@ export function classifyEligibility(arguments_) {
         }
         let resolved = original;
         let resolvedFromAny = false;
-        if (original.model === AGENT_ANY_MODEL) {
-            const picked = pickBestModel(config, usage, exhausted);
+        if (original.agent === AGENT_ANY) {
+            const picked = pickBestAgent(config, usage, exhausted);
             if (picked === undefined) {
                 verdicts.push({
                     kind: "skip",
                     issue: original,
-                    message: `Skipping ${original.id}: agent-any but no model has available capacity`,
+                    message: `Skipping ${original.id}: agent-any but no agent has available capacity`,
                     eventReason: "agent_any_capacity",
                 });
                 continue;
             }
-            resolved = { ...original, model: picked };
+            resolved = { ...original, agent: picked };
             resolvedFromAny = true;
         }
-        if (exhausted.has(resolved.model)) {
+        if (exhausted.has(resolved.agent)) {
             verdicts.push({
                 kind: "skip",
                 issue: resolved,
-                message: `Skipping ${resolved.id} (${resolved.model} session exhausted)`,
-                eventReason: "model_exhausted",
-                model: resolved.model,
+                message: `Skipping ${resolved.id} (${resolved.agent} session exhausted)`,
+                eventReason: "agent_exhausted",
+                agent: resolved.agent,
             });
             continue;
         }
@@ -203,7 +203,7 @@ export function classifyEligibility(arguments_) {
             dryRun,
         });
         if (recovery.kind === "skip") {
-            verdicts.push({ ...recovery, model: resolved.model });
+            verdicts.push({ ...recovery, agent: resolved.agent });
             continue;
         }
         verdicts.push({

package/dist/commands/init.d.ts

@@ -5,9 +5,9 @@
  * `cp` dance documented in the README.
  */
 import { type LocalRunnerSetting } from "../lib/config.ts";
-declare const INIT_MODELS: readonly ["claude", "codex"];
+declare const INIT_AGENTS: readonly ["claude", "codex"];
 type InitConfigScope = "global" | "local";
-type InitModel = (typeof INIT_MODELS)[number];
+type InitAgent = (typeof INIT_AGENTS)[number];
 interface InitConfigOptions {
     /** Where to write the config. Defaults to "local" (cwd). */
     scope?: InitConfigScope;
@@ -23,8 +23,8 @@ interface InitConfigOptions {
     repositories?: string[];
     /** Pre-fill local.runner in the generated config. */
     runner?: LocalRunnerSetting;
-    /** Choose the single built-in model preset enabled by the generated config. */
-    model?: InitModel;
+    /** Choose the single built-in agent preset enabled by the generated config. */
+    agent?: InitAgent;
     /** Override the source template path. */
     examplePath?: string;
 }

package/dist/commands/init.js

@@ -13,8 +13,8 @@ import { xdgConfigPath } from "../lib/xdg.js";
 const CONFIG_FILE_NAME = "crew.config.ts";
 const EXAMPLE_FILE_NAME = "crew.config.example.ts";
 const DEFAULT_EXAMPLE_PROJECT_DIR = "~/dev/groundcrew";
-const INIT_USAGE = "Usage: crew init [--global | --local] [--force] [--dry-run] [--project-dir <dir>] [--repo <owner/repo>]... [--runner <auto|safehouse|sdx|none>] [--model <claude|codex>]";
-const INIT_MODELS = ["claude", "codex"];
+const INIT_USAGE = "Usage: crew init [--global | --local] [--force] [--dry-run] [--project-dir <dir>] [--repo <owner/repo>]... [--runner <auto|safehouse|sdx|none>] [--agent <claude|codex>]";
+const INIT_AGENTS = ["claude", "codex"];
 export function initConfig(options = {}) {
     const scope = options.scope ?? "local";
     const cwd = options.cwd ?? process.cwd();
@@ -51,7 +51,7 @@ function parseArguments(argv) {
     let projectDir;
     const repositories = [];
     let runner;
-    let model;
+    let agent;
     for (let index = 0; index < argv.length; index += 1) {
         const argument = argv[index];
         /* v8 ignore next 3 @preserve -- loop bounds keep argv[index] defined */
@@ -89,8 +89,8 @@ function parseArguments(argv) {
             index += 1;
             continue;
         }
-        if (argument === "--model") {
-            model = parseModel(readOptionValue(argv, index, argument));
+        if (argument === "--agent") {
+            agent = parseAgent(readOptionValue(argv, index, argument));
             index += 1;
             continue;
         }
@@ -108,8 +108,8 @@ function parseArguments(argv) {
     if (runner !== undefined) {
         parsed.runner = runner;
     }
-    if (model !== undefined) {
-        parsed.model = model;
+    if (agent !== undefined) {
+        parsed.agent = agent;
     }
     return parsed;
 }
@@ -137,16 +137,16 @@ function parseRunner(value) {
     }
     throw new Error(`crew init --runner must be one of ${LOCAL_RUNNER_SETTINGS.join(", ")}`);
 }
-function parseModel(value) {
-    if (isInitModel(value)) {
+function parseAgent(value) {
+    if (isInitAgent(value)) {
         return value;
     }
-    throw new Error(`crew init --model must be one of ${INIT_MODELS.join(", ")}`);
+    throw new Error(`crew init --agent must be one of ${INIT_AGENTS.join(", ")}`);
 }
 function isLocalRunnerSetting(value) {
     return value === "auto" || value === "safehouse" || value === "sdx" || value === "none";
 }
-function isInitModel(value) {
+function isInitAgent(value) {
     return value === "claude" || value === "codex";
 }
 function tsString(value) {
@@ -163,15 +163,15 @@ function renderConfig(source, options) {
     if (options.runner !== undefined) {
         contents = replaceRequired(contents, `  // local: { runner: "auto" },`, `  local: { runner: ${tsString(options.runner)} },`, "--runner");
     }
-    if (options.model !== undefined) {
-        contents = replaceRequired(contents, `    default: "claude",`, `    default: ${tsString(options.model)},`, "--model");
-        contents = replaceRequired(contents, "      claude: {},", `      ${options.model}: {},`, "--model");
-        contents = removeDuplicateModelDefinitionLines(contents, options.model);
+    if (options.agent !== undefined) {
+        contents = replaceRequired(contents, `    default: "claude",`, `    default: ${tsString(options.agent)},`, "--agent");
+        contents = replaceRequired(contents, "      claude: {},", `      ${options.agent}: {},`, "--agent");
+        contents = removeDuplicateAgentDefinitionLines(contents, options.agent);
     }
     return contents;
 }
-function removeDuplicateModelDefinitionLines(contents, model) {
-    const linePattern = new RegExp(`^\\s*(?://\\s*)?${escapeRegExp(model)}:\\s*\\{\\},\\s*$`);
+function removeDuplicateAgentDefinitionLines(contents, agent) {
+    const linePattern = new RegExp(`^\\s*(?://\\s*)?${escapeRegExp(agent)}:\\s*\\{\\},\\s*$`);
     let hasActiveEntry = false;
     return contents
         .split("\n")

package/dist/commands/interruptWorkspace.js

@@ -36,7 +36,7 @@ function sourceFromState(state) {
     return {
         task: state.task,
         repository: state.repository,
-        model: state.model,
+        agent: state.agent,
         worktreeDir: state.worktreeDir,
         branchName: state.branchName,
         workspaceName: state.workspaceName,
@@ -47,7 +47,7 @@ function sourceFromWorktree(config, task, entry) {
     return {
         task,
         repository: entry.repository,
-        model: config.models.default,
+        agent: config.agents.default,
         worktreeDir: entry.dir,
         branchName: entry.branchName,
         workspaceName: task,
@@ -89,7 +89,7 @@ export async function interruptWorkspace(config, options) {
         state: {
             task,
             repository: source.repository,
-            model: source.model,
+            agent: source.agent,
             worktreeDir: source.worktreeDir,
             branchName: source.branchName,
             workspaceName: source.workspaceName,

package/dist/commands/orchestrator.js

@@ -9,7 +9,7 @@ import { buildSources, sourcesFromConfig } from "../lib/buildSources.js";
 import { loadConfigWithSource } from "../lib/config.js";
 import { findPullRequestsForBranch } from "../lib/pullRequests.js";
 import { RepositoryResolutionError } from "../lib/taskSource.js";
-import { getUsageByModel } from "../lib/usage.js";
+import { getUsageByAgent } from "../lib/usage.js";
 import { errorMessage, log, sleep, writeOutput } from "../lib/util.js";
 import { worktrees } from "../lib/worktrees.js";
 import { createCleaner } from "./cleaner.js";
@@ -55,7 +55,7 @@ class WatchLoopShutdownError extends Error {
 }
 async function fetchUsageOrEmpty(config, signal) {
     try {
-        return await getUsageByModel(config, signal);
+        return await getUsageByAgent(config, signal);
     }
     catch (error) {
         if (signal?.aborted === true) {